跳转示例:HAP模块Index页面(Router跳转)->HSP模块HspIndexPage页面(Navigation跳转)->HSP模块HspPage页面(Navigation跳转)->HAR模块HarPage页面(Router跳转)->HAP模块Index页面。
this.getUIContext().getRouter().pushUrl({
url: '@bundle:com.example.navigationsystemtable/hsp/ets/pages/Index' // url格式为'@bundle:包名(bundleName)/模块名(moduleName)/路径/页面所在的文件名(不加.ets后缀)'
}); "dependencies": {
"har": "file:../har",
"hsp": "file:../hsp"
} export { Index } from './src/main/ets/pages/Index';
export { HspPageBuilder, HspPage } from './src/main/ets/pages/HspPage'; HAR模块内Index.ets文件:
export { HarPage } from './src/main/ets/components/HarPage'; this.pageInfos.pushPathByName('HspPage', null, false); 除系统路由表外,可通过Navigation动态路由实现,开发者可参考Navigation动态路由。
// (无需@bundle前缀)
this.getUIContext().getRouter().pushUrl({ url: 'pages/Index' }); 完整代码如下所示:
HAP模块:oh-package.json5文件配置如上,Index页面代码如下所示。
// import引入HSP模块内跳转目标页面
import 'hsp/src/main/ets/pages/Index';
@Entry
@Component
struct Index {
pageInfos: NavPathStack = new NavPathStack();
build() {
Navigation(this.pageInfos) {
Column({ space: 16 }) {
Button('跳转到hspIndexPage页面(方法一)')
.onClick(() => {
this.getUIContext().getRouter().pushNamedRoute({ name: 'HspIndexPage' });
});
Button('跳转到hspIndexPage页面(方法二)')
.onClick(() => {
this.getUIContext().getRouter().pushUrl({
url: '@bundle:com.example.navigationsystemtable/hsp/ets/pages/Index' // url格式为'@bundle:包名(bundleName)/模块名(moduleName)/路径/页面所在的文件名(不加.ets后缀)'
});
});
Button('跳转到HspPage页面')
.onClick(() => {
this.pageInfos.pushPathByName('HspPage', null, false);
});
}
.width('100%')
.height('100%');
}
.width('100%')
.height('100%')
.hideBackButton(true)
.title('hap页面')
.titleMode(NavigationTitleMode.Mini);
}
} HSP模块:Index.ets文件如上配置。HspIndexPage页面代码如下:
// 命名路由页面的名字
@Entry({ routeName: 'HspIndexPage' })
@Component
export struct Index {
pageInfos: NavPathStack = new NavPathStack();
build() {
Navigation(this.pageInfos) {
Column({ space: 16 }) {
Button('跳转到HspPage页面')
.onClick(() => {
this.pageInfos.pushPathByName('HspPage', null, false);
});
}
.width('100%')
.height('100%');
}
.width('100%')
.height('100%')
.hideBackButton(true)
.title('hspIndexPage页面')
.titleMode(NavigationTitleMode.Mini);
}
} HspPage页面代码如下:
@Builder
export function HspPageBuilder() {
HspPage();
}
@Component
export struct HspPage {
pageInfos: NavPathStack = new NavPathStack();
build() {
NavDestination() {
Column({ space: 16 }) {
Button('跳转har页面')
.onClick(() => {
this.pageInfos.pushPathByName('HarPage', null, false);
});
}
.width('100%')
.height('100%');
}
.width('100%')
.height('100%')
.title('hsp页面')
.hideBackButton(true)
.onReady((context: NavDestinationContext) => {
this.pageInfos = context.pathStack;
});
}
}
系统路由表配置如下:
{
"routerMap": [
{
"name": "HspPage",
"pageSourceFile": "src/main/ets/pages/HspPage.ets",
"buildFunction": "HspPageBuilder",
"data": {
"description": "this is harPage,"
}
}
]
} HAR模块:Index.ets文件如上配置。HarPage页面代码如下所示。
@Builder
export function harPageBuilder() {
HarPage();
}
@Component
export struct HarPage {
pageInfos: NavPathStack = new NavPathStack();
build() {
NavDestination() {
Column({ space: 16 }) {
Button('跳转到hap页面')
.onClick(() => {
// (无需@bundle前缀)
this.getUIContext().getRouter().pushUrl({ url: 'pages/Index' });
});
}
.width('100%')
.height('100%');
}
.width('100%')
.height('100%')
.title('har页面')
.hideBackButton(true)
.onReady((context: NavDestinationContext) => {
this.pageInfos = context.pathStack;
});
}
}
系统路由表配置如下:
{
"routerMap": [
{
"name": "HarPage",
"pageSourceFile": "src/main/ets/components/HarPage.ets",
"buildFunction": "harPageBuilder",
"data": {
"description": "this is harPage,"
}
}
]
} Q:HAR模块中能否支持Page页面?
A:HAR模块支持Page页面,但不支持在配置文件module.json5中声明pages页面,通过命名路由的方式跳转,详见HAR和HSP支持page和HAP/HAR/HSP使用场景。
HAP和HAR/HSP页面跳转相关问题如下表所示:
实现方案 | 特点 | 适用场景 | |
|---|---|---|---|
Router | 方式一:通过命名路由的方式实现跨包跳转。 | 基于页面装饰器@Entry({routeName:'PageName'})声明路由名称。 | 模块内简单页面跳转、小型应用或原型开发。 |
方式二:使用@bundle协议指定目标模块的包名、模块名和页面路径。 | 通过@bundle:包名/模块路径格式指定目标资源。 | 动态化场景(按需加载远程模块)、跨包跳转(如主应用跳子模块)。 | |
Navigation | 方式一:系统路由表 | 将路由表方案下沉到系统中管理。 | 复杂应用统一路由管理、多团队协作开发(各模块独立配置路由表)。 |
方式二:动态路由 | 使用动态Import,按需加载页面 | 彻底解耦的模块化架构、跨HSP/HAR的无依赖跳转。 |