使用./gradlew wrapper升级Gradle未下载源码与Javadoc Jar的解决方法

方法一：通过构建脚本配置自动拉取源码和Javadoc #

在项目根目录的build.gradle（或build.gradle.kts）中添加以下配置，让Gradle自动从仓库获取对应版本的Gradle API源码与Javadoc：

Groovy DSL #

repositories {
    mavenCentral()
    gradlePluginPortal()
}

dependencies {
    implementation gradleApi()
    implementation gradleTestKit()
}

configurations.all {
    resolutionStrategy {
        // 指定Gradle API版本并开启源码、Javadoc下载
        eachDependency { DependencyResolveDetails details ->
            if (details.requested.group == 'org.gradle' && details.requested.name in ['gradle-api', 'gradle-test-kit']) {
                details.useVersion '7.5.1'
                details.selector.withSources()
                details.selector.withJavadoc()
            }
        }
    }
}

Kotlin DSL #

repositories {
    mavenCentral()
    gradlePluginPortal()
}

dependencies {
    implementation(gradleApi())
    implementation(gradleTestKit())
}

configurations.all {
    resolutionStrategy {
        eachDependency {
            if (requested.group == "org.gradle" && requested.name in listOf("gradle-api", "gradle-test-kit")) {
                useVersion("7.5.1")
                selector.withSources()
                selector.withJavadoc()
            }
        }
    }
}

配置完成后，执行./gradlew dependencies或直接在IDE中同步项目，Gradle会自动下载对应版本的源码包和Javadoc包到本地缓存。

方法二：手动下载并关联源码与Javadoc #

1. 找到Gradle官方Maven仓库中gradle-api的7.5.1版本，下载对应的gradle-api-7.5.1-sources.jar和gradle-api-7.5.1-javadoc.jar。
2. 将下载的文件放到本地Gradle缓存的对应目录：
   • 源码包路径：{home}/.gradle/caches/modules-2/files-2.1/org.gradle/gradle-api/7.5.1/[对应哈希目录]/gradle-api-7.5.1-sources.jar
   • Javadoc包路径：{home}/.gradle/caches/modules-2/files-2.1/org.gradle/gradle-api/7.5.1/[对应哈希目录]/gradle-api-7.5.1-javadoc.jar
     （哈希目录可通过查看已存在的gradle-api-7.5.1.jar所在的目录获取）
3. 在IDE中找到gradle-api-7.5.1.jar的依赖配置，手动关联下载好的源码和Javadoc文件。

方法三：IDE中直接配置自动下载 #

以IntelliJ IDEA为例：

• 打开File > Settings > Build, Execution, Deployment > Build Tools > Gradle
• 在Build and run using和Run tests using选项中选择IntelliJ IDEA
• 勾选Download sources和Download documentation选项
• 点击Apply后重新同步项目，IDE会自动下载缺失的源码和Javadoc

额外提示：关于org.junit.platform.commons.util.Preconditions #

这个类属于JUnit Platform Commons库，而非Gradle API本身。如果调试时需要该类的源码，可在依赖中添加对应版本的org.junit.platform:junit-platform-commons（Gradle 7.5.1默认依赖版本为1.9.3），并通过上述方法开启源码与Javadoc下载。

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