从Cordova迁移到Capacitor后iOS出现同Bundle ID双应用问题

iOS判定同Bundle ID应用唯一性的核心逻辑 #

iOS判断两个应用是否为同一应用，不止依赖Bundle ID，核心看以下两个关键标识：

• 签名证书与Provisioning Profile：必须使用完全一致的签名身份（开发者账号、证书类型）及匹配的配置文件。如果Cordova版本用旧证书/配置文件，Capacitor版本用了新的（比如换了开发者账号、证书过期重生成后未同步配置），iOS会判定为不同应用。
• 版本号配置：当Bundle ID相同时，若Capacitor应用的CFBundleVersion（内部版本号）或CFBundleShortVersionString（显示版本号）低于/等于旧Cordova应用，部分非官方分发渠道（如企业分发、第三方测试工具）可能不会触发替换逻辑，但这不是核心原因，签名不一致才是最常见的诱因。

导致应用共存的常见原因 #

• 签名配置不匹配：
  • Cordova通常通过config.xml配置签名，而Capacitor默认使用Xcode项目的签名设置。如果Xcode中选择的开发者账号、证书、配置文件和旧应用不一致，哪怕Bundle ID相同，iOS也会将其视为独立应用。
  • 若旧应用用个人账号签名，新Capacitor应用用团队账号，即使Bundle ID一致也会被判定为不同应用。
• Xcode项目配置差异：
  • Capacitor生成的Xcode项目中，Info.plist的CFBundleDisplayName（应用显示名称）如果和旧应用不同，可能会让你误以为是新应用，但本质还是签名问题导致的共存。
• 分发渠道缓存：
  • 通过企业分发或第三方测试工具（如蒲公英、FIR）推送时，渠道缓存可能导致安装包未正确覆盖，可清理设备上的分发描述文件后重新安装。

解决步骤 #

1. 统一签名配置：
   • 打开Capacitor的Xcode项目，在Signing & Capabilities中，确保开发者账号、证书、配置文件和旧Cordova应用完全一致。可导出旧应用的签名证书和配置文件，导入当前开发环境使用。
2. 验证版本号：
   • 确保Capacitor应用的CFBundleVersion和CFBundleShortVersionString均高于旧Cordova应用的版本号，避免分发渠道因版本号问题拒绝替换。
3. 清理缓存与测试：
   • 删除设备上的旧应用后重新安装Capacitor版本，测试覆盖逻辑；若为企业分发，先删除设备上对应的企业分发描述文件再重新安装。

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