React Native项目编译报错:':react-native-screens:configureCMakeDebug[arm64-v8a]'任务执行失败
React Native项目编译报错:':react-native-screens:configureCMakeDebug[arm64-v8a]'任务执行失败
我来帮你排查这个问题!你遇到的是React Native编译时找不到指定版本CMake的常见问题——即使已经通过SDK Manager安装了CMake,也可能因为版本不匹配、路径配置未生效或者Gradle缓存残留等原因触发报错,下面是几个可行的解决办法:
确认安装的CMake版本是否为3.22.1
打开SDK Manager → SDK Tools,先勾选右上角的Show Package Details(显示包详情),查看CMake的已安装版本。如果不是3.22.1,勾选对应版本完成安装,之后重启Android Studio再尝试编译。强制在Gradle配置中指定CMake路径与版本
可以直接在项目的Gradle配置文件里明确指定CMake的版本和路径,避免系统自动查找出错:- 打开项目根目录下的
android/build.gradle,在buildscript块中添加配置:buildscript { ext { cmakePath = "${System.env.ANDROID_SDK_ROOT}/cmake/3.22.1/bin/cmake" } // 保留原有其他配置 } - 或者在
android/app/build.gradle的android块中指定CMake版本:android { // 保留原有其他配置 externalNativeBuild { cmake { version "3.22.1" } } }
- 打开项目根目录下的
彻底清理缓存并重新同步项目
除了执行./gradlew clean,还可以手动删除这些目录来清除残留缓存:- 项目根目录下的
.gradle文件夹 android/.gradle和android/app/build文件夹
之后在Android Studio中点击「File → Sync Project with Gradle Files」,完成同步后再重新编译项目。
- 项目根目录下的
检查系统环境变量配置
确认你的系统PATH环境变量中包含了CMake 3.22.1的bin目录:- Windows路径示例:
C:\Users\<你的用户名>\AppData\Local\Android\Sdk\cmake\3.22.1\bin - Mac/Linux路径示例:
~/Library/Android/sdk/cmake/3.22.1/bin
如果未添加,手动将该路径加入PATH后,重启终端和Android Studio再试。
- Windows路径示例:
调整react-native-screens版本(备选方案)
若上述方法都无效,可能是当前react-native-screens版本对CMake有特殊依赖。可以尝试修改package.json中的react-native-screens版本号(比如降级到一个社区反馈更稳定的版本),执行npm install或yarn install更新依赖后,重新编译项目。
备注:内容来源于stack exchange,提问作者Kartikeya Gupta




