React Native Bootsplash 在 iOS 多 Scheme 环境下的适配方案

在 React Native 0.74 版本中，使用 react-native-bootsplash 库时，开发者可能会遇到 iOS 应用启动闪退的问题。特别是在多 Scheme（多应用标识）的复杂项目配置中，这个问题尤为常见。本文将深入分析问题原因并提供完整的解决方案。

问题现象

当开发者在项目中配置了多个 Scheme 时，应用启动时会出现以下异常表现：

1. 应用启动时显示默认的空白启动图，而非自定义的 Bootsplash 启动图
2. 随后应用直接闪退崩溃
3. 即使在 AppDelegate.mm 文件中正确配置了新旧两种初始化方法，问题依然存在

根本原因分析

经过技术验证，这个问题主要源于多 Scheme 环境下的资源配置不完整。在 iOS 项目中，每个 Scheme 都有独立的配置，而 react-native-bootsplash 生成的资源文件默认只关联到主 Scheme。当使用其他 Scheme 运行时，系统无法正确找到启动图资源，导致崩溃。

完整解决方案

第一步：添加资源文件引用

1. 在 Xcode 中打开项目
2. 选择项目导航器中的主 Target
3. 切换到 "Build Phases" 选项卡
4. 展开 "Copy Bundle Resources" 部分
5. 点击 "+" 按钮添加 Bootsplash.storyboard 文件

第二步：配置每个 Scheme 的 Info.plist

对于项目中的每个 Scheme，都需要单独配置：

1. 在项目导航器中找到对应 Scheme 的 Info.plist 文件
2. 定位到 "UILaunchStoryboardName" 键
3. 将其值修改为 "BootSplash"（注意大小写敏感）

第三步：验证配置

完成上述修改后，建议执行以下验证步骤：

1. 清理项目构建缓存（Xcode 菜单 Product → Clean Build Folder）
2. 删除 Derived Data 目录
3. 重新构建并运行各个 Scheme

技术原理补充

iOS 的启动图机制依赖于 Info.plist 中的 UILaunchStoryboardName 配置。在多 Scheme 项目中，每个 Scheme 可以有自己的 Info.plist 文件，因此需要确保所有 Scheme 都正确引用了 Bootsplash 资源。同时，Bootsplash.storyboard 必须包含在所有 Scheme 的资源拷贝阶段，否则在打包时会被遗漏。

最佳实践建议

1. 对于新项目，建议在创建初期就配置好所有 Scheme 的启动图设置
2. 定期检查各个 Scheme 的配置一致性，特别是在添加新 Scheme 时
3. 考虑使用 xcconfig 文件统一管理多个 Scheme 的公共配置
4. 在团队协作环境中，将这些配置变更纳入版本控制系统

通过以上方案，开发者可以彻底解决 react-native-bootsplash 在多 Scheme 环境下的适配问题，确保应用在所有配置下都能正常显示启动图并稳定运行。