开源实验室
·
【HarmonyOS】TheRouter 鸿蒙版新手入门
💡
原文中文，约5300字，阅读约需13分钟。
📝
内容提要
TheRouter 鸿蒙版是货拉拉定制的开源路由框架，支持 Android、iOS 和 Harmony 三端一致性使用，具备动态路由和编译时安全检查等功能。接入步骤包括引入依赖、初始化、定义页面容器和声明路由。使用时需确保插件与依赖版本一致，并可通过源码调试解决问题。
🎯
关键要点
- TheRouter 鸿蒙版是货拉拉基于HMRouter深度定制的开源路由框架，支持 Android、iOS 和 Harmony 三端一致性使用。
- 具备动态路由下发、编译时安全检查、路由Path一对多等高度动态能力。
- 接入步骤包括引入依赖、初始化、定义页面容器和声明路由。
- 使用时需确保插件与依赖版本一致，且可通过源码调试解决问题。
- 在项目入口的 UIAbility 的 onCreate() 中初始化 TheRouter。
- 定义页面容器时需创建 TheRouterPage，并在配置文件中进行相应配置。
- 声明路由时需为需要跳转的页面添加路由表声明。
- 发起跳转时可通过 TheRouter.build() 方法传递参数。
- 问题排查时需检查插件和依赖库版本一致性，必要时进行源码调试。
❓
延伸问答
TheRouter 鸿蒙版的主要功能是什么？
TheRouter 鸿蒙版支持动态路由下发、编译时安全检查和路由Path一对多等功能，适用于 Android、iOS 和 Harmony 三端一致性使用。
如何在项目中接入 TheRouter 鸿蒙版？
接入步骤包括引入依赖、初始化、定义页面容器和声明路由，确保插件与依赖版本一致。
在使用 TheRouter 时如何进行问题排查？
问题排查可通过检查插件和依赖库版本一致性、观察接入环境和源码调试来进行。
如何在 TheRouter 中发起页面跳转？
可以通过 TheRouter.build() 方法传递参数并调用 .navigation() 来发起页面跳转。
TheRouter 鸿蒙版的初始化代码应该放在哪里？
初始化代码应放在项目入口的 UIAbility 的 onCreate() 方法中。
如何定义 TheRouter 的页面容器？
需要创建 TheRouterPage，并在配置文件中进行相应配置，确保每个stack的名字唯一。
➡️
