Informacje o wersji wtyczki Androida do obsługi Gradle w wersji 8.6

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:

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
}

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.

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.

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:

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: