Android第三方注解框架Annotations和butterknife

使用注解，可以帮我们去实现一些简单而重复的工作，使得开发效率得到有效提升，免去不必要的时间花费。像findViewById，既可以省时间，也省去了代码量。

AndroidAnnotations

AndroidAnnotations是一个开源的注解框架，可以加快Android开发。通过它，让你专注于你真正重要的。通过简化你的代码，更有利于它的维护。

主 页: http://androidannotations.org/
Github 主页: https://github.com/excilys/androidannotations

一.配置开发环境

此配置为Android studio的配置

在project的build.gradle文件中，添加以下部分

// Top-level build file where you can add configuration options common to all sub-projects/modules.buildscript {    repositories {        jcenter()        mavenCentral() //添加的部分    }    dependencies {        classpath 'com.android.tools.build:gradle:1.3.0'        classpath 'com.neenbedankt.gradle.plugins:android-apt:1.4' //添加依赖        // NOTE: Do not place your application dependencies here; they belong        // in the individual module build.gradle files    }}//添加的部分---------->>repositories {    mavenCentral()    mavenLocal()}// <<----------------allprojects {    repositories {        jcenter()    }}task clean(type: Delete) {    delete rootProject.buildDir}

在需要用到此框架的module的build.gradle文件中，添加以下部分

apply plugin: 'com.android.application'apply plugin: 'android-apt' //添加的部分def AAVersion = '3.3.2' //添加的部分，自定义了一个变量“版本号”android {    compileSdkVersion 23    buildToolsVersion "23.0.0"    defaultConfig {        applicationId "com.ql.annotationsdemo"        minSdkVersion 10        targetSdkVersion 23        versionCode 1        versionName "1.0"    }    buildTypes {        release {            minifyEnabled false            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'        }    }}dependencies {    compile fileTree(dir: 'libs', include: ['*.jar'])    testCompile 'junit:junit:4.12'    compile 'com.android.support:appcompat-v7:23.1.0'    compile 'com.android.support:design:23.1.0'    apt "org.androidannotations:androidannotations:$AAVersion" //添加依赖    compile "org.androidannotations:androidannotations-api:$AAVersion" //添加依赖    compile 'com.jakewharton:butterknife:5.1.1'}//添加的部分------------->>>apt {    arguments {        androidManifestFile variant.outputs[0].processResources.manifestFile        // if you have multiple outputs (when using splits), you may want to have other index than 0        // you should set your package name here if you are using different application IDs        // resourcePackageName "your.package.name"        // You can set optional annotation processing options here, like these commented options:        // logLevel 'INFO'        // logFile '/var/log/aa.log'    }}// <<<-------------------

成功后即可在代码中使用

二.常用标签

 标签   |   等同于

@EActivity setContentView 绑定布局视图
@ViewById findViewById
@Click setOnClickListener 单击事件
@Extra intent.getExtra 活动之间的intent传值
@AfterViews View初始化完成
@ItemClick ListView Item单击事件
@ItemLongClick ListView Item长按事件
@Background 后台运行
@UIThread 前台运行

三.注意：

1.AndroidManifest.xml中注册的activity要在原类名后追加下划线“_”
2.使用注解的控件和方法不能使用private修饰符
3.使用 @Click @ItemClick @ItemLongClick标签必须指明ID
4.控件设置初始值要在生命周期的onResume()方法中或者使用@AfterViews标签
5.使用@EActivity标签绑定布局视图必须要在class的外面（跟import同一级）

四.示例

import android.content.Intent;import android.os.Bundle;import android.support.v7.app.AppCompatActivity;import android.widget.TextView;import org.androidannotations.annotations.AfterViews;import org.androidannotations.annotations.Click;import org.androidannotations.annotations.EActivity;import org.androidannotations.annotations.ViewById;@EActivity(R.layout.activity_main)public class MainActivity extends AppCompatActivity {    public static final String EXTRA_KEY_NAME = "name";    public static final String EXTRA_KEY_AGE = "age";    @ViewById(R.id.textView)    TextView textView;    @ViewById    TextView textView2;    @Click(R.id.button)    public void doSomething() {        Intent intent = new Intent(this, BActivity_.class);        intent.putExtra(EXTRA_KEY_NAME, "zhangsan");        intent.putExtra(EXTRA_KEY_AGE, 16);        startActivity(intent);    }    @Override    protected void onResume() {        super.onResume();    //设置值方式1//  textView.setText("this is from annotation");    }    //设置值方式2    @AfterViews    public void setcontent(){        textView.setText("this is from annotation");        textView2.setText("this is textview2");    }    @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);    }}

BActivity.java

@EActivity(R.layout.activity_b)public class BActivity extends Activity {    @Extra(MainActivity.EXTRA_KEY_NAME)    String name;    @Extra(MainActivity.EXTRA_KEY_AGE)    int age;    @ViewById    TextView tv_name;    @ViewById    TextView tv_age;    @Override    protected void onResume() {        super.onResume();        tv_name.setText(name);        tv_age.setText(age + "");    }}

---

butterknife

相比于AndroidAnnotations，功能更少，使用却比较方便，用于做findViewById工作。

1.使用步骤

1.添加依赖
在需要用到的module中的build.gradle文件中

compile 'com.jakewharton:butterknife:5.1.1'

或

2.安装插件
选择在线安装，安装完成重启一下

3.使用
在活动中将布局单词选中或者将光标置于单词中，鼠标右键选择Generate。或者使用键盘Alt + insert。会看到Generate butterknife injections这一项。点击确定，即可列出布局文件中所有带ID的控件

4.示例

5.注意
布局文件中的控件必须要指定ID，才会将其显示列出