MakeFIle学习3-Android的MakeFile基础

3.Android的makefile基础

Android.mk是什么

Android.mk是一个向AndroidNDK构建系统描述NDK项目的GNU的Makefile片段。主要用来编译生成以下几种:

1. APK程序：一般的Android应用程序，系统级别的直接push即可
2. Java库：Java类库，编译打包生成的JAR文件
3. C C++应用程序：可执行C C++应用程序
4. C C++静态库：编译生成C C++静态库，并打包.a文件
5. C C++ 共享库:编译生成共享库，并打包成.so文件

Android.mk 基本格式

这是一个简单的Android.mk文件对的内容

1. 定义模块当前路径(必须定义在文件开头，只需要定义一次)

LOCAL_PATH=$(call my-dir)

2. 清空当前环境变量(LOCAL_PATH)除外

include $(CLEAR_VARS)

3. 当前模块名(这里会生成libhello-jni.so)

LOCAL_MODULE  := hello-jni

4. 当前模块包含的源代码文件

LOCAL_SRC_FILES := hello-jni.c

5. 表示当前模块将编译成一个共享库

include $(BUILD_SHARED_LIBRARY)

编译多个共享库

一个Android.mk可能编译产生多个共享库模块。这里会产生libmodule1.so和libmodule2.so两个动态库

LOCAL_PATH := $(call my-dir)

# 共享模块1
include $(CLERA_VARS)
LOCAL_MODULE  := module1
LOCAL_SRC_FILES :=module1.c
include $(BUILD_SHARED_LIBRARY)

# 共享模块2
include $(CLERA_VARS)
LOCAL_MODULE  := module2
LOCAL_SRC_FILES :=module2.c
include $(BUILD_SHARED_LIBRARY)

编译静态库

虽然Android应用程序不能直接使用静态库，静态库可以用来编译动态库。比如在将第三方代码添加到原生项目中，可以不用直接将第三方源码包括到原生项目中，而是将第三方源码编译成静态库，然后并入共享库

LOCAL_PATH := $(call my-dir)

# 第三方VAVI库
include $(CLERA_VARS)
LOCAL_MODULE  := avilib
LOCAL_SRC_FILES :=avilib.c platform_posix.c
include $(BUILD_STATIC_LIBRARY)

# 原生模块
include $(CLERA_VARS)
LOCAL_MODULE  := module
LOCAL_SRC_FILES :=module.c

# 将静态库模块名添加到LOCAL_STATIC_LIBRARIES变量
LOCAL_STATIC_LIBRARIES := avilib
include $(BUILD_SHARED_LIBRARY)

使用共享库共享通用模块

静态库可以保证源码模块化，但是当静态库与共享库相连接时，他就变成了共享库的一部分。在多个共享库的情况下，多个共享库与静态库连接时，需要将通用模块的多个副本与不同的共享库重复连接，这样就增加了APP的大小。这种情况可以将通用模块作为共享库

LOCAL_PATH := $(call my-dir)

# 第三方VAVI库
include $(CLERA_VARS)
LOCAL_MODULE  := avilib
LOCAL_SRC_FILES :=avilib.c platform_posix.c
include $(BUILD_SHARED_LIBRARY)

# 原生模块1
include $(CLERA_VARS)
LOCAL_MODULE  := module1
LOCAL_SRC_FILES :=module1.c

# 将静态库模块名添加到LOCAL_SHARED_LIBRARIES变量
LOCAL_SHARED_LIBRARIES := avilib
include $(BUILD_SHARED_LIBRARY)


# 原生模块2
include $(CLERA_VARS)
LOCAL_MODULE  := module2
LOCAL_SRC_FILES :=module2.c

# 将静态库模块名添加到LOCAL_SHARED_LIBRARIES变量
LOCAL_SHARED_LIBRARIES := avilib
include $(BUILD_SHARED_LIBRARY)

在多个NDK项目间共享模块

1. 首先将avilib源代码移动到NDK项目外的位置，比如 c:\android\shared\transcode\avilib
2. 作为共享模块。avilib需要有自己的Android.mk文件。
3. 以transcode/avilib为参数调用函数宏import-module添加到NDK项目的Android.mk文档末尾

#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_LIIBRARY)
------------------------------------------------
# 使用共享模块的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_LIIBRARY)
#(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_LIIBRARY)
#(call import-module,transcode/avilib)

使用预编译库

1. 想在不发布源代码的情况下将模块发布给他人
2. 想使用共享库的预编译版来加速编译过程

# 预编译共享模块的Android.mk文件
LOCAL_PARH :=$(call my-dir)

# 第三方预编译的库
include $(CLEAR_VARS)
LOCAL_SRC_FILES :=libavilib.so
include $(PREBUILT_SHARED_LIBRARY)

编译独立的可执行文件

1. 为了方便测试和进行快速开发，可以编译成可执行文件。不用打包成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)

注意事项

1. 加入我们本地库libhello-jni.so依赖于libTest.so(可以使用NDK下的ndk-depends)查看so的依赖关系
2. 在Android6.0版之前，需要在加载本地库前先加载被依赖的so
3. 在Android6.0版本之后，不能再使用预编译的动态库(静态库没问题)

# Android 6.0之前
System.loadLibrary("Test");
System.loadLibrary("hello-jni");

# Android 6.0之后

System.loadLibrary("hello-jni")