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 dal plug-in Android Gradle 8.3 è il livello API 34. Ecco altre informazioni sulla compatibilità:
Versione minima | Versione predefinita | Notes | |
---|---|---|---|
Gradle | 8.4 | 8.4 | 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 | 25.1.8937393 | 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.3.
Release patch
Di seguito è riportato un elenco delle release delle patch in Android Studio Iguana e nel plug-in Android Gradle 8.3.
Android Studio Iguana | 2023.2.1 Patch 2 e AGP 8.3.2 (aprile 2024)
Questo aggiornamento secondario include queste correzioni di bug.
Android Studio Iguana | Patch 1 2023.2.1 e AGP 8.3.1 (marzo 2024)
Questo aggiornamento secondario include queste correzioni di bug.
Supporto per i cataloghi delle versioni Gradle
Android Studio supporta i catalogi delle versioni di Gradle basati su TOML, una funzionalità che consente di gestire le dipendenze in un'unica posizione centrale e di condividere le dipendenze tra moduli o progetti. Android Studio ora semplifica la configurazione dei cataloghi delle versioni tramite i suggerimenti dell'editor e l'integrazione con la finestra di dialogo Struttura del progetto. Scopri come impostare e configurare i cataloghi delle versioni 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 file TOML o aggiungi una dipendenza da un catalogo delle versioni a un file di build. Per utilizzare il completamento del codice, premi Ctrl+Barra spaziatrice (Comando+Barra spaziatrice su macOS). Inoltre, puoi passare rapidamente da un riferimento alle dipendenze nel file build.gradle
dell'app alla posizione in cui viene dichiarata nel catalogo delle versioni premendo Ctrl+b (Comando+b su macOS).
Integrazione con la finestra di dialogo Struttura del progetto
Se il progetto utilizza un catalogo delle versioni definito nel formato file TOML, puoi modificare le variabili definite nella finestra di dialogo Struttura del progetto nella vista Variabili (File > Struttura del progetto > Variabili) in Android Studio. Per ogni catalogo delle versioni, è presente un menu a discesa in cui sono elencate 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 aggiornare le dipendenze anche nella visualizzazione Dipendenze della finestra di dialogo Struttura del progetto (File > Struttura del progetto > Dipendenze). Per aggiornare le versioni utilizzando la finestra di dialogo Struttura del 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 in questo modo sostituisce la variabile con un valore impostato come hardcoded. Tieni inoltre presente che la rimozione di una dipendenza da un file di build, indipendentemente dal fatto che utilizzi o meno la finestra di dialogo Struttura del progetto, non rimuove la dipendenza dal catalogo delle versioni.
Problemi noti e limitazioni
Di seguito sono riportati i problemi noti o le limitazioni relative al supporto dei cataloghi delle versioni Gradle in Android Studio.
Errore durante l'evidenziazione delle dichiarazioni degli alias dei plug-in nei file di script Kotlin: quando aggiungi una dichiarazione del plug-in nel formato
alias(libs.plugins.example)
, l'editor aggiunge una sottolineatura rossa sotto la partelibs
. Si tratta di un problema noto nelle versioni Gradle 8.0 e precedenti che verrà risolto in una versione futura di Gradle.Supporto solo di Android Studio per i cataloghi di versioni in formato TOML: al momento, le finestre di dialogo per completamento del codice, navigazione e struttura del progetto in Android Studio sono disponibili solo per i cataloghi di versioni definiti nel formato file TOML. Tuttavia, puoi comunque aggiungere un catalogo delle versioni direttamente nel file
settings.gradle
e utilizzarne le dipendenze nel progetto.Navigazione per i file di build KTS non supportata: l'accesso a una definizione delle dipendenze in un catalogo di versioni mediante Ctrl e clic (Comando + clic su macOS) non è ancora supportata per i file di build scritti utilizzando lo script Kotlin.
L'Assistente Firebase 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: non è ancora possibile trovare gli utilizzi di una variabile di catalogo delle versioni in altri file di build, a prescindere dal fatto che il file di build sia in KTS o Groovy. In altre parole, l'uso di Ctrl+clic (Comando+clic su macOS) su una definizione di variabile in un catalogo delle versioni non indirizza ai file di build in cui viene utilizzata la variabile.
La finestra di dialogo Struttura del progetto in Android Studio mostra più file di catalogo se si trovano nella cartella
gradle
principale, ma non i cataloghi per una build composita. Ad esempio, se hai due file di catalogo (uno per l'app e uno per una build composita), la finestra di dialogo Struttura del progetto mostra solo il file di catalogo delle app. Puoi utilizzare una build composita, ma devi modificare direttamente il relativo file TOML.
Ulteriori approfondimenti sull'SDK: problemi relativi alle norme
Android Studio mostra avvisi lint nei file build.gradle.kts
e build.gradle
e nella finestra di dialogo della struttura del progetto per gli SDK pubblici con violazioni delle norme di Play nell'indice di Google Play SDK. Dovresti aggiornare eventuali
dipendenze che violano le norme di Google Play, in quanto queste violazioni potrebbero impedirti di pubblicare
su Google Play Console in futuro. 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 progetto utilizza un compileSdk
non supportato dalla versione corrente di Android Studio. Se disponibile, ti consigliamo anche di passare a una versione di Android Studio che supporti l'elemento 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 dello strumento Crea se il valore compileSdk
utilizzato dal progetto non è supportato dalla versione corrente di AGP.
Modifiche al comportamento dei lint
A partire dal plug-in Android per Gradle 8.3.0-alpha02, quando si esegue lint su un modulo, vengono eseguite attività separate di analisi lint per i componenti principali e di test del modulo. Questa modifica ha lo scopo di migliorare il rendimento.
Per ripristinare il comportamento precedente, imposta android.experimental.lint.analysisPerComponent=false
nel file gradle.properties
.
La riduzione esatta delle risorse è attivata per impostazione predefinita
La riduzione precisa delle risorse, che rimuove le voci inutilizzate dal file resources.arsc
ed elimina i file delle risorse inutilizzati, è attiva per impostazione predefinita.
Quando questa riduzione è abilitata, la tabella delle risorse viene ridotta e nell'APK sono incluse solo le voci della cartella res
di riferimento.
Per disattivare la riduzione precisa delle risorse, imposta android.enableNewResourceShrinker.preciseShrinking
su false
nel file gradle.properties
del tuo progetto.