Informazioni sul plug-in Android per Gradle

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

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

Per un riepilogo generale delle imminenti modifiche che causano interruzioni nel plug-in Android per Gradle, consulta la roadmap del plug-in Android per 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 DSL di Gradle
• Guida per l'utente alle prestazioni di Gradle

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

Aggiorna il plug-in Android per Gradle

Quando aggiorni Android Studio, potresti ricevere un messaggio che ti chiede di 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 in nel menu File > Struttura del progetto > Progetto in Android Studio o nel file build.gradle.kts di primo livello. La versione del plug-in si applica a tutti i moduli creati nel progetto Android Studio. L'esempio seguente imposta il plug-in alla versione 9.2.0 dal build.gradle.kts file:

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
}

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

Se la versione del plug-in specificata non è stata scaricata, Gradle la scarica la volta successiva che crei 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 la versione più recente possibile sia di Gradle sia del plug-in.

Puoi specificare la versione di Gradle nel menu File > Struttura del progetto > Progetto in Android Studio oppure 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.4.1 utilizzando Gradle Wrapper. Tieni presente che devi eseguire questo comando due volte per eseguire l'upgrade sia di Gradle sia di Gradle Wrapper (per ulteriori informazioni, consulta Eseguire l'upgrade di Gradle Wrapper).

gradle wrapper --gradle-version 9.4.1

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

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

Compatibilità tra il plug-in Android per Gradle e Android Studio

Il sistema di compilazione di Android Studio è basato su Gradle e il plug-in Android per Gradle (AGP) aggiunge diverse funzionalità specifiche per la creazione di app 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 relative note di rilascio.

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 di Android Studio o AGP inferiori 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: