You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

React Native执行npm run android报错,求助解决方法

问题解决步骤

1. 修复CMake 3.18.1未找到错误

  • 打开Android Studio,进入SDK Manager → SDK Tools,勾选「Show Package Details」,找到CMake 3.18.1版本并勾选,点击Apply完成安装。
  • 若已安装CMake,需确认其路径已加入系统环境变量PATH;或在项目的android/gradle.properties文件中添加配置:
    cmake.dir=/你的CMake安装路径/3.18.1
    
    替换为实际路径(比如Windows下可能是C:\Users\你的用户名\AppData\Local\Android\Sdk\cmake\3.18.1,Mac/Linux下是~/Library/Android/sdk/cmake/3.18.1)。

2. 解决「gradlew: command not found」

  • 切换到项目的android目录后,先给gradlew添加执行权限:
    chmod +x gradlew
    
  • 再执行清理命令(注意前缀./):
    ./gradlew clean
    
  • 若仍报错,直接用Android Studio打开项目根目录,它会自动下载并生成Gradle相关文件,完成后再执行清理操作。

3. 修复AGP版本、SDK XML不匹配及依赖错误

  • 版本匹配原则:不要随意修改Gradle/AGP版本,需与你当前的React Native版本对应。比如RN 0.7x系列对应AGP 7.3.x、Gradle 7.5左右,可参考项目默认配置调整。
    • 在android/build.gradle中调整AGP版本(com.android.tools.build:gradle的版本号)。
    • 在android/gradle/wrapper/gradle-wrapper.properties中调整Gradle版本(distributionUrl对应的版本)。
  • SDK XML不匹配:打开Android Studio的「Project Structure」→「Project」,确认SDK版本与项目build.gradle中compileSdkVersion、targetSdkVersion一致,点击「Sync Now」同步。
  • 依赖错误处理:
    1. 删除项目根目录的node_modules、package-lock.json,以及android目录下的.gradle文件夹。
    2. 重新安装依赖:npm install。
    3. 进入android目录执行:
      ./gradlew clean
      ./gradlew build --refresh-dependencies
      

内容的提问来源于stack exchange,提问作者Annie Ian

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.17 13:31:06