Note di rilascio del plug-in Android per Gradle 8.6

Il sistema di build di Android Studio si basa su Gradle e Android Gradle aggiunge diverse funzionalità specifiche per la creazione delle app Android. Sebbene il plug-in Android Gradle (AGP) viene generalmente aggiornato in fase di blocco con Android Studio, il plug-in (e il resto del sistema Gradle) può essere eseguito indipendentemente Android Studio e essere aggiornato separatamente.

In questa pagina viene spiegato come mantenere gli strumenti Gradle fino a data e gli aggiornamenti recenti. Per le note di rilascio relative ad Android precedenti per le versioni dei plug-in Gradle, consulta note di rilascio passate.

Per informazioni sui problemi risolti in questa versione del plug-in Android per Gradle, consulta: i problemi chiusi.

Per un riepilogo generale delle imminenti modifiche che provocano un errore in Android Gradle vedi il plug-in per Android Roadmap del plug-in Gradle.

Per maggiori dettagli su come configurare le build Android con Gradle, consulta le seguenti pagine:

• Configura la tua build
• Riferimento DSL per il plug-in Android Gradle
• Riferimento DSL Gradle
• Guida dell'utente sulle prestazioni di Gradle

Per saperne di più sul sistema di compilazione Gradle, consulta Guida dell'utente di Gradle.

Aggiorna il plug-in Android per Gradle

Quando aggiorni Android Studio, potresti ricevere automaticamente la richiesta aggiornare il plug-in Android per Gradle all'ultima versione disponibile. Tu 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 il file File > Progetto Struttura > Menu Progetto in Android Studio oppure il file build.gradle.kts di primo livello. La versione del plug-in è valida per tutti i moduli sviluppati in quel progetto Android Studio. Gli esempi che seguono impostano il plug-in alla versione 8.6.0 dal File build.gradle.kts:

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

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

Attenzione: non utilizzare le dipendenze dinamiche nella versione numeri come 'com.android.tools.build:gradle:8.6.+'. L'uso di questa funzionalità può causare problemi e aggiornamenti della versione imprevisti risolvere le differenze di versione.

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

Aggiorna Gradle

Quando aggiorni Android Studio, potresti ricevere una richiesta di aggiornare Gradle all'ultima versione disponibile. Puoi scegliere di accettare i aggiorna o specifica manualmente una versione in base alla build del progetto i tuoi requisiti.

Nella tabella seguente viene elencata la versione di Gradle richiesta per ogni del plug-in Android per Gradle. Per un rendimento ottimale, devi utilizzare l'ultima versione possibile sia di Gradle sia del plug-in.

Puoi specificare la versione Gradle nel campo File > Struttura del progetto > Menu Progetto in Android Studio, o aggiornare la versione di Gradle utilizzando la riga di comando. Il modo migliore è utilizzare Wrapper Gradle a riga di comando, che aggiorna gli script gradlew. Le seguenti esempio imposta la versione Gradle su 8.6 utilizzando il wrapper Gradle. Tieni presente che devi eseguire questo comando due volte per eseguire l'upgrade di Gradle e Wrapper Gradle (per ulteriori informazioni, vedi Upgrade del wrapper Gradle).

gradle wrapper --gradle-version 8.6

In alcuni casi potrebbe però non riuscire, ad esempio se hai appena aggiornato AGP e non è più conforme all'attuale versione di Gradle. In questo caso, devi modificare il riferimento alla distribuzione Gradle gradle/wrapper/gradle-wrapper.properties. Le seguenti di esempio imposta la versione Gradle su 8.6 gradle-wrapper.properties.

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

Android Gradle plug-in e compatibilità con Android Studio

Il sistema di build di Android Studio si basa su Gradle e Android Gradle (AGP) aggiunge diverse funzionalità specifiche per la creazione di app Android. La la seguente tabella elenca quale versione di AGP è richiesta per ogni versione di Android Studio.

Per informazioni sulle novità del plug-in Android Gradle, consulta la 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'API specifica livello. Utilizzare versioni precedenti di Android Studio o AGP rispetto a quelle richieste dalla tua l'elemento targetSdk o compileSdk del progetto potrebbe causare problemi imprevisti. Me consigliamo di utilizzare l'ultima versione di anteprima di Android Studio e AGP per lavorare progetti che hanno come target versioni di anteprima del sistema operativo Android. Puoi installa visualizza l'anteprima delle versioni 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 per il plug-in Android Gradle (AGP) a molto simile allo strumento di creazione Gradle sottostante.

Ecco le modifiche più importanti:

• AGP ora utilizzerà il controllo delle versioni semantico e le modifiche che provocano un errore verranno destinati alle versioni principali.

• Verrà rilasciata una versione principale di AGP all'anno, in linea con la release principale di Gradle.

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

• Le API verranno ritirate circa un anno prima, con una funzionalità di sostituzione resa disponibile contemporaneamente. API deprecate verrà rimossa circa un anno dopo, durante i successivi aggiornamento.

Compatibilità

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