Javadoc生成

2019-09-29  本文已影响0人  毛不翼

1.Javadoc打包部署

1.1 javadoc插件配置如下

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>3.0.1</version>
    <executions>
        <execution>
            <id>attach-javadocs</id>
            <phase>install</phase>
            <goals>
                <goal>jar</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <encoding>UTF-8</encoding>
        <charset>UTF-8</charset>
    </configuration>
    <show>private</show>
</plugin>

1.2 jdk1.7和jdk1.8

1.2.1 jdk1.7一下使用maven的javadoc插件执行 javadoc:jar deploy 即可。
1.2.2 jdk1.8对javadoc的要求比较严格,注释必须是按照一定要求编写,不符合规则会报错和警告,可能导致生成javadoc失败,解决思路如下:
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>3.0.1</version>
    <executions>
        <execution>
            <id>attach-javadocs</id>
            <phase>install</phase>
            <goals>
                <goal>jar</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <encoding>UTF-8</encoding>
        <charset>UTF-8</charset>
        <additionalOptions>
            <additionalOption>-Xdoclint:none</additionalOption>
        </additionalOptions>
       <show>private</show>
    </configuration>
</plugin>
上一篇 下一篇

猜你喜欢

热点阅读