Maven 打包（.jar、-sources.jar、-javadoc.jar）

爱被打了一巴掌 2021-12-19 03:49 589阅读 0赞

说明：

版本从新建项目开始，讲述如何将Java打包成 **.jar**（普通jar包）、**-sources.jar**（jar包的源码）、**-javadoc.jar**（api帮助文档）。

相关软件：

<table> 
 <tbody> 
 <tr> 
 <td style="border-color:#a3a3a3;vertical-align:top;width:.6673in;"> 软件 </td> 
 <td style="border-color:#a3a3a3;vertical-align:top;width:2.3479in;"> 版本 </td> 
 <td style="border-color:#a3a3a3;vertical-align:top;width:2.0131in;"> 说明 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#a3a3a3;vertical-align:top;width:.6673in;"> Java </td> 
 <td style="border-color:#a3a3a3;vertical-align:top;width:2.3479in;"> 1.8 </td> 
 <td style="border-color:#a3a3a3;vertical-align:top;width:2.1451in;"> Maven与IDEA运行依赖 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#a3a3a3;vertical-align:top;width:.6868in;"> Maven </td> 
 <td style="border-color:#a3a3a3;vertical-align:top;width:2.3479in;"> 3.0.6 </td> 
 <td style="border-color:#a3a3a3;vertical-align:top;width:2.0409in;"> 新建项目与打包所需 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#a3a3a3;vertical-align:top;width:.6673in;"> IDEA </td> 
 <td style="border-color:#a3a3a3;vertical-align:top;width:2.3673in;"> IntelliJ IDEA 2019.1.3 </td> 
 <td style="border-color:#a3a3a3;vertical-align:top;width:1.9937in;"> 新建项目所需 </td> 
 </tr> 
 </tbody> 
</table>

--------------------

1. 新建项目，选择 **Maven**、**Java 版本**，点 **Next**： 
 ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70][] 
  
2. 输入 **GroupId**（组织Id，域名的反转）、**ArtifactId**（坐标）、**Version**（版本），点 **Next**： 
 ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 1][] 
  
3. 输入 **Project name**（项目名，默认打包时的jar包名称）、**Project location**（项目保存路径），点 **Finish**： 
 ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 2][] 
  
4. 新建项目如图所示： 
 ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 3][] 
  
5. 在这里我们引入 阿里巴巴 JSON 处理依赖： 
 ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 4][] 
  
6. 编写几个简单的类： 
 需要自己根据自己的 **GroupId**（组织Id，域名的反转）、**ArtifactId**（坐标）创建包： 
 ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 5][] 
  
7. 推荐引入 org.sonatype.oss 依赖： 
 如果自己配置，比较麻烦。 
 发布到中央仓库所需依赖。
 
 
 <dependency>
 <groupId>org.sonatype.oss</groupId>
 <artifactId>oss-parent</artifactId>
 <version>9</version>
 <type>pom</type>
 </dependency>
 
 配置信息详情：[https://repo1.maven.org/maven2/org/sonatype/oss/oss-parent/9/oss-parent-9.pom][https_repo1.maven.org_maven2_org_sonatype_oss_oss-parent_9_oss-parent-9.pom] 
 
 如图所示： 
 ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 6][]
8. 打包前的注意事项：
 
 1. 设置编码 UTF-8：
 
 <table> 
 <tbody> 
 <tr> 
 <td style="border-color:#a3a3a3;vertical-align:top;width:1.3479in;"> .jar </td> 
 <td style="border-color:#a3a3a3;vertical-align:top;width:.8118in;"> 不设置 </td> 
 <td style="border-color:#a3a3a3;vertical-align:top;width:3.4506in;"> 存在中文字符会出现警告，不影响使用 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#a3a3a3;vertical-align:top;width:1.3479in;"> -source.jar </td> 
 <td style="border-color:#a3a3a3;vertical-align:top;width:.8118in;"> 不设置 </td> 
 <td style="border-color:#a3a3a3;vertical-align:top;width:3.2993in;"> 无影响 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#a3a3a3;vertical-align:top;width:1.3673in;"> -javadoc.jar </td> 
 <td style="border-color:#a3a3a3;vertical-align:top;width:.8118in;"> 不设置 </td> 
 <td style="border-color:#a3a3a3;vertical-align:top;width:3.2798in;"> 打包异常 </td> 
 </tr> 
 </tbody> 
 </table>
 
 <properties>
 <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 </properties>
 2. <packaging>jar</packaging>（新建项目时不存在，可缺省）。 
  
 3. 如图所示： 
 
 ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 7][] 
  
9. 使用 cmd 进入此文件夹（也可以使用 IDEA 中的 Terminal）： 
 ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 8][] 
  
10. jar包： 
 未编译过（无 target 文件夹），使用：
 
 mvn package
 
 编译过（有 target 文件夹），使用： 
 清理并编译：
 
 mvn clean package
 
 打包详情： 
 ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 9][] 
 
 查看到已打包的jar包： 
 
 ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 10][] 
 
 如果未配置：
 
 <properties>
 <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 </properties>
 
 会出现警告： 
 ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 11][] 
  
11. 源码打包：
 
 mvn clean source:jar
 
 
 ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 12][] 
 
 使用解压软件查看。 
 
 ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 13][] 
  
12. **-javadoc.jar**（api帮助文档）打包： 
  
 
 mvn clean javadoc:jar
 
 查看文件位置： 
 
 ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 14][] 
 
 解压 或 查看 apidocs 文件夹（区别在于 -javadoc.jar 有 META-INF 文件夹）： 
 
 ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 15][] 
 
 查看 文档： 
 ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 16][] 
 ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 17][]
13. 其他命令说明：
 
 mvn compile 编译类文件
 mvn install 打包后发布到本地仓库

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70]: /images/20211219/5d933b62162541f393802204f4b52305.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 1]: /images/20211219/86925e212ea64caaaaffccf74d202de9.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 2]: /images/20211219/5b6fc8062f85463a92349d1f8e6a8461.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 3]: /images/20211219/65fe45c01e804d93a43629c81cf21a21.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 4]: /images/20211219/e7b2acc060e44790894f44a5642715b4.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 5]: /images/20211219/00befe74296c4b12a6db1f9b52d38131.png
[https_repo1.maven.org_maven2_org_sonatype_oss_oss-parent_9_oss-parent-9.pom]: https://repo1.maven.org/maven2/org/sonatype/oss/oss-parent/9/oss-parent-9.pom
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 6]: /images/20211219/40d04de8c2764616b94f93f3f7a1845a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 7]: /images/20211219/925e67261c1d4689a793743281957b25.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 8]: /images/20211219/c5b8ed68ce454254bd3a14192e48c416.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 9]: /images/20211219/85f7fc809903482ca1e1bfd261413d39.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 10]: /images/20211219/cec0021900ac4b48b6e98b0a4a78d309.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 11]: /images/20211219/e4a69afccc3744a19990d0142f099f68.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 12]: /images/20211219/d592e0040c994ab6a5d96035f4cf19d5.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 13]: /images/20211219/fcd6bbceeddd4f6b889f400f294fe3dc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 14]: /images/20211219/d4ce5b21a9de4aed89d04f3e0fa86485.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 15]: /images/20211219/92f11c85657a4680b20115f5e51e7111.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 16]: /images/20211219/c770fceeaabf45058617fc18bcc2efce.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly94dXhpYW93ZWkuYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 17]: /images/20211219/2943b7e20af441a88826332be0621200.png