Plug-in Android per Gradle 8.0.0 (aprile 2023)

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

Compatibilità

Release delle patch

Di seguito è riportato un elenco delle release di patch per il plug-in Android per Gradle 8.0.

Plug-in Android per Gradle 8.0.2 (maggio 2023)

Per un elenco dei bug corretti in AGP 8.0.2, consulta Android Studio 2022.2.1 closed issues.

Plug-in Android per Gradle 8.0.1 (maggio 2023)

Questo aggiornamento minore include le seguenti correzioni di bug:

Modifica incompatibile: spazio dei nomi obbligatorio nello script di compilazione a livello di modulo

Devi impostare lo spazio dei nomi nel file build.gradle.kts a livello di modulo, anziché nel file manifest. Puoi iniziare a utilizzare la proprietà DSL namespace a partire da AGP 7.3. Per saperne di più, consulta Impostare uno spazio dei nomi.

Quando esegui la migrazione al DSL dello spazio dei nomi, tieni presente i seguenti problemi:

• Le versioni precedenti di AGP deducono erroneamente lo spazio dei nomi del test dallo spazio dei nomi principale o dall'ID applicazione in alcuni casi. L'Assistente all'upgrade di AGP blocca l'upgrade se rileva che lo spazio dei nomi principale e quello di test del progetto sono uguali. Se l'upgrade è bloccato, devi modificare manualmente testNamespace e modificare di conseguenza il codice sorgente.
• Dopo aver modificato lo spazio dei nomi del test, è possibile che il codice venga compilato, ma i test con strumenti non vadano a buon fine in fase di esecuzione. Ciò può accadere se il codice sorgente del test instrumentato fa riferimento a una risorsa definita sia nelle origini androidTest sia nelle origini dell'app.

Per ulteriori informazioni, consulta issue #191813691 comment #19.

Modifiche non compatibili: valori predefiniti dell'opzione di compilazione

A partire da AGP 8.0, i valori predefiniti di questi flag sono stati modificati per migliorare il rendimento della compilazione. Per ricevere assistenza per modificare il codice in modo da supportare alcune di queste modifiche, utilizza l'Assistente all'upgrade di AGP (Strumenti > Assistente all'upgrade di AGP). L'Assistente all'upgrade ti guida nell'aggiornamento del codice per adattarlo al nuovo comportamento o nell'impostazione di flag per preservare il comportamento precedente.

Modifiche non compatibili: valori delle opzioni di compilazione forzate

A partire da AGP 8.0, non puoi più modificare i valori di questi flag. Se li specifichi nel file gradle.properties, il valore viene ignorato e AGP stampa avvisi.

Nuovo flag stabile per il profilo di esecuzione

AGP include il nuovo flag android.settings.executionProfile. Utilizza questo flag per eseguire l'override del profilo di esecuzione predefinito da SettingsExtension. Per scoprire di più, consulta la documentazione del plug-in delle impostazioni.

Per visualizzare l'anteprima dei flag sperimentali, consulta le note di rilascio della versione di anteprima.

L'assegnazione della proprietà lazy di Kotlin non è supportata

Se utilizzi il DSL Kotlin di Gradle per gli script di compilazione, tieni presente che Android Studio e AGP 8.0 non supportano l'assegnazione sperimentale delle proprietà tramite l'operatore =. Per saperne di più su questa funzionalità, consulta le note di rilascio e la documentazione.

Categorie di attività di Build Analyzer

A partire da Android Studio Flamingo, Build Analyzer ha una nuova visualizzazione predefinita per le attività che influiscono sulla durata della compilazione. Se il tuo progetto utilizza AGP 8.0 o versioni successive, invece di visualizzare le attività singolarmente, Build Analyzer le raggruppa per categoria. Ad esempio, le attività specifiche per le risorse Android, Kotlin o il dexing vengono raggruppate e poi ordinate in base alla durata della compilazione. In questo modo, è facile sapere quale categoria ha l'impatto maggiore sui tempi di compilazione. L'espansione di ogni categoria consente di visualizzare un elenco delle attività corrispondenti. Per visualizzare le attività singolarmente, senza raggrupparle, utilizza il menu a discesa Raggruppa per.

Nuovo plug-in di impostazioni

AGP 8.0.0-alpha09 introduce il nuovo plug-in delle impostazioni. Il plug-in delle impostazioni consente di centralizzare le configurazioni globali, ovvero quelle che si applicano a tutti i moduli, in un unico posto in modo da non doverle copiare e incollare in più moduli. Inoltre, puoi utilizzare il plug-in delle impostazioni per creare profili di esecuzione degli strumenti o istruzioni diverse su come eseguire uno strumento e passare da uno all'altro.

Per utilizzare il plug-in delle impostazioni, applicalo nel file settings.gradle:

apply plugin 'com.android.settings'

Centralizzare le configurazioni globali

Per configurare le configurazioni globali, utilizza il nuovo blocco android nel settings.gradle file. Ecco un esempio:

android {
  compileSdk 31
  minSdk 28
  ...
}

Profili di esecuzione dello strumento

Il plug-in delle impostazioni ti consente anche di creare profili di esecuzione per alcuni strumenti. Un profilo di esecuzione determina in che modo viene eseguito uno strumento. Puoi selezionare diversi profili di esecuzione a seconda dell'ambiente. In un profilo di esecuzione, puoi impostare gli argomenti JVM per uno strumento e configurarlo per l'esecuzione in un processo separato. Al momento è supportato solo lo strumento R8.

Crea i profili di esecuzione e imposta quello predefinito nel settings.gradle file, come mostrato nell'esempio seguente:

android {
  execution {
    profiles {
      high {
        r8 {
          jvmOptions += ["-Xms2048m", "-Xmx8192m", "-XX:+HeapDumpOnOutOfMemoryError"]
          runInSeparateProcess true
        }
      }
      low {
        r8 {
          jvmOptions += ["-Xms256m", "-Xmx2048m", "-XX:+HeapDumpOnOutOfMemoryError"]
          runInSeparateProcess true
        }
      }
      ci {
        r8.runInSeparateProcess false
      }
    }
    defaultProfile "low"
  }
}

Per sostituire il profilo predefinito, selezionane un altro utilizzando la proprietà android.experimental.settings.executionProfile nel file gradle.properties:

android.experimental.settings.executionProfile=high

Puoi impostare questa proprietà anche utilizzando la riga di comando, il che ti consente di configurare diversi flussi di lavoro. Ad esempio, se hai un flusso di lavoro di integrazione continua, puoi utilizzare la riga di comando per modificare il profilo di esecuzione senza dover modificare il file settings.gradle:

./gradlew assembleRelease \
  -Pandroid.experimental.settings.executionProfile=ci

JDK 17 necessario per eseguire AGP 8.0

Quando utilizzi il plug-in Android per Gradle 8.0 per compilare la tua app, ora è necessario JDK 17 per eseguire Gradle. Android Studio Flamingo include JDK 17 e configura Gradle per usarlo per impostazione predefinita, il che significa che la maggior parte degli utenti di Android Studio non deve apportare modifiche alla configurazione dei propri progetti.

Se devi impostare manualmente la versione JDK utilizzata da AGP in Android Studio, devi utilizzare JDK 17 o versioni successive.

Quando utilizzi AGP indipendentemente da Android Studio, esegui l'upgrade della versione JDK impostando la JAVA_HOME variabile di ambiente o l'-Dorg.gradle.java.home opzione a riga di comando nella directory di installazione di JDK 17.

Problemi risolti

Plug-in Android per Gradle 8.0.0

Plug-in Android per Gradle 8.0.1

Plug-in Android per Gradle 8.0.2