Plug-in Android per Gradle 8.1.0 (luglio 2023)

Il plug-in Android per Gradle 8.1.0 è una release principale che include una serie di nuove funzionalità e miglioramenti.

Compatibilità

Kotlin DSL è l'impostazione predefinita per la configurazione della build

Per impostazione predefinita, i nuovi progetti ora utilizzano Kotlin DSL (build.gradle.kts) per la configurazione della build. Offre un'esperienza di modifica migliore rispetto a Groovy DSL (build.gradle) con evidenziazione della sintassi, completamento del codice e navigazione alle dichiarazioni. Tieni presente che se utilizzi AGP 8.1 e Kotlin DSL per la configurazione della build, devi utilizzare Gradle 8.1 per un'esperienza ottimale. Per saperne di più, consulta la guida alla migrazione di Kotlin DSL.

Supporto automatico della lingua per app

A partire da Android Studio Giraffe Canary 7 e AGP 8.1.0-alpha07, puoi configurare la tua app per supportare automaticamente le preferenze di lingua per app. In base alle risorse del progetto, il plug-in Android per Gradle genera il file LocaleConfig e aggiunge un riferimento al file manifest finale, quindi non devi più farlo manualmente. AGP utilizza le risorse nelle cartelle res dei moduli dell'app e le dipendenze dei moduli della libreria per determinare le impostazioni internazionali da includere nel file LocaleConfig.

Tieni presente che la funzionalità di lingua automatica per app supporta le app che eseguono Android 13 (livello API 33) o versioni successive. Per utilizzare la funzionalità, devi impostare compileSdkVersion su 33 o un valore superiore. Per configurare le preferenze della lingua per app per le versioni precedenti di Android, devi comunque utilizzare le API e i selettori della lingua in-app.

Per attivare il supporto automatico della lingua per app, specifica un locale predefinito:

1. Nella cartella res del modulo dell'app, crea un nuovo file denominato resources.properties.

2. Nel file resources.properties, imposta le impostazioni internazionali predefinite con l'etichetta unqualifiedResLocale. Per formare i nomi delle impostazioni internazionali, combina il codice lingua con i codici facoltativi di script e regione, separando ciascun codice con un trattino:

   • Lingua: utilizza il codice ISO 639-1 di due o tre lettere.
   • Script (facoltativo): utilizza il codice ISO 15924.
   • Regione (facoltativo): utilizza il codice ISO 3166-1 alpha-2 a due lettere o il codice UN_M.49 a tre cifre.

   Ad esempio, se la lingua predefinita è l'inglese americano:

       unqualifiedResLocale=en-US
       

AGP aggiunge questa impostazione internazionale predefinita e tutte le impostazioni internazionali alternative che hai specificato, utilizzando le directory values-* nella cartella res, al file LocaleConfig generato automaticamente.

Il supporto automatico della lingua per app è disattivato per impostazione predefinita. Per attivare la funzionalità, utilizza l'impostazione generateLocaleConfig nel blocco androidResources {} del file build.gradle.kts a livello di modulo (file build.gradle se utilizzi Groovy):

android {
  androidResources {
    generateLocaleConfig = true
  }
}

android {
  androidResources {
    generateLocaleConfig true
  }
}

Android Lint contiene bytecode che hanno come target la JVM 17

A partire da AGP 8.1.0-alpha04, Android Lint contiene bytecode che ha come target la JVM 17. Se scrivi controlli lint personalizzati, devi compilare con JDK 17 o versioni successive e specificare jvmTarget = '17' nelle opzioni del compilatore Kotlin.

Per scoprire di più sullo strumento di analisi statica del codice, consulta la pagina Migliorare il codice con i controlli lint.

L'impostazione di compressione della libreria nativa è stata spostata in DSL

A partire da AGP 8.1.0-alpha10, riceverai un avviso se non configuri la compressione della libreria nativa utilizzando il DSL anziché il manifest. Le seguenti indicazioni spiegano come aggiornare la configurazione per utilizzare il linguaggio DSL. Per ricevere assistenza per questi aggiornamenti, utilizza AGP Upgrade Assistant (Strumenti > AGP Upgrade Assistant).

Per utilizzare le librerie native non compresse, rimuovi l'attributo android::extractNativeLibs dal manifest e aggiungi il seguente codice al file build.gradle.kts a livello di modulo (file build.gradle se utilizzi Groovy):

android {
  packagingOptions {
    jniLibs {
      useLegacyPackaging = false
    }
  }
}

android {
  packagingOptions {
    jniLibs {
      useLegacyPackaging false
    }
  }
}

Flag di build sperimentali

Si tratta di flag sperimentali per la configurazione della build disponibili in AGP 8.1.

Problemi risolti

Plug-in Android per Gradle 8.1.0

Plug-in Android per Gradle 8.1.1

Plug-in Android per Gradle 8.1.2

Plug-in Android per Gradle 8.1.3

Plug-in Android per Gradle 8.1.4