Android.mk常用宏定义

常用变量定义

为了方便模块编译，Build系统还设置了很多编译环境。单独编译一个模块时，需要配置变量后才能执行编译：

变量	作用
LOCAL_SRC_FILES	当前模块包含的所有源代码文件
LOCAL_MODULE	当前模块的名称，这个名称应当是唯一的，模块间的依赖关系就是通过这个名称来引用的
LOCAL_C_INCLUDES	C 或 C++ 语言需要的头文件的路径
LOCAL_STATIC_LIBRARIES	当前模块在静态链接时需要的库的名称
LOCAL_SHARED_LIBRARIES	当前模块在运行时依赖的动态库的名称
LOCAL_CFLAGS	提供给 C/C++ 编译器的额外编译参数
LOCAL_JAVA_LIBRARIES	当前模块依赖的 Java 共享库
LOCAL_STATIC_JAVA_LIBRARIES	当前模块依赖的 Java 静态库
LOCAL_PACKAGE_NAME	当前 APK 应用的名称
LOCAL_CERTIFICATE	签署当前应用的证书名称
LOCAL_MODULE_PATH	指定输出路径
LOCAL_PRIVILEGED_MODULE	指定生成的apk是否在system/priv-app/下，等同于设置LOCAL_MODULE_PATH:= $(TARGET_OUT)/system/priv-app
LOCAL_MODULE_TAGS	user/debug/eng/optional 指定该模块在什么版本下编译 optional 表示所有版本都编译

在Android Build系统中声明了很多编译类型：Java 库，C/C++ 库，APK 应用，以及可执行文件等，并且Java 或者 C/C++ 库还可以分为静态的或者动态的，库或可执行文件既可能是针对设备的也可能是针对主机的或者模拟器的，不同的模块的编译声明和方法是不一样的，在config.mk中声明了模块类型，如下：

TAG	Action
BUILD_HOST_STATIC_LIBRARY	编译静态库(适用与主机)
BUILD_HOST_SHARED_LIBRARY	编译动态库(适用与主机)
BUILD_HOST_EXECUTABLE	编译可执行程序(适用与主机)
BUILD_HOST_PREBUILT	预编译(适用与主机)
BUILD_HOST_JAVA_LIBRARY	编译java包(适用与主机)
BUILD_JAVA_LIBRARY	编译java包
BUILD_STATIC_JAVA_LIBRARY	编译java静态包
BUILD_STATIC_LIBRARY	编译静态库
BUILD_SHARED_LIBRARY	编译动态库
BUILD_EXECUTABLE	编译可执行程序
BUILD_PACKAGE	编译apk
BUILD_PREBUILT	预编译(针对单个预编译文件)
BUILD_MULTI_PREBUILT	预编译(针对多个预编译文件)

在Android源码中，为了把一个模块添加到Build系统中，每个模块都需要编写一个专门的Android.mk文件，Build系统会查找到所有目录下的Android.mk，并根据Android.mk文件编译出指定的目标文件。

宏定义函数

宏函数定义文件：build/core/definitions.mk

#LOCAL_SRC_FILES 写法

LOCAL_SRC_FILES := $(call all-java-files-under, java) \  #java文件夹下所有java源文件
                    $(call all-Iaidl-files-under, aidl) \ #aidl文件夹下所有I*.aidl`源文件
                    $(call all-c-files-under, jni) \ #jni文件夹下所有c源文件
                    $(call all-cpp-files-under, cpp) \ #cpp文件夹下所有cpp源文件
                    

# 查找src问价夹下所有*.ext 的文件，使用该函数可以自定义查找的文件后缀
(call all-named-files-under,*.ext,src)      

Android mk 文件配置签名

我们知道在 build/target/product/security 目录中有四组默认签名供，Android.mk在编译APK使用：

1、testkey：普通APK，默认情况下使用。

2、platform：该APK完成一些系统的核心功能。经过对系统中存在的文件夹的访问测试，
这种方式编译出来的APK所在进程的UID为system。

3、shared：该APK需要和home/contacts进程共享数据。

4、media：该APK是media/download系统中的一环。
举例说明一下。

系统中所有使用android.uid.system作为共享UID的APK，
都会首先在manifest节点中增加android:sharedUserId="android.uid.system"，
然后在Android.mk中增加LOCAL_CERTIFICATE := platform。可以参见Settings等

系统中所有使用android.uid.shared作为共享UID的APK，
都会在manifest节点中增加android:sharedUserId="android.uid.shared"，
然后在Android.mk中增加LOCAL_CERTIFICATE := shared。可以参见Launcher等

系统中所有使用android.media作为共享UID的APK，
都会在manifest节点中增加android:sharedUserId="android.media"，
然后在Android.mk中增加LOCAL_CERTIFICATE := media。可以参见Gallery等。

引入依赖库

一. 引用系统aar库

LOCAL_STATIC_JAVA_LIBRARIES := android-support-v7-appcompat \
                    android-support-v13 \
                    android-support-design

LOCAL_RESOURCE_DIR := $(LOCAL_PATH)/res \
  frameworks/support/v7/appcompat/res \
  frameworks/support/design/res

LOCAL_AAPT_FLAGS := \
  --auto-add-overlay \
  --extra-packages android.support.design \
  --extra-packages android.support.v7.appcompat

二. 导入第三方jar包

LOCAL_PATH := $(call my-dir)
# 首先导入库
include $(CLEAR_VARS)

LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES := libOkhttp:/libs/Okhttp.jar \
                                        libGlide:/libs/Glide.jar 
                                        
include $(BUILD_MULTI_PREBUILT)


# 主编译中引入

include $(CLEAR_VARS)
.....

LOCAL_STATIC_JAVA_LIBRARIES := libOkhttp \
                               libGlide 

include $(BUILD_PACKAGE)

三. 导入so库

#====================================================

include $(CLEAR_VARS)
LOCAL_MODULE_TAGS := optional
LOCAL_MODULE_SUFFIX := .so
LOCAL_MODULE := libaaa
LOCAL_MODULE_CLASS := SHARED_LIBRARIES
LOCAL_SRC_FILES_arm :=libs/armeabi-v7a/libaaa.so
LOCAL_SRC_FILES_arm64 :=libs/arm64-v8a/libaaa.so
LOCAL_MODULE_TARGET_ARCHS:= arm arm64
LOCAL_MULTILIB := both
include $(BUILD_PREBUILT)
#====================================================

#====================================================
include $(CLEAR_VARS)
LOCAL_MODULE_TAGS := optional
LOCAL_MODULE_SUFFIX := .so
LOCAL_MODULE := libbbb
LOCAL_MODULE_CLASS := SHARED_LIBRARIES
LOCAL_SRC_FILES_arm :=libs/armeabi-v7a/libbbb.so
LOCAL_SRC_FILES_arm64 :=libs/arm64-v8a/libbbb.so
LOCAL_MODULE_TARGET_ARCHS:= arm arm64
LOCAL_MULTILIB := both
include $(BUILD_PREBUILT)



# 主编译中引用

include $(CLEAR_VARS)

----   

# 省略若干内容
....

LOCAL_REQUIRED_MODULES := libaaa \
                          libbbb \
                         

LOCAL_JNI_SHARED_LIBRARIES := libaaa\
                              libbbb\

include $(BUILD_PACKAGE)

四. 导入第三方aar包

include $(CLEAR_VARS)

LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES += aaa:libs/sampe1.aar
LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES += bbb:libs/sample2.aar

include $(BUILD_MULTI_PREBUILT)


# 主编译中引用
LOCAL_STATIC_JAVA_AAR_LIBRARIES += aaa \
                                    bbb
                                    
# 引用aar包资源
LOCAL_AAPT_FLAGS += \
         --auto-add-overlay \
         --extra-packages com.xxx.sample1 \ # sample1的包名
         --extra-packages com.xxx.sample2 \ # sample2的包名

LOCAL_SHARED_LIBRARIES 与 LOCAL_LDLIBS，LOCAL_LDFLAGS的区别

• LOCAL_LDLIBS

链接的库不产生依赖关系，一般用于不需要重新编译的库，如库不存在，则会报错找不到。且貌似只能链接那些存在于系统目录下本模块需要连接的库。如果某一个库既有动态库又有静态库，那么在默认情况下是链接的动态库而非静态库。

LOCAL_LDLIBS += -lm –lz –lc -lcutils –lutils –llog …

如果你的Android.mk文件中只有这么一行，那么将会采用动态链接。

• LOCAL_SHARED_LIBRARIES

会生成依赖关系，当库不存在时会去编译这个库。

• LOCAL_LDFLAGS

这个编译变量传递给链接器一个一些额外的参数，比如想传递而外的库和库路径给ld，或者传递给ld linker的一些链接参数，-On，-EL{B}(大小端字节序)，那么就要加到这个上面，如：

LOCAL_LDFLAGS += -L$(LOCAL_PATH)/lib/ -lHWrecog –EB{EL} –O{n} …

或者直接加上绝对路径库的全名：

LOCAL_LDFLAGS += $(LOCAL_PATH)/lib/libHWrecog.a –EB{EL} –O{n}

注：如果是非系统的第三方库，貌似只能用LOCAL_LDFLAGS方式，LOCAL_LDLIBS方式不行。