Upload Android mapping files to allow Bugsnag to de-obfuscate your Android stack traces.
If you use a tool to minifiy and optimize your application you will need to upload a mapping file to see full debugging information in error reports including the original class and method names.
If you’re using Android Studio/Gradle to build your Android projects, the best way to send your mapping files to Bugsnag is to use our Gradle plugin.
We use the line numbers of crashes to help with error grouping. You’ll need explicitly to tell ProGuard to not strip this information by adding the following line to your ProGuard configuration:
If you are using our Gradle plugin, this will automatically be added to your ProGuard config.
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 (class name will be used instead of file name in this case).
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.
In cases where you cannot use our Gradle plugin, you’ll need to manually upload your mapping file to Bugsnag using our API.
To send mapping files to Bugsnag, simply POST them to https://upload.bugsnag.com with the following parameters:
proguard- the path to the ProGuard, DexGuard, or R8 mapping file.
apiKey- your Bugsnag integration API key for this application.
appId- the Android
applicationIdfor this application.
versionCode- the Android
versionCodefor this application release.
versionName(optional) - the Android
versionNamefor this application release, used when displaying the version.
buildUUID(optional) - a UUID to identify this builds. This is required if you build multiple different apps with the same
versionCode. If you use this, you’ll also need to use
setBuildUUID()in your app.
overwrite(optional) - overwrite any existing
ProGuardmappings for this version of your app.
Here’s an example request with curl:
$ curl https://upload.bugsnag.com/ \ -F proguard=@/path/to/mapping.txt \ -F apiKey=YOUR_API_KEY_HERE \ -F versionCode=123 \ -F appId=com.example.android.app \ -F versionName=2.3.0
If the file is accepted then an HTTP 200 response will be returned with the body “OK”.
If not, there are several possible problems which will be indicated with an HTTP 4XX response:
buildUUIDparameter, or by using the
apiKeydoesn’t correspond to a Bugsnag project.
versionCodeparameters are missing.