1. 课程导入与生产环境认知
在 Android 应用开发中，Java/Kotlin 层负责业务逻辑与 UI，而 NDK（Native Development Kit）与 JNI（Java Native Interface）则承担着另一条关键路径：让 Java/Kotlin 代码与 C/C++ 代码互相调用，并最终把本地代码编译成各 ABI 对应的 .so 动态库，随 APK 或 AAB 一起分发到设备上运行。很多团队第一次接触 NDK，是因为接入了第三方 SDK（如音视频编解码、图像处理、加密库、AI 推理引擎），但真正把它用稳，需要理解它在整个工程中的位置，以及它在生产环境中会带来哪些新的稳定性问题。
一、NDK 与 JNI 在工程中的定位
可以把一个典型 Android 工程分成三层来看：最上层是 Java/Kotlin 应用层，中间是 JNI 桥接层，最下层是 Native 层（C/C++ 代码与预编译库）。JNI 并不是一门语言，而是一套规范：它规定了 Java 方法如何映射到本地函数、数据类型如何转换、对象引用如何管理、异常如何跨边界传递。NDK 则是工具集合，提供交叉编译器（Clang）、CMake/ndk-build 构建系统、平台头文件与系统库、以及 adb、ndk-stack、llvm-symbolizer 等调试工具。
需要特别区分两个容易混淆的概念：JNI 是运行时接口，决定 Java 与 C/C++ 如何互相调用；NDK 是构建与工具链，决定本地代码如何被编译、链接、打包和调试。二者配合，才构成完整的 Native 开发链路。
二、典型生产场景
NDK/JNI 在生产环境中并非“为了性能而用”，更多时候是被具体需求驱动的。以下场景在真实项目中最为常见：
- 音视频处理：使用 FFmpeg、libyuv、OpenSL ES / AAudio 进行编解码、滤镜、混音，Java 层只负责控制与状态回调。
- 图像与视觉：OpenCV、GPU 加速（Vulkan / OpenGL ES）图像管线，通常以 C++ 实现核心算法。
- 安全与加密：把密钥、签名校验、防篡改逻辑下沉到 Native 层，提高逆向门槛。
- AI 推理：TensorFlow Lite、NCNN、MNN 等推理引擎以 .so 形式集成，Java 层负责输入输出封装。
- 复用已有 C/C++ 资产：跨平台库、历史遗留代码、硬件厂商 SDK，通过 JNI 接入 Android 工程。
这些场景的共同点是：核心计算或关键逻辑在 Native 层完成，Java 层通过 JNI 调用并接收结果。一旦 Native 层崩溃，整个进程会直接终止，不会像 Java 异常那样被 try-catch 捕获，也不会留下 Java 堆栈。这正是 Native 稳定性问题的核心特征。
三、稳定性挑战
Native 层的稳定性问题与 Java 层有本质区别，主要体现在以下几个方面：
| 问题类型 | 典型表现 | 排查难点 |
|---|---|---|
| 内存越界 / 野指针 | SIGSEGV、SIGABRT，随机崩溃 | 崩溃地址无符号，需符号表还原 |
| JNI 引用泄漏 | 局部引用表溢出，JNI ERROR | 需检查循环中是否 DeleteLocalRef |
| 线程未附着 | 调用 JNI 时崩溃或行为异常 | Native 线程需 AttachCurrentThread |
| ABI 不匹配 | UnsatisfiedLinkError | 需核对 APK 内各 ABI 的 .so 完整性 |
| 符号被裁剪 | 运行时找不到方法 | 需检查 keep 规则与导出符号 |
生产环境中，Native 崩溃往往表现为 SIGSEGV(SEGV_MAPERR) 或 SIGABRT，堆栈中只有地址和 libxxx.so 偏移，没有可读函数名。要定位问题，必须保留带符号的 .so，并用 ndk-stack 或 llvm-symbolizer 还原。此外，不同 Android 版本、不同厂商 ROM 对 Native 行为也有差异，例如 Android 10 之后对非 SDK 接口的限制、Android 14 对 16KB 页大小的要求，都会影响 .so 的兼容性。
四、课程实战目标
本课程围绕“能写、能调、能稳”三个层次展开，最终目标是让读者具备独立完成 NDK/JNI 模块开发与稳定性治理的能力。具体包括：
- 理解 JNI 规范与 NDK 工具链，能独立搭建 CMake 构建的 Native 模块。
- 掌握 Java 与 C/C++ 双向调用的正确写法，包括类型签名、引用管理、异常处理与线程附着。
- 能够使用 ndk-stack、llvm-symbolizer、AddressSanitizer 等工具定位 Native 崩溃与内存问题。
- 掌握 ABI 裁剪、符号保留、包体积优化与 16KB 页对齐等生产级配置。
- 建立 Native 稳定性监控与线上崩溃归因的基本方法，形成可复用的排查流程。
接下来的章节会从 JNI 基础规范开始，逐步深入到构建配置、内存管理、崩溃分析、性能优化与线上治理。每一节都会围绕真实工程中的对象、参数与判断依据展开，帮助读者把知识转化为可落地的实践能力。