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.
Aby dowiedzieć się, co zostało naprawione w tej wersji wtyczki Androida do obsługi Gradle, zapoznaj się z zamkniętymi zgłoszeniami.
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.11.0 z pliku build.gradle.kts:
Kotlin
plugins { id("com.android.application") version "8.11.0" apply false id("com.android.library") version "8.11.0" apply false id("org.jetbrains.kotlin.android") version "2.1.20" apply false }
Groovy
plugins { id 'com.android.application' version '8.11.0' apply false id 'com.android.library' version '8.11.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.11.+'.
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 Androida 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.
| Wersja wtyczki | Minimalna wymagana wersja Gradle |
|---|---|
| 8.11 | 8.13 |
| 8.10 | 8.11.1 |
| 8.9 | 8.11.1 |
| 8.8 | 8.10.2 |
| 8.7 | 8.9 |
| 8.6 | 8.7 |
| 8.5 | 8.7 |
| 8.4 | 8.6 |
| 8.3 | 8.4 |
| 8.2 | 8.2 |
| 8.1 | z Androidem 8.0 |
| z Androidem 8.0 | z Androidem 8.0 |
Starsze wersje
| Wersja wtyczki | Wymagana wersja Gradle |
|---|---|
| 7.4 | 7,5 |
| 7.3 | 7.4 |
| 7.2 | 7.3.3 |
| 7.1 | 7.2 |
| 7,0 | 7,0 |
| 4.2.0+ | 6.7.1 |
| 4.1.0+ | 6,5+ |
| 4.0.0+ | 6.1.1+ |
| 3.6.0–3.6.4 | 5.6.4+ |
| 3.5.0–3.5.4 | 5.4.1+ |
| 3.4.0–3.4.3 | 5.1.1+ |
| 3.3.0–3.3.3 | 4.10.1+ |
| 3.2.0 - 3.2.1 | 4,6+ |
| 3.1.0+ | 4.4+ |
| 3.0.0+ | 4.1+ |
| 2.3.0+ | 3,3+ |
| 2.1.3–2.2.3 | 2.14.1 - 3.5 |
| 2.0.0–2.1.2 | 2.10–2.13 |
| 1.5.0 | 2.2.1 - 2.13 |
| 1.2.0 - 1.3.1 | 2.2.1–2.9 |
| 1.0.0–1.1.3 | 2.2.1 - 2.3 |
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 bieżącą 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.
| Wersja Android Studio | Wymagana wersja AGP |
|---|---|
| Pakiet nowych funkcji Narwhal | 2025.1.2 | 4,0–8,12 |
| Narwhal | 2025.1.1 | 3.2-8.11 |
| Pakiet nowych funkcji Meerkat | 2024.3.2 | 3.2-8.10 |
| Meerkat | 2024.3.1 | 3,2–8,9 |
| Pakiet nowych funkcji Ladybug | 2.2.2024 | 3,2–8,8 |
| Ladybug | 2024.2.1 | 3,2–8,7 |
| Pakiet nowych funkcji Koala | 2024.1.2 | 3,2–8,6 |
| Koala | 2024.1.1 | 3,2–8,5 |
| Jellyfish | 2023.3.1 | 3,2–8,4 |
| Iguana | 2023.2.1 | 3,2–8,3 |
| Jeż | 2023.1.1 | 3.2-8.2 |
| Giraffe | 2022.3.1 | 3.2-8.1 |
| Flamingo | 2022.2.1 | 3,2–8,0 |
Starsze wersje
| Wersja Android Studio | Wymagana wersja AGP |
|---|---|
| Electric Eel | 2022.1.1 | 3,2–7,4 |
| Dolphin | 2021.3.1 | 3,2–7,3 |
| Chipmunk | 2021.2.1 | 3.2-7.2 |
| Bumblebee | 2021.1.1 | 3.2-7.1 |
| Arctic Fox | 2020.3.1 | 3,1–7,0 |
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:
| Poziom interfejsu API | Minimalna wersja Android Studio | Minimalna wersja AGP |
|---|---|---|
| 36,0 | Meerkat | 2024.3.1 Patch 1 | 8.9.1 |
| 35 | Pakiet nowych funkcji Koala | 2024.2.1 | 8.6.0 |
| 34 | Jeż | 2023.1.1 | 8.1.1 |
| 33 | Flamingo | 2022.2.1 | 7.2 |
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.11 to poziom 36. Oto inne informacje o zgodności:
| Wersja minimalna | Wersja domyślna | Uwagi | |
|---|---|---|---|
| Gradle | 8.13 | 8.13 | Więcej informacji znajdziesz w sekcji Aktualizowanie Gradle. |
| SDK Build Tools | 35.0.0 | 35.0.0 | Zainstaluj lub skonfiguruj narzędzia do kompilacji pakietu SDK. |
| NDK | Nie dotyczy | 27.0.12077973 | Zainstaluj lub skonfiguruj inną wersję NDK. |
| JDK | 17 | 17 | Więcej informacji znajdziesz w artykule o ustawianiu wersji JDK. |
Rozwiązane problemy
Wtyczka Androida do obsługi Gradle w wersji 8.11.0
| Rozwiązane problemy | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Wtyczka Androida do obsługi Gradle |
|
|||||||||
| Dexer (D8) |
|
|||||||||
| Lint |
|
|||||||||
| Shrinker (R8) |
|
|||||||||