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

R8-Optimierung – Übersicht

R8 verwendet einen mehrstufigen Prozess, um Ihre App hinsichtlich 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, was nicht referenziert wird.

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

  • Method 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).

Ab 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, immer beide Einstellungen 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 optimieren, um noch kleinere Apps zu erstellen

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, die die Ressourcenkomprimierung effektiv getrennt vom Code behandelt haben. Dabei wurden oft 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 Entfernung von Ressourcen-Pipeline 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 Ursprünglichen 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.
• Nehmen Sie Optimierungen schrittweise vor.
• 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.

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.