- **介紹**
Apache Maven Assembly Plugin 是 Apache Maven 專案的一個外掛，其主要作用是將專案的所有依賴，包括程式碼、資源、配置等組裝成一個單獨的可部署的長期檔案。這樣，開發人員可以很方便地在生產環境中部署和執行專案。

- **打包成 JAR 檔案的示例**
```xml
<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/maven-v4_0_0.xsd">
  <modelversion>4.0.0</modelversion>
  <groupid>com.example</groupid>
  <artifactid>my-project</artifactid>
  <version>1.0.0-SNAPSHOT</version>
  <packaging>jar</packaging>

<build>
    <plugins>
      <plugin>
        <groupid>org.apache.maven.plugins</groupid>
        <artifactid>maven-compiler-plugin</artifactid>
        <version>3.8.0</version>
        <configuration>
          <source>1.8<source>
          <target>1.8</target>
        </configuration>
      </plugin>
      <plugin>
        <groupid>org.apache.maven.plugins</groupid>
        <artifactid>maven-assembly-plugin</artifactid>
        <version>3.3.0</version>
        <configuration>
          <descriptors>
            <descriptor>src/main/assembly/jar.xml</descriptor>
          </descriptors>
        </configuration>
        <executions>
          <execution>
            <phase>package</phase>
            <goals>
              <goal>single</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>
</project>
```
這裡我們使用了兩個外掛：Maven Compiler Plugin 和 Maven Assembly Plugin。
Maven Compiler Plugin 用於編譯專案原始碼，並配置了原始碼和目的碼版本為 1.8。
Maven Assembly Plugin 用於打包專案為 JAR 檔案，並從 jar.xml 檔案中讀取打包配置。
關於 jar.xml 檔案，你可以使用以下內容作為配置：
```xml
<assembly>
  <id>jar</id>
  <formats>
    <format>jar</format>
  </formats>
  <includebasedirectory>false</includebasedirectory>
  <filesets>
    <fileset>
      <directory>src/main/java</directory>
      <outputdirectory>/</outputdirectory>
      <includes>
        <include>**/*.class</include>
      </includes>
    </fileset>
  </filesets>
  <dependencysets>
    <dependencyset>
      <outputdirectory>/lib</outputdirectory>
      <useprojectartifact>true</useprojectartifact>
      <unpack>false</unpack>
    </dependencyset>
  </dependencysets>
</assembly>
```
以上配置告訴 Maven 在打包 JAR 檔案時：
不包含基本目錄。
包含 src/main/java 目錄下的所有編譯後的類檔案（*.class）。
包含所有的依賴，並將它們放在 JAR 檔案中的 /lib 目錄下。
最後，在命令列中執行以下命令即可生成 JAR 檔案：
```shell
mvn clean package
```

Apache Maven Assembly Plugin 的介紹

相關文章