📚 课程目录第2章 Android NDK简介

Android NDK简介：NDK的作用，版本选择

聊到交叉编译，就绕不开 Android NDK。很多新手会问：我用 Java 写 App 不就行了吗，为什么还要搞 NDK？嗯，这问题我刚开始也困惑过。说白了，NDK 就是让你在 Android 上跑 C/C++ 代码的那把钥匙。

Android 应用开发主要用 Java/Kotlin 写业务，但有些场景光靠 Java 搞不定。比如性能敏感的音视频编解码、游戏引擎、加密算法，或者你要复用现有的 C/C++ 库。我的第一份嵌入式工作就是给安防摄像头移植人脸识别算法，全靠 NDK 把 OpenCV 和深度学习模型穿起来。

NDK（Native Development Kit）提供了一套完整的工具链，包括编译器、链接器、头文件、库文件，以及构建脚本（ndk-build、CMake）。它让你写的 C/C++ 代码能编译成 ARM 机器码，然后通过 JNI 被 Java 调用。

  核心作用总结：
  把 C/C++ 源码编译成 ARM 原生库（.so 文件）
提供与 Android 系统版本匹配的 API 头文件
内含交叉编译工具链，无需手动搭建 GCC/Clang
支持多种 CPU 架构：ARM、ARM64、x86、x86_64

我见过不少团队硬用 Java 写图像处理，结果帧率上不去，内存还爆了。这时候 NDK 的优势就出来了：

但也别一上来就无脑用 NDK。普通 UI 交互、网络请求、数据库操作，用 Java/Kotlin 反而更灵活。记住：NDK 是锦上添花，不是雪中送炭。

NDK 版本那叫一个乱。从 r10 到 r27，名字改了好几轮。我个人习惯先确认两个指标：最低 API 级别和目标 ABI。

举个例子，如果你的 App 要支持 Android 4.4（API 19）以上，NDK r17 之前的版本可能更稳，因为 r17 开始默认用 Clang 抛弃了 GCC。但如果你只面向 Android 8.0 以上，直接用最新的 NDK r27 就行，它能帮你少踩几十个坑。

看这张表格你就明白了：

NDK 版本	默认编译器	最低 API 建议	备注
r16	GCC 4.9 + Clang	API 14+	最后支持 GCC 的版本
r17	Clang (GCC 移除)	API 16+	Clang 稳定，我开始改用
r21	Clang 8.0	API 21+	支持 `libc++_shared`
r23	Clang 12	API 23+	对 AArch64 优化明显
r27（最新）	Clang 17	API 24+	修复大量旧 bug，推荐

我的小技巧： 打开 Android Studio 的 SDK Manager，在 SDK Tools 里能看到 NDK 下拉列表。我通常会同时装两个版本：一个较新的（开发用），一个较旧的（兼容老项目）。

别翻来覆去纠结了。下面这张图是我自己总结的决策树，照着选基本不会翻车：

我踩过最痛的坑是 NDK 版本与编译器不兼容。那是 r16 升级到 r17 的时候，项目里用了不少 GCC 特有的内建函数（比如 __sync_*），r17 一键切 Clang 后直接编译不过。排查了一整天。

还有一次，我用 NDK r22 编译的库，放到 Android 4.4 设备上运行，一加载就崩溃。查 log 才发现新版 Clang 生成的代码调用了 libc 里才有的函数，老系统没有。教训就是：先确定最低 API 级别，再挑 NDK 版本。

⚠️ 注意：

不废话，直接给步骤：

打开 Android Studio → SDK Manager → SDK Tools → 勾选 NDK（旁边有个小下拉箭头，可以选具体版本）。
如果你的网络不好，去官网下载单独包：https://developer.android.com/ndk/downloads（注意别写进正文，仅为参考）
解压后用 ndk-build --version 或者 clang --target=aarch64-linux-android --print-sysroot 检查是否正常。

我个人习惯在项目根目录建一个 ndk 文件夹，把 NDK 放进去，然后用 ndk.dir 指定路径。这样每个项目可以绑定自己的 NDK 版本，不会互相污染。

小建议： 用 CMake 替代 ndk-build。虽然 ndk-build 也能用，但 CMake 现在才是官方推荐的构建系统，而且调试信息更完整。如果你刚接触 NDK，直接学 CMake 吧。