React Native构建时RNScreensPackage找不到错误的解决方法

• react-native-screens包未正确安装或版本不兼容：依赖缺失，或是版本与当前React Native版本不匹配，导致编译时找不到指定类文件。
• 自动链接机制失效：React Native的自动链接未将RNScreens的Android配置正确注入项目，使得自动生成的PackageList文件中存在无效引用。
• 缓存残留未清理彻底：虽然删除了模块文件夹、清理了Gradle，但自动生成的PackageList缓存、RN打包缓存等仍保留旧的引用信息。
• 项目配置冲突：Gradle配置中的依赖范围错误，或是第三方库与react-native-screens存在版本冲突，导致依赖无法正常加载。

• 重新安装适配版本的react-native-screens
  先卸载现有包再重新安装：

  # npm 方式
  npm uninstall react-native-screens
  npm install react-native-screens
  
  # yarn 方式
  yarn remove react-native-screens
  yarn add react-native-screens
  

  注意：务必确认安装的版本与你的React Native版本兼容，比如RN 0.70+可使用最新稳定版，低版本需选择对应兼容分支。

• 彻底清理缓存并重新链接
  执行以下命令完成全链路缓存清理与链接：

  # 清理前端依赖缓存
  rm -rf node_modules package-lock.json yarn.lock
  npm install
  
  # 清理Android构建缓存
  cd android && ./gradlew clean
  cd .. && rm -rf android/app/build .gradle
  
  # 重置React Native打包缓存并重启服务
  npx react-native start --reset-cache
  

  同时手动触发链接：

  npx react-native link react-native-screens
  

• 临时修正自动生成的PackageList（不推荐长期使用）
  打开android/app/build/generated/rncli/src/main/java/com/facebook/react/PackageList.java，删除以下两行：

  import com.swmansion.rnscreens.RNScreensPackage;
  // ...
  new RNScreensPackage()
  

  注意：此方法仅作临时应急，下次构建时自动生成的文件会覆盖修改，需彻底解决依赖问题。

• 检查Gradle配置正确性
  确认android/build.gradle的仓库配置包含必要源：

  allprojects {
      repositories {
          mavenCentral()
          maven { url 'https://www.jitpack.io' }
      }
  }
  

  同时检查android/app/build.gradle中是否存在依赖声明：

  dependencies {
      // ...
      implementation project(':react-native-screens')
  }
  

  若缺失则手动添加，之后重新执行构建。

• 验证依赖安装状态
  运行以下命令确认react-native-screens已正确安装：

  npm list react-native-screens
  # 或 yarn 用户执行
  yarn list react-native-screens
  

  输出结果需显示包已存在于node_modules中，且版本符合要求。

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