Azure Pipeline构建React Native iOS应用卡在编译LaunchScreen.storyboard

以下是针对Azure Pipeline构建React Native iOS卡在Linking MyApp/Compiling LaunchScreen.storyboard环节的常见排查点：

• 代理机器资源瓶颈
  链接（Linking）是Xcode构建中资源消耗较高的阶段，Azure Pipeline默认代理的CPU/内存配置可能低于你的本地开发机器，导致该阶段长时间无响应。可以尝试：

  • 切换至更高配置的自托管代理（Self-hosted Agent），匹配本地机器的硬件规格；
  • 在构建任务前添加资源监控步骤，确认代理的CPU、内存使用率是否接近饱和。

• Xcode环境与项目依赖不匹配
  虽然指定了Xcode 13.4.1，但代理机器上的iOS SDK可能存在缺失或损坏，或者项目中某些依赖（如第三方库）在该环境下的编译逻辑与本地有差异。可以：

  • 检查代理机器上/Applications/Xcode_13.4.1.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs目录下是否存在iPhoneOS15.5.sdk；
  • 在Pipeline中添加步骤，清理并重新安装Pods（pod deintegrate && pod install），确保依赖完全适配代理环境。

• 缓存与DerivedData冲突
  Pipeline的构建缓存可能包含旧的编译产物，导致链接或storyboard编译时出现死锁。建议：

  • 在Xcode构建任务前添加清理步骤，删除DerivedData目录（rm -rf ~/Library/Developer/Xcode/DerivedData）；
  • 在Xcode任务的actions中添加clean参数，改为clean build -verbose，强制清理后再构建。

• 手动签名的权限问题
  虽然证书部署完成，但链接阶段可能需要访问钥匙串中的签名身份，而Pipeline代理的钥匙串权限配置不足。可以：

  • 在证书安装任务后，添加钥匙串解锁步骤（security unlock-keychain -p $(KEYCHAIN_PASSWORD) login.keychain-db）；
  • 确保签名身份的权限设置为Allow all applications to access this item，避免链接时被权限弹窗阻塞（代理环境无交互，弹窗会导致任务挂起）。

• LaunchScreen.storyboard的资源依赖问题
  如果LaunchScreen引用了本地存在但代理机器上缺失的资源（如自定义字体、图片），或者storyboard的Release模式配置存在问题，会导致编译卡住。可以：

  • 检查项目中LaunchScreen.storyboard引用的所有资源是否都已提交到代码仓库；
  • 在Pipeline中添加步骤，验证资源文件的完整性（比如对比本地与代理上的资源目录）；
  • 尝试在本地使用xcodebuild命令模拟Pipeline的构建参数（xcodebuild clean build -workspace ios/MyApp.xcworkspace -scheme MyApp -configuration Release -sdk iphoneos15.5），看是否能复现问题。

• 构建命令参数优化
  当前的actions参数仅指定了build -verbose，可以补充参数避免潜在的阻塞：

  • 添加-derivedDataPath $(Build.ArtifactStagingDirectory)/DerivedData，指定DerivedData到临时目录，避免与其他任务冲突；
  • 移除-verbose（虽然会减少日志，但可能减少IO开销，先验证是否能完成构建，再逐步加日志排查）。

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