From d3193221f60f86465e7e01f827530ac6849db2d2 Mon Sep 17 00:00:00 2001
From: adbenitez <asieldbenitez@gmail.com>
Date: Fri, 14 Mar 2025 15:54:30 +0100
Subject: [PATCH] add instructions about decoding symbols in core crash

---
 README.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/README.md b/README.md
index 20cb8cf1c..f881688b7 100644
--- a/README.md
+++ b/README.md
@@ -227,6 +227,16 @@ You have 2 ways to do this:
 
 2. Or set them via environment variables.
 
+# Decoding Symbols in Crash Reports
+
+```
+$ANDROID_NDK_ROOT/ndk-stack --sym obj/local/armeabi-v7a --dump crash.txt > decoded.txt
+```
+
+`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)
+
 # Translations
 
 Android metadata and changelogs are translated using [Weblate](https://hosted.weblate.org/projects/deltachat/android-metadata/).