使用预构建库

NDK 支持使用预构建库，包括静态库和共享库。此功能主要有两个用例：

  • 无需分发源代码，即可将您自己的库分发给第三方 NDK 开发者。
  • 使用您自己的库的预构建版本来加快构建速度。

本页面介绍如何使用预构建库。

声明预构建库

您必须将您使用的每个预构建库声明为一个独立的模块。为此，请执行以下步骤：

  1. 为模块命名。此名称无需与预构建库本身的名称相同。

  2. 在模块的 Android.mk 文件中，将您提供的预构建库的路径分配给 LOCAL_SRC_FILES。指定相对于您的 LOCAL_PATH 变量值的路径。

  3. 根据您使用的是共享库 (.so) 还是静态库 (.a)，包含 PREBUILT_SHARED_LIBRARY 或 PREBUILT_STATIC_LIBRARY。

以下是一个简单示例，假设预构建库 libfoo.so 与描述它的 Android.mk 文件位于同一目录中。

LOCAL_PATH := $(call my-dir)

include $(CLEAR_VARS)
LOCAL_MODULE := foo-prebuilt
LOCAL_SRC_FILES := libfoo.so
include $(PREBUILT_SHARED_LIBRARY)

在此示例中，模块的名称与预构建库的名称相同。

构建系统会将您的预构建共享库复制一份到 $PROJECT/obj/local 中，另一份移除调试信息后复制到 $PROJECT/libs/<abi> 中。这里的 $PROJECT 是您项目的根目录。

从其他模块引用预构建库

要从其他模块引用预构建库，请在与这些其他模块关联的 Android.mk 文件中，将其名称指定为 LOCAL_STATIC_LIBRARIES 或 LOCAL_SHARED_LIBRARIES 变量的值。

例如，使用 libfoo.so 的模块描述可能如下所示：

include $(CLEAR_VARS)
LOCAL_MODULE := foo-user
LOCAL_SRC_FILES := foo-user.c
LOCAL_SHARED_LIBRARIES := foo-prebuilt
include $(BUILD_SHARED_LIBRARY)

这里，LOCAL_MODULE 是引用预构建库的模块名称；LOCAL_SHARED_LIBRARIES 是预构建库本身的名称。

为预构建库导出头文件

在 foo-user.c 中的代码依赖于通常位于头文件中的特定声明，例如随预构建库一起分发的 foo.h。例如，foo-user.c 可能包含类似以下内容的一行：

#include <foo.h>

在这种情况下，当构建 foo-user 模块时，您需要将头文件及其 include 路径提供给编译器。完成此任务的一个简单方法是在预构建模块定义中使用 exports。例如，只要头文件 foo.h 位于与预构建模块关联的 include 目录下，您就可以按如下方式声明它：

include $(CLEAR_VARS)
LOCAL_MODULE := foo-prebuilt
LOCAL_SRC_FILES := libfoo.so
LOCAL_EXPORT_C_INCLUDES := $(LOCAL_PATH)/include
include $(PREBUILT_SHARED_LIBRARY)

这里的 LOCAL_EXPORT_C_INCLUDES 定义确保构建系统导出预构建库的 include 目录路径，并将其添加到依赖于该库的模块的 LOCAL_C_INCLUDES 值中。

此操作允许构建系统找到必要的头文件。

调试预构建库

我们建议您提供包含调试符号的预构建共享库。NDK 构建系统总是会移除其安装到 $PROJECT/libs/<abi>/ 中的库版本中的符号，但您可以使用调试版本通过 ndk-gdb 进行调试。

为预构建库选择 ABI

您必须确保为目标 ABI 选择正确的预构建共享库版本。TARGET_ARCH_ABI 变量在 Android.mk 文件中可以指示构建系统使用适当版本的库。

例如，假设您的项目包含两个版本的库 libfoo.so：

armeabi/libfoo.so
x86/libfoo.so

以下代码片段展示了如何使用 TARGET_ARCH_ABI，以便构建系统选择适当版本的库：

include $(CLEAR_VARS)
LOCAL_MODULE := foo-prebuilt
LOCAL_SRC_FILES := $(TARGET_ARCH_ABI)/libfoo.so
LOCAL_EXPORT_C_INCLUDES := $(LOCAL_PATH)/include
include $(PREBUILT_SHARED_LIBRARY)

如果您将 armeabi 指定为 TARGET_ARCH_ABI 的值，构建系统将使用位于 armeabi 目录中的 libfoo.so 版本。如果您将 x86 指定为 TARGET_ARCH_ABI 的值，构建系统将使用位于 x86 目录中的版本。