Informacje o wersji 8.4 wtyczki Androida do obsługi Gradle

System kompilacji Android Studio jest oparty na Gradle, a wtyczka Androida do obsługi Gradle dodaje kilka funkcji, które są charakterystyczne dla aplikacji na Androida. Chociaż wtyczka Androida do obsługi Gradle (AGP) jest zwykle aktualizowana w ramach blokady za pomocą Androida Studio, wtyczka (i reszta systemu Gradle) może działać niezależnie od Android Studio i aktualizować oddzielnie.

Z tego artykułu dowiesz się, jak dbać o aktualność narzędzi Gradle i jakie są najnowsze aktualizacje. Informacje o poprzednich wersjach wtyczki Androida do obsługi Gradle znajdziesz w wcześniejszych informacjach o wersjach.

Aby zobaczyć, jakie poprawki zostały naprawione w tej wersji wtyczki Androida do obsługi Gradle, zapoznaj się z zamkniętymi problemami.

Ogólne podsumowanie nadchodzących zmian powodujących niezgodność we wtyczce Androida do obsługi Gradle znajdziesz w harmonogramie 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 DSL Gradle
• Przewodnik po wydajności Gradle

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

Aktualizowanie wtyczki Androida do obsługi Gradle

Gdy zaktualizujesz Androida Studio, możesz zobaczyć prośbę o automatyczne zaktualizowanie wtyczki Androida do obsługi Gradle do najnowszej wersji. Możesz zaakceptować aktualizację lub ręcznie określić wersję zgodnie z wymaganiami projektu dotyczącymi kompilacji.

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 ma zastosowanie do wszystkich modułów utworzonych w tym projekcie Android Studio. Ten przykład ustawia wersję wtyczki na wersję 8.4.0 z pliku build.gradle.kts:

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

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

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

Jeśli określona wersja wtyczki nie została pobrana, Gradle pobierze ją, gdy następnym razem będziesz tworzyć projekt lub kliknij Plik > Synchronizuj projekt z plikami Gradle na pasku menu Android Studio.

Aktualizowanie Gradle

Podczas aktualizowania Androida Studio możesz zobaczyć prośbę o zaktualizowanie Gradle do najnowszej wersji. Możesz zaakceptować aktualizację lub ręcznie określić wersję zgodnie z wymaganiami projektu dotyczącymi kompilacji.

W tabeli poniżej znajdziesz listę wersji Gradle, która jest wymagana w przypadku poszczególnych wersji wtyczki Androida do obsługi Gradle. Aby uzyskać najlepszą wydajność, użyj najnowszej możliwej wersji Gradle i wtyczki.

Wersję Gradle możesz określić w menu Plik > Struktura projektu > Projekt w Android Studio. Wersję Gradle możesz też zaktualizować przy użyciu wiersza poleceń. Preferowanym sposobem jest użycie narzędzia wiersza poleceń Gradle Wrapper, które aktualizuje skrypty gradlew. Poniższy przykład ustawia wersję Gradle na 8.4 za pomocą otoki Gradle. Pamiętaj, że musisz uruchomić to polecenie dwukrotnie, aby uaktualnić zarówno Gradle, jak i samą paczkę Gradle (więcej informacji znajdziesz w artykule o uaktualnianiu otoki Gradle).

gradle wrapper --gradle-version 8.4

W niektórych przypadkach może to jednak się nie powieść, np. jeśli po niedawna zostało zaktualizowane AGP, które nie jest już zgodne z obecną wersją Gradle. W tym przypadku musisz edytować odniesienie do dystrybucji Gradle w pliku gradle/wrapper/gradle-wrapper.properties. Poniższy przykład ustawia wersję Gradle na 8.4 w pliku gradle-wrapper.properties.

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

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

System kompilacji Android Studio jest oparty na Gradle, a wtyczka Android do obsługi Gradle (AGP) dodaje kilka funkcji charakterystycznych dla tworzenia aplikacji na Androida. W tabeli poniżej znajdziesz listę wersji AGP, która jest wymagana w przypadku każdej wersji Androida Studio.

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

Minimalne wersje narzędzi na poziomie interfejsu Android API

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ż te wymagane przez targetSdk lub compileSdk projektu może spowodować nieoczekiwane problemy. Zalecamy korzystanie z najnowszej wersji testowej Android Studio i AGP przy projektach kierowanych na wersje przedpremierowe systemu operacyjnego Android. Możesz zainstalować podglądy Androida Studio obok wersji stabilnej.

Minimalne wersje Android Studio i AGP to:

Zmiany dotyczące obsługi wersji (listopad 2020 r.)

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

Oto najważniejsze zmiany:

• AGP będzie teraz używać semantycznej obsługi wersji, a zmiany powodujące niezgodność będą uwzględniane w głównych wersjach.

• Co roku będzie publikowana 1 wersja główna AGP zgodnie z wersją główną Gradle.

• Po wersji 4.2 wersja po 4.2 będzie to 7.0 i będzie wymagać uaktualnienia do Gradle w wersji 7.x. Każda główna wersja AGP będzie wymagała znacznego uaktualnienia wersji podstawowego narzędzia Gradle.

• Interfejsy API zostaną wycofane mniej więcej z rocznym wyprzedzeniem, a funkcje ich wymiany będą udostępniane równocześnie. Wycofane interfejsy API zostaną usunięte około roku później podczas kolejnej głównej aktualizacji.

Zgodność

Maksymalny poziom interfejsu API obsługiwany przez wtyczkę Androida do obsługi Gradle w wersji 8.3 to poziom API 34. Inne informacje dotyczące zgodności:

Oto nowe funkcje wtyczki Androida do obsługi Gradle w wersji 8.4.

Klasy w bibliotece zostały zmniejszone

Począwszy od wtyczki Androida do obsługi Gradle w wersji 8.4, jeśli projekt biblioteki Androida zostanie ograniczony, zmniejszone klasy programu zostaną opublikowane na potrzeby publikowania między projektami. Oznacza to, że jeśli aplikacja jest zależna od zmniejszonej wersji podprojektów biblioteki Androida, plik APK będzie zawierał zmniejszone klasy biblioteki Androida. Jeśli w pliku APK brakuje klas, może być konieczne dostosowanie reguł przechowywania biblioteki.

Jeśli tworzysz i publikujesz AAR, lokalne pliki jar, od których zależna jest Twoja biblioteka, zostaną uwzględnione w AAR w niezmienionej formie, co oznacza, że ograniczacz kodu nie będzie na nich działać.

Aby przywrócić poprzednie działanie, ustaw parametr android.disableMinifyLocalDependenciesForLibraries w pliku gradle.properties i zgłoś błąd. Kolejne wersje Zasad AGP usuną tę flagę.