使用 Maven Assembly 外掛程式建立 fat JARs

範例專案: tutorial-server-get-started-maven

Maven Assembly plugin 提供了將專案輸出組合成單一可分發歸檔的能力，該歸檔包含依賴項、模組、網站文件及其他檔案。

設定 Assembly 外掛程式

要建置組件，您需要先設定 Assembly 外掛程式：

1. 導覽至 pom.xml 檔案並確保已指定主應用程式類別：

   <properties>
       <main.class>com.example.ApplicationKt</main.class>
   </properties>

   如果您使用 EngineMain 而沒有明確的 main() 函數，應用程式的主類別取決於所使用的引擎，並且可能如下所示：io.ktor.server.netty.EngineMain。

2. 如下所示將 maven-assembly-plugin 加入到 plugins 區塊：

   <plugin>
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-assembly-plugin</artifactId>
       <version>2.6</version>
       <configuration>
           <descriptorRefs>
               <descriptorRef>jar-with-dependencies</descriptorRef>
           </descriptorRefs>
           <archive>
               <manifest>
                   <addClasspath>true</addClasspath>
                   <mainClass>${main.class}</mainClass>
               </manifest>
           </archive>
       </configuration>
       <executions>
           <execution>
               <id>assemble-all</id>
               <phase>package</phase>
               <goals>
                   <goal>single</goal>
               </goals>
           </execution>
       </executions>
   </plugin>

建置組件

要為應用程式建置組件，請開啟終端機並執行以下指令：

mvn package

這將為組件建立一個新的 target 目錄，包括 .jar 檔案。

要了解如何使用結果套件透過 Docker 部署您的應用程式，請參閱 Docker 說明主題。

執行應用程式

要執行建置好的應用程式，請依照以下步驟：

1. 在新的終端機視窗中，使用 java -jar 指令執行應用程式。對於範例專案，它看起來如下：

   java -jar target/tutorial-server-get-started-maven-0.0.1-jar-with-dependencies.jar

2. 一旦您的應用程式正在執行，您將看到一條確認訊息：

   [main] INFO  Application - Responding at http://0.0.0.0:8080

3. 點擊 URL 連結以在您的預設瀏覽器中開啟應用程式：