在android源碼中我們能看到各種以@開頭的字元,他們大多出現在注釋中,如下圖所示
但是可不要小看了它們地作用,昨天當我編譯源碼的時候,就在一個“@link”處報錯了,下面就總結下常用的@字元的意義。
(1)最讨厭的@字元
@hide字元一般出現在源碼類或者方法的開頭注釋部分,表示這個方法或者類是在google提供的sdk中隐藏起來的,不能直接調用。要是想使用可以用反射,編譯源碼等方法。
(2)@link
@link字元是可以單獨使用如:@link sth 或者@link sth1#sth2。主要是用來生成javadoc檔案使用。當我們去掉這個字元是否會對編譯造成影響我還在實驗,稍後會貼上結果。
(3)@param
@param出現的頻率最高,它也是javadoc也就是文本記錄的字元之一。主要是用來注釋以下方法中用到的參數的功能。
(4)@see
@see提示使用者相關的類或是函數資訊。