【鸿蒙开发】第十四章 Stage模型应用组件-任务Mission

2024-02-25 02:36

本文主要是介绍【鸿蒙开发】第十四章 Stage模型应用组件-任务Mission,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

1 任务(Mission)管理场景

任务(Mission)管理相关的基本概念如下:

  • AbilityRecord:系统服务侧管理一个UIAbility实例的最小单元,对应一个应用侧的UIAbility组件实例。系统服务侧管理UIAbility实例数量上限为512个。

  • MissionRecord:任务管理的最小单元。一个MissionRecord中仅有一个AbilityRecord,即一个UIAbility组件实例对应一个单独的任务。

  • MissionList:一个从桌面开始启动的任务列表,记录了任务之间的启动关系,下一个任务由上一个任务启动,最底部的任务由桌面启动,这里称之为任务链。

  • MissionListManager:系统任务管理模块,内部维护了当前所有的任务链,与最近任务列表保持一致。
    在这里插入图片描述
    任务的管理由系统应用(如桌面应用)负责,三方应用无法管理任务。用户通过最近任务列表进行任务的相关交互。当创建任务后,用户可以对最近任务列表进行如下操作:

  • 删除一个指定的任务。

  • 加锁或解锁一个指定的任务(加锁后的任务在清理所有任务时不会被清理)。

  • 清理最近任务列表中的所有任务。

  • 将一个指定的任务切换到前台。

一个UIAbility实例对应一个单独的任务,因此应用调用startAbility()方法启动一个UIAbility时,就是创建了一个任务。

  1. 桌面应用调用missionManager的接口管理任务,需要申请ohos.permission.MANAGE_MISSIONS权限,配置方式请参见配置文件权限声明。
  2. 利用missionManager进行任务管理(监听任务变化、获取任务信息、获取任务快照、清理任务、任务加锁/解锁等)。
import missionManager from '@ohos.app.ability.missionManager'
import { BusinessError } from '@ohos.base';let listener: missionManager.MissionListener = {// 任务创建onMissionCreated: (mission) => {console.info("--------onMissionCreated-------")},// 任务销毁onMissionDestroyed: (mission) => {console.info("--------onMissionDestroyed-------")},// 任务快照变化onMissionSnapshotChanged: (mission) => {console.info("--------onMissionSnapshotChanged-------")},// 任务被移动到前台onMissionMovedToFront: (mission) => {console.info("--------onMissionMovedToFront-------")},// 任务图标变化onMissionIconUpdated: (mission, icon) => {console.info("--------onMissionIconUpdated-------")},// 任务名称变化onMissionLabelUpdated: (mission) => {console.info("--------onMissionLabelUpdated-------")},// 任务实例被关闭onMissionClosed: (mission) => {console.info("--------onMissionClosed-------")}
};// 1.注册任务变化通知
let listenerId = missionManager.on('mission', listener);// 2.获取系统最近20个任务
missionManager.getMissionInfos("", 20, (error, missions) => {console.info("getMissionInfos is called, error.code = " + error.code);console.info("size = " + missions.length);console.info("missions = " + JSON.stringify(missions));
});// 3.获取单个任务的详细信息()
let missionId = 11; // 11只是示例,实际是从系统中获取的任务id,下面类似
let mission = missionManager.getMissionInfo("", missionId).catch((err: BusinessError) => {console.info('${err.code}');
});// 4.获取任务快照
missionManager.getMissionSnapShot("", missionId, (error, snapshot) => {console.info("getMissionSnapShot is called, error.code = " + error.code);console.info("bundleName = " + snapshot.ability.bundleName);
})// 5.获取低分辨任务快照
missionManager.getLowResolutionMissionSnapShot("", missionId, (error, snapshot) => {console.info("getLowResolutionMissionSnapShot is called, error.code = " + error.code);console.info("bundleName = " + snapshot.ability.bundleName);
})// 6.加锁/解锁任务
missionManager.lockMission(missionId).then(() => {console.info("lockMission is called ");
});missionManager.unlockMission(missionId).then(() => {console.info("unlockMission is called ");
});// 7.把任务切到前台
missionManager.moveMissionToFront(missionId).then(() => {console.info("moveMissionToFront is called ");
});// 8.删除单个任务
missionManager.clearMission(missionId).then(() => {console.info("clearMission is called ");
});// 9.删除全部任务
missionManager.clearAllMissions().catch((err: BusinessError) => {console.info('${err.code}');
});// 10.解注册任务变化通知
missionManager.off('mission', listenerId, (error) => {console.info("unregisterMissionListener");
})

2 任务(Mission)与启动模式

如前文所述,一个UIAbility实例对应一个任务。UIAbility实例个数与UIAbility配置的启动模式有关。在FA模型下,通过config.json配置文件中的“launchType”属性配置;在Stage模型下,通过module.json5配置文件中的“launchType”属性配置。

下面介绍了任务管理如何实现以下三种启动模式UIAbility组件的管理:

2.1 singleton单实例模式

应用在运行时只存在一个该UIAbility实例。
在这里插入图片描述

2.2 multiton多实例模式

每次调用startAbility()方法,都会在应用进程中创建一个该UIAbility实例。
在这里插入图片描述

2.3 specified指定实例模式

AbilityStage的(onAcceptWant())决定是否创建新的UIAbility实例。
在这里插入图片描述
每个UIAbility实例都对应了一个最近任务列表中看到的Mission(任务)。
每个UIAbility实例对应的Mission都保留有该UIAbility实例的快照(Snapshot)UIAbility实例销毁后,Mission信息(包括UIAbility信息和任务快照)依然会保留,直到用户删除该任务。

3 页面栈及任务链

3.1 页面栈

单个UIAbility组件可以实现多个页面,并在多个页面之间跳转,这种UIAbility组件内部的页面跳转关系称为“页面栈”,由ArkUI框架统一管理,如下图中:
UIAbility1Page1->Page2->Page3
UIAbility2PageA->PageB->PageC

在这里插入图片描述

  • 页面栈的形成(下面2/3/5/6步骤为页面跳转,由ArkUI管理)
  1. 点击桌面图标(startAbility)启动UIAbility1UIAbility1的初始页面为Page1
  2. 点击Page1页面按钮(Navigator)跳转到Page2页面。
  3. 点击Page2页面按钮(Navigator)跳转到Page3页面。
  4. 点击Page3页面按钮(startAbility)跳转到UIAbility2UIAbility2的初始页面为PageA
  5. 点击PageA页面按钮(Navigator)跳转到PageB页面。
  6. 点击PageB页面按钮(Navigator)跳转到PageC页面。
  • 页面栈的返回(下面1/2/4/5步骤为页面跳转,由ArkUI管理)
  1. UIAbility2PageC页面点击返回键回到UIAbility2PageB页面。
  2. UIAbility2PageB页面点击返回键回到UIAbility2PageA页面。
  3. UIAbility2PageA页面点击返回键跳转到UIAbility1Page3页面。
  4. UIAbility1Page3页面点击返回键回到UIAbility1Page2页面。
  5. UIAbility1Page2页面点击返回键回到UIAbility1Page1页面。
  6. UIAbility1Page1页面点击返回键回到桌面

3.2 任务链

上文介绍了页面栈的返回,如果Ability2页面栈一层层通过返回键返回到最底层,再次点击返回键时,会返回到Ability1。因为在MissionList中记录了任务(Mission)之间的启动关系,即如果Ability1通过startAbility启动Ability2,则会形成一个MissionList任务链Ability1->Ability2,当Ability2页面栈返回到首页时,再次点击返回键,会返回到Ability1的页面。

MissionList任务链记录了任务之间的拉起关系,但是这个任务链可能会断开,有以下几种情况会导致任务链的断开:

  1. 进入任务列表,把任务链中间某个任务移动到前台。
    在这里插入图片描述
  2. 进入任务列表,把任务链中间某个任务清理掉。
    在这里插入图片描述
  3. 单实例UIAbility的任务,被不同的任务(包括Ability或桌面)反复拉起(AbilityB为单例)。
    在这里插入图片描述

4 设置任务快照的图标和名称

设置任务快照的图标和名称是为了提高用户界面的可视化性和用户体验,以便更好地管理和跟踪应用程序中的任务和功能。通过为每个任务快照设置不同的图标名称,可以更轻松地区分和识别每个任务的功能。

默认情况下任务快照的图标和名称采用的是module.json5配置文件的abilities标签中的iconlabel字段,如下图所示。
在这里插入图片描述

也可以使用UIAbilityContext.setMissionIcon()UIAbilityContext.setMissionLabel()方法,根据需要自定义任务快照的图标和名称。例如,对于UIAbility的多实例启动模式,可以根据不同的功能配置相应的任务快照的图标名称

4.1 设置任务快照的图标(仅对系统应用开放)

通过调用UIAbilityContext.setMissionIcon()方法修改任务快照的图标。

import common from '@ohos.app.ability.common';
import { BusinessError } from '@ohos.base';let context: common.UIAbilityContext = ...; // UIAbilityContext
let pixelMap: PixelMap = ...; // 图片的PixelMap信息context.setMissionIcon(pixelMap, (err: BusinessError) => {if (err.code) {console.error(`Failed to set mission icon. Code is ${err.code}, message is ${err.message}`);}
})

在这里插入图片描述

4.2 设置任务快照的名称

通过调用UIAbilityContext.setMissionLabel()方法修改任务快照的名称。

import common from '@ohos.app.ability.common';
import { BusinessError } from '@ohos.base';let context: common.UIAbilityContext = this.context; // UIAbilityContextcontext.setMissionLabel('test').then(() => {console.info('Succeeded in seting mission label.');
}).catch((err: BusinessError) => {console.error(`Failed to set mission label. Code is ${err.code}, message is ${err.message}`);
});

在这里插入图片描述

这篇关于【鸿蒙开发】第十四章 Stage模型应用组件-任务Mission的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/744162

相关文章

Spring Boot + MyBatis Plus 高效开发实战从入门到进阶优化(推荐)

《SpringBoot+MyBatisPlus高效开发实战从入门到进阶优化(推荐)》本文将详细介绍SpringBoot+MyBatisPlus的完整开发流程,并深入剖析分页查询、批量操作、动... 目录Spring Boot + MyBATis Plus 高效开发实战:从入门到进阶优化1. MyBatis

Python基于wxPython和FFmpeg开发一个视频标签工具

《Python基于wxPython和FFmpeg开发一个视频标签工具》在当今数字媒体时代,视频内容的管理和标记变得越来越重要,无论是研究人员需要对实验视频进行时间点标记,还是个人用户希望对家庭视频进行... 目录引言1. 应用概述2. 技术栈分析2.1 核心库和模块2.2 wxpython作为GUI选择的优

Python中随机休眠技术原理与应用详解

《Python中随机休眠技术原理与应用详解》在编程中,让程序暂停执行特定时间是常见需求,当需要引入不确定性时,随机休眠就成为关键技巧,下面我们就来看看Python中随机休眠技术的具体实现与应用吧... 目录引言一、实现原理与基础方法1.1 核心函数解析1.2 基础实现模板1.3 整数版实现二、典型应用场景2

Java的IO模型、Netty原理解析

《Java的IO模型、Netty原理解析》Java的I/O是以流的方式进行数据输入输出的,Java的类库涉及很多领域的IO内容:标准的输入输出,文件的操作、网络上的数据传输流、字符串流、对象流等,这篇... 目录1.什么是IO2.同步与异步、阻塞与非阻塞3.三种IO模型BIO(blocking I/O)NI

Python Dash框架在数据可视化仪表板中的应用与实践记录

《PythonDash框架在数据可视化仪表板中的应用与实践记录》Python的PlotlyDash库提供了一种简便且强大的方式来构建和展示互动式数据仪表板,本篇文章将深入探讨如何使用Dash设计一... 目录python Dash框架在数据可视化仪表板中的应用与实践1. 什么是Plotly Dash?1.1

Spring定时任务只执行一次的原因分析与解决方案

《Spring定时任务只执行一次的原因分析与解决方案》在使用Spring的@Scheduled定时任务时,你是否遇到过任务只执行一次,后续不再触发的情况?这种情况可能由多种原因导致,如未启用调度、线程... 目录1. 问题背景2. Spring定时任务的基本用法3. 为什么定时任务只执行一次?3.1 未启用

基于Flask框架添加多个AI模型的API并进行交互

《基于Flask框架添加多个AI模型的API并进行交互》:本文主要介绍如何基于Flask框架开发AI模型API管理系统,允许用户添加、删除不同AI模型的API密钥,感兴趣的可以了解下... 目录1. 概述2. 后端代码说明2.1 依赖库导入2.2 应用初始化2.3 API 存储字典2.4 路由函数2.5 应

利用Python开发Markdown表格结构转换为Excel工具

《利用Python开发Markdown表格结构转换为Excel工具》在数据管理和文档编写过程中,我们经常使用Markdown来记录表格数据,但它没有Excel使用方便,所以本文将使用Python编写一... 目录1.完整代码2. 项目概述3. 代码解析3.1 依赖库3.2 GUI 设计3.3 解析 Mark

Android Kotlin 高阶函数详解及其在协程中的应用小结

《AndroidKotlin高阶函数详解及其在协程中的应用小结》高阶函数是Kotlin中的一个重要特性,它能够将函数作为一等公民(First-ClassCitizen),使得代码更加简洁、灵活和可... 目录1. 引言2. 什么是高阶函数?3. 高阶函数的基础用法3.1 传递函数作为参数3.2 Lambda

Vue中组件之间传值的六种方式(完整版)

《Vue中组件之间传值的六种方式(完整版)》组件是vue.js最强大的功能之一,而组件实例的作用域是相互独立的,这就意味着不同组件之间的数据无法相互引用,针对不同的使用场景,如何选择行之有效的通信方式... 目录前言方法一、props/$emit1.父组件向子组件传值2.子组件向父组件传值(通过事件形式)方