修改App Bundle ID时，Firebase及本地项目需执行哪些变更？

Got it, let's break down every step you need to take when switching your app's Bundle ID—covering both your local project setup and the Firebase console, plus the key question about the google-services.json file.

一、本地项目修改步骤 #

Android 项目 #

• 打开你的Android项目，找到模块级别的 app/build.gradle 文件
• 将 applicationId 字段更新为新的Bundle ID（比如把 com.yourold.app 改成 com.yournew.app）
• 如果你用Flutter这类跨平台框架，还要检查 android/app/src/main/AndroidManifest.xml 里的 package 属性，确保它和新的 applicationId 一致
• 同步Gradle项目（点击Android Studio右上角的同步按钮），然后清理并重新构建项目

iOS 项目 #

• 在Xcode中打开项目，选中根项目节点，切换到「General」标签页的「Identity」区域
• 把「Bundle Identifier」字段改成新的ID
• 针对Flutter用户，还要确认 ios/Runner/Info.plist 里的 CFBundleIdentifier 值和Xcode中的设置匹配
• 清理项目（快捷键Cmd+Shift+K），再重新构建确保变更生效

二、Firebase控制台操作 #

这里要划重点：Firebase不允许直接修改已注册App的Bundle ID，所以你得按下面的步骤来：

1. 登录Firebase控制台，打开你的目标项目
2. 点击左侧侧边栏顶部的齿轮图标（项目设置）
3. 在「Your apps」区域，点击「Add app」并选择对应的平台（Android/iOS）
4. 输入新的Bundle ID，填写可选的App昵称等信息，然后点击「Register app」
5. 后续的初始化步骤可以直接跳过——我们只需要完成新App的注册
6. 如果旧的Bundle ID不再使用，可以移除旧App：在「Your apps」找到旧App，点击三点菜单选择「Remove app」（注意：此操作不可逆，确认不再需要再执行）

三、是否需要重新下载google-services.json？ #

必须重新下载。 google-services.json 文件和你的App Bundle ID是绑定的，旧文件里硬编码了原来的ID，切换新ID后会导致Firebase服务（比如认证、云消息推送、Firestore）无法正常工作。

获取更新文件的步骤：

1. 返回Firebase项目设置页面
2. 在「Your apps」区域找到刚注册的新App
3. 点击「Download google-services.json」（Android）或「GoogleService-Info.plist」（iOS）
4. 替换本地项目里的旧文件（Android放在app/目录下；iOS放在Runner文件夹里）

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