阅读 2585

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,1、2未设置,并且路径形式是<ndk>/platforms/android-<api>/arch-<arch>,则相当于设置了CMAKE_ANDROID_NDK,并且会使用该路径的ndk。
  4. 假如设置了CMAKE_SYSROOT,1、2、3未设置,并且路径形式是<standalone-toolchain>/sysroot,则相当于设置了CMAKE_ANDROID_STANDALONE_TOOLCHAIN并且使用该工具链编译。
  5. 假如设置了ANDROID_NDK,1、2、3、4未设置,则相当于设置了1,并且使用该ndk。
  6. 假如设置了ANDROID_STANDALONE_TOOLCHAIN,1、2、3、4、5未设置,则相当于设置了2,并且使用该工具链。
  7. 假如设置了环境变量ANDROID_NDK_ROOT或者ANDROID_NDK,1、2、3、4、5、6则相当于设置了1,并且使用NDK。
  8. 假如设置了ANDROID_STANDALONE_TOOLCHAIN,1、2、3、4、5、6、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
复制代码

效果与上边是一样的。

关注下面的标签,发现更多相似文章
评论