NDK 的核心目的之一是让您将 C 和 C++ 源代码构建为可用于应用的共享库。
1.Android.mk简介
1).Android.mk
在NDK项目中的位置:
Android.mk
文件位于项目 jni/
目录的子目录中,如下图:
2).Android.mk文件的作用:
用于向构建系统描述源文件和共享库:
- 定义 Application.mk;
- 构建系统和环境变量所未定义的项目范围设置;
- 替换特定模块的项目范围设置。
2.Android.mk基础知识:
- Android.mk 文件必须首先定义 LOCAL_PATH 变量:
# 源文件在开发树中的位置 # 在这里,构建系统提供的宏函数 my-dir 将返回当前目录(包含 Android.mk 文件本身的目录)的路径 LOCAL_PATH := $(call my-dir)
- 接着声明
CLEAR_VARS
变量:# CLEAR_VARS 变量指向特殊 GNU Makefile,可为您清除许多 LOCAL_XXX 变量 # 注意,它不会清除 LOCAL_PATH,此变量必须保留其值,因为系统在单一 GNU Make 执行环境(其中所有变量都是全局的)中解析所有构建控制文件。 在描述每个模块之前,必须声明(重新声明)此变量 include $(CLEAR_VARS)
LOCAL_MODULE
变量将存储您要构建的模块的名称:# XXX代表你想要生成的动态库文件的名字 # 在生成过程中系统会自动在xxx前面加上lib,形成libXXX.so的形式 # 应用的每个模块都应该使用一个该变量 LOCAL_MODULE := XXX
- 枚举源文件,以空格分隔多个文件:
# 变量必须包含要构建到模块中的 C 和/或 C++ 源文件列表 LOCAL_SRC_FILES := hello-jni.c
- 连接系统所有内容:
# BUILD_SHARED_LIBRARY 变量指向GNU Makefile脚本,用于收集您自最近 include 后在 LOCAL_XXX 变量中定义的所有信息 # GNU Makefile脚本确定要构建的内容及其操作方法 include $(BUILD_SHARED_LIBRARY)
- 可以定义自己的任意变量,定义变量时请注意,NDK 构建系统会预留以下变量名称:
- 以 LOCAL_ 开头的名称,例如 LOCAL_MODULE;
- 以 PRIVATE_、NDK_ 或 APP 开头的名称。构建系统在内部使用这些变量;
- 小写名称,例如 my-dir,构建系统也是在内部使用这些变量;
- 如果为了方便而需要在 Android.mk 文件中定义自己的变量,建议在名称前附加 MY_;
- NDK定义的变量及函数宏详解。
- 一个简单的Android.mk文件:
LOCAL_PATH := $(call my-dir) include $(CLEAR_VARS) LOCAL_MODULE := XXX LOCAL_SRC_FILES := Java_xxx_..._XXX.c include $(BUILD_SHARED_LIBRARY)
3.Application.mk简介
此文件用于描述应用需要的原生模块;
模块可以是静态库、共享库或可执行文件。
关于该文件,这里着重介绍一下APP_ABI变量,其它变量详情请移步至Application.mk:
- 默认情况下,NDK 构建系统为 armeabi ABI 生成机器代码;
- 此机器代码对应于基于 ARMv5TE、采用软件浮点运算的 CPU;
- 使用该变量可以选择不同的ABI
APP_ABI
不同指令集的设置见下表:- 注:
all
从 NDKr7 开始可用。指令集 值 基于 ARMv7 的设备上的硬件 FPU 指令 APP_ABI := armeabi-v7a ARMv8 AArch64 APP_ABI := arm64-v8a IA-32 APP_ABI := x86 Intel64 APP_ABI := x86_64 MIPS32 APP_ABI := mips MIPS64 (r6) APP_ABI := mips64 所有支持的指令集 APP_ABI := all