news 2026/4/16 12:28:37

从零开始:在 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/4/16 4:47:39

Sambert-HifiGan中文语音合成的7种情感效果对比评测

Sambert-HifiGan中文语音合成的7种情感效果对比评测 引言&#xff1a;中文多情感语音合成的技术演进与选型背景 随着智能客服、虚拟主播、有声阅读等应用场景的不断拓展&#xff0c;传统“机械式”语音合成已无法满足用户对自然度和情感表达的需求。多情感语音合成&#xff08;…

作者头像 李华
网站建设 2026/4/1 7:25:26

开源社区贡献指南:如何为Sambert-Hifigan提交PR修复bug

开源社区贡献指南&#xff1a;如何为Sambert-Hifigan提交PR修复bug &#x1f3af; 为什么参与开源&#xff1f;从一次依赖冲突修复说起 在语音合成领域&#xff0c;ModelScope 的 Sambert-HifiGan 模型因其高质量的中文多情感语音生成能力&#xff0c;已成为许多开发者构建TT…

作者头像 李华
网站建设 2026/4/16 12:23:28

完整示例:用 CSS vh 创建响应式图文卡片

用 CSSvh打造真正自适应的图文卡片&#xff1a;一次讲透原理与实战你有没有遇到过这样的问题&#xff1f;在电脑上看得好好的图文卡片&#xff0c;到了手机上却变得又矮又挤&#xff0c;文字溢出、图片变形&#xff0c;甚至部分内容直接被裁掉看不见。更糟的是&#xff0c;为了…

作者头像 李华
网站建设 2026/4/16 12:28:23

论文写作AI工具大盘点:8个平台深度测评,智能降重与自动改写全解析

当前AI论文辅助工具市场竞争激烈&#xff0c;各平台在降重优化、AIGC检测规避及学术写作功能上各具特色。经实测验证&#xff0c;主流工具在文本重构精度、语法规范性及操作界面友好度方面表现差异显著&#xff0c;其中基于Transformer架构的智能改写系统在学术术语适配性和逻辑…

作者头像 李华
网站建设 2026/4/11 4:28:25

游戏NPC语音生成:Sambert-Hifigan支持多情绪对白自动合成

游戏NPC语音生成&#xff1a;Sambert-Hifigan支持多情绪对白自动合成 引言&#xff1a;让游戏角色“声”动起来——中文多情感语音合成的突破 在现代游戏开发中&#xff0c;NPC&#xff08;非玩家角色&#xff09;不仅是剧情推进的关键载体&#xff0c;更是营造沉浸式体验的重要…

作者头像 李华
网站建设 2026/4/16 11:26:52

Kubernetes集群部署:大规模并发生成场景应对策略

Kubernetes集群部署&#xff1a;大规模并发生成场景应对策略 背景与挑战&#xff1a;AI视频生成服务的高并发需求 随着AIGC技术的快速发展&#xff0c;图像转视频&#xff08;Image-to-Video&#xff09;类应用正从实验性工具演变为可落地的内容生产引擎。以I2VGen-XL模型驱动的…

作者头像 李华