Offenlegung oder Symbolication von Absturz-Stacktraces

Abstürze und ANRs unter Android generieren einen Stacktrace. Das ist ein Snapshot der Reihenfolge der verschachtelten Funktionen, die in Ihrem Programm bis zum Absturz aufgerufen wurden. Mit diesen Snapshots können Sie Probleme in der Quelle identifizieren und beheben.

Wenn Ihre App oder Ihr Spiel mit Java entwickelt wurde und Sie Ihre App mit ProGuard optimieren und verschleiern, können Sie für jede Version Ihrer App in der Play Console eine ProGuard-Zuordnungsdatei hochladen. Wenn Ihre App oder Ihr Spiel mit nativem Code wie C++ entwickelt wurde, können Sie in der Play Console für jede App-Version eine Debugging-Symboldatei hochladen. Dadurch lassen sich Abstürze und ANRs leichter analysieren und beheben.

Wichtig: Zur Offenlegung von in Java kompilierten Apps werden nur mit ReTrace kompatible Zuordnungsdateien unterstützt. Das ist dasselbe Format, das auch von ProGuard oder R8 verwendet wird.

Schritt 1: Offenlegungs- oder Symbolication-Datei generieren

Zur Offenlegung oder Symbolication der Abstürze und ANRs für eine Version Ihrer App müssen Sie zuerst die erforderlichen Dateien für diese Version der App generieren. Damit die Offenlegung oder Symbolication funktioniert, ist für jede neue Version Ihrer App eine eigene Datei zu generieren und hochzuladen.

Java: ProGuard-Zuordnungsdatei generieren

Nativ: Debugging-Symboldatei generieren

Android-Gradle-Plug-in ab Version 4.1

Wenn Sie Ihr Projekt als Android App Bundle erstellen, können Sie die Debugging-Symboldatei automatisch darin aufnehmen lassen. Dazu fügen Sie der Datei build.gradle Ihrer App Folgendes hinzu:

android.defaultConfig.ndk.debugSymbolLevel = 'FULL'

Hinweis: Die Größe der Debugging-Symboldatei darf maximal 800 MB betragen. Wenn die Symbole zum Debuggen zu groß sind, verwenden Sie SYMBOL_TABLE anstelle von FULL, um die Dateigröße zu verringern.

Wenn Sie Ihr Projekt als Android App Bundle erstellen, verwenden Sie die obige Build-Einstellung „build.gradle“, um die Debugging-Symboldatei separat zu generieren. Laden Sie die Debugging-Symboldatei manuell in die Google Play Console hoch, wie in Schritt 2: Offenlegungs- oder Symbolication-Datei hochladen beschrieben. Im Rahmen des Build-Prozesses gibt das Android-Gradle-Plug-in diese Datei am folgenden Projektspeicherort aus:

app/build/outputs/native-debug-symbols/variant-name/native-debug-symbols.zip

Android-Gradle-Plug-in in der Version 4.0 und niedriger (und andere Build-Systeme)

Im Rahmen des Build-Prozesses für ein App Bundle oder APK speichert das Android-Gradle-Plug-in eine Kopie der Bibliotheken mit Debugging-Symbolen in einem Projektverzeichnis. Die Struktur dieses Verzeichnisses sieht ungefähr so aus:

app/build/intermediates/cmake/universal/release/obj

├── armeabi-v7a/

│ ├── libgamenegine.so

│ ├── libothercode.so

│ └── libvideocodec.so

├── arm64-v8a/

│ ├── libgamenegine.so

│ ├── libothercode.so

│ └── libvideocodec.so

├── x86/

│ ├── libgamenegine.so

│ ├── libothercode.so

│ └── libvideocodec.so

└── x86_64/

├── libgameengine.so

├── libothercode.so

└── libvideocodec.so

Hinweis: Wenn Sie ein anderes Build-System verwenden, können Sie es so ändern, dass Bibliotheken mit Debugging-Symbolen zwingend in einem Verzeichnis mit der oben genannten Struktur gespeichert werden.

Komprimieren Sie den Inhalt dieses Verzeichnisses:
- $ cd app/build/intermediates/cmake/universal/release/obj
- $ zip -r symbols.zip .
Laden Sie die Datei „symbols.zip“ manuell in die Play Console hoch, wie in Schritt 2: Offenlegungs- oder Symbolication-Datei hochladen beschrieben.

Die Debugging-Symboldatei darf nicht größer als 800 MB sein. Wenn Ihre Datei zu groß ist, liegt das wahrscheinlich daran, dass Ihre .so-Dateien eine Symboltabelle (Funktionsnamen) und zusätzlich DWARF-Informationen zur Fehlerbehebung (Dateinamen und Codezeilen) enthalten. Diese sind für die Symbolication des Codes nicht erforderlich und können mit dem folgenden Befehl entfernt werden:

$OBJCOPY --strip-debug lib.so lib.so.sym

Hinweis: $OBJCOPY verweist auf die spezifische Version für das ABI, das Sie entfernen, z. B. ndk-bundle/toolchains/aarch64-linux-android-4.9/prebuilt/linux-x86_64/bin/aarch64-linux-android-objcopy

Schritt 2: Offenlegungs- oder Symbolication-Datei hochladen

Für die Offenlegung oder Symbolication der Abstürze und ANRs für eine Version Ihrer App müssen Sie zuerst die Offenlegungs- oder Symbolication-Dateien für die einzelnen Versionen der App hochladen.

Wichtig: Dieser Schritt ist nur erforderlich, wenn Sie APKs verwenden. Wenn Sie ein App-Bundle und ein Android-Gradle-Plug-in in der Version 4.1 oder höher verwenden, müssen Sie nichts weiter tun. Die Offenlegungsdatei wird automatisch aus dem Bundle abgerufen und Sie können mit Schritt 3: Offengelegte Absturz-Stacktraces ansehen fortfahren. Weitere Informationen zu App Bundles finden Sie auf der Website für Android-Entwickler.

Dateien über die Play Console hochladen

Dateien mithilfe der Google Play Developer API hochladen

Schritt 3: Offengelegte Absturz-Stacktraces ansehen

Nachdem Sie für eine Version Ihrer App eine ProGuard-Zuordnungsdatei oder eine Debugging-Symboldatei hochgeladen haben, werden alle künftigen Abstürze und ANRs offengelegt. Sie können offengelegte Stacktraces für einzelne Abstürze und ANRs auf der Seite Abstürze und ANRs Ihrer App einsehen.

Öffnen Sie die Play Console.
Wählen Sie eine App aus.
Wählen Sie im Menü auf der linken Seite Beobachten und verbessern > Android Vitals > Abstürze & ANRs aus.
Wählen Sie einen Absturz aus.
Im Abschnitt „Stacktraces“ sehen Sie Ihre offengelegten und ersetzten Stacktraces.

Wichtig: Nachdem Sie eine Zuordnungsdatei für eine Version Ihrer App hochgeladen haben, werden nur künftige Abstürze und ANRs für diese Version Ihrer App offengelegt. Abstürze und ANRs für eine Version Ihrer App, die vor dem Hochladen der entsprechenden Zuordnungsdatei aufgetreten sind, werden nicht offengelegt.