React Native iOS多环境构建异常：命令行指定Scheme/配置失败

一、CLI指定Scheme后强制使用Debug配置的修复 #

React Native CLI的run-ios命令默认会追加-configuration Debug参数，导致即使指定了自定义Scheme，也会覆盖Scheme关联的配置。解决方式如下：

• 针对每个Scheme，明确指定对应的配置参数：
  • 开发环境：npx react-native run-ios --scheme appNameDev --configuration Debug
  • 预发布环境：npx react-native run-ios --scheme appNameStaging --configuration Staging
  • 生产环境：npx react-native run-ios --scheme appNameProd --configuration Release
• 优化构建脚本路径：将脚本中的$PATH_TO_GOOGLE_PLISTS替换为项目相对路径，比如${PROJECT_DIR}/GooglePlists（假设你的plist文件放在ios目录下的GooglePlists文件夹中），避免硬编码路径导致的文件复制失败。

二、Release/Staging构建后启动崩溃（OpenSSL缺失）的修复 #

崩溃日志显示DYLD无法找到OpenSSL.framework，这是第三方依赖（如Firebase）的框架嵌入或链接配置问题，按以下步骤排查：

1. 重新安装Pod依赖
   进入ios目录执行：

   pod deintegrate && pod install
   

   确保所有依赖的库（包括OpenSSL相关）都正确安装。

2. 检查Framework嵌入与链接配置
   打开Xcode，选中项目目标：

   • 进入Build Phases -> Link Binary With Libraries：确认OpenSSL.framework已添加，若没有则点击+搜索添加。
   • 进入Build Phases -> Embed Frameworks：添加OpenSSL.framework，并将Embed选项设置为Embed & Sign。

3. 修正Runpath搜索路径
   进入Build Settings，搜索Runpath Search Paths，确保包含以下路径：

   @executable_path/Frameworks
   @loader_path/Frameworks
   

   这两个路径是DYLD查找嵌入框架的核心路径，缺失会导致框架加载失败。

4. 同步自定义配置的Build Settings
   由于你自定义了Staging配置，需确认该配置的Build Settings是否正确继承了Release的框架相关配置：

   • 在Xcode的Build Settings界面，点击配置下拉菜单，选择Staging，检查Framework Search Paths、Runpath Search Paths等参数是否与Release一致。

5. 清理构建缓存

   • 执行React Native清理命令：npx react-native clean
   • 删除Xcode Derived Data：打开Xcode -> 偏好设置 -> 位置 -> Derived Data，点击箭头打开文件夹，删除当前项目的缓存目录
   • 重新执行构建命令

验证步骤 #

构建完成后，可通过以下方式确认配置正确：

• 找到构建生成的.app包（可在Xcode的Products目录右键选择"Show in Finder"），检查包内是否存在正确的GoogleService-Info.plist
• 查看.app包内的Frameworks目录，确认OpenSSL.framework已嵌入

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