前言
什么是ARouter？阿里巴巴官方解释是：Android平台中对页面、服务提供路由功能的中间件。那又是什么鬼，有啥功能，什么场合适合使用？官方给的说明是：
一、功能介绍
1、支持直接解析标准URL进行跳转，并自动注入参数到目标页面中
2、支持多模块工程使用
3、支持添加多个拦截器，自定义拦截顺序
4、支持依赖注入，可单独作为依赖注入框架使用
5、支持InstantRun
6、支持MultiDex(Google方案)
7、映射关系按组分类、多级管理，按需初始化
8、支持用户指定全局降级与局部降级策略
9、页面、拦截器、服务等组件均自动注册到框架
10、支持多种方式配置转场动画
11、支持获取Fragment
二、典型应用
1、从外部URL映射到内部页面，以及参数传递与解析
2、跨模块页面跳转，模块间解耦
3、拦截跳转过程，处理登陆、埋点等逻辑
4、跨模块API调用，通过控制反转来做组件解耦
好了，这些理论啥的我就不说了，具体也可以去官方地址查看：https://github.com/alibaba/ARouter
接下来我们来看看怎么使用，一步一步来
使用说明
1、在project gradle里面添加
buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:2.3.0' //推荐是2.3以上
classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8' //路由需要
}
}
2、在 app 和 module 的 gradel 添加依赖
android {
defaultConfig {
...
javaCompileOptions {
annotationProcessorOptions {
arguments = [ moduleName : project.getName() ]
}
}
}
}
dependencies {
// 替换成最新版本, 需要注意的是api
// 要与compiler匹配使用，均使用最新版可以保证兼容
compile 'com.alibaba:arouter-api:1.2.0'
annotationProcessor 'com.alibaba:arouter-compiler:1.1.0'
...
}
3、新建两个module（lib），然后让app都依赖这两个module
dependencies {
compile 'com.alibaba:arouter-api:1.2.0'
annotationProcessor 'com.alibaba:arouter-compiler:1.1.0'
//添加下面两个依赖
compile project(':module1')
compile project(':module2')
}
4、在两个module里面都新建一个activity，目的是测试模块化跳转。实验证明，只要app依赖了这两个module，module之间不需再互相依赖就可以实现从module1跳转到module2 。
//添加注解，path必须为 /XX/OO 的形式
@Route(path = "/module1/main")
public class Module1Activity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_module1);
String data = getIntent().getStringExtra("data");
Toast.makeText(this, "传递的参数：" + data, Toast.LENGTH_LONG).show();
}
}
5、然后从app的activity跳转到module的activity
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
ARouter.init(getApplication());// 初始化，建议放在application里面
ARouter.openLog(); // 打印日志
ARouter.openDebug(); // 开启调试模式(如果在InstantRun模式下运行，必须开启调试模式！线上版本需要关闭,否则有安全风险)
}
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (data == null) {
Log.e("---", "------------空--------------");
return;
}
if (requestCode == 100 && resultCode == 0) {
String key = data.getExtras().getString("key");
Toast.makeText(MainActivity.this, "回调的内容：" + key, Toast.LENGTH_LONG).show();
}
}
//跳去module1的页面
public void module(View view) {
//不用activityResult
ARouter.getInstance()
.build("/module1/main") //内容就是想跳转去那个module注解的path
.withString("data", "app传过来的内容") //传参，不用就不需写啦
.navigation();
//使用activityResult，相当于 startActivityForResult
ARouter.getInstance()
.build("/module1/main")
.withString("data", "app传过来的内容")
.navigation(MainActivity.this, 100);
//上面的处理和下面的处理功能一样
Intent intent = new Intent(this, Module1Activity.class);
intent.putExtra("data", "app传过来的内容");
startActivityForResult(intent, 100);
}
}
6、加入混淆
-keep public class com.alibaba.android.arouter.routes.**{*;}
-keep class * implements com.alibaba.android.arouter.facade.template.ISyringe{*;}
总结
好啦，上面的用法只是基本功能使用，进阶功能下篇再写吧。然后问题来了，用这个路由，优势在哪里？解耦，主要应该就是这个吧。当项目非常大的时候，需要有很多组件整合的时候，团队可以分别对这些module进行开发，而不会互相影响。
网友评论