HarmonyOS Next 自定义路由栈管理_navpathstack，2024年最新HarmonyOS鸿蒙应用开发实训报告

介绍

本示例将介绍如何使用动态路由跳转到模块中的页面，以及如何使用动态import的方式加载模块

使用说明

1. 通过动态import的方式，在需要进入页面时加载对应的模块。
2. 配置动态路由，通过WrapBuilder接口，动态创建页面并跳转。
3. 动态import变量表达式，需要DevEco Studio NEXT Developer Preview1 （4.1.3.500）版本IDE，配合hvigor 4.0.2版本使用。
4. 支持自定义路由栈管理，相关内容请参考路由来源页的相关说明

实现思路

动态路由的实现

1. 注册路由

public static createNavPathStack(router: NavPathStack): void {
DynamicsRouter.navPathStack = router;
}

2. 获取路由

private static getNavPathStack(): NavPathStack {
return DynamicsRouter.navPathStack;
}

3. 通过builderName，注册WrappedBuilder对象，用于动态创建页面

private static registerBuilder(builderName: string, builder: WrappedBuilder<[object]>): void {
DynamicsRouter.builderMap.set(builderName, builder);
}

4. 通过builderName，获取注册的WrappedBuilder对象

public static getBuilder(builderName: string): WrappedBuilder<[object]> {
let builder = DynamicsRouter.builderMap.get(builderName);
if (!builder) {
let msg = “not found builder”;
console.info(msg + builderName);
}
return builder as WrappedBuilder<[object]>;
}

5. 通过页面栈跳转到指定页面

public static async push(routerInfo: RouterInfo, param?: string): Promise {
const pageName: string = routerInfo.pageName;
const moduleName: string = routerInfo.moduleName;
let isImportSucceed: boolean = false;
await import(moduleName).then((result: ESObject) => {
result.harInit(pageName);
isImportSucceed = true;
}, (error: ESObject) => {
logger.error(LOGGER_TAG, error);
});
if (isImportSucceed) {
const builderName: string = moduleName + “/” + pageName;
DynamicsRouter.getNavPathStack().pushPath({ name: builderName, param: param });
}
}

6. 注册动态路由跳转的页面信息

public static registerRouterPage(routerInfo: RouterInfo, wrapBuilder: WrappedBuilder<[object]>) {
let builderName: string = routerInfo.moduleName + “/” + routerInfo.pageName;
if (!DynamicsRouter.getBuilder(builderName)) {
DynamicsRouter.registerBuilder(builderName, wrapBuilder);
}
}

动态路由的使用

下面以eventpropagation模块举例说明如何使用动态路由加载子模块页面。

1. 在工程的根目录的build-profile.json5中添加动态路由模块和需要加载的子模块的依赖，详细代码参考build-profile.json5。

{
“app”:{
…
}
“modules”:{
…
{
“name”: “eventpropagation”,
“srcPath”: “./feature/eventpropagation”
},
{
“name”: “routermodule”,
“srcPath”: “./feature/routermodule”
}
…
}
}

2. 在主模块中添加动态路由和需要加载的子模块的依赖，详细代码请参考oh-package.json。

“dependencies”: {
“@ohos/dynamicsrouter”: “file:…/…/feature/routermodule”,
“@ohos/event-propagation”: “file:…/…/feature/eventpropagation”,
…
}

3. 在主模块中添加动态import变量表达式需要的参数，此处在packages中配置的模块名必须和oh-package.json中配置的名称相同，详细代码请参考build-profile.json5。

…
“buildOption”: {
“arkOptions”: {
“runtimeOnly”: {
“packages”: [
“@ohos/event-propagation”,
…
]
}
}
}

4. 在routermodule模块中添加动态路由跳转的moduleName（模块名）和pageName（页面名），RouterInfo中配置的moduleName必须和oh-package.json中配置的名称相同，RouterInfo中添加的pageName是子模块中需要加载的页面，详细代码请参考RouterInfo.ets。

export class RouterInfo {
moduleName: string = ‘’;
pageName: string = ‘’;

constructor(moduleName: string, pageName: string) {
this.moduleName = moduleName;
this.pageName = pageName;
}
…
static readonly EVENT_TRANSMISSION_SOLUTION: RouterInfo = new RouterInfo(‘@ohos/event-propagation’, ‘EventPropagation’);
…
}

5. 在主模块中注册路由，并添加页面信息，详细代码请参考EntryView.ets。

…
@Provide(‘pageStack’) pageStack: NavPathStack = new NavPathStack();
@State listData: SceneModuleInfo[] = waterFlowData;
…
aboutToAppear(): void {
DynamicsRouter.createNavPathStack(this.pageStack);
…
}
…

6. 在主模块的WaterFlowData.ets中，将子模块要加载的页面，添加到列表中，详细代码请参考WaterFlowData.ets。

export const waterFlowData: SceneModuleInfo[] = [
…
new SceneModuleInfo($r(“app.media.event_propagation”), ‘阻塞事件冒泡’, RouterInfo.EVENT_TRANSMISSION_SOLUTION, ‘其他’, 1),
…
}

7. 在需要加载时将页面放入路由栈，详细代码请参考FunctionalScenes.ets。

@Builder
methodPoints(listData: ListData) {
Column() {
…
.onClick(() => {
DynamicsRouter.push(listData.routerInfo, listData.param);
})
}

8. 在子模块中添加动态路由的依赖，详细代码可参考oh-package.json。

…
“dependencies”: {
…
“@ohos/dynamicsrouter”: “file:…/…/feature/routermodule”

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数HarmonyOS鸿蒙开发工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则几千的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年HarmonyOS鸿蒙开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上HarmonyOS鸿蒙开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录大纲截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新

如果你觉得这些内容对你有帮助，可以添加VX：vip204888 （备注鸿蒙获取）

一个人可以走的很快，但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎扫码加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新**

如果你觉得这些内容对你有帮助，可以添加VX：vip204888 （备注鸿蒙获取）
[外链图片转存中…(img-U4rx2Pi6-1712660777323)]

一个人可以走的很快，但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎扫码加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！