输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心
全部文档版本说明工具设计指南与API参考开发与测试上架分发与运营问题处理与运维最佳实践行业解决方案
指南与API参考
指南
API
您当前正在浏览新版开发者文档中心，目录分类和层级有所调整。点击左侧当前文档分类名称前的“☰”图标，可切换文档分类。 了解新版目录
指南与API参考指南应用框架Background Tasks Kit（后台任务开发服务）短时任务(C/C++)

短时任务(C/C++)

更新时间: 2026-09-09 06:54
复制页面
本文导读
展开章节

场景介绍

应用退至后台一小段时间后，应用进程会被挂起，无法执行对应的任务。如果应用在后台仍需要执行耗时不长的任务，如状态保存等，可以通过本文申请短时任务，扩展应用在后台的运行时间。

约束与限制

申请短时任务的按钮，不可连续点击超过3次，否则会超出短时任务数量限制并报错。使用过程中更多的约束与限制请参考短时任务（ArkTS）的约束与限制。

接口说明

常用接口如下表所示，具体API说明详见transient_task_api.h。

展开
接口名 描述
int32_t OH_BackgroundTaskManager_RequestSuspendDelay(const char *reason, TransientTask_Callback callback, TransientTask_DelaySuspendInfo *info) 申请短时任务。
int32_t OH_BackgroundTaskManager_GetRemainingDelayTime(int32_t requestId, int32_t *delayTime) 获取对应短时任务的剩余时间。
int32_t OH_BackgroundTaskManager_CancelSuspendDelay(int32_t requestId) 取消短时任务。
int32_t OH_BackgroundTaskManager_GetTransientTaskInfo(TransientTask_TransientTaskInfo *transientTaskInfo) 获取所有短时任务信息，如当日剩余总配额等。

开发步骤

在napi_init.cpp文件中封装接口并注册模块

  1. 封装函数

    收起
    自动换行
    深色代码主题
    复制
    1. #include "napi/native_api.h"
    2. #include "transient_task/transient_task_api.h"
    3. 

    4. TransientTask_DelaySuspendInfo delaySuspendInfo;
    5. const int32_t TransientTask_TIMER = 3;
    6. static void Callback(void)
    7. {
    8.     // 短时任务即将结束，业务在这里取消短时任务
    9.     OH_BackgroundTaskManager_CancelSuspendDelay(delaySuspendInfo.requestId);
    10. }
    11. 

    12. // 申请短时任务
    13. static napi_value RequestSuspendDelay(napi_env env, napi_callback_info info)
    14. {
    15.     napi_value result;
    16.     int32_t res = OH_BackgroundTaskManager_RequestSuspendDelay("test", Callback, &delaySuspendInfo);
    17.     if (res == 0) {
    18.         napi_create_int32(env, delaySuspendInfo.requestId, &result);
    19.     } else {
    20.         napi_create_int32(env, -1, &result);
    21.     }
    22.     return result;
    23. }
    24. 

    25. // 获取剩余时间
    26. static napi_value GetRemainingDelayTime(napi_env env, napi_callback_info info)
    27. {
    28.     napi_value result;
    29.     int32_t delayTime = 0;
    30.     int32_t res = OH_BackgroundTaskManager_GetRemainingDelayTime(delaySuspendInfo.requestId, &delayTime);
    31.     if (res == 0) {
    32.         napi_create_int32(env, delayTime, &result);
    33.     } else {
    34.         napi_create_int32(env, -1, &result);
    35.     }
    36.     return result;
    37. }
    38. 

    39. // 取消短时任务
    40. static napi_value CancelSuspendDelay(napi_env env, napi_callback_info info)
    41. {
    42.     napi_value result;
    43.     int32_t res = OH_BackgroundTaskManager_CancelSuspendDelay(delaySuspendInfo.requestId);
    44.     napi_create_int32(env, res, &result);
    45.     return result;
    46. }
    47. 

    48. // 获取所有短时任务信息
    49. TransientTask_TransientTaskInfo transientTaskInfo;
    50. 

    51. static napi_value GetTransientTaskInfo(napi_env env, napi_callback_info info)
    52. {
    53.     napi_value result;
    54.     napi_create_object(env, &result);
    55.     int32_t res = OH_BackgroundTaskManager_GetTransientTaskInfo(&transientTaskInfo);
    56.     napi_value napiRemainingQuota = nullptr;
    57.     // 获取成功，格式化数据并返回给接口
    58.     if (res == 0) {
    59.         napi_create_int32(env, transientTaskInfo.remainingQuota, &napiRemainingQuota);
    60.         napi_set_named_property(env, result, "remainingQuota", napiRemainingQuota); // 格式化当日总配额
    61. 

    62.         napi_value info {nullptr};
    63.         napi_create_array(env, &info);
    64.         uint32_t count = 0;
    65.         // 格式化所有已申请的短时任务信息
    66.         for (int index = 0; index < TransientTask_TIMER; index++) {
    67.             if (transientTaskInfo.transientTasks[index].requestId == 0) {
    68.                 continue;
    69.             }
    70.             
    71.             napi_value napiWork = nullptr;
    72.             napi_create_object(env, &napiWork);
    73. 

    74.             napi_value napiRequestId = nullptr;
    75.             napi_create_int32(env, transientTaskInfo.transientTasks[index].requestId, &napiRequestId);
    76.             napi_set_named_property(env, napiWork, "requestId", napiRequestId);
    77. 

    78.             napi_value napiActualDelayTime = nullptr;
    79.             napi_create_int32(env, transientTaskInfo.transientTasks[index].actualDelayTime, &napiActualDelayTime);
    80.             napi_set_named_property(env, napiWork, "actualDelayTime", napiActualDelayTime);
    81. 

    82.             napi_set_element(env, info, count, napiWork);
    83.             count++;
    84.         }
    85.         napi_set_named_property(env, result, "transientTasks", info);
    86.     } else {
    87.         napi_create_int32(env, 0, &napiRemainingQuota);
    88.         napi_set_named_property(env, result, "remainingQuota", napiRemainingQuota);
    89.         napi_value info {nullptr};
    90.         napi_create_array(env, &info);
    91.         napi_set_named_property(env, result, "transientTasks", info);
    92.     }
    93.     return result;
    94. }
    napi_init.cpp

  2. 注册函数

    收起
    自动换行
    深色代码主题
    复制
    1. EXTERN_C_START
    2. static napi_value Init(napi_env env, napi_value exports)
    3. {
    4.     napi_property_descriptor desc[] = {
    5.         {"RequestSuspendDelay", nullptr, RequestSuspendDelay, nullptr, nullptr, nullptr, napi_default, nullptr},
    6.         {"GetRemainingDelayTime", nullptr, GetRemainingDelayTime, nullptr, nullptr, nullptr, napi_default, nullptr},
    7.         {"CancelSuspendDelay", nullptr, CancelSuspendDelay, nullptr, nullptr, nullptr, napi_default, nullptr},
    8.         {"GetTransientTaskInfo", nullptr, GetTransientTaskInfo, nullptr, nullptr, nullptr, napi_default, nullptr },
    9.     };
    10.     napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
    11.     return exports;
    12. }
    13. EXTERN_C_END
    napi_init.cpp

  3. 注册模块

    收起
    自动换行
    深色代码主题
    复制
    1. static napi_module demoModule = {
    2.     .nm_version = 1,
    3.     .nm_flags = 0,
    4.     .nm_filename = nullptr,
    5.     .nm_register_func = Init,
    6.     .nm_modname = "entry",
    7.     .nm_priv = ((void*)0),
    8.     .reserved = { 0 },
    9. };
    10. 

    11. extern "C" __attribute__((constructor)) void RegisterEntryModule(void)
    12. {
    13.     napi_module_register(&demoModule);
    14. }
    napi_init.cpp

在index.d.ts文件中声明函数

收起
自动换行
深色代码主题
复制
  1. import backgroundTaskManager from '@kit.BackgroundTasksKit';
  2. 

  3. export const RequestSuspendDelay: () => number;
  4. export const GetRemainingDelayTime: () => number;
  5. export const CancelSuspendDelay: () => number;
  6. export const GetTransientTaskInfo: () => backgroundTaskManager.TransientTaskInfo;
Index.d.ts

在index.ets文件中调用函数

收起
自动换行
深色代码主题
复制
  1. import testTransientTask from 'libentry.so';
  2. 

  3. @Entry
  4. @Component
  5. struct Index {
  6.   @State message: string = '';
  7.   // ...
  8. 

  9.   build() {
  10.     Row() {
  11.       Column() {
  12.         // ...
  13.         Text(this.message)
  14.           .fontSize(50)
  15.           .fontWeight(FontWeight.Bold)
  16.         Button() {
  17.           Text("RequestSuspendDelay").fontSize(20)
  18.         }
  19.         .id('request_suspend_delay')
  20.         .margin({ top: 10, bottom: 10 })
  21.         .width(250)
  22.         .height(40)
  23.         .backgroundColor('#0D9FFB')
  24.         .onClick(() => {
  25.           this.RequestSuspendDelay();
  26.         })
  27. 

  28.         Button(){
  29.           Text('GetRemainingDelayTime').fontSize(20)
  30.         }
  31.         .id('get_remaining_delay_time')
  32.         .margin({ top: 10, bottom: 10 })
  33.         .width(250)
  34.         .height(40)
  35.         .backgroundColor('#0D9FFB')
  36.         .onClick(() => {
  37.           this.GetRemainingDelayTime();
  38.         })
  39. 

  40.         Button(){
  41.           Text('CancelSuspendDelay').fontSize(20)
  42.         }
  43.         .id('cancel_suspend_delay')
  44.         .margin({ top: 10, bottom: 10 })
  45.         .width(250)
  46.         .height(40)
  47.         .backgroundColor('#0D9FFB')
  48.         .onClick(() => {
  49.           this.CancelSuspendDelay();
  50.         })
  51. 

  52.         Button(){
  53.           Text('GetTransientTaskInfo').fontSize(20)
  54.         }
  55.         .id('get_transient_task_info')
  56.         .margin({ top: 10, bottom: 10 })
  57.         .width(250)
  58.         .height(40)
  59.         .backgroundColor('#0D9FFB')
  60.         .onClick(() => {
  61.           this.GetTransientTaskInfo();
  62.         })
  63.       }
  64.       .width('100%')
  65.     }
  66.     .height('100%')
  67.   }
  68. 

  69.   RequestSuspendDelay() {
  70.     let requestId = testTransientTask.RequestSuspendDelay();
  71.     // ...
  72.     console.info('The returned requestId is ' + requestId);
  73.   }
  74. 

  75.   GetRemainingDelayTime() {
  76.     let time = testTransientTask.GetRemainingDelayTime();
  77.     console.info('The time is ' + time);
  78.   }
  79. 

  80.   CancelSuspendDelay() {
  81.     let result = testTransientTask.CancelSuspendDelay();
  82.     console.info('The return value is ' + result);
  83.   }
  84. 

  85.   GetTransientTaskInfo() {
  86.     let info = testTransientTask.GetTransientTaskInfo();
  87.     console.info('The transientTaskInfo is ' + JSON.stringify(info));
  88.   }
  89. }
Index.ets

配置库依赖

配置CMakeLists.txt，本模块需要用到的共享库是libtransient_task.so，在工程自动生成的CMakeLists.txt中的target_link_libraries中添加此共享库。

收起
自动换行
深色代码主题
复制
  1. target_link_libraries(entry PUBLIC libace_napi.z.so libtransient_task.so)
CMakeLists.txt

测试步骤

  1. 连接设备并运行程序。

  2. 点击 申请短时任务 按钮，控制台会打印日志，示例如下：

    收起
    自动换行
    深色代码主题
    复制
    1. The returned requestId is 1

  3. 点击 获取剩余时间 按钮，控制台会打印日志，示例如下：

    收起
    自动换行
    深色代码主题
    复制
    1. The time is 18000

  4. 点击 取消短时任务 按钮，控制台会打印日志，示例如下：

    收起
    自动换行
    深色代码主题
    复制
    1. The return value is 0

  5. 点击 获取所有短时任务信息 按钮，控制台会打印日志，示例如下：

    收起
    自动换行
    深色代码主题
    复制
    1. The transientTaskInfo is {"remainingQuota":600000,"transientTasks":[]}
短时任务(ArkTS)
长时任务(ArkTS)
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明