App-Optimierung mit R8 aktivieren

Für die bestmögliche Nutzererfahrung sollten Sie Ihre App so optimieren, dass sie so klein und schnell wie möglich ist. Unser App-Optimierungstool R8 optimiert Ihre App, indem es nicht verwendeten Code und nicht verwendete Ressourcen entfernt, Code umschreibt, um die Laufzeitleistung zu optimieren, und vieles mehr. Für Ihre Nutzer bedeutet das:

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

Übersicht über die R8-Optimierung

R8 verwendet einen mehrphasigen Prozess, um Ihre App in Bezug auf Größe und Geschwindigkeit zu optimieren. Wichtige Vorgänge sind:

• Codekomprimierung (auch Tree Shaking genannt): R8 identifiziert und entfernt nicht erreichbaren Code aus Ihrer Anwendung und ihren Bibliotheksabhängigkeiten. Durch die Analyse der Einstiegspunkte Ihrer App (z. B. Activities oder Services, die im Manifest definiert sind) erstellt R8 ein Diagramm des referenzierten Codes und entfernt alles, worauf nicht verwiesen wird.

• Logische Optimierungen: R8 schreibt Ihren Code um, um die Ausführungseffizienz zu verbessern und den Overhead zu reduzieren. Wichtige Techniken sind:

  • Methoden-Inlining: R8 ersetzt eine Methodenaufrufstelle durch den tatsächlichen Text der aufgerufenen Methode. Dadurch wird der Overhead eines Funktionsaufrufs vermieden und R8 kann weitere Optimierungen durchführen.

  • Klassenzusammenführung: R8 kombiniert Gruppen von Klassen und Schnittstellen zu einer einzigen Klasse. Dadurch wird die Anzahl der Klassen in der App reduziert, der Arbeitsspeicher wird weniger belastet und die Startgeschwindigkeit verbessert.

• Verschleierung (auch Reduzierung genannt): Um die Größe der DEX Datei zu reduzieren, kürzt R8 die Namen von Klassen, Feldern und Methoden (z. B. kann com.example.MyActivity zu a.b.a werden).

Seit Version 8.12.0 des Android-Gradle-Plug-ins (AGP) optimiert R8 auch Ressourcen im Rahmen seiner Optimierungsphasen. Weitere Informationen finden Sie unter Optimierte Ressourcenkomprimierung.

Optimierung aktivieren

Wenn Sie die App-Optimierung aktivieren möchten, legen Sie isMinifyEnabled = true (für die Codeoptimierung) und isShrinkResources = true (für die Ressourcenoptimierung) in Ihrem Release Build's Build-Skript auf App-Ebene fest, wie im folgenden Code gezeigt. Wir empfehlen, beide Einstellungen immer zu aktivieren. Außerdem empfehlen wir, 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')

            ...
        }
    }
}

Ressourcenkomprimierung für noch kleinere Apps optimieren

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

Vor der optimierten Ressourcenkomprimierung hat das Android Asset Packaging Tool (AAPT2) Keep-Regeln generiert, bei denen die Ressourcenkomprimierung getrennt vom Code behandelt wurde. Dadurch wurden häufig nicht zugänglicher Code oder Ressourcen beibehalten, die aufeinander verwiesen haben.

Bei der optimierten Ressourcenkomprimierung werden Ressourcen als Teil des Programmcodes betrachtet und bilden das Referenzdiagramm. Wenn auf eine Sammlung von Code oder Ressourcen nicht verwiesen wird, ist sie nicht durch eine Keep-Regel geschützt und kann entfernt werden.

Optimierte Ressourcenkomprimierung aktivieren

Wenn Sie die neue optimierte Ressourcenkomprimierungspipeline für AGP 8.12 oder 8.13 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 Ressourcenkomprimierung wird automatisch angewendet, wenn isShrinkResources = true in Ihrer Build-Konfiguration aktiviert ist.

R8-Optimierungseinstellungen überprüfen und konfigurieren

Damit R8 seine vollständigen Optimierungsfunktionen nutzen kann, entfernen Sie die folgende Zeile aus der Datei gradle.properties 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 zum Abrufen von Stacktraces, 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 sie mit den folgenden Strategien beheben:

• Fügen Sie Keep-Regeln hinzu, um zu verhindern, dass bestimmter Code geändert wird.
• Übernehmen Sie Optimierungen schrittweise.
• Aktualisieren Sie Ihren Code, um Bibliotheken zu verwenden, die besser für die Optimierung geeignet sind.

Wenn Sie die Build-Geschwindigkeit optimieren möchten, finden Sie unter Konfigurieren, wie R8 ausgeführt wird Informationen zum Konfigurieren von R8 basierend auf Ihrer Umgebung.

R8-Optimierung verbessern

Die Leistungssteigerungen durch R8 hängen direkt davon ab, wie viel von Ihrer Codebasis R8 optimieren kann. Um die Vorteile von R8 optimal zu nutzen, aktivieren Sie R8 im vollständigen Modus und optimieren Sie die Keep-Regeln, um eine maximale Optimierung von Klassen, Feldern und Methoden zu ermöglichen.Verwenden Sie dazu den R8-Konfigurationsanalysator.

Mit dem R8-Konfigurationsanalysator haben Sie folgende Möglichkeiten:

• Sie können die Qualität der R8-Gesamtkonfiguration verfolgen und verbessern, indem Sie die Messwerte im Bericht des R8-Konfigurationsanalysators beobachten.
• Sie können die breitesten Keep-Regeln finden, die die meisten Optimierungen verhindern.
• Sie können nachvollziehen, welche Optimierungen sie verhindern, um sie zu optimieren.

Der R8-Konfigurationsanalysator ist in AGP-Version 9.3.0-alpha05 oder ab R8-Version 9.3.7-dev verfügbar. Weitere Informationen finden Sie unter R8-Konfiguration analysieren.

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.