HarmonyOS 应用开发之设置任务快照的图标和名称

news2024/11/24 14:41:12

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

默认情况下任务快照的图标和名称采用的是 module.json5配置文件的 abilities标签中的icon和label字段，如下图所示。

图1 UIAbility对应的任务快照

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

本文将从以下两个方面介绍。

设置任务快照的图标（仅对系统应用开放）
设置任务快照的名称

设置任务快照的图标（仅对系统应用开放）

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

示例中的context的获取方式请参见获取UIAbility的上下文信息。示例中的pixelMap的获取方式请参见图片解码。

import common from '@ohos.app.ability.common';
import Logger from '../utils/Logger';
import { BusinessError } from '@ohos.base';

const TAG: string = 'EntryAbility';

...
let context: common.UIAbilityContext = this.context; // UIAbilityContext

... // 获取pixelMap

// 设置任务快照的图标
context.setMissionIcon(pixelMap, (err: BusinessError) => {
  if (err.code) {
    Logger.error(TAG, `Failed to set mission icon. Code is ${err.code}, message is ${err.message}`);
  } else {
    Logger.info(TAG, `Success to set mission icon.`);
  }
})

效果示意如下图所示。

图2 设置任务快照的图标

设置任务快照的名称

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

import common from '@ohos.app.ability.common';
import { BusinessError } from '@ohos.base';
import Logger from '../utils/Logger';

const TAG: string = 'EntryAbility';

...
let context: common.UIAbilityContext = this.context; // UIAbilityContext
// 设置任务快照的名称
context.setMissionLabel('test').then(() => {
  Logger.info(TAG, 'Succeeded in seting mission label.');
}).catch((err: BusinessError) => {
  Logger.error(TAG, `Failed to set mission label. Code is ${err.code}, message is ${err.message}`);
});

效果示意如下图所示。

图3 设置任务快照的名称