Android NDK开发详解之ndk-build 脚本

Android NDK开发详解之ndk-build 脚本

ndk-build 脚本使用 NDK 的基于 Make 的构建系统构建项目。我们针对 ndk-build 使用的 Android.mkApplication.mk 配置提供了更具体的文档。

内部原理

运行 ndk-build 脚本相当于运行以下命令:

复制代码
$GNUMAKE -f <ndk>/build/core/build-local.mk
<parameters>

$GNUMAKE 指向 GNU Make 3.81 或更高版本, 则指向 NDK 安装目录。您可以根据这些信息从其他 Shell 脚本(甚至是您自己的 Make 文件)中调用 ndk-build。

从命令行调用

ndk-build 脚本位于 NDK 安装目录顶层。如需从命令行运行该脚本,请在应用项目目录或其子目录中进行调用。例如:

复制代码
$ cd <project>
$ <ndk>/ndk-build

在此示例中, 指向项目的根目录, 则是您安装 NDK 的目录。

选项

ndk-build 的所有参数都将直接传递到运行 NDK 构建脚本的底层 GNU make 命令。请将 ndk-build 和表单 ndk-build 中的选项结合使用。例如:

复制代码
$ ndk-build clean

您可以使用以下选项:

复制代码
clean
    移除之前生成的所有二进制文件。

    注意:在 Mac OS X 上,运行 ndk-build clean 时若有大量并行执行,可能会导致出现包含以下消息的构建错误:

    rm: fts_read: No such file or directory

    为了避免出现此问题,请考虑不使用 -jN 修饰符,或为 N 选择较小的值(例如 2)。
V=1
    启动构建,并显示构建命令。 
-B
    强制执行完整的重新构建。 
-B V=1
    强制执行完整的重新构建,并显示构建命令。 
NDK_LOG=1
    显示内部 NDK 日志消息(用于调试 NDK 本身)。 
NDK_DEBUG=1
    强制执行可调试 build(详见表 1)。 
NDK_DEBUG=0
    强制执行发布 build(详见表 1)。 
NDK_HOST_32BIT=1
    始终使用 32 位模式下的工具链。 
NDK_APPLICATION_MK=<file>
    使用 NDK_APPLICATION_MK 变量指向的特定 Application.mk 文件进行构建。 
-C <project>
    构建位于 <project> 的项目路径的原生代码。如果您不想在终端通过 cd 切换到该路径,此选项会非常有用。 

可调试 build 与发布 build

使用 NDK_DEBUG 选项(在特定情况下结合 AndroidManifest.xml)指定调试 build 或发布 build、与优化相关的行为以及是否包含符号。表 1 显示了每个可能的设置组合的结果。

注意:"NDK_DEBUG=0"相当于"APP_OPTIM=release",并用"-O2"编译。"NDK_DEBUG=1"相当于"Application.mk"中的"APP_OPTIM=debug",并用"-O0"编译。如需详细了解"APP_OPTIM",请参阅 Application.mk

例如,命令行上的语法如下:

复制代码
$ ndk-build NDK_DEBUG=1

要求

一般来说,您需要使用 GNU Make 4 才能使用 ndk-build 或 NDK。NDK 包含其自己的 GNU Make 副本,除非您将 $GNUMAKE 环境变量设置为指向不适当的 Make,否则 NDK 将使用该副本。

JSON 编译数据库

在 NDK r18 及更高版本中,ndk-build 可以生成 JSON 编译数据库。

您可以使用 ndk-build compile_commands.json 生成数据库而不构建代码,也可以使用 ndk-build GEN_COMPILE_COMMANDS_DB=true 来构建代码,同时生成数据库。

相关推荐
endcy20164 分钟前
mybatis-plus多租户兼容多字段租户标识
java·mybatis-plus·多租户
小伟童鞋4 分钟前
c++中导出函数调用约定为__stdcall类型函数并指定导出函数名称
开发语言·c++
维C泡泡4 分钟前
C++初认、命名规则、输入输出、函数重载、引用+coust引用
开发语言·c++
青草地溪水旁24 分钟前
设计模式(C++)详解——建造者模式(2)
c++·设计模式·建造者模式
李游Leo1 小时前
Redis 持久化与高可用实践(RDB / AOF / Sentinel / Cluster 全解析)
java·spring·bootstrap
_OP_CHEN1 小时前
数据结构(C语言篇):(十三)堆的应用
c语言·数据结构·二叉树·学习笔记·堆排序··top-k问题
郝学胜-神的一滴1 小时前
深入探索 C++ 元组:从基础到高级应用
开发语言·c++·stl·软件工程
mask哥1 小时前
详解mcp以及agen架构设计与实现
java·微服务·flink·大模型·ai agent·springai·mcp
Propeller1 小时前
【Android】View 交互的事件处理机制
android·java
吴Wu涛涛涛涛涛Tao1 小时前
Flutter 实现「可拖拽评论面板 + 回复输入框 + @高亮」的完整方案
android·flutter·ios