React Native构建失败：:app:configureCMakeDebug[arm64-v8a]任务执行出错

问题现象 #

执行sudo npm run android命令时应用安装失败，报错信息如下：

BUILD FAILED in 2s
error Failed to install the app. Command failed with exit code 1: ./gradlew app:installDebug -PreactNativeDevServerPort=8081 
FAILURE: Build failed with an exception. 
* 问题原因:
Execution failed for task ':app:configureCMakeDebug[arm64-v8a]'.

[CXX1214] /Users/hein/Documents/Projects/ScorpioApp/node_modules/react-native/ReactAndroid/cmake-utils/default-app-setup/CMakeLists.txt debug|arm64-v8a : 用户设置的minSdkVersion为22，但依赖库是基于24版本构建的 [//ReactAndroid/hermestooling]

核心原因 #

项目配置的最低SDK版本（minSdkVersion）为22，但依赖的Hermes工具库要求最低SDK版本为24，版本不匹配导致CMake配置任务执行失败。

解决方法 #

• 打开项目目录下的android/app/build.gradle文件
• 找到defaultConfig代码块中的minSdkVersion配置项
• 将其值从22修改为24或更高版本
• 重新执行sudo npm run android命令

额外排查手段 #

• 执行./gradlew app:installDebug --stacktrace查看完整堆栈跟踪，定位具体执行错误
• 执行./gradlew app:installDebug --info或--debug获取更详细的日志输出，排查细节问题
• 执行./gradlew app:installDebug --scan生成完整分析报告，深入诊断构建问题

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