ARouter简介
ARouter 是阿里巴巴开发的一款，页面路由工具库，旨在解决组件化或者模块之间界面跳转的问题。
一、ARouter页面路由产生的背景
Intent intent = new Intent(mContext, XxxActivity.class);intent.putExtra("key","value");startActivity(intent);Intent intent = new Intent(mContext, XxxActivity.class);intent.putExtra("key","value");startActivityForResult(intent, 666);先看下上面的代码，在未使用ARouter路由框架之前是这样的。在Android开发中，最常见的常用功能就是页面的跳转了，我们经常遇到从浏览器或者其他App 跳转到自己App中某个页面的需求。不过就算是App内部简单的页面跳转，随着时间的推移，也会遇到一些问题：1. 集中式的URL管理：谈到集中式的管理，总是比较蛋疼，多人协同开发的时候，大家都去AndroidManifest.xml文件中，定义各种，然后使用隐式Intent实现跳转。最终发现AndroidManifest.xml中充斥着各种Schame、各种Path，需要经常解决Path冲突的问题。2. 可培植性较差：AndroidManifest.xml限制于xml格式，书写比较麻烦，配置较为复杂，可以进行自定义的东西也很少。3. 跳转过程中无法干预：直接通过Intent的方式跳转，跳转过程，开发者是无法进行干预的，一些面向切面的事情也难以实施。比如：登录、埋点的逻辑，在每个子页面中判断是很不合理的。4. 跨模块无法显示依赖：当App程序越来越大的时候我们会对App做水平拆分，按照业务拆分成多个子模块，模块与模块之间完全解藕，通过打包流程控制App功能，这样更有利于多人协作开发，逻辑相互不干扰。这种情况下，就只能依赖隐式Intent实现页面间的跳转了，书写麻烦，成功与否也难以控制。为了解决上述问题，我们需要一款能够解藕、简单、功能全面、定制性强、支持拦截跳转过程的路由组件，为此ARouter便诞生了。
二、原生路由方案的缺点
1，显式：直接的类依赖，耦合严重2，隐式：会在AndroidManifest.xml中进行集中式管理，写作困难。3，AndroidManifest.xml扩展性差。4，跳转过程无法控制。5，失败无法降级。
三、ARouter的优势
1，使用注解，实现了映射关系自动注册 与 分布式路由管理2，编译期间处理注解，并生成映射文件，没有使用反射，不影响运行时性能3，映射关系按组分类，多级管理，按需初始化。4，灵活的降级策略，每次跳转都会回调跳转结果，避免StartActivity() 一旦失败会抛出异常。5，自定义拦截器，自定义拦截顺序，可以对路由进行拦截，比如登陆判断，和埋点处理。6，支持依赖注入，可单独作为依赖注入框架使用，从而实现 跨模块API调用。7，支持直接解析标准Url进行跳转，并自动注入参数到目标页面中。8，支持多模块使用，支持组件化开发。
四、ARouter功能介绍
1，支持直接解析URL进行跳转、参数将按照类型解析到Bundle，支持Java基本类型。2，支持应用内的标准页面跳转，API接近Android原生接口。3，支持模块工程，允许分别打包，包结构符合Android包规范即可。4，支持组件化开发。5，支持拦截跳转过程，在跳转过程中自定义拦截逻辑，自定义拦截顺序。6，支持服务托管，可以通过ByName、ByType这两种方式获取服务实例，方便面向接口开发 与 跨模块调用解藕。7，支持 映射关系按组分类、多级管理，按需初始化，减少内存占用，提高查询效率。8，支持用户指定全局降级策略。9，支持获取单次跳转结果。10，支持丰富的API和可定制化。11，被ARouter管理的页面、拦截器、服务等均无需主动注册到ARouter，是被动发现的。12，支持Android N推出的Jack编译链。13，支持获取Fragment。14，支持MultiDex (Google方案)。15，支持多种方式配置专场动画。16，支持Kotlin及混编。17，支持第三方App加固。18，支持生成路由文档。19，支持InstantRun热运行。
五、ARouter的典型应用场景
1，从APP外部URL映射到App内的某个页面，以及参数传递与解析。2，App内的跨模块页面之间的跳转，实现模块间解藕。3，拦截跳转过程，处理登陆、埋点等逻辑。4，跨模块API调用，模块之间解藕 (注册ARouter服务的形式，通过接口相互调用)。 六、ARouter路由导航流程图
七、ARouter基本配置
1、添加依赖和配置在app.gradle 和 每个module.gradle 里面都需要进行配置
android {defaultConfig {...javaCompileOptions {annotationProcessorOptions {arguments = [AROUTER_MODULE_NAME: project.getName()]}}}}dependencies {// 替换成最新版本, 需要注意的是api// 要与compiler匹配使用，均使用最新版可以保证兼容compile 'com.alibaba:arouter-api:x.x.x'annotationProcessor 'com.alibaba:arouter-compiler:x.x.x'}2、使用Gradle插件，实现路由列表的自动加载 (可选)博客地址：加固后ARouter罢工了？看这里 – 掘金
apply plugin: 'com.alibaba.arouter'buildscript {repositories {jcenter()}dependencies {classpath "com.alibaba:arouter-register:" />3、添加混淆配置
-keep public class com.alibaba.android.arouter.routes.**{*;}-keep public class com.alibaba.android.arouter.facade.**{*;}-keep class * implements com.alibaba.android.arouter.facade.template.ISyringe{*;}# 如果使用了 byType 的方式获取 Service，需添加下面规则，保护接口-keep interface * implements com.alibaba.android.arouter.facade.template.IProvider# 如果使用了 单类注入，即不定义接口实现 IProvider，需添加下面规则，保护实现# -keep class * implements com.alibaba.android.arouter.facade.template.IProvider4、生成路由文档
// 更新 build.gradle, 添加参数 AROUTER_GENERATE_DOC = enable// 生成的文档路径 : build/generated/source/apt/// (debug or release)/com/alibaba/android/arouter/docs/arouter-map-of-${moduleName}.jsonandroid {defaultConfig {...javaCompileOptions {annotationProcessorOptions {arguments = [AROUTER_MODULE_NAME: project.getName(), AROUTER_GENERATE_DOC: "enable"]}}}}八、ARouter基本功能的使用
1、ARouter初始化
public static void initRouter(Application application) {if (BuildConfig.DEBUG) {// 这两行必须写在init之前，否则这些配置在init过程中将无效ARouter.openLog();// 打印日志// 开启调试模式(如果在InstantRun模式下运行，必须开启调试模式！线上版本需要关闭,否则有安全风险)ARouter.openDebug(); }ARouter.init(application); // 尽可能早，推荐在Application中初始化}2、为目标Activity页面 添加注解
// 在支持路由的页面上添加注解(必选)// 这里的路径需要注意的是至少需要有两级，/xx/xx@Route(path = "/test/activity")public class YourActivity extend Activity {...}3，发起路由跳转
// 1. 应用内简单的跳转(通过URL跳转在'进阶用法'中)ARouter.getInstance().build("/test/activity").navigation();// 2. 跳转并携带参数ARouter.getInstance().build("/test/1").withLong("key1", 666L).withString("key3", "888").withObject("key4", new Test("Jack", "Rose")).navigation();4，跳转到其他moudle
ARouter跳转到其他moudle时，需要注意的是，moudle中的目标Activity或者service服务类上使用@Route(path = “xx/xxx”) 与 app moudle中使用的@Route里的path路径不能相同，否则会报错，找不到索引。 步骤一：鼠标右键项目 -> New -> Module -> 直至创建完成；步骤二：注释掉module中build.gradle里面相应的配置，如：（applicationId 和apply plugin等）同时引入ARouter中的依赖库，同app module；步骤三：删除module中AndoridManifest.xml中不需要的配置；步骤四：为module中的目标页面配置路由步骤五：实现module之间的跳转。
九、ARouter注解
注解共有三种：@Route、@AutoWired、@Interceptor1、注解路由 @Route用于注解一个目标Activity或者 一个目标服务类。参数包括@Route (path = “/self/test_activity”, group = “default”, name = “这是一个测试页面”，)
/*** Path of route*/String path();/*** Used to merger routes, the group name must be use the common words !!!*/String group() default "";/*** Name of route, used to generate javadoc.*/String name() default "";/*** Extra data, 可以被用户设置* Ps. U should use the integer num sign the switch, by bits. 10001010101010*/int extras() default Integer.MIN_VALUE;/*** The priority of route.* 值越小，优先级越高*/int priority() default -1;2、注解字段 @AutoWired接收参数时，不要忘记 进行注册 ARouter.getInstance().inject(this); 用户注解字段参数，需要配合ARouter.getInstance().inject(this)配置。 2.1 传递参数
@OnClick(R2.id.enter_activity_inject)public void onClick9() {TestSerializable testSerializable = new TestSerializable("Titanic", 555);TestParcelable testParcelable = new TestParcelable("jack", 666);TestObj testObj = new TestObj("Rose", 777);List objList = new ArrayList();objList.add(testObj);Map<String, List> map = new HashMap();map.put("testMap", objList);ARouter.getInstance().build("/self/activity_inject").withString("name", "老王").withInt("age", 18).withBoolean("boy", true).withLong("high", 180).withString("url", "https://a.b.c").withSerializable("ser", testSerializable).withParcelable("pac", testParcelable).withObject("obj", testObj).withObject("objList", objList).withObject("map", map).navigation();}2.2 接收参数值
@Autowired(desc = "姓名")String name = "jack";@Autowiredint age = 10;@Autowiredint height = 175;//通过name来映射URL中的不同参数，及girl是传递参数时的字段名，在当前，可以改变字段名称，使用boy替换girl。@Autowired(name = "boy", required = true)boolean girl;@Autowiredchar ch = 'A';@Autowiredfloat fl = 12.00f;@Autowireddouble dou = 12.01d;@AutowiredTestSerializable ser;@AutowiredTestParcelable pac;// URL中不能传递Parcelable类型数据，通过ARouter api可以传递Parcelable对象// 支持解析自定义对象，URL中使用json传递@AutowiredTestObj obj;//使用withObject传递实现Serializable接口ArrayList和HashMap的时候，//接收对象的地方不能标注为具体实现的类型，否则会影响序列化中类型的判断，//应该标注为：List 和 Map. @AutowiredList objList;@AutowiredMap<String, List> map;@AutowiredString url;//获取服务实例的第三种方式 -- 通过注解获取@AutowiredHelloService helloService;自定义类型参数--用于网页传递json数据网页传递json参数到App页面,然后ARouter帮助我们自动转换为我们的自定义数据类
// 如果需要传递自定义对象，新建一个类（并非自定义对象类），// 然后实现 SerializationService, 并使用@Route注解标注(方便用户自行选择序列化方式)，例如@Route(path = "/self_service/json")public class JsonServiceImpl implements SerializationService {@Overridepublic void init(Context context) {} //json字符串转换为对象@Overridepublic T json2Object(String text, Class clazz) {return JSON.parseObject(text, clazz);} //自定义对象转换为json字符串@Overridepublic String object2Json(Object instance) {return JSON.toJSONString(instance);}@Overridepublic T parseObject(String input, Type clazz) {return JSON.parseObject(input, clazz);}}网页链接为：
带json自定义对象
自定义对象为：
public class TestObj() { //这里变量名称对应Url的json的keypublic String name;public int id;}然后在目标Activity中接收对象:
@AutoWiredString name;@AutoWired(name = “id”)int ID;3、拦截器 @Interceptor （拦截跳转过程，面向切面编程）拦截器注解，在跳转的过程中进行拦截，方便添加某些逻辑处理。
/** * 自定义拦截器 * priority： 为拦截器的优先级，其值越小，优先级越高；多个拦截器时候有用； */@Interceptor(priority = 7, name = "测试用拦截器")public class Test1Interceptor implements IInterceptor {Context mContext;/*** process：拦截器操作* @param postcard 数据* @param callback 回调*/@Overridepublic void process(final Postcard postcard, final InterceptorCallback callback) {if ("/self/activity_page".equals(postcard.getPath())) {// 这里的弹窗仅做举例，代码写法不具有可参考价值final AlertDialog.Builder ab = new AlertDialog.Builder(ARouterHomeActivity.getThis());ab.setCancelable(false);ab.setTitle("温馨提醒");ab.setMessage("想要跳转到ARouterPageActivity么？(触发了\"/inter/test\"拦截器，拦截了本次跳转)” );ab.setNegativeButton("继续", new DialogInterface.OnClickListener() {@Overridepublic void onClick(DialogInterface dialog, int which) {//继续执行跳转，不做额外的拦截操作callback.onContinue(postcard);}});ab.setNeutralButton("算了", new DialogInterface.OnClickListener() {@Overridepublic void onClick(DialogInterface dialog, int which) {//直接终止跳转callback.onInterrupt(null);callback.onInterrupt(new RuntimeException("出现跳转终止的异常"));}});ab.setPositiveButton("加参数", new DialogInterface.OnClickListener() {@Overridepublic void onClick(DialogInterface dialog, int which) {postcard.withString("extra", "这拦截器中附加的参数");callback.onContinue(postcard);}});MainLooper.runOnUiThread(new Runnable() {@Overridepublic void run() {ab.create().show();}});} else {callback.onContinue(postcard);}}/*** 拦截器的初始化，会在sdk初始化的时候调用该方法，且仅会调用一次；*/@Overridepublic void init(Context context) {mContext = context;Log.e("testService", Test1Interceptor.class.getName() + " has init.");}}十、服务
并不是说的四大组件中的service服务，而是一个普通对象。ARouter中的服务，可以通过注入的方式解藕，实现moudle模块之间的API调用。1、服务管理——暴露服务
// 声明接口,其他组件通过接口来调用服务public interface HelloService implements IProvider {String sayHello(String name);}// 实现接口@Route(path = "/yourservicegroupname/hello", name = "测试服务")public class HelloServiceImpl implements HelloService {@Overridepublic String sayHello(String name) {return "hello, " + name;}@Overridepublic void init(Context context) {}}2、服务管理——发现服务
public class Test {//注解的方式获取服务@AutowiredHelloService helloService; //注解的方式获取服务—重命名服务@Autowired(name = "/yourservicegroupname/hello")HelloService helloService2;//其他方式获取服务HelloService helloService3;HelloService helloService4;public Test() { //这里是重点********** 出过错，忘记在使用 Aroter的组件(Activity)中注册了 ARouter.getInstance().inject(this);}public void testService() {// 1. (推荐)使用依赖注入的方式发现服务,通过注解标注字段,即可使用，无需主动获取// Autowired注解中标注name之后，将会使用byName的方式注入对应的字段，// 不设置name属性，会默认使用byType的方式发现服务// (当同一接口有多个实现的时候，必须使用byName的方式发现服务)helloService.sayHello("Vergil");helloService2.sayHello("Vergil");// 2. 使用依赖查找的方式发现服务，主动去发现服务并使用，下面两种方式分别是byName和byTypehelloService3 = ARouter.getInstance().navigation(HelloService.class);helloService4= (HelloService) ARouter.getInstance().build("/yourservicegroupname/hello").navigation();helloService3.sayHello("Vergil");helloService4.sayHello("Vergil");}}3、预处理服务
// 实现 PretreatmentService 接口，并加上一个Path内容任意的注解即可@Route(path = "/xxx/xxx")public class PretreatmentServiceImpl implements PretreatmentService {@Overridepublic boolean onPretreatment(Context context, Postcard postcard) {// 跳转前预处理，如果需要自行处理跳转，该方法返回 false 即可}@Overridepublic void init(Context context) {}}4、重写跳转Url的服务
即会拦截跳转时的Path 和 Url (app内部跳转，以及页面跳转到app页面) ,拦截之后可以重新定义跳转路径，改变跳转的目标页面。
@Route(path = "/self/repace_pathorurl_service")public class ReplacePathOrUrlServiceImpl implements PathReplaceService {Context mContext;/*** void 重写跳转路径path* @param path 原始的跳转路径* @return 按照一定的规则处理之后返回处理后的结果*/@Overridepublic String forString(String path) {return path;}/*** void 重写跳转Uri* @param uri 原始的跳转url* @return 按照一定的规则处理之后返回处理后的结果*/@Overridepublic Uri forUri(Uri uri) {return uri;}@Overridepublic void init(Context context) {this.mContext = context;}十一、为目标页面，声明更多参数
// 我们经常需要在目标页面中配置一些属性，比方说"是否需要登陆”之类的， // 可以通过 Route 注解中的 extras 属性进行扩展，这个属性是一个 int值， // 换句话说，单个int有4字节，也就是32位，可以配置32个开关 // 剩下的可以自行发挥，通过字节操作可以标识32个开关，通过开关标记目标页面的一些属性， // 在拦截器中可以拿到这个标记进行业务逻辑判断 @Route(path = "/test/activity", extras = Consts.XXXX)
十二，降级策略
通俗的讲，降级就是，在使用ARouter实现跳转的时候，如果发生错误，而进行相应的逻辑处理， 不至于导致崩溃现象。
十三、API总结
//构建标准的路由请求ARouter.getInstance().build("/home/main").navigation();//构建标准的路由请求，并指定分组ARouter.getInstance().build("/home/main", "ap").navigation();//构建标准的路由请求，通过Uri直接解析Uri uri;ARouter.getInstance().build(uri).navigation();//构建标准的路由请求，startActivityForResult//navigation的第一个参数必须是Activity，第二个参数则是RequestCodeARouter.getInstance().build("/home/main", "ap").navigation(this, 5);//直接传递BundleBundle params = new Bundle();ARouter.getInstance().build("/home/main").with(params).navigation();//指定FlagARouter.getInstance().build("/home/main").withFlags();.navigation();//获取FragmentFragment fragment = (Fragment) ARouter.getInstance().build("/test/fragment").navigation();//对象传递ARouter.getInstance().withObject("key", new TestObj("Jack", "Rose")).navigation();//觉得接口不够多，可以直接拿出Bundle赋值ARouter.getInstance().build("/home/main").getExtra();//转场动画(常规方式)ARouter.getInstance().build("/test/activity2").withTransition(R.anim.slide_in_bottom, R.anim.slide_out_bottom).navigation(this);//转场动画(API16+)ActivityOptionsCompat compat = ActivityOptionsCompat.makeScaleUpAnimation(v, v.getWidth() / 2, v.getHeight() / 2, 0, 0);//ps. makeSceneTransitionAnimation 使用共享元素的时候，需要在navigation方法中传入当前ActivityARouter.getInstance().build("/test/activity2").withOptionsCompat(compat).navigation();//使用绿色通道(跳过所有的拦截器)ARouter.getInstance().build("/home/main").greenChannel().navigation();//使用自己的日志工具打印日志ARouter.setLogger();//获取原始的URIString uriStr = getIntent().getStringExtra(ARouter.RAW_URI);//关闭ARouterARouter.getInstance().destroy();十四、使用IDE插件，导航到目标类
在 Android Studio 插件市场中搜索ARouter Helper, 或者直接下载文档上方最新版本中列出的arouter-idea-pluginzip 安装包手动安装，安装后 插件无任何设置，可以在跳转代码的行首找到一个图标 () 点击该图标，即可跳转到标识了代码中路径的目标类 手动安装过程： 1，Preferences —> Plugins -> Install plugin from disk -> 重启IDE
ARouter原理
全面掌握组件化ARouter，即刻吊打面试官！ - 简书 “终于懂了” 系列：组件化框架 ARouter 完全解析（一） 原理详解