鸿蒙开发:router组件升级,彻底告别手动配置

前言

自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)

相关总结

此次更新的特点是引入了路由管理模块,并更新了配套的插件使用方式,以插件驱动路由自动配置,来解放开发中的手动配置,使用中若有问题,可以及时反馈,不定期进行修改。

相关推荐
Digitally30 分钟前
如何在安卓设备上使用 4 种简单方法将应用移动到 SD 卡
android
booboosui2 小时前
录一遍就会:8 种步骤、6 类失败,卡住时只修那一步
android
阿杰m2 小时前
Android源码第十五章:Camera2 与 CameraService——一帧图像怎样回到应用
android
茶底世界之下7 小时前
雾中山路的冷光层次:用 Awaking 留住红色背影
ios·app·产品
Digitally8 小时前
iPhone 如何添加日历?
ios·iphone
恋猫de小郭8 小时前
Flutter Analyzer 系列坑推进,必看,AI 时代这玩意最吃你内存
android·前端·flutter
威哥爱编程8 小时前
模拟面试智能体开发实战 09:把面试官装进手机,鸿蒙端聊天界面用 SSE 流式输出让回复逐字滚出来
python·agent·harmonyos
威哥爱编程8 小时前
模拟面试智能体开发实战 10:配置写死在代码里还怎么换服务端,把设置和简历做成界面可配、可存
python·agent·harmonyos
LinXunFeng20 小时前
拿竞品 App 一扫,技术栈全暴露了
android·flutter·开源