ITPub博客

首页 > 架构设计 > 操作系统 > #HarmonyOS NEXT体验官# HMRouter使用详解(一)环境配置

#HarmonyOS NEXT体验官# HMRouter使用详解(一)环境配置

投稿 操作系统 作者:ITPUB鸿蒙小助手 时间:2025-12-04 17:37:20 0 删除 编辑

踏入鸿蒙世界的敲门砖,标志着您在技术征途上的全新起点,提升就业竞争力,获得行业 认可,点亮职业成长先机,快人一步抢占未来应用开发赛道! https://developer.huawei.com/consumer/cn/training/dev-cert-detail/101666948302721398?ha_source=hmosclass-itpub&ha_sourceId=70000033

 

背景

在项目中使用官方推荐的Navigation时,需要在所有的页面上都添加一层NavDestination,在代码阅读上会增加多个层级,而且还要在主页面设置对应名字的跳转等问题,配置起来比较繁琐。看到大佬开发的HMRouter使用起来方便简洁,因此,写下这篇文章记录HMRouter的使用。

插件配置

1.HMRouter 安装

在终端中运行下面命令进行第三方库的安装。

#HarmonyOS NEXT体验官# HMRouter使用详解(一)环境配置-鸿蒙开发者社区

#HarmonyOS NEXT体验官# HMRouter使用详解(一)环境配置-鸿蒙开发者社区

 

2. 添加路由编译插件

修改项目的hvigor/hvigor-config.json文件中的dependencies数组。

#HarmonyOS NEXT体验官# HMRouter使用详解(一)环境配置-鸿蒙开发者社区

 

3. 使用路由编译插件

在项目的entry/hvigorfile.ts文件中添加插件的使用。如果模块是Har则使用harPlugin(),模块是Hsp则使用hspPlugin()

4. 工程配置

由于拦截器、生命周期和自定义转场动画会在运行时动态创建实例,因此需要进行如下配置,使得HMRouter路由框架可以动态导入项目中的模块。

在工程目录下的build-profile.json5中,配置useNormalizedOHMUrl属性为true。

#HarmonyOS NEXT体验官# HMRouter使用详解(一)环境配置-鸿蒙开发者社区

 

HMRouter 使用

在UIAbility中初始化路由框架

在OnCreate中初始化路由框架。

在首页中定义路由入口

自定义一个NavModifier类,继承AttributeUpdater<NavigationAttribute>

然后编写页面代码

HMNavigation 参数解析

l   navigationId : 容器ID并且全局统一

l   homePageUrl :指定默认加载的页面

l   navigationOption :全局参数设置。

Ø   modifier :Navigation动态属性设置

Ø   standardAnimator :页面全局动画配置

Ø   dialogAnimator :弹窗全局动画配置

Ø   title :navigation的Title设置

Ø   menus :navigation的menus设置

Ø   toolbar :navigation的toolbar设置

Ø   systemBarStyle :navigation的systemBarStyle设置

页面设置

新建跳转的页面TwoPage,里面按钮使用HMRouterMgr.pop方法实现返回上个页面的操作。
必须加上@HMRouter装饰器,pageUrl方法来定义页面的名称

总结

这篇帖子主要关注在HMRouter的环境部署和简单的页面跳转。

这里附上HMRouter的 Gitee 地址

( 转载自51CTO,作者:奥尼5354)

 


来自 “ ITPUB博客 ” ,链接:https://blog.itpub.net/70047792/viewspace-3104417/ ,如需转载,请注明出处,否则将追究法律责任。

请登录后发表评论 登录
全部评论

注册时间:2021-11-18

  • 博文量
    401
  • 访问量
    296702