android路由框架的好处,严选 Android 路由框架优化（下篇）

3 router 框架优化

3.1 apt 生成代码量过大问题优化

思考框架本身，其实可以发现仅有 router 映射表是需要根据注解编译生成的，其他的全部代码都是固定代码，完全可以 sdk 中直接编码提供。反过来思考为何当初 sdk 开发需要编写繁重的 apt 生成代码，去生成这些固定的逻辑，可以发现 htrouterdispatch-process 工程是一个纯 java 工程，部分纯 java 类的提供在 htrouterdispatch。由于无法引用 Android 类，同时期望业务层接口能完美隐藏内部实现，为此和 Android 相关的类，索性全部由 apt 生成。

apply plugin: 'java' // 使用 apply plugin: 'com.android.library' 编译报错

sourceCompatibility = JavaVersion.VERSION_1_7

targetCompatibility = JavaVersion.VERSION_1_7

dependencies {

compile project (':htrouterdispatch')

compile 'com.google.auto.service:auto-service:1.0-rc2'

compile 'com.squareup:javapoet:1.0.0'

}

为了解决这里的问题，我们可以稍微降低对实现封装的隐藏程度，修改初始化接口，需要业务层将 router 映射表显式的传入。修改后就能发现仅有 HTRouterTable 里面的映射表接口需要 apt 生成，而其余的代码均可通过直接编码。

HTRouterManager.init();

→

HTRouterManager.init(HTRouterTable.pageRouters(),

HTRouterTable.methodRouters(),

HTRouterTable.interceptors());

HTRouterTable.methodRouters() 和 HTRouterTable.interceptors() 先忽略，后续解释

新建了一个 Android Libraryhtrouter，引用工程htrouterdispatch，app 工程修改引用htrouter

经过优化，router 跳转的逻辑代码可通过直接编码方式实现，普通 Android 开发也能轻松修改其中的逻辑，同时 apt 生成的类从 6 个直接减少至 1 个 HTRouterTable。若出现业务层代码编译错误导致 apt 生成失败，最终导致编译器提示 HTRouterTable not found，可仅需注释掉初始化代码即可。

/**

* 用于用户启动Activity或者通过URL获得可以跳转的目标

*/

public final class HTRouterTable{

public static final String HT_URL_PARAMS_KEY = "ht_url_params_map";

private static final List PAGE_ROUTERS = new LinkedList();

private static final List INTERCEPTORS = new LinkedList();

private static final List METHOD_ROUTERS = new LinkedList();

public static List pageRouters(){

if (PAGE_ROUTERS.isEmpty()) {

PAGE_ROUTERS.add(new HTRouterEntry("com.netease.yanxuan.module.home.category.activity.CategoryPushActivity", "yanxuan://homepage_categoryl2", 0, 0, false));

...

}

return PAGE_ROUTERS;

}

public static List interceptors(){

if (INTERCEPTORS.isEmpty()) {

PAGE_ROUTERS.add(new HTRouterEntry("com.netease.yanxuan.module.home.recommend.activity.TagActivity", "yanxuan://tag", 0, 0, false));

...

}

return INTERCEPTORS;

}

public static List methodRouters(){

if (METHOD_ROUTERS.isEmpty()) {

{

List paramTypes = new ArrayList();

paramTypes.add(Context.class);

paramTypes.add(String.class);

paramTypes.add(int.class);

METHOD_ROUTERS.add(new HTMethodRouterEntry("http://www.you.163.com/jumpA", "com.netease.hearttouch.example.JumpUtil", "jumpA", paramTypes));

}

...

}

return METHOD_ROUTERS;

}

}

3.2 拦截器优化

3.2.1 优化前临时方案

针对登录拦截需求，当时的临时解决方案如下：

路由注解添加 needLogin 字段

并修改 apt 生成代码，使 HTRouterEntry 记录 needLogin 信息

提供 RouterUtil.startActivity 将目标页面的跳转构建成一个 runnable 传入，在登录成功回调中执行 runnable

@HTRouter(url = {PreemptionActivateActivity.ROUTER_URL}, needLogin = true)

public class PreemptionActivateActivity extends Activity{

...

}

public static boolean startActivity(final Context context, final String schemeUrl,

final Intent sourceIntent, final boolean isFinish){

return doStartActivity(context, schemeUrl, new Runnable(){

@Override

public void run(){

HTRouterManager.startActivity(context, schemeUrl, sourceIntent, isFinish);

}

});

}

private static boolean doStartActivity(final Context context, final String schemeUrl,

final Runnable runnable){

if (HTRouterManager.isUrlRegistered(schemeUrl)) {

HTRouterEntry entry = HTRouterManager.findRouterEntryByUrl(schemeUrl);

if (entry == null) {

return false;

}

if (entry.isNeedLogin() && !UserInfo.isLogin()) {

LoginActivity.setOnLoginResultListener(new OnLoginResultListener() {

@Override

public void onLoginSuccess(){

runnable.run();

}

@Override

public void onLoginFail(){

// do nothing

}

});

LoginActivity.start(context);

}

return true;

}

return false;

}

可以发现这种处理方式并不通用，同时需要业务层代码全部修改调用方式，未修改的接口还是可能出现以未登录态进入需要登录的页面(这种情况也确实在后面发生过，后来我们要求前端跳转之前，先通过 jsbridge 唤起登录页面(⊙﹏⊙)b)。我们需要一种通用规范的方式处理拦截逻辑，同时能适用各种场景，也能规避业务层的错误。

3.2.2 拦截器优化和设计

为避免业务层绕过拦截器直接调用到 HTRouterManager，将 HTRouterManager.startActivity 等接口修改为 package 引用范围，此外新定义 HTRouterCall 作为对外接口类。

public class HTRouterCall implements IRouterCall{

...

}

public interface IRouterCall {

// 继续路由跳转

void proceed();

// 继续路由跳转

void cancel();

// 获取路由参数

HTRouterParams getParams();

}

定义拦截器 interface 如下：

public interface IRouterInterceptor{

void intercept(IRouterCall call);

}

总结拦截的需求场景，归纳拦截场景为 3 种：

全局拦截 → 全局拦截器

全局拦截器，通过静态接口设置添加 public static void addGlobalInterceptors(IRouterInterceptor... interceptors){

Collections.addAll(sGlobalInterceptors, interceptors);

}

登录拦截需求可以理解是一个全局的需求，全部的 Activity 跳转都需要判断是否需要唤起登录页面。 public class LoginRouterInterceptor implements IRouterInterceptor{

@Override

public void intercept(final IRouterCall call){

HTDroidRouterParams params = (HTDroidRouterParams) call.getParams();

HTRouterEntry entry = HTRouterManager.findRouterEntryByUrl(params.url);

if (entry == null) {

call.cancel();

return;

}

if (entry.isNeedLogin() && !UserInfo.isLogin()) {

LoginActivity.setOnLoginResultListener(new OnLoginResultListener() {

@Override

public void onLoginSuccess(){

call.proceed();

}

@Override

public void onLoginFail(){

call.cancel();

}

});

LoginActivity.start(params.getContext());

} else {

call.proceed();

}

}

}

登录拦截效果

业务页面固定拦截 → 注解拦截器

上面剩余的 7 个 switch-case 拦截，可以理解为特定业务页面唤起都必须进入的一个拦截处理，分别定义 7 个拦截器类，同样通过注解的方式标记。

以 yanxuan://category 为例子@HTRouter(url = {"yanxuan://category", "yanxuan://categoryl2"})

public class CategoryL2Activity extends Activity{

...

}

对应的注解拦截器@HTRouter(url = {"yanxuan://category"})

public class CategoryL2Intercept implements IRouterInterceptor{

@Override

public void intercept(IRouterCall call){

HTRouterParams routerParams = call.getParams();

Uri uri = Uri.parse(routerParams.url);

// routerParams.url 添加额外参数

Uri.Builder builder = uri.buildUpon();

...

routerParams.url = builder.build().toString();

call.proceed();

}

}

apt 生成拦截器初始化代码public static List interceptors(){

if (INTERCEPTORS.isEmpty()) {

...

INTERCEPTORS.add(new HTInterceptorEntry("yanxuan://category", new CategoryL2Intercept()));

...

}

return INTERCEPTORS;

}

HTRouterTable

业务页面动态拦截

比如 onClick 方法内执行路由跳转时，需要弹窗提示用户是否继续跳转，其他场景跳转并不需要这个弹窗，这种场景的拦截器我们认为是动态拦截 HTRouterCall.newBuilder(data.schemeUrl)

.context(mContext)

.interceptors(new IRouterInterceptor() {

@Override

public void intercept(final IRouterCall call){

Log.i("TEST", call.toString());

AlertDialog dialog = new AlertDialog.Builder(mContext)

.setTitle("alert")

.setMessage("是否继续")

.setPositiveButton("继续", new DialogInterface.OnClickListener() {

@Override

public void onClick(DialogInterface dialog, int which){

call.proceed();

}

})

.setNegativeButton("取消", new DialogInterface.OnClickListener() {

@Override

public void onClick(DialogInterface dialog, int which){

call.cancel();

}

}).create();

dialog.show();

}

})

.build()

.start();

优先级：动态拦截器 > 注解拦截器 > 全局拦截器

3.3 sdk 页面 router 支持

我们接入了七鱼、HTImagePick 等 sdk，这些 sdk 也有自己的页面，而这部分页面并不能通过前面的路由方式打开，其原因如下：

我们不能修改他们的代码

apt 处理的注解仅能针对引入 apt 的 app 工程

对应的页面唤起需要通过 sdk 提供的特殊接口唤起 public static void openYsf(Context context, String url, String title, String custom){

ConsultSource source = new ConsultSource(url, title, custom);

Unicorn.openServiceActivity(context, // 上下文

title, // 聊天窗口的标题

source // 咨询的发起来源，包括发起咨询的url，title，描述信息等

);

}

七鱼客服页面唤起

public void openImagePick(Context context, ArrayList photoInfos, boolean multiSelectMode, int maxPhotoNum, String title){

HTPickParamConfig paramConfig = new HTPickParamConfig(HTImageFrom.FROM_LOCAL, null,

photoInfos, multiSelectMode, maxPhotoNum, title);

HTImagePicker.INSTANCE.start(context, paramConfig, this);

}

基于此，只需要提供对方法的 router 调用，就能支持 sdk 中的页面路由跳转。具体用法示例如下

通过 HTMethodRouter 注解标记跳转方法(非静态方法需实现 getInstance 单例) public class JumpUtil{

private static final String TAG = "JumpUtil";

private static JumpUtil sInstance = null;

public static JumpUtil getInstance(){

if (sInstance == null) {

synchronized (JumpUtil.class) {

if (sInstance == null) {

sInstance = new JumpUtil();

}

}

}

return sInstance;

}

private JumpUtil(){

}

@HTMethodRouter(url = {"http://www.you.163.com/jumpA"}, needLogin = true)

public void jumpA(Context context, String str, int i){

String msg = "jumpA called: str=" + str + "; i=" + i;

Log.i(TAG, msg);

if (context != null) {

Toast.makeText(context, msg, Toast.LENGTH_LONG).show();

}

}

@HTMethodRouter(url = {"http://www.you.163.com/jumpB"})

public static void jumpB(Context context, String str, int i){

String msg = "jumpB called: str=" + str + "; i=" + i;

Log.i(TAG, msg);

if (context != null) {

Toast.makeText(context, msg, Toast.LENGTH_LONG).show();

}

}

@HTMethodRouter(url = {"http://www.you.163.com/jumpC"})

public void jumpC(){

Log.i(TAG, "jumpC called");

}

}

方法路由触发逻辑

除了设置动画、是否关闭当前页面等参数，这里方法路由的调用方式和页面路由完全一致，同样支持 needLogin 字段，同样支持全局拦截器、注解拦截器、动态拦截器 // JUMPA 按钮点击

public void onMethodRouter0(View v){

HTRouterCall.call(MainActivity.this, "http://www.you.163.com/jumpA?a=lilei&b=10");

}

// JUMPB 按钮点击

public void onMethodRouter1(View v){

HTRouterCall.call(MainActivity.this, "http://www.you.163.com/jumpB?a=hanmeimei&b=10");

}

// JUMPC 按钮点击

public void onMethodRouter2(View v){

HTRouterCall.call(MainActivity.this, "http://www.you.163.com/jumpC");

}

结果示例

3.4 main dex 优化处理

这里的处理逻辑较为简单，仅需修改类引用为类名字符串，后续跳转时通过反射获取类

public static List routers(){

if (ROUTERS.isEmpty()) {

...

ROUTERS.add(new HTRouterEntry("com.netease.yanxuan.module.subject.SubjectActivity", "yanxuan://subject", 0, 0, false));

...

}

return ROUTERS;

}

4 总结

通过优化拦截器，解决登录拦截问题，优化子模块和全局代码划分；通过提供方法路由，解决 sdk 页面的路由跳转问题；通过区分路由表生成代码和其他跳转逻辑，优化 apt 代码生成逻辑的复杂性和和维护性；通过修改路由表对类的直接引用，解决 main-dex 问题。

除此之外，路由框架并未对 module 子工程的 Activity 做路由集成，严选当前也没做更进一步的业务组件化。后续有需求进一步补充文章。

本文来自网易实践者社区，经作者张云龙授权发布。