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

I nuovi progetti ora utilizzano Kotlin DSL (build.gradle.kts) per impostazione predefinita per la configurazione della build. Questo offre un'esperienza di modifica migliore rispetto a Groovy DSL (build.gradle) con evidenziazione della sintassi, completamento del codice e navigazione verso le dichiarazioni. Tieni presente che se utilizzi AGP 8.1 e Kotlin DSL per la configurazione della build, devi usare Gradle 8.1 per un'esperienza ottimale. Per ulteriori informazioni, consulta la guida alla migrazione a Kotlin DSL.

Supporto automatico della lingua in base all'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 linguistiche per ogni app. In base alle risorse del progetto, il plug-in Android Gradle genera il file LocaleConfig a cui aggiunge un riferimento nel file manifest finale, così non dovrai più farlo manualmente. AGP utilizza le risorse nelle cartelle res dei moduli dell'app e le eventuali dipendenze dei moduli delle librerie per determinare le impostazioni internazionali da includere nel file LocaleConfig.

Tieni presente che la funzionalità linguistica automatica per ogni app supporta le app con 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 linguistiche per app per le versioni precedenti di Android, devi comunque utilizzare le API e i selettori lingua in-app.

Per attivare il supporto automatico delle lingue per app, specifica un'impostazione internazionale predefinita:

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 creare i nomi delle impostazioni internazionali, combina il codice lingua con lo script facoltativo e i codici regione, separandoli 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 UN_M.49 a tre cifre.

   Ad esempio, se la tua lingua predefinita è Inglese americano:

       unqualifiedResLocale=en-US
       

AGP aggiunge queste impostazioni internazionali predefinite ed eventuali impostazioni internazionali alternative che hai specificato, utilizzando le directory values-* nella cartella res, al file LocaleConfig generato automaticamente.

Il supporto automatico della lingua in ogni 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
  }
}

Lint Android contiene bytecode che ha come target JVM 17

A partire da AGP 8.1.0-alpha04, il Lint di Android contiene bytecode che ha come target 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 lint, consulta Migliorare il codice con i controlli lint.

Impostazione di compressione della libreria nativa spostata in DSL

A partire da AGP 8.1.0-alpha10, riceverai un avviso se non configuri la compressione delle librerie native utilizzando la DSL anziché il manifest. Le seguenti indicazioni spiegano come aggiornare la configurazione per utilizzare l'interfaccia DSL. Per ricevere assistenza per questi aggiornamenti, utilizza l'Assistente per l'upgrade AGP (Strumenti > Assistente per l'upgrade AGP).

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 usi Groovy):

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

android {
  packagingOptions {
    jniLibs {
      useLegacyPackaging false
    }
  }
}

Flag di build sperimentali

Questi sono flag sperimentali disponibili in AGP 8.1 per configurare la tua build.