maven 生成javadoc常見

1  亂碼問題java

2自定義標籤apache

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>${maven_javadoc_version}</version>
    <configuration>
        <aggregate>true</aggregate>
        <tags>
            <tag>
                <name>checkstyle</name>
                <placement>a</placement>
                <head>略過checkstyle規則</head>
            </tag>
        </tags>
    </configuration>
    <executions>
        <execution>
            <id>attach-javadoc</id>
            <goals>
                <goal>jar</goal>
            </goals>
            <phase>compile</phase>
        </execution>
    </executions>
</plugin>
 maven

屬性 說明
name 標籤名
placement 標籤適用的位置
head 前置提示

該三個參數和用使用generate javadoc 生成時,第三步添加自定義標籤基本一致spa

其添加方式以下:.net

-tag Date:a:"生成日期"插件

-tag Desc:a:"功能描述"code

3 忽略告警、錯誤blog

常見的如@return和@param 後面沒有描述等等ci

網上常見的配置以下:get

<plugin>

 <groupId>org.apache.maven.plugins</groupId>

 <artifactId>maven-javadoc-plugin</artifactId>

 <version>2.10.3</version>

 <executions>

 <execution>

 <id>attach-javadocs</id>

 <goals>

 <goal>jar</goal>

 </goals>

 <configuration>

 <additionalparam>-Xdoclint:none</additionalparam>

 </configuration>

 </execution>

 </executions>

</plugin>

這種方式的缺點是隻能使用老版本插件,新版的maven是不支持的。新版的配置以下

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>3.0.1</version>
    <configuration>
        <doclint>none</doclint>
    </configuration>
</plugin>
相關文章
相關標籤/搜索