使用Cordova构建APP遇依赖缺失及gradlew.bat构建失败问题求助

1. 校验Gradle与Cordova版本兼容性 #

Cordova对Gradle版本有严格适配要求，并非本地高版本就能直接兼容：

• 执行cordova info查看当前Cordova及Android平台版本
• 匹配对应Cordova Android平台要求的Gradle版本（比如Cordova Android 12.x建议用Gradle 7.4.2+，暂不直接适配Gradle 8.x）

2. 强制统一项目依赖版本 #

避免手动修改build.gradle导致的版本冲突，通过Cordova配置文件指定：

• 在项目根目录创建gradle.properties（无则新建），添加：

  org.gradle.java.home=你的JAVA_HOME绝对路径
  org.gradle.version=7.6.3  # 选与Cordova Android兼容的版本
  kotlin.version=1.8.22    # 对应Gradle版本的兼容Kotlin版本
  

• 或修改config.xml的Android平台配置：

  <platform name="android">
      <preference name="gradleVersion" value="7.6.3" />
      <preference name="kotlinVersion" value="1.8.22" />
  </platform>
  

3. 重置构建环境并刷新依赖 #

• 执行cordova platform remove android，再执行cordova platform add android@对应兼容版本，重置Android平台文件
• 进入platforms/android目录，执行gradlew.bat clean build --refresh-dependencies（Windows）或./gradlew clean build --refresh-dependencies（Mac/Linux），强制刷新所有依赖
• 执行cordova build android --verbose查看完整报错日志，定位具体缺失的依赖（如特定Android SDK版本、支持库），手动在SDK Manager中安装

4. 验证环境变量有效性 #

在命令行依次执行以下命令，确保路径无空格、无中文，版本匹配：

# Windows系统
echo %JAVA_HOME%
echo %ANDROID_HOME%
gradle -v
java -version

# Mac/Linux系统
echo $JAVA_HOME
echo $ANDROID_HOME
gradle -v
java -version

同时确认SDK Manager已安装项目targetSdkVersion对应的Android Platform、匹配版本的Build Tools

5. 排查插件兼容性 #

• 执行cordova plugin list查看所有插件，核对插件更新日志，确认是否支持当前Cordova及Gradle版本
• 尝试移除最近新增的插件，重新构建，排查是否为插件引发的依赖冲突

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