一、什么是CMake
或许听过好几种 Make 工具,如 GNU Make ,qmake,MS nmake等。这些 Make 工具遵循着不同的规范和标准,所执行的 Makefile 格式也千差万别。如果软件想跨平台,必须要保证能够在不同平台编译。而如果使用上面的 Make 工具,就得为每一种标准写一次 Makefile 。
CMake就是针对上面问题所设计的工具,它让开发者编写一种平台无关的 CMakeList.txt 文件来定制整个编译流程,然后再根据目标用户的平台进一步生成所需的本地化 Makefile 和工程文件。
二、CMakeList.txt文件
如上所述,这个文件是用来定制编译流程的。里面包含的是一些命令。
CMakeLists.txt 的语法比较简单,由命令、注释和空格组成,其中命令是不区分大小写的。符号 # 后面的内容被认为是注释。命令由命令名称、小括号和参数组成,参数之间使用空格进行间隔。
如下是AndroidStuido新建项目,默认生成的CMakeList.txt。这里改了些注释
# Sets the minimum version of CMake required to build the native
# library. You should either keep the default value or only pass a
# value of 3.4.0 or lower.
#最低版本要求
cmake_minimum_required(VERSION 3.4.1)
#添加库或者源文件,参数1.生成库的名字 2.生成库的类型 3.源文件所在路径
add_library(native-lib SHARED src/main/cpp/native-lib.cpp )
#查找NDK提供的库,这里是查找用于打印日志的log库,参数1.给查找库的别名 2.查找库的名称
find_library(log-lib log )
#将预构建的库和自己的原生库关联 参数1.原生库的名称 2.预构建库的别名
target_link_libraries(native-lib ${log-lib} )
更加关于AS下的CMakeList.text内容在Android的官方文档里
三、在build.gradle里对CMake的一些必要配置
externalNativeBuild {
cmake {
path "CMakeLists.txt"//指定CMakeLists.txt的路径
}
}
四、在build.gradle里对CMake的一些可选配置
android {
...
defaultConfig {
...
// This block is different from the one you use to link Gradle
// to your CMake or ndk-build script.
externalNativeBuild {
// For ndk-build, instead use ndkBuild {}
cmake {
// Passes optional arguments to CMake.
arguments "-DCMAKE_VERBOSE_MAKEFILE=TRUE"
// Sets optional flags for the C compiler.
cFlags "-D_EXAMPLE_C_FLAG1", "-D_EXAMPLE_C_FLAG2"
// Sets a flag to enable format macro constants for the C++ compiler.
cppFlags "-D__STDC_FORMAT_MACROS"
}
}
ndk {
// Specifies the ABI configurations of your native
// libraries Gradle should build and package with your APK.
abiFilters 'x86', 'x86_64', 'armeabi', 'armeabi-v7a', 'arm64-v8a'
}
buildTypes {...}
productFlavors {
...
demo {
...
externalNativeBuild {
cmake {
...
// Specifies which native libraries to build and package for this
// product flavor. If you don't configure this property, Gradle
// builds and packages all shared object libraries that you define
// in your CMake or ndk-build project.
targets "native-lib-demo"
}
}
}
paid {
...
externalNativeBuild {
cmake {
...
targets "native-lib-paid"
}
}
}
}
// You use this block to link Gradle to your CMake or ndk-build script.
externalNativeBuild {
cmake {...}
// or ndkBuild {...}
}
}