Apache Maven JAR Plugin官方文档

太过爱你忘了你带给我的痛 2022-12-27 02:28 157阅读 0赞

[原文地址][Link 1]

这个插件提供了构建jar的功能。如果您喜欢签名jar文件，请使用[Maven Jarsigner插件][Maven Jarsigner]。

## 目标概述 ##

*  [jar:jar][jar_jar] 为包含资源的项目类创建一个jar文件。
 *  [jar:test-jar][jar_test-jar] 为您的项目测试类创建一个jar文件。

## 主要版本升级到3.0.0版本 ##

请注意，以下参数已经完全从插件配置中删除:

*  useDefaultManifestFile  
    如果你需要定义你自己的 **MANIFEST.MF** 文件，您可以简单地实现通过 [Maven Archiver][] 配置如下示例:

<project>
          ...
          <build>
            <plugins>
              <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <version>3.2.0</version>
                <configuration>
                  <archive>
                    <manifestFile>${project.build.outputDirectory}/META-INF/MANIFEST.MF</manifestFile>
                  </archive>
                </configuration>
                ...
              </plugin>
            </plugins>
          </build>
          ...
        </project>

## 使用 ##

关于如何使用JAR插件的一般说明可以在 [usage页面][usage] 中找到。下面的示例中描述了一些更具体的用例。

如果你对插件的使用还有疑问，请查看 [FAQ][] 并随时联系[用户邮件列表][Link 2]。发送到邮件列表的文章已经存档，并且可能已经包含了您问题的答案，作为旧线程的一部分。因此，浏览/搜索[邮件归档][Link 2]也是值得的。

如果你觉得插件缺少一个特性或者有缺陷，你可以在我们的[问题跟踪器][Link 3]中填写一个特性请求或者错误报告。当创建一个新的问题，请提供一个全面的描述，您的关注。特别是在修复bug时，开发人员重现你的问题是至关重要的。由于这个原因，我们非常感谢与这个问题相关的完整的调试日志、POMs或最好的小演示项目。当然，补丁也是受欢迎的。贡献者可以从我们的[源存储库][Link 4]查看该项目，并在[帮助使用Maven指南][Maven]中找到补充信息。

## 存储服务器配置 ##

插件使用Maven Archiver来处理jar内容和清单配置。

您可以查看 [Maven Archiver Documentation][] 来了解如何设置它。

您可能还需要查阅[使用清单的指南][Link 5]。

## 例子 ##

为了让你更好地理解JAR插件的一些用法，你可以看看下面的例子:

*  [Manifest 自定义][Manifest]
 *  [如何从jar归档中包含/排除内容][jar]
 *  [如何从项目中创建附加的jar工件][jar 1]
 *  [如何创建一个包含测试类的jar][jar 2]

[Link 1]: https://maven.apache.org/plugins/maven-jar-plugin/
[Maven Jarsigner]: https://maven.apache.org/plugins/maven-jarsigner-plugin/
[jar_jar]: https://maven.apache.org/plugins/maven-jar-plugin/jar-mojo.html
[jar_test-jar]: https://maven.apache.org/plugins/maven-jar-plugin/test-jar-mojo.html
[Maven Archiver]: http://maven.apache.org/shared/maven-archiver/index.html
[usage]: https://maven.apache.org/plugins/maven-jar-plugin/usage.html
[FAQ]: https://maven.apache.org/plugins/maven-jar-plugin/faq.html
[Link 2]: https://maven.apache.org/plugins/maven-jar-plugin/mail-lists.html
[Link 3]: https://maven.apache.org/plugins/maven-jar-plugin/issue-tracking.html
[Link 4]: https://maven.apache.org/plugins/maven-jar-plugin/source-repository.html
[Maven]: http://maven.apache.org/guides/development/guide-helping.html
[Maven Archiver Documentation]: https://maven.apache.org/shared/maven-archiver/
[Link 5]: https://maven.apache.org/guides/mini/guide-manifest.html
[Manifest]: https://maven.apache.org/plugins/maven-jar-plugin/examples/manifest-customization.html
[jar]: https://maven.apache.org/plugins/maven-jar-plugin/examples/include-exclude.html
[jar 1]: https://maven.apache.org/plugins/maven-jar-plugin/examples/attached-jar.html
[jar 2]: https://maven.apache.org/plugins/maven-jar-plugin/examples/create-test-jar.html