build/android/README.md

1 # android-cmake
3 …Android. This is a collection of CMake scripts that may be useful to the Android NDK community. It…
5 …ripts so that devs that use CMake as their build system may easily compile native code for Android.
9     cmake -DCMAKE_TOOLCHAIN_FILE=android.toolchain.cmake \
18 …cmake -DCMAKE_TOOLCHAIN_FILE=android.toolchain.cmake -DANDROID_NDK=<ndk_path> -DCMAKE_BUILD_TYPE=R…
27 So if you have installed the NDK as `~/android-ndk-r10d` then _android-cmake_ will locate it automa…
31 To build a cmake-based C/C++ project for Android you need:
33 * Android NDK (>= r5) http://developer.android.com/tools/sdk/ndk/index.html
36 The _android-cmake_ is also capable to build with NDK from AOSP or Linaro Android source tree, but …
66 * **ANDROID_NDK** - path to the Android NDK. If not set then _android-cmake_ will search for the mo…
67 …ption nearly matches to the APP_ABI variable used by ndk-build tool from Android NDK. If not speci…
78 …*ANDROID_NATIVE_API_LEVEL** - level of android API to build for. Can be set either to full name (e…
79     * `android-8` for ARM;
80     * `android-9` for x86 and MIPS;
81     * `android-21` for 64-bit ABIs.
83     Building for `android-L` is possible only when it is explicitly selected.
87     * `aarch64-linux-android-4.9`
88     * `aarch64-linux-android-clang3.5`
92     * `mips64el-linux-android-4.9`
93     * `mipsel-linux-android-4.8`
132 * **ANDROID_NDK_LAYOUT** = `RELEASE` - inner layout of Android NDK, should be detected automaticall…
135     * `ANDROID` - NDK from AOSP.
144 ### Recognizing Android build
146 _android-cmake_ defines `ANDROID` CMake variable which can be used to add Android-specific stuff:
148     if (ANDROID)
149         message(STATUS "Hello from Android build!")
166 * `ANDROID_NATIVE_API_LEVEL` - native Android API level we are building for (note: Java part of And…
167 * `ANDROID_NDK_RELEASE` - version of the Android NDK
174 … the same build target. So _android-cmake_ configures CMake to search in Android-specific paths on…
178 will surely find libz.so within the Android NDK.
180 … to use `find_host_package` and `find_host_program` macro defined in the `android.toolchain.cmake`:
226     * Android NDK r7 (and newer) already has `make.exe` on board;