Android mapping support

Upload your Android mapping files to Bugsnag.

Overview

If you are using ProGuard, DexGuard, or R8 to minify and optimize your app, this will cause method and class names to become obfuscated which makes debugging harder.

Upload your mapping file so Bugsnag can replace the obfuscated data with the original file names, line numbers, and method names. Our Android Gradle plugin automatically uploads your mapping file for each release build.

For NDK applications, a shared object mapping file can be uploaded to display the original code locations.

Note: If you have enabled R8 for your project you must use proguard-android-optimize.txt until this R8 issue is resolved.

Bugsnag’s Gradle plugin will automatically upload ProGuard, DexGuard, and R8 mapping files and NDK shared object files when you build your app. See our Gradle Plugin docs to get started.

Manually uploading mapping files

In cases where you are not using Gradle, you’ll need to manually upload your mapping files to Bugsnag using our APIs.

For ProGuard, DexGuard, and R8 mapping files see the Android Mapping Upload API reference for more details.

For NDK shared object files see the NDK Symbol Upload API reference for more details.

ProGuard Settings

If you are using proguard-android-optimize.txt settings then Bugsnag will convert the stack traces to a human-readable format, but the original file names might not be available.

If the stack traces provided to Bugsnag do not contain a valid file, then we will use the unqualified class name in place of the file name.