android源碼出現的@字符代表什麼意思

1.背景

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

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

2.總結篇

（1）最討厭的@字符

<span style="font-size:18px;">@hide</span>

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

（2）@link

<span style="font-size:18px;">@link</span>

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

（3）@param

<span style="font-size:18px;">@param</span>

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

<span style="font-size:18px;">/** 
*@param context 
*@param attrs 
*/
Public DotView(Context context, Attribute attrs) {  
     super(context, attrs);  
     setFocusAbleInTouch(true);  
}</span>

（4）@see

<span style="font-size:18px;">@see</span>

@see提示用戶相關的類或是函數信息。

<span style="font-size:18px;">public abstract class MyBase {  
  protected abstract void myFunc();  
}  
      
class MyImpl extends MyBase {  
      
  /** 
   * @see MyBase#myFunc() 
   */
  @Override
  protected void myFunc() { .. }  
}</span>