news 2026/1/11 23:57:06

从零开始:在 Windows 上使用命令行编译 Android .so 动态库(NDK + CMake + Ninja)

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
从零开始:在 Windows 上使用命令行编译 Android .so 动态库(NDK + CMake + Ninja)

🛠️ 从零开始:在 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 工具链(进阶话题)。


版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/1/9 20:58:29

DDU清除残留驱动:游戏本显卡优化核心要点

DDU清除残留驱动&#xff1a;游戏本显卡优化实战全解析 你有没有遇到过这样的情况——刚更新完显卡驱动&#xff0c;结果《赛博朋克2077》一开光追就黑屏重启&#xff1f;或者设备管理器里突然冒出个“未知设备”&#xff0c;明明昨天还能满帧跑《艾尔登法环》&#xff1f; 别…

作者头像 李华
网站建设 2026/1/9 20:57:53

AI教师助手开发实录:个性化语音生成助力在线教育

AI教师助手开发实录&#xff1a;个性化语音生成助力在线教育 &#x1f3af; 背景与需求&#xff1a;让AI教师“声”动起来 随着在线教育的快速发展&#xff0c;传统录播课程和机械式TTS&#xff08;文本转语音&#xff09;系统已难以满足学习者对沉浸感、情感化、个性化教学体验…

作者头像 李华
网站建设 2026/1/9 20:57:35

波特率误差对UART通信的影响:系统学习与计算方法

波特率误差对UART通信的影响&#xff1a;从原理到实战的深度解析你有没有遇到过这样的情况&#xff1f;程序逻辑没问题&#xff0c;接线也正确&#xff0c;但串口就是时通时断&#xff0c;偶尔收到乱码&#xff0c;甚至完全无响应。排查半天最后发现——问题出在波特率上。别小…

作者头像 李华
网站建设 2026/1/9 20:57:27

基于AUTOSAR的NM唤醒机制:系统集成全面讲解

AUTOSAR网络唤醒机制深度解析&#xff1a;从报文到系统级集成 汽车电子系统的复杂度正在以惊人的速度攀升。如今一辆高端车型可能拥有超过100个ECU&#xff0c;遍布车身、动力、底盘和信息娱乐系统。在这样的分布式架构下&#xff0c;如何让这些节点既保持高效通信&#xff0c;…

作者头像 李华
网站建设 2026/1/9 20:57:20

USB3.1协议层流量控制对传输速度的影响研究

深入解析USB3.1协议层流量控制&#xff1a;为何你的10Gbps接口跑不满&#xff1f;你有没有遇到过这种情况&#xff1f;手里的外接NVMe固态硬盘标称支持USB3.1 Gen2&#xff0c;理论速度高达10Gbps&#xff08;约1.25GB/s&#xff09;&#xff0c;可实际拷贝大文件时&#xff0c…

作者头像 李华
网站建设 2026/1/11 0:20:49

知网AI率降不下去?这招改完稳稳降到个位数!

兄弟姐妹们&#xff0c;写论文那点事儿&#xff0c;最难的莫过于降AI率。你天天一段段改&#xff0c;改到头都大了&#xff0c;还降不下来&#xff1f;别傻了&#xff0c;告诉你个大坑&#xff1a;千万别一段一段改&#xff01;那样逻辑散了&#xff0c;AI根本看不懂&#xff0…

作者头像 李华