Android NDK 开发之 CMake 必知必会

最新推荐文章于 2024-04-28 17:32:52 发布

2401_84149557

最新推荐文章于 2024-04-28 17:32:52 发布

阅读量946

点赞数 11

分类专栏：程序员文章标签： android

本文链接：https://blog.csdn.net/2401_84149557/article/details/137533129

版权

程序员专栏收录该内容

284 篇文章 0 订阅

订阅专栏

本文介绍了CMake在AndroidStudio中的使用，包括如何通过CMakeLists.txt配置文件编译动态库和可执行文件，展示了基本操作步骤，如添加库、指定文件和版本，以及高级语法如变量管理、数学和字符串操作，以及平台相关常量的使用。

摘要由CSDN通过智能技术生成

这意味就不需要再编写 .mk 文件来编译 so 动态库了。

CMake 是一个跨平台构建系统，在 Android Studio 引入 CMake 之前，它就已经被广泛运用了。

Google 官方网站上有对 CMake 的使用示范，可以参考官方指南。

总结官网对 CMake 的使用，其实也就如下的步骤：

add_library 指定要编译的库，并将所有的 .c 或 .cpp 文件包含指定。
include_directories 将头文件添加到搜索路径中
set_target_properties 设置库的一些属性
target_link_libraries 将库与其他库相关联

如果你对上面的步骤还是不了解，那么接下来就更深入了解 CMake 相关内容吧~~~

CMake 的基本操作

以 Clion 作为工具来讲解 CMake 的基本使用。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

CMake 编译可执行文件

一个打印 hello world 的 cpp 文件，通过 CMake 将它编译成可执行文件。

在 cpp 的同一目录下创建 CMakeLists.txt 文件，内容如下：

指定 CMake 使用版本

cmake_minimum_required(VERSION 3.9)

工程名

project(HelloCMake)

编译可执行文件

add_executable(HelloCMake main.cpp )

其中，通过 cmake_minimum_required 方法指定 CMake 使用版本，通过 project 指定工程名。

而 add_executable 就是指定最后编译的可执行文件名称和需要编译的 cpp 文件，如果工程很大，有多个 cpp 文件，那么都要把它们添加进来。

定义了 CMake 文件之后，就可以开始编译构建了。

CMake 在构建工程时会生成许多临时文件，避免让这些临时文件污染代码，一般会把它们放到一个单独的目录中。

操作步骤如下：

mkdir build

调用 cmake 命令生成 makefile 文件

cmake …

编译

make

在 build 目录中可以找到最终生成的可执行文件。

这就是 CMake 的一个简单操作，将 cpp 编译成可执行文件，但在 Android 中，大多数场景都是把 cpp 编译成库文件。

CMake 编译静态库和动态库

同样还是一个 cpp 文件和一个 CMake 文件，cpp 文件内容为打印字符串的函数：

#include
void print() {
std::cout << “hello lib” << std::endl;
}

同时，CMake 文件也要做相应更改：

cmake_minimum_required(VERSION 3.12)

指定编译的库和文件，SHARED 编译动态库

add_library(share_lib SHARED lib.cpp)

STATIC 编译静态库

add_library(share_lib STATIC lib.cpp)

通过 add_library 指定要编译的库的名称，以及动态库还是静态库，还有要编译的文件。

最后同样地执行构建，在 build 目录下可以看到生成的库文件。

到这里，就基本可以使用 CMake 来构建 C/C++ 工程了。

CMake 基本语法

熟悉了上面的基本操作之后，就必然会遇到以下的问题了：

如果要参与编译的 C/C++ 文件很多，难道每个都要手动添加嘛？
可以把编译好的可执行文件或者库自动放到指定位置嘛?
可以把编译好的库指定版本号嘛？

带着这些问题，还是要继续深入学习 CMake 的相关语法，最好的学习材料就是官网文档了。

为了避免直接看官方文档时一头雾水，这里列举一些常用的语法命令。

注释与大小写

在前面就已经用到了 CMake 注释了，每一行的开头 # 代表注释。

另外，CMake 的所有语法指令是不区分大小写的。

变量定义与消息打印

通过 set 来定义变量：

变量名为 var，值为 hello

set(var hello)

当需要引用变量时，在变量名外面加上 ${} 符合来引用变量。

引用 var 变量

${var}

还可以通过 message 在命令行中输出打印内容。

set(var hello)
message(${var})

数学和字符串操作

数学操作

CMake 中通过 math 来实现数学操作。

math 使用，EXPR 为大小

math(EXPR )

math(EXPR var “1+1”)

输出结果为 2

message(${var})

math 支持 +, -, *, /, %, |, &, ^, ~, <<, >> 等操作，和 C 语言中大致相同。

字符串操作

CMake 通过 string 来实现字符串的操作，这波操作有很多，包括将字符串全部大写、全部小写、求字符串长度、查找与替换等操作。

具体查看官方文档。

set(var “this is string”)
set(sub “this”)
set(sub1 “that”)

字符串的查找，结果保存在 result 变量中

string(FIND ${var} ${sub1} result )

找到了输出 0 ，否则为 -1

message(${result})

将字符串全部大写

string(TOUPPER ${var} result) message($ {result})

求字符串的长度

string(LENGTH ${var} num) message($ {num})

另外，通过空白或者分隔符号可以表示字符串序列。

set(foo this is a list) // 实际内容为字符串序列
message(${foo})

当字符串中需要用到空白或者分隔符时，再用双括号""表示为同一个字符串内容。

set(foo “this is a list”) // 实际内容为一个字符串
message(${foo})

文件操作

CMake 中通过 file 来实现文件操作，包括文件读写、下载文件、文件重命名等。

具体查看官方文档

文件重命名

file(RENAME “test.txt” “new.txt”)

文件下载

把文件 URL 设定为变量

set(var “http://img.zcool.cn/community/0117e2571b8b246ac72538120dd8a4.jpg”)

使用 DOWNLOAD 下载

file(DOWNLOAD ${var} “/Users/glumes/CLionProjects/HelloCMake/image.jpg”)

在文件的操作中，还有两个很重要的指令 GLOB 和 GLOB_RECURSE 。

GLOB 的使用

file(GLOB ROOT_SOURCE *.cpp)

GLOB_RECURSE 的使用

file(GLOB_RECURSE CORE_SOURCE ./detail/*.cpp)

其中，GLOB 指令会将所有匹配 *.cpp 表达式的文件组成一个列表，并保存在 ROOT_SOURCE 变量中。

而 GLOB_RECURSE 指令和 GLOB 类似，但是它会遍历匹配目录的所有文件以及子目录下面的文件。

使用 GLOB 和 GLOB_RECURSE 有好处，就是当添加需要编译的文件时，不用再一个一个手动添加了，同一目录下的内容都被包含在对应变量中了，但也有弊端，就是新建了文件，但是 CMake 并没有改变，导致在编译时也会重新产生构建文件，要解决这个问题，就是动一动 CMake，让编译器检测到它有改变就好了。