【轉】Android開發:JavaDoc注釋插件簡單使用介紹


原文網址:https://www.jianshu.com/p/06153fabcad3

一、插件說明

JavaDoc

添加注釋,可自定義模板。
插件下載地址:https://plugins.jetbrains.com/plugin/?idea_ce&pluginId=7157
插件源碼地址:https://github.com/setial/intellij-javadocs
推薦指數: 五星

二、插件安裝

Android Studio: File → Settings → Plugins → Browse repositories 搜索插件名【JavaDoc】 並安裝
或者
Android Studio: 下載jar文件 並安裝
   File → Settings → Plugins → Install plugin from disk (選本地插件包)安裝即可。

三、插件使用

1、注釋快捷鍵

Windows電腦:在方法上面輸入快捷鍵 alt+ctrl+shift+G 即可自動生成注釋,或者按alt+insert調出對話框,手動選擇。
Mac電腦:在方法上面輸入快捷鍵 alt+command+shift+G 即可自動生成注釋,或者按command+N調出對話框,手動選擇。

 
command_N.png
2、生成javadoc文檔

在Android studio中進行打開一個項目的文件之后,然后進行點擊Android stuio中菜單中的“tools”的選項。

 
Tools.png

這樣就會彈出了下拉菜單中,進行選中下拉菜單中的“generate javadoc”的選項。

 
Generate JavaDoc.png

就會彈出了specify generate javadoc scope的窗口,在output directorys中進行輸出的路徑。

 
OutputPath.png

可在運行的窗口中查看到的是文件正在生成,根據文件大小,對生成的時間上等待。

 
progress.png

文件生成完畢之后,進入到了resource的文件,進行雙擊index.html的選項即可。

 
index.png

這樣就同index.html中查看代碼中所有類的方法,如果有添加注釋的信息,也可查看到。

 
javadoc.png

四、小技巧

1、解決使用Android Studio導出JavaDoc時中文亂碼問題

導出過程中,在Other command line arguments欄目添加命令參數:

-encoding UTF-8 -charset UTF-8(如果是GBK,參數為 -encoding GBK -charset GBK)

默認是中文文檔,添加 -locale en_US 生成英文文檔

或者在Locate欄目添加 en_US

2、command+J:調出系統注釋選擇項
 
system_ annotation.png
3、類注釋代碼
/** * @Author: ${USER} * @Time: ${DATE} ${TIME} * @Company:公司名稱 * @Description: 功能描述 */ 
 
File Header.png
4、類似主題優秀文檔參考

https://blog.csdn.net/EthanCo/article/details/52003296



作者:Jason_hzb
鏈接:https://www.jianshu.com/p/06153fabcad3
來源:簡書
著作權歸作者所有。商業轉載請聯系作者獲得授權,非商業轉載請注明出處。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM