breakpad/android/sample_app
digit@chromium.org 0bed408b15 Add Android NDK module definition + sample application
This patch adds a new directory named "android/" which contains
the following:

- A NDK build system module definition for the Google Breakpad
  client library. This can be used by developers using the ndk-build
  build system to more easily build and use the client library in
  their own programs.

- A sample application demonstrating how to use the module,
  as well as test that the library works properly during a
  crash.

- A shell script (run-checks.sh) that will check everything
  for you automatically, including:

  - Rebuilding the host Google Breakpad host package with configure/make
  - Rebuilding the Android client library with configure/make
  - Rebuilding the Android client library and test program with ndk-build
  - Running the crashing test program, extract minidump, dump symbols,
    generate a stack trace and check that it has correct source file
    locations.

For more details, run android/run-checks.sh --help-all

+ Updates to the README.ANDROID documentation.
Review URL: https://breakpad.appspot.com/407002

git-svn-id: http://google-breakpad.googlecode.com/svn/trunk@983 4c0a9323-5329-0410-9bdc-e9ce6186880e
2012-07-09 19:02:17 +00:00
..
jni Add Android NDK module definition + sample application 2012-07-09 19:02:17 +00:00
README Add Android NDK module definition + sample application 2012-07-09 19:02:17 +00:00

This is a sample Android executable that can be used to test the
Google Breakpad client library on Android.

Its purpose is simply to crash and generate a minidump under /data/local/tmp.

Build instructions:

   cd android/sample_app
   $NDK/ndk-build

  Where $NDK points to a valid Android NDK installation.

Usage instructions:

   After buildind the test program, send it to a device, then run it as
   the shell UID:

     adb push libs/armeabi/test_google_breakpad /data/local/tmp
     adb shell /data/local/tmp/test_google_breakpad

   This will simply crash after dumping the name of the generated minidump
   file.

   See jni/test_breakpad.cpp for details.

   Use 'armeabi-v7a' instead of 'armeabi' above to test the ARMv7-A version
   of the binary.

Note:
   If you plan to use the library in a regular Android application, store
   the minidump files either to your app-specific directory, or to the SDCard
   (the latter requiring a specific permission).