天天看點

android源碼出現的@字元意義總結(轉載請注明出處:http://blog.csdn.net/buptgshengod)1.背景2.總結篇

       在android源碼中我們能看到各種以@開頭的字元,他們大多出現在注釋中,如下圖所示

android源碼出現的@字元意義總結(轉載請注明出處:http://blog.csdn.net/buptgshengod)1.背景2.總結篇

但是可不要小看了它們地作用,昨天當我編譯源碼的時候,就在一個“@link”處報錯了,下面就總結下常用的@字元的意義。

(1)最讨厭的@字元

       @hide字元一般出現在源碼類或者方法的開頭注釋部分,表示這個方法或者類是在google提供的sdk中隐藏起來的,不能直接調用。要是想使用可以用反射,編譯源碼等方法。

(2)@link

      @link字元是可以單獨使用如:@link sth 或者@link sth1#sth2。主要是用來生成javadoc檔案使用。當我們去掉這個字元是否會對編譯造成影響我還在實驗,稍後會貼上結果。

(3)@param

        @param出現的頻率最高,它也是javadoc也就是文本記錄的字元之一。主要是用來注釋以下方法中用到的參數的功能。 

(4)@see

           @see提示使用者相關的類或是函數資訊。

繼續閱讀