MacOS下React Native集成reanimated后run-android失败求助

是否与Gradle版本有关？ #

这个问题和Gradle/AGP版本本身没有直接关联，核心原因是指定的NDK版本目录不完整（缺少source.properties文件）。不过AGP 8.x对NDK的依赖校验更严格，会直接抛出这个错误，旧版本可能不会触发，但根源还是NDK本身的安装问题。

解决步骤 #

• 检查并修复NDK安装
  打开Android Studio的SDK Manager，切换到「SDK Tools」标签，勾选「Show Package Details」，找到「NDK (Side by side)」：

  • 如果25.1.8937393未安装，直接勾选安装；
  • 如果已安装，先卸载该版本，再重新安装，确保下载过程无中断导致文件缺失。

• 指定React Native 0.73兼容的NDK版本
  React Native 0.73官方推荐的NDK版本是25.2.9519653，你可以在项目的android/build.gradle中统一指定：

  buildscript {
      ext {
          ndkVersion = "25.2.9519653"
      }
  }
  

  同时在android/app/build.gradle的defaultConfig中引用该版本：

  defaultConfig {
      ndkVersion rootProject.ext.ndkVersion
  }
  

• 清理构建缓存
  执行以下命令彻底清理缓存，避免旧配置干扰：

  cd android && ./gradlew clean
  rm -rf ~/.gradle/caches
  cd .. && npx react-native clean
  

  之后重新运行项目：npx react-native run-android

• 校验local.properties路径
  确保android/local.properties文件中的NDK路径指向完整安装的版本，示例：

  ndk.dir=/Users/username/Library/Android/sdk/ndk/25.2.9519653
  sdk.dir=/Users/username/Library/Android/sdk
  

  若不存在该文件，直接在android目录下创建并填写正确路径。

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