文档开发者中心
我的
|

Background Tasks Kit

HarmonyOS SDK

跟着官网的延迟任务文档实现的demo,在模拟器运行一直无法回调任务

 申请延长服务后,log输出服务申请成功,但一直未有回调输出,使用 hdc 检测也为发现有注册的延迟任务,请帮大神帮看看是哪里出了问题

收起
自动换行
深色代码主题
复制
// ./entryworkschedulerextability/EntryWorkSchedulerExtAbility.ets
import hilog from '@ohos.hilog';
import WorkSchedulerExtensionAbility from '@ohos.WorkSchedulerExtensionAbility';
import workScheduler from '@ohos.resourceschedule.workScheduler';

export default class WorkSchedulerExtension extends WorkSchedulerExtensionAbility {
  onWorkStart(workInfo: workScheduler.WorkInfo) {
    hilog.info(0, 'testTag', '%{public}s',
      'WorkSchedulerExtensionAbility onWorkStart, workInfo = ' + JSON.stringify(workInfo));
  }

  onWorkStop(workInfo: workScheduler.WorkInfo) {
    hilog.info(0, 'testTag', '%{public}s',
      'WorkSchedulerExtensionAbility onWorkStop, workInfo = ' + JSON.stringify(workInfo));
  }
};

Index

收起
自动换行
深色代码主题
复制
import workScheduler from '@ohos.resourceschedule.workScheduler';
import { BusinessError } from '@kit.BasicServicesKit'
import hilog from '@ohos.hilog';
let workInfo: workScheduler.WorkInfo = {
  workId: 1,
  bundleName: 'com.example.application',
  abilityName: 'WorkSchedulerExtension',
  networkType: workScheduler.NetworkType.NETWORK_TYPE_WIFI,
};

@Entry
@Component
struct Index {
  @State currentCount: number = 0;
  @State lastExecuteTime: string = '暂无';
  @State isTaskRunning: boolean = false;

  // 启动任务
  private async startDelayTask() {
    try {
      workScheduler.startWork(workInfo);
      this.isTaskRunning = true;
      console.info('延迟任务申请成功');
      hilog.info(0, 'testTag', '🚀 延迟任务申请成功 startWork ');
    } catch (error) {
      hilog.error(0, 'testTag', `延迟任务申请失败: code is ${(error as BusinessError).code}, message is ${(error as BusinessError).message}`);
    }
  }

  // 停止任务的方法
  private async stopDelayTask() {
    try {
      // 先检查任务是否存在
      const workStatus = await workScheduler.getWorkStatus(1);
      if (workStatus) {
        workScheduler.stopWork(workInfo, true);
        this.isTaskRunning = false;
        hilog.info(0, 'testTag', '🚀 已停止存在的延迟任务 stopWork ');
      }
    } catch (error) {
      // 如果任务不存在会抛出异常,这是正常的
      hilog.error(0, 'testTag', '没有找到需要停止的任务,继续执行');
    }
  }

  // 获取延迟任务状态
  private async checkTaskStatus() {
    try {
      const workStatus = await workScheduler.getWorkStatus(1);
      // 显示任务信息
      hilog.info(0, 'testTag', `🚀 延迟任务状态checkTaskStatus: ${JSON.stringify({
        workId: workStatus.workId,
        bundleName: workStatus.bundleName,
        abilityName: workStatus.abilityName,
        isRepeat: workStatus.isRepeat,
        repeatCycleTime: `${workStatus.repeatCycleTime}ms`
      })}`);

    } catch (error) {
      hilog.error(0, 'testTag', `获取任务状态失败: ${JSON.stringify(error)}`);
    }
  }

  // 获取所有延迟任务
  private async getAllTasks() {
    try {
      const allWorks = await workScheduler.obtainAllWorks();
      hilog.info(0, 'testTag', `🚀 所有延迟任务getAllTasks: ${JSON.stringify(allWorks)}`);
      hilog.info(0, 'testTag', `🚀 任务数量: ${allWorks.length}`);
    } catch (error) {
      hilog.error(0, 'testTag', `获取所有任务失败: ${JSON.stringify(error)}`);
    }
  }

  build() {
    Column() {
      Column({ space: 15 }) {
       Text(this.isTaskRunning ? '延迟任务运行中' : '延迟任务已停止')
          .fontSize(16)
          .fontColor(this.isTaskRunning ? Color.Green : Color.Red)
      }
      .alignItems(HorizontalAlign.Center)
      .padding(20)
      .backgroundColor(Color.White)
      .borderRadius(10)
      .margin({ left: 20, right: 20 })

      Column({ space: 10 }) {
        Button(this.isTaskRunning ? '停止延迟任务' : '启动延迟任务')
          .width('80%')
          .backgroundColor(this.isTaskRunning ? Color.Red : Color.Green)
          .onClick(() => {
            if (this.isTaskRunning) {
              this.stopDelayTask();
            } else {
              this.startDelayTask();
            }
          })



        Button('检查任务状态')
          .width('80%')
          .backgroundColor(Color.Orange)
          .onClick(() => {
            this.checkTaskStatus();
          })

        Button('查看所有任务')
          .width('80%')
          .backgroundColor(Color.Brown)
          .onClick(() => {
            this.getAllTasks();
          })
      }
    }
    .width('100%')
    .height('100%')
    .backgroundColor('#F5F5F5')
    .justifyContent(FlexAlign.Center)  // 添加垂直居中对齐
    .alignItems(HorizontalAlign.Center)  // 添加水平居中对齐
  }
}

module.json5

收起
自动换行
深色代码主题
复制
{
  "module": {
    "name": "entry",
    "type": "entry",
    "description": "$string:module_desc",
    "mainElement": "EntryAbility",
    "deviceTypes": [
      "phone"
    ],
    "deliveryWithInstall": true,
    "installationFree": false,
    "pages": "$profile:main_pages",
    "abilities": [
      {
        "name": "EntryAbility",
        "srcEntry": "./ets/entryability/EntryAbility.ets",
        "description": "$string:EntryAbility_desc",
        "icon": "$media:icon",
        "label": "$string:EntryAbility_label",
        "startWindowIcon": "$media:startIcon",
        "startWindowBackground": "$color:start_window_background",
        "exported": true,
        "skills": [
          {
            "entities": [
              "entity.system.home"
            ],
            "actions": [
              "action.system.home"
            ]
          }
        ]
      }
    ],
    "extensionAbilities": [
      {
        "name": "EntryWorkSchedulerExtAbility",
        "srcEntry": "./ets/entryworkschedulerextability/EntryWorkSchedulerExtAbility.ets",
        "type": "workScheduler"
      }
    ]
  }
}

11.png

22.png

点赞
收藏
回复
2
分享
举报
浏览251 发布于2025-06-02 12:14广西
全部评论
最多点赞
最新发布
最早发布
|
技术支持

【背景知识】

  • 延迟任务的介绍: 应用退至后台后,需要执行实时性要求不高的任务,例如有网络时不定期主动获取邮件等,可以使用延迟任务。当应用满足设定条件(包括网络类型、充电类型、存储状态、电池状态、定时状态等)时,将任务添加到执行队列,系统会根据内存、功耗、设备温度、用户使用习惯等统一调度拉起应用。
  • 延迟任务实现原理: 应用调用延迟任务接口添加、删除、查询延迟任务,延迟任务管理模块会根据任务设置的条件(通过WorkInfo参数设置,包括网络类型、充电类型、存储状态等)和系统状态(包括内存、功耗、设备温度、用户使用习惯等)统一决策调度时机。当满足调度条件或调度结束时,系统会回调应用WorkSchedulerExtensionAbility中onWorkStart()或onWorkStop()的方法,同时会为应用单独创建一个Extension扩展进程用以承载[WorkSchedulerExtensionAbility,并给WorkSchedulerExtensionAbility一定的活动周期,开发者可以在对应回调方法中实现自己的任务逻辑。

【常见FAQ】

Q:确认延迟任务是否申请成功的命令hdc shell hidumper -s 1904 -a '-a'和确认延迟任务WorkSchedulerExtensionAbility回调方法onWorkStart、onWorkStop实现是否正确、是否可以成功回调的命令hdc shell hidumper -s 1904 -a '-t ${bundleName} ${abilityName}'执行结果与指南文档描述不一致。文档描述,命令hdc shell hidumper -s 1904 -a '-t ${bundleName} ${abilityName}'会手动触发延迟任务执行回调,命令hdc shell hidumper -s 1904 -a '-a'会返回“包含对应应用的bundleName、abilityName、workId”。实际上两个命令的执行结果几乎一致,原因是什么?

A:文档描述的执行结果,是在手机root版本执行的结果,在手机普通版本执行因权限问题会与描述不一致。

【解决方案】

开发者可通过两种方式对Extension Ability生命周期函数进行调试:

展开全部
2楼回复于2025-07-18 08:19 来自广东
同样的问题,完全不触发,或者偶尔无规律的触发一次
1楼回复于2025-06-21 11:26 来自广东
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。