安装react-native-splash-screen后React Native出现res/layout/launch_screen.xml错误

错误分析 #

报错信息为undefined is not an object (evaluating 'SplashScreen.hide')，核心原因是SplashScreen模块未被正确识别，常见于导入错误、原生配置缺失或模块未完成链接。

修复步骤 #

• 核对导入语句
  在调用SplashScreen.hide()的文件中，确保导入路径正确：

  import SplashScreen from 'react-native-splash-screen';
  

  避免拼写错误或使用错误的相对路径。

• 处理模块链接（RN < 0.60版本）
  若你的React Native版本低于0.60，手动执行链接命令后重新编译：

  react-native link react-native-splash-screen
  

• 补全原生端配置

  • Android端：在MainActivity.java的onCreate方法中添加SplashScreen.show(this)，同时确认android/app/src/main/res/layout/launch_screen.xml文件存在且配置正常。
  • iOS端：在AppDelegate.m中导入#import "RNSplashScreen.h"，并在didFinishLaunchingWithOptions方法内添加[RNSplashScreen show]，检查LaunchScreen.storyboard的配置完整性。

• 清除缓存并重建项目
  执行以下命令清除缓存后重新运行项目：

  npm start -- --reset-cache
  react-native run-android # 对应iOS端执行 react-native run-ios
  

• 适配版本兼容性
  检查react-native-splash-screen版本与当前RN版本的适配性，安装对应兼容版本：

  npm install react-native-splash-screen@latest --save
  

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