breakpad-tools

Install and run Google breakpad tools using Docker for Android NDK.

Description

These tools help running Breakpad's tool dump_syms on all platforms using Docker. The scripts can be used to prepare a Zip file for upload to App Center for symbolication.

Requirements

Docker should be installed and running.

Usage

1. Prepare the docker container by running the following command.

./build.sh

2. To extract symbols and prepare a Zip file for upload to App Center:

./run.sh <path_to_android_ndk_app>/app/build/intermediates/ndkBuild/debug/obj/local/*/*.so

Pass all .so files as argument to run.sh and a file symbols.zip will be created automatically.

3. (Bonus) To enter the docker container, which contains all breakpad tools (dump_syms, minidump_stackwalk, etc...):

./run.sh

Known problems

System symbols from a running Android device are not extracted by the breakpad client. So we can not symbolicate system libraries such as libc.