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

【cmake系列使用教程】

cmake使用教程（一）-起步

cmake使用教程（二）-添加库

cmake使用教程（三）-安装、测试、系统自检

cmake使用教程（四）-文件生成器

cmake使用教程（五）-cpack生成安装包

cmake使用教程（六）-蛋疼的语法

cmake使用教程（七）-流程和循环

cmake使用教程（八）-macro和function

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

cmake使用教程（十）-关于file

这个系列的文章翻译自官方cmake教程：cmake tutorial。

示例程序地址：github.com/rangaofei/t…

不会仅仅停留在官方教程。本人做为一个安卓开发者，实在是没有linux c程序开发经验，望大佬们海涵。教程是在macos下完成，大部分linux我也测试过，有特殊说明的我会标注出来。本教程基于cmake-3.10.2，同时认为你已经安装好cmake。

简介

该文章未介绍如何编译，能够参考个人另外一篇文章

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两种方式的交叉编译。

变量说明

有几个特殊的变量须要设置：

1. CMAKE_SYSTEM_NAME

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

2. CMAKE_SYSTEM_VERSION

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

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

3. CMAKE_ANDROID_ARCH_ABI

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

4. CMAKE_ANDROID_NDK

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

5. CMAKE_ANDROID_NDK_DEPRECATED_HEADERS

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

6. CMAKE_ANDROID_NDK_TOOLCHAIN_VERSION

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

7. 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。

8. CMAKE_<LANG>_ANDROID_TOOLCHAIN_PREFIX

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

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

构建顺序

1. 假如设置了CMAKE_ANDROID_NDK，就会使用该变量指定的NDK路径
2. 假如设置了CMAKE_ANDROID_STANDALONE_TOOLCHAIN，而1中的变量未设置，就会使用该独立的工具链编译。
3. 假如设置了CMAKE_SYSROOT,一、2未设置，而且路径形式是<ndk>/platforms/android-<api>/arch-<arch>,则至关于设置了CMAKE_ANDROID_NDK，而且会使用该路径的ndk。
4. 假如设置了CMAKE_SYSROOT，一、二、3未设置，而且路径形式是<standalone-toolchain>/sysroot，则至关于设置了CMAKE_ANDROID_STANDALONE_TOOLCHAIN而且使用该工具链编译。
5. 假如设置了ANDROID_NDK，一、二、三、4未设置，则至关于设置了1，而且使用该ndk。
6. 假如设置了ANDROID_STANDALONE_TOOLCHAIN,一、二、三、四、5未设置，则至关于设置了2，而且使用该工具链。
7. 假如设置了环境变量ANDROID_NDK_ROOT或者ANDROID_NDK，一、二、三、四、五、6则至关于设置了1，而且使用NDK。
8. 假如设置了ANDROID_STANDALONE_TOOLCHAIN，一、二、三、四、五、六、7未设置，则至关于设置了2，而且使用该工具链。
9. 全都没设置会报错。

编译方式

通常须要设置的以下：

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
复制代码

效果与上边是同样的。