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

【HarmonyOS】关于官方推荐的组件级路由Navigation的心得体会

news 2026/5/23 16:20:49

前言

最近因为之前的630版本有点忙，导致断更了几天，现在再补上。换换脑子。
目前内测系统的华为应用市场，各种顶级APP陆续都放出来beta版本了，大体上都完成了主流程的开发。欣欣向荣的气息。

学习思路

关于学习HarmonyOS的问题，很多同学私聊我说，因为没有白名单访问不了最新的API，目前API已经到12。这其实影响不大，HarmonyOS和OpenHarmony的接口我比对了下，现在基本功能和作用没有区别，可能某些系统api导包名字有区别，但这不影响，可以无缝切换。

可以通过这个链接，访问OpenHarmony开源的API接口文档等信息。

点击左上角的分支，来控制你看的API文档版本。目前最新的是5.0 Beta1 这和HarmonyOS是一致的。目前看华为的策略就是开源鸿蒙和商业鸿蒙版本一致管理。
在这里插入图片描述

标关于官方推荐的组件级路由Navigation的使用心得体会

最近经历了一次应用架构更新，对于路由的概念有了深刻的认识。从两年前开发OpenHarmony开始，基本都是使用router路由和window窗口来控制模块之间的切换。整个页面逻辑的控制非常耦合，并且笨重不变。

随着API的迭代更新，目前华为官方推荐使用Navigaiton来替换router。

Navigaiton这个东西，方便就方便于它的定位，组件级别。而我们的老东西router是页面级别。

灵活性一目了然，我们可以将页面一部分组件，进行路由控制切换。
并且我们可以对路由的删除进行管理，而router是没有remove只能替换，并且替换路由函数，是强制没有页面转场动画的效果。
最大的优势在于系统提供了自动扩容的容器控件，并且支持分栏效果，在折叠屏手机上的适配会非常方便。

Navigation如何使用？

首先Navigation是个容器，并不是直接对标router一样来使用的。我们可以理解成，这家伙是个变形金刚，它是由三部分组成，首先是主页面容器Navigation，其次是子页面容器NavDestination，之后才是对标router的操作对象NavPathStack

（1）创建主页界面

@Entry
@Component
struct MainPage {@State message: string = 'Hello World';// 创建一个页面栈对象并传入NavigationpageStack: NavPathStack = new NavPathStack()build() {Navigation(this.pageStack) {// 页面布局Row() {Column() {Text(this.message).fontSize(50).fontWeight(FontWeight.Bold).onClick(()=>{// 跳转到子页面this.pageStack.pushDestination({name: "OnePage",}, false); //该false表示不需要转场动画，默认是有的})}.width('100%')}.height('100%')}// 分为三种模式，（默认）自动NavigationMode.Auto，单页面NavigationMode.Stack和分栏NavigationMode.Split.mode(NavigationMode.Stack)}
}

（2）创建子页界面


// 跳转页面入口函数
@Builder
export function OnePageBuilder() {OnePage()
}@Entry
@Component
struct OnePage {private TAG: string = "OnePage";@State message: string = 'Hello World';pathStack: NavPathStack = new NavPathStack();build() {NavDestination() {Row() {Column() {Text(this.message).fontSize(50).fontWeight(FontWeight.Bold)}.width('100%')}.height('100%')}.onShown(()=>{console.log(this.TAG, "OnePage onShown");}).onReady((context: NavDestinationContext) => {this.pathStack = context.pathStack;})}
}

（3）配置路由表
在这里插入图片描述

{"routerMap": [{"name": "OnePage","pageSourceFile": "src/main/ets/pages/Navigation/OnePage.ets","buildFunction": "OnePageBuilder","data": {"description" : "this is PageOne"}}]
}

特别注意的是，需要配置路由表的路径到module.json5里面，要不然跳转不了。
特别注意的是，需要配置路由表的路径到module.json5里面，要不然跳转不了。
特别注意的是，需要配置路由表的路径到module.json5里面，要不然跳转不了。主要的话说三遍！

  {"module" : {"routerMap": "$profile:route_map"}}

从API version 12开始，Navigation支持使用系统路由表的方式进行动态路由。各业务模块（HSP/HAR）中需要独立配置router_map.json文件，在触发路由跳转时，应用只需要通过NavPactStack提供的路由方法，传入需要路由的页面配置名称，此时系统会自动完成路由模块的动态加载、页面组件构建，并完成路由跳转，从而实现了开发层面的模块解耦。