国内都比较流行开发超级APP,也就是我全都要,什么功能都想加进去,这致使业务逻辑变得愈来愈复杂. java
这时咱们会开始面临两个问题:android
res
文件夹下的资源将会迎来爆炸式地增加,而且咱们都知道res
文件夹不能分层,它只能按module
进行划分,因此你的layout
和mipmap
等文件夹将最早被迫害,当这两个文件夹的资源变多时,你要查找一个layout
或者一张图片都会变得十分费劲APP
仍是只有一个module
,还将会可能致使业务逻辑耦合没法复用,除非你的编程习惯十分良好,可是绝大多数人都作不到,因此咱们须要用组件化
来给本身一些约束
,以此创造更高质量的应用程序.我特别喜欢ARouter
简介中的一句话:解耦不是前提而是过程.接下来我将介绍如何使用ARouter
对项目进行组件化改造git
要组件化,首先你须要建立module
来分割你的业务逻辑.要建立新的module
能够在你的project
名字上右键,而后New->Module
github
Android Library
便可.
host
的
com.android.application
壳
module
,其余包含业务逻辑的
module
以
com.android.library
实现,
host
依赖其余
module
,这就能够实现组件化中的热插拔了.
这里列出我对本身项目里组件化改造后的目录结构的摘要编程
dng(project) //项目根
—— host(module) //壳模块
———— AppGlobal.java //自定义Application类
———— HostActivity.java //用来启动程序的Activity
—— common(module) //公共模块
———— PR.java //全部path的常量的集合
———— TTSService.java //从ai模块下沉的接口
———— Utils.java //通用工具类
—— ai(module) //业务逻辑模块
———— SpeakerFragment.java //业务逻辑
———— TTSServiceImpl.java //TTSService的具体实现类
—— navi(module) //业务逻辑模块
———— NaviFragment.java //业务逻辑
———— NaviViewModel.java //业务逻辑
复制代码
解释一下:api
先说common
模块,这个模块须要包含项目中要使用的全部依赖和一些公用的工具类,以后每一个模块都依赖common
模块,这样就能够把common
模块的依赖轻松地依赖导入到其余模块中去而不用在其余模块的build.gradle
中重复地写一大堆脚本.缓存
要想使用ARouter
,先要在common
模块的build.gradle
中使用api
(老版本是compile
)引入ARrouter
的运行时依赖(下面的版本可能不是最新的,获取最新版本请到Github获取最新版本的ARouter)bash
api 'com.alibaba:arouter-api:1.4.1'
复制代码
相似R
文件咱们还能够在common
模块中定义一个PR
的java
文件,来保存咱们项目中所用到的全部路由的path
app
public final class PR
{
public static final class navi
{
public static final String navi = "/navi/navi";
public static final String location_service = "/navi/location";
}
public static final class ai
{
public final static String tts_service = "/ai/tts";
public final static String asr_service = "/ai/asr";
public final static String speaker = "/ai/speaker";
}
}
复制代码
这能够帮助咱们更好的对页面按模块进行分类,同时,其余模块导入common
模块时,也会将PR
导入进去,但又不须要依赖某个具体实现的模块,咱们能够在页面跳转时直接引用这些常量,而且集中起来也好统一管理.框架
这里须要注意一点,在ARouter
中是使用path
来映射到页面的,每一个path
都必须至少有两级,而且每一个页面的第一级不能够是其余模块已经使用过的.
host
模块是,是一个空的APP
壳模块,基本不实现任何业务逻辑,经过在build.gradle
中,引用其余模块为本身添加功能.
implementation project(':common')
implementation project(':navi')
implementation project(':ai')
复制代码
AppGlobal
是我自定义的Application
,咱们须要在这里面给ARouter
进行初始化.注意循序不要错,不然你可能会看不到一些log
,并且在Debug
模式下必定要openDebug
,不然ARouter
只会在第一次运行的时候扫描Dex
加载路由表.
public final class AppGlobal extends MultiDexApplication
{
@Override
public void onCreate()
{
super.onCreate();
if (BuildConfig.DEBUG)
{
ARouter.openLog(); // Print log
ARouter.openDebug();
}
ARouter.init(this);
}
}
复制代码
个人HostActivity
中差很少就只有这些代码,能够看到我获取了ARouter
的单例,而后使用build
引用PR
传入path
,最后调用navigation
获取其余模块的Fragment
用来添加到当前Activity
中.
Fragment fragment = (Fragment) ARouter.getInstance()
.build(PR.navi.navi)
.navigation();
getSupportFragmentManager()
.beginTransaction()
.add(R.id.fragment_container, fragment, PR.ux.desktop)
.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_OPEN)
.commit();
复制代码
而后是navi
模块,由于这个模块使用了ARouter
的注解,记得要先在build.gradle
配置ARouter
注解处理器的环境(host
模块若是也使用了那么也要配置)
android {
//省略...
//ARouter注解处理器启动参数
javaCompileOptions {
annotationProcessorOptions {
arguments = [AROUTER_MODULE_NAME: project.getName()]
}
}
}
dependencies {
//省略..
//导入公共依赖
implementation project(':common')
//声明ARouter注解处理器
annotationProcessor 'com.alibaba:arouter-compiler:1.2.2'
}
复制代码
咱们在navi
模块中使用@Route
注解将PR.navi.navi
映射到具体的Fragment
或者Activity
这样:
@Route(path = PR.navi.navi)
public class NaviFragment extends Fragment
复制代码
或者这样:
@Route(path = PR.navi.navi)
public class NaviActivity extends AppCompatActivity
复制代码
ARouter
这种使用path
解耦的方式容许咱们在开发的过程当中更换PR.navi.navi
映射到的Fragment
或Activity
,而在代码修改时把对调用方的影响下降到最小.
但值得注意的是,ARouter
对不一样类型的处理是不同的,若是path
指向的是Fragment
,你须要获取navigation
的返回值并手动把它添加到FragmentManager
中.(若是不了解Fragment
的同窗能够看这篇文章 从Activity迁移到Fragment)
Fragment fragment = (Fragment) ARouter.getInstance()
.build(PR.navi.navi)
.navigation();
复制代码
而Activity
则不须要,它会当即显示
ARouter.getInstance()
.build(PR.navi.navi)
//还能够设置参数,ARouter会帮你存在Bundle中
.withString("pathId",UUID.randomUUID().toString())
//Activity 或 Context
.navigation(this);
复制代码
navi
模块是典型的业务逻辑模块,这里你可导入一些只有这个模块才会使用的专属第三方SDK,好比我在navi
模块中使用了高德地图
的SDK
,其余模块只须要我这个模块的地图功能,但它不该该知道我到底使用的是高德
仍是百度
仍是腾讯
地图,这就提升了封装性,在将来改变此模块的具体实现时,代价也会小得多.
ARouter
实现了module
间的路由操做,同时也实现了拦截器的功能,拦截器是一种AOP
(面向切面编程),比较经典的使用场景就是处理页面登陆与否的问题.拦截器会在跳转之间执行,多个拦截器会按优先级顺序依次执行.经过实现IInterceptor
接口并标注@Interceptor
注解,这样一来,这个拦截器就被注册到ARouter
当中了.
process
方法会传入Postcard
和InterceptorCallback
,Postcard
携带这次路由的关键信息,而InterceptorCallback
则用于处理这次拦截,调用onContinue
则放行,又或者调用onInterrupt
抛出自定义异常.
拦截器会在ARouter
初始化的时候进行异步
(不在主线程)初始化,若是第一次路由发生时,还有拦截器没有初始化完毕,那么ARouter
会等待该拦截器初始化完毕才进行路由.
@Interceptor(priority = 8)
public class TestInterceptor implements IInterceptor {
@Override
public void process(Postcard postcard, InterceptorCallback callback) {
callback.onContinue(postcard); // 处理完成,交还控制权
// callback.onInterrupt(new RuntimeException("我以为有点异常"));
// 以为有问题,中断路由流程
// 以上两种至少须要调用其中一种,不然不会继续路由
}
@Override
public void init(Context context) {
// 拦截器的初始化,会在ARouter初始化的时候调用该方法,仅会调用一次
}
}
复制代码
当页面未找到时,咱们能够定义一种降级策略来让程序继续运行,此时咱们须要实现DegradeService
接口,并用@Route
(必须)标注,而后它会在全局范围内生效,你能够在onLost
回调中自定义降级逻辑.
@Route(path = "/xxx/xxx")
public class DegradeServiceImpl implements DegradeService {
@Override
public void onLost(Context context, Postcard postcard) {
// do something.
}
@Override
public void init(Context context) {
}
}
复制代码
有时候页面咱们须要将path
其重定向别的path
,这时咱们能够实现PathReplaceService
接口,并用@Route
(必须)标注,而后它会在全局范围内生效.因此若没有重定向需求记得返回原path
@Route(path = "/xxx/xxx")
public class PathReplaceServiceImpl implements PathReplaceService {
String forString(String path) {
return path; // 按照必定的规则处理以后返回处理后的结果
}
Uri forUri(Uri uri) {
return url; // 按照必定的规则处理以后返回处理后的结果
}
@Override
public void init(Context context) {
}
}
复制代码
以上上三种接口中的init
方法,只有拦截器的调用时间是特殊的,其余两种,都是在第一次使用时才会进行初始化.
有的时候咱们可能须要的不是另一个模块的页面,而是它提供的服务(MVC中的Model层),这时这时咱们须要为本身想要的服务编写一个接口,并让他实现IProvider
接口,而后把它放到common
模块中, 可是接口的实现依然放在非common
的具体的模块中,好比common
模块的TTSService
和ai
模块的TTSServiceImpl
.
这种作法被称为接口下沉
,其实它并非严格符合解耦
思想的,可是它很是有用,就像你使用了ARouter
,但没人规定你就不能用startActivity
了同样,框架最终的目的仍是为了方便咱们编码的,而不是为了给咱们添堵,更况且最终结果各模块依然是松散耦合的.
服务的初始化时机也是在第一次使用的时候.咱们在common
模块中声明TTSService
接口:
public interface TTSService extends IProvider
{
void send(String text);
void stop();
}
复制代码
并在ai
模块中实现它并使用@Route
注解标注
@Route(path = PR.ai.tts_service)
public class TTSServiceImpl implements TTSService
{
//省略...
}
复制代码
这样咱们就能在其余模块使用该服务了
TTSService ttsService = (TTSService) ARouter.getInstance()
.build(PR.ai.tts_service)
.navigation()
复制代码
有些第三方SDK
初始化是必需要在Application
的onCreate
中进行初始化的,可是若是咱们编写独立于host
的module
时,要怎么初始化它们呢?
ARouter
并无提供官方的解决方案,可是通过个人实践,咱们能够经过声明ContentProvider
并在模块内AndroidManifest
中注册它来实现初始化功能.
//java
public class ModuleLoader extends ContentProvider
{
@Override
public boolean onCreate()
{
Context context = getContext();
//TODO
return true;
}
//......
}
//AndroidManifest
<provider
android:authorities="${applicationId}.navi-module-loader"
android:exported="false"
android:name=".app.ModuleLoader"/>
复制代码
ContentProvider#onCreate
在Application#attachBaseContext
调用以后Application#onCreate
调用以前执行,而且能够经过getContext
拿到Application
的Context
.这样就解决了部分第三方SDK
初始化的问题.
简单归纳起来其实也就是两个知识点:
APT
注解处理器经过注解生成RouteMeta
元数据到指定包下Dex
指定包下class
,加载并缓存路由表,而后在navigation
是对path
映射到的不一样类型尽量地抽象出同一套接口若是还想深刻理解ARouter
,可能就须要去读源码了.
ARouter
目前暂时不支持多进程开发,这是我以为比较遗憾的,但愿将来可以支持吧.
ARouter
的介绍就到此为止了,若是还想了解ARouter
的依赖注入功能请移步Github.
若是喜欢个人文章记得给我点个赞,拜托了,这对我真的很重要.