【学习】ARouter的基本使用

2021-06-09 本文已影响0人 Merbng

首先借用阿里云栖社区的一段话：
我们所使用的原生路由方案一般是通过显式intent和隐式intent两种方式实现的（这里主要是指跳转Activity or Fragment）。在显式intent的情况下，因为会存在直接的类依赖的问题，导致耦合非常严重；而在隐式intent的情况下，则会出现规则集中式管理，导致协作变得非常困难。一般而言配置规则都是在Manifest中的，这就导致了扩展性较差。除此之外，使用原生的路由方案会出现跳转过程无法控制问题，因为一旦使用了startActivity()就无法插手其中的任何环节了，只能交给系统管理，这就导致了在跳转失败的情况下无法降级，而是会直接抛出运营级的异常。这时候如果考虑使用自定义的路由组件就可以解决以上问题，比如通过URL索引就可以解决类依赖的问题；通过分布式管理页面配置可以解决隐式intent中集中式管理Path的问题；自己实现整个路由过程也可以拥有良好的扩展性，还可以通过AOP的方式解决跳转过程中无法控制的问题，与此同时也能够提供非常灵活的降级方式。

初始化

public class BaseActivity extends AppCompatActivity{
    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState){
        super.onCreate(savedInstanceState);
        // ARouter  inject 注入
        ARouter.getInstance().inject(this);
    }
    @Override
    protected void onDestory(){
        super.onDestory();
        //这样写会报错
        //ARouter.getInstance().destory();
    }
    //推荐写在这里
    @Override
    public void onTerminate(){
        super.onTerminate();
        ARouter.getInstance().destory();
    }
}

简单页面跳转

如果只是简单的页面跳转，一行代码即可完成。

ARouter.getInstance().build(Constance.ACTIVITY_URL_NEXT_PAGE).navigation()

Activity 跳转

@Route(path=Constance.ACTIVITY_URL_MAIN)
public class MainActivity extends BaseActivity{
    @Override
    protected void onCreate(Bundle savedInstanceState){
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        //跳转 到 NextPageActivity
        ARouter.getInstance().build(Constance.ACTIVITY_URL_NEXT_PAGE).navigation();
    }

}


//  path 要一致
@Route(path =Constance.ACTIVITY_URL_NEXT_PAGE)
public class NextPageActivity extends BaseActivity{
        @Override
    protected void onCreate(Bundle savedInstanceState){
        super.onCreate(savedInstanceState);
        
        
    }
}

不要忘了在清单文件里配置Activity

携带参数的跳转

ARouter.getInstance().build(Constance.ACTIVITY_URL_NEXT_PAGE)
.whithString("name","Android")
.withInt("age",3)
.withParceable("test",new ManualBean("merbng","28"))
.navigation();

在目标界面，使用AutoWired注解

@AutoWired()
String name;

@AutoWired()
int age;

@AutoWired(name="test")
ManualBean bean;

@Override
protected void onCreate(@Nullable Bundle savedInstanceState){
    super.onCreate(savedInstanceState);
    mTextView.setText("姓名："+name+"年龄："+age+"test对象："+bean.toString());
}

界面跳转动画

直接调用withTransition，里面传入两个动画即可

ARouter.getInstance().build(Constance.ACTIVITY_URL_NEXT_PAGE)
.withTransition(R.anim.a_1,R.anim.a_2)
.navigation();

使用URI跳转

Uri uri =Uri.parse(Constance.ACTIVITY_URL_NEXT_PAGE);
ARouter.getInstance().build(uri).navigation();

Fragment 跳转

Fragment的跳转也可以参照Activity跳转，第一步依旧是先写上类注解，然后是强转

Fragment fragment =(Fragment)ARouter.getInstance().build(Constance.ACTIVITY_URL_NEXT_PAGE).navigation();

拦截器

@Interecptor(priority =1 )
public class UseInterceptor implements IInterceptor{
    @Override
    public void init(Context context){
        
    }
    @Override
    public void process(Postcard postcard,InterceptorCallback callback){
        String name =Thread.currentThread().getName();
        //拦截器开始执行
    }
}

定义ARouter拦截器必须要使用Interceptor注解。
注解里面的priority，这个是声明拦截器的优先级，里面的属性值是int类型，
priority数值越小，越优先执行，
如果两个拦截器的优先级一样，项目就会编译报错，所以不同拦截器定义的优先级属性值不能相同

监听

NavigationCallback 就是ARouter在路由跳转过程中，可以监听路由的一个具体过程，一共有四个方法

ARouter.getInstance().build(Constance.ACTIVITY_URL_NEXT_PAGE).navigation(MainActivity.this,new NavigationCallback(){
@Override
public void onFound(Postcard postcard){
    //路由目标被发现时调用
}
@Override
public void onArrival(Postcard postcard){}
    //路由到达后调用
});
@Override
public void onLost(Postcard postcard){
    //路由被丢失时调用
}
@Override
public void onInterrupt(Postcard postcard){
    //路由被拦截时调用
}

自定义分组

如果使用自定义分组来跳转页面，只需要在源代码改动以下三个位置：
1.类注解新增group，赋值我们自定义的组名

@Route(path = Constance.ACTIVITY_URL_MAIN,group=Constance.GROUP_FIRST)
public class MainActivity extends BaseActivity{
    public static final String TAG ="app";
}

在build方法里，添加我们的与之对应的组名

ARouter.getInstance().build(Constance.ACTIVITY_URL_INTERCEPTOR,Constance.GROUP_FIRST).navigation();

在被跳转的Activity里面的类注释，加上同样的组名

@Route(path =Constance.ACTIVITY_URL_INTERCEPTOR,group=Constance.GROUP_FIRST)
public class InterceptorActivity extends BaseActivity{

}

实现startActivityForResult()

1.在第一个Activity设置requestCode为 123

@Override
protected void onActivityResult(int requestCode,int resultCode,Intent data){
    super.onActivityResult(requestCode,resultCode,data);
    switch(requestCode){
        case 123:
        //接受到了第二个界面返回来的数据
        break
    }
}

2.需要在跳转的navigation方法里面的第二个参数，设置我们定义的requestCode

ARouter.getInstance().build(Constance.ACTIVITY_URL_NEXT_PAGE)
.withString("name","merbng")
.withInt("age",28)
.withParceable("test",new ManualBean("merbng",28))
.navigation(MainActivity.this,123);

在第二个界面的setResult方法里面，写上对应的resultCode,

        @Override
    protected void onCreate(Bundle savedInstanceState){
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_second);
        //返回上一个页面
        setResult(123);
        
    }

参考链接：
探索Android路由框架-ARouter之基本使用

下面这些代码可让markdown转为html