React Native从0.62.2升级到0.69.12时编译失败求助

问题本质 #

编译报错核心是多个第三方库未适配RN 0.69版本，或手动注册的Package代码与RN 0.60+引入的自动链接机制冲突，导致Java包找不到。涉事库包括：

• react-native-orientation
• react-native-version-number
• react-native-splash-screen
• react-native-document-picker
• react-native-doc-viewer

分步解决方案 #

1. 升级涉事第三方库到RN 0.69兼容版本 #

每个库必须升级到支持RN 0.60+（尤其是0.69）的版本，推荐版本：

• react-native-splash-screen：v3.2.0+
• react-native-version-number：v0.3.6+
• react-native-document-picker：v8.0.0+
• react-native-doc-viewer：v2.15.0+
• 特殊处理：react-native-orientation已停止维护，直接替换为活跃维护的分支：

  yarn remove react-native-orientation
  yarn add react-native-orientation-locker
  

2. 彻底清理缓存与依赖 #

执行以下命令清除所有缓存，确保依赖重新安装：

# 清理Node.js依赖与缓存
rm -rf node_modules yarn.lock package-lock.json
yarn cache clean
yarn install

# 清理Android构建缓存
cd android
./gradlew clean
cd ..

# 重置RN打包缓存
npx react-native start --reset-cache

3. 移除手动注册的Package代码 #

RN 0.60+支持自动链接，无需手动在MainApplication.java中注册Package：

• 打开android/app/src/main/java/.../MainApplication.java，删除：
  • 涉事库的所有import语句：

    import com.github.yamill.orientation.OrientationPackage;
    import com.apsl.versionnumber.RNVersionNumberPackage;
    import org.devio.rn.splashscreen.SplashScreenReactPackage;
    import com.reactnativedocumentpicker.ReactNativeDocumentPicker;
    import com.reactlibrary.RNReactNativeDocViewerPackage;
    

  • getPackages()方法中的对应实例化代码：

    new OrientationPackage(),
    new RNVersionNumberPackage(),
    new SplashScreenReactPackage(),
    new ReactNativeDocumentPicker(),
    new RNReactNativeDocViewerPackage(),
    

• MainActivity.java中保留SplashScreen的调用，但需确认库版本是否有API变更，如有则参考库文档调整。

4. 确认自动链接生效 #

执行自动链接命令，确保所有库正确关联到Android项目：

npx react-native link

部分库可能需要额外配置（如react-native-splash-screen需在AndroidManifest.xml中添加启动页配置），请参考对应库的最新文档完成配置。

5. 重新编译项目 #

完成上述步骤后，重新编译Android项目：

npx react-native run-android

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