HarmonyOS —— UIAbility 页面跳转总结

2023-12-27 17:44
文章标签 总结 页面 跳转 harmonyos uiability

本文主要是介绍HarmonyOS —— UIAbility 页面跳转总结，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

HarmonyOS —— UIAbility 页面跳转总结

Author：Gorit

Date：2023年12月27日

一、系统环境

  1. HarmonOS API9
  2. SDK 3.1.0
  3. Stage 模型

二、应用内跳转

在应用内之前实现不同 page 的跳转，我们使用 router 即可，页面跳转主要支持如下两个方法:

  • router.pushUrl()：目标页不会替换当前页，而是压入页面栈。这样可以保留当前页的状态，并且可以通过返回键或者调用router.back()方法返回到当前页。
  • router.replaceUrl()：目标页会替换当前页，并销毁当前页。这样可以释放当前页的资源，并且无法返回到当前页。

router 跳转模式

  • Standard：标准实例模式，也是默认情况下的实例模式。每次调用该方法都会新建一个目标页，并压入栈顶。
  • Single：单实例模式。即如果目标页的url在页面栈中已经存在同url页面，则离栈顶最近的同url页面会被移动到栈顶，并重新加载；如果目标页的url在页面栈中不存在同url页面，则按照标准模式跳转。

具体的使用案例 及 应用场景可以查看 官方文档，我这里就不做多余赘述

PS：在卡 ArkTS 卡片中可采用 postCardAction 实现 的跳转

三、UIAbility 之间跳转

原理：基于 startAbility 实现页面跳转，主要应用场景如下

  1. 打开当前 App
  2. 选择多个 App，选择打开某一个 App
  3. 打开指定 App

3.1 了解什么是 UIAbility？

概述：

UIAbility组件是一种包含UI界面的应用组件，主要用于和用户交互。

UIAbility组件是系统调度的基本单元，为应用提供绘制界面的窗口；一个UIAbility组件中可以通过多个页面来实现一个功能模块。每一个UIAbility组件实例，都对应于一个最近任务列表中的任务。

更多的 UIAbility 的信息需要大家自行查阅文档~，比如 生命周期，启动方式等等

3.2 如何启动其它应用 UIAbility？

  1. 获取 UIAbility 上下文信息
    通过文档得知，我们可以在 EntryAbility 中直接获取当前实例的上下文，也可以自己在任意 Page 中去获取 UIAbility 的实例信息
  2. 定义 Want 参数配置，这里东西有很多，我们进需要关注两个配置参数即可 （bundleName 和 abilityName）
  3. 调用 context.startAbility(want).then(...) 实现调用其他 UIAbility

转换成代码如下:

import common from '@ohos.app.ability.common'// 业务代码 ...
{Button().onClick(() => {startSettingsMainAbilityExplicit()})}function startSettingsMainAbilityExplicit() {console.log("begin to navigate");let context = getContext(this) as unknown as common.UIAbilityContext;let want = {deviceId: "",bundleName: 'com.examples', // com.ohos.settingsabilityName: 'EntryAbility', // com.ohos.settings};// previewer 无法调用context.startAbility(want).then((res) => {console.log(res + "");}).catch((e) => {console.log(e.code, e.message);})}
PS：如果你是模拟器用户，需要记得在被跳转的 UIAbility 中 `module.json5` 下 `exported: true` 下面添加一个配置 `visible: true`，不然得话程序会崩溃，暂时还没找到其他替代方案。 真机需要使用后才清楚

完整的文档可以参考：UIAbility组件相互交互

这里有很多跳转方式，我简单总结下

  1. 一个应用内有两个 UIAbility，可以采用此方法启动应用内的 UIAbility
  2. 同上，并获取返回结果
  3. 启动其它应用的 UIAbility，这里又分为 显示 Want 启动 和 隐示 Want 启动，我们前面第二点提到的就是 显示 Want 启动，可以理解为精准匹配某一个 APP
  4. 同上，可以修改 Want 参数 和 module.json5 参数，进行模糊匹配，选择多个 UIAbility 可以打开
  5. Call 实现 UIAbility 交互，但是仅支持 系统应用

3.3 跳转系统应用

  1. 系统应用——拉起系统相册
  2. 拉起系统设置及二级页面

let want  = {"deviceId": "","bundleName": "","abilityName": "","uri": "","flags":wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,"action": "android.settings.SETTINGS","parameters": {},"entities": []
}
this.context.startAbility(want, (err) => {if (err.code) {// 处理业务逻辑错误console.log('startAbility failed, error.code: ' + JSON.stringify(err.code) +' error.message: ' + JSON.stringify(err.message));return;}
// 正常逻辑
})

系统设置 action 配置

系统设置常见子页面（在当前 HarmonOS 3.1 版本，4.0 版本可以使用，NEXT 版本是否支持有待考证）
Action名称 作用

android.settings.SETTINGS    跳转到设置界面
android.settings.ACCESSIBILITY_SETTINGS    跳转系统的辅助功能界面
android.settings.ADD_ACCOUNT_SETTINGS    显示添加帐户创建一个新的帐户屏幕。【测试跳转到微信登录界面】
android.settings.AIRPLANE_MODE_SETTINGS    飞行模式，无线网和网络设置界面
android.settings.WIRELESS_SETTINGS    飞行模式，无线网和网络设置界面
android.settings.APN_SETTINGS    跳转 APN设置界面
android.settings.APPLICATION_DETAILS_SETTINGS    根据包名跳转到系统自带的应用程序信息界面
android.settings.APPLICATION_DEVELOPMENT_SETTINGS    跳转开发人员选项界面
android.settings.APPLICATION_SETTINGS    跳转应用程序列表界面
android.settings.MANAGE_ALL_APPLICATIONS_SETTINGS    跳转到应用程序界面【所有的】
android.settings.MANAGE_APPLICATIONS_SETTINGS    跳转 应用程序列表界面【已安装的】
android.settings.BLUETOOTH_SETTINGS    跳转系统的蓝牙设置界面
android.settings.DATA_ROAMING_SETTINGS    跳转到移动网络设置界面
android.settings.DATE_SETTINGS    跳转日期时间设置界面
android.settings.DEVICE_INFO_SETTINGS    跳转手机状态界面
android.settings.DISPLAY_SETTINGS    跳转手机显示界面
android.settings.INPUT_METHOD_SETTINGS    跳转语言和输入设备
android.settings.INPUT_METHOD_SUBTYPE_SETTINGS    【API 11及以上】 // 跳转 语言选择界面 【多国语言选择】
android.settings.INTERNAL_STORAGE_SETTINGS    跳转存储设置界面【内部存储】
android.settings.MEMORY_CARD_SETTINGS    跳转 存储设置 【记忆卡存储】
android.settings.LOCALE_SETTINGS    跳转语言选择界面【仅有English 和 中文两种选择】
android.settings.LOCATION_SOURCE_SETTINGS    跳转位置服务界面【管理已安装的应用程序。】
android.settings.NETWORK_OPERATOR_SETTINGS    跳转到 显示设置选择网络运营商。
android.settings.NFCSHARING_SETTINGS    显示NFC共享设置。 【API 14及以上】
android.settings.NFC_SETTINGS    显示NFC设置。这显示了用户界面,允许NFC打开或关闭。 【API 16及以上】
android.settings.PRIVACY_SETTINGS    跳转到备份和重置界面
android.settings.QUICK_LAUNCH_SETTINGS    跳转快速启动设置界面
android.search.action.SEARCH_SETTINGS    跳转到 搜索设置界面
android.settings.SECURITY_SETTINGS    跳转到安全设置界面
android.settings.SOUND_SETTINGS    跳转到声音设置界面
android.settings.SYNC_SETTINGS    跳转账户同步界面
android.settings.USER_DICTIONARY_SETTINGS    跳转用户字典界面
android.settings.WIFI_IP_SETTINGS    跳转到IP设定界面
android.settings.WIFI_SETTINGS    跳转Wifi列表设置

四、跨设备跳转【TODO】

经过尝试，两个模拟器之间貌似不支持，会提示如下错误

2-27 10:19:19.724 16971-193/com.examples.demo I 0FEFE/JsApp: startAbility failed, error.code: 16000009 error.message: "Cannot operate in wukong mode."

五、相关文档

  1. Stage模型应用组件 —— 配置
  2. 应用上下文Context
  3. codelabs 下载通知案例 —— want 应用
  4. 其它 HarmonOS 跳转案例

这篇关于HarmonyOS —— UIAbility 页面跳转总结的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/543895。

相关文章

Python中实现进度条的多种方法总结

Python中实现进度条的多种方法总结

《Python中实现进度条的多种方法总结》在Python编程中,进度条是一个非常有用的功能,它能让用户直观地了解任务的进度,提升用户体验,本文将介绍几种在Python中实现进度条的常用方法,并通过代码... 目录一、简单的打印方式二、使用tqdm库三、使用alive-progress库四、使用progres
阅读更多...
使用JavaScript将PDF页面中的标注扁平化的操作指南

使用JavaScript将PDF页面中的标注扁平化的操作指南

《使用JavaScript将PDF页面中的标注扁平化的操作指南》扁平化(flatten)操作可以将标注作为矢量图形包含在PDF页面的内容中,使其不可编辑,DynamsoftDocumentViewer... 目录使用Dynamsoft Document Viewer打开一个PDF文件并启用标注添加功能扁平化
阅读更多...
Android数据库Room的实际使用过程总结

Android数据库Room的实际使用过程总结

《Android数据库Room的实际使用过程总结》这篇文章主要给大家介绍了关于Android数据库Room的实际使用过程,详细介绍了如何创建实体类、数据访问对象（DAO）和数据库抽象类,需要的朋友可以... 目录前言一、Room的基本使用1.项目配置2.创建实体类（Entity）3.创建数据访问对象（DAO
阅读更多...
SpringBoot如何访问jsp页面

SpringBoot如何访问jsp页面

《SpringBoot如何访问jsp页面》本文介绍了如何在SpringBoot项目中进行Web开发,包括创建项目、配置文件、添加依赖、控制层修改、测试效果以及在IDEA中进行配置的详细步骤... 目录SpringBoot如何访问JSP页python面简介实现步骤1. 首先创建的项目一定要是web项目2. 在
阅读更多...
Java向kettle8.0传递参数的方式总结

Java向kettle8.0传递参数的方式总结

《Java向kettle8.0传递参数的方式总结》介绍了如何在Kettle中传递参数到转换和作业中,包括设置全局properties、使用TransMeta和JobMeta的parameterValu... 目录1.传递参数到转换中2.传递参数到作业中总结1.传递参数到转换中1.1. 通过设置Trans的
阅读更多...
C# Task Cancellation使用总结

C# Task Cancellation使用总结

《C#TaskCancellation使用总结》本文主要介绍了在使用CancellationTokenSource取消任务时的行为,以及如何使用Task的ContinueWith方法来处理任务的延... 目录C# Task Cancellation总结1、调用cancellationTokenSource.
阅读更多...
HarmonyOS学习(七)——UI（五）常用布局总结

HarmonyOS学习(七)——UI（五）常用布局总结

自适应布局 1.1、线性布局（LinearLayout） 通过线性容器Row和Column实现线性布局。Column容器内的子组件按照垂直方向排列，Row组件中的子组件按照水平方向排列。 属性说明space通过space参数设置主轴上子组件的间距，达到各子组件在排列上的等间距效果alignItems设置子组件在交叉轴上的对齐方式，且在各类尺寸屏幕上表现一致，其中交叉轴为垂直时，取值为Vert
阅读更多...
学习hash总结

学习hash总结

2014/1/29/   最近刚开始学hash，名字很陌生，但是hash的思想却很熟悉，以前早就做过此类的题，但是不知道这就是hash思想而已，说白了hash就是一个映射，往往灵活利用数组的下标来实现算法，hash的作用：1、判重；2、统计次数；
阅读更多...
如何在页面调用utility bar并传递参数至lwc组件

如何在页面调用utility bar并传递参数至lwc组件

1.在app的utility item中添加lwc组件： 2.调用utility bar api的方式有两种： 方法一，通过lwc调用： import {LightningElement,api ,wire } from 'lwc';import { publish, MessageContext } from 'lightning/messageService';import Ca
阅读更多...
git使用的说明总结

git使用的说明总结

Git使用说明 下载安装(下载地址) macOS: Git - Downloading macOS Windows: Git - Downloading Windows Linux/Unix: Git (git-scm.com) 创建新仓库 本地创建新仓库：创建新文件夹，进入文件夹目录，执行指令 git init ，用以创建新的git 克隆仓库 执行指令用以创建一个本地仓库的
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2