第三方 Android 库

本指南介绍了如何在应用程序包中包含第三方库。有许多库提供了对您的应用程序可能有用的 API。

先决条件

本指南假定使用 androiddeployqt 工具构建部署包。当使用 Qt Creator 进行构建和部署时，androiddeployqt 在后台使用，因此这也适用于使用 Qt Creator 进行开发。本指南不解释如何访问项目包含后的库 API。有关更多信息，请参阅 使用 Android 功能扩展 Qt。

将库添加到 Android 项目

您需要做的第一件事是将库文件复制到您的项目中。库的内容必须无修改地复制到打包目录中，即复制到由 QT_ANDROID_PACKAGE_SOURCE_DIR 设置的路径。默认情况下，这是项目源根目录下名为 android 的目录。有关更多信息，请参阅 Android 库。

如果您正在使用 Qt Creator，您可以通过选择 项目 > 构建 > 构建 Android APK > 创建模板 快速设置打包目录结构。这将为您创建一个 Android 包自定义 目录。将库目录复制到 "<target_src>/android/libs/" 中。

添加本地共享库

要添加本地共享库，您可以使用 CMake 的属性 QT_ANDROID_EXTRA_LIBS 或 qmake 的 ANDROID_EXTRA_LIBS，这可以将库打包到 Android 包中。

添加 .jar 或 .aar 库

默认情况下，Qt for Android 可以使用路径 "<target_src>/android/libs/" 中找到的 .jar 或 .aar 库。Qt 在 Android 构建使用的 Gradle 文件中具有以下规则

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar', '*.aar'])
    ...
}

添加库项目

有一个名为 CustomLibrary 的库，类似于前面的方法，将库项目复制到您的打包目录 "<target_src>/android/libs/" 中，然后创建一个包含以下内容的文件 settings.gradle

include ':libs:CustomLibrary'

然后，在 dependencies 块中添加依赖项到 build.gradle 文件中

dependencies {
    ...
    implementation project(":libs:CustomLibrary")
    ...
}

有关将库添加到Android项目的更多信息，请参阅添加构建依赖关系 Android 文档。