OpenHarmony开发实战：UIAbility内和UIAbility间页面的跳转（ArkTS

UIAbility内页面的跳转

entry模块中，EntryAbility内页面的跳转可以通过页面路由router来实现。页面路由router根据页面url找到目标页面，从而实现跳转。效果图如下：

1. 实现UIAbility内页面的跳转，我们首先需要构建两个页面。在“Project”窗口，点击“entry > src > main > ets > pages”，打开“Index.ets”文件，可以看到EntryAbility的Index页面由一个Image组件、两个Text组件、三个Button组件组成。“Index.ets”文件的示例代码如下：

@Entry
@Component
struct Index {
@State text: string = ‘’;
@State bottomMargin: string = StyleConstants.MAIN_INDEX_BUTTON_MARGIN_BOTTOM;

build() {
Column() {
Image($r(‘app.media.right’))
…

Text($r(‘app.string.main_index_page_name’))
…

// 条件渲染：当text的值不为空时，显示该组件
if (this.text !== ‘’) {
Text(this.text)
…
}

// 导航到EntryAbility的Second Page
Button($r(‘app.string.to_main_second_page_btn_text’), { type: ButtonType.Capsule, stateEffect: true })
…

// 导航到SecondAbility的Index Page
Button($r(‘app.string.to_second_index_page_btn_text’), { type: ButtonType.Capsule, stateEffect: true })
…

// 导航到SecondAbility的Second Page
Button($r(‘app.string.to_second_second_page_btn_text’), { type: ButtonType.Capsule, stateEffect: true })
…
}
…
}
}

2. 在“Project”窗口，打开“entry > src > main > ets”，右键点击“pages”文件夹，选择“New > Page”，命名为“Second”。可以看到EntryAbility的Second页面由一个Image组件、两个Text组件、一个Button组件组成。“Second.ets”文件的示例代码如下：

@Entry
@Component
struct Second {
…

build() {
Column() {
Image($r(‘app.media.left’))
…

Text($r(‘app.string.main_second_page_name’))
…

Text(${this.src}：${this.count})
…

// 返回到EntryAbility的Index Page
Button($r(‘app.string.back_main_index_page_btn_text’), { type: ButtonType.Capsule, stateEffect: true })
…
}
…
}
}

3. 从entry模块的Index页面跳转到Second页面，并进行数据传递，通过页面路由router来实现。需要如下几个步骤：

• 给两个页面导入router模块。
• 在EntryAbility的Index页面中，点击“导航到EntryAbility的Second Page”按钮后，调用ButtonClickMethod类中的toEntryAbilitySecond方法，跳转到EntryAbility的Second页面。使用router.pushUrl实现跳转，可以通过params来向新页面传入参数，示例代码如下：

// 导入router模块
import router from ‘@ohos.router’;

// 导航到EntryAbility的Second Page
toEntryAbilitySecond() {
router.pushUrl({
url: ‘pages/Second’,
params: {
src: textMessage,
count: CommonConstants.NUM_VALUES[0]
}
});
}

• Second页面通过router.getParams()方法获取Index页面传递过来的自定义参数，并用一个Text文本展示从Index页面传递过来的数据，示例代码如下：

@Entry
@Component
struct Second {
…
// 获取Index页面传递过来的自定义参数
params = router?.getParams();
@State src: string = this.params == undefined ? ‘-’ : (this.params as Record<string,Object>)[‘src’] as string;
@State count: number = this.params == undefined ? 0 : (this.params as Record<string,Object>)[‘count’] as number;

build() {
Column() {
Image($r(‘app.media.left’))
…

Text($r(‘app.string.main_second_page_name’))
…

// 用一个Text文本展示从Index页面传递过来的数据
Text(${this.src}：${this.count})
…

// 返回到EntryAbility的Index Page
Button($r(‘app.string.back_main_index_page_btn_text’), { type: ButtonType.Capsule, stateEffect: true })
…
}
…
}
}

4. 从entry模块的Second返回到Index页面，使用router.back来实现。在EntryAbility的Second页面中，点击“返回到EntryAbility的Index Page”按钮后，返回到EntryAbility的Index页面，示例代码如下：

// 返回到EntryAbility的Index Page
router.back();

跳转到指定UIAbility的首页

实现UIAbility间页面的跳转，需要启动另外一个UIAbility，可以通过UIAbilityContext的startAbility的方法来完成。本篇Codelab是用两个模块（entry和device），实现UIAbility间页面的跳转。跳转到指定UIAbility的首页，效果图如下：

1. 在本章节中，实现跳转到指定UIAbility的首页，我们需要新建一个模块。在“Project”窗口，右键点击“entry 文件夹”，选择“New > Module > Empty Ability > Next”，在“Module name”中给新建的模块命名为“device”，点击“Next”，在“Ability name”中给新建模块的Ability命名为“SecondAbility”，点击“Finish”。可以看到文件目录结构如下：

2. 构建SecondAbility的首页。在“Project”窗口，点击“device > src > main > ets > pages”，打开“Index.ets”文件，可以看到SecondAbility的Index页面由一个Image组件、两个Text组件、一个Button组件组成。“Index.ets”文件的示例代码如下：

@Entry
@Component
struct Index {
…

build() {
Column() {
Image($r(‘app.media.left’))
…

Text($r(‘app.string.second_index_page_name’))
…

Text(${this.src}：${this.count})
…

// 停止SecondAbility自身
Button($r(‘app.string.terminate_second_btn_text’), { type: ButtonType.Capsule, stateEffect: true })
…
}
…
}
}

3. 从entry模块的EntryAbility的首页，跳转到SecondAbility的首页，即从EntryAbility的Index页面跳转到SecondAbility的Index页面。通过UIAbilityContext的startAbility方法来实现。

• 首先需要在EntryAbility的“Index.ets”文件中获取UIAbilityContext，示例代码如下：

// 获取UIAbilityContext
let context = getContext(this) as common.UIAbilityContext;

说明： 如果需要使用UIAbilityContext中的方法，需要在对应的页面获取相应的UIAbilityContext。

• 在EntryAbility的Index页面中，点击“导航到SecondAbility的Index Page”按钮后，调用ButtonClickMethod类中的toSecondAbilityIndex方法，拉起SecondAbility的Index页面。使用UIAbilityContext.startAbility来实现，可以通过parameters来向被拉起方传递参数，示例代码如下：

// 导航到SecondAbility的Index Page
toSecondAbilityIndex(context: common.UIAbilityContext) {
let want: Want = {
‘deviceId’: ‘’,
‘bundleName’: CommonConstants.BUNDLE_NAME,
‘abilityName’: CommonConstants.SECOND_ABILITY_NAME,
‘moduleName’: CommonConstants.DEVICE_MODULE_NAME,
‘parameters’: {
src: textMessage,
count: CommonConstants.NUM_VALUES[1]
}
};
context.startAbility(want).then(() => {
Logger.info(CommonConstants.TAG, start second ability index page succeed with ${JSON.stringify(want)});
}).catch((error: Error) => {
Logger.error(CommonConstants.TAG, start second ability index page failedwith ${error});
});
}

• 在SecondAbility的Index页面，获取从EntryAbility的Index页面传递过来的自定义参数，并用一个Text文本展示从Index页面传递过来的数据，示例代码如下：

@Entry
@Component
struct Index {
// 获取从EntryAbility的Index页面传递过来的自定义参数
secondAbilityWant?: Want = GlobalContext.getContext().getObject(‘secondAbilityWant’);
@State src: string = this.secondAbilityWant?.parameters?.src as string ?? ‘-’;
@State count: number = this.secondAbilityWant?.parameters?.count as number ?? 0;

build() {
Column() {
Image($r(‘app.media.left’))
…

Text($r(‘app.string.second_index_page_name’))
…

// 用一个Text文本展示从Index页面传递过来的数据
Text(${this.src}：${this.count})
…

// 停止SecondAbility自身
Button($r(‘app.string.terminate_second_btn_text’), { type: ButtonType.Capsule, stateEffect: true })
…
}
…
}
}

4. 在SecondAbility的Index页面，点击“停止SecondAbility自身”按钮，使用UIAbilityContext.terminateSelf方法手动销毁Ability。示例代码如下：

// 停止SecondAbility自身
terminateSecondAbility(context: common.UIAbilityContext) {
context.terminateSelf().then(() => {
Logger.info(CommonConstants.TAG, ‘terminate second ability self succeed’);
}).catch((error: Error) => {
Logger.error(CommonConstants.TAG, terminate second ability self failed with ${error});
});
}

5. 运行时，需要在DevEco Studio的entry模块中勾选“Deploy Multi Hap Packages”，如下图所示：

跳转到指定UIAbility的指定页面（非首页）

跳转到指定UIAbility的指定页面（非首页），本章节以从EntryAbility的Index页面跳转到SecondAbility的Second页面为例。只需要在本文档“跳转到指定UIAbility的首页”章节的基础上，另外在device模块中构建一个Second页面。效果图如下：

1. 构建SecondAbility的Second页面。在“Project”窗口，打开“device > src > main > ets”，右键点击“pages”文件夹，选择“New > Page”，命名为“Second”。可以看到文件目录结构如下：

2. 可以看到SecondAbility的Second页面由一个Image组件、两个Text组件、一个Button组件组成。“Second.ets”文件的示例代码如下：

@Entry
@Component
struct Second {
// 用来接收parameters参数传过来的值
secondAbilityWant?: Want = GlobalContext.getContext().getObject(‘secondAbilityWant’);
@State src: string = this.secondAbilityWant?.parameters?.src as string ?? ‘-’;
@State count: number = this.secondAbilityWant?.parameters?.count as number ?? 0;

build() {
Column() {
Image($r(‘app.media.left’))
…

Text($r(‘app.string.second_second_page_name’))
…

Text(${this.src}：${this.count})
…

// 停止SecondAbility自身并返回结果
Button($r(‘app.string.terminate_second_for_result_btn_text’), { type: ButtonType.Capsule, stateEffect: true })
…
}
…
}
}

3. 在EntryAbility的Index页面中，点击“导航到SecondAbility的Second Page”按钮后，调用ButtonClickMethod类中的toSecondAbilitySecond方法，拉起SecondAbility的Second页面。

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

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

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

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

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

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

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

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

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

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

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