React Native iOS端添加启动页后卡在启动页问题求助

针对你使用react-native-splash-screen时遇到的启动页卡住问题，结合你的操作步骤，给出以下具体排查和解决办法：

• 调整RNSplashScreen show的执行时机
  你当前把[RNSplashScreen show]放在super方法调用之前，部分React Native版本中，super application:didFinishLaunchingWithOptions:会完成RN核心初始化流程，提前调用show可能导致启动页无法正常响应后续的隐藏指令。建议修改代码如下：

  - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
  {
    self.moduleName = @"eCare";
    self.initialProps = @{};
    
    BOOL launchResult = [super application:application didFinishLaunchingWithOptions:launchOptions];
    [RNSplashScreen show]; // 移至super调用之后执行
    return launchResult;
  }
  

• 验证根页面的隐藏逻辑是否生效
  确保你在根组件中正确调用了隐藏方法，且该代码确实被执行：

  • 函数组件示例（添加日志确认）：

    import SplashScreen from 'react-native-splash-screen';
    
    useEffect(() => {
      console.log("准备隐藏启动页"); // 查看Xcode控制台是否输出该日志
      SplashScreen.hide();
    }, []);
    

  • 类组件示例：

    import SplashScreen from 'react-native-splash-screen';
    
    componentDidMount() {
      console.log("准备隐藏启动页");
      SplashScreen.hide();
    }
    

  如果控制台没有输出日志，说明根组件未正常挂载，需要检查路由配置或应用初始化逻辑是否存在阻塞。

• 检查iOS原生启动页配置

  • 确认LaunchScreen.storyboard已正确设置启动页内容，且Info.plist中UILaunchStoryboardName的值与你的启动页storyboard名称一致（默认是LaunchScreen）。
  • 确保RNSplashScreen的配置指向了正确的启动页，若你自定义了启动页，需在原生代码中指定对应的storyboard或xib。

• 确认依赖链接完整性
  自动链接可能存在偶发失败，手动检查Xcode项目：

  • 进入Build Phases → Link Binary With Libraries，确认已添加libRNSplashScreen.a。
  • 进入Build Settings → Header Search Paths，确认包含$(SRCROOT)/../node_modules/react-native-splash-screen/ios，且设置为recursive。

• 清理缓存重新构建
  缓存问题也可能导致异常，执行以下命令彻底清理后重新构建：

  # 重置React Native缓存
  npx react-native start --reset-cache
  
  # 清理iOS依赖和构建文件
  cd ios
  pod deintegrate
  pod install
  rm -rf build
  cd ..
  
  # 重新运行iOS应用
  npx react-native run-ios
  

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