arouter编译器注解

A. ARouter源码分析

Annotation Processing Tool，自定义注解处理器。
搞Android的基本上都知道这个吧。许多第三方库都使用了APT去实现自己的功能，比如butterknife，比如X2C，比如我们要讲的ARouter。
其基本做法是：

一般是自定义gradle Transform + ASM，实现AOP，可以在编译期修改project和第三方依赖库中的class文件（比如ARouter源码中的arouter-gradle-plugin模块），与APT主要是生成.java文件不同，ASM操作的是.class文件。
自定义gradle Transform功能很强大，可以与ASM结合，修改.class，也可以操作资源文件(比如统一压缩图片，转png大图为webp等)。
至于ASM，基于修改.class文件，我们即可以用ASM来插桩统计方法耗时，也可以用来实现自动化埋点，甚至是修改第三方lib中的crash...

使用方法可以看 ARouter 。
带着问题看源码，这里主要的问题是：

ARouter的核心方法。

这个方法算是核心中的核心了。
其实也只做了两件事情

总的来说，只干了一件事情，扫描所有的dex文件，找到com.alibaba.android.arouter.routes包下的所有文件并返回。这里的操作都是耗时操作。
但是com.alibaba.android.arouter.routes包下都是什么文件呢？
比如：

比如：

比如：

比如：

这些都是APT生成的辅助类。

①项目编译期，通过APT，生成辅助类（所有的辅助类包名都是com.alibaba.android.arouter.routes）
包括

②ARouter#init初始化的时候，扫描dex文件，找到①生成的辅助类文件（也即是包com.alibaba.android.arouter.routes下的文件），放到routerMap中

注意，这里没有实例化IRouteGroup，IRouteGroup的信息都在IRouteRoot中，这样做的目的是为了实现分组route的加载，用到了哪个group的route的信息，才会加载这个group的信息，没用到就不加载。这里可以仔细想想IProviderGroup/IInterceptorGroup/IRouteGroup的区别。
该方法执行完了以后，

至此，就完成了初始化路由表的操作。
我们回过头来瞄一眼ARouter#init，里面初始化路由表以后，执行了_ARouter#afterInit

这一句看着很熟悉。

页面路由跳转/IProvider/拦截器都是ARouter.getInstance().build("/test/activity").navigation()这种形式的话，我们就先从拦截器interceptorService = (InterceptorService) ARouter.getInstance().build("/arouter/service/interceptor").navigation();开始分析吧。

虽然这里我们是想看拦截器的实现，但是要明确一点：InterceptorServiceImpl是IProvider的实现类，获取InterceptorService也就是获取一个IProvider。有一点绕，简单来说，ARouter使用一个IProvider来实现拦截器的初始化。
后面的逻辑就变成了获取一个IProvider上了。

也即是ARouter.getInstance().build("/arouter/service/interceptor").navigation()方法中，ARouter.getInstance().build("/arouter/service/interceptor")做的事情就是创建一个Postcard，其path是"/arouter/service/interceptor",group是"arouter".

简单来说，这里做的事情有

注意addRouteGroupDynamic(postcard.getGroup(), null)这个方法，通过groupName去groupIndex中查找，那"arouter"对应的是谁呢？正是ARouter$$Group$$arouter.class。
反射创建ARouter$$Group$$arouter对象，并执行ARouter$$Group$$arouter#loadInto方法

现在我们回过头来继续看LogisticsCenter#completion

总结一下LogisticsCenter#completion方法做了啥：

以ARouter.getInstance().build("/arouter/service/interceptor").navigation()举例说明就是：

init方法做的事情很单一，就是一次性实例化全部的拦截器，存到 Warehouse.interceptors中。（想想为什么要这么做？）
这样，ARouter.getInstance().build("/arouter/service/interceptor").navigation()就分析完了，ARouter#init的时候,会创建所有的拦截器实例。ARouter.getInstance().build("/arouter/service/interceptor").navigation()方法返回的是InterceptorServiceImpl的实例。

另外，_ARouter#navigation(Context, Postcard, int, NavigationCallback)方法的最后，调用了_ARouter#_navigation

方法看着长，内容却很简单：

这样， ARouter#init 就分析完了， 总结 一下：

另外使用ARouter.getInstance().build("path").navigation()方法 获取IProvider的流程 如下：

Activity跳转的流程如下：

至此，我们回答了问题1/问题2和问题4.
下面我们来看下剩下的问题
问题3：拦截器是如何生效的？
我们可以看看_ARouter

执行_ARouter#navigation的时候，执行了interceptorService.doInterceptions方法，前面我们已经知道，执行了interceptorService实际上是InterceptorServiceImpl。

这里一个一个调用拦截器，如果有拦截器拦截，就中断调用，否则，调用下一个拦截器进行拦截。

所以， 拦截器 总结如下

最后，我们来看下最后一个问题。
问题5 ARouter的Gradle Plugin做了哪些优化？
该问题的关键是LogisticsCenter#loadRouterMap

上面的是gradle plugin修改之前的，下面的loadRouterMap是gradle plugin修改之后的。

瞄一眼register方法我们就能明白，这还是之前的那一套，跟不使用gradle plugin不同的地方在于，这里不需要扫描dex去找IRouteRoot/IInterceptorGroup/IProviderGroup，在编译期，gradle plugin就已经找到了这些，然后生成新的loadRouterMap方法。

B. ARouter框架使用总结及思考

ARouter框架不仅提供了强大的路由跳转功能，还有其他的能力。该框架对模块解耦，组件化设计提供了强有力的支持。

ARouter框架提供的具体功能包括Native页面跳转，URL页面跳转，获取Fragment，提供能力接口，拦截器等。

ARouter框架最基础的能力就是页面跳转。针对模块中支持外部模块跳转的页面，可以配置ARouter的注解，便于模块内外跳转到该页面。页面跳转的方法简明易用，不需要知道页面的class信息，避免模块间的耦合性。

1、普通的页面跳转
build的入参可以是build(String path)、build(String path, String group)(D eprecated，不建议使用)、build(Uri url)三种。ARouter的path一般包括两个层级"/group/pageName"。

传入参数Uri时，ARouter可以按照Uri的解析规则，获取Uri的path数据传入build函数。Uri解析规则如图

2、带参数页面跳转
可以通过with(bundle)，withString(key, value)等传递数据。目标页面通过getIntent获取参数。

ARouter支持通过Autowired自动装配参数，框架来完成字段的赋值。

3、支持startActivityForResult的页面跳转
navigation的第一个参数必须时Activity，第二个参数是requestCode。在Activity中重写onActivityResult(int requestCode, int resultCode, Intent data)即可处理返回信息

4、NavigationCallback
可以通过NavigationCallback监控页面跳转的情况。

ARouter支持在h5页面中，通过URL直接跳转到原生页面。关于URL调起Intent的内容也可参考 为什么可以通过URL来调起APP - URL Scheme和Intent

可以通过对Fragment添加注解，后续通过ARouter获取Fragment实例。这对模块划分，APP壳工程开发，提供了便利性。

ARouter支持模块通过声明接口来对外提供能力，获取数据等。首先通过定义IProvider的子接口，进而实现该子接口来提供能力。这个功能有助于实现模块之间的解耦。

接口支持同步回调，也可以使用callback参数进行异步回调。在考虑组件化开发中，和同事讨论如何避免不同模块之间传递数据结构，暂定采用json来在传输。后续的设想是调研跨模块数据结构传输方案，参考aidl。

不过也可通过提供多个能力接口来避免复杂的数据结构传输。

使用方可通过依赖注入，通过路径或接口类名来获取接口实例，进而提供服务。

参考文档
为什么可以通过URL来调起APP - URL Scheme和Intent

C. 毫无关系的组件之间的通讯怎么实现

> 组件间通信包括两个场景：（1）UI 跳转；（2）调用组件某个类的某个方法

ARouter组件间通信- https://github.com/alibaba/ARouter
支持依赖注入注解，可单独作为依赖注入框架使用；支持添加多个拦截器，自定义拦截顺序；

Android-Demos/LiteRouter/- https://github.com/hiphonezhu/Android-Demos/tree/master/LiteRouter
> 项目组件化

那么什么是组件化？概括为：组件化是基于可重用目的将项目按照具体业务需求进行拆分，并能将拆分得到的组件进行灵活重组，减小耦合(业务需求上的拆分)。

组件化项目- https://github.com/JessYanCoding/ArmsComponent

Android组件化方案- http://blog.csdn.net/guiying712/article/details/55213884
Android 组件化探索与思考- https://github.com/WuXiaolong/MolarSample
Android项目组件化AndroidMolePattern(阿里ARouter作为路由)- https://github.com/guiying712/AndroidMolePattern
Router activities and methods with url for android- https://github.com/mzule/ActivityRouter
组件化项目Router的其他方案-阿里ARouter- https://github.com/alibaba/ARouter

Android组件化方案- http://blog.csdn.net/guiying712/article/details/55213884
Android组件化之终极方案- http://blog.csdn.net/guiying712/article/details/78057120

Android组件化和插件化开发- https://www.cnblogs.com/android-blogs/p/5703355.html
组件化：随着业务量的不断增长，app也会不断的膨胀，开发团队的规模和工作量也会逐渐增大，面对所衍生的64K问题、协作开发问题等，app一般都会走向组件化。组件化就是将APP按照一定的功能和业务拆分成多个组件mole，不同的组件独立开发，组件化不仅能够提供团队的工作效率，还能够提高应用性能。而组件化的前提就是解耦，那么我们首先要做的就是解耦页面之间的依赖关系

Native与H5的问题：现在的APP很少是纯Native的，也很少会有纯H5的，一般情况下都是将两者进行结合。这时候就需要非常便捷并且统一的跳转方案，因为在H5中是无法使用StartActivity()跳转到Native页面的，而从Native跳转到H5页面也只能通过配置浏览器的方式实现

D. Android-ARouter原理解析

ARouter使用的是APT（Annotation Processing Tool）注解处理器，通过给对应的类添加注解，在编译器动态生成对应的路由表文件。这里以分析ARouter的RouteProcessor。在ARouter的使用配置上，需要给base库配置

然后给每个组件都配置annotationProcessor，如果使用kotlin，则使用kapt
接着给每个组件都配置上下面的内容：

这个配置主要是通过这个annotationProcessorOptions获取到key为AROUTER_MODULE_NAME的值，这个值其实就是mole的name，这个的作用就是作为一个Root文件的命名的，因为一个mole中可能会有多个group，而多个group归属于一个Root，而ARouter的做法就是将一个mole作为一个Root。

Element 是一个接口，它只在编译期存在和Type有区别，表示程序的一个元素，可以是package，class，interface，method,成员变量，函数参数，泛型类型等。

它的子类包括ExecutableElement, PackageElement, Parameterizable, QualifiedNameable, TypeElement, TypeParameterElement, VariableElement。

Element的子类介绍：

ExecutableElement:表示类或者接口中的方法，构造函数或者初始化器。

PackageElement :表示包程序元素

TypeELement:表示一个类或者接口元素

TypeParameterElement:表示类，接口，方法的泛型类型例如T。

VariableElement：表示字段，枚举常量，方法或者构造函数参数，局部变量，资源变量或者异常参数。

Element只在编译期可见

asType()： 返回TypeMirror,TypeMirror是元素的类型信息，包括包名，类(或方法，或参数)名/类型。TypeMirror的子类有ArrayType, DeclaredType, DisjunctiveType, ErrorType, ExecutableType, NoType, NullType, PrimitiveType, ReferenceType, TypeVariable, WildcardType ，getKind可以获取类型。

equals(Object obj)： 比较两个Element利用equals方法。

getAnnotation(Class<A> annotationType)： 传入注解可以获取该元素上的所有注解。

getAnnotationMirrors()： 获该元素上的注解类型。

getEnclosedElements()： 获取该元素上的直接子元素，类似一个类中有VariableElement。

getEnclosingElement()： 获取该元素的父元素,如果是PackageElement则返回null，如果是TypeElement则返回PackageElement，如果是TypeParameterElement则返回泛型Element

getKind()：返回值为ElementKind,通过ElementKind可以知道是那种element，具体就是Element的那些子类。

getModifiers()： 获取修饰该元素的访问修饰符，public，private。

getSimpleName()： 获取元素名，不带包名，如果是变量，获取的就是变量名，如果是定义了int age，获取到的name就是age。如果是TypeElement返回的就是类名。

getQualifiedName()：获取类的全限定名，Element没有这个方法它的子类有，例如TypeElement，得到的就是类的全类名（包名）。

具体的注解处理流程如下：

首先，看下属性注解处理器生成的文件示例：

AutowiredProcessor这个注解处理器的目的，就是通过这个注解处理器给对应的类中的属性进行赋值的操作。
AutowiredProcessor注解处理器流程：

E. android app开发中常用到哪些开源框架

在前面的课程中，随着对Android体系的了解，已经可以进行正常的Android应用开发了。在Android开发中，同其他工程开发一样，也经常使用一些提高效率的框架，本文我们做一个对比。这些框架，既包括：网络请求框架、也包括图片加载库框架、还包括数据库操作等一些框架，总之，了解和熟悉这些框架，会对自己的开发效率有很大的提升和帮助。

网络请求框架

1、okHttp

在前文的学习中，我们已经了解过okHttp，是一个常用的网络加载库。

2、Retrofit

介绍

Retrofit是一个很不错的网络请求库，该库是square开源的另外一个库，之前的okhttp也是该公司开源的。

Retrofit是基于OkHttp封装的RESTful网络请求框架，使用注解的方式配置请求。优点是速度快，使用注解，callback函数返回结果自动包装成Java对象。官方自己的介绍说：

A type-safe REST client for Android and Java

该网络框架在github上的地址如下：https://square.github.io/retrofit/

要求

Retrofit支持的http方式方式包括 GET/POST/PUT/DELETE/HEAD/PATCH，Retrofit要求Java的版本是1.8+，Android应用的API版本应该在21+。

依赖

使用Retrofit库，和其他库一样，首先需要设置依赖，依然是在build.gradle文件中设置依赖：

//添加retrofit库依赖

implementation ‘com.squareup.retrofit2:retrofit:2.1.0’

//添加gson转换器

implementation ‘com.squareup.retrofit2:converter-gson:2.1.0’

使用

通过一个例子，我们可以来演示该框架的使用步骤：

1、定义请求接口，即程序中都需要什么请求操作
public interface HttpServices {

/**

• 获取头条新闻

• @param type 新闻类型

• @param key apiKey

• @return

*/

@GET(“toutiao/index”)

Call getNewsList(@Query(“type”) String type, @Query(“key”) String key);

}

2、实例化Retrofit对象，使用的Builder的模式创建，如下代码所示：
Retrofit retrofit = new Retrofit.Builder()

.baseUrl(Constants.BASE_API)

.addConverterFactory(GsonConverterFactory.create())

.build();

注意，这里设置结构体转换器，是可以直接把网络请求回来的数据转换为Java结构体，这里设置的Gson解析器，因此要引入相应的转换器支持库。

3、得到接口对象，自己创建的全局的接口对象，并调用相应的接口，得到一个类似于请求Call对象。如下所示：
HttpServices httpServices = retrofit.create(HttpServices.class);

Call newsListCall = httpServices.getNewsList(“top”, Constants.API_KEY);

4、加入到请求队列中，并设置回调方法：
newsListCall.enqueue(new Callback() {

@Override

public void onResponse(Call call, Response response) {

//网络请求成功的回调方法

List list = Arrays.asList(response.body().result.data);

Log.i(“TAG”, “请求成功:” + String.valueOf(list.size()));

NewListAdapter adapter = new NewListAdapter(RetrofitActivity.this);

adapter.setmData(list);

mRecyclerView.setAdapter(adapter);

}

@Override

public void onFailure(Call call, Throwable throwable) {

//网络请求失败的回调方法

Log.i(“TAG”, “请求失败:” + throwable.getMessage());

}

});

其他界面操作和之前的Android中的内容一致。

3、RxJava

简单来说，用来处理事件和异步任务，在很多语言上都有实现，RxJava是Rx在Java上的实现。

原理

RxJava最基本的原理是基于观察者模式来实现的。通过Obserable和Observer的机制，实现所谓响应式的编程体验。

特点

RxJava在编程中的实现就是一种链式调用，做了哪些操作，谁在前谁在后非常直观，逻辑清晰，代码维护起来非常轻松。

RxJava也是一个在github上的库，githubhttp://www.xingkongmj.com/news/id/62.html地址如下：https://github.com/ReactiveX/RxJava

基于此，还有一个RxAndroid，github地址如下：https://github.com/ReactiveX/RxAndroid

RxJava和RxAndroid的关系

RxAndroid是RxJava的一个针对Android平台的扩展，主要用于 Android 开发。

基本概念

RxJava 有四个基本概念：

Observable：可观察者，即被观察者Observer：观察者subscribe：订阅事件
这四个概念之间的逻辑关系是：Observable和Observer通过subscribe方法实现订阅关系，从而Observable可以在需要的时候发出事件来通知Observer。

事件

RxJava 的事件回调方法主要包含以下几个：

onNext：普通的事件onCompletedhttp://dachang.net/432717.html：事件队列完结。RxJava 不仅把每个事件单独处理，还会把它们看做一个队列。RxJava 规定，当不会再有新的 onNext 发出时，需要触发 onCompleted 方法作为标志。：事件队列异常。在事件处理过程中出异常时， 会被触发，同时队列自动终止，不再允许再有事件发出。在一个正确运行的事件序列中, onCompleted和 有且只有一个，并且是事件序列中的最后一个。需要注意的是，onCompleted() 和 () 二者也是互斥的，即在队列中调用了其中一个，就不应该再调用另一个。
数据库操作框架

在开发时，本地数据库可以起到缓存数据和存储业务数据的作用，随着技术的成熟，不断推出了有很多关于数据库的操作框架。比较常见的数据库操作框架有诸如：GreenDao，OrmLite 和 ActiveAndroid，DBFlow等。

GreenDAO

GreenDAO是一个开源的 Android ORM(“对象/关系映射”)，通过 ORM（称为“对象/关系映射”），在我们数据库开发过程中节省了开发时间！

GreenDao的官方文档地址如下：http://www.xingkongmj.com/news/id/63.html

GreenDao的作用

通过 GreenDao，我们可以更快速的操作数据库，我们可以使用简单的面相对象的API来存储，更新，删除和查询 Java 对象。这款数据库操作框架的特点是：

高性能，在官方的统计数据中，GreenDao在GreenDao，OrmLite 和 ActiveAndroid三个框架中，读、写、更新操作效率均表现第一。易于使用的强大 API，涵盖关系和连接。内存消耗较小。安全：greenDAO 支持 sqlCipherhttp://www.xingkongmj.com/news/id/64.html，以确保用户的数据安全;
核心概念

GreenDao 的核心类有三个：分别是：

DaoMaster：保存数据库对象（SQLiteDatabase）并管理特定模式的 DAO 类（而不是对象）。它有静态方法来创建表或删除它们。它的内部类 OpenHelper 和DevOpenHelper 是 SQLiteOpenHelper 实现，它们在 SQLite 数据库中创建模式。DaoSession：管理特定模式的所有可用 DAO 对象，您可以使用其中一个getter方法获取该对象。DaoSession 还提供了一些通用的持久性方法，如实体的插入，加载，更新，刷新和删除。XXXDao：数据访问对象（DAO）持久存在并查询实体。对于每个实体，greenDAO 生成DAO。它具有比 DaoSession 更多的持久性方法。Entities：可持久化对象。通常, 实体对象代表一个数据库行使用标准 Java 属性(如一个POJO 或 JavaBean )。
使用

按照官方的文档和github上的说明可以实现green的使用。

首先进行的是依赖，对于greenDao，有两个地方需要设置，分别是项目根目录中的 build.gradle，还有mole中的build.gradle。
classpath ‘org.greenrobot:green-gradle-plugin:3.3.0’ // add plugin

在项目根目录中的build.gradle目录中写这句话的意思是添加greenDao的插件。

在项目mole中的build.gradle中也需要进行配置，有两个地方需要设置，如下图所示：

apply plugin: ‘org.greenrobot.greenhttp://www.xingkongmj.com/news/id/66.html’ //开头加入该代码

dependences{

implementation ‘org.greenrobot:green:3.2.0’

}

然后就可以使用了。

bean实体

可以在项目中创建自己业务需要的实体类，并通过注解来设置是实体类，字段约束等内容。然后点击Android Studio中的Make mole，即可自动生成XXXDao代码，以此来方便开发者的操作。生成的XXXDao类，不可修改和编辑，是自动生成的。

ORMLite

ORMLite框架是另外一款Android开发中可以使用的数据库操作框架。该框架的文档地址如下：https://ormlite.com/sqlite_java_android_orm.shtml

该框架的文档准备的不是特别友好，此处不再赘述。

总结，所有的框架原理几乎都相差不大，只是操作有所差异。

视图注入框架

在Android项目开发过程中，有太多的页面需要布局完成，同时在代码中需要些大量的findviewbyid的操作，来实现控件的解析。于是就有人想能否轻松一些，解放双手节省时间，干一些其他有意义的事情，于是ButterKnife就来了。

ButterKnife是一个专注于Android系统的View注入框架,可以减少大量的findViewById以及setOnClickListener代码，可视化一键生成。

该项目在github上的地址如下：http://www.xingkongmj.com/news/id/65.html

这个框架的优势也非常明显：

强大的View绑定和Click事件处理功能，简化代码，提升开发效率方便的处理Adapter里的ViewHolder绑定问题运行时不会影响APP效率，使用配置方便代码清晰，可读性强
使用

首先是设置依赖，在build.gradlehttp://dachang.net/432714.html中进行依赖设置：

implementation ‘com.jakewharton:butterknife:10.2.1’

annotationProcessor ‘com.jakewharton:butterknife-compiler:10.2.1’

需要注意，该框架要求Java环境1.8版本以上，SDK版本在26以上，因此在使用到的mole中的build.graldle文件中，还必须添加如下代码配置：

apply plugin: ‘com.jakewharton.butterknife’

android{

//…

compileOptions {

sourceCompatibility JavaVersion.VERSION_1_8

targetCompatibility JavaVersion.VERSION_1_8

}

//…

}

另外，还必须在项目根目录中的build.gradle文件中，添加该框架的插件，如下图所示：

dependences{

classpath ‘com.jakewharton:butterknife-gradle-plugin:10.2.1’

}

然后即可在代码中进行使用了。

在使用该框架的页面进行绑定诸如，如下所示代码:

ButterKnife.bind( this) ;

主要的功能

@BindView（）：控件id 注解，解放双手，不用再每个控件都写一遍findviewById@BindViews（）:多个控件id 的注解，括号内使用花括号包括多个id即可，中间用，分割开在Fragment中使用，绑定Fragment。@BindString（）：绑定字符串@BindArray：绑定数组@BindBitmap：绑定bitmap资源@OnClick、@OnLongClick：绑定点击事件和长按事件…还有很多
插件安装

如果是页面很复杂，一个一个写BindView也很费劲，在Android Studio中，可以安装一个ButterKnife的插件，安装该插件后，可以在Studio中直接将对应的布局中的所有控件均给自动生成。

注意，在进行自动生成时，鼠标要放在布局文件上。

注意事项

ButterKnife框架在使用时，要求的版本比较高，包括Java的版本也有限制。因此，如果计划在项目中使用，要提前做好预备工作，以防止对已有项目和业务带来不必要的麻烦，反而影响工作进度。

F. aRouter正式包不跳,测试包可以

每个需要用到跳转的mole及主app的build.gradle中需要添加（像base、util之类的库不用加）。
主app的build.gradle中需要依赖所有使用路由的mole，使用路由的mole之间不用相互依赖。
使用到ARouter注解跳转的页面类名不要一样（就算包名不一样，类名也要不一样），还有这些页面使用的XML布局名字也要不一样。