xref: /aosp_15_r20/external/google-breakpad/android/sample_app/README (revision 9712c20fc9bbfbac4935993a2ca0b3958c5adad2)
1*9712c20fSFrederick MayleThis is a sample Android executable that can be used to test the
2*9712c20fSFrederick MayleGoogle Breakpad client library on Android.
3*9712c20fSFrederick Mayle
4*9712c20fSFrederick MayleIts purpose is simply to crash and generate a minidump under /data/local/tmp.
5*9712c20fSFrederick Mayle
6*9712c20fSFrederick MayleBuild instructions:
7*9712c20fSFrederick Mayle
8*9712c20fSFrederick Mayle   cd android/sample_app
9*9712c20fSFrederick Mayle   $NDK/ndk-build
10*9712c20fSFrederick Mayle
11*9712c20fSFrederick Mayle  Where $NDK points to a valid Android NDK installation.
12*9712c20fSFrederick Mayle
13*9712c20fSFrederick MayleUsage instructions:
14*9712c20fSFrederick Mayle
15*9712c20fSFrederick Mayle   After buildind the test program, send it to a device, then run it as
16*9712c20fSFrederick Mayle   the shell UID:
17*9712c20fSFrederick Mayle
18*9712c20fSFrederick Mayle     adb push libs/armeabi/test_google_breakpad /data/local/tmp
19*9712c20fSFrederick Mayle     adb shell /data/local/tmp/test_google_breakpad
20*9712c20fSFrederick Mayle
21*9712c20fSFrederick Mayle   This will simply crash after dumping the name of the generated minidump
22*9712c20fSFrederick Mayle   file.
23*9712c20fSFrederick Mayle
24*9712c20fSFrederick Mayle   See jni/test_breakpad.cpp for details.
25*9712c20fSFrederick Mayle
26*9712c20fSFrederick Mayle   Use 'armeabi-v7a' instead of 'armeabi' above to test the ARMv7-A version
27*9712c20fSFrederick Mayle   of the binary.
28*9712c20fSFrederick Mayle
29*9712c20fSFrederick MayleNote:
30*9712c20fSFrederick Mayle   If you plan to use the library in a regular Android application, store
31*9712c20fSFrederick Mayle   the minidump files either to your app-specific directory, or to the SDCard
32*9712c20fSFrederick Mayle   (the latter requiring a specific permission).
33