Android.mk详解

#Android.mk详解

##一.Android.mk介绍

Android.mk是Android提供的一种makefile文件,用来指定诸如编译生成so库名、引用的头文件目录、需要编译的.c/.cpp文件和.a静态库文件等。
要掌握jni,就必须熟练掌握Android.mk的语法规范。

它的基本格式如下:

LOCAL_PATH := $(call my-dir)  
include $(CLEAR_VARS)  
................  
LOCAL_xxx       := xxx  
LOCAL_MODULE    := hello-jni  
LOCAL_SRC_FILES := hello-jni.c  
LOCAL_xxx       := xxx  
................  
include $(BUILD_SHARED_LIBRARY)  

LOCAL_PATH变量制定了该.mk的路径,$(call my-dir)调用NDK内部的函数获得当前.mk文件的路径

include $(CLEAR_VARS)清空了除了LOCAL_PATH之外的所有LOCAL_xxx变量的值

省略号中间就是对于模块参数的设置,主要包括:模块名字、模块源文件、模块类型、编译好的模块存放位置、以及编译的平台等

include $(BUILD_xxx_xxx)执行NDK的默认脚本,它会收集include $(CLEAR_VARS)脚本后所有定义的LOCAL_xxx变量,然后根据它们来生成模块。

总结一下Android.mk的写法:

LOCAL_PATH := $(call my-dir)       //固定写法,获取但却.mk文件的路径
include $(CLEAR_VARS)             //固定写法,清空了所有LOCAL_xxx变量的值(除了LOCAL_PATH之外)
LOCAL_xxx       := xxx            //定义属性1
LOCAL_xxx       := xxx            //定义属性2,各属性的定义次序部分先后
include $(BUILD_xxx)              //收集上面定义的属性,执行脚本

##二.Android.mk标签详解

###1.LOCAL_PATH := $(call my-dir)
这个是固定写法不需要修改,并且要放在文件第一行。并且只需要写一次,即使一个文件执行多个脚本命令。
每个Android.mk文件必须以定义LOCAL_PATH为开始。它用于在开发tree中查找源文件。
宏my-dir 则由Build System提供。返回包含Android.mk的目录路径。

###2.include $(CLEAR_VARS)
这个是固定写法不需要修改,写在LOCAL_PATH之后和定义LOCAL属性之前,
如果一个Android.mk文件要执行多个脚本命令,需要在每一个定义LOCAL属性之前加入这个命令。
CLEAR_VARS 变量由Build System提供。并指向一个指定的GNU Makefile,由它负责清理很多LOCAL_xxx.
例如:LOCAL_MODULE, LOCAL_SRC_FILES, LOCAL_STATIC_LIBRARIES等等。但不清理LOCAL_PATH.
这个清理动作是必须的,因为所有的编译控制文件由同一个GNU Make解析和执行,其变量是全局的。所以清理后才能避免相互影响。

###3.LOCAL_MODULE := xxx

LOCAL_MODULE模块必须定义,以表示Android.mk中的每一个模块。名字xxx必须唯一且不包含空格。
这个也是生成的so库的名字的定义。Build System会自动添加适当的前缀和后缀。
例如,模块名被定为foo,要产生动态库,则生成libfoo.so.
但请注意:如果模块名被定为:libfoo.则生成libfoo.so. 不再加前缀

###4.LOCAL_MODULE_PATH :=$(TARGET_XXX) 指定最后生成的模块的目标地址

这个属性不是非必需的,定义的属性值可以参考下面的:

####(1)TARGET_ROOT_OUT:根文件系统,路径为out/target/product/generic/root

####(2)TARGET_OUT:system文件系统,路径为out/target/product/generic/system

####(3)TARGET_OUT_DATA:data文件系统,路径为out/target/product/generic/data

默认是第二个TARGET_OUT

除了上面的这些,NDK还提供了很多其他的TARGET_XXX_XXX变量,用于将生成的模块拷贝到输出目录的不同路径

###5.LOCAL_SRC_FILES := xxx.cpp

LOCAL_SRC_FILES变量必须包含将要打包如模块的C/C++ 源码。
不必列出头文件,build System 会自动帮我们找出依赖文件。缺省的C++源码的扩展名为.cpp.
也可以修改,通过LOCAL_CPP_EXTENSION

如果有多个c或c++文件,用反斜杠\隔开即可,例如:

LOCAL_SRC_FILES := jni.cpp \
    utils.c \
    manager.c 

###6.include $(BUILD_SHARED_LIBRARY)
BUILD_SHARED_LIBRARY:是Build System提供的一个变量,指向一个GNU Makefile Script。
它负责收集自从上次调用 include $(CLEAR_VARS) 后的所有LOCAL_XXX信息。并执行编译。

主要的属性值:

BUILD_STATIC_LIBRARY   //编译为静态库。 
BUILD_SHARED_LIBRARY   //编译为动态库 
BUILD_EXECUTABLE       //编译为Native C可执行程序  
BUILD_PREBUILT         //该模块已经预先编译

NDK还定义了很多其他的BUILD_XXX_XXX变量,它们用来指定模块的生成方式。

##其他
本文只是对Android.mk进行了简单的介绍,真正的项目中mk文件有些是比较复杂的,
比如一个mk文件要编译生产多个so库,
mk文件中添加多个静态.a文件或so文件,一些复杂的情况要添加一些不同的属性,
并且系统源码中也是非常多mk文件的,源码中的mk属性有一些是和Studio中不相同的,
主要的做法无非是借鉴别人编译成功的示例代码。

在NDK7.0后可以使用Android.bp代替mk文件,里面的规则也是类似的,
但是文件里面的数据替换成json,key-value都是替换成简单的小写英文关键字

#共勉:别在该努力的年纪,徘徊不前。

  • 2
    点赞
  • 3
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
这些都是 Android NDK 内部的 `Android.mk` 文件。其中,`./android-ndk-r25c/sources/android/native_app_glue/Android.mk` 是用于编译 Native Activity 示例应用程序的 `Android.mk` 文件;`./android-ndk-r25c/sources/android/support/Android.mk` 是包含一些 Android 支持库的 `Android.mk` 文件;`./android-ndk-r25c/sources/android/ndk_helper/Android.mk` 是包含一些辅助函数和类的 `Android.mk` 文件;`./android-ndk-r25c/sources/android/cpufeatures/Android.mk` 是用于编译 `cpufeatures` 库的 `Android.mk` 文件,该库提供了一些 CPU 相关的信息和功能;`./android-ndk-r25c/sources/cxx-stl/llvm-libc++abi/Android.mk` 和 `./android-ndk-r25c/sources/cxx-stl/llvm-libc++/Android.mk` 是用于编译 C++ STL 库的 `Android.mk` 文件,分别对应 libc++abi 和 libc++ 两个 STL 库;`./android-ndk-r25c/sources/third_party/googletest/Android.mk` 是用于编译 Google Test 测试框架的 `Android.mk` 文件;`./android-ndk-r25c/sources/third_party/shaderc/Android.mk` 是用于编译 Shaderc 编译器的 `Android.mk` 文件,该编译器可以将 GLSL 代码编译成 SPIR-V 代码;`./android-ndk-r25c/sources/third_party/shaderc/libshaderc/Android.mk` 是用于编译 Shaderc 库的 `Android.mk` 文件;`./android-ndk-r25c/sources/third_party/shaderc/libshaderc_util/Android.mk` 是用于编译 Shaderc Util 库的 `Android.mk` 文件,该库提供了一些辅助函数和类;`./android-ndk-r25c/sources/third_party/shaderc/third_party/Android.mk` 是用于编译 Shaderc 编译器依赖的第三方库的 `Android.mk` 文件,包括 glslang 和 spirv-tools 两个库;`./android-ndk-r25c/sources/third_party/shaderc/third_party/glslang/Android.mk` 是用于编译 glslang 库的 `Android.mk` 文件;`./android-ndk-r25c/sources/third_party/shaderc/third_party/spirv-tools/Android.mk` 是用于编译 spirv-tools 库的 `Android.mk` 文件;`./android-ndk-r25c/sources/third_party/vulkan/src/build-android/jni/Android.mk` 是用于编译 Vulkan 库的 `Android.mk` 文件。 如果您要在 Android NDK 中编写自己的 `Android.mk` 文件,可以参考这些示例文件。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

峥嵘life

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值