Android Gradle-Plug-in 8.0.0 (April 2023)

Das Android Gradle-Plug-in 8.0.0 ist eine Hauptversion mit einer Vielzahl neuer Funktionen und Verbesserungen.

Kompatibilität

Patch-Releases

Im Folgenden finden Sie eine Liste der Patch-Releases für das Android Gradle-Plug-in 8.0.

Android Gradle Plugin 8.0.2 (Mai 2023)

Eine Liste der in AGP 8.0.2 behobenen Fehler finden Sie unter Behobene Probleme in Android Studio 2022.2.1.

Android Gradle Plugin 8.0.1 (Mai 2023)

Dieses Minor-Update enthält die folgenden Fehlerkorrekturen:

Wichtige Änderung: Namespace im Build-Script auf Modulebene erforderlich

Sie müssen den Namespace in der build.gradle.kts-Datei auf Modulebene und nicht in der Manifestdatei festlegen. Die namespace-DSL-Property kann ab AGP 7.3 verwendet werden. Weitere Informationen finden Sie unter Namespace festlegen.

Beachten Sie bei der Migration zur Namespace-DSL die folgenden Probleme:

• In früheren Versionen von AGP wurde der Test-Namespace in einigen Fällen fälschlicherweise aus dem Haupt-Namespace oder der Anwendungs-ID abgeleitet. Der AGP Upgrade Assistant blockiert das Upgrade, wenn er feststellt, dass der Haupt- und der Test-Namespace Ihres Projekts identisch sind. Wenn das Upgrade blockiert ist, müssen Sie testNamespace manuell ändern und den Quellcode entsprechend anpassen.
• Nachdem Sie den Test-Namespace geändert haben, wird Ihr Code möglicherweise kompiliert, aber Ihre instrumentierten Tests schlagen bei der Laufzeit fehl. Das kann passieren, wenn der instrumentierte Test-Quellcode auf eine Ressource verweist, die sowohl in Ihren androidTest- als auch in Ihren App-Quellen definiert ist.

Weitere Informationen finden Sie unter Problem 191813691, Kommentar 19.

Wichtige Änderungen: Standardwerte für Build-Optionen

Ab AGP 8.0 wurden die Standardwerte für diese Flags geändert, um die Build-Leistung zu verbessern. Mit dem AGP-Upgrade-Assistenten (Tools > AGP-Upgrade-Assistent) können Sie Ihren Code an einige dieser Änderungen anpassen. Der Upgrade Assistant führt Sie durch die Aktualisierung Ihres Codes, um das neue Verhalten zu berücksichtigen, oder durch die Einstellung von Flags, um das vorherige Verhalten beizubehalten.

Nicht abwärtskompatible Änderungen: Erzwungene Werte für Build-Optionen

Ab AGP 8.0 können Sie die Werte für diese Flags nicht mehr ändern. Wenn Sie sie in der Datei gradle.properties angeben, wird der Wert ignoriert und AGP druckt Warnungen aus.

Neues Flag „Stable“ für das Ausführungsprofil

AGP enthält das neue Flag android.settings.executionProfile. Mit diesem Flag können Sie das Standardausführungsprofil von SettingsExtension überschreiben. Weitere Informationen finden Sie in der Dokumentation zum Plug-in für Einstellungen.

Eine Vorschau der experimentellen Flags finden Sie in den Versionshinweisen zur Vorabversion.

Lazy-Property-Zuweisung in Kotlin wird nicht unterstützt

Wenn Sie die Kotlin-DSL von Gradle für Ihre Build-Scripts verwenden, beachten Sie, dass Android Studio und AGP 8.0 die experimentelle Attributzuweisung mit dem Operator = nicht unterstützen. Weitere Informationen zu dieser Funktion finden Sie in den Versionshinweisen und in der Dokumentation.

Build Analyzer-Aufgabenkategorien

Ab Android Studio Flamingo gibt es im Build Analyzer eine neue Standardansicht für Aufgaben, die sich auf die Builddauer auswirken. Wenn in Ihrem Projekt AGP 8.0 oder höher verwendet wird, werden Aufgaben im Build Analyzer nicht einzeln angezeigt, sondern nach Kategorie gruppiert. Beispielsweise werden Aufgaben, die speziell für Android-Ressourcen, Kotlin oder Dexing gelten, gruppiert und dann nach Builddauer sortiert. So lässt sich leicht erkennen, welche Kategorie den größten Einfluss auf die Buildzeit hat. Wenn Sie eine Kategorie maximieren, wird eine Liste der entsprechenden Aufgaben angezeigt. Wenn Sie Aufgaben einzeln und ohne Gruppierung anzeigen lassen möchten, verwenden Sie das Drop-down-Menü Nach.

Neues Plug-in für Einstellungen

Mit AGP 8.0.0-alpha09 wird das neue Plug-in für Einstellungen eingeführt. Mit dem Einstellungs-Plug-in können Sie globale Konfigurationen, die für alle Module gelten, an einem Ort zentralisieren, sodass Sie die Konfigurationen nicht in mehrere Module kopieren und einfügen müssen. Außerdem können Sie mit dem Einstellungs-Plug-in Ausführungsprofile für Tools oder unterschiedliche Anweisungen zum Ausführen eines Tools erstellen und zwischen ihnen wechseln.

Wenn Sie das Plug-in für Einstellungen verwenden möchten, wenden Sie es in der Datei settings.gradle an:

apply plugin 'com.android.settings'

Globale Konfigurationen zentralisieren

Verwenden Sie den neuen Block android in der Datei settings.gradle, um globale Konfigurationen zu konfigurieren. Beispiel:

android {
  compileSdk 31
  minSdk 28
  ...
}

Tool-Ausführungsprofile

Mit dem Plug-in „Einstellungen“ können Sie auch Ausführungsprofile für einige Tools erstellen. Ein Ausführungsprofil bestimmt, wie ein Tool ausgeführt wird. Je nach Umgebung können Sie unterschiedliche Ausführungsprofile auswählen. In einem Ausführungsprofil können Sie JVM-Argumente für ein Tool festlegen und es so konfigurieren, dass es in einem separaten Prozess ausgeführt wird. Derzeit wird nur das R8-Tool unterstützt.

Erstellen Sie Ausführungsprofile und legen Sie das Standardausführungsprofil in der Datei settings.gradle fest, wie im folgenden Beispiel gezeigt:

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"
  }
}

Wenn Sie das Standardprofil überschreiben möchten, wählen Sie mit der Property android.experimental.settings.executionProfile in der Datei gradle.properties ein anderes Profil aus:

android.experimental.settings.executionProfile=high

Sie können diese Eigenschaft auch über die Befehlszeile festlegen, um unterschiedliche Workflows einzurichten. Wenn Sie beispielsweise einen Continuous-Integration-Workflow haben, können Sie das Ausführungsprofil über die Befehlszeile ändern, ohne die settings.gradle-Datei ändern zu müssen:

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

JDK 17 für die Ausführung von AGP 8.0 erforderlich

Wenn Sie das Android Gradle Plug-in 8.0 zum Erstellen Ihrer App verwenden, ist jetzt JDK 17 erforderlich, um Gradle auszuführen. Android Studio Flamingo enthält JDK 17 und konfiguriert Gradle so, dass es standardmäßig verwendet wird. Die meisten Android Studio-Nutzer müssen also keine Konfigurationsänderungen an ihren Projekten vornehmen.

Wenn Sie die JDK-Version festlegen, die von AGP in Android Studio verwendet wird, müssen Sie JDK 17 oder höher verwenden.

Wenn Sie AGP unabhängig von Android Studio verwenden, aktualisieren Sie die JDK-Version, indem Sie die JAVA_HOME-Umgebungsvariable oder die -Dorg.gradle.java.home-Befehlszeilenoption auf das Installationsverzeichnis von JDK 17 festlegen.

Behobene Probleme

Android Gradle-Plug-in 8.0.0

Android Gradle-Plug-in 8.0.1

Android Gradle-Plug-in 8.0.2