Hello 大家好，我是刘某人
注解不是必须的，但是能极大的帮助我们节约时间和提高开发效率，写此篇文章的初衷，是我课程中的同学想要了解一下这个框架，遂写下此篇文章，其实我们如果想了解Annotations这个框架的话，他的官方示例写得还是比较详细的：
如果你学习我的视频课程，哪怕课程之外的知识点，如果有时间，我也会帮助你提升的，授人予鱼不如授人予渔，我时刻都在培养同学的思维逻辑，只要哪天开窍了，一切都变得简单明了了。
推荐我的慕课网Android实战课程，助你暴力提升Android技术。
Android X/音视频开发/社交匹配算法/即时通信/语音识别/App优化/安全加固
相对于其他的注解框架，如XUtils、ButterKnife、Dragger等，Annotations的优势在于没有使用到反射，不影响性能，所以如果论性能，Annotations应该是最好的。
不过据说Google官方推出注解框架之后，Annotations的作者就不在更新了。
不过不得不说Annotations的配置要麻烦许多，所以我建议如果不是必须的话，这个还是少用一些，不然重构代码比较麻烦，当然，我现在说这些，对于没有用过Annotations的同学来讲，可能还不太理解，跟着我一起来看下吧。
首先我们来配置一下所需的Gradle，配置Gradle分为两步，第一步是添加依赖
可以看到我定义了一个变量AAVersion来定义版本，第二步则是添加Java编译的配置：
我们在defaultConfig节点中配置如上代码是因为Annotations的编译不像其他框架一样反射，而是通过生成一份子类代码来帮助运行，所以找不到清单文件，我们自己配置下即可。
当然，这个时候还是无法运行的，上面说到Annotations的编译是生成一份子类，所以我们的清单文件也需要修改，在每一个声明的类中加上下划线，如下代码：
做完这些，我们的配置才OK，那么接下来就看下我们怎么使用吧。
Annotations对Android中一些重量级的组件都做了增加，我们来看下
1.Activity
首先是如何声明一个Activity的View,传统的写法是setContentView,但是有了Annotations之后，我们可以使用@EActivity这个标签
@EActivity(R.layout.activity_main)
public class MainActivity extends AppCompatActivity {
//Anything
}
2.Application
关于Appliation，是必须要使用@EApplication这个标签的
@EApplication
public class BaseApp extends Application {
//Anything
}
然后则是在清单文件中注册了，记得加上下划线哦
如果想要使用的话，需要使用@App标签
@App
BaseApp mApp;
具体的可以查阅Github wiki
3.Bean
关于实体类，我们可以使用@EBean
@EBean
public class JavaBean {
//Anything
}
如果想要使用的话，需要使用@Bean标签
@Bean
JavaBean mBean;
具体的可以查阅Github wiki
4.Fragment
关于Fragment就有意思了，首先我们需要使用@EFragment来注解，这个是没问题的，和@EActivity的用法是一样的
@EFragment(R.layout.fragment_main)
public class MainFragment extends Fragment {
//Anything
}
这样我们就不需要再调用onCreateView了，当然如果你想使用到onCreateView中的Bundle那么你直接return null 即可，说完注解，我们再来说一下使用，使用是需要下划线的，比如我们在xml中则是如下：
如果是在代码中，则可以使用下面两种任选其一：
MainFragment mFragment = new MainFragment_();
//or
MainFragment mFragment = MainFragment_.builder().build();
5.Provider
内容提供者倒是没什么太大的区别，使用@EProvider注解即可。
6.BrocastReceiver
广播的话分为动态广播和静态广播，动态注册最为简单
@Receiver(actions = TEST_ACTION)
protected void test() {
//收到广播
}
我们可以看到只需要通过@Receiver注解标记需要接收的actions即可，而静态广播如下
@EReceiver
public class JavaReceiver extends BroadcastReceiver {
//可以接收Context,Intent 两个参数
@ReceiverAction(actions = MainActivity.TEST_ACTION)
void test() {
//收到广播
}
@Override
public void onReceive(Context context, Intent intent) {
//什么都不用做
}
这里我们也是一样的，我定义了一个test，并且你也可以自己传递上下文或者intent
7.Service
服务的话有两个，一个IntentService和一个Service，我们先来看下IntentService
@EIntentService
public class MainIntentService extends IntentService {
public MainIntentService() {
super("MainIntentService");
}
@ServiceAction
void myAction(String param) {
//接收参数
}
@Override
protected void onHandleIntent(Intent intent) {
//什么都不做
}
代码很简单，我们使用@EIntentService注解来标记，使用@ServiceAction注解来接收传递的参数，再来看下我们常见的Service,其实只是使用了@EService注解，我们具体看下他的启动和停止的方法吧。
//启动服务
MainService_.intent(this).start();
//停止服务
MainService_.intent(this).stop();
8.View
View的情况实际上也是两种，一种是View，一种是ViewGroup,如果是View的话只需要@EView注解即可
当然，使用的方式也分两种，xml或者代码，先看xml
<com.liuguilin.androidannotations.view.MyTextView_
android:text="MyTextView"
android:layout_width="wrap_content"
android:layout_height="wrap_content"/>
xml包括清单文件中一定要注意下划线，在代码中可以这样
MyTextView mTextView = MyTextView_.build(this);
如果是ViewGroup的话使用@ViewGroup(R.layout.xxx)
具体的可以查阅Github wiki
关于注入的注解关键字，其实上面已经有讲到一些了，比如@App @Bean 等都是，我们继续来看其他的基本操作
1.ViewById / ViewsById
这两个都是负责初始化的，相信大家一眼就知道什么意思，替代我们的findViewById
@ViewById(R.id.mTextView)
TextView mTextView;
@ViewsById({R.id.mTextView, R.id.mYourTextView})
List<TextView> mTextViews;
2.Extra
扩展属性，常用于Intent的扩展，说白了就是intent的传值，所以我们可以这样使用，这里我的案例是MainActivity跳转FirstActivity，所以我们的FirstActivity可以这样区写：
@EActivity(R.layout.activity_first)
public class FirstActivity extends AppCompatActivity {
@ViewById(R.id.tvFirst)
TextView tvFirst;
@Extra("Name")
String mName;
@AfterViews
void initView() {
tvFirst.setText(mName);
}
可以看到代码还是很明朗的，我初始化了一个文本控件然后接受外部传递的mName设置给文本，那么外部是如何调用的？
FirstActivity_.intent(this).mName("刘桂林").start();
一行代码即可。
3.AfterViews
我们如果使用ViewById初始化后，在onCreate使用这个对象你会发现是无法使用的，事实上这个时候还没有初始化，AfterViews就是用来告知我们试图已经初始化完成，我们标准的写法是这样的：
@EActivity(R.layout.activity_main)
public class MainActivity extends AppCompatActivity {
@ViewById(R.id.mTextView)
TextView mTextView;
@AfterViews
void init(){
mTextView.setText("Hello");
}
4.FragmentArg
顾名思义，这个是在Fragment中使用的，并且看名字就知道是什么意思了，首先是@FragmentArg，这个注解和@Extra是一样的，用来传递参数
MainFragment mFragment = MainFragment_
.builder()
.fragmentArg("Hello")
.build();
至于 FragmentById / FragmentByTag 这些不常用的可以自行查阅wiki
5.FromHtml
假设你的strings.xml中有一个html的参数，那么常见的做法是使用Html类去转换成String再赋值给TextView,而使用@FromHtml则无需这么复杂，我们来看下
<string name="hello_html"><![CDATA[Hello <b>World</b>!]]></string>
这是一段html，我们来加载
@ViewById(R.id.mTextView)
@FromHtml(R.string.hello_html)
TextView mTextView;
这样即可。
6.NonConfigurationInstance
这也是个相对冷门的注解了，当我们的Config配置发生更改，比如切换语言的时候，我们的对象会销毁重建，但是使用此注解可以保存实例
7.SystemService
我们如果需要getSystemService初始化的系统服务都可以使用此注解免去这一个步骤。
1.Text 变化
如果我们要监听EditText的输入文本改变，则需要实现他的TextWatcher.onTextChanged接口，但是注解框架为我们提供了诸多方便的接口，如：
- TextChange
- BeforeTextChange
- AfterTextChange
看如下代码：
@AfterTextChange(R.id.mEditText)
void afterTextChanged(Editable text) {
//开始改变
}
@TextChange(R.id.mEditText)
void onTextChanges(CharSequence text, int before, int start, int count) {
//正在改变
}
@BeforeTextChange(R.id.mEditText)
void beforeTextChanged(CharSequence text, int start, int count, int after) {
//结束改变
}
其中参数除了text其他的都是可选项
2.状态 变化
状态变化主要取决于焦点以及编辑状态，还有选中，我们可以使用 @FocusChange @EditorAction @CheckedChange
3.事件 监听
事件监听就很多了，比如我们的点击事件，触摸事件，长按事件等
@Click(R.id.mClick)
void BttonClick() {
//点击事件
}
@LongClick(R.id.mClick)
void BttonLongClick() {
//长按事件
}
@Touch(R.id.mClick)
boolean BttonTouchClick(MotionEvent event) {
//触摸事件
return false;
}
当然，我们还有Adapter中的事件监听，如 @ItemClick @ItemLongClick @ItemSelect
还有我们的menu其实也是可以这样设置点击的，我们来看下如下代码
@OptionsMenu(R.menu.main)
@EActivity(R.layout.activity_main)
public class MainActivity extends AppCompatActivity {
@OptionsItem(R.id.menu_help)
void Help() {
//Anything
}
}
这样即可实现menu与menu的点击事件
4.SeekBar 监听
以往我们监听SeekBar是需要设置监听的，现在不用啦。
@SeekBarTouchStart(R.id.mSeekBar)
void SeekBarTouchStart(SeekBar seekBar) {
//触摸开始
}
@SeekBarProgressChange(R.id.mSeekBar)
void onProgressChangeOnSeekBar(SeekBar seekBar, int progress, boolean fromUser) {
//触摸变化
}
@SeekBarTouchStop(R.id.mSeekBar)
void SeekBarTouchStop(SeekBar seekBar) {
//触摸结束
}
5.按键 事件
按键共有四个
- KeyDown 按下
- KeyUp 抬起
- KeyLongPress 长按
- KeyMultiple 多按
6.ViewPager 监听
ViewPager监听以往是需要addPageListener的，现在提供了三个注解
- PageScrollStateChanged
- PageScrolled
- PageSelected
1.后台线程
我们如果想要在子线程中运行，以往都是new Thread().start的，现在只需要@Background
即可，它表示在主线程以外的线程执行
2.主线程
主线程也就是ui线程，我们使用@UiThread注解，代替 runUIThread方法
其他还有很多，我们来看下
- InstanceState 保存状态
- WindowFeature 窗口功能
- Fullscreen 全屏
- CustomTitle 自定义标题
- InjectMenu 注入菜单
- OptionsMenu 菜单
- OptionsMenuItem 菜单Item
- OrmLiteDao 数据库
- RoboGuice
- Trace 日志条目
- Transactional 数据库事务任务
- OnActivityResult Activity回调
- OnActivityResult.Extra Activit回调扩展值
- HierarchyViewerSupport
- ServiceAction 服务信号
- Receiver 广播
- Receiver.Extra 广播扩展值
- ReceiverAction 广播信号
- ReceiverAction.Extra 广播信号扩展值
- IgnoredWhenDetached
- IgnoreWhen
- WakeLock 锁屏
- DataBound 数据绑定
- StringRes 字符串
- AnimationRes 动画
- ColorRes 颜色
- DimensionPixelOffsetRes 数字
- DimensionPixelSizeRes 数字
- DimensionRes 数字
- BooleanRes 布尔
- ColorStateListRes 颜色状态
- DrawableRes 图片
- IntArrayRes 整型数组
- IntegerRes 整型
- LayoutRes 布局
- MovieRes 电影
- StringArrayRes 字符串数组
- TextArrayRes 文本数组
- TextRes 文本
- HtmlRes 网页
到这里，其实大部分常用的Api都已经有所讲解了，不过在实际开发中可能还会有一些需要注意的事项，不过不用担心，多看下wiki即可，国内的博客领域比较凌乱，其实很难找到实用的东西，所以需要自己耐心一点，当然还有Rest Api ，Typesafe SharedPreferences，Preference API helpers 这些就不讲了，感兴趣的可以看下Github wiki，一法通万法，掌握了学习知识的技巧，很多东西哪怕不了解，摸索一下也能快速上手的。
源码下载
链接：https://pan.baidu.com/s/1QzkVUsIPKAv1veM9gSuwEw
密码：t35a
推荐我的慕课网Android实战课程，助你暴力提升Android技术。
Android X/音视频开发/社交匹配算法/即时通信/语音识别/App优化/安全加固