include $(CLEAR_VARS)LOCAL_MODULE := libexample_prebuiltLOCAL_SRC_FILES := path/to/libexample.soinclude $(PREBUILT_SHARED_LIBRARY)
这段代码定义了一个名为libexample_prebuilt的模块,它指向了预编译的libexample.so库。当其他模块依赖于这个库时,它们可以通过libexample_prebuilt这个标识符来引用它。
使用PREBUILT_XXXX_LIBRARY让构建系统明确知道这些库文件已经是编译好的,不需要再次编译,同时还提供了库文件的位置信息,确保链接过程能够正确地找到并使用这些库。这是Android构建系统设计的一部分,旨在提供一种高效、可靠的方式来处理预编译的第三方库。
为什么需要BUILD_PREBUILT在Android构建系统中,通常有两种方式来使用第三方库:

使用PREBUILT_XXXX_LIBRARY(XXXX可以是STATIC或SHARED)告诉构建系统这个库已经编译好了,不需要再次编译,只需要在链接时将其包含进来。当你在Android.mk文件中设置了相关的PREBUILT_XXXX_LIBRARY变量后,使用include $(BUILD_PREBUILT)告诉构建系统应用这些设置。这行命令实际上引入了一个预定义的Makefile片段,这个片段包含了处理预编译库所需的规则和逻辑。
用BUILD_PREBUILT而不是直接引入源码编译有几个好处:
时间节省:避免了每次构建都重新编译库,尤其是对于大型第三方库来说,这可以大大减少构建时间。一致性:确保库的版本一致,避免因不同编译环境或参数导致的差异。简化依赖:对于使用者来说,不需要关心库的编译过程和依赖,只需要关注如何链接和使用。通过这种方式,开发者可以有效地管理和使用第三方预编译库,使得构建过程更加高效和可控。
Android.mk示例分析LOCAL_PATH:= $(call my-dir)include $(CLEAR_VARS)LOCAL_MODULE := NotePadLOCAL_MODULE_TAGS := optionalLOCAL_MODULE_CLASS := APPSifeq ($(SOC_VENDOR), x) LOCAL_MODULE_PATH := $(TARGET_OUT)/preloadelse ifeq ($(APP_USE_SYSTEM_EXT), true) LOCAL_MODULE_PATH := $(TARGET_OUT_SYSTEM_EXT)/partnerelse LOCAL_MODULE_PATH := $(TARGET_OUT)/partnerendififeq ($(ODM_VERTU_METASPACE), true) LOCAL_MODULE_PATH :=endififeq ($(RETAIL_MODE), true)LOCAL_SRC_FILES := $(LOCAL_MODULE)-retail.apkendifLOCAL_MODULE_SUFFIX := $(COMMON_ANDROID_PACKAGE_SUFFIX)LOCAL_DEX_PREOPT := falseifeq ($(TARGET_BUILD_VARIANT), user)LOCAL_CERTIFICATE := releasekeyelse LOCAL_CERTIFICATE := testkeyendifinclude $(BUILD_PREBUILT)
设置LOCAL_PATH变量为当前目录。$(call my-dir)是一个内置函数,用于获取当前Android.mk文件所在的目录。
包含了CLEAR_VARS变量指向的文件,通常用于清除之前为新模块设置的所有变量,以避免设置冲突。
定义模块名为NotePad
指定模块标签为optional,意味着这个模块不是必须的,可以根据需求包含或不包含在最终产品中。
指定模块类别为应用程序(APPS)。
根据不同条件设置模块的安装路径。如果系统芯片供应商(SOC_VENDOR)是x,模块将安装到preload目录;如果设置了使用系统扩展(APP_USE_SYSTEM_EXT),则安装到system_ext/partner目录;否则,默认安装到partner目录。
如果定义了ODM_VERTU_METASPACE并设置为true,那么LOCAL_MODULE_PATH将被清空,可能意味着这个模块不会被安装。
根据不同的特性标志选择不同的APK文件作为源文件。如果是零售模式(RETAIL_MODE),选择-retail.apk版本;否则,选择默认的.apk文件。
设置模块后缀,通常为.apk
禁用DEX文件的预优化
根据不同的条件选择使用的签名密钥。使用releasekey或使用预签名(PRESIGNED)。
包含BUILD_PREBUILT,这个指令告诉构建系统如何处理预先构建的模块。