Informacje o wtyczce 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ą specyficzne dla kompilowania aplikacji na Androida.

Na tej stronie dowiesz się, jak aktualizować narzędzia Gradle. Informacje o wersji wtyczki Androida do obsługi Gradle znajdziesz na stronie z informacjami o wersji.

Ogólne podsumowanie nadchodzących zmian powodujących niezgodność we wtyczce Androida do obsługi Gradle znajdziesz w artykule Plan rozwoju 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 użytkownika dotyczący wydajności Gradle

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

android skills add --skill agp-9-upgrade

Aktualizowanie wtyczki Androida do obsługi Gradle

Gdy zaktualizujesz Android Studio, może pojawić się prośba 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 Android Studio w menu Plik > Struktura projektu > Projekt lub w pliku build.gradle.kts najwyższego poziomu. Wersja wtyczki dotyczy wszystkich modułów skompilowanych w tym projekcie Android Studio. Ten przykład ustawia wtyczkę na wersję 9.3.0 w build.gradle.kts pliku:

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

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

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

Jeśli określona wersja wtyczki nie została pobrana, Gradle pobierze ją przy następnej kompilacji projektu lub gdy w pasku menu Android Studio klikniesz Plik > Synchronizuj projekt z plikami Gradle.

Aktualizowanie Gradle

Gdy zaktualizujesz Android Studio, może pojawić się prośba 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 każdej wersji wtyczki Androida do obsługi Gradle. Aby uzyskać najlepszą wydajność, używaj najnowszej możliwej wersji Gradle i wtyczki.

Wersję Gradle możesz określić w Android Studio w menu Plik > Struktura projektu > Projekt lub zaktualizować ją za pomocą wiersza poleceń. Zalecamy używanie narzędzia wiersza poleceń Gradle Wrapper, które aktualizuje skrypty gradlew. Ten przykład ustawia wersję Gradle na 9.5.0 za pomocą Gradle Wrapper. Aby zaktualizować zarówno Gradle, jak i Gradle Wrapper, musisz uruchomić to polecenie 2 razy (więcej informacji znajdziesz w artykule Aktualizowanie Gradle Wrapper).

gradle wrapper --gradle-version 9.5.0

W niektórych przypadkach może to jednak się nie udać, np. jeśli właśnie zaktualizowano AGP i nie jest ono już zgodne z bieżącą wersją Gradle. W takim przypadku, musisz edytować odniesienie do dystrybucji Gradle w pliku gradle/wrapper/gradle-wrapper.properties. Ten przykład ustawia wersję Gradle na 9.5.0 w pliku gradle-wrapper.properties.

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

Zgodność wtyczki Androida do obsługi Gradle i Android Studio

System kompilacji Android Studio jest oparty na Gradle, a wtyczka Androida do obsługi Gradle (AGP) dodaje kilka funkcji, które są specyficzne dla kompilowania aplikacji na Androida. W tabeli poniżej znajdziesz informacje o tym, która wersja AGP jest wymagana w przypadku każdej wersji Android Studio.

Więcej informacji o nowościach we wtyczce Androida do obsługi Gradle znajdziesz w informacjach o wersji wtyczki Androida do obsługi 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 wersji Android Studio lub AGP starszych niż wymagane przez targetSdk lub compileSdk w projekcie może prowadzić do nieoczekiwanych problemów. Zalecamy używanie najnowszej wersji testowej Android Studio i AGP do pracy nad projektami, które są przeznaczone na wersje testowe systemu operacyjnego Android. Wersje testowe Android Studio możesz zainstalować obok wersji stabilnej .

Minimalne wersje Android Studio i AGP są takie: