https://blog.csdn.net/top_code/article/details/53586551
當我們開發了一個公共模塊,將它deploy到Maven倉庫時,最好同時提供源碼包和Javadoc包,這樣使用者可以在IDE中直接進入該依賴的源碼查看其實現的細節。
由於生成源碼包和Javadoc包是極其常見的需求,因此Maven官方提供了插件來幫助用戶完成這個任務
,配置如下:
<build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.5.1</version> <configuration> <source>${java.version}</source> <target>${java.version}</target> <testSource>${java.version}</testSource> <testTarget>${java.version}</testTarget> </configuration> </plugin> <!--配置生成Javadoc包--> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <version>2.9.1</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> </execution> </executions> </plugin> <!--配置生成源碼包--> <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> </plugins> </build>
在使用IDEA生成Java Doc的過程中,可能會出現IDEA控制台輸出中文亂碼,即使我們在maven-javadoc-plugin插件中指定字符集為UTF-8,依然是亂碼,這是因為Maven的默認平台編碼是GBK。
解決辦法:
在IDEA中,打開File | Settings | Build, Execution, Deployment | Build Tools | Maven | Runner在VM Options中添加-Dfile.encoding=GBK,切記一定是GBK。
參考
Maven實戰(九)——打包的技巧:http://www.infoq.com/cn/news/2011/06/xxb-maven-9-package