App-Optimierung aktivieren

Für eine optimale Nutzererfahrung sollten Sie Ihre App so klein und schnell wie möglich gestalten. Unser App-Optimierungstool R8 optimiert Ihre App, indem es ungenutzten Code und ungenutzte Ressourcen entfernt, Code neu schreibt, um die Laufzeitleistung zu optimieren, und vieles mehr. Für Ihre Nutzer bedeutet das:

• App startet schneller
• Verbesserte Rendering- und Laufzeitleistung
• Weniger ANRs

Wenn Sie die App-Optimierung aktivieren möchten, legen Sie isMinifyEnabled = true (für die Code-Optimierung) und isShrinkResources = true (für die Ressourcenoptimierung) im Build-Skript auf App-Ebene Ihres Release-Builds fest, wie im folgenden Code dargestellt. Wir empfehlen, immer beide Einstellungen zu aktivieren. Wir empfehlen, die App-Optimierung nur in der endgültigen Version Ihrer App zu aktivieren, die Sie vor der Veröffentlichung testen – in der Regel Ihr Release-Build. Die Optimierungen verlängern die Build-Zeit Ihres Projekts und können das Debugging erschweren, da sie den Code ändern.

android {
    buildTypes {
        release {

            // Enables code-related app optimization.
            isMinifyEnabled = true

            // Enables resource shrinking.
            isShrinkResources = true

            proguardFiles(
                // Default file with automatically generated optimization rules.
                getDefaultProguardFile("proguard-android-optimize.txt"),

                ...
            )
            ...
        }
    }
    ...
}

android {
    buildTypes {
        release {

            // Enables code-related app optimization.
            minifyEnabled true

            // Enables resource shrinking.
            shrinkResources true

            // Default file with automatically generated optimization rules.
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt')

            ...
        }
    }
}

Ressourcenverkleinerung für noch kleinere Apps optimieren

Mit Version 8.12.0 des Android-Gradle-Plug-ins (AGP) wird die optimierte Ressourcenverkleinerung eingeführt, bei der Ressourcen- und Codeoptimierung integriert werden, um noch kleinere und schnellere Apps zu erstellen.

Optimierte Ressourcenverkleinerung aktivieren

Wenn Sie die neue optimierte Pipeline zum Verkleinern von Ressourcen für eine Version von AGP vor 9.0.0 aktivieren möchten, fügen Sie der Datei gradle.properties Ihres Projekts Folgendes hinzu:

android.r8.optimizedResourceShrinking=true

Wenn Sie AGP 9.0.0 oder eine neuere Version verwenden, müssen Sie android.r8.optimizedResourceShrinking=true nicht festlegen. Die optimierte Ressourcenverkleinerung wird automatisch angewendet, wenn isShrinkResources = true in Ihrer Build-Konfiguration aktiviert ist.

R8-Optimierungseinstellungen prüfen und konfigurieren

Damit R8 seine vollständigen Optimierungsfunktionen nutzen kann, entfernen Sie die folgende Zeile aus der gradle.properties-Datei Ihres Projekts, falls sie vorhanden ist:

android.enableR8.fullMode=false # Remove this line from your codebase.

Wenn Sie die App-Optimierung aktivieren, sind Stacktraces schwer zu verstehen, insbesondere wenn R8 Klassen- oder Methodennamen umbenennt. Informationen dazu, wie Sie Stacktraces erhalten, die Ihrem Quellcode entsprechen, finden Sie unter Original-Stacktrace wiederherstellen.

Wenn R8 aktiviert ist, sollten Sie auch Startprofile erstellen, um die Startleistung noch weiter zu verbessern.

Wenn Sie die App-Optimierung aktivieren und dadurch Fehler auftreten, können Sie Folgendes versuchen:

• Behalteregeln hinzufügen, um bestimmten Code unverändert zu lassen.
• Optimierungen schrittweise vornehmen:
• Aktualisieren Sie Ihren Code, um Bibliotheken zu verwenden, die sich besser für die Optimierung eignen.

Wenn Sie die Build-Geschwindigkeit optimieren möchten, finden Sie unter Konfigurieren der Ausführung von R8 Informationen zum Konfigurieren von R8 basierend auf Ihrer Umgebung.

Verhaltensänderungen bei AGP- und R8-Versionen

In der folgenden Tabelle sind die wichtigsten Funktionen aufgeführt, die in verschiedenen Versionen des Android-Gradle-Plug-ins (AGP) und des R8-Compilers eingeführt wurden.