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
del plug-in alla versione 8.5.0 dal
File build.gradle.kts
:
Kotlin
plugins { id("com.android.application") version "8.5.0" apply false id("com.android.library") version "8.5.0" apply false id("org.jetbrains.kotlin.android") version "1.9.23" apply false }
Alla moda
plugins { id 'com.android.application' version '8.5.0' apply false id 'com.android.library' version '8.5.0' apply false id 'org.jetbrains.kotlin.android' version '1.9.23' apply false }
Attenzione: non utilizzare le dipendenze dinamiche nella versione
numeri come
'com.android.tools.build:gradle:8.5.+'
.
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.
Versione plug-in | Versione Gradle minima richiesta |
---|---|
8,50 | 8,7 |
8.4 | 8,6 |
8.3 | 8.4 |
8.2 | 8.2 |
8.1 | 8.0 |
8.0 | 8.0 |
7,4 | 7,5 |
Versioni precedenti
Versione 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 versioni successive | 6.7.1 |
4.1.0 e versioni successive | Più di 6,5 |
4.0.0 e versioni successive | 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 | 4,6 e versioni successive |
3.1.0 e versioni successive | 4,4 e versioni successive |
3.0.0 e versioni successive | 4,1 e versioni successive |
2.3.0 e versioni successive | 3,3 e versioni successive |
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 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.5 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.5
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.5
gradle-wrapper.properties
.
...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.5-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.
Versione di Android Studio | Versione AGP richiesta |
---|---|
Koala | 1/2024 | 3,2-8,5 |
Meduse | 1/3/2023 | 3,2-8,4 |
Iguana | 1/2 2023 | 3,2-8,3 |
Riccio | 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 richiesta |
---|---|
Anguilla elettrica | 1/2022 | 3,2-7,4 |
Delfino | 1/3/2021 | 3,2-7,3 |
Tamia striato | 1/2/2021 | 3,2-7,2 |
Bombo | 1/1/2021 | 3,2-7,1 |
Volpe artica | 1/3/2020 | 3,1-7,0 |
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 quanto richiesto dal tuo
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
visualizzare l'anteprima delle versioni di Android Studio insieme 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/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) 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 principali versioni.
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 del plug-in Android Gradle 8.5 è il livello API 34. Ecco altre informazioni sulla compatibilità:
Versione minima | Versione predefinita | Note | |
---|---|---|---|
Gradle | 8,7 | 8,7 | Per scoprire di più, consulta la sezione sull'aggiornamento di Gradle. |
Strumenti di creazione SDK | 34,0,0 | 34,0,0 | Installa o configura gli strumenti di creazione dell'SDK. |
ND | N/D | 26.1.10909125 | Installa o configura una versione diversa dell'NDK. |
JDK | 17 | 17 | Per scoprire di più, consulta la sezione sull'impostazione della versione JDK. |
Release patch
Di seguito è riportato un elenco delle release di patch in Android Studio Koala e Android Gradle plugin 8.5.
Koala Android Studio | 2024.1.1 Patch 1 e AGP 8.5.1 (luglio 2024)
Questo aggiornamento minore include queste correzioni di bug.