Xcode Build生成的.ipa可正常安装，Archive生成的.ipa无法安装如何解决？

核心成因 #

• 签名配置不一致：Build操作默认使用本地Debug环境自动匹配的开发签名，Archive导出时如果手动选择了错误的签名证书/描述文件，即便UDID在描述文件内，也可能因证书不匹配、权限校验不通过导致安装失败。
• 架构裁剪差异：Build操作默认仅生成当前连接设备对应的CPU架构，Archive导出时如果开启了设备定向裁剪、或误删了目标设备对应的架构，会导致设备无法识别安装包架构。
• Entitlements权限配置不匹配：Archive打包会默认读取项目Release配置的Entitlements文件，如果Release配置的权限（推送、关联域名、iCloud等）与签名描述文件允许的权限不一致，会触发签名校验失败。
• Bitcode配置问题：如果项目开启了Bitcode，Archive导出时选择包含Bitcode，但项目依赖的第三方库不支持Bitcode，会导致安装包运行校验失败。
• 导出选项错误：Archive导出时如果选错分发类型，比如选择了App Store分发而非开发/Ad Hoc分发，即便包含对应UDID也会安装失败。

解决方案 #

• 校验签名配置：右键Archive包选择显示包内容，进入Products/Applications找到对应app文件，再次右键显示包内容，找到embedded.mobileprovision文件，在终端执行security cms -D -i embedded.mobileprovision，和Build生成的IPA内的描述文件做对比，确认证书、UDID、权限配置完全一致。同时确认Archive导出时选择的是开发/Ad Hoc分发，而非App Store分发。
• 检查架构配置：在项目Build Settings中确认Build Active Architecture Only的Release配置设为NO，同时Architectures配置包含目标设备对应的架构（常规iOS设备为arm64），导出IPA时不要勾选针对特定设备的裁剪选项。
• 校验Entitlements权限：对比Build和Archive两种模式下的CODE_SIGN_ENTITLEMENTS配置是否一致，同时确认描述文件支持的权限和Entitlements文件内声明的权限完全匹配，无多余权限项。
• 关闭Bitcode测试：如果项目开启了Bitcode，临时在Build Settings中将Enable Bitcode的Release配置改为NO，重新Archive导出测试是否可以正常安装。
• 清除缓存重试：删除Xcode缓存目录~/Library/Developer/Xcode/DerivedData，重启Xcode后重新Archive导出。

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