Annotation Processor

annotationProcessor和android-apt的功能是一样的，它们是替代关系。annotationProcessor是APT工具中的一种，他是谷歌开发的内置框架，不需要引入，可以直接在build.gradle文件中使用。android-apt是由一位开发者自己开发的apt框架，随着Android Gradle 插件 2.2 版本的发布，间接的进行了替代。

涉及注解相关知识：

@Retention的取值范围如下（代表注解的保留位置）：

RetentionPolicy.SOURCE 表示修饰的注解只在源码中保留，编译后就被遗弃了，也就是class文件中就不存在了。
RetentionPolicy.CLASS 表示修饰的注解保留到编译后的class文件，运行时就被遗弃。比如在运行时通过反射去获取这个注解，会发现是不存在的。
RetentionPolicy.RUNTIME 表示注解一直保留到运行时。

@Target:的取值范围如下（代表注解的作用目标）

@Target(ElementType.TYPE)——接口、类、枚举、注解
@Target(ElementType.FIELD)——字段、枚举的常量
@Target(ElementType.METHOD)——方法
@Target(ElementType.PARAMETER)——方法参数
@Target(ElementType.CONSTRUCTOR) ——构造函数
@Target(ElementType.LOCAL_VARIABLE)——局部变量
@Target(ElementType.ANNOTATION_TYPE)——注解
@Target(ElementType.PACKAGE)——包

@Document：该注解可以被包含在javadoc中
@Inherited：子类可以继承父类中的该注解

三方库依赖方式：

implementation：该依赖方式所依赖的库不会传递，只会在当前module中生效。
api：该依赖方式会传递所依赖的库，当其他module依赖了该module时，可以使用该module下使用api依赖的库。

compile已过时，已被 implementation 和api 取代

当我们依赖一些第三方的库时，可能会遇到com.android.support冲突的问题，就是因为开发者使用的compile或api依赖的com.android.support包与我们本地所依赖的com.android.support包版本不一样。

一、定义注解

在工程中添加一个java library类型的module，取名annotation

Android Studio -> file -> new module -> java library

备注：注解@IdRes 引用系统库，如果是jiavaLibrary需要单独添加引用

二、定义注解处理器

新建一个module，取名为compiler，类型必须为java librar（因为有用到 javax.*下的类文件)

Android Studio -> file -> new module -> java library

新建一个类MyProcessor，这类必须继承至 AbstractProcessor

备注：注解处理器创建完毕后，需要创建注册目录，如果是手动创建，目录如下：

 文件里面内容为自己处理器的全路径path

 建议使用谷歌的 AutoService，通过@AutoService注解标记一下，就可以自动完成注册动作，避免了手动创建错误，引用如下：

生成路径：

Processor 常用到的4个方法：

系统注解使用如下：

如果需要调试传递参数：

注解处理器所在库获取参数：

Map<String, String> options = processingEnv.getOptions();

注解相关的api可以参考：注解与APT注解处理器技术详解 - 简书

三、新建android library：inject

1.  
   public interface ViewBinder<T> {
2.  
   void bind(T target);
3.  
   }
4.  
    
5.  
    

1.  
   public class InjectView {
2.  
    
3.  
   public static void bind(Activity activity) {
4.  
   String className = activity.getClass().getName();
5.  
   try {
6.  
   // 得到我们生成的对应该Activity的ViewBinder类的Class对象
7.  
   Class<?> viewBinderClass = Class.forName(className "$$ViewBinder");
8.  
   ViewBinder viewBinder = (ViewBinder) viewBinderClass.newInstance();
9.  
   // 绑定Activity的控件
10.  
    viewBinder.bind(activity);
11.  
    } catch (ClassNotFoundException e) {
12.  
    e.printStackTrace();
13.  
    } catch (Exception e) {
14.  
    e.printStackTrace();
15.  
    }
16.  
    }
17.  
    }

引用如下：

api project(':annotation')

接下来开始生成代码文件了。。。

代码生成

生成java文件工具有：Filer(注解处理器自带)、JavaPoet（省去手工拼接字符串麻烦）

手工生成api如下：

拼接步骤麻烦，比如说换行符、导包操作等等。

javaPoet生成java文件，api如下：

 常用的api：

• addStatement() 方法负责分号和换行
• beginControlFlow() endControlFlow() 需要一起使用，提供换行符和缩进。
• addCode() 以字符串的形式添加内
• returns 添加返回值类型
• .constructorBuilder() 生成构造器函数
• .addAnnotation 添加注解
• addSuperinterface 给类添加实现的接口
• superclass 给类添加继承的父类
• ClassName.bestGuess(“类全名称”) 返回ClassName对象，这里的类全名称表示的类必须要存在，会自动导入相应的包
• ClassName.get(“包名”，”类名”) 返回ClassName对象，不检查该类是否存在
• TypeSpec.interfaceBuilder(“HelloWorld”)生成一个HelloWorld接口
• MethodSpec.constructorBuilder() 构造器
• addTypeVariable(TypeVariableName.get(“T”, typeClassName)) 
  会给生成的类加上泛型

占位符

• $L代表的是字面量
• $S for Strings
• $N for Names(我们自己生成的方法名或者变量名等等)
• $T for Types

具体api使用，可以参考，感谢感谢，写的挺好的：

代码生成如下：

调用如下：

1.  
   public class MainActivity extends AppCompatActivity {
2.  
    
3.  
   //关键
4.  
   @BindView(R.id.tv01)
5.  
   TextView tv01;
6.  
    
7.  
   @Override
8.  
   protected void onCreate(Bundle savedInstanceState) {
9.  
   super.onCreate(savedInstanceState);
10.  
    setContentView(R.layout.activity_main);
11.  
    //关键
12.  
    InjectView.bind(this);
13.  
    tv01.setText(Html.fromHtml("DD<font color='red'>注入初始化*</font>"));
14.  
     
15.  
     
16.  
    ViewBindId.setMsg(new String[]{"a","b","c"});
17.  
    ViewBinderAuto.setMsg(new String[]{"D","E","F"});
18.  
    try {
19.  
    new ViewBindId().close();
20.  
    } catch (Exception e) {
21.  
    e.printStackTrace();
22.  
    }
23.  
    }
24.  
    }

切记build.gradle添加相关引用：

implementation project(':inject')
//implementation project(':annotation')
annotationProcessor project(path: ':compiler')

手写拼接可以参考：EventBus，Dragger等开源库的基本原理。自动生成参考butterknife

参考：

Android关于AutoService、Javapoet讲解 - 帅气的码农 - 博客园

注解与APT注解处理器技术详解 - 简书

秒懂Android注解处理器（Android Annotation Processor）-蒲公英云

通过编译期生成代码方式实现的仿ButterKnife功能Demo

这篇好文章是转载于：学新通技术网