通过Azure DevOps发布iOS应用出现黑屏，Xcode发布正常该如何解决？

1. 架构配置兼容性排查 #

• 检查Azure Pipeline的Xcode任务中ARCHS参数配置：本地Xcode默认会根据发布目标自动匹配兼容架构，流水线如果硬编码架构参数，极有可能遗漏TestFlight目标设备需要的架构（比如遗漏arm64、错误包含x86_64模拟器架构）
• 验证流水线IPA包的架构支持：将流水线输出的IPA解压后，执行lipo -info 你的App名.app/你的App名命令查看支持的架构，和本地构建的输出结果做对比，确保二者架构完全一致
• 确认ENABLE_BITCODE配置和本地构建保持一致：如果你的App依赖了不支持bitcode的三方库，流水线开启bitcode编译会导致运行时启动闪退

2. 签名与配置文件匹配校验 #

• 确认流水线使用的发布配置文件（*.mobileprovision）和本地构建使用的是同一个，包含App所有用到的能力配置（比如推送权限、关联域、钥匙串访问组等）
• 检查Xcode任务中的CODE_SIGN_IDENTITY参数，确认使用的是Apple Distribution类型的发布签名证书，不要使用开发证书，也不建议在流水线构建中勾选「自动管理签名」选项，建议显式指定证书和配置文件ID

3. 构建配置参数差异排查 #

• 对比本地Xcode的Release构建配置和流水线Xcode任务的构建配置：重点核对Optimization Level、Strip Debug Symbols、Dead Code Stripping三个参数，流水线如果开启过度编译优化、错误剥离了必要符号，会导致启动时运行异常
• 确认流水线构建使用的Xcode版本和本地完全一致，不同版本Xcode的编译逻辑、内置SDK版本差异也会导致运行时闪退

4. 闪退日志精准定位 #

• 从TestFlight后台下载闪退日志，或者连接测试设备通过Xcode的「Devices and Simulators」功能查看闪退堆栈，定位具体崩溃点：如果是启动时动态库加载失败导致的闪退，大概率是动态库的签名、架构或者嵌入配置错误
• 检查流水线构建时是否正确嵌入了所有依赖的动态库，确认Embed & Sign配置在流水线构建时正常生效，没有出现动态库丢失或者签名无效的问题

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