Il sistema di build di Android Studio è basato su Gradle e il plug-in Android Gradle aggiunge diverse funzionalità specifiche per la creazione di app per Android. Anche se il plug-in Android per 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 da Android Studio ed essere aggiornato separatamente.
In questa pagina viene spiegato come mantenere aggiornati gli strumenti Gradle e quali sono le novità negli aggiornamenti recenti. Per le note di rilascio delle versioni precedenti del plug-in Android Gradle, consulta le note di rilascio precedenti.
Per scoprire le correzioni apportate in questa versione del plug-in Android per Gradle, consulta i problemi chiusi.
Per un riepilogo generale delle imminenti modifiche che interessano il plug-in Android per Gradle, consulta la Roadmap del plug-in Android 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 Gradle Android
- Riferimento Gradle DSL
- Guida dell'utente sulla valutazione del rendimento
Per ulteriori informazioni sul sistema di build Gradle, consulta la guida dell'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 nel menu File > Struttura del 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 alla versione 8.4.0 dal
file build.gradle.kts:
Kotlin
plugins {
id("com.android.application") version "8.4.0" apply false
id("com.android.library") version "8.4.0" apply false
id("org.jetbrains.kotlin.android") version "1.9.23" apply false
}
trendy
plugins {
id 'com.android.application' version '8.4.0' apply false
id 'com.android.library' version '8.4.0' apply false
id 'org.jetbrains.kotlin.android' version '1.9.23' apply false
}
Attenzione: non utilizzare dipendenze dinamiche nei numeri di versione, ad esempio
'com.android.tools.build:gradle:8.4.+'.
L'uso di questa funzionalità può causare aggiornamenti di versione imprevisti e difficoltà a risolvere le differenze di versione.
Se la versione del plug-in specificata non è stata scaricata, Gradle la scarica alla successiva creazione del progetto o fai clic su File > Sincronizza progetto con i file Gradle dalla barra dei menu di Android Studio.
Aggiorna Gradle
Quando aggiorni Android Studio, potresti ricevere anche una richiesta di aggiornare 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.
Nella tabella seguente è indicata la versione di Gradle richiesta per ogni versione del plug-in Android per Gradle. Per ottenere le migliori prestazioni, devi utilizzare l'ultima versione possibile di Gradle e del plug-in.
| Versione del plug-in | Versione Gradle minima richiesta |
|---|---|
| 8.4 | 8,6 |
| 8.3 | 8.4 |
| 8.2 | 8.2 |
| 8.1 | con Android 8.0 |
| con Android 8.0 | con Android 8.0 |
| 7,4 | 7,5 |
Versioni precedenti
| Versione del plug-in | Versione Gradle richiesta |
|---|---|
| 7,3 | 7,4 |
| 7,2 | 7.3.3 |
| 7.1 | 7,2 |
| 7,0 | 7,0 |
| 4.2.0 e oltre | 6.7.1 |
| 4.1.0 e versioni successive | Più di 6,5 |
| 4.0.0 e oltre | 6.1.1 e versioni successive |
| 3.6.0 - 3.6.4 | 5.6.4 e versioni successive |
| 3,5,0-3,5,4 | 5.4.1 e versioni successive |
| 3.4.0 - 3.4.3 | 5.1.1 e versioni successive |
| 3,3.0 - 3,3.3 | 4.10.1 e versioni successive |
| 3.2.0 - 3.2.1 | Più di 4,6 |
| 3.1.0 e oltre | Più di 4,4 |
| 3.0.0 e oltre | Più di 4,1 |
| 2.3.0 e oltre | Più di 3,3 |
| 2.1.3 - 2.2.3 | 2.14.1 - 3,5 |
| 2.0.0 - 2.1.2 | 2,10 - 2,13 |
| 1,5,0 | 2.2.1 - 2,13 |
| 1.2.0 - 1.3.1 | 2,2,1-2,9 |
| 1,0,0 - 1,1,3 | 2.2.1 - 2.3 |
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 metodo preferito è utilizzare lo strumento a riga di comando Gradle Wrapper, che aggiorna gli script gradlew. L'esempio seguente imposta la versione Gradle a 8.4 utilizzando il wrapper Gradle.
Tieni presente che devi eseguire questo comando due volte per eseguire l'upgrade sia di Gradle sia del wrapper Gradle (per ulteriori informazioni, consulta Upgrade del wrapper Gradle).
gradle wrapper --gradle-version 8.4
Tuttavia, in alcuni casi questa operazione potrebbe 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 nel file gradle/wrapper/gradle-wrapper.properties. L'esempio seguente imposta la versione Gradle su 8.4 nel file gradle-wrapper.properties.
...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.4-bin.zip
...
Compatibilità del plug-in Android Gradle e di Android Studio
Il sistema di build di Android Studio è basato su Gradle e il plug-in Android Gradle (AGP) aggiunge diverse funzionalità specifiche per la creazione di app per Android. Nella tabella seguente è indicata la versione di AGP richiesta per ogni versione di Android Studio.
| Versione di Android Studio | Versione AGP obbligatoria |
|---|---|
| Koala | 1.1.2024 | 3,2-8,5 |
| Meduse | 1.3.2023 | 3,2-8,4 |
| Iguana | 1/2/2023 | 3,2-8,3 |
| Riccio | 1.1.2023 | 3,2-8,2 |
| Giraffa | 1.3.2022 | 3,2-8,1 |
| Fenicottero | 1.2.2022 | 3,2-8,0 |
Versioni precedenti
| Versione di Android Studio | Versione AGP obbligatoria |
|---|---|
| Anguilla elettrica | 1.1.2022 | 3,2-7,4 |
| Delfino | 1.3.2021 | 3,2-7,3 |
| Scoiattolo americano | 1/2/2021 | 3,2-7,2 |
| Bombolo | 1.1.2021 | 3,2-7,1 |
| Volpe artica | 2020.3.1 | 3,1-7,0 |
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 di Android Studio o AGP precedenti a quelle richieste dalle 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 in anteprima del sistema operativo Android. Puoi installare versioni di anteprima di Android Studio oltre a una versione stabile.
Le versioni minime di Android Studio e AGP sono le seguenti:
| Livello API | Versione minima di Android Studio | Versione AGP minima |
|---|---|---|
| Anteprima VanillaIceCream | Meduse | 1.3.2023 | 8.4 |
| 34 | Riccio | 1.1.2023 | 8.1.1 |
| 33 | Fenicottero | 1.2.2022 | 7,2 |
Modifiche al controllo delle versioni (novembre 2020)
Stiamo aggiornando la numerazione delle versioni per il plug-in Android Gradle (AGP) in modo che corrisponda meglio allo strumento di creazione Gradle sottostante.
Ecco le modifiche più significative:
AGP ora utilizzerà il controllo delle versioni semantico e le modifiche che provocano errori avranno come target le release principali.
Ogni anno verrà rilasciata una versione principale di AGP, in linea con la release principale di Gradle.
La release dopo AGP 4.2 sarà la versione 7.0 e richiederà un upgrade a Gradle versione 7.x. Ogni release principale di AGP richiede un upgrade della versione principale nello strumento Gradle sottostante.
Le API verranno ritirate con circa un anno di anticipo e contemporaneamente saranno disponibili funzionalità di sostituzione. Le API deprecate verranno rimosse circa un anno dopo, durante il successivo aggiornamento principale.
Compatibilità
Il livello API massimo supportato dal plug-in Android Gradle 8.3 è il livello API 34. Ecco altre informazioni sulla compatibilità:
| Versione minima | Versione predefinita | Notes | |
|---|---|---|---|
| Gradle | 8,6 | 8,6 | Per scoprire di più, consulta la pagina sull'aggiornamento di Gradle. |
| Strumenti di creazione dell'SDK | 34,0,0 | 34,0,0 | Installa o configura gli strumenti di creazione dell'SDK. |
| NDK | N/A | 26.1.10909125 | Installa o configura una versione diversa dell'NDK. |
| JDK | 17 | 17 | Per ulteriori informazioni, vedi Impostazione della versione JDK. |
Di seguito sono riportate le nuove funzionalità del plug-in Android per Gradle 8.4.
Le classi della biblioteca sono ridotte
A partire dal plug-in Android per Gradle 8.4, se un progetto della libreria Android viene minimizzato, le classi di programma ridotte verranno pubblicate per la pubblicazione tra i progetti. Ciò significa che se un'app dipende dalla versione ridotta dei sottoprogetti della libreria Android, l'APK includerà classi della libreria Android ridotte. Potresti dover modificare le regole di conservazione della libreria nel caso in cui manchino classi nell'APK.
Se stai creando e pubblicando un AAR, i jar locali da cui dipende la tua libreria verranno inclusi non ridimensionati nell'AAR, il che significa che lo strumento di riduzione del codice non verrà eseguito su di essi.
Per ripristinare il comportamento precedente, imposta android.disableMinifyLocalDependenciesForLibraries nel file gradle.properties e segnala un bug.
Nelle versioni future di AGP, il flag rimuove questo flag.