请注意,前 3 个方法修改了Jar
Gradle 的现有任务。
方法 1:将库文件放在结果 JAR 旁边
此方法不需要application
或任何其他插件。
tasks.jar {
manifest.attributes["Main-Class"] = "com.example.MyMainClass"
manifest.attributes["Class-Path"] = configurations
.runtimeClasspath
.get()
.joinToString(separator = " ") { file ->
"libs/${file.name}"
}
}
请注意,Java 要求我们为Class-Path
属性使用相对 URL。因此,我们不能使用 Gradle 依赖项的绝对路径(这也容易被更改并且在其他系统上不可用)。如果您想使用绝对路径,也许这种解决方法会起作用。
使用以下命令创建 JAR:
./gradlew jar
结果 JAR 将默认创建在build/libs/目录中。
创建 JAR 后,将库 JAR 复制到放置结果 JAR 的libs/子目录中。确保您的库 JAR 文件的文件名中不包含空格(它们的文件名应与${file.name}
上述任务中的变量指定的文件名匹配)。
方法 2:在结果 JAR 文件中嵌入库(fat 或 uber JAR)
这种方法也不需要任何 Gradle 插件。
tasks.jar {
manifest.attributes["Main-Class"] = "com.example.MyMainClass"
val dependencies = configurations
.runtimeClasspath
.get()
.map(::zipTree) // OR .map { zipTree(it) }
from(dependencies)
duplicatesStrategy = DuplicatesStrategy.EXCLUDE
}
创建 JAR 与前面的方法完全相同。
方法 3:使用Shadow 插件(创建 fat 或 uber JAR)
plugins {
id("com.github.johnrengelman.shadow") version "6.0.0"
}
// Shadow task depends on Jar task, so these configs are reflected for Shadow as well
tasks.jar {
manifest.attributes["Main-Class"] = "org.example.MainKt"
}
使用以下命令创建 JAR:
./gradlew shadowJar
有关配置插件的更多信息,请参阅Shadow 文档。
方法四:新建任务(而不是修改Jar
任务)
tasks.create("MyFatJar", Jar::class) {
group = "my tasks" // OR, for example, "build"
description = "Creates a self-contained fat JAR of the application that can be run."
manifest.attributes["Main-Class"] = "com.example.MyMainClass"
duplicatesStrategy = DuplicatesStrategy.EXCLUDE
val dependencies = configurations
.runtimeClasspath
.get()
.map(::zipTree)
from(dependencies)
with(tasks.jar.get())
}
运行创建的 JAR
java -jar my-artifact.jar
上述解决方案经过以下测试:
- 爪哇 17
- Gradle 7.1(将 Kotlin 1.4.31 用于.kts构建脚本)
有关创建 uber (fat) JARs的信息,请参阅官方Gradle 文档。
有关清单的更多信息,请参阅Oracle Java 文档:使用清单文件。
有关和之间的区别tasks.create()
,tasks.register()
请参阅这篇文章。
请注意,您的资源文件将自动包含在 JAR 文件中(假设它们被放置在/src/main/resources/目录或在构建文件中设置为资源根目录的任何自定义目录中)。要访问应用程序中的资源文件,请使用以下代码(注意/
名称开头的 ):
- 科特林
val vegetables = MyClass::class.java.getResource("/vegetables.txt").readText()
// Alternative ways:
// val vegetables = object{}.javaClass.getResource("/vegetables.txt").readText()
// val vegetables = MyClass::class.java.getResourceAsStream("/vegetables.txt").reader().readText()
// val vegetables = object{}.javaClass.getResourceAsStream("/vegetables.txt").reader().readText()
- 爪哇
var stream = MyClass.class.getResource("/vegetables.txt").openStream();
// OR var stream = MyClass.class.getResourceAsStream("/vegetables.txt");
var reader = new BufferedReader(new InputStreamReader(stream));
var vegetables = reader.lines().collect(Collectors.joining("\n"));