Skip to content

Commit 0db4cac

Browse files
richardthe3rdclaude
andcommitted
docs(android): use full mapping file path in retrace examples
Both retrace command examples were passing a bare `mapping.txt` filename that only works if the user first cd's to the build output directory. Use the full relative path so commands are runnable from the repo root. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 1afcfd3 commit 0db4cac

1 file changed

Lines changed: 8 additions & 6 deletions

File tree

docs/tooling/android-release.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -768,12 +768,12 @@ ls -lh build/app/outputs/flutter-apk/app-release.apk
768768
If you encounter crashes in production, use the mapping file to deobfuscate:
769769

770770
```bash
771-
# Mapping file location
771+
# Mapping file location (after a release build)
772772
build/app/outputs/mapping/release/mapping.txt
773773

774-
# Upload to Play Console for automatic deobfuscation
775-
# Or use retrace tool:
776-
retrace.sh -verbose mapping.txt obfuscated_trace.txt
774+
# Deobfuscate using the Android SDK retrace tool:
775+
$ANDROID_HOME/tools/proguard/bin/retrace.sh -verbose \
776+
build/app/outputs/mapping/release/mapping.txt obfuscated_trace.txt
777777
```
778778

779779
### Recommendation for This App
@@ -790,10 +790,12 @@ enabling automatic deobfuscation of crash stack traces in the Play Console.
790790
build/app/outputs/mapping/release/mapping.txt
791791

792792
# Deobfuscate using the Android SDK retrace tool:
793-
$ANDROID_HOME/tools/proguard/bin/retrace.sh -verbose mapping.txt obfuscated_trace.txt
793+
$ANDROID_HOME/tools/proguard/bin/retrace.sh -verbose \
794+
build/app/outputs/mapping/release/mapping.txt obfuscated_trace.txt
794795

795796
# Or with a standalone retrace JAR:
796-
java -jar $ANDROID_HOME/tools/proguard/lib/retrace.jar -verbose mapping.txt obfuscated_trace.txt
797+
java -jar $ANDROID_HOME/tools/proguard/lib/retrace.jar -verbose \
798+
build/app/outputs/mapping/release/mapping.txt obfuscated_trace.txt
797799
```
798800

799801
> **Note:** For AAB-based Play Store installs the mapping is also available in Play Console under

0 commit comments

Comments
 (0)