当前位置：首页 > news >正文

鸿蒙动态路由实现方案

news 2025/7/27 22:47:42

背景

随着CSDN 鸿蒙APP 业务功能的增加，以及为了与iOS、Android 端统一页面跳转路由，以及动态下发路由链接，路由重定向等功能。鸿蒙动态路由方案的实现迫在眉睫。

实现方案

鸿蒙版本动态路由的实现原理，类似于 iOS与Android的实现原理，具体理论可以查看 iOS 动态路由实现这篇博文，这边不在赘述，这边只阐述实现逻辑。

1、路由地址与页面绑定

为了让鸿蒙中的每个页面都有一个固定的URL地址，我们这边借助了三方框架 HMRouter，具体HMRouter的实现方案，可以查看文档

@HMRouter({ pageUrl: 'app://app.com/blog/detail' })
@Component
export struct BlogDetailPage {
}

2、动态路由注册与跳转

我们实现了一个Router类，该类来实现我们动态路由表存储以及跳转的所有逻辑。routers 中存放了所有已经注册的URL。

 class Router {/***  保存了所有已注册的 URL*  结构类似 {"blog": {":blogId": {"_":callback}}}*/private  routers:Map<string,CommonAllType>}

通过下面方法实现注册动态路由表routers

 /** 添加路由到路由表* */private addURL(urlStr:string):Map<string,CommonAllType>{let pathComponents = this.pathComponentsFromURL(urlStr)let subRoutes = this.routersfor (let pathComponent of pathComponents){if (!subRoutes.get(pathComponent)) {subRoutes.set(pathComponent,new Map())}subRoutes = subRoutes.get(pathComponent) as Map<string,CommonAllType>}return subRoutes}

例如注册如下路由：

 Router.registerURLPattern('https://blog.csdn.net/:us' ,(params)=> {})

注册到本地路由表routers中应该是如下所示

{"https": {"blog.csdn.net": {":us": {"_": function ( {...} )}}}
}

在这里插入图片描述
所有注册的路由，都是以这种方式存储在routers中，跳转时就会从路由表中查询匹配到的路由，来跳转。
当有路由跳转时，调用以下方法：

Router.openUrl('https://blog.csdn.net/weixin_36162680/article/details/124127748', {'isLogin':true})

跳转时，匹配到路由有，那么也会生成相应的路由参数，如下：

{"un": "weixin_36162680","id": "124127748"
}

3、动态路由重定向实现及远端路由表格式

路由重定向

对于移动端的路由重定向，实际上就是将一个路由转换为另一个路由，例如：
https://blog.csdn.net/:us
转换为：
app://app.com/blog/detail?us=xxx

远端路由表格式

一条路由规则，分为一个 Key 和对应的 Value，Key 为需要注册的路由（匹配规则），Value 中包含重定向的路由地址，或者需要拦截的参数等。
这里面的Key 必须是与鸿蒙中页面所绑定的路由地址。

{"app://app.csdn.net/blog/detail": {"needLogin": true},"https://blog.csdn.net/:un": {"redirectUrl": "csdnapp://app.csdn.net/blog/detail"}
}

跳转时重定向逻辑

Router.registerURLPattern('https://blog.csdn.net/:us' ,(params)=> {//判断是否需要登录if (!UserTool.isLogin() && params.has(Router.routerNeedLogin)) {let needLogin = params.get(Router.routerNeedLogin) as booleanif (needLogin) {Router.login()return}}//判断是否需要重定向.....})

HMRouter 路由是否注册

在使用的时候，还有情况需要判断页面是否绑定了HMRouter

/** hm_router是否注册* */static isRegisterHMRouter(urlStr: string) : boolean {let mapJsonValue = getContext().resourceManager.getRawFileContentSync('hm_router_map.json')let jsonStr: string = strUtils.uint8ArrayToStr(mapJsonValue)let jsonObj = JSON.parse(jsonStr) as objectlet routMapArray = jsonObj['routerMap'] as Array<object>if (!strUtils.isBlank(urlStr)) {try {let tempURL = Url.URL.parseURL(urlStr)let tempUrlStr = tempURL.protocol + '//' + tempURL.host + tempURL.pathnamelet found = falsefor (let value of routMapArray){let name = value['name'] as stringif (name === tempUrlStr) {found = truebreak}}return found}catch (err){}}return false}