Globale Optionen hinzufügen

R8 bietet globale Optionen, die entweder die Optimierungen von R8 in der gesamten App ändern oder sich auf jede Keep-Regel auswirken. Diese Optionen werden zusammen mit den Aufbewahrungsregeln in der Datei proguard-rules.pro verwaltet. Einige dieser globalen Optionen konfigurieren zusätzliche Optimierungen, während andere bestimmte Aspekte der Optimierung deaktivieren.

Globale Optionen für zusätzliche Optimierung

Mit den folgenden globalen Optionen kann die Optimierung weiter verbessert werden:

• -repackageclasses [<optional-package-name>]: Klassen werden in einem einzigen angegebenen Paket neu verpackt, um die App-Größe weiter zu verringern. Wenn Sie den optionalen Paketnamen nicht angeben, werden die Klassen in das leere Standardpaket verschoben. Dies ist eine empfohlene Einstellung für Apps.
• -allowaccessmodification: Ermöglicht R8, die Sichtbarkeit von Klassen, Feldern und Methoden zu ändern (in der Regel zu erweitern), um umfassendere Optimierungen durchzuführen. Aktiviert, wenn proguard-android-optimize.txt verwendet wird. Seit Android Gradle-Plugin (AGP) 8.2 ist dies die Standardkonfiguration, wenn Sie R8 im vollständigen Modus verwenden.

Hier sehen Sie ein Beispiel für eine Konfiguration, bei der die zusätzliche Optimierung aktiviert ist:

-repackageclasses
-allowaccessmodification

Globale Optionen zum Einschränken der Optimierung

Mit den folgenden globalen Optionen können Sie bestimmte Aspekte der App-Optimierung deaktivieren. Das ist hilfreich, wenn Sie Ihre Keep-Regeln optimieren oder R8 zum ersten Mal aktivieren.

• -dontoptimize: Verhindert die Codeoptimierung, z. B. das Inlining von Methoden. Diese Option kann während der Entwicklung verwendet werden, sollte aber nicht in Produktions-Builds verwendet werden.
• -dontshrink: Verhindert das Entfernen von nicht referenzierten Code und Codeoptimierungen. Diese Option kann während der Entwicklung verwendet werden, sollte aber nicht in Produktions-Builds verwendet werden.
• -dontobfuscate: Verhindert das Kürzen der Namen von Klassen und Methoden. Es kann besonders hilfreich sein, die Verschleierung während des Debuggens zu deaktivieren, damit Stacktraces leichter zu lesen sind. Diese Option kann während der Entwicklung verwendet werden, sollte aber nicht in Produktions-Builds verwendet werden.
• -keepattributes <attributes>: Akzeptiert eine durch Kommas getrennte Liste von Attributen, die beibehalten werden sollen. Wenn Sie nicht die Standard-proguard-android-optimize.txt verwenden, entfernt R8 alle Attribute, einschließlich RuntimeVisibleAnnotations und Signature. Es kann jedoch hilfreich sein, diese Attribute beizubehalten, wenn sie in Fällen wie der Reflexion benötigt werden. Eine Liste der Attribute, die Sie angeben können, finden Sie unter Attribute beibehalten.

Attribute beibehalten

Attribute sind zusätzliche Informationen, die an verschiedene Teile Ihres Codes angehängt werden. In Attributen werden Informationen wie Annotationen und generische Signaturen aus Ihrem Code gespeichert.

Für bestimmte reflektierende Vorgänge müssen bestimmte Attribute beibehalten werden, damit sie erfolgreich ausgeführt werden können. Beispiel:

• Wenn Sie mit getEnclosingMethod() oder getDeclaredClasses() auf die innere oder äußere Klassenstruktur zugreifen, sind die Attribute EnclosingMethod und InnerClasses erforderlich.
• Wenn Sie mit getTypeParameters() auf generische Signaturen zugreifen, ist das Attribut Signature erforderlich.

• Wenn Sie mit getAnnotation() auf Annotationen zugreifen, ist das Attribut RuntimeVisibleAnnotations erforderlich.

Häufig erforderliche Attribute

Wenn Sie die Standard-Proguard-Datei (proguard-android-optimize.txt oder proguard-android.txt) verwenden, behält das Android Gradle-Plug-in (AGP) die folgenden Attribute bei. Für einige dieser Attribute sind neuere Versionen von AGP erforderlich:

Für Apps, die proguard-android-optimize.txt verwenden, sind die von AGP definierten Keep-Regeln in den meisten Fällen ausreichend. Wenn Sie jedoch Code für eine Bibliothek schreiben, sollten Sie alle Attribute, die für Ihre Bibliothek erforderlich sind, in den Keep-Regeln für Consumer angeben, auch wenn sie in dieser Liste definiert sind. So ist Ihre Bibliothek auch dann robust, wenn Entwickler sich entscheiden, proguard-android-optimize.txt nicht einzubinden.

Zusätzliche Attribute für die Kundenbindung

Sie können zusätzliche Attribute angeben, die beibehalten werden sollen. Diese sind jedoch für die meisten Szenarien mit Reflektion oder JNI-Zugriff nicht erforderlich. Einige davon werden jedoch möglicherweise weiterhin häufig verwendet, wenn Bibliotheken optimiert werden.