Android 依赖项集成

背景

当 Corona 最初开放 Corona 市场 接受第三方内容时，插件开发者可以上传运行其插件所需的任何 .jar 文件。这导致提交的插件包含 Android 支持库 或 Google Play 服务 的版本。这些 .jar 文件的版本通常是插件最初开发时可用的最新版本，但在发布插件的新版本时，它们通常不会更新。

实际上，由于插件内部存在不同版本的库，因此在需要例如 Google Play 服务 8.4 版的插件与需要 Google Play 服务 4.2 版的另一个插件之间会发生不兼容的情况。

依赖插件

在 Corona 中，**依赖插件**是特殊的插件，用于解决多个插件可能具有的依赖项之间的版本不兼容问题。它们包含 Corona 支持的特定库最新版本的所有资源，以及有助于集成和正确使用库的任何其他资源。

如果您的项目依赖于常见的 Android 库，例如 Android 支持库 或 Google Play 服务，则需要包含一个依赖插件才能将该库合并到您的插件提交中。这是为了确保与可能依赖于这些库的其他插件兼容。

下表概述了 Corona 支持哪些库作为依赖插件。在开发满足上述条件的插件时，您应该针对依赖插件中封装的库版本对其进行测试。

compile 'com.android.support:[COMPONENT_NAME]:[VERSION_NUMBER]'

compile 'com.google.android.gms:play-services-[COMPONENT_NAME]:[VERSION_NUMBER]'

基础逻辑层

`shared.google.play.services.base` 依赖插件还包括一个基础逻辑层，该层将检查设备上的环境是否安全，以便使用 Google Play 服务，并尝试解决使用 Google Play 服务 `apk` 的任何问题。这是为了遵循 Google 关于确保设备具有 Google Play 服务 APK 的准则。尝试通过显示警报或通知来解决问题，其中包含有关问题及其解决方法的上下文。通过警报，最终用户可以点击按钮并被带到设备上的其他位置来解决问题。通过通知，点击它将启动应用程序并显示具有类似上下文的警报。

<meta-data android:name="usesGooglePlayServicesComponent[PascalCase_NAME_OF_COMPONENT]" android:value="true" />

<meta-data android:name="usesGooglePlayServicesComponentAds" android:value="true" />

包含依赖插件

要在 提交插件 时包含依赖插件，请在插件 `android/metadata.lua` 的`coronaManifest` → `dependencies`表中添加一个条目。

local metadata =
{
    plugin =
    {
        -- ...
    },
    coronaManifest = {
        dependencies = {
            ["shared.google.play.services.ads"] = "com.coronalabs",
        },
    },
}

return metadata

针对依赖项进行测试

大多数依赖插件只是包装了可从Android SDK 管理器访问的库分发。在这种情况下，只需在插件的`build.gradle (Module: plugin)`文件的 `dependencies` 块中包含正确版本的库就足够了。例如，依赖于CardView库的插件可以通过添加`compile 'com.android.support:cardview-v7:27.1.1'`到`build.gradle (Module: plugin)`文件的 `dependencies` 块中进行准确测试。

其他依赖插件可能需要额外的资源来进行测试。属于此类别的任何依赖插件都将在 Solar2D Native 发行文件中提供的插件压缩包中包含一个条目。对于具有此要求的依赖插件，请务必

• 包含名称与依赖插件相同的 `.jar` 文件。例如，`shared.google.play.services.base` 依赖插件包含一个 `shared.google.play.services.base.jar` 文件，该文件应包含在您的项目中。

• 将 `metadata.lua` 的 `manifest` 表的内容合并到您项目的 `AndroidManifest.xml` 中。需要合并的部分应包含一个注释，将其标识为依赖插件包名称的一部分，例如`-- For share-google-play-services-base package`。但是，为不同包指定的任何 XML 块，例如`-- From play-services-basement package`不需要手动添加 — 当您添加`compile 'com.google.android.gms:play-services-base:15.0.1'`到`build.gradle (Module: app)`文件的 `dependencies` 块中进行准确测试。

• 的 `dependencies` 块时，这些部分将包含在已编译的应用程序中。将依赖插件包的任何资源添加到您的项目中。如果依赖插件在 `resources` 文件夹中包含多个包，请查找包含依赖插件包名称的 `package.txt` 文件，并将 `res` 文件夹的内容添加到您项目的 `res` 文件夹中。

依赖插件链

正如您的插件可能依赖于依赖插件一样，依赖插件本身也可能依赖于其他依赖插件。以下流程图说明了依赖插件之间的链式关系：

依赖插件和权限

使用依赖插件时，某些权限可能会自动添加到您的应用中。下表说明了为哪些依赖插件添加了哪些权限。