Android Gradle-Plug-in 8.0.0 (April 2023)

Das Android-Gradle-Plug-in 8.0.0 ist eine Hauptversion mit vielen neuen 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-Plug-in 8.0.2 (Mai 2023)

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

Android-Gradle-Plug-in 8.0.1 (Mai 2023)

Dieses kleinere Update enthält die folgenden Fehlerkorrekturen:

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

Sie müssen den Namespace in der build.gradle.kts-Datei auf Modulebene und nicht in der Manifestdatei festlegen. Sie können die DSL-Property namespace ab AGP 7.3 verwenden. 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-Namespace 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, kann es sein, dass Ihr Code kompiliert wird, Ihre instrumentierten Tests aber zur Laufzeit fehlschlagen. Das kann passieren, wenn in Ihrem instrumentierten Testquellcode auf eine Ressource verwiesen wird, 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. Wenn Sie Hilfe beim Anpassen Ihres Codes benötigen, um einige dieser Änderungen zu unterstützen, verwenden Sie den AGP Upgrade Assistant (Tools > AGP Upgrade Assistant). Der Upgrade Assistant führt Sie durch die Aktualisierung Ihres Codes, um das neue Verhalten zu berücksichtigen, oder durch das Festlegen von Flags, um das vorherige Verhalten beizubehalten.

Nicht abwärtskompatible Änderungen: Erzwingen von Build-Optionswerten

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 gibt Warnungen aus.

Neues stabiles Flag für das Ausführungsprofil

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

Informationen zur Vorschau von experimentellen Flags finden Sie in den Versionshinweisen zur Vorschau.

Zuweisung von Lazy-Properties in Kotlin wird nicht unterstützt

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

Build Analyzer-Aufgabenkategorien

Ab Android Studio Flamingo bietet Build Analyzer eine neue Standardansicht für Tasks, die sich auf die Build-Dauer auswirken. Wenn in Ihrem Projekt AGP 8.0 oder höher verwendet wird, werden Aufgaben im Build Analyzer nicht einzeln, sondern nach Kategorie gruppiert. Aufgaben, die sich beispielsweise auf Android-Ressourcen, Kotlin oder Dexing beziehen, werden gruppiert und dann nach Build-Dauer sortiert. So lässt sich leicht feststellen, welche Kategorie die Build-Zeit am stärksten beeinflusst. 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ü Gruppieren nach.

Neues Einstellungen-Plug-in

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

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

apply plugin 'com.android.settings'

Globale Konfigurationen zentralisieren

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

android {
  compileSdk 31
  minSdk 28
  ...
}

Profile für die Tool-Ausführung

Mit dem Einstellungen-Plug-in 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 verschiedene 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 dem Attribut android.experimental.settings.executionProfile in der Datei gradle.properties ein anderes Profil aus:

android.experimental.settings.executionProfile=high

Sie können dieses Attribut auch über die Befehlszeile festlegen, um verschiedene Arbeitsabläufe einzurichten. Wenn Sie beispielsweise einen Continuous Integration-Workflow haben, können Sie das Ausführungsprofil über die Befehlszeile ändern, ohne die Datei settings.gradle ändern zu müssen:

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

Für AGP 8.0 ist JDK 17 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 daher keine Konfigurationsänderungen an ihren Projekten vornehmen.

Wenn Sie die von AGP in Android Studio verwendete JDK-Version manuell festlegen müssen, 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