idea 配置 maven 生成 maven 包 + javadoc 文档方式

首先,我不是搞Java的,因此!措辞可能不严谨,请勿抬杠,感谢理解和支持!本人本机环境是:JDK8(开发环境)+ idea 2021.2.2 + 编辑器自带Maven + 改动了库的位置和镜像源!

我的需求

首先我的需求是什么?是我有一个API的jar包,如果我希望我可以调用这个jar包的内的API,那么我就需要在新的项目里手动引入这个jar包,这是最简单的方案;但有个你说有啥影响也没啥影响,你要说没影响又有点蛋疼的问题;那就是如果你是直接引入jar包折中调用,如果调用了jar里的接口或者API,那么编辑器是无法给你自动补充javadoc的,因为你只引入的jar包,java是编译性语言,编译后注释都没了,你当然也取不到注释自己用;因此我现在的诉求和我对java的了解,目前就1个方案:制作成mavan的包,这种包可以通过 pom.xml 来引入,也就是支持连文档一起下载实用;

实现需求

首先,打开 pom.xml,在 <project> 下添加 <distributionManagement>,以设置导出maven包的位置;可供参考的配置如下:

<!-- 添加一个distributionManagement配置,表示置顶deploy目录-->
<distributionManagement>
    <repository>
        <!-- 这里名字随便填,反正我是随便填的-->
        <id>localRepository</id>
        <!-- 这里填写本地仓库路径,可以是完整路径也可以是相对路径-->
        <!--  比如我这里直接 file:repository 就表示在项目目录下的 repository 生成 -->
        <url>file:target/repository</url>
    </repository>
</distributionManagement>

然后在 <plugins> 节点下添加如下插件,参考配置如下:

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

最后,直接看图吧!这里只用用图表示可比我文字表述简单多了!

Snipaste_2021-11-16_21-39-39.png