ARouter使用记录

资料来源

GitHub Arouter源码及教程

一、功能介绍

1. 支持直接解析标准URL进行跳转，并自动注入参数到目标页面中
2. 支持多模块工程使用
3. 支持添加多个拦截器，自定义拦截顺序
4. 支持依赖注入，可单独作为依赖注入框架使用
5. 支持InstantRun
6. 支持MultiDex(Google方案)
7. 映射关系按组分类、多级管理，按需初始化
8. 支持用户指定全局降级与局部降级策略
9. 页面、拦截器、服务等组件均自动注册到框架
10. 支持多种方式配置转场动画
11. 支持获取Fragment
12. 完全支持Kotlin以及混编(配置见文末 其他#5)
13. 支持第三方 App 加固(使用 arouter-register 实现自动注册)
14. 支持生成路由文档
15. 提供 IDE 插件便捷的关联路径和目标类

二、典型应用

1. 从外部URL映射到内部页面，以及参数传递与解析
2. 跨模块页面跳转，模块间解耦
3. 拦截跳转过程，处理登陆、埋点等逻辑
4. 跨模块API调用，通过控制反转来做组件解耦

三、基础功能

1. 添加依赖和配置

   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'
       ...
   }
   // 旧版本gradle插件(< 2.2)，可以使用apt插件，配置方法见文末'其他#4'
   // Kotlin配置参考文末'其他#5'

2. 添加注解

   // 在支持路由的页面上添加注解(必选)
   // 这里的路径需要注意的是至少需要有两级，/xx/xx
   @Route(path = "/test/activity")
   public class YourActivity extend Activity {
       ...
   }

3. 初始化SDK

   if (isDebug()) {           // 这两行必须写在init之前，否则这些配置在init过程中将无效
       ARouter.openLog();     // 打印日志
       ARouter.openDebug();   // 开启调试模式(如果在InstantRun模式下运行，必须开启调试模式！线上版本需要关闭,否则有安全风险)
   }
   ARouter.init(mApplication); // 尽可能早，推荐在Application中初始化

4. 发起路由操作

   // 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();

5. 添加混淆规则(如果使用了Proguard)

   -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.IProvider
   

6. 使用 Gradle 插件实现路由表的自动加载 (可选)

   apply plugin: 'com.alibaba.arouter'
   
   buildscript {
       repositories {
           jcenter()
       }
   
       dependencies {
           classpath "com.alibaba:arouter-register:?"
       }
   }

   可选使用，通过 ARouter 提供的注册插件进行路由表的自动加载(power by AutoRegister)， 默认通过扫描 dex 的方式 进行加载通过 gradle 插件进行自动注册可以缩短初始化时间解决应用加固导致无法直接访问 dex 文件，初始化失败的问题，需要注意的是，该插件必须搭配 api 1.3.0 以上版本使用！

7. 使用 IDE 插件导航到目标类 (可选)

   在 Android Studio 插件市场中搜索 ARouter Helper, 或者直接下载文档上方 最新版本 中列出的 arouter-idea-pluginzip 安装包手动安装，安装后 插件无任何设置，可以在跳转代码的行首找到一个图标 () 点击该图标，即可跳转到标识了代码中路径的目标类