Android 路由框架ARouter最佳实践

时间  2021-01-30
标签 php css java android git github web api 数组 安全 栏目 Android 繁體版
原文   原文链接

一：什么是路由？

说简单点就是映射页面跳转关系的，固然它也包含跳转相关的一切功能。php

二：为何须要路由

Android系统已经给咱们提供了api来作页面跳转，好比startActivity，为何还须要路由框架呢？咱们来简单分析下路由框架存在的意义：css

  • 在一些复杂的业务场景下（好比电商），灵活性比较强，不少功能都是运营人员动态配置的，好比下发一个活动页面，咱们事先并不知道具体的目标页面，但若是事先作了约定，提早作好页面映射，即可以自由配置。java

  • 随着业务量的增加，客户端必然随之膨胀，开发人员的工做量愈来愈大，好比64K问题，好比协做开发问题。App通常都会走向组件化、插件化的道路，而组件化、插件化的前提就是解耦，那么咱们首先要作的就是解耦页面之间的依赖关系。android

  • 简化代码。数行跳转代码精简成一行代码。git

  • 其余…github

三：ARouter 简介

是ARouter是阿里巴巴开源的Android平台中对页面、服务提供路由功能的中间件，提倡的是简单且够用。web

GitHub：https://github.com/alibaba/ARouterapi

四：ARouter 优点

从 ARouter Github 了解到它的优点：数组

  • 支持直接解析标准URL进行跳转，并自动注入参数到目标页面中
  • 支持多模块工程使用
  • 支持添加多个拦截器，自定义拦截顺序
  • 支持依赖注入，可单独做为依赖注入框架使用
  • 支持InstantRun
  • 支持MultiDex(Google方案)
  • 映射关系按组分类、多级管理，按需初始化
  • 支持用户指定全局降级与局部降级策略
  • 页面、拦截器、服务等组件均自动注册到框架
  • 支持多种方式配置转场动画
  • 支持获取Fragment
  • 彻底支持Kotlin以及混编

典型的应用：安全

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

五：ARouter 配置

android {
    defaultConfig {
    ... javaCompileOptions { annotationProcessorOptions { arguments = [ moduleName : project.getName() ] } } } } dependencies { compile 'com.alibaba:arouter-api:1.2.1.1' annotationProcessor 'com.alibaba:arouter-compiler:1.1.2.1' }

api 的版本和 compiler 的版本号须要用最新的。最新的版本在 Github上能够找到。

这里写图片描述

六：ARouter 初始化

public class MyApplication extends Application { @Override public void onCreate() { super.onCreate(); ARouter.openLog(); // 打印日志 ARouter.openDebug(); // 开启调试模式(若是在InstantRun模式下运行，必须开启调试模式！线上版本须要关闭,不然有安全风险) ARouter.init( this ); // 尽量早，推荐在Application中初始化 } }

七：ARouter 注解发起路由

新建一个 Activity1 做为测试 ，在 Activity1 添加注解的代码以下：

package com.router; import android.support.v7.app.AppCompatActivity; import android.os.Bundle; import com.alibaba.android.arouter.facade.annotation.Route; // 在支持路由的页面上添加注解(必选) // 这里的路径须要注意的是至少须要有两级，/xx/xx @Route(path = "/com/Activity1") public class Activity1 extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_1); } }

 

在 MainActivity 的布局中添加一个按钮

<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" tools:context="com.router.MainActivity"> <TextView android:id="@+id/bt1" android:layout_width="match_parent" android:layout_height="wrap_content" android:text="应用内跳转" android:gravity="center" android:padding="10dp" android:background="#666666" /> </LinearLayout>

MainActivity 里面的跳转逻辑是：

public class MainActivity extends AppCompatActivity implements View.OnClickListener { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); findViewById( R.id.bt1).setOnClickListener( this ); } @Override public void onClick(View v) { switch ( v.getId() ){ case R.id.bt1 : //发起路由跳转 ARouter.getInstance().build("/com/Activity1").navigation(); break; } } }

 

效果图以下：

这里写图片描述

若是你想实现像 startActivityForResult（） 功能，能够这样使用：

navigation(Activity mContext, int requestCode)

 

具体使用以下：

ARouter.getInstance() .build("/com/Activity1") .navigation( this , 100 );

 

若是 Path 路径不正确会发生什么，咱们来测试一下，如今咱们把路由操做改成

ARouter.getInstance().build("/com/Test").navigation();

效果以下：

这里写图片描述

能够看到有一个 Toast 提示咱们找不到 “/com/Test” 路径，咱们来看看源码

这里写图片描述

经过源码咱们能够看到在 debug 状态下，当找不到路由路径目标是，会有 Toast 提示。

八：监听路由过程

在路由跳转的过程当中，咱们能够监听路由的过程，只须要使用：

navigation(Context context, NavigationCallback callback)

NavigationCallback 的源码以下：

public interface NavigationCallback { /** * Callback when find the destination. * 找到了 * @param postcard meta */ void onFound(Postcard postcard); /** * Callback after lose your way. * 找不到了 * @param postcard meta */ void onLost(Postcard postcard); /** * Callback after navigation. * 跳转完了 * @param postcard meta */ void onArrival(Postcard postcard); /** * Callback on interrupt. * 被拦截了 * @param postcard meta */ void onInterrupt(Postcard postcard); }

具体使用以下

ARouter.getInstance()
       .build("/com/Activity1") .navigation(this, new NavCallback() { @Override public void onFound(Postcard postcard) { Log.e("zhao", "onArrival: 找到了 "); } @Override public void onLost(Postcard postcard) { Log.e("zhao", "onArrival: 找不到了 "); } @Override public void onArrival(Postcard postcard) { Log.e("zhao", "onArrival: 跳转完了 "); } @Override public void onInterrupt(Postcard postcard) { Log.e("zhao", "onArrival: 被拦截了 "); } });

 

九：发起路由而且传递参数

ARouter.getInstance() .build("/com/Activity1") .withString( "key" , "123") //参数：键：key 值：123 .navigation();

 

ARouter 提供了丰富大量的参数类型，供咱们选择。

//基础类型 .withString( String key, String value ) .withBoolean( String key, boolean value) .withChar( String key, char value ) .withShort( String key, short value) .withInt( String key, int value) .withLong( String key, long value) .withDouble( String key, double value) .withByte( String key, byte value) .withFloat( String key, float value) .withCharSequence( String key, CharSequence value) //数组类型 .withParcelableArrayList( String key, ArrayList<? extends Parcelable > value) .withStringArrayList( String key, ArrayList<String> value) .withIntegerArrayList( String key, ArrayList<Integer> value) .withSparseParcelableArray( String key, SparseArray<? extends Parcelable> value) .withCharSequenceArrayList( String key, ArrayList<CharSequence> value) .withShortArray( String key, short[] value) .withCharArray( String key, char[] value) .withFloatArray( String key, float[] value) .withCharSequenceArray( String key, CharSequence[] value) //Bundle 类型 .with( Bundle bundle ) //Activity 跳转动画 .withTransition(int enterAnim, int exitAnim) //其余类型 .withParcelable( String key, Parcelable value) .withParcelableArray( String key, Parcelable[] value) .withSerializable( String key, Serializable value) .withByteArray( String key, byte[] value) .withTransition(int enterAnim, int exitAnim)

 

十：路由分组

在前面咱们讲到在对 Activity1 作注解的时候，用到了

@Route(path = "/com/Activity1") public class Activity1 extends AppCompatActivity { }

 

在 path 这个字符串里面，”com” 就表明组的标识；“Activity1” 表明是 Activity1 类的具体表示。组的标识和类的标识均可以本身定义的，须要记住的是组标识和类标识之间用斜杠来区分 ”\” .

什么是组？

这里就须要提下，ARouter框架是分组管理，按需加载。提起来很高深的样子呢！其实解释起来就是，在编译期框架扫描了全部的注册页面／服务／字段／拦截器等，那么很明显运行期不可能一股脑所有加载进来，这样就太不和谐了。因此就分组来管理，ARouter在初始化的时候只会一次性地加载全部的root结点，而不会加载任何一个Group结点，这样就会极大地下降初始化时加载结点的数量。好比某些Activity分红一组，组名就叫test，而后在第一次须要加载组内的某个页面时再将test这个组加载进来。

测试一下：

ARouter.getInstance()
       .build("/com/Activity1") .navigation(this, new NavCallback() { @Override public void onArrival(Postcard postcard) { String group = postcard.getGroup(); Log.e("zhao", "分组是: " + group); } });

 

结果是

07-27 17:32:17.880 19449-19449/com.router E/zhao: 分组是: com

ARouter 默认状况下的分组就是第一个 / / 之间的内容。

自定义分组：

建立 CustomGroupActivity 而且添加 注解，而且指定路由分组。自定义分组的就是在原来的注解上添加 group 字段， 以下所示。

@Route(path = "/com/CustomGroupActivity" , group = "customGroup") public class CustomGroupActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_custom_group); } }

 

自定义分组，发起路由：第二个参数就是路由的分组

build(String path, String group)

具体实现以下所示：

ARouter.getInstance().build("/com/CustomGroupActivity", "customGroup").navigation();

 

十一：Fragment 路由

建立 Fragment 类，而且添加路由注解

@Route(path = "/com/TestFragment") public class TestFragment extends Fragment { @Override public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { View view = inflater.inflate(R.layout.fragment_test, container, false); return view ; } }

 

获取 Fragment 实例

Fragment fragment = (Fragment) ARouter.getInstance().build( "/com/TestFragment" ).navigation();

十二：URL 跳转

web url 跳转流程图

这里写图片描述

建立URL 中间跳转页

建立 URLReceiveActivity

/** * URL 中转Activity */ public class URLReceiveActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView( R.layout.activity_url_receive ); //对URI 数据分发 Uri uri = getIntent().getData(); ARouter.getInstance().build(uri).navigation(this, new NavCallback() { @Override public void onArrival(Postcard postcard) { finish(); } }); } }

 

URLReceiveActivity 添加注册

<activity android:name=".URLReceiveActivity"> <!-- Schame --> <intent-filter> <data android:host="zhaoyanjun" android:scheme="arouter" /> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> </intent-filter> </activity>

 

这里面的 host 、scheme 字段很重要。点击 url 会根据这两个字段会调起本地的 Activity 。

下面是一段 HTML 片断

<h2>1:URL普通跳转</h2> <p><a href="arouter://zhaoyanjun/com/URLActivity1">arouter://zhaoyanjun/com/URLActivity1 </a> </p> <h2>2:URL普通跳转携带参数</h2> <p> <a href="arouter://zhaoyanjun/com/URLActivity2?name=alex&age=18&boy=true&high=180&obj=%7b%22name%22%3a%22jack%22%2c%22id%22%3a666%7d">arouter://zhaoyanjun/test/URLActivity2?name=alex&age=18&boy=true&high=180&obj={"name":"jack","id":"666"} </a> </p>

 

注意 a 标签里面的 arouter://zhaoyanjun 分别表明着 scheme 、host ；/com/URLActivity1 就是目标 Activity 的注解。

若是须要接收 URL 中的参数，须要在 Activity 调用自动注入初始化方法；

ARouter.getInstance().inject(this);

 

须要注意的是，若是不使用自动注入，那么能够不写 ARouter.getInstance().inject(this)，可是须要取值的字段仍然须要标上 @Autowired 注解，由于 只有标上注解以后，ARouter才能知道以哪种数据类型提取URL中的参数并放入Intent中，这样您才能在intent中获取到对应的参数

具体的代码以下：

@Route(path = "/com/URLActivity2") public class URLActivity2 extends AppCompatActivity{ private TextView textView; @Autowired String name; @Autowired int age; @Autowired boolean boy; @Autowired int high; @Autowired String obj ; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); ARouter.getInstance().inject(this); setContentView(R.layout.activity_url2); textView = (TextView) findViewById(R.id.tv); //解析参数 Bundle bundle = getIntent().getExtras(); String name1 = bundle.getString("name"); textView.setText("参数是： " + "name: " + name + " age: " + age + " boy: " + boy + " name1: " + name1 + " obj: " + obj.toString() ); } }

 

效果图以下：

这里写图片描述

十三：暴露服务

这里说到的服务不是Android四大组件中的Service，这里的服务是接口开发的概念，就是将一部分功能和组件封装起来成为接口，以接口的形式对外提供能力，因此在这部分就能够将每一个功能做为一个服务，而服务的实现就是具体的业务功能。

咱们先自定义一个接口 IService 而且继承 IProvider 。IService 接口里面有一个 sayHello() 方法，具体代码以下。

public interface IService extends IProvider { void sayHello(Context context ); }

 

先定义一个 IService 的实现类 MyService 而且添加注解，代码以下

@Route(path = "/service/hello", name = "测试服务") public class MyService implements IService { @Override public void sayHello( Context context ) { Toast.makeText( context , "hello", Toast.LENGTH_SHORT).show(); } @Override public void init(Context context) { } }

 

发现服务，首先定义服务对象，而且添加注解，咱们不须要知道接口的具体实现类。

@Autowired(name = "/service/hello") IService service;

 

而后添加注解初始化，自动赋值。

ARouter.getInstance().inject(this);

最后咱们调用 service 里面的 sayHello() 方法。

service.sayHello(this);

效果图以下：

这里写图片描述

发现服务这个功能的特色在于，咱们只须要知道接口，不须要关心接口的实现类，很好了实现了解耦。

十四：其余

  • 关闭路由，这个操做慎用
ARouter.getInstance().destroy();

十五：混淆说明

-keep public class com.alibaba.android.arouter.routes.**{*;} -keep class * implements com.alibaba.android.arouter.facade.template.ISyringe{*;}

总结

全部的代码都上传至Github: https://github.com/zyj1609wz/Router

参考资料

ARouter解析一：基本使用及页面注册源码解析
ARouter解析二：页面跳转源码分析

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程