Quasar+Cordova构建Android项目时gradle:8.3.0依赖解析失败求助

问题背景 #

用Quasar框架搭配Cordova构建Android项目，执行调试命令 quasar d -m cordova -T android 时触发构建失败，错误指向Gradle插件、Gradle版本与JDK版本不兼容，更换Android Studio的Gradle和JDK后问题仍未解决。

错误详情 #

• 出错原因：
  配置根项目 'xxxx Management System' 时出现问题。

无法解析配置 ':classpath' 的所有构件。
无法解析 com.android.tools.build:gradle:8.3.0。
被以下项目依赖：
project :
未找到 com.android.tools.build:gradle:8.3.0 的匹配变体。消费者配置要求找到一个运行时使用的库，兼容Java 8，打包为jar，依赖外部声明，同时要求属性 'org.gradle.plugin.api-version' 的值为 '8.7'，但：
- 变体 'apiElements' 声明了一个打包为jar的库，依赖外部声明：
- 不兼容：该组件声明为编译时使用，兼容Java 11，而消费者需要运行时使用、兼容Java 8的组件
- 其他兼容属性：
- 未声明 org.gradle.plugin.api-version（要求值为 '8.7'）
- 变体 'javadocElements' 声明了一个运行时使用的组件，依赖外部声明：
- 不兼容：该组件是文档，而消费者需要的是库
- 其他兼容属性：
- 未声明元素打包格式（要求为jar）
- 未声明目标Java版本（要求兼容Java 8）
- 未声明 org.gradle.plugin.api-version（要求值为 '8.7'）
- 变体 'runtimeElements' 声明了一个运行时使用的库，打包为jar，依赖外部声明：
- 不兼容：该组件兼容Java 11，而消费者需要兼容Java 8的组件
- 其他兼容属性：
- 未声明 org.gradle.plugin.api-version（要求值为 '8.7'）
- 变体 'sourcesElements' 声明了一个运行时使用的组件，依赖外部声明：
- 不兼容：该组件是文档，而消费者需要的是库
- 其他兼容属性：
- 未声明元素打包格式（要求为jar）
- 未声明目标Java版本（要求兼容Java 8）
- 未声明 org.gradle.plugin.api-version（要求值为 '8.7'）

• 建议尝试：

查看变体匹配算法说明。
查看无匹配变体错误的详细解释。
使用 --stacktrace 选项获取堆栈跟踪。
使用 --info 或 --debug 选项获取更多日志输出。
使用 --scan 选项获取完整分析报告。
查看Gradle官方帮助文档。

构建失败，耗时1秒
命令执行失败，退出码1：E:\xxxx\xxxx\templates\src-cordova\platforms\android\tools\gradlew.bat cdvBuildDebug

App · 命令 "cordova" 执行失败，退出码：1
App · 已更新Cordova config.xml
App · ⚠️ [失败] Cordova CLI执行失败

核心原因 #

1. 版本兼容冲突：com.android.tools.build:gradle:8.3.0 要求JDK 11及以上版本，但当前项目配置为使用Java 8
2. 插件与Gradle版本不匹配：Gradle插件8.3.0与Gradle 8.7的API版本不兼容

解决方案 #

方案1：升级JDK并统一Gradle版本（推荐） #

• 安装Java 11或更高版本，配置系统环境变量 JAVA_HOME 指向该JDK路径
• 修改Cordova Android项目根目录下的 build.gradle 文件，更新Gradle插件版本为8.7.0（与Gradle 8.7兼容）：

  buildscript {
      repositories {
          google()
          mavenCentral()
      }
      dependencies {
          classpath 'com.android.tools.build:gradle:8.7.0'
      }
  }
  

• 修改 gradle/wrapper/gradle-wrapper.properties 文件，确保Gradle版本与插件匹配：

  distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-all.zip
  

方案2：降级Gradle插件适配Java 8（若必须保留Java 8） #

• 将 build.gradle 中的Gradle插件版本降级到7.4.2（兼容Java 8，支持Gradle 7.5+）：

  buildscript {
      dependencies {
          classpath 'com.android.tools.build:gradle:7.4.2'
      }
  }
  

• 对应修改 gradle-wrapper.properties 中的Gradle版本为7.5：

  distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-all.zip
  

方案3：通过Quasar配置强制指定环境参数 #

在Quasar项目根目录的 quasar.config.js 中添加Cordova配置，指定JDK路径和Gradle参数：

module.exports = function () {
  return {
    cordova: {
      android: {
        extraBuildArgs: [
          '-Dorg.gradle.java.home=/path/to/your/jdk11', // 替换为实际JDK11路径
          '--no-build-cache'
        ]
      }
    }
  }
}

验证步骤 #

1. 执行 quasar clean 清理项目缓存
2. 移除旧Android平台：cordova platform remove android
3. 重新添加兼容版本的Android平台：cordova platform add android@12.0.0（或最新兼容版本）
4. 再次运行调试命令：quasar d -m cordova -T android

内容的提问来源于stack exchange，提问作者Puppet Dr.