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 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 użytkownika dotyczący 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 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. Poniższy przykład ustawia wtyczkę w wersji 9.2.0 z pliku build.gradle.kts:

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

plugins {
    id 'com.android.application' version '9.2.0' apply false
    id 'com.android.library' version '9.2.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.2.+'. Korzystanie z tej funkcji może powodować nieoczekiwane aktualizacje wersji i trudności z rozwiązywaniem 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. Poniższy przykład ustawia wersję Gradle na 9.4.1 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.4.1

W niektórych przypadkach może to jednak się nie udać, np. jeśli właśnie zaktualizowano wtyczkę Androida do obsługi Gradle i nie jest ona już zgodna z bieżącą wersją Gradle. W takim przypadku, musisz edytować odniesienie do dystrybucji Gradle w pliku gradle/wrapper/gradle-wrapper.properties. Poniższy przykład ustawia wersję Gradle na 9.4.1 w pliku gradle-wrapper.properties.

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

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

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. W tabeli poniżej znajdziesz informacje o tym, która wersja wtyczki Androida do obsługi Gradle jest wymagana w przypadku każdej wersji Androida Studio.

Informacje 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 Androida Studio i wtyczki Androida do obsługi Gradle, które obsługują określony poziom interfejsu API. Używanie wersji Androida Studio lub wtyczki Androida do obsługi Gradle starszych niż wymagane przez targetSdk lub compileSdk w projekcie może prowadzić do nieoczekiwanych problemów. W przypadku projektów, które są przeznaczone na wersje testowe systemu operacyjnego Android, zalecamy używanie najnowszej wersji testowej Androida Studio i wtyczki Androida do obsługi Gradle. Wersje testowe Androida Studio możesz zainstalować obok wersji stabilnej.

Minimalne wersje Androida Studio i wtyczki Androida do obsługi Gradle są takie: