cmake使用教程(九)-关于安卓的交叉编译

来源:互联网 时间:2018-02-27

该文章未介绍如何编译,可以参考我的另一篇文章



shell脚本生成安卓全abi动态库与静态库


用cmake交叉编译相当简单,基本可以达到一次编写,每次都能运行的目的。


CMake使用toolchain来编译,链接library和创建archives,以及其他task来驱动构建。 可用的toolchain实用程序由启用的语言确定。 在正常版本中,CMake根据系统默认值自动确定主使用的toolchain。 在交叉编译场景中,可以使用关于编译器和实用程序路径的信息来指定toolchain文件。



假如我们已经编写好了自己的toolchain文件,那么在执行构建时添加参数-DCMAKE_TOOLCHAIN_FILE=path/to/file
即可,cmake系统会自动使用执行的toolchain.cmake文件。


安卓平台交叉编译有两种方式,一是使用ndk编译,另一种是使用自己的工具链编译,我感觉我只会ndk编译,另一中我就不介绍了,因为我不会。


这里介绍如何构建makefile和ninja两种方式的交叉编译。


变量说明

有几个特殊的变量需要设置:



CMAKE_SYSTEM_NAME



编译安卓平台时请设置这个变量为Android
。而且CMAKE_SYSTEM_VERSION
必须指定。



CMAKE_SYSTEM_VERSION


设置安卓的api level,假如未设置这个值,则会由以下两个方式决定:



CMAKE_ANDROID_API
设置了,则使用该api level
CMAKE_SYSROOT
设置了,则使用该api level
都没设置,则使用ndk中最新的api levele


CMAKE_ANDROID_ARCH_ABI



arm64-v8a armeabi-v7a armeabi-v6 armeabi mips mips64 x86 x86_64
。 这个牛逼了,设置abi架构,假如未设置,则使用默认的armeabi
。设置了这个变量系统会自动设置CMAKE_ANDROID_ARCH
,不必手动设置。



CMAKE_ANDROID_NDK


这个更牛逼了,使用它来设置ndk的路径,必须是绝对路径,到ndk的根目录即可。



CMAKE_ANDROID_NDK_DEPRECATED_HEADERS


设置为true,则会使用每个api level中已经废弃的头文件,而不会使用统一的头文件。默认为false,使用统一的头文件。



CMAKE_ANDROID_NDK_TOOLCHAIN_VERSION


设置NDK编译链的版本,假如不设置,则使用最新的。



CMAKE_ANDROID_STL_TYPE
这个牛逼了。有好几个值:



none
No C++ Support



system
Minimal C++ without STL



gabi++_static
GAbi++ Static



gabi++_shared
GAbi++ Shared



gnustl_static
GNU libstdc++ Static



gnustl_shared
GNU libstdc++ Shared



c++_static
LLVM libc++ Static



c++_shared
LLVM libc++ Shared



stlport_static
STLport Static



stlport_shared
STLport Shared


默认值是gnustl_static。



CMAKE_<LANG>_ANDROID_TOOLCHAIN_PREFIX


自动生成的,绝对路径的前缀。



CMAKE_<LANG>_ANDROID_TOOLCHAIN_SUFFIX
自动生成的,绝对路径的后缀。


构建顺序
假如设置了CMAKE_ANDROID_NDK
,就会使用该变量指定的NDK路径
假如设置了CMAKE_ANDROID_STANDALONE_TOOLCHAIN
,而1中的变量未设置,就会使用该独立的工具链编译。
假如设置了CMAKE_SYSROOT
,1、2未设置,并且路径形式是<ndk>/platforms/android-<api>/arch-<arch>
,则相当于设置了CMAKE_ANDROID_NDK
,并且会使用该路径的ndk。
假如设置了CMAKE_SYSROOT
,1、2、3未设置,并且路径形式是<standalone-toolchain>/sysroot
,则相当于设置了CMAKE_ANDROID_STANDALONE_TOOLCHAIN
并且使用该工具链编译。
假如设置了ANDROID_NDK
,1、2、3、4未设置,则相当于设置了1,并且使用该ndk。
假如设置了ANDROID_STANDALONE_TOOLCHAIN
,1、2、3、4、5未设置,则相当于设置了2,并且使用该工具链。
假如设置了环境变量ANDROID_NDK_ROOT
或者ANDROID_NDK
,1、2、3、4、5、6则相当于设置了1,并且使用NDK。
假如设置了ANDROID_STANDALONE_TOOLCHAIN
,1、2、3、4、5、6、7未设置,则相当于设置了2,并且使用该工具链。
全都没设置会报错。
编译方式

一般需要设置的如下:


set(CMAKE_SYSTEM_NAME Android)
set(CMAKE_SYSTEM_VERSION 21) # API level
set(CMAKE_ANDROID_ARCH_ABI arm64-v8a)
set(CMAKE_ANDROID_NDK /path/to/android-ndk)
set(CMAKE_ANDROID_STL_TYPE gnustl_static)

假如不想编写toolchain.cmake文件,也课可以在命令行直接输入参数来完成构建:


cmake ../src /
-DCMAKE_SYSTEM_NAME=Android /
-DCMAKE_SYSTEM_VERSION=21 /
-DCMAKE_ANDROID_ARCH_ABI=arm64-v8a /
-DCMAKE_ANDROID_NDK=/path/to/android-ndk /
-DCMAKE_ANDROID_STL_TYPE=gnustl_static

效果与上边是一样的。


相关阅读:
Top