Android Studio 中 variant.getExternalNativeBuildTasks() API 已弃用：升级到新 API 的全面指南

Android Studio 中 variant.getExternalNativeBuildTasks() API 的弃用：一个全面指南

引言

在 Android Studio 3.3 及更高版本中，variant.getExternalNativeBuildTasks() API 已弃用，并被**variant.getExternalNativeBuildProviders()** 所取代。它将在 2019 年底之前彻底移除。本文将深入探讨弃用的原因、新 API 的优点，并提供一个迁移指南，帮助你无缝过渡到新 API。

原因和好处

variant.getExternalNativeBuildTasks() API 已弃用的主要原因是性能和灵活性问题。variant.getExternalNativeBuildProviders() 提供了以下好处：

• 更好的性能： 它允许并行执行 Native 构建任务，从而提高了构建速度。
• 更大的灵活性： 它允许对 Native 构建提供程序进行更精细的控制，提供更多定制选项。

迁移指南

要迁移到 variant.getExternalNativeBuildProviders() , 请按照以下步骤操作：

1. 在 Gradle 构建脚本中，将 variant.getExternalNativeBuildTasks() 替换为 variant.getExternalNativeBuildProviders() 。
2. 检查你的 Native 构建任务是否需要任何修改，以与新的 API 兼容。
3. 如果你的项目使用 Kotlin，确保更新 Kotlin Gradle 插件到 1.3.60 或更高版本。

示例

以下是使用新 API 的示例：

applicationVariants.all { variant ->
    variant.outputs.all {
        outputFileName = "${variant.name}-${variant.versionName}.apk"
    }

    // 编译并打包原生库
    variant.externalNativeBuildProviders.each { provider ->
        provider.compilationFinished { result ->
            if (!result.failed) {
                copyNativeLibsFrom(provider.outputDirectory)
            }
        }
    }
}

常见问题解答

1. 为什么 variant.getExternalNativeBuildTasks() API 被弃用？

   • 为了提高性能并提供更大的灵活性。

2. variant.getExternalNativeBuildProviders() API 有什么好处？

   • 更快的构建速度和对 Native 构建任务的更多控制。

3. 如何迁移到 variant.getExternalNativeBuildProviders() API？

   • 按照迁移指南中的步骤操作。

4. 我需要更新 Kotlin Gradle 插件吗？

   • 如果你的项目使用 Kotlin，你需要更新到 1.3.60 或更高版本。

5. 我需要修改我的 Native 构建任务吗？

   • 检查你的任务，以确保它们与新 API 兼容。

结论

variant.getExternalNativeBuildTasks() API 的弃用是 Android Studio 中的一项重大变化。迁移到 variant.getExternalNativeBuildProviders() API 对于提高构建性能和灵活性至关重要。通过遵循迁移指南和利用新 API 的好处，你可以无缝过渡到 Android Studio 的最新版本。