前言
自2024年9月1.0.0版本上架,自己便主推了router以注解的形式使用,让开发者,一个注解,一行代码便可完成页面之间的跳转,无论是当时,还是现在,依然是鸿蒙开发中最便捷的使用方式。
执行跳转
TypeScript
startPage("entry_test")
相关页面(必须export)
TypeScript
@RouterPath("entry_test")
@ComponentV2
export struct Test{
build(){
Column(){}
}
}
以上的方式,就完成了路由的注册与跳转,已经相对来说很是简洁,但是它存在两个问题,第一个问题是必须纯字符串形式,显然这是不符合日常需求开发的,毕竟我们需要路由管理工具类来单独的管理,在模块比较多的情况下,有可能会有多个路由管理类;第二个问题是,必须携带模块前缀,因为内部做了模块检索,模块的前缀是必须要携带的,但是,又会和实际的开发相违背,比如路由标识有可能是多端统一使用的, 不方便路由标识管理,虽然可以多端统一,鸿蒙内部单独加,不影响外部统一,但在开发中手动配置也是不方便。
针对第一个问题,后续推出了,每个模块,在根路径下,可以创建一个路由管理类,来对整个模块进行管理:
比如entry模块(Module)下,你可以在根路径下创建任意的管理类,比如EntryRouter:
路由写法,也是要遵循模块名字+自定义的路由别名。
TypeScript
export class EntryRouter {
static EntryTest= "entry_test"//测试页面
}
本模块下使用不变,直接获取即可。
TypeScript
@RouterPath(EntryRouter.EntryTest)
@Component
export struct TestPage {
build() {
//UI组件
}
}
本模块下跳转
TypeScript
startPage(EntryRouter.EntryTest)
每个模块下管理自己的路由,似乎边界清晰可维护,但是局限性也很大,比如要跨模块跳转呢,路由该如何获取?让两个模块分别定义一个,虽然能解决问题,但是显得代码冗余,况且,第二个问题,前缀问题,仍然存在。
除了以上两个问题之外,每次书写UI页面,还得必须手动书写注解@RouterPath,手动导包,繁琐的步骤,极大降低了开发效率。
以上存在的问题,不得不让我重新对router组件进行审视,它的初衷是帮助开发者提高效率,奈何提高了部分效率,却带来了一些问题,所以,优化,不得不提上日程。
经过两天的不断优化,1.1.0版本更新上架,此次更新,带来了全新的路由使用方式以及全新的配套插件,让router不仅好用,更好维护。
router组件地址:
ohpm.openharmony.cn/#/cn/detail...
路由管理模块
自己很早之前就确定过路由管理模块,在实际的项目开发中也是这么去做的,只是一直没有落实到router组件,此次更新,便明确了路由管理模块这一概念。
如果你的项目采用的是模块化/组件化开发,那么路由管理模块是完美契合的,你只需要创建一个单独的router静态共享包即可,由于它管理着所有模块的路由,在项目下的oh-package.json5文件里进行全局依赖即可,记住是项目下的oh-package.json5文件,不是某一个模块。

在项目下的oh-package.json5文件里进行依赖:

以上步骤完成之后,我们的路由管理模块就完成了,后续的所有模块的页面路由,都会在路由模块中进行配置,以后写路由,查路由,只需要关注这个模块即可,当然了,既然要对路由管理,那么就要约束好,所有页面中的路由都在此配置,不要有的人约束,有的人随意,否则,就违背了它的初衷。
为了解决团队的路由管理问题,针对路由管理模块中的路由,不需要大家来手动创建,后续结合插件使用,所有的页面会自动在这里一一配置。

插件创建页面
以前的插件,只支持纯字符串形式的路由配置,在1.1.0版本及以后,增加了第三种创建方式,路由模块页面创建,只需要在想要创建页面的地方,右键选择New->Router Page->Router Module Page,即可创建。

输入UI页面名字和自定义的路由名字,按回车或者点击确定即可。

那么一个完整的带有路由注册的UI页面就创建完毕了,全程,不需要大家手动配置路由,只需要正常写UI页面即可。
TypeScript
import { RouterPath } from "@abner/router";
import { RouterManager } from "router";
/**
*AUTHOR:AbnerMingdeMacBook-Pro.local
*DATE:2026/11/9
*INTRODUCE:
*/
@RouterPath(RouterManager.share.USER_INFO)
@Component
export struct UserInfoPage {
@State message: string = 'Hello UserInfoPage';
build() {
RelativeContainer() {
Text(this.message)
.fontWeight(FontWeight.Bold)
.alignRules({
center: { anchor: '__container__', align: VerticalAlign.Center },
middle: { anchor: '__container__', align: HorizontalAlign.Center }
})
.onClick(() => {
this.message = 'Welcome';
})
}
.height('100%')
.width('100%')
}
}
以上的创建页面,会自动在router路由管理模块,自动化配置,全程无须人工在配置。
RouterManager类:
TypeScript
import { MineConstants } from "./constants/MineConstants"
import { EntryConstants } from "./constants/EntryConstants"
import { getRouterModuleName } from "@abner/router"
import { ShareConstants } from "./constants/ShareConstants"
/**
*AUTHOR:AbnerMing
*DATE:2026/11/9
*INTRODUCE:路由管理,如果想要路由不写前缀,需要在这里进行配置
*/
export class RouterManager {
static readonly mine = getRouterModuleName(MineConstants, "mine")
static readonly entry = getRouterModuleName(EntryConstants, "entry")
static readonly share = getRouterModuleName(ShareConstants, "share")
}
ShareConstants类:
TypeScript
/**
*AUTHOR:AbnerMing
*DATE:2026/11/9
*INTRODUCE:share模块路由常量配置
*/
export class ShareConstants {
static MESSAGE: string = "message"
static USER_INFO: string = "user_info"
}
路由全部按照不同的模块进行划分,方便路由查找和修改,并且路由全部自定义实现,无须在手动配置前缀。
后续跳转,使用路由管理类RouterManager,后面就是模块,再后面就是自定义的路由,结构清晰,一目了然。
TypeScript
startPage(RouterManager.share.USER_INFO)
相关总结
此次更新的特点是引入了路由管理模块,并更新了配套的插件使用方式,以插件驱动路由自动配置,来解放开发中的手动配置,使用中若有问题,可以及时反馈,不定期进行修改。