harmony 鸿蒙任务(Mission)管理场景介绍

  • 2022-12-13
  • 浏览 (1393)

任务(Mission)管理场景介绍

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

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

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

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

  • MissionListManager:系统任务管理模块,内部维护了当前所有的任务链,与最近任务列表保持一致。

图1 任务管理示意图
mission-list-manager

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

  • 删除一个指定的任务。

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

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

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

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

  1. 桌面应用调用missionManager的接口管理任务,需要申请ohos.permission.MANAGE_MISSIONS权限,配置方式请参见申请应用权限

  2. 利用missionManager进行任务管理(监听任务变化、获取任务信息、获取任务快照、清理任务、任务加锁/解锁等)。

    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);
    this.getUIContext().getPromptAction().showToast({
      message: '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>) => {
        if (error.code) {
          hilog.error(DOMAIN_NUMBER, TAG,
            `getMissionInfos is called, error code: ${error.code}, err msg: ${error.message}.`);
          return;
        }
        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') {
            this.getUIContext().getPromptAction().showToast({
              message: 'obtain_success_toast'
            });
            hilog.info(DOMAIN_NUMBER, TAG,
              `getMissionInfos.find etsclock, missionId  = ${missions[i].missionId}`);
            this.missionId = missions[i].missionId;
            return;
          }
        }
        this.getUIContext().getPromptAction().showToast({
          message: 'obtain_failed_toast'
        });
      });
    
    // 3.获取单个任务的详细信息()
    missionManager.getMissionInfo('', this.missionId).then((data: missionManager.MissionInfo) => {
      this.getUIContext().getPromptAction().showToast({
        message: JSON.stringify(data.want.bundleName)
      });
      hilog.info(DOMAIN_NUMBER, TAG, `getMissionInfo successfully. Data: ${JSON.stringify(data)}`);
    }).catch((error: BusinessError) => {
      hilog.error(DOMAIN_NUMBER, TAG, `getMissionInfo failed. Cause: ${error.message}`);
    });
    
    // 4.获取任务快照
    missionManager.getMissionSnapShot('', this.missionId,
      (error: BusinessError, snapshot: missionManager.MissionSnapshot) => {
        if (error === null) {
          this.getUIContext().getPromptAction().showToast({
            message: 'obtain_snapshot_success_toast'
          });
        }
        hilog.error(DOMAIN_NUMBER, TAG,
          `getMissionSnapShot is called, error code: ${error.code}, error msg: ${error.message}.`);
        hilog.info(DOMAIN_NUMBER, TAG, `bundleName = ${snapshot.ability.bundleName}.`);
      });
    
    // 5.获取低分辨任务快照
    missionManager.getLowResolutionMissionSnapShot('', this.missionId,
      (error: BusinessError, snapshot: missionManager.MissionSnapshot) => {
        if (error === null) {
          this.getUIContext().getPromptAction().showToast({
            message: 'obtain_low_snapshot_success_toast'
          });
        }
        hilog.error(DOMAIN_NUMBER, TAG,
          `getLowResolutionMissionSnapShot is called, error code: ${error.code}, error msg: ${error.message}.`);
        hilog.info(DOMAIN_NUMBER, TAG, `bundleName = ${snapshot.ability.bundleName}.`);
      });
    
    // 6-1 加锁任务
    missionManager.lockMission(this.missionId).then(() => {
      this.getUIContext().getPromptAction().showToast({
        message: 'lock_success_toast'
      });
      hilog.info(DOMAIN_NUMBER, TAG, 'lockMission is called ');
    });
    
    // 6-2 解锁任务
    missionManager.unlockMission(this.missionId).then(() => {
      this.getUIContext().getPromptAction().showToast({
        message: '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(() => {
      this.getUIContext().getPromptAction().showToast({
        message: 'delete_success_toast'
      });
      hilog.info(DOMAIN_NUMBER, TAG, 'clearMission is called ');
    });
    
    // 9.删除全部任务
    missionManager.clearAllMissions().catch((err: BusinessError) => {
      hilog.error(DOMAIN_NUMBER, TAG, `${err.code}`);
    });
    
    // 10.解注册任务变化通知
    missionManager.off('mission', this.listenerId, (error: BusinessError) => {
      if (error === null) {
        this.getUIContext().getPromptAction().showToast({
          message: 'unregister_success_toast'
        });
      }
      hilog.info(DOMAIN_NUMBER, TAG, 'unregisterMissionListener');
    });
    

相关实例

针对任务管理开发,有以下相关实例可供参考:

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Ability Kit(程序框架服务)

harmony 鸿蒙获取应用异常退出原因

harmony 鸿蒙UIAbility备份恢复

harmony 鸿蒙使用显式Want启动应用组件

harmony 鸿蒙Ability Kit简介

harmony 鸿蒙AbilityStage组件容器

harmony 鸿蒙访问DataAbility

harmony 鸿蒙FA模型访问Stage模型DataShareExtensionAbility

harmony 鸿蒙常见action与entities(不推荐使用)

harmony 鸿蒙API切换概述

0  赞