安装react-native-reanimated后run-android报checkDebugAarMetadata错误及模块解析失败问题

问题1：安装默认版本后执行 npx react-native run-android 出现:app:checkDebugAarMetadata执行失败错误 #

解决步骤： #

• 先确认本地React Native版本，react-native-reanimated对RN版本有严格适配要求，禁止直接安装latest版本，需安装和RN版本匹配的稳定版：
  • RN 0.64.x 适配 reanimated 2.2.x稳定版
  • RN 0.65.x 适配 reanimated 2.3.x稳定版
  • RN 0.66及以上版本 适配 reanimated 2.4.x及以上稳定版
• 卸载当前已安装的所有reanimated版本：

  npm uninstall react-native-reanimated
  # 如使用yarn则执行 yarn remove react-native-reanimated
  

• 清除本地缓存：删除项目根目录下的node_modules文件夹、package-lock.json（或yarn.lock）文件，执行npm cache clean --force
• 安装匹配的稳定版，以RN 0.65版本为例：

  npm install react-native-reanimated@2.3.1 --save
  

• 配置Babel插件：打开项目根目录下的babel.config.js，添加reanimated专属插件：

  module.exports = {
    presets: ['module:metro-react-native-babel-preset'],
    plugins: ['react-native-reanimated/plugin'],
  };
  

• 安卓端配置检查：打开android/gradle.properties文件，确认以下两行配置存在，不存在则手动添加：

  android.useAndroidX=true
  android.enableJetifier=true
  

• 重新构建项目：先执行安卓清理命令，再重启Metro并启动项目：

  # 清理安卓构建缓存
  cd android && ./gradlew clean
  # Windows环境执行 cd android && gradlew clean
  
  # 回到根目录重启Metro并清空缓存
  cd .. && npx react-native start --reset-cache
  
  # 新开终端执行启动命令
  npx react-native run-android
  

问题2：安装2.3 alpha3版本后提示无法解析./Hooks模块错误 #

原因： #

alpha为未正式发布的测试版本，本身存在文件缺失、兼容性未适配的bug，不适合常规开发使用。

解决步骤： #

• 卸载该测试版本，按照上述问题1的步骤安装和RN版本匹配的稳定版即可
• 若安装稳定版后仍出现模块找不到报错，直接执行npx react-native start --reset-cache清空Metro缓存即可解决

注意：所有标注alpha、beta的测试版本均未经过全场景兼容性验证，非必要不要安装使用

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