Xcode 12、iOS 14下集成Firebase后App无法安装至iPhone

错误本质 #

你碰到的-402652994安装报错，核心是iOS系统校验到新安装包的application-identifier权限值，和设备上已安装的同Bundle ID应用的对应值不匹配，系统直接拦截了覆盖安装流程。
这个问题和Firebase的代码逻辑本身没有直接关系，并非Firebase本身的功能缺陷，可以按以下步骤排查解决：

具体操作步骤 #

• 先把测试设备上同Bundle ID的旧应用全部卸载
  这是该报错最高发的触发原因：如果设备上之前用其他开发者证书、临时描述文件、不同Team账号装过同Bundle ID的应用，残留的应用记录会和当前新构建包的签名权限对不上，哪怕是全新创建的空测试项目，只要之前在这台设备上部署过同Bundle ID的版本，就会触发这个报错。
• 核对项目签名与权限配置
  Firebase的部分集成流程会自动联动修改项目的Capabilities配置，要是配置被意外篡改，会导致最终打包生成的application-identifier值不符合预期：
  • 打开项目的Signing & Capabilities面板，确认当前选中的描述文件对应的Team ID、Bundle ID和开发者后台的配置完全一致
  • 打开项目里的.entitlements文件，确认application-identifier的格式是<TeamID前缀>.<你的Bundle ID>，没有被集成脚本写入错误的前缀值
  • 如果用SPM集成Firebase，确认没有自动勾选Firebase附带的、你实际用不到的权限配置（比如Analytics组件默认关联的广告标识权限）
• 清理本地构建缓存后重新打包
  执行Product -> Clean Build Folder，删掉DerivedData目录下的项目构建缓存，重新选好匹配的签名证书后再尝试安装。

复现场景验证 #

你在M1芯片Mac mini、Intel架构iMac两套完全不同的编译环境上，都复现了一模一样的问题，基本可以排除本地环境偶发缓存的影响，属于固定的签名权限不匹配的配置类问题，按上面的步骤操作基本都能解决。

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