設置任務快照的圖標和名稱

設置任務快照的圖標和名稱是為了提高用戶界面的可視化性和用戶體驗，以便更好地管理和跟蹤應用程序中的任務和功能。通過為每個任務快照設置不同的圖標和名稱，可以更輕松地區分和識別每個任務的功能。

默認情況下任務快照的圖標和名稱采用的是[module.json5配置文件]的[abilities標簽]中的icon和label字段，如下圖所示。

圖1 UIAbility對應的任務快照

也可以使用[UIAbilityContext.setMissionIcon()]和[UIAbilityContext.setMissionLabel()]方法，根據需要自定義任務快照的圖標和名稱。例如，對于UIAbility的多實例啟動模式，可以根據不同的功能配置相應的任務快照的圖標和名稱。

本文將從以下兩個方面介紹。

• [設置任務快照的圖標（僅對系統應用開放）]
• [設置任務快照的名稱]
• 開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

設置任務快照的圖標（僅對系統應用開放）

通過調用[UIAbilityContext.setMissionIcon()]方法修改任務快照的圖標。

示例中的context的獲取方式請參見[獲取UIAbility的上下文信息]。示例中的pixelMap的獲取方式請參見[圖片解碼]。

import type common from '@ohos.app.ability.common';
import type { BusinessError } from '@ohos.base';
import hilog from '@ohos.hilog';

const TAG: string = 'EntryAbility';
const DOMAIN_NUMBER: number = 0xFF00;

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

... // 獲取pixelMap

// 設置任務快照的圖標
context.setMissionIcon(pixelMap, (err: BusinessError) = > {
  if (err.code) {
    hilog.error(DOMAIN_NUMBER, TAG, `Failed to set mission icon. Code is ${err.code}, message is ${err.message}`);
  } else {
    hilog.info(DOMAIN_NUMBER, TAG, `Success to set mission icon.`);
  }
})

效果示意如下圖所示。

圖2 設置任務快照的圖標

設置任務快照的名稱

通過調用[UIAbilityContext.setMissionLabel()]方法修改任務快照的名稱。

import type common from '@ohos.app.ability.common';
import type { BusinessError } from '@ohos.base';
import hilog from '@ohos.hilog';

const TAG: string = 'EntryAbility';
const DOMAIN_NUMBER: number = 0xFF00;

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

`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`

效果示意如下圖所示。

圖3 設置任務快照的名稱

審核編輯 黃宇