HarmonyOS 鸿蒙Next backgroundTaskManager 相关问题咨询

1.目前网络管理服务（kit.NetworkKit）和上传下载（ohos.request）支持长时任务 2.在startBackgroundRunning回调中执行

3.update使用方式可参考：

如果应用想先后申请多种不同类型的长时任务只能使用start+update模式

目前停止长时任务只能使用stop，会把应用所有的长时任务全部停止掉(已经给系统提供需求支持单一类型的停止)，目前只能是stop+start的方式保证业务体验联系性

抽象一个基础能力，不耦合业务来实现不同类型的长时任务动态管理

/*

* Copyright (c) Huawei Technologies Co., Ltd. 2024-2024. All rights reserved.

*/

import { backgroundTaskManager } from '@kit.BackgroundTasksKit'

import WantAgent from '@ohos.app.ability.wantAgent';

import { BusinessError } from '@kit.BasicServicesKit'

import { BackgroundMode } from './BackgroundMode'

import { MusicApp } from '../global/globalmodel/GlobalModel'

import { createOrGet, globalKeys } from '../global/GlobalThisHelper'

import { Logger } from './Logger'

const logger = new Logger("LastLongTaskHelper")

const ERRCODE_BGTASK_EXISTS = 9800005

/**

* 长时任务管理类

*/

export class LastLongTaskHelper {

private static instance?: LastLongTaskHelper

private bgModeSet = new Set<string>()

/**

* 获取唯一实例

* @returns

*/

public static getInstance(): LastLongTaskHelper {

if (!LastLongTaskHelper.instance) {

LastLongTaskHelper.instance = new LastLongTaskHelper()

}

return LastLongTaskHelper.instance

}

/**

* 开启长时任务

* @param action 类型

* @param bgMode 任务类型

* @param wantAgent

* @returns 任务的id

*/

public startBackGround(action: string, bgMode: BackgroundMode, wantAgent: object): Promise<number | undefined> {

this.bgModeSet.add(bgMode)

const app: MusicApp = createOrGet(MusicApp, globalKeys.app)

return new Promise((resolve) => {

// 只有一种类型 直接start

if (this.bgModeSet.size === 1) {

resolve(this.startBackgroundRunning(action, bgMode, wantAgent))

} else if (this.bgModeSet.size > 1) {

// 如果有多种类型时 audio和mul 不共存

if (bgMode === BackgroundMode.AUDIO) {

this.bgModeSet.delete(BackgroundMode.MULTI_DEVICE_CONNECTION)

} else if (bgMode === BackgroundMode.MULTI_DEVICE_CONNECTION) {

this.bgModeSet.delete(BackgroundMode.AUDIO)

}

// 超过两个时进行更新

backgroundTaskManager.updateBackgroundRunning(app.abilityContext, Array.from(this.bgModeSet))

.then((res: backgroundTaskManager.ContinuousTaskNotification) => {

let resId = res.notificationId

logger.info(`${action},Operation updateBackgroundRunning succeeded, ${JSON.stringify(this.bgModeSet)}, resId ${resId}`)

resolve(resId)

}).catch((error: BusinessError) => {

logger.error(`${action}, Operation updateBackgroundRunning failed. code is ${error.code} message is ${error.message}`)

// 如果更新失败 尝试重新start

if (error.code === ERRCODE_BGTASK_EXISTS) {

resolve(this.startBackgroundRunning(action, bgMode, wantAgent))

return

}

resolve(undefined)

})

}

})

}

/**

* startBackgroundRunning

* @param action 类型

* @param bgMode 任务类型

* @param wantAgent

*/

private startBackgroundRunning(action : string, bgMode: BackgroundMode, wantAgent: object) : Promise<number | undefined> {

const app: MusicApp = createOrGet(MusicApp, globalKeys.app)

return new Promise((resolve) => {

backgroundTaskManager.startBackgroundRunning(app.abilityContext, [bgMode], wantAgent)

.then((res: backgroundTaskManager.ContinuousTaskNotification) => {

let resId = res.notificationId

logger.info(`${action},startBackgroundRunning succeeded ${bgMode}, resId ${resId}`)

resolve(resId)

})

.catch((error: BusinessError) => {

logger.error(`Operation startBackgroundRunning failed. code is ${error.code} message is ${error.message}`);

resolve(undefined)

});

})

}

/**

* 停止长时任务

* @param action 类型

* @param bgMode 任务类型

*/

public stopBackGround(action: string, bgMode: BackgroundMode): void {

this.bgModeSet.delete(bgMode)

if (this.bgModeSet.size === 0) {

const app: MusicApp = createOrGet(MusicApp, globalKeys.app)

backgroundTaskManager.stopBackgroundRunning(app.abilityContext, (err, data) => {

if (err) {

logger.warn(`${action}, stop background err ${err.stack}`)

} else {

logger.info(`${action},stop background success`)

}

})

} else if (this.bgModeSet.size > 0) {

// 如果是下载的场景要定制处理

if (bgMode === BackgroundMode.DATA_TRANSFER) {

const app: MusicApp = createOrGet(MusicApp, globalKeys.app)

backgroundTaskManager.stopBackgroundRunning(app.abilityContext, (err, data) => {

if (err) {

logger.warn(`${action}, stop background err ${err.stack}`)

} else {

logger.info(`${action},stop background success`)

}

this.reStartBackGround(BackgroundMode.DATA_TRANSFER)

})

} else {

const app: MusicApp = createOrGet(MusicApp, globalKeys.app)

backgroundTaskManager.updateBackgroundRunning(app.abilityContext, Array.from(this.bgModeSet)).then(() => {

logger.info(`${action},Operation updateBackgroundRunning succeeded, ${JSON.stringify(this.bgModeSet)}`);

}).catch((error: BusinessError) => {

logger.error(`${action}, Operation updateBackgroundRunning failed. code is ${error.code} message is ${error.message}`)

})

}

}

}

/**

* 重新开启某种类型的后台任务 先从set中移除在基于set中剩余的进行开启

* @param bgMode 待移除的类型

*/

public reStartBackGround(bgMode: BackgroundMode): void {

this.bgModeSet.delete(bgMode)

if (this.bgModeSet.has(BackgroundMode.AUDIO)) {

this.start('reStartBackGround', BackgroundMode.AUDIO)

} else if (this.bgModeSet.has(BackgroundMode.MULTI_DEVICE_CONNECTION)) {

this.start('reStartBackGround', BackgroundMode.MULTI_DEVICE_CONNECTION)

}

}

/**

* 开启任务

* @param action 类型

* @param bgMode 任务模式

*/

private start(action: string, bgMode: BackgroundMode): void {

logger.info(`${action},start background ${bgMode}`)

let wantAgentInfo: WantAgent.WantAgentInfo = {

wants: [

{

bundleName: "com.huawei.hmsapp.music",

abilityName: "MainAbility",

}

],

operationType: WantAgent.OperationType.START_ABILITY,

requestCode: 0,

wantAgentFlags: [WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]

};

WantAgent.getWantAgent(wantAgentInfo).then((agent) => {

logger.info('getWantAgent success' + JSON.stringify(agent));

LastLongTaskHelper.getInstance().startBackGround(action, bgMode, agent)

}).catch((err: BusinessError) => {

logger.warn(`${action},setLaunchAbility fail ${err.stack}`);

})

}

}