1. 环境准备与工具链配置
在Windows环境下编译Android原生库需要搭建完整的工具链。与常见的Android Studio集成开发环境不同,命令行方式可以更好地适应持续集成和自动化构建场景。
1.1 必备组件安装
首先需要确保系统中已安装以下核心组件:
-
Android SDK:包含NDK和CMake工具
- 推荐通过Android Studio安装后独立使用
- 默认安装路径:
C:\Users\<用户名>\AppData\Local\Android\Sdk - 验证安装:检查
platform-tools和ndk目录是否存在
-
Git for Windows:
- 提供Git Bash终端环境
- 包含必要的Unix工具链(如sh、rm等)
- 下载地址:git-scm.com
注意:建议将Android SDK路径添加到系统环境变量中,方便后续脚本调用。例如添加
ANDROID_SDK_ROOT=D:\AndroidSDK
1.2 版本兼容性检查
不同版本的NDK和CMake存在兼容性要求:
| 组件 | 最低版本 | 推荐版本 | 备注 |
|---|---|---|---|
| NDK | r21 | r25+ | 旧版本可能缺少关键工具链 |
| CMake | 3.18 | 3.22+ | 需匹配NDK内置的CMake版本 |
验证版本命令:
bash复制# 检查NDK版本
$NDK_PATH/ndk-build --version
# 检查CMake版本
$CMAKE_BIN --version
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 项目结构与构建系统配置
2.1 最小化Native项目结构
典型的命令行编译项目需要以下基础结构:
code复制/ndkTest
├── CMakeLists.txt # CMake构建脚本
├── build.sh # 构建入口脚本
├── native-lib.c # 原生代码实现
└── ninja-win/ # Ninja构建工具
└── n
