Il plug-in Android per Gradle 8.3.0 è una release principale che include una serie di nuove funzionalità e miglioramenti.
Compatibilità
Il livello API massimo supportato da Android Gradle Plugin 8.3 è il livello API 34. Ecco altre informazioni sulla compatibilità:
Versione minima | Versione predefinita | Note | |
---|---|---|---|
Gradle | 8.4 | 8.4 | Per scoprire di più, consulta la sezione Aggiornare Gradle. |
Strumenti di compilazione SDK | 34.0.0 | 34.0.0 | Installa o configura gli strumenti di creazione dell'SDK. |
NDK | N/D | 25.1.8937393 | Installa o configura una versione diversa dell'NDK. |
JDK | 17 | 17 | Per saperne di più, vedi Impostare la versione di JDK. |
Di seguito sono riportate le nuove funzionalità del plug-in Android per Gradle 8.3.
Release delle patch
Di seguito è riportato un elenco delle patch rilasciate in Android Studio Iguana e nel plug-in Android per Gradle 8.3.
Android Studio Iguana | 2023.2.1 Patch 2 e AGP 8.3.2 (aprile 2024)
Questo aggiornamento minore include queste correzioni di bug.
Android Studio Iguana | 2023.2.1 Patch 1 e AGP 8.3.1 (marzo 2024)
Questo aggiornamento minore include queste correzioni di bug.
Supporto dei cataloghi delle versioni di Gradle
Android Studio supporta i cataloghi delle versioni di Gradle basati su TOML, una funzionalità che ti consente di gestire le dipendenze in un'unica posizione centrale e di condividerle tra moduli o progetti. Android Studio ora semplifica la configurazione dei cataloghi delle versioni tramite suggerimenti dell'editor e l'integrazione con la finestra di dialogo Struttura progetto. Scopri come configurare i cataloghi delle versioni di Gradle o come eseguire la migrazione della build ai cataloghi delle versioni.
Completamento e navigazione del codice
Android Studio offre il completamento del codice quando modifichi un catalogo delle versioni nel formato di file TOML o quando aggiungi una dipendenza da un catalogo delle versioni a un file di build. Per utilizzare il completamento del codice, premi Ctrl+Spazio
(Command+Spazio su macOS). Inoltre, puoi passare rapidamente da un riferimento di dipendenza nel file build.gradle
della tua app a dove è dichiarato nel catalogo delle versioni premendo Ctrl+b (Command+b su macOS).
Integrazione con la finestra di dialogo Struttura progetto
Se il tuo progetto utilizza un catalogo delle versioni definito nel formato di file TOML, puoi modificare le variabili che hai definito tramite la finestra di dialogo Struttura progetto e la visualizzazione Variabili (File > Struttura progetto > Variabili) in Android Studio. Per ogni catalogo delle versioni, è presente un menu a discesa che elenca le variabili del catalogo. Per modificare una variabile, fai clic sul relativo valore e sovrascrivilo. Quando salvi queste modifiche, il file TOML viene aggiornato di conseguenza.
Puoi anche aggiornare le dipendenze nella finestra di dialogo Struttura del progetto nella visualizzazione Dipendenze (File > Struttura del progetto > Dipendenze). Per aggiornare le versioni utilizzando la finestra di dialogo Struttura progetto, vai al modulo e alla dipendenza che vuoi modificare, quindi aggiorna il campo Versione richiesta. Quando salvi queste modifiche, il file TOML viene aggiornato di conseguenza. Tieni presente che se la versione della dipendenza è stata definita utilizzando una variabile, l'aggiornamento diretto della versione sostituisce la variabile con un valore hardcoded. Tieni inoltre presente che la rimozione di una dipendenza da un file di build, indipendentemente dal fatto che utilizzi la finestra di dialogo Struttura progetto o meno, non rimuove la dipendenza dal catalogo delle versioni.
Problemi noti e limitazioni
Di seguito sono riportati i problemi noti o le limitazioni del supporto dei cataloghi delle versioni di Gradle in Android Studio.
Errore di evidenziazione delle dichiarazioni di alias del plug-in nei file di script Kotlin: quando aggiungi una dichiarazione di plug-in del modulo
alias(libs.plugins.example)
, l'editor aggiunge una sottolineatura rossa sotto la partelibs
. Si tratta di un problema noto nelle versioni di Gradle 8.0 e precedenti, che verrà risolto in una futura release di Gradle.Supporto di Android Studio solo per i cataloghi delle versioni in formato TOML: al momento il completamento del codice, la navigazione e la finestra di dialogo Struttura del progetto di Android Studio sono disponibili solo per i cataloghi delle versioni definiti nel formato del file TOML. Tuttavia, puoi comunque aggiungere un catalogo delle versioni direttamente nel file
settings.gradle
e utilizzare le relative dipendenze nel tuo progetto.Navigazione per i file di build KTS non supportata: la navigazione fino a una definizione di dipendenza in un catalogo delle versioni utilizzando Controllo+clic (Comando+clic su macOS) non è ancora supportata per i file di build scritti utilizzando lo script Kotlin.
Firebase Assistant aggiunge le dipendenze direttamente negli script di build: l'assistente Firebase aggiunge le dipendenze direttamente agli script di build anziché tramite i cataloghi delle versioni.
Funzionalità "Trova utilizzi" non supportata: la ricerca degli utilizzi di una variabile del catalogo delle versioni in altri file di build non è ancora supportata, indipendentemente dal fatto che il file di build si trovi in KTS o Groovy. ovvero, l'utilizzo di Control+clic (Command+clic su macOS) su una definizione di variabile in un catalogo di versioni non porta ai file di build in cui viene utilizzata la variabile.
La finestra di dialogo Struttura progetto in Android Studio mostra più file di catalogo se si trovano nella cartella root
gradle
, ma non mostra i cataloghi per una build composita. Ad esempio, se hai due file di catalogo, uno per la tua app e uno per una build composita, la finestra di dialogo Struttura del progetto mostra solo il file di catalogo dell'app. Puoi utilizzare una build composita, ma devi modificare direttamente il relativo file TOML.
Altri approfondimenti sull'SDK: problemi relativi alle norme
Android Studio mostra gli avvisi lint nei file build.gradle.kts
e build.gradle
e nella
finestra di dialogo Struttura progetto per gli SDK pubblici che presentano violazioni delle norme di Google Play
nell'indice SDK di Google Play. Devi aggiornare tutte le dipendenze che violano le norme di Google Play, perché queste violazioni potrebbero impedirti di pubblicare in futuro su Google Play Console. Gli avvisi di violazione delle norme integrano gli avvisi di versione obsoleta visualizzati da Android Studio.
Supporto della versione compileSdk di Android Studio
Android Studio mostra un avviso se il tuo progetto utilizza un compileSdk
non supportato dalla versione corrente di Android Studio. Se disponibile, suggerisce anche di passare a una versione di Android Studio che supporti compileSdk
utilizzato dal tuo progetto. Tieni presente che
l'upgrade di Android Studio potrebbe richiedere anche l'upgrade di AGP.
AGP mostra anche un avviso nella finestra degli strumenti Build se compileSdk
utilizzato dal tuo progetto non è supportato dalla versione corrente di AGP.
Modifiche al comportamento di lint
A partire dal plug-in Android per Gradle 8.3.0-alpha02, quando esegui lint su un
modulo, vengono eseguite attività di analisi lint separate per i componenti
principali e di test del modulo. Il motivo di questa modifica è migliorare il rendimento.
Per ripristinare il comportamento precedente, imposta
android.experimental.lint.analysisPerComponent=false
nel file
gradle.properties
.
Riduzione precisa delle risorse attivata per impostazione predefinita
La riduzione precisa delle risorse, che rimuove le voci inutilizzate dal file
resources.arsc
ed elimina i file di risorse inutilizzati, è attiva per impostazione predefinita.
Quando questa riduzione è abilitata, la tabella delle risorse viene ridotta e nell'APK vengono incluse solo le voci della cartella res
a cui viene fatto riferimento.
Per disattivare la riduzione precisa delle risorse, imposta
android.enableNewResourceShrinker.preciseShrinking
su false
nel file
gradle.properties
del progetto.
Problemi risolti
Plug-in Android per Gradle 8.3.0
Problemi risolti | ||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Plug-in Android per Gradle |
|
|||||||||||||||||||||||||||||||||||||||||||||||||
Dexer (D8) |
|
|||||||||||||||||||||||||||||||||||||||||||||||||
Pelucchi |
|
|||||||||||||||||||||||||||||||||||||||||||||||||
Integrazione di Lint |
|
|||||||||||||||||||||||||||||||||||||||||||||||||
Shrinker (R8) |
|
Plug-in Android per Gradle 8.3.1
Problemi risolti | ||
---|---|---|
Plug-in Android per Gradle |
|
|
Integrazione di Lint |
|
Plug-in Android per Gradle 8.3.2
Problemi risolti | |||
---|---|---|---|
Plug-in Android per Gradle |
|
||
Integrazione di Lint |
|