Android 浅度解析：mk预置AAR、SO文件、APP包和签名

1.Android.mk中引用AAR文件的方法

在Android开发中，经常需要使用到第三方库，这些库通常以AAR或JAR的形式提供。在本文中，将详细介绍如何在Android.mk文件中引用AAR文件。

AAR文件简介

AAR（Android Archive）文件是Android库项目的打包格式，它包含了Java类、资源文件、清单文件和可选的本地库文件。AAR文件是一种方便的方式来分发Android库，因为它包含了库所需的所有资源和代码。

在Android.mk中引用AAR文件

在Android.mk中引用AAR文件，需要使用LOCAL_STATIC_JAVA_AAR_LIBRARIES变量来指定AAR文件的别名，然后使用LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES变量来指定AAR文件的位置，最后使用include $(BUILD_MULTI_PREBUILT)来编译AAR文件。

如果AAR文件包含了本地库文件（.so），还需要在LOCAL_JNI_SHARED_LIBRARIES变量中指定本地库文件的模块名，并在LOCAL_MULTILIB变量中指定本地库文件的位数（32或64）。

如果AAR文件包含了其他JAR文件，还需要在LOCAL_STATIC_JAVA_LIBRARIES变量中指定JAR文件的别名，并在LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES变量中指定JAR文件的位置。

以下是一个Android.mk引用AAR文件的详细示例：

# 定义当前模块的相对路径
LOCAL_PATH := $(call my-dir)

# 清除一些变量的值，但是LOCAL_PATH除外
include $(CLEAR_VARS)

# 指定当前待编译模块的名称
LOCAL_MODULE := my-app

# 指定当前模块的源文件
LOCAL_SRC_FILES := MainActivity.java

# 指定当前模块依赖的aar文件的别名
LOCAL_STATIC_JAVA_AAR_LIBRARIES := my-lib

# 指定当前模块依赖的其他模块
LOCAL_SHARED_LIBRARIES := liblog

# 指定当前模块的编译选项
LOCAL_CFLAGS := -Wall -Werror

# 指定当前模块的链接选项
LOCAL_LDFLAGS := -Wl,-z,nocopyreloc

# 指定当前模块的目标类型，可以是静态库、动态库、可执行文件或者Java库等
include $(BUILD_PACKAGE)

# 声明aar文件的位置
include $(CLEAR_VARS)
LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES += my-lib:libs/my-lib.aar
include $(BUILD_MULTI_PREBUILT)

# 如果aar文件包含了本地库文件（.so），还需要在下面声明本地库文件的模块名、源文件和路径，例如：
include $(CLEAR_VARS)
LOCAL_MODULE_TAGS := optional
LOCAL_MODULE_CLASS := SHARED_LIBRARIES
LOCAL_MODULE_SUFFIX := .so
LOCAL_MODULE := libmy-lib
LOCAL_SRC_FILES := libs/armeabi-v7a/libmy-lib.so


LOCAL_MODULE_PATH := $(TARGET_OUT)/lib
include $(BUILD_PREBUILT)

生成AAR文件

如果你想要生成AAR文件，可以先编译JAR文件，然后再编译AAR文件。以下是一个示例：

make out/target/common/obj/JAVA_LIBRARIES/YourLibName_intermediates/javalib.jar
make out/target/common/obj/JAVA_LIBRARIES/YourLibName_intermediates/javalib.aar

执行上述命令后，你可以在out/target/common/obj/JAVA_LIBRARIES/YourLibName_intermediates/目录下找到生成的AAR文件。

2.Android.mk中引用和生成SO文件的方法

在Android开发中，经常需要使用到第三方库，这些库通常以SO（Shared Object）的形式提供。在本文中，将详细介绍如何在Android.mk文件中引用和生成SO文件。

SO文件简介

SO文件是动态链接库文件，它可以被多个应用程序共享，也可以包含本地代码和其他SO文件。SO文件是一种方便的方式来分发Android库，因为它包含了库所需的所有资源和代码。

在Android.mk中生成SO文件

在Android.mk中生成SO文件，需要使用LOCAL_SRC_FILES变量来指定源文件，然后使用LOCAL_MODULE变量来指定模块名，最后使用include $(BUILD_SHARED_LIBRARY)来编译SO文件。

@lib方式引用SO文件

@lib方式是一种指定apk运行时加载apk中的SO文件的方法，它可以避免解压apk中的SO文件并拷贝到lib目录的操作。但是，如果apk中有多个SO文件，而且不是所有的SO文件都支持同样的平台（如arm64-v8a或armeabi-v7a），那么@lib方式可能会导致找不到对应的SO文件而报错。

为了解决这个问题，有两种可能的方法：

• 方法一：在Android.mk中指定只编译支持的平台，例如：

ifeq ($(TARGET_ARCH), arm)
LOCAL_PREBUILT_JNI_LIBS := \
    @lib/armeabi-v7a/liba.so \
    @lib/armeabi-v7a/libb.so
else ifeq ($(TARGET_ARCH),arm64)
LOCAL_PREBUILT_JNI_LIBS := \
    @lib/arm64-v8a/liba.so \
    @lib/arm64-v8a/libb.so
endif

• 方法二：在Android.mk中使用LOCAL_PREBUILT_JNI_LIBS变量来指定SO文件相对于LOCAL_PATH的路径，而不是使用@符号，例如：

LOCAL_PREBUILT_JNI_LIBS := \
    lib/arm64-v8a/liba.so \
    lib/arm64-v8a/libb.so

在Android.mk中引用SO文件

在Android.mk中引用SO文件，需要使用LOCAL_SHARED_LIBRARIES变量来指定SO文件的模块名，然后使用LOCAL_PREBUILT_JNI_LIBS变量来指定SO文件的位置，最后使用include $(BUILD_PREBUILT)来编译SO文件。

如果SO文件是32位或64位的，还需要在LOCAL_MULTILIB变量中指定位数，例如：

LOCAL_MULTILIB := 32

或者

LOCAL_MULTILIB := 64

以下是一个Android.mk引用SO文件的详细示例：

# 定义当前模块的相对路径
LOCAL_PATH := $(call my-dir)

# 清除一些变量的值，但是LOCAL_PATH除外
include $(CLEAR_VARS)

# 指定当前待编译模块的名称
LOCAL_MODULE := my-app

# 指定当前模块的源文件
LOCAL_SRC_FILES := MainActivity.java

# 指定当前模块依赖的so文件的模块名
LOCAL_SHARED_LIBRARIES := libtest1 libtest2 libtest3

# 指定当前模块的编译选项
LOCAL_CFLAGS := -Wall -Werror

# 指定当前模块的链接选项
LOCAL_LDFLAGS := -Wl,-z,nocopyreloc

# 指定当前模块的目标类型，可以是静态库、动态库、可执行文件或者Java库等
include $(BUILD_PACKAGE)

# 声明so文件的位置，有两种方式：

# 方式一：使用LOCAL_PREBUILT_JNI_LIBS变量，指定so文件相对于LOCAL_PATH的路径，例如：
include $(CLEAR_VARS)
LOCAL_PREBUILT_JNI_LIBS := \
    lib/arm64-v8a/libtest1.so \
    lib/arm64-v8a/libtest2.so \
    lib/arm64-v8a/libtest3.so
include $(BUILD_MULTI_PREBUILT)

# 方式二：使用LOCAL_MODULE和LOCAL_SRC_FILES变量，指定so文件的模块名和源文件，然后使用include $(BUILD_PREBUILT)来编译so文件，例如：
include $(CLEAR_VARS)
LOCAL_MODULE_TAGS := optional
LOCAL_MODULE_CLASS := SHARED_LIBRARIES
LOCAL_MODULE_SUFFIX := .so
LOCAL_MODULE := libtest1
LOCAL_SRC_FILES := libs/armeabi-v7a/libtest1.so
LOCAL_MODULE_PATH := $(TARGET_OUT)/lib
include $(BUILD_PREBUILT)

include $(CLEAR_VARS)
LOCAL_MODULE_TAGS := optional
LOCAL_MODULE_CLASS := SHARED

_LIBRARIES
LOCAL_MODULE_SUFFIX := .so
LOCAL_MODULE := libtest2
LOCAL_SRC_FILES := libs/armeabi-v7a/libtest2.so
LOCAL_MODULE_PATH := $(TARGET_OUT)/lib
include $(BUILD_PREBUILT)

include $(CLEAR_VARS)
LOCAL_MODULE_TAGS := optional
LOCAL_MODULE_CLASS := SHARED_LIBRARIES
LOCAL_MODULE_SUFFIX := .so
LOCAL_MODULE := libtest3
LOCAL_SRC_FILES := libs/armeabi-v7a/libtest3.so
LOCAL_MODULE_PATH := $(TARGET_OUT)/lib
include $(BUILD_PREBUILT)

如何处理APK中的多个SO文件
在Android开发中，一个APK可能包含多个SO文件，这些SO文件可能分布在不同的目录中，处理这些SO文件可能会比较麻烦。但是，可以使用一些方法来简化这个过程。

方法一：使用循环语句自动解压所有SO文件

在Android.mk中，可以使用一个循环语句来遍历APK中的所有SO文件，并使用LOCAL_PREBUILT_JNI_LIBS变量来指定SO文件相对于LOCAL_PATH的路径。以下是一个示例：

# 清空临时变量JNI_LIBS
JNI_LIBS :=
# 当前目录递归搜索
$(foreach FILE,$(shell find $(LOCAL_PATH)/lib/ -name *.so), $(eval JNI_LIBS += $(FILE)))
# 获取搜索文件目录集（相对目录）
LOCAL_PREBUILT_JNI_LIBS := $(subst $(LOCAL_PATH),,$(JNI_LIBS))

这样，就可以自动解压出APK中的所有SO文件。

方法二：使用@符号避免解压所有SO文件

在Android.mk中，也可以使用@符号来指定APK运行时加载APK中的SO文件，而不需要解压出来。以下是一个示例：

ifeq ($(TARGET_ARCH), arm)
LOCAL_PREBUILT_JNI_LIBS := \
    @lib/armeabi-v7a/liba.so \
    @lib/armeabi-v7a/libb.so \
    ...
else ifeq ($(TARGET_ARCH),arm64)
LOCAL_PREBUILT_JNI_LIBS := \
    @lib/arm64-v8a/liba.so \
    @lib/arm64-v8a/libb.so \
    ...
endif

这样，就可以避免解压出APK中的所有SO文件。

使用@符号和不使用@符号的区别

在Android.mk中，使用@符号和不使用@符号有一些区别：

• 使用@符号可以提高性能，因为不需要解压和拷贝SO文件，也可以节省空间，因为不需要存储多余的SO文件。
• 不使用@符号可以提高兼容性，因为可以针对不同的平台提供相应的SO文件，而不需要考虑APK中是否有对应平台的SO文件。

3.Android.mk中预置APK、SO文件和签名

在Android系统开发中，经常需要预置一些应用（APK）和库（SO）文件，以及为这些应用和库文件指定签名。这些操作通常在Android.mk文件中完成。本文将详细介绍这些操作的方法和注意事项。

预置APK

预置APK的方式可以分为两种，一种是预置带源码的app，一种是预置无源码的apk。

预置带源码的app

预置带源码的app的方法是将app的源码放在源码树中的某个位置，例如vendor/xxx/apps或packages/apps目录下，然后在app目录下创建一个Android.mk文件，指定相关的变量和编译规则。例如：

# 定义当前模块的相对路径
LOCAL_PATH := $(call my-dir)

# 清除一些变量的值，但是LOCAL_PATH除外
include $(CLEAR_VARS)

# 指定当前待编译模块的名称
LOCAL_MODULE := my-app

# 指定当前模块的源文件
LOCAL_SRC_FILES := MainActivity.java

# 指定当前模块依赖的其他模块
LOCAL_SHARED_LIBRARIES := liblog

# 指定当前模块的编译选项
LOCAL_CFLAGS := -Wall -Werror

# 指定当前模块的链接选项
LOCAL_LDFLAGS := -Wl,-z,nocopyreloc

# 指定当前模块的目标类型，可以是静态库、动态库、可执行文件或者Java库等
include $(BUILD_PACKAGE)

预置无源码的apk

预置无源码的apk的方法是将apk放在源码树中的某个位置，例如vendor/xxx/apps目录下，然后在apk目录下创建一个Android.mk文件，使用LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES变量来指定apk相对于LOCAL_PATH的路径，并使用LOCAL_STATIC_JAVA_LIBRARIES变量来定义apk的别名。例如：

# 定义当前模块的相对路径
LOCAL_PATH := $(call my-dir)

# 清除一些变量的值，但是LOCAL_PATH除外
include $(CLEAR_VARS)

# 指定当前待编译模块的名称
LOCAL_MODULE := my-app

# 指定当前模块依赖的预置apk文件
LOCAL_STATIC_JAVA_LIBRARIES := my-app-prebuilt

# 指定当前模块的目标类型，可以是静态库、动态库、可执行文件或者Java库等
include $(BUILD_PACKAGE)

# 声明预置apk文件的位置
include $(CLEAR_VARS)
LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES += my-app-prebuilt:my-app.apk
include $(BUILD_MULTI_PREBUILT)

预置SO文件

预置SO文件的方式也可以分为两种，一种是预置带源码的so，一种是预置无源码的so。

预置带源码的so

预置带源码的so的方法是将so的源码放在源码树中的某个位置，例如vendor/xxx/libs或external/xxx目录下，然后在so目录下创建一个Android.mk文件，指定相关的变量和编译规则。例如：

# 定义当前模块的相对路径
LOCAL_PATH := $(call my-dir)

# 清除一些变量的值，但是LOCAL_PATH除外
include $(CLEAR_VARS)

# 指定当前待编译模块的名称
LOCAL_MODULE := libtest

# 指定当前模块的源文件
LOCAL_SRC_FILES := test.c

# 指定当前模块依赖的其他模块
LOCAL_SHARED_LIBRARIES := libcutils liblog

# 指定当前模块的编译选项
LOCAL_CFLAGS := -Wall -Werror

# 指定当前模块的链接选项
LOCAL_LDFLAGS := -Wl,-z,nocopyreloc

# 指定当前模块的目标类型，可以是静态库、动态库、可执行文件或者Java库等
include $(BUILD_SHARED_LIBRARY)

预置无源码的so

预置无源码的so的方法是将so放在源码树中的某个位置，例如vendor/xxx/libs目录下，然后在so目录下创建一个Android.mk文件，使用LOCAL_PREBUILT_JNI_LIBS变量来指定so文件相对于LOCAL_PATH的路径，或者使用@符号来指定apk运行时加载apk中的so文件。例如：

# 定义当前模块的相对路径
LOCAL_PATH := $(call my-dir)

# 清除一些变量的值，但是LOCAL_PATH除外
include $(CLEAR_VARS)

# 指定当前待编译模块的名称
LOCAL_MODULE := my-app

# 指定当前模块依赖的预置so文件
LOCAL_SHARED_LIBRARIES := libtest1 libtest2 libtest3

# 指定当前模块的目标类型，可以是静态库、动态库、可执行文件或者Java库等
include $(BUILD_PACKAGE)

# 声明预置so文件的位置，有两种方式：

# 方式一：使用LOCAL_PREBUILT_JNI_LIBS变量，指定so文件相对于LOCAL_PATH的路径，例如：
include $(CLEAR_VARS)
LOCAL_PREBUILT_JNI_LIBS := \
    lib/arm64-v8a/libtest1.so \
    lib/arm64-v8a/libtest2.so \
    lib/arm64-v8a/libtest3.so
include $(BUILD_MULTI_PREBUILT)

# 方式二：使用@符号，指定apk运行时加载apk中的so文件，例如：
ifeq ($(TARGET_ARCH), arm)
LOCAL_PREBUILT_JNI_LIBS := \
    @lib/armeabi-v7a/libtest1.so \
    @lib/armeabi-v7a/libtest2.so \
    @lib/armeabi-v7a/libtest3.so
else ifeq ($(TARGET_ARCH),arm64)
LOCAL_PREBUILT_JNI_LIBS := \
    @lib/arm64-v8a/libtest1.so \
    @lib/arm64-v8a/libtest2.so \
    @lib/arm64-v8a/libtest3.so
endif

预置APK和SO文件的目录

预置APK和SO文件的目录可以分为三种，一种是system/app目录，一种是system/priv-app目录，一种是data/app目录。

system/app目录

预置到system/app目录的APK和SO文件是普通系统应用和库，用户不可卸载，但可以更新。预置到system/app目录的APK和SO文件需要在Android.mk文件中指定LOCAL_MODULE_PATH := $ (TARGET_OUT_APPS)变量，并在device/xxxx/device.mk文件中添加PRODUCT_PACKAGES += <app_name>这句来指定要打包进系统镜像中去的app名称。

system/priv-app目录

预置到system/priv-app目录的APK和SO文件是特权系统应用和库，用户不可卸载，但可以更新，并且具有特殊权限。预置到system/priv-app目录的APK和SO文件需要在Android.mk文件中指定LOCAL_MODULE_PATH := $ (TARGET_OUT_PRIVILEGED_APPS)变量，并在device///device.mk文件中添加PRODUCT_PACKAGES += <app_name>这句来指定要打包进系统镜像中去的app名称。

data/app目录

预置到data/app目录的APK和SO文件是普通应用和库，用户可卸载和更新，并且恢复出厂设置后会被清除。预置到data/app目录的APK和SO文件需要在Android.mk文件中指定LOCAL_MODULE_PATH := $ (TARGET_OUT_DATA_APPS)变量，并在device///device.mk文件中添加PRODUCT_PACKAGES += <app_name>这句来指定要打包进系统镜像中去的app名称。

指定签名

Android.mk文件中可以指定的签名有以下几种：

• platform：表示使用平台签名文件，一般用于系统应用或特权应用。
• shared：表示使用共享签名文件，一般用于共享用户ID的应用。
• media：表示使用媒体签名文件，一般用于媒体相关的应用。
• testkey：表示使用测试签名文件，一般用于开发阶段的应用。
• PRESIGNED：表示使用预先签名的apk文件，不需要再次签名。
• <keystore_file>：表示使用指定的签名文件，可以是相对路径或绝对路径。

指定签名的方法是在Android.mk文件中使用LOCAL_CERTIFICATE变量来指定签名文件的名称或路径。例如：

# 使用平台签名
LOCAL_CERTIFICATE := platform

# 使用共享签名
LOCAL_CERTIFICATE := shared

# 使用媒体签名
LOCAL_CERTIFICATE := media

# 使用测试签名
LOCAL_CERTIFICATE := testkey

# 使用预先签名的apk
LOCAL_CERTIFICATE := PRESIGNED

# 使用自定义签名
LOCAL_CERTIFICATE := mykey.keystore

如果没有指定签名，默认是testkey签名。

签名的区别

Android.mk文件中指定的签名是用来给预置的apk文件进行签名，以便在系统中运行或访问特定的权限。

• platform签名是用来给平台的核心应用签名，这些应用是完成系统的核心功能的，它们所在的进程UID是system，可以访问系统级别的API。例如，设置应用、电话应用等。
• media签名是用来给媒体相关的应用签名，这些应用是media/download的一部分，它们所在的进程UID是android.media，可以访问媒体相关的API。例如，相机应用、音乐应用等。
• shared签名是用来给可以和home/contacts进程共享数据的应用签名，它们所在的进程UID是android.uid.shared，可以访问共享数据相关的API。例如，桌面应用、联系人应用等。
• testkey签名是用来给测试阶段的应用签名，它们不需要特定的进程UID或权限，只能在开发版的系统中运行。例如，HelloWorld应用等。
• PRESIGNED签名是用来给预先签名的apk文件进行签名，它们不需要再次签名，可以直接安装到系统中。例如，第三方应用等。
• <keystore_file>签名是用来给自定义签名文件进行签名，它们可以指定任意的keystore文件或路径。例如，mykey.keystore等。

总结

在Android系统开发中，预置APK和SO文件，以及指定签名，是常见的操作。理解这些操作的方法和注意事项，可以帮助更好地进行Android系统开发。本文介绍了如何在Android.mk文件中预置APK和SO文件，并介绍了如何指定不同类型的签名。希望这篇文章对你有所帮助，如果你有任何问题，欢迎在评论区留言。