如何在 AOSP 项目中使用我预建的 c++ 静态/共享库

Question

我想使用我的 static 或共享的预建库libmylib.so or libmylib.a 。 我的构建目标是 Hikey960 设备。 我成功构建了纯 aosp 项目并闪存到 Hikey960 设备。 接下来我想使用我的libmylib.so /frameworks/av/media/libaudioclient/AudioTrack.cpp

设置 1

我将mylib目录创建到/system并复制了预构建的库。

|-- Andoird.mk
|-- arm64-v8a
|   |-- shared
|   |   `-- Release
|   |       `-- libmylib.so
|   `-- static
|       `-- Release
|           `-- libmylib.a
|-- armeabi
|   |-- shared
|   |   `-- Release
|   |       `-- libmylib.so
|   `-- static
|       `-- Release
|           `-- libmylib.a
|-- armeabi-v7a
|   |-- shared
|   |   `-- Release
|   |       `-- libmylib.so
|   `-- static
|       `-- Release
|           `-- libmylib.a
|-- include
|   `-- mylib.h
|-- x86
|   |-- shared
|   |   `-- Release
|   |       `-- libmylib.so
|   `-- static
|       `-- Release
|           `-- libmylib.a
`-- x86_64
    |-- shared
    |   `-- Release
    |       `-- libmylib.so
    `-- static
        `-- Release
            `-- libmylib.a

第2步

我在/system/mylib中创建了Android.mk文件，如下所示

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := mylib
LOCAL_SRC_FILES := system/mylib/$(TARGET_ARCH_ABI)/shared/Release/libmylib.so
LOCAL_EXPORT_C_INCLUDES:= include
include $(PREBUILT_SHARED_LIBRARY)

步骤 3

我将libmylib行插入到shared_libs: [在frameworks/av/media/libaudioclient/Android.bp中如下

cc_library_shared {
    name: "libaudioclient",

    aidl: {
        export_aidl_headers: true,
        local_include_dirs: ["aidl"],
        include_dirs: [
            "frameworks/av/media/libaudioclient/aidl",
        ],
    },

    srcs: [
        // AIDL files for audioclient interfaces
        // The headers for these interfaces will be available to any modules that
        // include libaudioclient, at the path "aidl/package/path/BnFoo.h"
        ":libaudioclient_aidl_private",
        ":libaudioclient_aidl",

        "AudioEffect.cpp",
        "AudioRecord.cpp",
        "AudioSystem.cpp",
        "AudioTrack.cpp",
        "AudioTrackShared.cpp",
        "IAudioFlinger.cpp",
        "IAudioFlingerClient.cpp",
        "IAudioPolicyService.cpp",
        "IAudioPolicyServiceClient.cpp",
        "IAudioTrack.cpp",
        "IEffect.cpp",
        "IEffectClient.cpp",
        "ToneGenerator.cpp",
        "PlayerBase.cpp",
        "RecordingActivityTracker.cpp",
        "TrackPlayerBase.cpp",
    ],
    shared_libs: [
        "libaudiofoundation",
        "libaudioutils",
        "libaudiopolicy",
        "libaudiomanager",
        "libbinder",
        "libcutils",
        "libdl",
        "liblog",
        "libmedia_helper",
        "libmediametrics",
        "libmediautils",
        "libnblog",
        "libprocessgroup",
        "libutils",
        "libvibrator",
        "libmylib",
    ],
    export_shared_lib_headers: ["libbinder"],

    local_include_dirs: ["include/media", "aidl"],
    header_libs: [
        "libaudioclient_headers",
        "libbase_headers",
        "libmedia_headers",
    ],
    export_header_lib_headers: ["libaudioclient_headers"],

    // for memory heap analysis
    static_libs: [
        "libc_malloc_debug_backtrace",
    ],
    cflags: [
        "-Wall",
        "-Werror",
        "-Wno-error=deprecated-declarations",
    ],
    sanitize: {
        misc_undefined : [
            "unsigned-integer-overflow",
            "signed-integer-overflow",
        ],
    },
}

Output

不幸的是，构建失败了：

error: frameworks/av/media/libaudioclient/Android.bp:39:1: "libaudioclient" depends on undefined module "libmylib"
06:32:39 soong bootstrap failed with: exit status 1

我认为在构建 aosp 时不包括我预构建的库文件。 如何将我的库包含到 aosp 构建中。 我应该在哪里指定 mylib？

而且我认为现在使用 soong 作为构建工具而不是 aosp 中的 nkd-build 所以我应该将上面创建的 Android.mk 文件更改为 Android.bp 吗？

如果您知道我的错误步骤，请告诉我该怎么做。 谢谢。

Answer 1

关于 Android.mk 和 Android.bp 文件，学习 Soong 可能是个不错的选择，因为 Google 正在慢慢将 make 文件转换为新的构建系统。

如果您想开始使用 Soong，这里是一个不错的起点：

• https://android.googlesource.com/platform/build/soong/+/master/README.md
• https://ci.android.com/builds/submitted/6350183/linux/latest/view/soong_build.html

---

关于添加自定义库。 由于 Android 的项目高音定制应该在供应商图像中完成。 如果您以后想更新 Android 框架，您将遇到的问题更少。 https://android-developers.googleblog.com/2017/05/here-comes-treble-modular-base-for.html

为了向供应商添加自定义库，您需要做几件事。 通过这些步骤，我成功地添加了预先构建的共享 (.so) 库。 仍然不知道如何将预构建静态（.a）库添加到系统中。

1. 为了将库添加到供应商分区，您需要创建列出所有添加库的文本文件。 从 Android N (7.0) 或更高版本开始，应用只能访问 NDK 库特定白名单上的库。

   示例文件：

   • 主要Android的system/core/rootdir/etc/public.libraries.android.txt
   • Android Wear 设备的system/core/rootdir/etc/public.libraries.wear.txt
   • system/core/rootdir/etc/public.libraries.iot.txt于 Android Things 设备的system/core/rootdir/etc/public.libraries.iot.txt

我们可以为供应商创建对应文件并在以下路径中创建它： /vendor/etc/public.libraries.txt

2. 接下来，从 Android 8.0 (Oreo) 开始，供应商中的本机库必须正确标记，以便应用程序可以访问它。 我们需要更新 SELinux 文件并为我们的库资源文件添加适当的上下文。

   • 创建目录vendor/[your_vendor]/sepolicy并添加“file_contexts”文件

   • 在 "file_contexts" -> vendor/lib(64)?/[your_lib_name]\\.so u:object_r:same_process_hal_file:s0为我们的文件资源添加标签。

   文件上下文标签遵循user:role:type:sensitivity 。 如果任何应用程序（包括第三方应用程序）需要访问，则库必须标记为same_process_hal_file 。 此规则在system/sepolicy/public/file.te

   • 记住在输入后添加新行。 否则下一个“file_contexts”文件的第一行将在构建过程中连接起来，你会得到错误。

   构建后，您可以检查您的“file_contexts”是否已正确添加。 所有 file_contexts 文件的输出在： out/target/product/generic_x86_64/obj/ETC/file_contexts.bin_intermediates/file_contexts.device.tmp 。 所有条目都以注释和 file_contexts 路径开头。 在我们的例子中，您应该在文件注释中找到“ vendor/[your_vendor]/sepolicy/file_contexts ”。

3. 在 [your_vendor] 目录中，您应该有您的 product.mk 文件。 您可以在/device找到此文件的示例。 更新您的 product.mk 文件并添加 BOARD_VENDOR_SEPOLICY_DIRS。 →

   BOARD_VENDOR_SEPOLICY_DIRS += \\ vendor/[your_vendor]/sepolicy \\

   在 SELinux 文档中，说明供应商 sepolicy 位于 BOARD_SEPOLICY_DIRS 路径下，但在 system/sepolicy/Android.mk 中，我们可以看到该字段已弃用：

   “BOARD_SEPOLICY_DIRS 之前用于供应商/odm sepolicy 定制。它已被 BOARD_VENDOR_SEPOLICY_DIRS（强制）取代......”

4. 在您的 product.mk 文件中添加库作为产品包。

PRODUCT_PACKAGES += \\ {your_library_name} \\

5. 构建和测试

现在您的库应该在 AOSP 中可见。

如果您想在供应商映像中使用此库，则需要在库 .mk / 中指定它。 bp 文件根据 VNDK。

查看此链接了解更多信息：

• https://source.android.com/devices/architecture/vndk/build-system
• https://source.android.com/devices/tech/config/namespaces_libraries#adding-additional-native-libraries
• https://source.android.com/security/selinux/build#android-o-build

Answer 2

bogus998 的回答对我帮助很大！

我一直在努力解决的一件事是，我假设 64 位版本的库就足够了，但在我们的例子中，构建失败了，因为缺少 32 位版本的库。 所以我创建了我们库的 32 位和 64 位版本，并将其包含到系统中，如下所示：

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := [your_library_name]
LOCAL_VENDOR_MODULE := true
LOCAL_MODULE_CLASS := SHARED_LIBRARIES
LOCAL_MODULE_SUFFIX := .so
LOCAL_SRC_FILES := arm64-v8a/[your_library_name].so
LOCAL_MULTILIB := 64
include $(BUILD_PREBUILT)

include $(CLEAR_VARS)
LOCAL_MODULE := [your_library_name]
LOCAL_VENDOR_MODULE := true
LOCAL_MODULE_CLASS := SHARED_LIBRARIES
LOCAL_MODULE_SUFFIX := .so
LOCAL_SRC_FILES := armeabi-v7a/[your_library_name].so
LOCAL_MULTILIB := 32
include $(BUILD_PREBUILT)

同样在我们的例子中，库将包含在system分区中，无论它位于vendor/external/[your_library_name]下，并添加LOCAL_VENDOR_MODULE:= true修复了这个问题。

Answer 3

我也面临同样的错误......我试图将 libaudioflinger.so 链接到 mylib.so

失败：out/soong/build.ninja out/soong/.bootstrap/bin/soong_build -t -l out/.module_paths/Android.bp.list -b out/soong -n out -d out/soong/build.ninja .d -globFile out/soong/.bootstrap/build-globs.ninja -o out/soong/build.ninja Android.bp 错误：frameworks/av/services/audioflinger/Android.bp:3:1：“libaudioflinger”取决于在未定义的模块“mylib”上

@Tom Choi，你的错误解决了吗？ 如果错误已修复，您可以在这里分享如何修复它吗？