From 94657767158892741e1c0f9cfd1b1553d09378ef Mon Sep 17 00:00:00 2001 From: adbenitez Date: Tue, 28 Apr 2026 16:04:07 +0200 Subject: [PATCH] add mapping.txt to symbols zip --- BUILDING.md | 12 ++++++++++++ scripts/upload-release.sh | 1 + 2 files changed, 13 insertions(+) diff --git a/BUILDING.md b/BUILDING.md index 37bf82e94..8b58b3962 100644 --- a/BUILDING.md +++ b/BUILDING.md @@ -243,3 +243,15 @@ $ANDROID_NDK_ROOT/ndk-stack --sym obj/local/armeabi-v7a --dump crash.txt > decod `obj/local/armeabi-v7a` is the extracted path from `deltachat-gplay-release-X.X.X.apk-symbols.zip` file from https://download.delta.chat/android/symbols/ Replace `armeabi-v7a` by the correct architecture the logs come from (can be guessed by trial and error) + + +### Deobfuscating Java Stack Traces + +Because the app uses code minification (ProGuard/R8), Java stack traces in crash reports are obfuscated. +To decode them, use `retrace` with the `mapping.txt` file that is included in the symbols zip: + +``` +retrace mapping.txt crash.txt > decoded-crash.txt +``` + +`mapping.txt` is extracted from the same `deltachat-gplay-release-X.X.X.apk-symbols.zip` file available at https://download.delta.chat/android/symbols/ diff --git a/scripts/upload-release.sh b/scripts/upload-release.sh index 7161feb8b..cb3f19e1e 100755 --- a/scripts/upload-release.sh +++ b/scripts/upload-release.sh @@ -34,6 +34,7 @@ cd ../.. SYMBOLS_ZIP="$APK-symbols.zip" rm $SYMBOLS_ZIP zip -r $SYMBOLS_ZIP obj +zip $SYMBOLS_ZIP build/outputs/mapping/gplayRelease/mapping.txt ls -l $SYMBOLS_ZIP rsync --progress $SYMBOLS_ZIP jekyll@download.delta.chat:/var/www/html/download/android/symbols/