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           <- Base package for my-lib classes
│           ├── MyLyb.class   
│           └── _shaded     <- Base package for dependency classes
│               ├── com.google...
│               ├── com.fasterxml.jackson...
│               └── com.github.lalyos.jfiglat...
└── META-INF             
    └── MANIFEST.MF      

此外，@maven.publication.extraArtifacts=all 包含 jeka maven:publish 指令產生的 maven 出版品中的陰影 jar。

Maven 比較

如下所示，Maven 需要更多的輸入才能實現類似的目標。

<?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中文網其他相關文章！