Check in a copy of android-cmake.
BUG=26 Change-Id: I2f95740afdbc3bdb0676626679a30f1e1cc307d6 Reviewed-on: https://boringssl-review.googlesource.com/7984 Reviewed-by: Adam Langley <agl@google.com>
This commit is contained in:
parent
00b1069a6b
commit
f07ba17942
96
third_party/android-cmake/AndroidNdkGdb.cmake
vendored
Normal file
96
third_party/android-cmake/AndroidNdkGdb.cmake
vendored
Normal file
@ -0,0 +1,96 @@
|
||||
# Copyright (c) 2014, Pavel Rojtberg
|
||||
# All rights reserved.
|
||||
#
|
||||
# Redistribution and use in source and binary forms, with or without
|
||||
# modification, are permitted provided that the following conditions are met:
|
||||
#
|
||||
# 1. Redistributions of source code must retain the above copyright notice,
|
||||
# this list of conditions and the following disclaimer.
|
||||
#
|
||||
# 2. Redistributions in binary form must reproduce the above copyright notice,
|
||||
# this list of conditions and the following disclaimer in the documentation
|
||||
# and/or other materials provided with the distribution.
|
||||
#
|
||||
# 3. Neither the name of the copyright holder nor the names of its
|
||||
# contributors may be used to endorse or promote products derived from this
|
||||
# software without specific prior written permission.
|
||||
#
|
||||
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
||||
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
|
||||
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
||||
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
||||
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
||||
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
||||
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
||||
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
||||
# POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
# ------------------------------------------------------------------------------
|
||||
# Usage:
|
||||
# 1. place AndroidNdkGdb.cmake somewhere inside ${CMAKE_MODULE_PATH}
|
||||
# 2. inside your project add
|
||||
#
|
||||
# include(AndroidNdkGdb)
|
||||
# android_ndk_gdb_enable()
|
||||
# # for each target
|
||||
# add_library(MyLibrary ...)
|
||||
# android_ndk_gdb_debuggable(MyLibrary)
|
||||
|
||||
|
||||
# add gdbserver and general gdb configuration to project
|
||||
# also create a mininal NDK skeleton so ndk-gdb finds the paths
|
||||
#
|
||||
# the optional parameter defines the path to the android project.
|
||||
# uses PROJECT_SOURCE_DIR by default.
|
||||
macro(android_ndk_gdb_enable)
|
||||
if(ANDROID)
|
||||
# create custom target that depends on the real target so it gets executed afterwards
|
||||
add_custom_target(NDK_GDB ALL)
|
||||
|
||||
if(${ARGC})
|
||||
set(ANDROID_PROJECT_DIR ${ARGV0})
|
||||
else()
|
||||
set(ANDROID_PROJECT_DIR ${PROJECT_SOURCE_DIR})
|
||||
endif()
|
||||
|
||||
set(NDK_GDB_SOLIB_PATH ${ANDROID_PROJECT_DIR}/obj/local/${ANDROID_NDK_ABI_NAME}/)
|
||||
file(MAKE_DIRECTORY ${NDK_GDB_SOLIB_PATH})
|
||||
|
||||
# 1. generate essential Android Makefiles
|
||||
file(MAKE_DIRECTORY ${ANDROID_PROJECT_DIR}/jni)
|
||||
if(NOT EXISTS ${ANDROID_PROJECT_DIR}/jni/Android.mk)
|
||||
file(WRITE ${ANDROID_PROJECT_DIR}/jni/Android.mk "APP_ABI := ${ANDROID_NDK_ABI_NAME}\n")
|
||||
endif()
|
||||
if(NOT EXISTS ${ANDROID_PROJECT_DIR}/jni/Application.mk)
|
||||
file(WRITE ${ANDROID_PROJECT_DIR}/jni/Application.mk "APP_ABI := ${ANDROID_NDK_ABI_NAME}\n")
|
||||
endif()
|
||||
|
||||
# 2. generate gdb.setup
|
||||
get_directory_property(PROJECT_INCLUDES DIRECTORY ${PROJECT_SOURCE_DIR} INCLUDE_DIRECTORIES)
|
||||
string(REGEX REPLACE ";" " " PROJECT_INCLUDES "${PROJECT_INCLUDES}")
|
||||
file(WRITE ${LIBRARY_OUTPUT_PATH}/gdb.setup "set solib-search-path ${NDK_GDB_SOLIB_PATH}\n")
|
||||
file(APPEND ${LIBRARY_OUTPUT_PATH}/gdb.setup "directory ${PROJECT_INCLUDES}\n")
|
||||
|
||||
# 3. copy gdbserver executable
|
||||
file(COPY ${ANDROID_NDK}/prebuilt/android-${ANDROID_ARCH_NAME}/gdbserver/gdbserver DESTINATION ${LIBRARY_OUTPUT_PATH})
|
||||
endif()
|
||||
endmacro()
|
||||
|
||||
# register a target for remote debugging
|
||||
# copies the debug version to NDK_GDB_SOLIB_PATH then strips symbols of original
|
||||
macro(android_ndk_gdb_debuggable TARGET_NAME)
|
||||
if(ANDROID)
|
||||
get_property(TARGET_LOCATION TARGET ${TARGET_NAME} PROPERTY LOCATION)
|
||||
|
||||
# create custom target that depends on the real target so it gets executed afterwards
|
||||
add_dependencies(NDK_GDB ${TARGET_NAME})
|
||||
|
||||
# 4. copy lib to obj
|
||||
add_custom_command(TARGET NDK_GDB POST_BUILD COMMAND ${CMAKE_COMMAND} -E copy_if_different ${TARGET_LOCATION} ${NDK_GDB_SOLIB_PATH})
|
||||
|
||||
# 5. strip symbols
|
||||
add_custom_command(TARGET NDK_GDB POST_BUILD COMMAND ${CMAKE_STRIP} ${TARGET_LOCATION})
|
||||
endif()
|
||||
endmacro()
|
58
third_party/android-cmake/AndroidNdkModules.cmake
vendored
Normal file
58
third_party/android-cmake/AndroidNdkModules.cmake
vendored
Normal file
@ -0,0 +1,58 @@
|
||||
# Copyright (c) 2014, Pavel Rojtberg
|
||||
# All rights reserved.
|
||||
#
|
||||
# Redistribution and use in source and binary forms, with or without
|
||||
# modification, are permitted provided that the following conditions are met:
|
||||
#
|
||||
# 1. Redistributions of source code must retain the above copyright notice,
|
||||
# this list of conditions and the following disclaimer.
|
||||
#
|
||||
# 2. Redistributions in binary form must reproduce the above copyright notice,
|
||||
# this list of conditions and the following disclaimer in the documentation
|
||||
# and/or other materials provided with the distribution.
|
||||
#
|
||||
# 3. Neither the name of the copyright holder nor the names of its
|
||||
# contributors may be used to endorse or promote products derived from this
|
||||
# software without specific prior written permission.
|
||||
#
|
||||
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
||||
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
|
||||
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
||||
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
||||
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
||||
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
||||
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
||||
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
||||
# POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
macro(android_ndk_import_module_cpufeatures)
|
||||
if(ANDROID)
|
||||
include_directories(${ANDROID_NDK}/sources/android/cpufeatures)
|
||||
add_library(cpufeatures ${ANDROID_NDK}/sources/android/cpufeatures/cpu-features.c)
|
||||
target_link_libraries(cpufeatures dl)
|
||||
endif()
|
||||
endmacro()
|
||||
|
||||
macro(android_ndk_import_module_native_app_glue)
|
||||
if(ANDROID)
|
||||
include_directories(${ANDROID_NDK}/sources/android/native_app_glue)
|
||||
add_library(native_app_glue ${ANDROID_NDK}/sources/android/native_app_glue/android_native_app_glue.c)
|
||||
target_link_libraries(native_app_glue log)
|
||||
endif()
|
||||
endmacro()
|
||||
|
||||
macro(android_ndk_import_module_ndk_helper)
|
||||
if(ANDROID)
|
||||
android_ndk_import_module_cpufeatures()
|
||||
android_ndk_import_module_native_app_glue()
|
||||
|
||||
include_directories(${ANDROID_NDK}/sources/android/ndk_helper)
|
||||
file(GLOB _NDK_HELPER_SRCS ${ANDROID_NDK}/sources/android/ndk_helper/*.cpp ${ANDROID_NDK}/sources/android/ndk_helper/gl3stub.c)
|
||||
add_library(ndk_helper ${_NDK_HELPER_SRCS})
|
||||
target_link_libraries(ndk_helper log android EGL GLESv2 cpufeatures native_app_glue)
|
||||
|
||||
unset(_NDK_HELPER_SRCS)
|
||||
endif()
|
||||
endmacro()
|
30
third_party/android-cmake/LICENSE
vendored
Normal file
30
third_party/android-cmake/LICENSE
vendored
Normal file
@ -0,0 +1,30 @@
|
||||
Copyright (c) 2010-2011, Ethan Rublee
|
||||
Copyright (c) 2011-2014, Andrey Kamaev
|
||||
Copyright (c) 2014, Pavel Rojtberg
|
||||
All rights reserved.
|
||||
|
||||
Redistribution and use in source and binary forms, with or without
|
||||
modification, are permitted provided that the following conditions are met:
|
||||
|
||||
1. Redistributions of source code must retain the above copyright notice,
|
||||
this list of conditions and the following disclaimer.
|
||||
|
||||
2. Redistributions in binary form must reproduce the above copyright notice,
|
||||
this list of conditions and the following disclaimer in the documentation
|
||||
and/or other materials provided with the distribution.
|
||||
|
||||
3. Neither the name of the copyright holder nor the names of its
|
||||
contributors may be used to endorse or promote products derived from this
|
||||
software without specific prior written permission.
|
||||
|
||||
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
||||
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||
ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
|
||||
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
||||
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
||||
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
||||
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
||||
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
||||
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGE.
|
12
third_party/android-cmake/README.google
vendored
Normal file
12
third_party/android-cmake/README.google
vendored
Normal file
@ -0,0 +1,12 @@
|
||||
URL: https://github.com/taka-no-me/android-cmake/archive/556cc14296c226f753a3778d99d8b60778b7df4f.zip
|
||||
Version: 556cc14296c226f753a3778d99d8b60778b7df4f
|
||||
License: BSD
|
||||
License File: LICENSE
|
||||
|
||||
Description:
|
||||
android-cmake is a collection of CMake scripts for building against the Android
|
||||
NDK.
|
||||
|
||||
Local Modifications:
|
||||
LICENSE file has been created for compliance purposes. Not included in original
|
||||
distribution.
|
240
third_party/android-cmake/README.md
vendored
Normal file
240
third_party/android-cmake/README.md
vendored
Normal file
@ -0,0 +1,240 @@
|
||||
# android-cmake
|
||||
|
||||
CMake is great, and so is Android. This is a collection of CMake scripts that may be useful to the Android NDK community. It is based on experience from porting OpenCV library to Android: http://opencv.org/platforms/android.html
|
||||
|
||||
Main goal is to share these scripts so that devs that use CMake as their build system may easily compile native code for Android.
|
||||
|
||||
## TL;DR
|
||||
|
||||
cmake -DCMAKE_TOOLCHAIN_FILE=android.toolchain.cmake \
|
||||
-DANDROID_NDK=<ndk_path> \
|
||||
-DCMAKE_BUILD_TYPE=Release \
|
||||
-DANDROID_ABI="armeabi-v7a with NEON" \
|
||||
<source_path>
|
||||
cmake --build .
|
||||
|
||||
One-liner:
|
||||
|
||||
cmake -DCMAKE_TOOLCHAIN_FILE=android.toolchain.cmake -DANDROID_NDK=<ndk_path> -DCMAKE_BUILD_TYPE=Release -DANDROID_ABI="armeabi-v7a with NEON" <source_path> && cmake --build .
|
||||
|
||||
_android-cmake_ will search for your NDK install in the following order:
|
||||
|
||||
1. Value of `ANDROID_NDK` CMake variable;
|
||||
1. Value of `ANDROID_NDK` environment variable;
|
||||
1. Search under paths from `ANDROID_NDK_SEARCH_PATHS` CMake variable;
|
||||
1. Search platform specific locations (home folder, Windows "Program Files", etc).
|
||||
|
||||
So if you have installed the NDK as `~/android-ndk-r10d` then _android-cmake_ will locate it automatically.
|
||||
|
||||
## Getting started
|
||||
|
||||
To build a cmake-based C/C++ project for Android you need:
|
||||
|
||||
* Android NDK (>= r5) http://developer.android.com/tools/sdk/ndk/index.html
|
||||
* CMake (>= v2.6.3, >= v2.8.9 recommended) http://www.cmake.org/download
|
||||
|
||||
The _android-cmake_ is also capable to build with NDK from AOSP or Linaro Android source tree, but you may be required to manually specify path to `libm` binary to link with.
|
||||
|
||||
## Difference from traditional CMake
|
||||
|
||||
Folowing the _ndk-build_ the _android-cmake_ supports **only two build targets**:
|
||||
|
||||
* `-DCMAKE_BUILD_TYPE=Release`
|
||||
* `-DCMAKE_BUILD_TYPE=Debug`
|
||||
|
||||
So don't even try other targets that can be found in CMake documentation and don't forget to explicitly specify `Release` or `Debug` because CMake builds without a build configuration by default.
|
||||
|
||||
## Difference from _ndk-build_
|
||||
|
||||
* Latest GCC available in NDK is used as the default compiler;
|
||||
* `Release` builds with `-O3` instead of `-Os`;
|
||||
* `Release` builds without debug info (without `-g`) (because _ndk-build_ always creates a stripped version but cmake delays this for `install/strip` target);
|
||||
* `-fsigned-char` is added to compiler flags to make `char` signed by default as it is on x86/x86_64;
|
||||
* GCC's stack protector is not used neither in `Debug` nor `Release` configurations;
|
||||
* No builds for multiple platforms (e.g. building for both arm and x86 require to run cmake twice with different parameters);
|
||||
* No file level Neon via `.neon` suffix;
|
||||
|
||||
The following features of _ndk-build_ are not supported by the _android-cmake_ yet:
|
||||
|
||||
* `armeabi-v7a-hard` ABI
|
||||
* `libc++_static`/`libc++_shared` STL runtime
|
||||
|
||||
## Basic options
|
||||
|
||||
Similarly to the NDK build system _android-cmake_ allows to select between several compiler toolchains and target platforms. Most of the options can be set either as cmake arguments: `-D<NAME>=<VALUE>` or as environment variables:
|
||||
|
||||
* **ANDROID_NDK** - path to the Android NDK. If not set then _android-cmake_ will search for the most recent version of supported NDK in commonly used locations;
|
||||
* **ANDROID_ABI** - specifies the target Application Binary Interface (ABI). This option nearly matches to the APP_ABI variable used by ndk-build tool from Android NDK. If not specified then set to `armeabi-v7a`. Possible target names are:
|
||||
* `armeabi` - ARMv5TE based CPU with software floating point operations;
|
||||
* **`armeabi-v7a`** - ARMv7 based devices with hardware FPU instructions (VFPv3_D16);
|
||||
* `armeabi-v7a with NEON` - same as armeabi-v7a, but sets NEON as floating-point unit;
|
||||
* `armeabi-v7a with VFPV3` - same as armeabi-v7a, but sets VFPv3_D32 as floating-point unit;
|
||||
* `armeabi-v6 with VFP` - tuned for ARMv6 processors having VFP;
|
||||
* `x86` - IA-32 instruction set
|
||||
* `mips` - MIPS32 instruction set
|
||||
* `arm64-v8a` - ARMv8 AArch64 instruction set - only for NDK r10 and newer
|
||||
* `x86_64` - Intel64 instruction set (r1) - only for NDK r10 and newer
|
||||
* `mips64` - MIPS64 instruction set (r6) - only for NDK r10 and newer
|
||||
* **ANDROID_NATIVE_API_LEVEL** - level of android API to build for. Can be set either to full name (example: `android-8`) or a numeric value (example: `17`). The default API level depends on the target ABI:
|
||||
* `android-8` for ARM;
|
||||
* `android-9` for x86 and MIPS;
|
||||
* `android-21` for 64-bit ABIs.
|
||||
|
||||
Building for `android-L` is possible only when it is explicitly selected.
|
||||
* **ANDROID_TOOLCHAIN_NAME** - the name of compiler toolchain to be used. This option allows to select between different GCC and Clang versions. The list of possible values depends on the NDK version and will be printed by toolchain file if an invalid value is set. By default _android-cmake_ selects the most recent version of GCC which can build for specified `ANDROID_ABI`.
|
||||
|
||||
Example values are:
|
||||
* `aarch64-linux-android-4.9`
|
||||
* `aarch64-linux-android-clang3.5`
|
||||
* `arm-linux-androideabi-4.8`
|
||||
* `arm-linux-androideabi-4.9`
|
||||
* `arm-linux-androideabi-clang3.5`
|
||||
* `mips64el-linux-android-4.9`
|
||||
* `mipsel-linux-android-4.8`
|
||||
* `x86-4.9`
|
||||
* `x86_64-4.9`
|
||||
* etc.
|
||||
* **ANDROID_STL** - the name of C++ runtime to use. The default is `gnustl_static`.
|
||||
* `none` - do not configure the runtime.
|
||||
* `system` - use the default minimal system C++ runtime library.
|
||||
* Implies `-fno-rtti -fno-exceptions`.
|
||||
* `system_re` - use the default minimal system C++ runtime library.
|
||||
* Implies `-frtti -fexceptions`.
|
||||
* `gabi++_static` - use the GAbi++ runtime as a static library.
|
||||
* Implies `-frtti -fno-exceptions`.
|
||||
* Available for NDK r7 and newer.
|
||||
* `gabi++_shared` - use the GAbi++ runtime as a shared library.
|
||||
* Implies `-frtti -fno-exceptions`.
|
||||
* Available for NDK r7 and newer.
|
||||
* `stlport_static` - use the STLport runtime as a static library.
|
||||
* Implies `-fno-rtti -fno-exceptions` for NDK before r7.
|
||||
* Implies `-frtti -fno-exceptions` for NDK r7 and newer.
|
||||
* `stlport_shared` - use the STLport runtime as a shared library.
|
||||
* Implies `-fno-rtti -fno-exceptions` for NDK before r7.
|
||||
* Implies `-frtti -fno-exceptions` for NDK r7 and newer.
|
||||
* **`gnustl_static`** - use the GNU STL as a static library.
|
||||
* Implies `-frtti -fexceptions`.
|
||||
* `gnustl_shared` - use the GNU STL as a shared library.
|
||||
* Implies `-frtti -fno-exceptions`.
|
||||
* Available for NDK r7b and newer.
|
||||
* Silently degrades to `gnustl_static` if not available.
|
||||
* **NDK_CCACHE** - path to `ccache` executable. If not set then initialized from `NDK_CCACHE` environment variable.
|
||||
|
||||
## Advanced _android-cmake_ options
|
||||
|
||||
Normally _android-cmake_ users are not supposed to touch these variables but they might be useful to workaround some build issues:
|
||||
|
||||
* **ANDROID_FORCE_ARM_BUILD** = `OFF` - generate 32-bit ARM instructions instead of Thumb. Applicable only for arm ABIs and is forced to be `ON` for `armeabi-v6 with VFP`;
|
||||
* **ANDROID_NO_UNDEFINED** = `ON` - show all undefined symbols as linker errors;
|
||||
* **ANDROID_SO_UNDEFINED** = `OFF` - allow undefined symbols in shared libraries;
|
||||
* actually it is turned `ON` by default for NDK older than `r7`
|
||||
* **ANDROID_STL_FORCE_FEATURES** = `ON` - automatically configure rtti and exceptions support based on C++ runtime;
|
||||
* **ANDROID_NDK_LAYOUT** = `RELEASE` - inner layout of Android NDK, should be detected automatically. Possible values are:
|
||||
* `RELEASE` - public releases from Google;
|
||||
* `LINARO` - NDK from Linaro project;
|
||||
* `ANDROID` - NDK from AOSP.
|
||||
* **ANDROID_FUNCTION_LEVEL_LINKING** = `ON` - enables saparate putting each function and data items into separate sections and enable garbage collection of unused input sections at link time (`-fdata-sections -ffunction-sections -Wl,--gc-sections`);
|
||||
* **ANDROID_GOLD_LINKER** = `ON` - use gold linker with GCC 4.6 for NDK r8b and newer (only for ARM and x86);
|
||||
* **ANDROID_NOEXECSTACK** = `ON` - enables or disables stack execution protection code (`-Wl,-z,noexecstack`);
|
||||
* **ANDROID_RELRO** = `ON` - Enables RELRO - a memory corruption mitigation technique (`-Wl,-z,relro -Wl,-z,now`);
|
||||
* **ANDROID_LIBM_PATH** - path to `libm.so` (set to something like `$(TOP)/out/target/product/<product_name>/obj/lib/libm.so`) to workaround unresolved `sincos`.
|
||||
|
||||
## Fine-tuning `CMakeLists.txt` for _android-cmake_
|
||||
|
||||
### Recognizing Android build
|
||||
|
||||
_android-cmake_ defines `ANDROID` CMake variable which can be used to add Android-specific stuff:
|
||||
|
||||
if (ANDROID)
|
||||
message(STATUS "Hello from Android build!")
|
||||
endif()
|
||||
|
||||
The recommended way to identify ARM/MIPS/x86 architecture is examining `CMAKE_SYSTEM_PROCESSOR` which is set to the appropriate value:
|
||||
|
||||
* `armv5te` - for `armeabi` ABI
|
||||
* `armv6` - for `armeabi-v6 with VFP` ABI
|
||||
* `armv7-a` - for `armeabi-v7a`, `armeabi-v7a with VFPV3` and `armeabi-v7a with NEON` ABIs
|
||||
* `aarch64` - for `arm64-v8a` ABI
|
||||
* `i686` - for `x86` ABI
|
||||
* `x86_64` - for `x86_64` ABI
|
||||
* `mips` - for `mips` ABI
|
||||
* `mips64` - for `mips64` ABI
|
||||
|
||||
Other variables that are set by _android-cmake_ and can be used for the fine-grained build configuration are:
|
||||
|
||||
* `NEON` - set if target ABI supports Neon;
|
||||
* `ANDROID_NATIVE_API_LEVEL` - native Android API level we are building for (note: Java part of Andoid application can be built for another API level)
|
||||
* `ANDROID_NDK_RELEASE` - version of the Android NDK
|
||||
* `ANDROID_NDK_HOST_SYSTEM_NAME` - "windows", "linux-x86" or "darwin-x86" depending on the host platform
|
||||
* `ANDROID_RTTI` - set if rtti is enabled by the runtime
|
||||
* `ANDROID_EXCEPTIONS` - set if exceptions are enabled by the runtime
|
||||
|
||||
### Finding packages
|
||||
|
||||
When crosscompiling CMake `find_*` commands are normally expected to find libraries and packages belonging to the same build target. So _android-cmake_ configures CMake to search in Android-specific paths only and ignore your host system locations. So
|
||||
|
||||
find_package(ZLIB)
|
||||
|
||||
will surely find libz.so within the Android NDK.
|
||||
|
||||
However sometimes you need to locate a host package even when cross-compiling. For example you can be searching for your documentation generator. The _android-cmake_ recommends you to use `find_host_package` and `find_host_program` macro defined in the `android.toolchain.cmake`:
|
||||
|
||||
find_host_package(Doxygen)
|
||||
find_host_program(PDFLATEX pdflatex)
|
||||
|
||||
However this will break regular builds so instead of wrapping package search into platform-specific logic you can copy the following snippet into your project (put it after your top-level `project()` command):
|
||||
|
||||
# Search packages for host system instead of packages for target system
|
||||
# in case of cross compilation these macro should be defined by toolchain file
|
||||
if(NOT COMMAND find_host_package)
|
||||
macro(find_host_package)
|
||||
find_package(${ARGN})
|
||||
endmacro()
|
||||
endif()
|
||||
if(NOT COMMAND find_host_program)
|
||||
macro(find_host_program)
|
||||
find_program(${ARGN})
|
||||
endmacro()
|
||||
endif()
|
||||
|
||||
### Compiler flags recycling
|
||||
|
||||
Make sure to do the following in your scripts:
|
||||
|
||||
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${my_cxx_flags}")
|
||||
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} ${my_cxx_flags}")
|
||||
|
||||
The flags will be prepopulated with critical flags, so don't loose them. Also be aware that _android-cmake_ also sets configuration-specific compiler and linker flags.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Building on Windows
|
||||
|
||||
First of all `cygwin` builds are **NOT supported** and will not be supported by _android-cmake_. To build natively on Windows you need a port of make but I recommend http://martine.github.io/ninja/ instead.
|
||||
|
||||
To build with Ninja you need:
|
||||
|
||||
* Ensure you are using CMake newer than 2.8.9;
|
||||
* Download the latest Ninja from https://github.com/martine/ninja/releases;
|
||||
* Put the `ninja.exe` into your PATH (or add path to `ninja.exe` to your PATH environment variable);
|
||||
* Pass `-GNinja` to `cmake` alongside with other arguments (or choose Ninja generator in `cmake-gui`).
|
||||
* Enjoy the fast native multithreaded build :)
|
||||
|
||||
But if you still want to stick to old make then:
|
||||
|
||||
* Get a Windows port of GNU Make:
|
||||
* Android NDK r7 (and newer) already has `make.exe` on board;
|
||||
* `mingw-make` should work as fine;
|
||||
* Download some other port. For example, this one: http://gnuwin32.sourceforge.net/packages/make.htm.
|
||||
* Add path to your `make.exe` to system PATH or always use full path;
|
||||
* Pass `-G"MinGW Makefiles"` and `-DCMAKE_MAKE_PROGRAM="<full/path/to/>make.exe"`
|
||||
* It must be `MinGW Makefiles` and not `Unix Makefiles` even if your `make.exe` is not a MinGW's make.
|
||||
* Run `make.exe` or `cmake --build .` for single-threaded build.
|
||||
|
||||
### Projects with assembler files
|
||||
|
||||
The _android-cmake_ should correctly handle projects with assembler sources (`*.s` or `*.S`). But if you still facing problems with assembler then try to upgrade your CMake to version newer than 2.8.5
|
||||
|
||||
## Copying
|
||||
|
||||
_android-cmake_ is distributed under the terms of [BSD 3-Clause License](http://opensource.org/licenses/BSD-3-Clause)
|
1693
third_party/android-cmake/android.toolchain.cmake
vendored
Normal file
1693
third_party/android-cmake/android.toolchain.cmake
vendored
Normal file
File diff suppressed because it is too large
Load Diff
211
third_party/android-cmake/ndk_links.md
vendored
Normal file
211
third_party/android-cmake/ndk_links.md
vendored
Normal file
@ -0,0 +1,211 @@
|
||||
|
||||
============== r1 ============== (dead links)
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-1.5_r1-windows.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-1.5_r1-darwin-x86.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-1.5_r1-linux-x86.zip
|
||||
|
||||
============== r2 ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-1.6_r1-windows.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-1.6_r1-darwin-x86.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-1.6_r1-linux-x86.zip
|
||||
|
||||
============== r3 ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-r3-windows.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r3-darwin-x86.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r3-linux-x86.zip
|
||||
|
||||
============== r4 ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-r4-windows.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r4-darwin-x86.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r4-linux-x86.zip
|
||||
|
||||
============== r4b ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-r4b-windows.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r4b-darwin-x86.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r4b-linux-x86.zip
|
||||
|
||||
============== r5 ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-r5-windows.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r5-darwin-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r5-linux-x86.tar.bz2
|
||||
|
||||
============== r5b ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-r5b-windows.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r5b-darwin-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r5b-linux-x86.tar.bz2
|
||||
|
||||
============== r5c ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-r5c-windows.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r5c-darwin-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r5c-linux-x86.tar.bz2
|
||||
|
||||
============== r6 ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-r6-windows.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r6-darwin-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r6-linux-x86.tar.bz2
|
||||
|
||||
============== r6b ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-r6b-windows.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r6b-darwin-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r6b-linux-x86.tar.bz2
|
||||
|
||||
============== r7 ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-r7-windows.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r7-darwin-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r7-linux-x86.tar.bz2
|
||||
|
||||
============== r7b ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-r7b-windows.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r7b-darwin-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r7b-linux-x86.tar.bz2
|
||||
|
||||
============== r7c ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-r7c-windows.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r7c-darwin-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r7c-linux-x86.tar.bz2
|
||||
|
||||
============== r8 ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-r8-windows.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r8-darwin-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r8-linux-x86.tar.bz2
|
||||
|
||||
============== r8b ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-r8b-windows.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r8b-darwin-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r8b-linux-x86.tar.bz2
|
||||
|
||||
============== r8c ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-r8c-windows.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r8c-darwin-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r8c-linux-x86.tar.bz2
|
||||
|
||||
============== r8d ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-r8d-windows.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r8d-darwin-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r8d-linux-x86.tar.bz2
|
||||
|
||||
============== r8e ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-r8e-windows-x86.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r8e-windows-x86_64.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r8e-darwin-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r8e-darwin-x86_64.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r8e-linux-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r8e-linux-x86_64.tar.bz2
|
||||
|
||||
============== r9 ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9-windows-x86.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9-windows-x86-legacy-toolchains.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9-windows-x86_64.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9-windows-x86_64-legacy-toolchains.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9-darwin-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9-darwin-x86-legacy-toolchains.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9-darwin-x86_64.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9-darwin-x86_64-legacy-toolchains.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9-linux-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9-linux-x86-legacy-toolchains.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9-linux-x86_64.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9-linux-x86_64-legacy-toolchains.tar.bz2
|
||||
|
||||
============== r9b ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9b-windows-x86.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9b-windows-x86-legacy-toolchains.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9b-windows-x86_64.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9b-windows-x86_64-legacy-toolchains.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9b-darwin-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9b-darwin-x86-legacy-toolchains.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9b-darwin-x86_64.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9b-darwin-x86_64-legacy-toolchains.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9b-linux-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9b-linux-x86-legacy-toolchains.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9b-linux-x86_64.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9b-linux-x86_64-legacy-toolchains.tar.bz2
|
||||
|
||||
============== r9c ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9c-windows-x86.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9c-windows-x86_64.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9c-darwin-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9c-darwin-x86_64.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9c-linux-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9c-linux-x86_64.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9c-cxx-stl-libs-with-debugging-info.zip
|
||||
|
||||
============== r9d ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9d-windows-x86.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9d-windows-x86_64.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9d-darwin-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9d-darwin-x86_64.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9d-linux-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9d-linux-x86_64.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r9d-cxx-stl-libs-with-debug-info.zip
|
||||
|
||||
============== r10 ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk32-r10-windows-x86.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk32-r10-windows-x86_64.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk32-r10-darwin-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk32-r10-darwin-x86_64.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk32-r10-linux-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk32-r10-linux-x86_64.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk64-r10-windows-x86.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk64-r10-windows-x86_64.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk64-r10-darwin-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk64-r10-darwin-x86_64.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk64-r10-linux-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk64-r10-linux-x86_64.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r10-cxx-stl-libs-with-debug-info.zip
|
||||
|
||||
============== r10b ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk32-r10b-windows-x86.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk32-r10b-windows-x86_64.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk32-r10b-darwin-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk32-r10b-darwin-x86_64.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk32-r10b-linux-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk32-r10b-linux-x86_64.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk64-r10b-windows-x86.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk64-r10b-windows-x86_64.zip
|
||||
* http://dl.google.com/android/ndk/android-ndk64-r10b-darwin-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk64-r10b-darwin-x86_64.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk64-r10b-linux-x86.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk64-r10b-linux-x86_64.tar.bz2
|
||||
* http://dl.google.com/android/ndk/android-ndk-r10b-cxx-stl-libs-with-debug-info.zip
|
||||
|
||||
============== r10c ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-r10c-windows-x86.exe
|
||||
* http://dl.google.com/android/ndk/android-ndk-r10c-windows-x86_64.exe
|
||||
* http://dl.google.com/android/ndk/android-ndk-r10c-darwin-x86.bin
|
||||
* http://dl.google.com/android/ndk/android-ndk-r10c-darwin-x86_64.bin
|
||||
* http://dl.google.com/android/ndk/android-ndk-r10c-linux-x86.bin
|
||||
* http://dl.google.com/android/ndk/android-ndk-r10c-linux-x86_64.bin
|
||||
|
||||
============== r10d ==============
|
||||
|
||||
* http://dl.google.com/android/ndk/android-ndk-r10d-windows-x86.exe
|
||||
* http://dl.google.com/android/ndk/android-ndk-r10d-windows-x86_64.exe
|
||||
* http://dl.google.com/android/ndk/android-ndk-r10d-darwin-x86.bin
|
||||
* http://dl.google.com/android/ndk/android-ndk-r10d-darwin-x86_64.bin
|
||||
* http://dl.google.com/android/ndk/android-ndk-r10d-linux-x86.bin
|
||||
* http://dl.google.com/android/ndk/android-ndk-r10d-linux-x86_64.bin
|
Loading…
Reference in New Issue
Block a user