Informacje o wersji wtyczki Androida do obsługi Gradle 8.12

System kompilacji Androida Studio jest oparty na Gradle, a wtyczka Androida do obsługi Gradle dodaje kilka funkcji, które są specyficzne dla kompilowania aplikacji na Androida. Wtyczka Androida do obsługi Gradle (AGP) jest zwykle aktualizowana równolegle z Androidem Studio, ale może działać niezależnie od Androida Studio i być aktualizowana oddzielnie.

Z tego artykułu dowiesz się, jak aktualizować narzędzia Gradle i co zawierają najnowsze aktualizacje. Informacje o wersjach wtyczki Androida do obsługi Gradle z ubiegłych lat znajdziesz w informacjach o wersjach.

Ogólne podsumowanie nadchodzących zmian powodujących niezgodność we wtyczce Androida do obsługi Gradle znajdziesz w  planie rozwoju wtyczki Androida do obsługi Gradle.

Szczegółowe informacje o konfigurowaniu kompilacji Androida za pomocą Gradle znajdziesz na tych stronach:

• Konfigurowanie kompilacji
• Dokumentacja DSL wtyczki Androida do obsługi Gradle
• Dokumentacja Gradle DSL
• Przewodnik użytkownika dotyczący wydajności Gradle

Więcej informacji o systemie kompilacji Gradle znajdziesz w przewodniku użytkownika Gradle.

Aktualizowanie wtyczki Androida do obsługi Gradle

Podczas aktualizowania Androida Studio może pojawić się prośba o automatyczne zaktualizowanie wtyczki Androida do obsługi Gradle do najnowszej dostępnej wersji. Możesz zaakceptować aktualizację lub ręcznie określić wersję na podstawie wymagań projektu.

Wersję wtyczki możesz określić w menu Plik > Struktura projektu > Projekt w Android Studio lub w pliku build.gradle.kts najwyższego poziomu. Wersja wtyczki dotyczy wszystkich modułów utworzonych w tym projekcie Android Studio. W tym przykładzie wtyczka jest ustawiana na wersję 8.12.0 z pliku build.gradle.kts:

plugins {
    id("com.android.application") version "8.12.0" apply false
    id("com.android.library") version "8.12.0" apply false
    id("org.jetbrains.kotlin.android") version "2.1.20" apply false
}

plugins {
    id 'com.android.application' version '8.12.0' apply false
    id 'com.android.library' version '8.12.0' apply false
    id 'org.jetbrains.kotlin.android' version '2.1.20' apply false
}

Ostrzeżenie: w numerach wersji nie należy używać zależności dynamicznych, takich jak 'com.android.tools.build:gradle:8.12.+'. Korzystanie z tej funkcji może powodować nieoczekiwane aktualizacje wersji i utrudniać rozwiązywanie różnic między wersjami.

Jeśli określona wersja wtyczki nie została pobrana, Gradle pobierze ją przy następnej kompilacji projektu lub gdy na pasku menu Android Studio klikniesz Plik > Synchronizuj projekt z plikami Gradle.

Aktualizowanie Gradle

Podczas aktualizacji Androida Studio może pojawić się prośba o zaktualizowanie Gradle do najnowszej dostępnej wersji. Możesz zaakceptować aktualizację lub ręcznie określić wersję na podstawie wymagań projektu.

W tabeli poniżej znajdziesz informacje o tym, która wersja Gradle jest wymagana w przypadku poszczególnych wersji wtyczki Androida do obsługi Gradle. Aby uzyskać najlepszą wydajność, używaj najnowszych wersji Gradle i wtyczki.

Wersję Gradle możesz określić w menu Plik > Struktura projektu > Projekt w Android Studio lub zaktualizować wersję Gradle za pomocą wiersza poleceń. Zalecamy użycie narzędzia wiersza poleceń Gradle Wrapper, które aktualizuje skrypty gradlew. W tym przykładzie ustawiamy wersję Gradle na 8.13 za pomocą Gradle Wrapper. Pamiętaj, że to polecenie musisz uruchomić 2 razy, aby zaktualizować zarówno Gradle, jak i sam Gradle Wrapper (więcej informacji znajdziesz w sekcji Aktualizowanie Gradle Wrapper).

gradle wrapper --gradle-version 8.13

Może się to jednak nie udać w niektórych przypadkach, np. jeśli właśnie zaktualizowano AGP i nie jest on już zgodny z obecną wersją Gradle. W takim przypadku musisz edytować odwołanie do dystrybucji Gradle w pliku gradle/wrapper/gradle-wrapper.properties. W tym przykładzie w pliku gradle-wrapper.properties ustawiamy wersję Gradle na 8.13.

...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.13-bin.zip
...

Zgodność wtyczki Androida do obsługi Gradle i Androida Studio

System kompilacji Androida Studio jest oparty na Gradle, a wtyczka Androida do obsługi Gradle (AGP) dodaje kilka funkcji, które są specyficzne dla kompilowania aplikacji na Androida. W tabeli poniżej znajdziesz informacje o tym, która wersja AGP jest wymagana w przypadku poszczególnych wersji Androida Studio.

Informacje o nowościach we wtyczce Androida do obsługi Gradle znajdziesz w informacjach o wersji wtyczki Androida do obsługi Gradle.

Minimalne wersje narzędzi dla poziomu interfejsu API Androida

Istnieją minimalne wersje Androida Studio i AGP, które obsługują określony poziom API. Używanie starszych wersji Android Studio lub AGP niż wymagane przez targetSdk lub compileSdk projektu może prowadzić do nieoczekiwanych problemów. Do pracy nad projektami, które są przeznaczone dla wersji przedpremierowych systemu operacyjnego Android, zalecamy używanie najnowszej wersji przedpremierowej Androida Studio i AGP. Możesz zainstalować wersje podglądowe Android Studio obok wersji stabilnej.

Minimalne wersje Android Studio i AGP są następujące:

Zmiany w wersjach (listopad 2020 r.)

Aktualizujemy numerację wersji wtyczki Androida do obsługi Gradle (AGP), aby była bardziej zgodna z numeracją narzędzia do kompilacji Gradle.

Oto najważniejsze zmiany:

• AGP będzie teraz używać wersji semantycznych, a zmiany powodujące niezgodność będą wprowadzane w głównych wersjach.

• Co roku będziemy publikować jedną wersję główną AGP, która będzie zgodna z wersją główną Gradle.

• Wersja po AGP 4.2 to 7.0, która będzie wymagać uaktualnienia do Gradle w wersji 7.x. Każda główna wersja AGP będzie wymagać uaktualnienia wersji głównej bazowego narzędzia Gradle.

• Interfejsy API będą wycofywane z wyprzedzeniem około roku, a funkcje zastępcze będą udostępniane w tym samym czasie. Wycofane interfejsy API zostaną usunięte około rok później podczas kolejnej dużej aktualizacji.

Zgodność

Maksymalny poziom API obsługiwany przez wtyczkę Androida do obsługi Gradle w wersji 8.12 to poziom 36. Oto inne informacje o zgodności:

Rozwiązane problemy

Wtyczka Androida do obsługi Gradle w wersji 8.12.0