React Native项目配置Xcode Cloud构建时遇配置文件无法打开错误

问题详情 #

构建React Native项目时触发Xcode Cloud错误：

unable to open configuration settings file
Pods-XXX.debug.xcconfig:1

项目工作区结构：

|-- XXX
|-- Pods
|.  -- Podfile
|.  -- Targets Support Files
|.     -- Pods-XXX
|.        -- Pods-XXX.debug

排查与解决步骤 #

1. 核对Pod配置文件的命名与路径

从你的文件结构能看到，Pods/Targets Support Files/Pods-XXX/下的文件是Pods-XXX.debug，但Xcode明确要找带.xcconfig后缀的文件：

• 先在本地开发环境打开Pods目录，确认对应路径下的文件完整名称是否带有.xcconfig
• 如果本地是正常的.xcconfig文件，说明Xcode Cloud拉取代码后，Pod安装过程没有生成正确的配置文件，需要强制在构建前执行pod install

2. 给Xcode Cloud添加Pod安装前置步骤

Xcode Cloud默认不会自动执行pod install，必须手动加入构建前脚本：

1. 打开Xcode，进入Product > Scheme > Edit Scheme
2. 切换到Build标签，在Pre-actions区域点击+号，选择New Run Script Action
3. 脚本内容填写：

   cd "$SRCROOT"
   pod install
   

4. 在Provide build settings from下拉框中选择你的主Target（比如XXX）

3. 检查.gitignore规则是否误屏蔽xcconfig文件

如果Pod生成的xcconfig文件没被提交到仓库，Xcode Cloud拉取代码后自然找不到：

• 打开项目根目录的.gitignore文件，查找是否有*.xcconfig这类全局屏蔽规则
• 修改规则，允许Pods目录下的xcconfig文件被提交：

  /Pods/*
  !/Pods/Targets Support Files/
  !/Pods/Targets Support Files/**/*.xcconfig
  

4. 清理Xcode Cloud缓存后重新构建

缓存异常也可能导致文件路径识别错误：

• 登录Xcode Cloud的构建记录页面，删除所有失败的构建记录
• 触发一次全新的构建，确保拉取最新代码并重新执行完整的Pod安装流程

内容的提问来源于stack exchange，提问作者Edie W.