悠悠楠杉
网站页面
在Java中使用Gradle构建可执行Jar包
11/11
在现代Java开发中，将应用程序打包为可执行的JAR（Java Archive）文件是部署和分发程序的关键步骤。相比传统的Ant或Maven，Gradle以其灵活的DSL（领域特定语言）和强大的插件系统，成为越来越多开发者首选的构建工具。尤其在Spring Boot等现代框架广泛采用Gradle的背景下，掌握如何通过Gradle生成一个可以直接运行的JAR包，已成为Java工程师的必备技能。
要让一个JAR文件“可执行”，核心在于两点：一是将所有依赖项正确打包或指定路径；二是明确告诉JVM哪个类包含main方法作为程序入口。Gradle通过java插件和application插件提供了对这一流程的原生支持，开发者只需在build.gradle文件中进行合理配置，即可一键生成可运行的JAR。
首先，确保项目根目录下的build.gradle文件应用了必要的插件。最基础的是java插件，它启用了Java项目的标准生命周期任务，如编译、测试和打包。若希望更便捷地构建可执行应用，推荐同时应用application插件：
groovy
plugins {
id 'java'
id 'application'
}
接下来，必须指定主类（main class），也就是包含public static void main(String[] args)方法的类。这是JAR被执行时JVM查找入口的依据。通过mainClass属性进行设置，例如：
groovy
application {
mainClass = 'com.example.HelloWorld'
}
此时，执行./gradlew run命令即可直接运行程序。但我们的目标是生成一个独立的、可在其他环境中运行的JAR文件。默认的jar任务生成的JAR仅包含项目自身的编译类文件，并不包含第三方依赖。因此，若直接用java -jar build/libs/xxx.jar运行，很可能会遇到ClassNotFoundException。
解决依赖问题的常见方式是使用“fat jar”（也称uber jar），即将所有依赖库的字节码合并到同一个JAR文件中。Gradle本身不直接提供此功能，但我们可以通过自定义jar任务来实现。在build.gradle中重写jar任务如下：
groovy
jar {
manifest {
attributes 'Main-Class': 'com.example.HelloWorld'
}
from {
configurations.runtimeClasspath.collect { it.isDirectory() ? it : zipTree(it) }
}
}
上述代码做了三件事：第一，在JAR的MANIFEST.MF文件中添加Main-Class属性，指明启动类；第二，收集runtimeClasspath中的所有依赖（包括本地库和远程依赖如Maven中央仓库下载的JAR）；第三，使用zipTree将这些JAR解压并合并到输出的JAR中，实现“打平”操作。
完成配置后，只需在命令行运行./gradlew clean build，Gradle会依次执行清理、编译、测试和打包任务。成功后，在build/libs/目录下将生成一个以项目名和版本命名的JAR文件，例如myapp-1.0.jar。此时，可以在任意安装了JRE的机器上通过以下命令运行：
bash
java -jar build/libs/myapp-1.0.jar
如果一切配置正确，程序将正常启动并输出预期结果。
值得注意的是，生成fat jar虽然方便，但也存在潜在问题。例如，多个依赖可能包含同名资源文件（如META-INF/services），合并时会发生覆盖；此外，JAR体积可能变得臃肿。对于复杂项目，建议结合使用shadow插件（如com.github.johnrengelman.shadow），它专为创建fat jar设计，能更好地处理冲突和重定位类。
总之，使用Gradle构建可执行JAR包的过程本质上是对构建脚本的精准控制。从插件引入、主类声明到依赖合并，每一步都体现了Gradle声明式配置的优势。只要理解JAR执行机制和Gradle任务模型，开发者就能高效地将Java应用打包成简洁、可移植的交付物，为后续部署打下坚实基础。
