第一章：CMake入门——从零认识这个构建工具
大家好，我是你们这门课的老师。做了这么多年Android底层开发，我见过太多人在NDK集成上栽跟头。说实话，大部分问题都出在同一个地方——对CMake的理解不够深。今天我们就从最基础的东西聊起。
1.1 CMake是什么？
CMake，全称是Cross-platform Make。说白了，它是一个跨平台的构建系统生成器。你可能会问：什么叫"构建系统生成器"？
我举个例子。你在Windows上写代码，用Visual Studio；在Linux上，用Makefile；在macOS上，可能用Xcode。每个平台都有自己的构建方式。CMake的作用就是——你写一份CMakeLists.txt，它能帮你生成对应平台的构建文件。
嗯，这里要注意：CMake本身不编译代码。它只是生成Makefile或者Visual Studio工程文件，然后让真正的编译器去干活。
核心概念：CMake是一种元构建系统（Meta Build System）。它管理的是"如何构建"，而不是"构建本身"。
1.2 为什么选择CMake？
我在2015年第一次接触CMake。当时公司要做一个跨平台的音视频SDK，需要在Android、iOS、Windows、Linux上同时编译。用Makefile？写四套？那不得累死。
CMake的好处，我总结了几点：
- 跨平台：一份CMakeLists.txt，生成各平台构建文件
- 语法简洁：比手写Makefile容易太多
- 模块化：支持子目录、库依赖管理
- 社区活跃：遇到问题，StackOverflow上基本都有答案
- Android官方推荐：从Android Studio 2.2开始，Google就主推CMake了
你想想看，如果你还在用Android.mk写NDK构建，每次加个源文件都要改一堆东西。用CMake呢？一行add_library就搞定了。
我的建议：新项目直接用CMake。老项目如果还在用Android.mk，趁早迁移。我见过太多团队因为懒得改，最后维护成本越来越高。
1.3 CMake与Makefile的关系
很多人搞不清CMake和Makefile的区别。我打个比方：
- Makefile：是施工图纸，告诉工人（make命令）每一步做什么
- CMake：是设计师，根据你的需求画出施工图纸
CMake生成Makefile，然后make命令读取Makefile来编译代码。就这么简单。
我曾经遇到一个项目，团队直接手写了一个2000行的Makefile。后来要加一个新平台，改了一个星期还没改完。换成CMake后，两天就搞定了。这就是工具的力量。
| 对比项 | Makefile | CMake |
|---|---|---|
| 跨平台 | 需要手动适配 | 自动生成 |
| 语法复杂度 | 高（Tab缩进、变量展开） | 低（函数式调用） |
| 依赖管理 | 手动写规则 | 自动推导 |
| 调试难度 | 高（报错信息不友好） | 低（有详细的诊断输出） |
1.4 CMake在Android NDK中的角色
说到Android NDK，CMake的地位就更重要了。从Android Studio 2.2开始，Google就默认使用CMake来构建原生代码。为什么？
原因其实很简单：Android.mk的语法太老了，而且不支持条件编译、模块化这些现代构建需求。CMake正好补上了这个短板。
在Android NDK中，CMake主要负责：
- 管理C/C++源文件的编译
- 链接第三方静态库/动态库
- 处理ABI适配（armeabi-v7a、arm64-v8a等）
- 集成预编译库
- 控制编译优化选项
我记得有一次，一个同事在集成OpenCV时，因为ABI没配好，在64位手机上直接崩溃。用CMake的ANDROID_ABI变量，一行代码就解决了。
避坑指南：我曾经在项目中遇到CMake版本不兼容的问题。Android NDK r21要求CMake 3.10以上，但服务器上装的是3.6。编译出来的so文件在运行时各种诡异崩溃。后来统一了版本才解决。所以，一定要确保CMake版本和NDK版本匹配。
1.5 知识体系总览
下面这张图，是我根据多年经验总结的CMake在Android NDK中的知识体系。你可以把它当作整个课程的地图。
1.6 一个简单的例子
说了这么多理论，我们来看一个最基础的CMakeLists.txt长什么样：
# CMakeLists.txt - 最简单的NDK项目
cmake_minimum_required(VERSION 3.10)
# 项目名称
project(HelloNDK)
# 添加C++标准支持
set(CMAKE_CXX_STANDARD 11)
# 编译一个动态库
add_library(
hello-jni # 库名称
SHARED # 动态库
src/main/cpp/hello-jni.cpp # 源文件
)
# 链接NDK的log库
find_library(log-lib log)
target_link_libraries(hello-jni ${log-lib})
这段代码，说白了就做了三件事：
- 告诉CMake，我们要用C++11标准
- 把hello-jni.cpp编译成一个动态库
- 链接Android的log库，方便打印日志
我第一次写这个文件的时候，还担心会不会漏了什么。后来发现，CMake的语法比想象中直观得多。你只要记住：add_library是核心，target_link_libraries是必备，其他都是锦上添花。
小技巧：刚开始学CMake，不要追求一步到位。先写一个能编译通过的版本，然后慢慢加功能。我见过太多人一开始就想把所有东西都配好，结果编译报错都不知道从哪查起。
好了，第一章的内容就到这里。记住我们今天讲的核心：CMake是构建系统的生成器，它帮你管理编译过程，让你专注于写代码。后面的章节，我们会一步步深入，从变量、函数到高级特性，再到实战项目。
公众号：蓝海资料掘金营，微信deep3321