Informazioni sul plug-in Android per Gradle

Il sistema di compilazione di Android Studio si basa su Gradle e il plug-in Android Gradle aggiunge diverse funzionalità specifiche per la compilazione di app per Android.

Questa pagina spiega come mantenere aggiornati gli strumenti Gradle. Per le note di rilascio sul plug-in Android per Gradle, consulta la pagina delle note di rilascio.

Per un riepilogo generale delle prossime modifiche che causano interruzioni nel plug-in Android Gradle, consulta la roadmap del plug-in Android Gradle.

Per informazioni dettagliate su come configurare le build Android con Gradle, consulta le seguenti pagine:

• Configura la build
• Riferimento DSL del plug-in Android per Gradle
• Riferimento a Gradle DSL
• Guida per l'utente al rendimento di Gradle

Per ulteriori informazioni sul sistema di compilazione Gradle, consulta la Guida per l'utente di Gradle.

Aggiornare il plug-in Android per Gradle

Quando aggiorni Android Studio, potresti ricevere un prompt per aggiornare automaticamente il plug-in Android per Gradle all'ultima versione disponibile. Puoi scegliere di accettare l'aggiornamento o specificare manualmente una versione in base ai requisiti di build del progetto.

Puoi specificare la versione del plug-in nel menu File > Struttura progetto > Progetto in Android Studio oppure nel file build.gradle.kts di primo livello. La versione del plug-in si applica a tutti i moduli integrati nel progetto Android Studio. L'esempio seguente imposta il plug-in sulla versione 9.0 dal file 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
}

Attenzione:non devi utilizzare dipendenze dinamiche nei numeri di versione, ad esempio 'com.android.tools.build:gradle:9.+'. L'utilizzo di questa funzionalità può causare aggiornamenti imprevisti delle versioni e difficoltà nella risoluzione delle differenze tra le versioni.

Se la versione del plug-in specificata non è stata scaricata, Gradle la scarica la volta successiva che compili il progetto o fai clic su File > Sincronizza progetto con file Gradle dalla barra dei menu di Android Studio.

Aggiorna Gradle

Quando aggiorni Android Studio, potresti ricevere un messaggio che ti chiede di aggiornare anche Gradle all'ultima versione disponibile. Puoi scegliere di accettare l'aggiornamento o specificare manualmente una versione in base ai requisiti di build del progetto.

La tabella seguente elenca la versione di Gradle richiesta per ogni versione del plug-in Android per Gradle. Per ottenere prestazioni ottimali, devi utilizzare l'ultima versione possibile di Gradle e del plug-in.

Puoi specificare la versione di Gradle nel menu File > Project Structure > Project in Android Studio o aggiornare la versione di Gradle utilizzando la riga di comando. Il modo preferito è utilizzare lo strumento a riga di comando Gradle Wrapper, che aggiorna gli script gradlew. L'esempio seguente imposta la versione di Gradle su 9.1.0 utilizzando Gradle Wrapper. Tieni presente che devi eseguire questo comando due volte per eseguire l'upgrade sia di Gradle sia del wrapper Gradle stesso (per ulteriori informazioni, vedi Eseguire l'upgrade del wrapper Gradle).

gradle wrapper --gradle-version 9.1.0

Tuttavia, in alcuni casi l'operazione potrebbe non riuscire, ad esempio se hai appena aggiornato AGP e non è più conforme alla versione attuale di Gradle. In questo caso, devi modificare il riferimento alla distribuzione Gradle nel file gradle/wrapper/gradle-wrapper.properties. L'esempio seguente imposta la versione di Gradle su 9.1.0 nel file gradle-wrapper.properties.

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

Compatibilità del plug-in Android per Gradle e di Android Studio

Il sistema di compilazione di Android Studio si basa su Gradle e il plug-in Android per Gradle (AGP) aggiunge diverse funzionalità specifiche per la creazione di app per Android. La tabella seguente elenca la versione di AGP richiesta per ogni versione di Android Studio.

Per informazioni sulle novità del plug-in Android per Gradle, consulta le note di rilascio del plug-in Android per Gradle.

Versioni minime degli strumenti per il livello API Android

Esistono versioni minime di Android Studio e AGP che supportano un livello API specifico. L'utilizzo di versioni precedenti di Android Studio o AGP rispetto a quelle richieste da targetSdk o compileSdk del progetto potrebbe causare problemi imprevisti. Ti consigliamo di utilizzare l'ultima versione di anteprima di Android Studio e AGP per lavorare su progetti che hanno come target le versioni di anteprima del sistema operativo Android. Puoi installare le versioni di anteprima di Android Studio insieme a una versione stabile.

Le versioni minime di Android Studio e AGP sono le seguenti: