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
z wersji 8.6.0
Plik build.gradle.kts:
Kotlin
plugins {
id("com.android.application") version "8.6.0" apply false
id("com.android.library") version "8.6.0" apply false
id("org.jetbrains.kotlin.android") version "2.0.20" apply false
}
Odlotowe
plugins {
id 'com.android.application' version '8.6.0' apply false
id 'com.android.library' version '8.6.0' apply false
id 'org.jetbrains.kotlin.android' version '2.0.20' apply false
}
Uwaga: nie używaj w wersji zależności dynamicznych.
takie jak
'com.android.tools.build:gradle:8.6.+'
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ędzia wiersza poleceń, które aktualizuje skrypty gradlew. Poniżej
W tym przykładzie ustawiamy wersję Gradle na 8.6 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.6
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.6 w
gradle-wrapper.properties.
...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.6-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 |
|---|---|
| Biedronka | 1.2024.2024 | 3,2–8,7 |
| Pakiet funkcji koala | 2.01.2024 r. | 3,2–8,6 |
| 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 ściśle pasuje do bazowego narzędzia do kompilacji Gradle.
Oto najważniejsze zmiany:
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.
Aktualizacje AGP 4.2 będą udostępniane w wersji 7.0 i będą wymagały aktualizacji. 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 która jest dostępna w tym samym czasie. Wycofane interfejsy API zostaną usunięte około roku później podczas kolejnych głównych .
Zgodność
Maksymalny poziom interfejsu API obsługiwany przez wtyczkę Androida do obsługi Gradle 8.6 to poziom 34. Oto inne informacje o zgodności: