Android代碼注釋模版

Android代碼注釋模版

一、注釋模版的內(nèi)容 代碼注釋生成文檔,所以,部分注釋內(nèi)容需要用到html標(biāo)簽排版內(nèi)容以達(dá)到代碼美觀的目的,常用的

有等,Android studio 在 file菜單中選擇settings 搜索File and Code Templates,在右側(cè)菜單中選擇不同的代碼使用場(chǎng)景并編輯為需要的模版,在生成注釋時(shí)就可以生成自己想要的注釋

二、注釋代碼腳本編寫(xiě)

生成代碼模版時(shí),需要用到默認(rèn)的生成內(nèi)容,例如,將@author的默認(rèn)內(nèi)容設(shè)定為自己的用戶名,方法一、直接配置內(nèi)容 或者配置內(nèi)容為 USERNAME時(shí)間為{DATE} 、YEAR、{ORGANIZATION_NAME}

三、通用注釋模版

1.文件(Files)注釋標(biāo)簽:

/**

* All rights Reserved, Designed By Android_Robot

* @Title: filename?@Package{package_name}

* @Description: todo(用一句話描述該文件做什么)?@author:AndroidRobot?@date:{date} ${time}

* @version V1.0

*/

2.類型(Types)注釋標(biāo)簽(類的注釋):

/**

* @ClassName: typename?@Description:{todo}(這里用一句話描述這個(gè)類的作用)

* @author: Android_Robot

* @date: date{time}

*

* ${tags}

*/

3.字段(Fields)注釋標(biāo)簽:

/**

* @Fields field:{todo}(用一句話描述這個(gè)變量表示什么)

*/

4.構(gòu)造函數(shù)標(biāo)簽:

/**

* @Title: enclosingtype?@Description:{todo}(這里用一句話描述這個(gè)方法的作用)

* @param: ${tags}

* @throws

*/

5.方法(Methods)標(biāo)簽:

/**

* @Title: enclosingmethod?@Description:{todo}(這里用一句話描述這個(gè)方法的作用)

* @param: tags?@return:{return_type}

* @throws

*/

6.覆蓋方法(Overriding Methods)標(biāo)簽:

/**

*

Title: ${enclosing_method}

*

Description:

* tags?{see_to_overridden}

*/

7.代表方法(Delegate Methods)標(biāo)簽:

/**

* tags?{see_to_target}

*/

8.getter方法標(biāo)簽:

/**

* @Title: enclosingmethod?@Description:pleasewriteyourdescription?@return:{field_type}

*/

9.setter方法標(biāo)簽:

/**

* @Title: enclosingmethod?@Description:pleasewriteyourdescription?@return:{field_type}

*/

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書(shū)系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

推薦閱讀更多精彩內(nèi)容

  • Spring Cloud為開(kāi)發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見(jiàn)模式的工具(例如配置管理,服務(wù)發(fā)現(xiàn),斷路器,智...
    卡卡羅2017閱讀 134,992評(píng)論 19 139
  • 設(shè)置注釋模板的入口: Window->Preference->Java->Code Style->Code Tem...
    柒黍閱讀 686評(píng)論 0 0
  • github排名https://github.com/trending,github搜索:https://gith...
    小米君的demo閱讀 4,829評(píng)論 2 38
  • 明天你是否會(huì)想起 昨天你寫(xiě)的日記 明天你是否還惦記 曾經(jīng)最愛(ài)哭的你 老師們都已想不起 猜不出問(wèn)題的你 我也是偶然翻...
    人生只有一次請(qǐng)好好珍惜閱讀 288評(píng)論 0 4
  • Who are you? I'm here! 等你 是我能做的最長(zhǎng)久的事 醒來(lái) 我笑笑 和往日一樣 往周一樣 往月...
    MiaLL閱讀 358評(píng)論 3 1