从需求出发：QMUI-最新版-QMUISchemeHandler-的设计与实现解析

doAction1(params)
}else if(action==“action2”){
doAction2(params)
}else {
…
}

每当有新的 scheme 添加时，就去添加一个 if，直到它逐渐变成一段巨长的烂代码，改都改不动。因而我们要勤思考、多重构，尽早通过设计出优良的框架来解放自己的双手。

对于 if else 这类的重构，一个基本的方式就是用查表法，将所有的条件以及其所要执行的行为放在一个 map 里，然后使用时通过去查询这个 map 而获取要执行的行为。而我们可以通过注解配合代码生成的方式构建这个 map，从而减少我们代码的编写量。除此之外，我们还需要考虑各种功能性需求：

1. 可以设置拦截器 interceptor，例如跳某些界面，如果是非登录的状态，可能需要跳转到登录界面
2. 参数可以指定一些基础类型， scheme 所携带的参数的值都是字符串，但我们希望它可以方便的转换成我们需要的基础类型
3. 同一个 action 可以根据参数的不同而有不同的跳转行为，例如都是跳转书籍详情，漫画书籍和普通书籍要跳转的界面可能不一样
4. 如果当前界面已经是目标界面，可以选择刷新当前界面或者启动一个新界面
5. 对于 QMUI，是同时支持 Activity 和 Fragment 的，因而 scheme 也要同时支持这两者
6. 可以自定义新界面的实例化方法

接口设计

任何一个库的开发，为了让业务使用方足够舒心，既要保证库的功能足够强大，也要保证使用的方便性，QMUI Scheme 对外主要是QMUISchemeHandler 这个入口类， 以及 ActivityScheme 和 FragmentScheme 两个注解。

QMUISchemeHandler

QMUISchemeHandler 通过 Builder 模式实例化：

// 设置schemeName
val instance = QMUISchemeHandler.Builder(“qmui://”)
// 防止短时间类触发多次相同的scheme跳转
.blockSameSchemeTimeout(1000)
// scheme 参数 decode
.addInterpolator(new QMUISchemeParamValueDecoder())
.addInterpolator(…)
// 默认 fragment 实例化 factory
.defaultFragmentFactory(…)
// 默认 activity 实例化 factory
.defaultIntentFactory(…)
// 默认 scheme 匹配器
.defaultSchemeMatcher(…)
.build();

if(!instance.handle(“qmui://xxx”)){
// scheme 未被 handle，日志记录？
}

大多数场景，QMUISchemeHandler 采用单例模式即可。 其可以设置多个拦截器、设置 fragment、activity 的默认实例化工厂、以及默认的匹配器。实例工厂和匹配器都是提供了默认实现的，大多数场景是不需要调用者关心的。而且这里都只是设置全局默认值，到了 scheme 注解那一层，还可以为每个 scheme 指定不同的值，以满足可能的自定义需求。

ActivityScheme 与 FragmentScheme 注解

这两个注解是非常相似的，但是因为 Fragment 有一些更多的配置项，因为独立出来了。

@Retention(RetentionPolicy.CLASS)
@Target(ElementType.TYPE)
public @interface ActivityScheme {
// scheme action 名
String name();
// 必须的参数列表，用于支持同一个 action 对应多个 scheme 的场景，每一项可以是"type=4" 来指定值，或者只传"type"来匹配任意值
String[] required() default {};
// 如果当前界面就是 scheme 跳转的目标值，可以选择刷新当前界面，当然当前界面必须实现 ActivitySchemeRefreshable
boolean useRefreshIfCurrentMatched() default false;
// 自定义当前 scheme 的匹配实现方法， 传值为 QMUISchemeMatcher 的实现
Class<?> customMatcher() default void.class; // 自定义当前 Activity 实例工厂，传值为 QMUISchemeIntentFactory Class<?> customFactory() default void.class;
// 指定参数的类型，支持 int/bool/long/float/double 这些基础类型，不指定则为 string 类型
String[] keysWithIntValue() default {};
String[] keysWithBoolValue() default {};
String[] keysWithLongValue() default {};
String[] keysWithFloatValue() default {};
String[] keysWithDoubleValue() default {};
}

@Retention(RetentionPolicy.CLASS)
@Target(ElementType.TYPE)
public @interface FragmentScheme {
// 这些参数都同 ActivityScheme
String name();
String[] required() default {};
Class<?> customMatcher() default void.class;
String[] keysWithIntValue() default {};
String[] keysWithBoolValue() default {};
String[] keysWithLongValue() default {};
String[] keysWithFloatValue() default {};
String[] keysWithDoubleValue() default {};

//同 ActivityScheme，但当前UI必须实现 FragmentSchemeRefreshable
boolean useRefreshIfCurrentMatched() default false;

// 同 ActivityScheme, 但传值是 QMUISchemeFragmentFactory 的实现类
Class<?> customFactory() default void.class; // 可以承载目标 Fragment 的 activity 列表，如果当前 activity 不在列表里，则用 activities 的第一项启动新的 activity Class<?>[] activities();
// 是否强制启动新的 Activity
boolean forceNewActivity() default false;
// 可以通过 scheme 里的参数来控制是否强制启动新的 Activity
String forceNewActivityKey() default “”;
}

可以看出，我们前面所罗列的各种需求，都在 SchemeHandler 以及两个 scheme 里体现出来了。

使用

对于业务使用者，我们只需要在 Activity 或者 Fragment 上加上注解。 QMUISchemeHandler 默认会将参数解析出来并放到 Activity 的 intent 里或者 Fragment 的 arguments 里，因而我们可以在 onCreate 里将我们关心的值取出来：

@ActivityScheme(name=“activity1”)
class Activity1: QMUIActivity{

override fun onCreate(…){
…
if(isStartedByScheme()){
// 通过 intent extra 获取参数的值
val param1 = getIntent().getStringExtra(paramName)
}
}
}

@FragmentScheme(name=“activity1”, activities = {QDMainActivity.class})
class Fragment1: QMUIFragment{
override fun onCreate(…){
…
if(isStartedByScheme()){
// 通过 arguments 获取参数的值
val param1 = getArguments().getString(paramName)
}
}
}

这种传值方法很符合 Android 官方设计的做法了，这也要求 Fragment 遵循无参构造器的使用方式。

对于 WebView， 我们可以通过重写 WebViewClient#shouldOverrideUrlLoading 来处理 scheme 跳转：

class MyWebViewClient: WebViewClient{
override fun shouldOverrideUrlLoading(view: WebView, url: String){
if(schemeHandler.handle(url)){
return true;
}
return super.shouldOverrideUrlLoading(view, url);
}

override fun shouldOverrideUrlLoading(view: WebView, request: WebResourceRequest){
if(schemeHandler.handle(request.getUrl().toString())){
return true;
}
return super.shouldOverrideUrlLoading(view, request);
}
}

实现

QMUISchemeHandler 采用代码生成的方式，在编译期生成一个 SchemeMapImpl 类，其实现了 SchemeMap 类

public interface SchemeMap {

// 通过 action 和参数寻找 SchemeItem
SchemeItem findScheme(QMUISchemeHandler handler, String schemeAction, Map<String, String> params);
// 判断 schemeAction 是否存在
boolean exists(QMUISchemeHandler handler, String schemeAction);
}

而每个 scheme 的注解对应一个 SchemeItem:

• ActivityScheme 对应实例化一个 ActivitySchemeItem 类，并加入到 map 中
• FragmentScheme 对应实例化一个 FragmentSchemeItem 类，并加入到 map 中

在编译期通过 SchemeProcessor 生成的 SchemeMapImpl 大概是这样子的：

最后

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数初中级Android工程师，想要提升技能，往往是自己摸索成长，自己不成体系的自学效果低效漫长且无助。

因此我收集整理了一份《2024年Android移动开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Android开发知识点！不论你是刚入门Android开发的新手，还是希望在技术上不断提升的资深开发者，这些资料都将为你打开新的学习之门

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！
的新手，还是希望在技术上不断提升的资深开发者，这些资料都将为你打开新的学习之门**

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！