Gradle7环境下Android构建配置官方文档是否过时的问询

你遇到的配置差异是 Gradle 7.0 与 Android Gradle Plugin（AGP）7.0 版本迭代带来的默认配置变更，既不是文档错误，也不是版本未完全支持，只是你查阅的官方文档、JitPack指引都是面向更早版本的配置说明。

1. 全局仓库配置差异 #

Gradle 6.8 版本正式推出 dependencyResolutionManagement 配置能力，用于统一管理全项目的依赖解析规则，优先级高于根目录 build.gradle 中 allprojects 块的配置。
AGP 7.0 之后创建的新项目，默认会在 settings.gradle 中开启该配置，并且默认设置为 repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)，该规则会直接屏蔽 allprojects 块内的仓库配置，所以你只能在 settings.gradle 中配置全局仓库。
如果需要沿用旧的配置写法，可以把上述规则改为 repositoriesMode.set(RepositoriesMode.PREFER_PROJECT)，就能恢复 allprojects 块配置的效力。

2. 插件引入写法差异 #

apply plugin: 'com.android.application' 是 Gradle 传统的动态插件应用语法，plugins {} 块是 Gradle 3.0 之后推出的静态插件 DSL 语法，两种语法长期兼容，不存在高低版本不能用的问题。AGP 7.0 之后的新项目默认使用更规范、编译性能更优的 plugins {} 写法，只是官方默认模板的变更，不是旧写法失效。

大部分公开的配置指引（包括部分未明确标注版本的官方文档）默认都是适配 AGP 4.2 及更早版本的项目，所以会和你当前使用的新版本默认配置产生差异。

内容的提问来源于stack exchange，提问作者razz