Android.mk 是一个向Android NDK构建系统描述NDK项目的GNUmakefile片段。主要是用来编译生成以下几种:
APK程序:一般的Android应用程序,系统级别的直接push即可
JAVA库:JAVA类库,编译打包生成JAR文件。
C\C++应用程序:可执行的C\C++应用程序。
C\C++静态库:编译生成C\C++静态库,并打包成 .a 文件。
C\C++共享库:编译生成共享库,并打包成.so 文件。
Android.mk基本格式
# 定义模块当前路径(必须定义在文件头,只需定义一次),定位源文件
LOCAL_PATH := $(call my - dir)
# 清除当前环境变量 (清除 LOCAL_PATH 以外的 LOCAL_ 开头的环境变量),避免冲突
include $(CLEAR_VEARS)
# 当前模块名, 需要唯一,并且不能包含空格 (这里会生成 libhello-jni.so)
LOCAL_MODULE := hello-jni
# 当前模块包含的源文件
LOCAL_SRC_FILES := hell-jni.c
# 表示当前模块将被编译成一个共享库
include $(BUILD_SHARED_LIBRARY)
编译多个共享库
一个Android.mk文件可能编译产生多个共享库。这里会产生 libmodule1.so 和 libmodule2.so两个动态库
LOCAL_PATH := $(call my-dir)
# 模块一
include $(CLEAR_VARS)
LOCAL_MODUL := mudule1
LOCAL_SRC_FILES := module1.c
include $(BUILD_SHARED_LIBRARY)
# 模块一
include $(CLEAR_VARS)
LOCAL_MODUL := mudule2
LOCAL_SRC_FILES := module2.c
include $(BUILD_SHARED_LIBRARY)
编译静态库
虽然Andorid应用程序不能直接使用静态库,静态库可以用来编译动态库。
比如在将第三方代码添加到原生项目中,可以不用直接将第三方源码包括在原生项目中,而是将第三方源码编译成静态库,然后并入共享库。
LOCAL_PATH := $(call my - dir)
# 第三方AVI库
include $(CLEAR_VARS)
LOCAL_MOUDLE := avilib
LOCAL_SRC_FILES ;= avilib.c platform_posix.c
include $(BUILD_STATIC_LIBARAY)
# 原生模块
include $(CLEAR_VARS)
LOCAL_MOUDLE := moudle
LOCAL_SRC_FILES := moudle.c
# 将静态库模块名添加到 LOCAL_STATIC_LIBRARIES变量
LOCAL_STATIC_LIBRARIES := avilib
include $(BUILD_SHARD_LIBRARY)
使用共享库共享通用模块
静态库可以保证源代码模块化,但是当静态库与共享库相连时,他就变成了共享库的一部分。在多个共享库的情况下,多个共享库与静态库连接时,需要将通用模块的多个副本与不同的共享库重复连接,这就增加了APP的大小,这种情况下,可以改通过模块作为共享库。
LOCAL_PATH := $(call my - dir)
# 模块1 模块 2 都依赖第三方库 AVI
include $(CLEAR_VARS)
LOCAL_MOUDLE := avilib
LOCAL_SRC_FILES ;= avilib.c platform_posix.c
# 共享库
include $(BUILD_SHARED_LIBARAY)
# 原生模块1
include $(CLEAR_VARS)
LOCAL_MODULE := moudel1
LOCAL_SRC_FILES := moudl1e.c
LOCAL_STATIC_LIBRARIES := avilib
include $(BUILD_SHARD_LIBRARY)
# 原生模块2
include $(CLEAR_VARS)
LOCAL_MODULE := moudel2
LOCAL_SRC_FILES := moudl2e.c
LOCAL_STATIC_LIBRARIES := avilib
include $(BUILD_SHARD_LIBRARY)
在多个NDK项目间共享模块
首先将avilib源码移动到NDK项目以外的位置 , 如:c:\android\shared-modules\transcode\avilib
作为共享模块,avilib需要有自己的Anroid.mk
以transcode/avilb(源文件目录)为参数调用函宏 import-module 添加到NDK项目的Android.mk末尾
# avilib 模块自己的Android.mk文件
LOCAL_PATH := $(call my - dir)
include $(CLEAR_VARS)
LOCAL_MOUDLE := avilib
LOCAL_SRC_FILES ;= avilib.c platform_posix.c
include $(BUILD_SHARED_LIBARAY)
------------------------------------------------------------------------
#使用共享模块的 NDK项目1 的Android.mk文件
LOCAL_PATH := $(call my - dir)
include $(CLEAR_VARS)
include $(CLEAR_VARS)
LOCAL_MODULE := moudel1
LOCAL_SRC_FILES := moudl1e.c
LOCAL_STATIC_LIBRARIES := avilib
include $(BUILD_SHARD_LIBRARY)
$(call import-module, transcode/avilib)
------------------------------------------------------------------------
#使用共享模块的 NDK项目2 的Android.mk文件
LOCAL_PATH := $(call my - dir)
include $(CLEAR_VARS)
include $(CLEAR_VARS)
LOCAL_MODULE := moudel2
LOCAL_SRC_FILES := moudl2e.c
LOCAL_STATIC_LIBRARIES := avilib
include $(BUILD_SHARD_LIBRARY)
$(call import-module, transcode/avilib)
使用预编译库
现在不发布源代码的情况下将模块发布给他人。
使用共享模块的预编译版来加速编译过程
# 预编译共享模块的Android.mk文件
LOCAL_PATH := $(call my-dir)
# 第三方预编译库
include $(CLEAR_VARS)
LOCAL_MODULE := avilib
LOCAL_SRC_FILE := avilib.c platform_posix.c
include $(PREBUILD_SHARD_LIBRARY)
编译独立的可执行文件
为了方便测试和进行快速开发,可以编译成可执行文件。不用打包到APK就可以复制到Android设备上直接执行。
# 独立可执行模块的Android.mk文件
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := avilib
LOCAL_SRC_FILE := avilib.c platform_posix.c
include $(BUILD_EXECUTABLE)
注意事项
假如我们本地库 libhello-jni.so 依赖于libTest.so (可以使用NDK下的ndk-depends 查看so的依赖关系)
在Andorid6.0版本之前,需要在加载本地库前先加载被依赖的so
在Android6.0版本之后,不能再使用预编译的动态库(静态库没问题)
Android studio 项目编译