🛠️ 从零开始:在 Windows 上使用命令行编译 Android .so 动态库(NDK + CMake + Ninja)
无需 Android Studio 构建系统,纯命令行搞定 Native 库编译
本文将手把手教你如何在 Windows + Git Bash 环境下,仅用命令行工具,基于 Android NDK、CMake 和 Ninja,编译出适用于 Android 的 .so 动态库。整个过程不依赖 Android Studio 的构建流程,适合集成到 CI/CD 或自定义构建脚本中。
✅ 前提条件
你已安装:
· Android SDK(包含 NDK 和 CMake)
· Git for Windows(提供 Git Bash 环境)
💡 如果你通过 Android Studio 安装了 SDK,默认路径通常为:
C:\Users\<用户名>\AppData\Local\Android\Sdk本文假设你的路径为:D:\AndroidSDK
🔧 第一步:确认你的工具路径
根据你的环境,确认以下两个关键组件的位置:
组件 路径示例
NDK D:\AndroidSDK\ndk\26.3.11579264
CMake D:\AndroidSDK\cmake\3.22.1
⚠️ 注意:NDK 版本建议 ≥ r21,CMake ≥ 3.18(Android 官方推荐)
📦 第二步:下载 Ninja(构建工具)
Android NDK 推荐使用 Ninja 作为构建后端(比 Make 更快、更可靠)。
- 访问 https://github.com/ninja-build/ninja/releases
- 下载 ninja-win.zip
- 解压得到 ninja.exe
- 将其放在项目目录下,例如:
D:\ndkTest\ninja-win\ninja.exe✅ Ninja 是单文件可执行程序,无需安装,无依赖。
📄 第三步:创建最小项目源码
在项目目录 D:\ndkTest 中创建两个文件:
- native-lib.c
#include<jni.h>JNIEXPORT jstring JNICALLJava_com_example_myapp_MainActivity_stringFromJNI(JNIEnv*env,jobject thiz){return(*env)->NewStringUTF(env,"Hello from C!");}- CMakeLists.txt
cmake_minimum_required(VERSION 3.18.1) project("native-lib") add_library(native-lib SHARED native-lib.c) find_library(log-lib log) target_link_libraries(native-lib ${log-lib})🖥️ 第四步:编写构建脚本 build.sh
在 D:\ndkTest 下创建 build.sh(使用 Git Bash):
#!/bin/bash# === 配置路径 ===NDK_PATH="/d/AndroidSDK/ndk/26.3.11579264"CMAKE_BIN="/d/AndroidSDK/cmake/3.22.1/bin/cmake"NINJA_BIN="/d/ndkTest/ninja-win/ninja.exe"# === 构建参数 ===ABI="arm64-v8a"# 可选: armeabi-v7a, x86, x86_64API_LEVEL=21BUILD_DIR="build"OUTPUT_DIR="libs"# === 检查工具 ===[-f"$CMAKE_BIN"]||{echo"❌ CMake not found";exit1;}[-f"$NINJA_BIN"]||{echo"❌ Ninja not found";exit1;}# === 清理并配置 ===rm-rf"$BUILD_DIR""$CMAKE_BIN"\-G"Ninja"\-DCMAKE_MAKE_PROGRAM="$NINJA_BIN"\-DCMAKE_TOOLCHAIN_FILE="$NDK_PATH/build/cmake/android.toolchain.cmake"\-DANDROID_ABI="$ABI"\-DANDROID_PLATFORM="android-$API_LEVEL"\-DCMAKE_BUILD_TYPE=Release\-B"$BUILD_DIR"\-S.# === 编译与输出 ===cd"$BUILD_DIR""$CMAKE_BIN"--build.--parallelcd..mkdir-p"$OUTPUT_DIR/$ABI"cp"$BUILD_DIR/libnative-lib.so""$OUTPUT_DIR/$ABI/"echo"✅ 输出:$OUTPUT_DIR/$ABI/libnative-lib.so"▶ 第五步:运行构建
在 Git Bash 中执行:
cd/d/ndkTestchmod+x build.sh# 赋予执行权限(可选)./build.sh成功后,你会在以下路径看到生成的动态库:
libs/arm64-v8a/libnative-lib.so🔍 验证结果
- 检查架构
filelibs/arm64-v8a/libnative-lib.so# 应显示: ELF 64-bit LSB shared object, ARM aarch64- 查看符号(可选)
/d/AndroidSDK/ndk/26.3.11579264/toolchains/llvm/prebuilt/windows-x86_64/bin/aarch64-linux-android-readelf-Wslibs/arm64-v8a/libnative-lib.so🌟 优势总结
✅ 完全脱离 Android Studio 构建系统
✅ 支持多 ABI 快速切换
✅ 构建速度快(Ninja)
✅ 可集成到自动化脚本或 CI 流程
📌 常见问题
Q:为什么不用 make?
A:Git Bash 的 make 在某些精简版中缺失,而 Ninja 单文件、无依赖、官方推荐。
Q:如何支持 C++?
A:将源文件改为 .cpp,CMake 中会自动识别;如需手动指定,用 add_library(… your.cpp) 即可。
Q:如何打包成 AAR?
A:可配合 jar 命令将 jniLibs 打包,或使用 android.jar 工具链(进阶话题)。