最近在看一個新的基於註解開發的專案，瞭解到Android中同樣存在一些註解框架，能夠大大提高我們的編碼規範和效率，減少程式碼量。本文主要分為兩部分，針對較熱門的註解框架Android Annotations在Android Studio上的配置進行詳解。

Android Annotations配置

1.首先，一個框架需要有它的依賴包，Annotations框架需要使用兩個jar包，我已經上傳在了我的資源上，點此下載

2.在新建的普通專案裡面，新建一個compile-libs資料夾，將下載來的androidannotation-xx.jar新增到compile-libs資料夾下，將androidannotation-api-xx.jar新增到libs資料夾下

，如圖：

3.新增完依賴包之後，還要為其配置，在Project的build.gradle下的dependencies節點新增：
classpath 'com.neenbedankt.gradle.plugins:android-apt:1.4'，如圖：

4.在Moudle的build.gradle下新增：
apply節點下：
apply plugin: 'android-apt'
def AAVersion = '3.2+'
-----------------------------------------------------------------------------
dependencies節點下：

apt "org.androidannotations:androidannotations:$AAVersion"
compile "org.androidannotations:androidannotations-api:$AAVersion"
compile 'com.android.support:support-v4:23.4.0'
------------------------------------------------------------------------------
新增一段apt：
apt {
    arguments {
        androidManifestFile variant.outputs[0].processResources.manifestFile
        resourcePackageName 'com.example.zjy.myapplication'
    }
}
如圖：

5.以上完成了基本的搭建，接下來還需要注意一點，AndroidAnnotations框架有一個特點，就是在編譯時會將我們的元件名後面加上一個下劃線，比如MainActivity就變為MainActivity_.class，所以如果我們要通過這個框架來進行開發，那需要在使用這些元件的時候都遵循這種規範，如圖，在AndroidMainfest.xml檔案中：

6.但是新增完之後你會發現專案報錯，識別不到xxxActivity_這個類名，那是因為還沒有編譯，需要將專案進行編譯，點選工具欄中的編譯按鈕(就圖案是010101，在選單欄Build下方的那個按鈕)：

執行專案若報錯：
com.android.builder.packaging.duplicateFileException

則根據所指的重複檔案的路徑，將在build.gradle檔案的android節點中新增：
 packagingOptions {
        exclude 'META-INF/maven/org.androidannotations/androidannotations-api/pom.xml'
        exclude 'META-INF/maven/org.androidannotations/androidannotations-api/pom.properties'
        exclude 'androidannotations-api.properties'
 }

再次執行，完美通過。

Android Annotations應用

AndroidAnnotations的基本應用：

[email protected](R.id.xxx)

這是最為基本的一個註解，表示該類是一個Activity，並且對應於哪個佈局檔案

@EActivity(R.layout.activity_main)
public class MainActivity extends Activity {

}

可以看到，我們沒有了onCreate方法，也沒有了setContentView方法，依然能夠執行出界面。

[email protected](R.id.xxx)

作用：相當於findViewById(R.id.xxx)。
在佈局檔案中定義一個按鈕：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fitsSystemWindows="true"
    >

    <Button
        android:id="@+id/btn"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

</LinearLayout>

在Activity中通過註解宣告該按鈕，注意按鈕要宣告為public不能為private：

@EActivity(R.layout.activity_main)
public class MainActivity extends Activity {

    @ViewById(R.id.btn)
    public Button btn;

}

[email protected](R.id.xxx)

作用：為該按鈕註冊監聽事件，表明該方法為該按鈕的點選事件方法

@EActivity(R.layout.activity_main)
public class MainActivity extends Activity {

    @ViewById(R.id.btn)
    public Button btn;

    @Click(R.id.btn)
    void myClick(){
        Toast.makeText(this,"AndroidAnnotations",Toast.LENGTH_SHORT).show();
    }

}

還可以對多個button進行註解，再通過switch進行判斷：

@Click({R.id.button1,R.id.button2,R.id.button3})  
void buttonClicked(Button btn){  
    switch(btn.getId()){  
    case R.id.button1:  
	//這裡實現button1的點選事件  
        break;  
        ...  
    }  
} 

[email protected]

作用：只有所有View都注入完畢之後，才會執行該註解的方法，一般進行一些初始化的操作

@EActivity(R.layout.activity_main)
public class MainActivity extends Activity {

    @ViewById(R.id.btn)
    public Button btn;

    @Click(R.id.btn)
    void myClick(){
        Toast.makeText(this,"AndroidAnnotations",Toast.LENGTH_SHORT).show();
    }

    @AfterViews
    void init(){
        btn.setText("按鈕注入完畢後才執行此方法");
    }

}

[email protected](String params)

作用：獲得其它地方跳轉過來時所傳遞過來的資料，括號中的字串即為傳遞過來的資料的key
如下例子：

MainActivity中：

Intent intent = new Intent(MainActivity.this,SecondActivity_.class);
Bundle bundle = new Bundle();
bundle.putString("hello","hello");
intent.putExtras(bundle);
startActivity(intent);

SecondActivity：

@EActivity(R.layout.activity_second)
public class SecondActivity extends Activity{

    @Extra("hello")
    String params;

    @AfterViews
    void init(){
        Toast.makeText(this,params,Toast.LENGTH_SHORT).show();
    }
}

跳轉的時候注意加下劃線：

Intent intent = new Intent(MainActivity.this,SecondActivity_.class);
startActivity(intent);

[email protected]和@UiThread

@Background作用：相當於用來進行後臺操作的方法(比如請求網路資源，操作檔案等等)，被Backgroung註解的方法裡面不能進行任何UI操作，否則會報錯。

@Background
void httprequest(){
     //進行http操作
     //操作資料庫
     //操作檔案
}

@UiThread作用：相當於用來進行UI控制元件的操作，被UiThread註解的方法裡面不能進行任何後臺操作，否則會報錯

@UiThread
void runinUI(){
     Toast.makeText(this,"AndroidAnnotations",Toast.LENGTH_SHORT).show();
}

如何將兩者結合使用：

@AfterViews
void init(){
    httprequest();
}

@Background
void httprequest(){
    //進行http操作
    //操作資料庫
    //操作檔案

    //執行完後臺操作之後再執行UI操作
    runinUI();
}

@UiThread
void runinUI(){
    Toast.makeText(this,"UiThread",Toast.LENGTH_SHORT).show();
}

[email protected]

作用：用來標識該類是一個Fragment，並對應哪個佈局檔案

@EFragment(R.layout.layout_myfragment)
public class MyFragment extends Fragment{

}

[email protected]

作用：用來給當前Fragment接收別的地方傳來的資料
MainActivity中：

@EActivity(R.layout.activity_main)
public class MainActivity extends Activity {

    @ViewById(R.id.btn)
    public Button btn;

    @Click(R.id.btn)
    void myClick(){
        MyFragment fragment = new MyFragment_();
        Bundle bundle = new Bundle();
        bundle.putString("hello","...");
	//設定傳遞的引數
        fragment.setArguments(bundle);
        FragmentTransaction transaction = getFragmentManager().beginTransaction();
        transaction.add(R.id.content, fragment);
        transaction.commit();
    }
}

activity_main.xml：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    >

    <Button
        android:id="@+id/btn"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />
    <FrameLayout
        android:id="@+id/content"
        android:layout_width="match_parent"
        android:layout_height="wrap_content">
    </FrameLayout>

</LinearLayout>

MyFragment類：

@EFragment(R.layout.layout_myfragment)
public class MyFragment extends Fragment{


    @FragmentArg("hello")
    String params;

    @AfterViews
    void init(){
        Toast.makeText(getActivity(), params, Toast.LENGTH_SHORT).show();
    }

}

layout_myfragment.xml：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    >
</LinearLayout>

注意：FragmentArg括號中的引數要跟bundle所裝載的資料的key一致，才能接受到傳過來的資料。

以上介紹了比較常用的幾種註解，Annotaions框架還提供了很多其他的註解，如下：

@AfterInject 定義的方法在類的構造方法執行後執行

@AfterTextChange定義的方法在TextView及其子類的Text屬性改變後執行

@BeforeTextChange 定義的方法在TextView及其子類的Text屬性改變前執行

@EProvider 在 ContentProvider中啟用Annotations

@EReceive 在BroadcastReceiver中啟用Annotations

@EService 在Service中啟用Annotations

@EView 在自定義的View的子類中啟用Annotations

......等等，有興趣的朋友可以去看Annotations的官方API文件

總結：Annotations確實為我們的開發帶了許多方便，特別是在大型的專案下，不再需要一遍遍的findViewById,不再需要一遍遍地setContentView，同時另一方面又提高了程式碼的簡潔度和可讀性，所以相信其運用到實際開發中是非常有幫助的。