Informacje o wtyczce Androida do obsługi Gradle

System kompilacji Androida 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 dbać o aktualność narzędzi 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 planie 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 Gradle DSL
• 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

Podczas aktualizowania Androida 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ń projektu.

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 dotyczy wszystkich modułów utworzonych w tym projekcie Androida Studio. W tym przykładzie wtyczka jest ustawiana na wersję 9.0 z pliku build.gradle.kts:

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

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

Ostrzeżenie: w numerach wersji nie należy używać zależności dynamicznych, np. 'com.android.tools.build:gradle:9.+'. Korzystanie z tej funkcji może powodować nieoczekiwane aktualizacje wersji i utrudniać 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 po kliknięciu Plik > Synchronizuj projekt z plikami Gradle na pasku menu Android Studio.

Aktualizowanie Gradle

Podczas aktualizacji Androida 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ń 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 najnowszych 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ń. Zalecamy użycie narzędzia wiersza poleceń Gradle Wrapper, które aktualizuje skrypty gradlew. W tym przykładzie ustawiamy wersję Gradle na 9.1.0 za pomocą narzędzia Gradle Wrapper. Pamiętaj, że to polecenie musisz uruchomić 2 razy, aby zaktualizować zarówno Gradle, jak i sam Gradle Wrapper (więcej informacji znajdziesz w artykule Aktualizowanie Gradle Wrapper).

gradle wrapper --gradle-version 9.1.0

W niektórych przypadkach może się to jednak nie udać, np. jeśli właśnie zaktualizowano AGP i nie jest on już zgodny z bieżącą wersją Gradle. W takim przypadku musisz edytować odwołanie do dystrybucji Gradle w pliku gradle/wrapper/gradle-wrapper.properties. W tym przykładzie w pliku gradle-wrapper.properties ustawiono wersję Gradle na 9.1.0.

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

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

System kompilacji Androida 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 wtyczki Androida do obsługi Gradle jest wymagana w przypadku poszczególnych 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 AGP, które obsługują określony poziom API. Używanie starszych wersji Androida Studio lub wtyczki Androida do obsługi Gradle niż wymagane przez targetSdk lub compileSdk projektu może prowadzić do nieoczekiwanych problemów. Do pracy nad projektami, które są przeznaczone dla wersji testowych systemu operacyjnego Android, zalecamy używanie najnowszej wersji testowej Androida Studio i wtyczki Androida do obsługi Gradle. Możesz zainstalować wersje podglądowe Androida Studio obok wersji stabilnej.

Minimalne wersje Android Studio i AGP są następujące: