含HTML模块的LibGDX项目升级Gradle 8.0.1遇类加载错误求助

原因分析 #

Gradle 8.0+移除了内部类org.gradle.api.internal.artifacts.dsl.dependencies.DependencyFactory$ClassPathNotation，而LibGDX 1.11.0的HTML模块依赖的旧版GWT Gradle插件仍在引用这个已被移除的类，导致加载失败。

具体修复步骤 #

1. 更新HTML模块的GWT Gradle插件 #

打开项目中HTML模块的build.gradle文件，替换原有插件引用为兼容Gradle 8.x的版本：

// 替换原有的 apply plugin: "gwt" 写法
plugins {
    id "dev.gradleplugins.gwt" version "1.1.0"
    id "war"
}

2. 调整GWT SDK依赖配置 #

在同一个build.gradle文件的gwt配置块中，修改gwtSdk的赋值方式：

gwt {
    // 替换原有的 gwtSdk "com.google.gwt:gwt-sdk:2.9.0" 写法
    gwtSdk = "com.google.gwt:gwt-sdk:2.9.0"
    // 保留原有其他配置（如modules、devMode参数等）
}

3. 同步Gradle项目 #

点击Android Studio的「Sync Project with Gradle Files」按钮，等待同步完成即可。

备选方案：升级LibGDX版本 #

如果插件调整后仍有兼容问题，可直接将LibGDX版本升级到1.12.0或更高（这些版本已适配Gradle 8.x）：
打开项目根目录的build.gradle文件，更新gdxVersion变量：

ext {
    gdxVersion = '1.12.0'
    // 同步更新其他LibGDX相关依赖版本（如box2dlights、ashley等）
}

完成后同步Gradle项目即可。

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