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

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

默认情况下任务快照的图标和名称采用的是 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 设置任务快照的名称

写在最后

• 如果你觉得这篇内容对你还蛮有协助，我想邀请你帮我三个小忙：
• 点赞，转发，有你们的 『点赞和评论』，才是我创造的动力。
• 关注小编，同时可以期待后续文章ing🚀，不定期分享原创知识。
• 想要获取更多完整鸿蒙最新学习知识点，请移步前往小编：https://gitee.com/MNxiaona/733GH/blob/master/jianshu