前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >HarmonyOS —— UIAbility 页面跳转总结

HarmonyOS —— UIAbility 页面跳转总结

作者头像
Gorit
发布2023-12-28 08:51:12
8080
发布2023-12-28 08:51:12
举报
文章被收录于专栏:Gorit 带你学全栈系列

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

转换成代码如下:

代码语言:javascript
复制
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.settings
    abilityName: '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. 拉起系统设置及二级页面
代码语言:javascript
复制
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名称 作用

代码语言:javascript
复制
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 跳转案例
本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
原始发表:2023-12-27,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • HarmonyOS —— UIAbility 页面跳转总结
    • 一、系统环境
      • 二、应用内跳转
        • 三、UIAbility 之间跳转
          • 3.1 了解什么是 UIAbility?
          • 3.2 如何启动其它应用 UIAbility?
          • 3.3 跳转系统应用
        • 四、跨设备跳转【TODO】
          • 五、相关文档
          领券
          问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档