Ionic/Angular项目用Capacitor运行Android时Gradle构建失败求助

构建失败的直接原因是com.google.gms.google-services插件未找到与包名io.ionic.starter匹配的配置文件。另外你直接修改自动生成的capacitor-cordova-android-plugins目录下的配置不生效，是因为每次执行npx cap sync、npx cap run这类命令时，Capacitor都会重新生成该目录的所有内容，手动修改会被直接覆盖。

1. 修复构建失败问题 #

• 如果你项目不需要使用Firebase/Google相关服务：
  1. 删除android/app/src/目录下的google-services.json文件
  2. 删除安卓根目录build.gradle中dependencies块下的com.google.gms:google-services classpath依赖
  3. 删除android/app/build.gradle文件末尾的apply plugin: 'com.google.gms.google-services'代码
• 如果你项目需要使用Google服务：
  1. 打开项目根目录的capacitor.config.ts（或旧版capacitor.config.json），确认appId字段的值，默认值为io.ionic.starter
  2. 在Firebase控制台创建包名和上述appId完全一致的Android应用，下载新的google-services.json文件放到android/app/目录下即可

2. 解决Gradle配置被覆盖的问题 #

不要直接修改android目录下的自动生成文件，通过Capacitor的原生配置能力做持久化修改：

• 在项目根目录创建android/variables.gradle文件，写入你需要自定义的Gradle配置（比如替换jcenter为mavenCentral、移除flatDir配置），Capacitor执行同步操作时会自动合并该文件的配置，不会被覆盖
• 升级你项目使用的所有Capacitor插件到最新稳定版，新版官方Capacitor插件已经完全移除了jcenter依赖、也不再使用flatDir配置，升级后相关警告会自动消失

3. 临时验证方法 #

你可以直接用Android Studio打开项目的android目录，直接在IDE里执行构建操作，排除Capacitor自动同步覆盖配置的干扰，确认配置修改生效后再通过上述持久化方法同步到根目录配置即可。

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