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.

android skills add agp-9-upgrade

Aktualizowanie wtyczki Androida do obsługi Gradle

Podczas aktualizacji 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.4.0 z pliku build.gradle.kts:

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

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

Ostrzeżenie: w numerach wersji nie należy używać zależności dynamicznych, np. 'com.android.tools.build:gradle:9.4.+'. 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ępnym tworzeniu 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.6.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.6.0

Może się to jednak nie udać w niektórych przypadkach, np. jeśli właśnie zaktualizowano AGP i 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. W tym przykładzie w pliku gradle-wrapper.properties ustawiono wersję Gradle na 9.6.0.

...
distributionUrl = https\://services.gradle.org/distributions/gradle-9.6.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 wersje wtyczki Androida do obsługi Gradle wymagane 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. Zalecamy korzystanie z najnowszej wersji podglądowej Androida Studio i AGP do pracy nad projektami, które są przeznaczone na wersje podglądowe systemu Android. Możesz zainstalować wersje podglądowe Android Studio obok wersji stabilnej.

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