Gradle Java项目怎么生成源码包-java教程-PHP中文网

Gradle默认不生成sources.jar，需显式注册sourceJar任务并配置archiveClassifier='sources'、from sourceSets.main.allSource，再通过dependsOn或finalizedBy使其随jar任务自动执行。

gradle java项目怎么生成源码包

gradle sourceJar 任务默认不启用

Java插件默认不会生成源码包（sources.jar），即使你运行了 gradle build 或 gradle jar，输出目录 build/libs/ 下也只会有主 .jar 和可能的 -javadoc.jar（如果启用了 Javadoc 插件），但不会有源码包。这是新手最常困惑的一点：明明代码都在 src/main/java，为什么没被打进去？

手动配置 sourceJar 任务（Groovy DSL）

在 build.gradle 中添加以下块即可启用源码打包：

plugins {
    id 'java'
}
// 必须显式声明，否则不会参与 publish 或 assemble 流程
tasks.register('sourceJar', Jar) {
    archiveClassifier = 'sources'
    from sourceSets.main.allSource
}

注意几个关键点：

archiveClassifier = 'sources' 是约定名称，决定了最终文件名形如 myapp-1.0-sources.jar
from sourceSets.main.allSource 包含 src/main/java 和 src/main/resources —— 但通常源码包只应含 .java；如需严格只打包 Java 源文件，改用 sourceSets.main.java
该任务注册后仍需手动触发：gradle sourceJar，或让它被其他任务依赖（见下一条）

让 sourceJar 自动随 jar 一起生成

如果你希望每次运行 gradle jar 或 gradle assemble 时都顺带产出 -sources.jar，需建立任务依赖：

tasks.named('jar') {
    dependsOn tasks.named('sourceJar')
}
// 或更通用（兼容 Gradle 7.4+）：
tasks.withType(Jar).configureEach {
    if (archiveClassifier.orNull == '') {
        finalizedBy tasks.named('sourceJar')
    }
}

这样执行 gradle jar 后，build/libs/ 下就会同时出现 myapp-1.0.jar 和 myapp-1.0-sources.jar。

Java调试

通过 JDWP 实现 Java 远程调试：连接远程 JVM、设置断点、单步执行代码、查看变量值、获取调用栈。适用于需要调试远程 Java 应用、排查运行时状态、追踪代码执行流程的场景。术语注解 JDWP：Java Debug Wire Protocol，Java 调试有线协议（Java 远程调试底层通信协议） remote JVM：远程 Java 虚拟机 step through code：代码单步调试（步入 / 步过 / 步出调试） inspect variables：变量查看 / 变量检视 stac

下载

发布到 Maven 仓库时 sourceJar 会自动包含吗

不会自动包含，除非你明确配置 maven-publish 插件并附加 artifact：

plugins {
    id 'maven-publish'
}
publishing {
    publications {
        mavenJava(MavenPublication) {
            from components.java
            artifact(tasks.named('sourceJar'))
        }
    }
}

这里容易踩坑的是：