0
  • 聊天消息
  • 系统消息
  • 评论与回复
登录后你可以
  • 下载海量资料
  • 学习在线课程
  • 观看技术视频
  • 写文章/发帖/加入社区
会员中心
创作中心

完善资料让更多小伙伴认识你,还能领取20积分哦,立即完善>

3天内不再提示

鸿蒙开发Ability Kit程序框架服务:任务管理

jf_46214456 来源:jf_46214456 作者:jf_46214456 2024-06-24 14:46 次阅读

任务(Mission)管理场景介绍

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

  • AbilityRecord:系统服务侧管理一个UIAbility实例的最小单元,对应一个应用侧的UIAbility组件实例。系统服务侧管理UIAbility实例数量上限为512个。
  • MissionRecord:任务管理的最小单元。一个MissionRecord中仅有一个AbilityRecord,即一个UIAbility组件实例对应一个单独的任务。
  • MissionList:一个从桌面开始启动的任务列表,记录了任务之间的启动关系,下一个任务由上一个任务启动,最底部的任务由桌面启动,这里称之为任务链。
  • MissionListManager:系统任务管理模块,内部维护了当前所有的任务链,与最近任务列表保持一致。
  • 开发前请熟悉鸿蒙开发指导文档 :[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
    图1 任务管理示意图
    mission-list-manager

任务的管理由系统应用(如桌面应用)负责,三方应用无法管理任务。用户通过最近任务列表进行任务的相关交互。当创建任务后,用户可以对最近任务列表进行如下操作:

  • 删除一个指定的任务。
  • 加锁或解锁一个指定的任务(加锁后的任务在清理所有任务时不会被清理)。
  • 清理最近任务列表中的所有任务。
  • 将一个指定的任务切换到前台。

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

  1. 桌面应用调用[missionManager]的接口管理任务,需要申请ohos.permission.MANAGE_MISSIONS权限,配置方式请参见[申请应用权限]。
  2. 利用missionManager进行任务管理(监听任务变化、获取任务信息、获取任务快照、清理任务、任务加锁/解锁等)。
    新文档.png
import { missionManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { image } from '@kit.ImageKit';
import { promptAction } from '@kit.ArkUI';
import { hilog } from '@kit.PerformanceAnalysisKit';

const TAG: string = 'TaskManager';
const DOMAIN_NUMBER: number = 0xFF00;
private listenerId: number = 0;
private missionId: number = 0;
private listener: missionManager.MissionListener = {
  // 任务创建
  onMissionCreated: (mission: number) = > {
    hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionCreated-------');
  },
  // 任务销毁
  onMissionDestroyed: (mission: number) = > {
    hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionDestroyed-------');
  },
  // 任务快照变化
  onMissionSnapshotChanged: (mission: number) = > {
    hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionMovedToFront-------');
  },
  // 任务被移动到前台
  onMissionMovedToFront: (mission: number) = > {
    hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionClosed-------');
  },
  // 任务图标变化
  onMissionIconUpdated: (mission: number, icon: image.PixelMap) = > {
    hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionIconUpdated-------');
  },
  // 任务名称变化
  onMissionLabelUpdated: (mission: number) = > {
    hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionLabelUpdated-------');
  },
  // 任务实例被关闭
  onMissionClosed: (mission: number) = > {
    hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionClosed-------');
  }
};
// 1.注册任务变化通知
this.listenerId = missionManager.on('mission', this.listener);
promptAction.showToast({
  message: $r('app.string.register_success_toast')
});
hilog.info(DOMAIN_NUMBER, TAG, `missionManager.on success, listenerId = ${this.listenerId}`);
// 2.获取系统最近20个任务
missionManager.getMissionInfos('', 20, (error: BusinessError, missions: Array< missionManager.MissionInfo >) = > {
  hilog.info(DOMAIN_NUMBER, TAG, 'getMissionInfos is called, error = ' + JSON.stringify(error));
  hilog.info(DOMAIN_NUMBER, TAG, 'size = ' + missions.length);
  hilog.info(DOMAIN_NUMBER, TAG, 'missions = ' + JSON.stringify(missions));
  
  // 判断系统最近任务中是否包含etsclock
  for (let i = 0;i < missions.length; i++) {
    if (missions[i].want.bundleName === 'ohos.samples.etsclock') {
      promptAction.showToast({
        message: $r('app.string.obtain_success_toast')
      });
      hilog.info(DOMAIN_NUMBER, TAG, `getMissionInfos.find etsclock, missionId  = ${missions[i].missionId}`);
      this.missionId = missions[i].missionId;
      return;
    }
  }
  promptAction.showToast({
    message: $r('app.string.obtain_failed_toast')
  });
});
// 3.获取单个任务的详细信息()
missionManager.getMissionInfo('', this.missionId).then((data: missionManager.MissionInfo) = > {
  promptAction.showToast({
    message: JSON.stringify(data.want.bundleName)
  });
  hilog.info(DOMAIN_NUMBER, TAG, `getMissionInfo successfully. Data: ${JSON.stringify(data)}`);
}).catch((error: BusinessError) = > {
  hilog.info(DOMAIN_NUMBER, TAG, `getMissionInfo failed. Cause: ${error.message}`);
});
// 4.获取任务快照
missionManager.getMissionSnapShot('', this.missionId, (error: BusinessError, snapshot: missionManager.MissionSnapshot) = > {
  if (error === null) {
    promptAction.showToast({
      message: $r('app.string.obtain_snapshot_success_toast')
    });
  }
  hilog.info(DOMAIN_NUMBER, TAG, 'getMissionSnapShot is called, error = ' + JSON.stringify(error));
  hilog.info(DOMAIN_NUMBER, TAG, 'bundleName = ' + snapshot.ability.bundleName);
})
// 5.获取低分辨任务快照
missionManager.getLowResolutionMissionSnapShot('', this.missionId, (error: BusinessError, snapshot: missionManager.MissionSnapshot) = > {
  if (error === null) {
    promptAction.showToast({
      message: $r('app.string.obtain_low_snapshot_success_toast')
    });
  }
  hilog.info(DOMAIN_NUMBER, TAG, 'getLowResolutionMissionSnapShot is called, error = ' + JSON.stringify(error));
  hilog.info(DOMAIN_NUMBER, TAG, 'bundleName = ' + snapshot.ability.bundleName);
})
// 6-1 加锁任务
missionManager.lockMission(this.missionId).then(() = > {
  promptAction.showToast({
    message: $r('app.string.lock_success_toast')
  });
  hilog.info(DOMAIN_NUMBER, TAG, 'lockMission is called ');
});
// 6-2 解锁任务
missionManager.unlockMission(this.missionId).then(() = > {
  promptAction.showToast({
    message: $r('app.string.unlock_success_toast')
  });
  hilog.info(DOMAIN_NUMBER, TAG, 'unlockMission is called ');
});
// 7.把任务切到前台
missionManager.moveMissionToFront(this.missionId).then(() = > {
  hilog.info(DOMAIN_NUMBER, TAG, 'moveMissionToFront is called ');
});
// 8.删除单个任务
missionManager.clearMission(this.missionId).then(() = > {
  promptAction.showToast({
    message: $r('app.string.delete_success_toast')
  });
  hilog.info(DOMAIN_NUMBER, TAG, 'clearMission is called ');
});
// 9.删除全部任务
missionManager.clearAllMissions().catch((err: BusinessError) = > {
  hilog.info(DOMAIN_NUMBER, TAG, `${err.code}`);
});
// 10.解注册任务变化通知
missionManager.off('mission', this.listenerId, (error: BusinessError) = > {
  if (error === null) {
    promptAction.showToast({
      message: $r('app.string.unregister_success_toast')
    });
  }
  hilog.info(DOMAIN_NUMBER, TAG, 'unregisterMissionListener');
})

审核编辑 黄宇

声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉
  • 框架
    +关注

    关注

    0

    文章

    398

    浏览量

    17393
  • 程序
    +关注

    关注

    116

    文章

    3754

    浏览量

    80724
  • Kit
    Kit
    +关注

    关注

    0

    文章

    26

    浏览量

    16450
  • 鸿蒙
    +关注

    关注

    57

    文章

    2301

    浏览量

    42669
收藏 人收藏

    评论

    相关推荐

    鸿蒙开发接口Ability框架:【@ohos.application.Ability (Ability)】

    Ability模块提供对Ability生命周期、上下文环境等调用管理的能力,包括Ability创建、销毁、转储客户端信息等。
    的头像 发表于 04-30 17:42 2175次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b>接口<b class='flag-5'>Ability</b><b class='flag-5'>框架</b>:【@ohos.application.<b class='flag-5'>Ability</b> (<b class='flag-5'>Ability</b>)】

    鸿蒙开发接口Ability框架:【@ohos.ability.featureAbility (FeatureAbility模块)】

    FeatureAbility模块提供带有UI设计与用户交互的能力,包括启动新的ability、获取dataAbilityHelper、设置此Page Ability、获取当前Ability对应的窗口,连接
    的头像 发表于 05-06 16:31 892次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b>接口<b class='flag-5'>Ability</b><b class='flag-5'>框架</b>:【@ohos.<b class='flag-5'>ability</b>.featureAbility (FeatureAbility模块)】

    鸿蒙开发接口Ability框架:【@ohos.application.missionManager (missionManager)】

    表示Ability对应任务信息的枚举。
    的头像 发表于 05-08 09:19 846次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b>接口<b class='flag-5'>Ability</b><b class='flag-5'>框架</b>:【@ohos.application.missionManager (missionManager)】

    鸿蒙开发接口Ability框架:【 (Context模块)】

    Context模块提供了ability或application的上下文的能力,包括允许访问特定于应用程序的资源、请求和验证权限等。
    的头像 发表于 05-13 16:04 644次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b>接口<b class='flag-5'>Ability</b><b class='flag-5'>框架</b>:【 (Context模块)】

    鸿蒙Ability Kit程序框架服务)【ServiceExtensionAbility】

    [ServiceExtensionAbility]是SERVICE类型的ExtensionAbility组件,提供后台服务能力,其内部持有了一个[ServiceExtensionContext],通过[ServiceExtensionContext]提供了丰富的接口供外部使用。
    的头像 发表于 06-04 14:50 1068次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>Ability</b> <b class='flag-5'>Kit</b>(<b class='flag-5'>程序</b><b class='flag-5'>框架</b><b class='flag-5'>服务</b>)【ServiceExtensionAbility】

    鸿蒙Ability Kit程序框架服务)【UIExtensionAbility】

    [UIExtensionAbility]是UI类型的ExtensionAbility组件,需要与[UIExtensionComponent]一起配合使用,开发者可以在UIAbility的页面中通过
    的头像 发表于 06-05 09:19 1240次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>Ability</b> <b class='flag-5'>Kit</b>(<b class='flag-5'>程序</b><b class='flag-5'>框架</b><b class='flag-5'>服务</b>)【UIExtensionAbility】

    鸿蒙Ability开发-Stage模型下Ability的创建和使用

    函数 HiLog日志系统可以让应用按照指定类型、指定级别、指定格式字符串打印日志内容,帮助开发者了解应用/服务的运行状态,更好地调试程序。 HiLog提供了debug、info、warn、error以及fatal
    发表于 01-08 15:34

    HarmonyOS NEXT Developer Beta1中的Kit

    、AI六大领域,例如: 应用框架相关Kit开放能力:Ability Kit程序框架
    发表于 06-26 10:47

    跟阿斌一起学鸿蒙(2): Ability vs App?

    在进一步实践之前,需要先弄明白一个概念:Ability。不知道你有没有注意到,使用鸿蒙开发工具DevEco Studio创建项目时,我们选择创建的是一个个Ability。这是为什么呢?
    发表于 11-30 20:56

    跟阿斌一起学鸿蒙(2): Ability vs App?

    在进一步实践之前,需要先弄明白一个概念:Ability。不知道你有没有注意到,使用鸿蒙开发工具DevEco Studio创建项目时,我们选择创建的是一个个Ability。这是为什么呢?
    发表于 12-02 16:55

    鸿蒙应用开发入门资料合集

    应用开发入门资料六:实现跨设备迁移分布式任务调度概述在HarmonyOS中,分布式任务调度平台对搭载HarmonyOS的多设备构筑的“超级虚拟终端”提供统一的组件管理能力,为应用定义统
    发表于 03-22 11:23

    鸿蒙应用模型:【Ability Kit】简介

    Ability Kit程序框架服务)提供了应用程序开发
    的头像 发表于 05-29 14:41 540次阅读
    <b class='flag-5'>鸿蒙</b>应用模型:【<b class='flag-5'>Ability</b> <b class='flag-5'>Kit</b>】简介

    鸿蒙Ability Kit程序框架服务)【Ability内页面间的跳转】

    基于Stage模型下的Ability开发,实现Ability内页面间的跳转和数据传递。
    的头像 发表于 06-03 20:43 245次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>Ability</b> <b class='flag-5'>Kit</b>(<b class='flag-5'>程序</b><b class='flag-5'>框架</b><b class='flag-5'>服务</b>)【<b class='flag-5'>Ability</b>内页面间的跳转】

    鸿蒙Ability Kit程序框架服务)【Ability与ServiceExtensionAbility通信】

    本示例展示通过[IDL的方式]和 [@ohos.rpc] 等接口实现了Ability与ServiceExtensionAbility之间的通信。
    的头像 发表于 06-05 09:28 425次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>Ability</b> <b class='flag-5'>Kit</b>(<b class='flag-5'>程序</b><b class='flag-5'>框架</b><b class='flag-5'>服务</b>)【<b class='flag-5'>Ability</b>与ServiceExtensionAbility通信】

    鸿蒙Ability Kit程序框架服务)【应用启动框架AppStartup】

    `AppStartup`提供了一种更加简单高效的初始化组件的方式,支持异步初始化组件加速应用的启动时间。使用启动框架应用开发者只需要分别为待初始化的组件实现`AppStartup`提供
    的头像 发表于 06-10 18:38 640次阅读