JeKa：创建 Uber 和 Shade Jars 的最简单方法

JeKa 是一个注重简单性的现代 Java 构建工具。

这篇文章是“Jeka：最简单的方法......”系列的一部分，展示了如何毫不费力地创建一个胖罐子（无论是否有阴影）。

适用应用： 简单脂肪罐

打包 Java 应用程序的常见方法是创建 FAT jar。 fat jar 捆绑了依赖项中的所有类，因此您只需要该 jar（以及 Java 运行时）即可运行应用程序。

您的应用程序可能需要依赖项，您可以在 dependency.txt 文件中列出这些依赖项，如下例所示：

== COMPILE ==
com.github.lalyos:jfiglet:0.0.9
com.google.guava:guava:33.4.0-jre
com.fasterxml.jackson.core:jackson-core:2.18.2


== TEST ==
org.junit.jupiter:junit-jupiter:5.8.1

要配置 fat jar 生成，请编辑 jeka.properties 文件：

jeka.version=0.11.11
jeka.java.version=17

@project.pack.detectMainClass=true
@project.pack.jarType=FAT

@project.pack.jarType 属性指定要生成的 JAR 的类型。它可以是常规的、胖的或阴影的。

@project.pack.detectMainClass=true 设置指示 Jeka 检测要包含在清单文件中的主类。

要生成 jar，请运行以下命令：

jeka project: pack

FAT jar 将在 jeka-output 目录中创建。要运行它，只需执行：java -jar [jar-name].jar.

对于图书馆：Shade Fat jar

对于图书馆来说，一个好的做法是保留一个常规的 Jar 并提供一个 Fat Jar 作为附加选项。

理想情况下，依赖类也应该重新定位到特定的包，以避免消费者的类路径冲突。我们将 shade jar 称为 fat jar，其中依赖项类已重新定位在特定包中。

要创建这样的 jar，请按如下方式配置 JeKa：

jeka.version=0.11.11
jeka.java.version=17

@project.moduleId=org.examples:my-lib
@project.version=1.0.0-SNAPSHOT
@project.pack.shadeJarClassifier=all

@maven.publication.extraArtifacts=all

现在，调用 jeka prpject: pack 还将创建一个*org.examples.my-lib-all.jar* 文件。
通过打开jat文件，我们可以看到所有的依赖类都已经自动重新定位了。

.
├── org                  
│   └── example             
│       └── mylib           



<p>此外，@maven.publication.extraArtifacts=all 包含 jeka maven:publish 命令生成的 <em>maven</em> 出版物中的阴影 jar。</p>

<h3>
  
  
  Maven 比较
</h3>

<p>如下所示，<em>Maven</em> 需要更多的输入才能实现类似的目标。<br>
</p>

<pre class="brush:php;toolbar:false"><?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemalocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelversion>4.0.0</modelversion>


    <groupid>org.examples</groupid>
    <artifactid>my-lib</artifactid>
    <version>0.1.0-SNAPSHOT</version>

    <dependencies>
        <dependency>
            <groupid>com.github.lalyos</groupid>
            <artifactid>jfiglet</artifactid>
            <version>0.0.9</version>
        </dependency>
        <dependency>
            <groupid>com.google.guava</groupid>
            <artifactid>guava</artifactid>
            <version>33.2.1-jre</version>
        </dependency>
        <dependency>
            <groupid>com.fasterxml.jackson.core</groupid>
            <artifactid>jackson-core</artifactid>
            <version>2.17.2</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupid>org.apache.maven.plugins</groupid>
                <artifactid>maven-shade-plugin</artifactid>
                <version>2.3</version>
                <executions>
                    <!-- Run shade goal on package phase -->
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>shade</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
        <pluginmanagement>
            <plugins>
                <plugin>
                    <groupid>org.apache.maven.plugins</groupid>
                    <artifactid>maven-shade-plugin</artifactid>
                    <version>2.1</version>
                    <executions>
                        <execution>
                            <phase>package</phase>
                            <goals>
                                <goal>shade</goal>
                            </goals>
                        </execution>
                    </executions>
                    <configuration>
                        <minimizejar>true</minimizejar>
                        <artifactset>
                            <includes>
                                <include>com.google.guava:guava</include>
                                <include>com.github.lalyos:jfiglet</include>
                                <include>com.fasterxml.jackson.core:jackson-core</include>
                            </includes>
                        </artifactset>
                        <relocations>
                            <relocation>
                                <pattern>com.google.common</pattern>
                                <shadedpattern>org.elasticsearch.common</shadedpattern>
                            </relocation>
                            <relocation>
                                <pattern>com.fasterxml.jackson</pattern>
                                <shadedpattern>org.elasticsearch.common.jackson</shadedpattern>
                            </relocation>
                        </relocations>
                        <filters>
                            <filter>
                                <artifact>*:*</artifact>
                                <excludes>
                                    <exclude>META-INF/license/**</exclude>
                                    <exclude>META-INF/*</exclude>
                                    <exclude>META-INF/maven/**</exclude>
                                    <exclude>LICENSE</exclude>
                                    <exclude>NOTICE</exclude>
                                    <exclude>/*.txt</exclude>
                                    <exclude>build.properties</exclude>
                                </excludes>
                            </filter>
                        </filters>
                    </configuration>
                </plugin>
            </plugins>
        </pluginmanagement>
    </build>

</project>

结论

与

Maven 或 Gradle 相比，Jeka 使构建 Java 项目变得更加容易，并且配置最少。

探索更多示例，了解 Jeka 如何适应您的项目需求！

以上是JeKa：创建 Uber 和 Shade Jars 的最简单方法的详细内容。更多信息请关注PHP中文网其他相关文章！