Android Studio或Intellij Idea生成javadoc出錯的解決辦法

參考鏈接:https://my.oschina.net/yaly/blog/644590
http://www.cnblogs.com/kaima/p/4444506.html


解決問題1、2的配置:

-bootclasspath  E:\software\sdk\platforms\android-22\android.jar -encoding utf-8 -charset utf-8

一般使用Android Studio生成 JavaDoc會有三個問題:
1、空指針異常
解決方法:

Tools –> Generate JavaDoc –>打開對話框活,在”Other command line arguments”輸入“-bootclasspath /Users/用戶名/sdk/platforms/android-22/android.jar”,每個人電腦不盡相同,指定android.jar的位置就行

2、文檔編碼出錯

Tools –> Generate JavaDoc –>打開對話框活,在”Other command line arguments”輸入“-encoding UTF-8 -charset UTF-8“

3、內存溢出

Tools –> Generate JavaDoc –>打開對話框活,在”Other command line arguments”輸入“-J-Xmx1024m“
或者在 Maximum heap size(Mb) 裏直接填入值1024

注意:
(如果兩個參數都加,參數之間需要空格隔開)

附命令:

用法: javadoc [options] [packagenames] [sourcefiles] [@files]
-overview <file>          從 HTML 文件讀取概覽文檔
-public                   僅顯示 public 類和成員
-protected                顯示 protected/public 類和成員 (默認值)
-package                  顯示 package/protected/public 類和成員
-private                  顯示所有類和成員
-help                     顯示命令行選項並退出
-doclet <class>            通過替代 doclet 生成輸出
-docletpath <path>        指定查找 doclet 類文件的位置
-sourcepath <pathlist>    指定查找源文件的位置
-classpath <pathlist>     指定查找用戶類文件的位置
-exclude <pkglist>        指定要排除的程序包列表
-subpackages <subpkglist> 指定要遞歸加載的子程序包
-breakiterator            計算帶有 BreakIterator 的第一個語句
-bootclasspath <pathlist> 覆蓋由引導類加載器所加載的
               類文件的位置
-source <release>         提供與指定發行版的源兼容性
-extdirs <dirlist>        覆蓋所安裝擴展的位置
-verbose                  輸出有關 Javadoc 正在執行的操作的信息
-locale <name>            要使用的區域設置, 例如 en_US 或 en_US_WIN
-encoding <name>          源文件編碼名稱
-quiet                    不顯示狀態消息
-J<flag>                  直接將 <flag> 傳遞到運行時系統
-X                        輸出非標準選項的提要

通過標準 doclet 提供:
-d <directory>                    輸出文件的目標目錄
-use                              創建類和程序包用法頁面
-version                          包含 @version-author                           包含 @author-docfilessubdirs                  遞歸複製文檔文件子目錄
-splitindex                       將索引分爲每個字母對應一個文件
-windowtitle <text>               文檔的瀏覽器窗口標題
-doctitle <html-code>             包含概覽頁面的標題
-header <html-code>               包含每個頁面的頁眉文本
-footer <html-code>               包含每個頁面的頁腳文本
-top    <html-code>               包含每個頁面的頂部文本
-bottom <html-code>               包含每個頁面的底部文本
-link <url>                       創建指向位於 <url> 的 javadoc 輸出的鏈接
-linkoffline <url> <url2>         利用位於 <url2> 的程序包列表鏈接至位於 <url> 的文檔
-excludedocfilessubdir <name1>:.. 排除具有給定名稱的所有文檔文件子目錄。
-group <name> <p1>:<p2>..         在概覽頁面中, 將指定的程序包分組
-nocomment                        不生成說明和標記, 只生成聲明。
-nodeprecated                     不包含 @deprecated 信息
-noqualifier <name1>:<name2>:...  輸出中不包括限定符的列表。
-nosince                          不包含 @since 信息
-notimestamp                      不包含隱藏時間戳
-nodeprecatedlist                 不生成已過時的列表
-notree                           不生成類分層結構
-noindex                          不生成索引
-nohelp                           不生成幫助鏈接
-nonavbar                         不生成導航欄
-serialwarn                       生成有關 @serial 標記的警告
-tag <name>:<locations>:<header>  指定單個參數定製標記
-taglet                           要註冊的 Taglet 的全限定名稱
-tagletpath                       Taglet 的路徑
-Xdocrootparent <url>             將文檔註釋中出現的所有後跟 /.. 的 @docRoot 替換爲 <url>
-charset <charset>                用於跨平臺查看生成的文檔的字符集。
-helpfile <file>                  包含幫助鏈接所鏈接到的文件
-linksource                       以 HTML 格式生成源文件
-sourcetab <tab length>           指定源中每個製表符佔據的空格數
-keywords                         使程序包, 類和成員信息附帶 HTML 元標記
-stylesheetfile <path>            用於更改生成文檔的樣式的文件
-docencoding <name>               輸出編碼名稱
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章