如何在Android Studio中集成旧版Google地图？解决Gradle插件报错

有一个开发2年的Android旧项目，想要集成Google地图，使用的依赖为implementation 'com.google.android.gms:play-services-maps:15.0.1'。但在配置module的build.gradle时，应用插件apply plugin: 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin:2.0.1'出现报错，完整错误信息如下：

Exception is:
org.gradle.api.GradleScriptException: A problem occurred evaluating project ':app'.
...（省略中间堆栈信息）
Caused by: org.gradle.api.plugins.UnknownPluginException: Plugin with id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin:2.0.1' not found.
...（省略后续堆栈信息）

核心问题 #

插件ID格式错误——版本号不应该包含在插件ID中，Gradle无法识别带版本号的插件ID，导致找不到插件。

修复步骤 #

1. 修改项目根目录的build.gradle（Project级），添加插件的classpath依赖并指定版本：

   buildscript {
       repositories {
           google()
           mavenCentral()
       }
       dependencies {
           // 保留原有其他classpath依赖，新增以下行
           classpath 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin:2.0.1'
       }
   }
   

2. 修改模块目录的build.gradle（App级），修正插件应用语句，去掉版本号：

   // 替换原错误语句
   apply plugin: 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
   

3. 点击Android Studio的"Sync Now"按钮同步项目，重新执行构建。

额外适配旧项目注意事项 #

由于项目是2年前的旧项目，Gradle版本可能较低：

• 若同步时仍报错，检查根目录gradle/wrapper/gradle-wrapper.properties中的Gradle版本，插件2.0.1要求Gradle 7.0及以上；
• 若无法升级Gradle，可降级插件版本，比如使用classpath 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin:1.3.0'，该版本兼容更低的Gradle版本。

内容的提问来源于stack exchange，提问作者Sooraj S Nair