广安市网站建设_网站建设公司_Sketch_seo优化
2026/1/9 21:01:40 网站建设 项目流程

🛠️ 从零开始:在 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 更快、更可靠)。

  1. 访问 https://github.com/ninja-build/ninja/releases
  2. 下载 ninja-win.zip
  3. 解压得到 ninja.exe
  4. 将其放在项目目录下,例如:
D:\ndkTest\ninja-win\ninja.exe

✅ Ninja 是单文件可执行程序,无需安装,无依赖。


📄 第三步:创建最小项目源码

在项目目录 D:\ndkTest 中创建两个文件:

  1. 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!");}
  1. 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

🔍 验证结果

  1. 检查架构
filelibs/arm64-v8a/libnative-lib.so# 应显示: ELF 64-bit LSB shared object, ARM aarch64
  1. 查看符号(可选)
/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 工具链(进阶话题)。


需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询