doc: Update Android developer documentation for NDK 14

NDK 14 is current. Update the developer documentation to reflect this.

Recommend using subdirectories of out/ as the Android build output
directory, so that they’ll be ignored by .gitignore.

Bug: crashpad:30
Change-Id: Id1508215b924a3e0cae2c11a61c9c685363c50f6
Reviewed-on: https://chromium-review.googlesource.com/454202
Reviewed-by: Mark Mentovai <mark@chromium.org>
Commit-Queue: Mark Mentovai <mark@chromium.org>
This commit is contained in:
Mark Mentovai 2017-03-13 23:33:18 -04:00 committed by Commit Bot
parent 18d70acf81
commit 3eaee58970

View File

@ -112,7 +112,7 @@ Kit)](https://developer.android.com/ndk/) runs on.
If its not already present on your system, [download the NDK package for your If its not already present on your system, [download the NDK package for your
system](https://developer.android.com/ndk/downloads/) and expand it to a system](https://developer.android.com/ndk/downloads/) and expand it to a
suitable location. These instructions assume that its been expanded to suitable location. These instructions assume that its been expanded to
`~/android-ndk-r13`. `~/android-ndk-r14`.
To build Crashpad, portions of the NDK must be reassembled into a [standalone To build Crashpad, portions of the NDK must be reassembled into a [standalone
toolchain](https://developer.android.com/ndk/guides/standalone_toolchain.html). toolchain](https://developer.android.com/ndk/guides/standalone_toolchain.html).
@ -126,8 +126,8 @@ desired. To build a standalone toolchain targeting 64-bit ARM and API level 21
``` ```
$ cd ~ $ cd ~
$ python android-ndk-r13/build/tools/make_standalone_toolchain.py \ $ python android-ndk-r14/build/tools/make_standalone_toolchain.py \
--arch=arm64 --api=21 --install-dir=android-ndk-r13_arm64_api21 --arch=arm64 --api=21 --install-dir=android-ndk-r14_arm64_api21
``` ```
Note that Chrome uses Android API level 21 for 64-bit platforms and 16 for Note that Chrome uses Android API level 21 for 64-bit platforms and 16 for
@ -144,14 +144,14 @@ not be permanent.
``` ```
$ cd ~/crashpad/crashpad $ cd ~/crashpad/crashpad
$ CC_target=~/android-ndk-r13_arm64_api21/bin/clang \ $ CC_target=~/android-ndk-r14_arm64_api21/bin/clang \
CXX_target=~/android-ndk-r13_arm64_api21/bin/clang++ \ CXX_target=~/android-ndk-r14_arm64_api21/bin/clang++ \
AR_target=~/android-ndk-r13_arm64_api21/bin/aarch64-linux-android-ar \ AR_target=~/android-ndk-r14_arm64_api21/bin/aarch64-linux-android-ar \
NM_target=~/android-ndk-r13_arm64_api21/bin/aarch64-linux-android-nm \ NM_target=~/android-ndk-r14_arm64_api21/bin/aarch64-linux-android-nm \
READELF_target=~/android-ndk-r13_arm64_api21/bin/aarch64-linux-android-readelf \ READELF_target=~/android-ndk-r14_arm64_api21/bin/aarch64-linux-android-readelf \
python build/gyp_crashpad.py \ python build/gyp_crashpad.py \
-DOS=android -Dtarget_arch=arm64 -Dclang=1 \ -DOS=android -Dtarget_arch=arm64 -Dclang=1 \
--generator-output=out_android_arm64_api21 -f ninja-android --generator-output=out/android_arm64_api21 -f ninja-android
``` ```
It is also possible to use GCC instead of Clang by making the appropriate It is also possible to use GCC instead of Clang by making the appropriate
@ -174,7 +174,7 @@ build, direct `ninja` to the specific `out` directory chosen by
`--generator-output` above. `--generator-output` above.
``` ```
$ ninja -C out_android_arm64_api21/out/Debug crashpad_test_test $ ninja -C out/android_arm64_api21/out/Debug crashpad_test_test
``` ```
## Testing ## Testing
@ -216,10 +216,10 @@ transferred to the device prior to running the test.
``` ```
$ cd ~/crashpad/crashpad $ cd ~/crashpad/crashpad
$ adb push out_android_arm64_api21/out/Debug/crashpad_test_test /data/local/tmp/ $ adb push out/android_arm64_api21/out/Debug/crashpad_test_test /data/local/tmp/
[100%] /data/local/tmp/crashpad_test_test [100%] /data/local/tmp/crashpad_test_test
$ adb push \ $ adb push \
out_android_arm64_api21/out/Debug/crashpad_test_test_multiprocess_exec_test_child \ out/android_arm64_api21/out/Debug/crashpad_test_test_multiprocess_exec_test_child \
/data/local/tmp/ /data/local/tmp/
[100%] /data/local/tmp/crashpad_test_test_multiprocess_exec_test_child [100%] /data/local/tmp/crashpad_test_test_multiprocess_exec_test_child
$ adb shell mkdir -p /data/local/tmp/crashpad_test_data_root/test $ adb shell mkdir -p /data/local/tmp/crashpad_test_data_root/test