Android.mk
Android.mk是一个向Android NDK构建系统描述NDK项目的GUN makefile片段。主要用来编译生成以下几种:
- APK程序:一般的Android应用程序,系统级别的直接push即可
- JAVA库:JAVA类库,编译打包生成JAR文件。
- C\C++应用程序:可执行的C\C++应用程序。
- C\C++静态库:编译生成C\C++静态库
- C\C++共享库:编译生成共享库,并打包成.so文件
Android.mk基本格式
# 定义模块当前路径(必须定义在文件开头,只需定义一次)
# my-dir是编译系统提供的宏函数 返回mk当前路径
LOCAL_PATH := $(call my-dir)
# 清空当前环境变量(以LOCAL_开头除LOCAL_PATH外变量)
# CLEAR_VARS是 GUN Makefile提供的一段特定的Makefile片段
# 这样做因为编译系统在单次执行中会解析多个构建文件和模块定义,而LOCAL_开头的变量是全局变量,所以,描述每个模块前都会做此操作,避免冲突
include $(CLEAR_VARS)
# 当前模块名(这里会生成libhello-jni.so)
LOCAL_MODULE := hello-jni
# 当前模块包含的源代码文件(多个用“空格”隔开)
LOCAL_SRC_FILES := hello-jni.c
# 表示当前模块将被编译成一个共享库
include $(BUILD_SHARED_LIBRARY)
编译多个共享库
一个Android可能编译产生多个共享库模块。
会产生libmodule1.so和libmodule2.so两个动态库
LOCAL_PATH := $(call my-dir)
# 模块1
include $(CLEAR_VARS)
LOCAL_MODULE := module1
LOCAL_SRC_FILES := module1.c
include $(BUILD_SHARED_LIBRARY)
# 模2
include $(CLEAR_VARS)
LOCAL_MODULE := module2
LOCAL_SRC_FILES := module2.c
include $(BUILD_SHARED_LIBRARY)
编译静态库
虽然Android应用程序不能直接使用静态库,但可以使用静态库编译成动态库。比如讲三方代码添加到原生项目中时,可以不用直接将第三方源码包括在原生项目中,而是将三方源码编译成静态库,然后并入共享库。
LOCAL_PATH := $(call my-dir)
# 第三方AVI库
include $(CLEAR_VARS)
LOCAL_MODULE := avilib
LOCAL_SRC_FILES := avilib.c platform-posix.c
include $(BUILD_STATIC_LIBRARY)
# 原生模块
include $(CLEAR_VARS)
LOCAL_MODULE := module
LOCAL_SRC_FILES := module.c
# 将静态库模块名添加到LOCAL_STATIC_LIBRARIES变量
LOCAL_STATIC_LIBRARIES := avilib
include $(BUILD_SHARED_LIBRARY)
如果多个共享库都是用到了avi库,那么avi库就是通用模块,我们可以使用共享库共享通用模块
使用共享库共享通用模块
静态库可以保证源代码模块化,但是当静态库与共享库相连时,它就变成了共享库的一部分。在多个共享库的情况下,多个共享库与静态库连接时,需要将通用模块的多个副本与不同的共享库重复相连,这样就增加了APP的大小。这种情况下可将通用模块作为共享库。
LOCAL_PATH := $(call my-dir)
# 第三方AVI库
include $(CLEAR_VARS)
LOCAL_MODULE := avilib
LOCAL_SRC_FILES := avilib.c platform_posix.c
include $(BUILD_SHARED_LIBRARY)
# 原生模块1
include $(CLEAR_VARS)
LOCAL_MODULE := module1
LOCAL_SRC_FILES := module1.c
LOCAL_SHARED_LIBRARIES := avilib
include $(BUILD_SHARED_LIBRARY)
# 原生模块2
include $(CLEAR_VARS)
LOCAL_MODULE := module2
LOCAL_SRC_FILES := module2.c
LOCAL_SHARED_LIBRARIES := avilib
include $(BUILD_SHARED_LIBRARY)
以上所有的模块必须属于同一NDK项目,如果是多个NDK项目间如何处理呢?
在多个NDK项目间共享模块
从NDKr5开始允许多个NDK项目共享重用模块,使用 improt-module
- 将avilib源代码移动到NDK以外的位置,比如C:\android\shared-modules\transcode\avilib
- avilib创建自己的Android.mk文件
- import-module需要先定位共享模块,然后导入到NDK项目中,默认import-module只搜索NDK目录下sources目录。如果想要搜索到其他目录需要定义新环境变量NDK_MODULE_PATH并且设置成共享模块的根目录.
示例
# avilib模块自己的Android.mk文件
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := avilib
LOCAL_SRC_FILES := avilib.c platform_posix.c
include $(BUILD_SHARED_LIBRARY)
# 使用共享模块的NDK项目1的Android.mk文件
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := module1
LOCAL_SRC_FILES := module1.c
LOCAL_SHARED_LIBRARIES := avilib
include $(BUILD_SHARED_LIBRARY)
$(call import-module,transcode/avilib)
# 使用共享模块的NDK项目2的Android.mk文件
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := module2
LOCAL_SRC_FILES := module2.c
LOCAL_SHARED_LIBRARIES := avilib
include $(BUILD_SHARED_LIBRARY)
$(call import-module,transcode/avilib)
使用预编译库
当我们想在不发布源代码的情况下将模块发布给他人;想使用共享模块的预编译版来加速编译过程。这时候我们就可以使用预编译库
# 预编译共享模块的Android.mk文件
LOCAL_PATH := $(call my-dir)
# 第三方预编译的库
include $(CLEAR_VARS)
LOCAL_MODULE := avilib
LOCAL_SRC_FILES := libavilib.so
include $(PREBUILD_SHARED_LIBRARY)
编译独立的可执行文件
为了方便测试和进行加速开发,可以编译成可执行文件。不用打包成APK就可以复制到Android设备上执行
# 独立可执行模块的Android.mk文件
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := module
LOCAL_SRC_FILES := module.c
LOCAL_STATIC_LIBRARIES := avilib
include $(BUILD_EXECUTABLE)
注意事项
假如我们本地库 libhello-jni.so依赖于libTest.so(可以使用NDK下的ndk-depends查看so的依赖关系)
- Android6.0版本之前,需要在加载本地库前先加载被依赖的so。
- Android6.0版本之后,不能在使用预编译的动态库(静态库没问题)。
// Android 6.0版本之前 libhello-jni.so依赖于libTest.so 需要先加载libTest.so
System.loadLibrary("Test");
System.loadLibrary("hello-jni");
// Android 6.0版本之后
System.loadLibrary("hello-jni");