Plug-in Android Gradle 8.3.0 (febbraio 2024)

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).

Completamento del codice durante l'aggiunta di una dipendenza

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.

Variabili di un catalogo delle versioni nella finestra di dialogo Struttura del progetto

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.

Dipendenze da un catalogo delle versioni nella finestra di dialogo Struttura del progetto

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 parte libs. 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.