You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

React Native iOS端Splash Screen自动关闭问题求助

iOS端react-native-splash-screen自动隐藏问题的解决办法

针对你遇到的iOS启动页自动隐藏、不受SplashScreen.hide()控制的问题,以下是经过验证的解决步骤:

  • 修正AppDelegate.m代码位置
    确保[RNSplashScreen show];代码放在didFinishLaunchingWithOptions方法的最后一行,紧挨着return YES;,示例代码如下:

    - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
    {
      // 保留你原有的其他初始化代码
      
      // 必须放在return YES之前的最后位置
      [RNSplashScreen show];
      return YES;
    }
    

    如果代码位置靠前,可能被RN的初始化逻辑覆盖,导致自定义的splash视图无法正常挂载。

  • 确认LaunchScreen.storyboard的项目配置
    打开Xcode,选中项目target,进入General标签页,在App Icons and Launch Images区域,确认Launch Screen File已选择你自定义的LaunchScreen.storyboard。同时检查storyboard内的布局约束是否完整,避免视图加载失败导致splash无法显示。

  • 手动指定要显示的启动页storyboard
    如果默认的show方法无法识别你的LaunchScreen,改用带参数的方法指定具体名称:

    [RNSplashScreen showSplash:@"LaunchScreen" inRootView:window.rootViewController.view];
    

    注意这里的LaunchScreen是你的storyboard文件名(不需要带.storyboard后缀)。

  • 彻底清理缓存并重建项目
    执行以下操作解决缓存导致的异常:

    • 删除ios目录下的Pods文件夹和Podfile.lock文件
    • 重新执行pod install
    • 在Xcode中点击Product -> Clean Build Folder(快捷键Cmd+Shift+K)
    • 卸载设备上的App后重新运行项目
  • 检查版本兼容性
    确保react-native-splash-screen版本与你的RN版本匹配,RN 0.60+建议使用v3.2.0及以上版本,避免因版本不兼容导致的逻辑异常。

内容的提问来源于stack exchange,提问作者Anshif yaseen

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.09 07:40:33