发起路由操作
所谓发起路由操作,就是指触发路由的操作,例如:
// 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();
如果要接受传递处理的数据,可以使用下面的方式:
@Route(path = MainRoutePath.MAIN_ACTIVITY)
public class MainActivity extends BaseActivity {
/**
- 接收参数
*/
@Autowired(name = “name”)
public String name;
@Autowired(name = “age”)
public int age;
…
}
拦截器
// A more classic application is to handle login events during a jump so that there is no need to repeat the login check on the target page.
// Interceptors will be executed between jumps, multiple interceptors will be executed in order of priority
@Interceptor(priority = 8, name = “test interceptor”)
public class TestInterceptor implements IInterceptor {
@Override
public void process(Postcard postcard, InterceptorCallback callback) {
…
// No problem! hand over control to the framework
callback.onContinue(postcard);
// Interrupt routing process
// callback.onInterrupt(new RuntimeException(“Something exception”));
// The above two types need to call at least one of them, otherwise it will not continue routing
}
@Override
public void init(Context context) {
// Interceptor initialization, this method will be called when sdk is initialized, it will only be called once
}
}
降级策略
ARouter提供的降级策略主要有两种方式,一种是通过回调的方式;一种是提供服务接口的方式。
一、回调方式
这种方式在跳转失败的时候会回调NavCallback接口的onLost方法。ARouter提供的回调方式的函数如下:
ARouter.getInstance().build(MainRoutePath.MAIN_ACTIVITY).navigation(this, new NavCallback() {
@Override
public void onFound(Postcard postcard) {
Log.d(“ARouter”, “找到了”);
}
@Override
public void onLost(Postcard postcard) {
Log.d(“ARouter”, “找不到了”);
}
@Override
public void onArrival(Postcard postcard) {
Log.d(“ARouter”, “跳转完了”);
}
@Override
public void onInterrupt(Postcard postcard) {
Log.d(“ARouter”, “被拦截了”);
}
});
二、服务接口
全局降级-服务接口的方式主要处理逻辑在内部,暴露的接口很友好。
ARouter.getInstance().build(“/test/test”).navigation();
此种降级策略需要实现服务接口DegradeService,返回的就一个方法就是onLost。例如:
@Route(path = RoutePath.DEGRADE)
public class DegradeServiceImpl implements DegradeService {
@Override
public void onLost(Context context, Postcard postcard) {
ARouter.getInstance().build(RoutePath.DEGRADE_TIP).greenChannel().navigation();
}
@Override
public void init(Context context) {
}
}
混淆
为了避免打包时出现错误,需要将下面的内容使用keep标示。
-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
ARouter Helper,
在 Android Studio 插件市场中搜索 ARouter Helper, 或者直接下载文档上方 最新版本 中列出的 arouter-idea-plugin zip 安装包手动安装,安装后 插件无任何设置,可以在跳转代码的行首找到一个图标 (navigation) 点击该图标,即可跳转到标识了代码中路径的目标类。
ARouter模块化示例
接下来,将会用一个demo介绍如何用ARouter进行模块化开发,demo模块化的整体架构如下图所示。
每个模块的作用如下:
- app:项目的宿主模块,仅仅是一个空壳,依赖于其他模块,成为项目架构的入口;
- baselibrary:项目的基类库,每个子模块都依赖共享公用的类和资源,防止公用的功能在不同的模块中有多个实现方式;
- module_route:集中管理所有模块的route的库;
- module_main:闪屏页,登录页,主页等;
- module_home:首页模块;
- module_video:视频模块;
- module_mine:我的模块;
依赖模式与独立模式的切换
使用模块化开发的一个好处是,各个独立的模块可以同时开发,独立运行而不必依赖于宿主app,也就是每个module是一个独立的App,项目发布的时候依赖到宿主App中即可。各业务模块之间不允许存在相互依赖关系,但是需要依赖基类库。
并且,单一模块生成的apk体积也小,编译时间也快,开发效率会高很多,同时也可以独立测试,要实现这样的效果需要对项目做一些配置。
gradle.properties配置
在主项目的gradle.properties中需要设置一个开关,用来控制module的编译模式,例如:
isModule=false
当isModule为false时作为依赖库,只能以宿主app启动项目,选择运行模块时其他module前都是红色的X,表示无法运行。
当isModule为true时,作为单独的模块进行运行,选择其中一个具体的module就可以直接运行。
module清单文件
为了完成依赖模式与独立模式的切换,module清单文件需要配置两个,一个作为独立项目的清单文件,一个作为库的清单文件,以module_main模块为例。
buildApp作为依赖库的清单文件,和独立项目的清单文件buildModule区别是依赖库的清单文件Application中没有配置入口的Activity,其他都一样。
gradle配置
为了完成切换,还需要对module的build.gradle文件进行配置,如下图:
宿主app配置
接下来,在宿主app的build.gradle中添加模块依赖,如下所示:
dependencies {
if (!isModule.toBoolean()) {
implementation project(‘:module_home’)
implementation project(‘:module_video’)
implementation project(‘:module_main’)
implementation project(‘:module_mine’)
implementation project(‘:module_router’)
}
}
ARouter Helper
常见问题
问题1
错误:ARouter::Compiler >>> No module name, for more information, look at gradle log.
检查项目依赖的全部module,包括module依赖的module,为了能够进行单独的编译,所以需要为每一个module添加名称,即在每个module的 build.gradle中加上下面的代码:
defaultConfig {
javaCompileOptions {
annotationProcessorOptions {
arguments = [ AROUTER_MODULE_NAME : project.getName() ]
}
}
}
问题2
ARouter.getInstance().inject(this);
问题描述:有一个singletask启动模式的activity,在onNewIntent方法中调用ARouter.getInstance().inject(this);得不到参数,查看ARouter在build过程中生成的代码可以知道它是调用了activity的getIntent来获取参数的,但是onNewIntent中的intent和在onCreate方法中的intent并不相同,所以需要在onNewIntent方法中调用setIntent方法,然后就能得到参数了。
问题3
ARouter there’s no route matched
不同module的一级路径必须不同,否则会导致一个moudle中的一级路径失效。
附:示例下载地址
##文末
好啦,如此文章到这里就结束了,希望这篇文章能够帮到正在看的你们解决小伙伴们的问题~
如果你觉得文章写得不错就给个赞呗?如果你觉得文章非常不错的话那就转发一个呗,让更多小伙伴看到;如果你觉得那里值得改进的,请给我留言。一定会认真查询,修正不足,谢谢~
最后文末放上一个技术交流群:Android架构设计(185873940)
文末
对于很多初中级Android工程师而言,想要提升技能,往往是自己摸索成长,不成体系的学习效果低效漫长且无助。 整理的这些架构技术希望对Android开发的朋友们有所参考以及少走弯路,本文的重点是你有没有收获与成长,其余的都不重要,希望读者们能谨记这一点。
最后想要拿高薪实现技术提升薪水得到质的飞跃。最快捷的方式,就是有人可以带着你一起分析,这样学习起来最为高效,所以为了大家能够顺利进阶中高级、架构师,我特地为大家准备了一套高手学习的源码和框架视频等精品Android架构师教程,保证你学了以后保证薪资上升一个台阶。
当你有了学习线路,学习哪些内容,也知道以后的路怎么走了,理论看多了总要实践的。
进阶学习视频
附上:我们之前因为秋招收集的二十套一二线互联网公司Android面试真题 (含BAT、小米、华为、美团、滴滴)和我自己整理Android复习笔记(包含Android基础知识点、Android扩展知识点、Android源码解析、设计模式汇总、Gradle知识点、常见算法题汇总。)
《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》,点击传送门,即可获取!
id面试真题** (含BAT、小米、华为、美团、滴滴)和我自己整理Android复习笔记(包含Android基础知识点、Android扩展知识点、Android源码解析、设计模式汇总、Gradle知识点、常见算法题汇总。)
[外链图片转存中…(img-PLWg5t8C-1715067385871)]
《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》,点击传送门,即可获取!