Note di rilascio del plug-in Android per Gradle 8.12

Il sistema di compilazione di Android Studio si basa su Gradle e il plug-in Android per Gradle aggiunge diverse funzionalità specifiche per la compilazione di app per Android. Anche se il plug-in Android per Gradle (AGP) viene in genere aggiornato in modo sincronizzato con Android Studio, il plug-in (e il resto del sistema Gradle) può essere eseguito indipendentemente da Android Studio e può essere aggiornato separatamente.

Questa pagina spiega come mantenere aggiornati gli strumenti Gradle e cosa contengono gli aggiornamenti recenti. Per le note di rilascio delle versioni precedenti del plug-in Android per Gradle, consulta le note di rilascio precedenti.

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 dell'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 tuo 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 creati in questo progetto Android Studio. L'esempio seguente imposta il plug-in sulla versione 8.12.0 dal file build.gradle.kts:

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

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

Attenzione:non devi utilizzare dipendenze dinamiche nei numeri di versione, ad esempio 'com.android.tools.build:gradle:8.12.+'. 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 prompt per 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 8.13 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 Upgrade del wrapper Gradle).

gradle wrapper --gradle-version 8.13

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 8.13 nel file gradle-wrapper.properties.

...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.13-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:

Modifiche al controllo delle versioni (novembre 2020)

Stiamo aggiornando la numerazione delle versioni del plug-in Android per Gradle (AGP) in modo che corrisponda più da vicino allo strumento di compilazione Gradle sottostante.

Ecco le modifiche più importanti:

• AGP ora utilizzerà il controllo delle versioni semantico e le modifiche che causano interruzioni saranno destinate alle release principali.

• Ogni anno verrà rilasciata una versione principale di AGP, in linea con la versione principale di Gradle.

• La release successiva ad AGP 4.2 sarà la versione 7.0 e richiederà un upgrade a Gradle versione 7.x. Ogni versione principale di AGP richiederà un upgrade della versione principale dello strumento Gradle sottostante.

• Le API verranno ritirate con circa un anno di anticipo e la funzionalità sostitutiva verrà resa disponibile contemporaneamente. Le API deprecate verranno rimosse circa un anno dopo durante l'aggiornamento principale successivo.

Compatibilità

Il livello API massimo supportato dal plug-in Android per Gradle 8.12 è il livello API 36. Ecco altre informazioni sulla compatibilità:

Problemi risolti

Plug-in Android per Gradle 8.12.0