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_LIBRARIESLOCAL_LDLIBSLOCAL_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方式不行。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,937评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,503评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,712评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,668评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,677评论 5 366
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,601评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,975评论 3 396
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,637评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,881评论 1 298
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,621评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,710评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,387评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,971评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,947评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,189评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,805评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,449评论 2 342

推荐阅读更多精彩内容