Informacje o wersji 8.7 wtyczki Androida do obsługi Gradle

System kompilacji Android Studio jest oparty na Gradle, a wtyczka Androida do obsługi Gradle dodaje kilka funkcji specyficznych dla kompilacji aplikacji na Androida. Chociaż wtyczka Androida do obsługi Gradle (AGP) jest zwykle aktualizowana równolegle z Android Studio, może działać niezależnie od tej aplikacji i być aktualizowana osobno.

Z tej strony dowiesz się, jak aktualizować narzędzia Gradle i co zawiera najnowsza wersja. Informacje o wersjach wtyczki Gradle na Androida znajdziesz w informacjach o poprzednich wersjach.

Aby sprawdzić, co zostało naprawione w tej wersji wtyczki Gradle dla Androida, zapoznaj się z rozwiązanymi problemami.

Ogólne omówienie nadchodzących zmian w funkcjonalnościach wtyczki 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
• Wtyczka Androida do obsługi Gradle – dokumentacja DSL
• Informacje o Gradle DSL
• Przewodnik użytkownika dotyczący wydajności Gradle

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

Aktualizacja wtyczki Androida do obsługi Gradle

Podczas aktualizacji Android Studio możesz zobaczyć prośbę 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ń kompilacji projektu.

Wersję wtyczki możesz określić w menu Plik > Struktura projektu > Projekt w Android Studio lub w pliku najwyższego poziomu build.gradle.kts. Wersja wtyczki dotyczy wszystkich modułów utworzonych w tym projekcie Android Studio. Ten przykład ustawia dla wtyczki w wersji 8.7.0 z pliku build.gradle.kts:

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

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

Uwaga: nie używaj zależności dynamicznych w numerach wersji, np. 'com.android.tools.build:gradle:8.7.+'. Korzystanie z tej funkcji może spowodować nieoczekiwane aktualizacje wersji i utrudnić rozwiązanie różnic między wersjami.

Jeśli wybrana wersja wtyczki nie została pobrana, Gradle pobierze ją następnym razem, gdy skompilujesz projekt lub klikniesz Plik > Synchronizuj projekt z plikami Gradle na pasku menu Android Studio.

Aktualizacja Gradle

Podczas aktualizacji Android Studio możesz zobaczyć prośbę o zaktualizowanie Gradle do najnowszej dostępnej wersji. Możesz zaakceptować aktualizację lub ręcznie określić wersję na podstawie wymagań kompilacji 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 najnowszej 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ń. Preferowanym sposobem jest użycie narzędzia wiersza poleceń Gradle Wrapper, które aktualizuje skrypty gradlew. W tym przykładzie za pomocą Gradle Wrapper ustawiamy wersję Gradle na 8.7. Aby uaktualnić zarówno Gradle, jak i samą opakowanie Gradle Wrapper, musisz 2 razy uruchomić to polecenie (więcej informacji znajdziesz w artykule Uaktualnianie kodu Gradle Wrapper).

gradle wrapper --gradle-version 8.7

W niektórych przypadkach może się to jednak nie udać, jeśli na przykład po zaktualizowaniu interfejsu AGP 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. Ten przykład ustawia wersję Gradle w pliku gradle-wrapper.properties na 8.7.

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

Wtyczka Androida do obsługi Gradle i zgodność z Android Studio

System kompilacji Android Studio jest oparty na Gradle, a wtyczka Android Gradle (AGP) dodaje kilka funkcji specyficznych dla kompilowania aplikacji na Androida. W tabeli poniżej znajdziesz, która wersja AGP jest wymagana w przypadku każdej wersji Android Studio.

Nowości w wtyczce Androida do obsługi Gradle znajdziesz w informacjach o wersji wtyczki Androida do Gradle.

Minimalne wersje narzędzi dla poziomu interfejsu API Androida

Istnieją minimalne wersje Android Studio i AGP, które obsługują określony poziom interfejsu API. Używanie starszych wersji Androida Studio lub AGP niż wymagane przez targetSdk lub compileSdk projektu może spowodować nieoczekiwane problemy. Przy projektach kierowanych na wersje testowe systemu operacyjnego Android zalecamy korzystanie z najnowszych wersji przedpremierowych Android Studio i AGP. Możesz zainstalować wersje podglądowe Android Studio obok stabilnej wersji.

Minimalne wersje Android Studio i AGP to:

Zmiany dotyczące wersji (listopad 2020 r.)

Aktualizujemy numerację wersji wtyczki Androida do obsługi Gradle (AGP), aby była bardziej zbliżona do numeracji narzędzia do kompilacji Gradle.

Oto najważniejsze zmiany:

• AGP będzie teraz używać wersji semantycznej, a zmiany powodujące przerwanie działania będą kierowane na główne wersje.

• W ciągu roku będzie wydawana jedna główna wersja AGP, zgodna z wersją główną Gradle.

• Po aktualizacji AGP 4.2 zostanie ona udostępniona w wersji 7.0 i będzie wymagać uaktualnienia Gradle do wersji 7.x. Każda główna wersja AGP będzie wymagać uaktualnienia wersji głównej w podstawowym narzędziu Gradle.

• Interfejsy API zostaną wycofane z okresem około 1 roku, a w tym samym czasie udostępnione zostaną funkcje zastępcze. Wycofane interfejsy API zostaną usunięte około roku później podczas kolejnej dużej aktualizacji.

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:

Zmiana działania lintowania

Począwszy od wtyczki Androida do obsługi Gradle w wersji 8.7.0-alfa08, jeśli podczas uruchamiania lintowania za pomocą Gradle istnieje zdarzenie LintError, zadanie analizy lintowania zgłosi wyjątek. Ta zmiana zapobiega buforowaniu rzadkich błędów w pamięci podręcznej kompilacji.

Ta zmiana powoduje jednak przerwanie kompilacji w projektach, które w plikach bazowych lintowego mają autentyczne instancje LintError. Komunikat o błędzie zawiera informacje o tym, które kontrole lint powodują problem. W niektórych przypadkach problem może rozwiązać zaktualizowanie odpowiedniej biblioteki zależnej. Jeśli nie, możesz wyłączyć problemowe sprawdzanie lint, dopóki autor biblioteki nie naprawi problemu.

Rozwiązane problemy

Wtyczka Androida do obsługi Gradle 8.7.0

Wtyczka Androida do obsługi Gradle w wersji 8.7.1

Wtyczka Androida do obsługi Gradle 8.7.2