System kompilacji Android Studio oparty jest na Gradle i narzędziu Android Gradle. dodaje kilka funkcji charakterystycznych dla tworzenia aplikacji na Androida. Chociaż wtyczka Androida do obsługi Gradle (AGP) jest zwykle aktualizowana na etapie blokady na urządzeniach z Androidem. Studio, wtyczka (i reszta systemu Gradle) może działać niezależnie od Android Studio i będzie aktualizowane oddzielnie.
Z tej strony dowiesz się, jak zaktualizować narzędzia Gradle datę i najnowsze aktualizacje. Informacje o wersji na Androida w poprzedniej wersji Wersje wtyczki Gradle, zobacz informacjami o poprzednich wersjach.
Aby sprawdzić, co zostało poprawione w tej wersji wtyczki Androida do obsługi Gradle, przeczytaj artykuł zamknięte problemy.
Ogólne podsumowanie nadchodzących zmian powodujących niezgodność w Android Gradle przeczytaj artykuł Android Harmonogram dotyczący wtyczki Gradle.
Szczegółowe informacje o konfigurowaniu kompilacji Androida za pomocą Gradle znajdziesz zobacz te strony:
- Konfigurowanie kompilacji
- Dokumentacja DSL wtyczki Androida do obsługi Gradle
- Dokumentacja Gradle DSL
- Przewodnik po wydajności Gradle
Więcej informacji o systemie kompilacji Gradle znajdziesz w Przewodnik użytkownika Gradle
Aktualizowanie wtyczki Androida do obsługi Gradle
Po zaktualizowaniu Android Studio możesz zobaczyć prośbę o automatyczne zaktualizować wtyczkę Androida do obsługi Gradle do najnowszej wersji. Ty mogą zaakceptować aktualizację lub ręcznie określić wersję na podstawie z wymaganiami kompilacji projektu.
Możesz określić wersję wtyczki w
wybierz Plik > Projekt
Struktura > menu Projekt w Android Studio lub
pliku build.gradle.kts najwyższego poziomu. Wersja wtyczki dotyczy
wszystkich modułów utworzonych w tym projekcie Android Studio. Poniższe przykładowe zestawy
do wersji 8.5.0 z
Plik build.gradle.kts:
Kotlin
plugins { id("com.android.application") version "8.5.0" apply false id("com.android.library") version "8.5.0" apply false id("org.jetbrains.kotlin.android") version "1.9.23" apply false }
Odlotowe
plugins { id 'com.android.application' version '8.5.0' apply false id 'com.android.library' version '8.5.0' apply false id 'org.jetbrains.kotlin.android' version '1.9.23' apply false }
Uwaga: nie używaj w wersji zależności dynamicznych.
takie jak
'com.android.tools.build:gradle:8.5.+'
Korzystanie z tej funkcji może spowodować nieoczekiwane aktualizacje wersji i utrudnić
i w rozwiązaniu różnic między wersjami.
Jeśli określona wersja wtyczki nie została pobrana, Gradle pobierze ją. następnym razem, gdy będziesz kompilować projekt lub klikniesz Plik > Synchronizowanie projektu z plikami Gradle na pasku menu w Android Studio.
Aktualizowanie Gradle
Po zaktualizowaniu Android Studio możesz zobaczyć prośbę o zaktualizuj Gradle do najnowszej wersji. Możesz zaakceptować zaktualizuj lub ręcznie określ wersję na podstawie kompilacji projektu .
W tabeli poniżej znajdziesz informacje o tym, która wersja Gradle jest wymagana w przypadku każdego typu aplikacji wersji wtyczki Androida do obsługi Gradle. Aby uzyskać najlepszą skuteczność, korzystać z najnowszej wersji zarówno Gradle, jak i wtyczki.
| Wersja wtyczki | Minimalna wymagana wersja Gradle |
|---|---|
| 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 |
| 7.4 | 7,5 |
Starsze wersje
| Wersja wtyczki | Wymagana wersja Gradle |
|---|---|
| 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 lub nowszy | 6,5 lub więcej |
| 4.0.0+ | 6.1.1 lub nowszy |
| 3.6.0–3.6.4 | 5.6.4 lub nowszy |
| 3.5.0–3.5.4 | 5.4.1 lub nowszy |
| 3.4.0–3.4.3 | 5.1.1 lub nowszy |
| 3.3.0–3.3.3 | 4.10.1 lub nowszy |
| 3.2.0–3.2.1 | 4,6 lub nowszy |
| 3.1.0 lub nowszy | 4,4 lub nowszy |
| 3.0.0 lub nowsze | 4.1 lub nowszy |
| 2.3.0+ | 3,3 lub nowszy |
| 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 tym miejscu: Plik >
Struktura projektu > menu Projekt w Android Studio,
lub zaktualizuj wersję Gradle za pomocą wiersza poleceń.
Preferowany sposób to użycie funkcji
Opakowanie Gradle
narzędzie wiersza poleceń, które aktualizuje skrypty gradlew. Poniżej
Ten przykład ustawia wersję Gradle na 8.5 za pomocą komponentu Gradle Wrapper.
Aby uaktualnić zarówno Gradle, jak i
Sama obudowa Gradle Wrapper (więcej informacji:
Uaktualnianie kodu Gradle Wrapper).
gradle wrapper --gradle-version 8.5
W niektórych przypadkach może się to jednak nie udać, jeśli na przykład niedawno zaktualizujesz AGP
i nie jest już zgodny z bieżącą wersją Gradle. W tym przypadku
edytuj odniesienie do dystrybucji Gradle w pliku
gradle/wrapper/gradle-wrapper.properties. Poniżej
ustawia wersję Gradle na 8.5 w
gradle-wrapper.properties.
...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.5-bin.zip
...
Gradle Androida wtyczka i zgodność z Android Studio
System kompilacji Android Studio oparty jest na Gradle i narzędziu Android Gradle. wtyczki (AGP) dodaje kilka funkcji charakterystycznych dla tworzenia aplikacji na Androida. w poniższej tabeli podano, które wersje AGP są wymagane w przypadku poszczególnych wersji Android Studio.
| Wersja Android Studio | Wymagana wersja AGP |
|---|---|
| Koala | 1.2024.2024 | 3,2–8,5 |
| Meduza | 1.03.2023 r. | 3,2–8,4 |
| Iguana | 1.2023.2023 | 3,2–8,3 |
| Jeż | 1.01.2023 r. | 3,2–8,2 |
| Żyrafa | 1.03.2022 | 3.2–8.1 |
| Flaming | 1.2022.2022 | 3,2–8,0 |
Starsze wersje
| Wersja Android Studio | Wymagana wersja AGP |
|---|---|
| Węgorz elektryczny | 1.2022.2022 r. | 3,2–7,4 |
| Delfin | 1.03.2021 | 3,2–7,3 |
| Wiewiórka | 1.2021.2021 | 3,2–7,2 |
| Trzmiel | 1.01.2021 | 3.2–7.1 |
| Lis polarny | 1.03.2020 | 3,1–7,0 |
Informacje o nowościach we wtyczce Androida do obsługi Gradle znajdziesz w Informacje o wersji wtyczki Android do obsługi Gradle.
Minimalna liczba wersji narzędzi na poziomie interfejsu API Androida
Istnieją minimalne wersje Android Studio i AGP, które obsługują określony interfejs API
na poziomie 300%. Nie używasz wersji Android Studio lub AGP w wersji starszej niż wymagana
targetSdk lub compileSdk projektu mogą spowodować nieoczekiwane problemy. Śr
zalecamy korzystanie z najnowszej wersji testowej Android Studio i AGP
projektów, które są kierowane na wersje testowe systemu operacyjnego Android. Dostępne opcje
instaluj
wersji testowej Androida Studio oraz wersji stabilnej.
Minimalne wersje Android Studio i AGP to:
| Poziom interfejsu API | Minimalna wersja Android Studio | Minimalna wersja AGP |
|---|---|---|
| Wersja testowa VanillaIceCream | Meduza | 1.03.2023 r. | 8.4 |
| 34 | Jeż | 1.01.2023 r. | 8.1.1 |
| 33 | Flaming | 1.2022.2022 | 7.2 |
Zmiany w obsłudze wersji (listopad 2020 r.)
Aktualizujemy numerację wersji wtyczki Androida do obsługi Gradle (AGP) na wyższą ściśle pasuje do bazowego narzędzia do kompilacji Gradle.
Oto najważniejsze zmiany:
Interfejs AGP będzie teraz korzystać z semantycznej obsługi wersji, a zmiany powodujące niezgodność przeznaczonego na duże wydania.
Każdego roku publikujemy jedną główną wersję pakietu AGP, wersji głównej Gradle.
Aktualizacja AGP 4.2 będzie dostępna w wersji 7.0 i będzie wymagać uaktualnienia. do Gradle w wersji 7.x. Każda duża wersja pakietu AGP wymaga w odpowiednim narzędziu Gradle.
Interfejsy API zostaną wycofane z około rocznym wyprzedzeniem i zastępcza. Wycofane interfejsy API zostaną usunięte około roku później podczas kolejnych głównych .
Zgodność
Maksymalny poziom interfejsu API, na którym wtyczka Androida do obsługi Gradle w wersji 8.5 jest obsługiwany poziom API 34. Oto inne informacje o zgodności:
| Wersja minimalna | Wersja domyślna | Uwagi | |
|---|---|---|---|
| Gradle | 8,7 | 8,7 | Więcej informacji znajdziesz w artykule na temat aktualizowania Gradle. |
| Narzędzia do tworzenia pakietów SDK | 34.0.0 | 34.0.0 | Zainstaluj lub skonfiguruj narzędzia SDK Build Tools. |
| NDK | Nie dotyczy | 26.1.10909125 | Zainstaluj lub skonfiguruj inną wersję NDK. |
| JDK | 17 | 17 | Więcej informacji znajdziesz w sekcji o ustawianiu wersji pakietu JDK. |
Wersje poprawek
Poniżej znajdziesz listę poprawek w Android Studio Koala i wtyczka Androida do obsługi Gradle w wersji 8.5.
Android Studio Koala | Poprawki 1 i 8.5.1 AGP 2024.1.1 (lipiec 2024 r.)
Ta drobna aktualizacja obejmuje te poprawki błędów.