打包Maven公共模块项目的JavaDoc和源码

最新推荐文章于 2025-06-26 21:34:21 发布

原创最新推荐文章于 2025-06-26 21:34:21 发布 · 567 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#maven #javadoc #java #源码

本文介绍了如何在Maven项目中打包JavaDoc和源码，以方便他人使用。通过配置pom.xml，确保了文档的可读性和代码的可获取性，便于开发者快速集成公共模块。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

抽取公共模块是为了将其编译成jar包提给其他人使用，相同的逻辑不用每个人实现一遍。公共模块代码可读性要求很高，为了方便用户使用，我们可以将公共模块的javadoc注释以及源码打包一并发布。

一、打包JavaDoc注解

在pom文件中增加打包javadoc的插件配置：

            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-javadoc-plugin</artifactId>
                <version>2.10.4</version>
                <configuration>
                    <encoding>UTF-8</encoding>
                    <aggregate>true</aggregate>
                    <charset>UTF-8</charset>
                    <docencoding>UTF-8</docencoding>
                </configuration>
                <executions>
                    <execution>
                        <id>attach-javadocs</id>
                        <goals>
                            <goal>jar</goal>
                        </goals>
                        <configuration>
                            <additionalparam>-Xdoclint:none</additionalparam>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

增加 -Xdoclint:none配置是因为有一部老代码不符合javadoc规范，打包时忽略。

二、打包源码文件

在pom文件中增加打包源码文件的插件：

            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-source-plugin</artifactId>
                <version>3.0.1</version>
                <executions>
                    <execution>
                        <id>attach-sources</id>
                        <goals>
                            <goal>jar</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>

配置完后用mvn命令打包可以看到生成的jar包：

在这里插入图片描述

三、用户下载javadoc和源码

在客户端程序的pom文件中增加如下配置，就可以将javadoc和source的包下到本地：

        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <classifier>javadoc</classifier>
            <version>1.2.31</version>
        </dependency>
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <classifier>sources</classifier>
            <version>1.2.31</version>
        </dependency>