Android Gradle Plugin 3.5.0(2019 年 8 月)

Android Gradle 插件 3.5.0 与 Android Studio 3.5 一同发布,是一个主要版本,也是 Project Marble 的成果。Project Marble 专注于改进 Android 开发者工具的三个主要领域:系统健康状况、功能完善度和错误修复。值得注意的是,提高项目构建速度是本次更新的主要重点。

有关这些和其他 Project Marble 更新的信息,请阅读 Android 开发者博客文章或下文各部分。

此版本 Android 插件需要满足以下条件:

最低版本 默认版本 备注
Gradle 5.4.1 5.4.1 要了解更多信息,请参阅更新 Gradle
SDK Build Tools 28.0.3 28.0.3 安装配置 SDK Build Tools。

3.5.4(2020 年 7 月)

此次次要更新支持兼容 Android 11 的新默认设置和功能,包括软件包可见性

有关详细信息,请参阅4.0.1 版本说明

3.5.3(2019 年 12 月)

此次次要更新支持 Android Studio 3.5.3,包含多项错误修复和性能改进。

3.5.2(2019 年 11 月)

此次次要更新支持 Android Studio 3.5.2,包含多项错误修复和性能改进。要查看值得注意的错误修复列表,请阅读版本更新博客中的相关文章。

3.5.1(2019 年 10 月)

此次次要更新支持 Android Studio 3.5.1,包含多项错误修复和性能改进。要查看值得注意的错误修复列表,请阅读版本更新博客中的相关文章。

增量注解处理

数据绑定注解处理器支持增量注解处理,前提是您在 gradle.properties 文件中将 android.databinding.incremental 设置为 true。此优化可提升增量构建性能。如需查看支持优化的注解处理器的完整列表,请参阅增量注解处理器表格。

此外,KAPT 1.3.30 及更高版本也支持增量注解处理器,您可以通过在 gradle.properties 文件中添加 kapt.incremental.apt=true 来启用此功能。

可缓存的单元测试

当您通过将 includeAndroidResources 设置为 true 来启用单元测试以使用 Android 资源、素材资源和清单时,Android Gradle 插件会生成包含绝对路径的测试配置文件,这会破坏缓存的可重定位性。您可以通过在 gradle.properties 文件中加入以下内容,指示插件改为使用相对路径生成测试配置,这可使 AndroidUnitTest 任务完全可缓存:

      android.testConfig.useRelativePath = true
    

已知问题

  • 使用 Kotlin Gradle 插件 1.3.31 或更早版本时,在构建或同步项目时可能会看到以下警告:

              WARNING: API 'variant.getPackageLibrary()' is obsolete and has been replaced
                      with 'variant.getPackageLibraryProvider()'.
              
            

    要解决此问题,请将插件升级到 1.3.40 或更高版本。