From eda76fa3b48eb4d6e5c8e52a33b90cc8c8b6e63f Mon Sep 17 00:00:00 2001 From: pdf001 <1626385780@qq.com> Date: Fri, 4 Jul 2025 06:44:06 +0000 Subject: [PATCH 1/9] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E6=A8=A1=E5=9D=97?= =?UTF-8?q?=E3=80=90TransientTask=E3=80=91?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: pdf001 <1626385780@qq.com> --- .../_transient_task.md | 184 ------------------ .../capi-transienttask.md | 13 ++ 2 files changed, 13 insertions(+), 184 deletions(-) delete mode 100644 zh-cn/application-dev/reference/apis-backgroundtasks-kit/_transient_task.md create mode 100644 zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transienttask.md diff --git a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/_transient_task.md b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/_transient_task.md deleted file mode 100644 index 8b7aaa3f283..00000000000 --- a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/_transient_task.md +++ /dev/null @@ -1,184 +0,0 @@ -# TransientTask - -## 概述 - -提供短时任务C接口。 - -**起始版本：** 13 - -## 汇总 - - -### 文件 - -| 名称 | 描述 | -| -------- | -------- | -| [transient_task_api.h](transient__task__api_8h.md) | 提供短时任务申请、查询、取消功能。 | -| [transient_task_type.h](transient__task__type_8h.md) | 定义短时任务的错误码和结构体。 | - - -### 结构体 - -| 名称 | 描述 | -| -------- | -------- | -| struct  [TransientTask_DelaySuspendInfo](_transient_task___delay_suspend_info.md) | 定义短时任务返回信息结构体。 | - - -### 类型定义 - -| 名称 | 描述 | -| -------- | -------- | -| typedef enum [TransientTask_ErrorCode](#transienttask_errorcode) [TransientTask_ErrorCode](#transienttask_errorcode) | 定义短时任务错误码。 | -| typedef struct [TransientTask_DelaySuspendInfo](_transient_task___delay_suspend_info.md) [TransientTask_DelaySuspendInfo](_transient_task___delay_suspend_info.md)| 定义短时任务返回信息结构体。 | -| typedef void(\* [TransientTask_Callback](#transienttask_callback)) (void) | 定义短时任务超时回调类型。 | - - -### 枚举 - -| 名称 | 描述 | -| -------- | -------- | -| [TransientTask_ErrorCode](#transienttask_errorcode) {
ERR_TRANSIENT_TASK_OK = 0, ERR_TRANSIENT_TASK_INVALID_PARAM = 401, ERR_TRANSIENT_TASK_PARCEL_FAILED = 9800002, ERR_TRANSIENT_TASK_TRANSACTION_FAILED = 9800003,
ERR_TRANSIENT_TASK_SYS_NOT_READY = 9800004, ERR_TRANSIENT_TASK_CLIENT_INFO_VERIFICATION_FAILED = 9900001, ERR_TRANSIENT_TASK_SERVICE_VERIFICATION_FAILED = 9900002
} | 定义短时任务错误码。 | - - -### 函数 - -| 名称 | 描述 | -| -------- | -------- | -| int32_t [OH_BackgroundTaskManager_RequestSuspendDelay](#oh_backgroundtaskmanager_requestsuspenddelay) (const char \*reason, [TransientTask_Callback](#transienttask_callback) callback, [TransientTask_DelaySuspendInfo](_transient_task___delay_suspend_info.md) \*info) | 申请短时任务。 | -| int32_t [OH_BackgroundTaskManager_GetRemainingDelayTime](#oh_backgroundtaskmanager_getremainingdelaytime) (int32_t requestId, int32_t \*delayTime) | 获取本次短时任务的剩余时间。 | -| int32_t [OH_BackgroundTaskManager_CancelSuspendDelay](#oh_backgroundtaskmanager_cancelsuspenddelay) (int32_t requestId) | 取消短时任务。 | - - -## 类型定义说明 - - -### TransientTask_Callback - -``` -typedef void(* TransientTask_Callback) (void) -``` -**描述** -定义短时任务超时回调类型。 - -**起始版本：** 13 - - -### TransientTask_DelaySuspendInfo - -``` -typedef struct TransientTask_DelaySuspendInfo TransientTask_DelaySuspendInfo -``` -**描述** -定义短时任务返回信息结构体。 - -**起始版本：** 13 - - -### TransientTask_ErrorCode - -``` -typedef enum TransientTask_ErrorCode TransientTask_ErrorCode -``` -**描述** -定义短时任务错误码。 - -**起始版本：** 13 - - -## 枚举类型说明 - - -### TransientTask_ErrorCode - -``` -enum TransientTask_ErrorCode -``` -**描述** -定义短时任务错误码。 - -**起始版本：** 13 - -| 枚举值 | 描述 | -| -------- | -------- | -| ERR_TRANSIENT_TASK_OK | \@error 成功。   | -| ERR_TRANSIENT_TASK_INVALID_PARAM | \@error 参数检查失败。可能原因：1.必选参数没有传入。2.参数类型错误。   | -| ERR_TRANSIENT_TASK_PARCEL_FAILED | \@error Parcel读写操作失败。   | -| ERR_TRANSIENT_TASK_TRANSACTION_FAILED | \@error IPC通信失败。   | -| ERR_TRANSIENT_TASK_SYS_NOT_READY | \@error 系统服务失败。   | -| ERR_TRANSIENT_TASK_CLIENT_INFO_VERIFICATION_FAILED | \@error 短时任务客户端信息校验失败。   | -| ERR_TRANSIENT_TASK_SERVICE_VERIFICATION_FAILED | \@error 短时任务服务端校验失败。   | - - -## 函数说明 - - -### OH_BackgroundTaskManager_CancelSuspendDelay() - -``` -int32_t OH_BackgroundTaskManager_CancelSuspendDelay (int32_t requestId) -``` -**描述** -取消短时任务。 - -**系统能力：** SystemCapability.ResourceSchedule.BackgroundTaskManager.TransientTask - -**起始版本：** 13 - -**参数:** - -| 名称 | 描述 | -| -------- | -------- | -| requestId | 短时任务的请求ID。 | - -**返回：** - -返回0，表示取消成功。
返回401，表示入参错误。
返回9800002，表示Parcel读写操作失败。
返回9800003，表示IPC通信失败。
返回9800004，表示系统服务失败。
返回9900001，表示短时任务客户端信息校验失败。
返回9900002，表示短时任务服务端校验失败。
错误码的具体信息请参考[TransientTask_ErrorCode](#transienttask_errorcode)。 - - -### OH_BackgroundTaskManager_GetRemainingDelayTime() - -``` -int32_t OH_BackgroundTaskManager_GetRemainingDelayTime (int32_t requestId, int32_t * delayTime ) -``` -**描述** -获取本次短时任务的剩余时间。 - -**系统能力：** SystemCapability.ResourceSchedule.BackgroundTaskManager.TransientTask - -**起始版本：** 13 - -**参数:** - -| 名称 | 描述 | -| -------- | -------- | -| requestId | 短时任务的请求ID。 | -| delayTime | 短时任务的剩余时间。 | - -**返回：** - -返回0，表示查询成功。
返回401，表示入参错误。
返回9800002，表示Parcel读写操作失败。
返回9800003，表示IPC通信失败。
返回9800004，表示系统服务失败。
返回9900001，表示短时任务客户端信息校验失败。
返回9900002，表示短时任务服务端校验失败。
错误码的具体信息请参考[TransientTask_ErrorCode](#transienttask_errorcode)。 - - -### OH_BackgroundTaskManager_RequestSuspendDelay() - -``` -int32_t OH_BackgroundTaskManager_RequestSuspendDelay (const char * reason, TransientTask_Callback callback, TransientTask_DelaySuspendInfo * info ) -``` -**描述** -申请短时任务。 - -**系统能力：** SystemCapability.ResourceSchedule.BackgroundTaskManager.TransientTask - -**起始版本：** 13 - -**参数:** - -| 名称 | 描述 | -| -------- | -------- | -| reason | 申请短时任务的原因。 | -| callback | 短时任务即将超时的回调，一般在超时前6秒，通过此回调通知应用。 | -| info | 返回短时任务信息。 | - -**返回：** - -返回0，表示申请成功。
返回401，表示入参错误。
返回9800002，表示Parcel读写操作失败。
返回9800003，表示IPC通信失败。
返回9800004，表示系统服务失败。
返回9900001，表示短时任务客户端信息校验失败。
返回9900002，表示短时任务服务端校验失败。
错误码的具体信息请参考[TransientTask_ErrorCode](#transienttask_errorcode)。 diff --git a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transienttask.md b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transienttask.md new file mode 100644 index 00000000000..478c6c16f66 --- /dev/null +++ b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transienttask.md @@ -0,0 +1,13 @@ +# TransientTask + +## 概述 + +提供短时任务C接口。 + +**起始版本：** 13 +## 文件汇总 + +| 名称 | 描述 | +| -- | -- | +| [transient_task_api.h](capi-transient-task-api-h.md) | 提供短时任务申请、查询、取消功能。 | +| [transient_task_type.h](capi-transient-task-type-h.md) | 定义短时任务的错误码和结构体。 | -- Gitee From 012d020f363bfabaccc7d2150afea4c0121a9865 Mon Sep 17 00:00:00 2001 From: pdf001 <1626385780@qq.com> Date: Fri, 4 Jul 2025 06:44:56 +0000 Subject: [PATCH 2/9] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E6=A8=A1=E5=9D=97?= =?UTF-8?q?=E3=80=90BackgroundProcessManager=E3=80=91?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: pdf001 <1626385780@qq.com> --- .../_background_process_manager.md | 155 ------------------ .../capi-backgroundprocessmanager.md | 12 ++ 2 files changed, 12 insertions(+), 155 deletions(-) delete mode 100644 zh-cn/application-dev/reference/apis-backgroundtasks-kit/_background_process_manager.md create mode 100644 zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-backgroundprocessmanager.md diff --git a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/_background_process_manager.md b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/_background_process_manager.md deleted file mode 100644 index 63a69455ffb..00000000000 --- a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/_background_process_manager.md +++ /dev/null @@ -1,155 +0,0 @@ -# BackgroundProcessManager - - -## 概述 - -提供后台子进程调度策略管控C接口。 - -**起始版本：** 17 - - -## 汇总 - - -### 文件 - -| 名称 | 描述 | -| -------- | -------- | -| [background_process_manager.h](background__process__manager_8h.md) | 本模块提供了后台子进程管控接口。开发者可以通过本模块接口对子进程进行压制、解压制，避免子进程过多占用系统资源，导致系统使用卡顿。 本模块接口仅对通过[OH_Ability_StartNativeChildProcess](../apis-ability-kit/c-apis-ability-childprocess.md#oh_ability_startnativechildprocess)接口创建的子进程生效。 | - - -### 类型定义 - -| 名称 | 描述 | -| -------- | -------- | -| typedef enum [BackgroundProcessManager_ProcessPriority](#backgroundprocessmanager_processpriority) [BackgroundProcessManager_ProcessPriority](#backgroundprocessmanager_processpriority) | 子进程压制档位。 | -| typedef enum [BackgroundProcessManager_ErrorCode](#backgroundprocessmanager_errorcode) [BackgroundProcessManager_ErrorCode](#backgroundprocessmanager_errorcode) | 定义后台子进程管控错误码。 | - - -### 枚举 - -| 名称 | 描述 | -| -------- | -------- | -| [BackgroundProcessManager_ProcessPriority](#backgroundprocessmanager_processpriority) { PROCESS_BACKGROUND = 1, PROCESS_INACTIVE = 2 } | 子进程压制档位。 | -| [BackgroundProcessManager_ErrorCode](#backgroundprocessmanager_errorcode) { ERR_BACKGROUND_PROCESS_MANAGER_SUCCESS = 0, ERR_BACKGROUND_PROCESS_MANAGER_INVALID_PARAM = 401, ERR_BACKGROUND_PROCESS_MANAGER_REMOTE_ERROR = 31800001 } | 定义后台子进程管控错误码。 | - - -### 函数 - -| 名称 | 描述 | -| -------- | -------- | -| int [OH_BackgroundProcessManager_SetProcessPriority](#oh_backgroundprocessmanager_setprocesspriority) (int pid, [BackgroundProcessManager_ProcessPriority](#backgroundprocessmanager_processpriority) priority) | 设置子进程的压制档位，子进程被压制后可获得的CPU资源将会受到限制。如果主进程调度策略发生变化，如从后台切至前台等，子进程会跟随主进程一同变化，子进程如需继续压制，需要重新调用本接口。 | -| int [OH_BackgroundProcessManager_ResetProcessPriority](#oh_backgroundprocessmanager_resetprocesspriority) (int pid) | 为子进程解压制，即子进程策略恢复为主进程调度策略。若主进程调度策略发生变化，如从后台切至前台等，子进程会跟随主进程一同变化，等效于执行一次resetProcessPriority动作。 | - - -## 类型定义说明 - - -### BackgroundProcessManager_ErrorCode - -``` -typedef enum BackgroundProcessManager_ErrorCodeBackgroundProcessManager_ErrorCode -``` -**描述** - -定义后台子进程管控错误码。 - -**起始版本：** 17 - - -### BackgroundProcessManager_ProcessPriority - -``` -typedef enum BackgroundProcessManager_ProcessPriorityBackgroundProcessManager_ProcessPriority -``` -**描述** - -子进程压制档位。 - -**起始版本：** 17 - - -## 枚举类型说明 - - -### BackgroundProcessManager_ErrorCode - -``` -enum BackgroundProcessManager_ErrorCode -``` -**描述** - -定义后台子进程管控错误码。 - -**起始版本：** 17 - -| 枚举值 | 描述 | -| -------- | -------- | -| ERR_BACKGROUND_PROCESS_MANAGER_SUCCESS | 压制参数发送成功。 | -| ERR_BACKGROUND_PROCESS_MANAGER_INVALID_PARAM | 参数检查失败。 | -| ERR_BACKGROUND_PROCESS_MANAGER_REMOTE_ERROR | 客户端进程请求系统服务进程，获取系统服务操作失败。 | - - -### BackgroundProcessManager_ProcessPriority - -``` -enum BackgroundProcessManager_ProcessPriority -``` -**描述** - -子进程压制档位。 - -**起始版本：** 17 - -| 枚举值 | 描述 | -| -------- | -------- | -| PROCESS_BACKGROUND | 该档位相较PROCESS_INACTIVE压制效果更显著，获取到的CPU资源更少。推荐执行处于后台的图文页面等用户无感知业务的后台子进程时设置该档位。   | -| PROCESS_INACTIVE | 推荐正在执行播放音频、导航等用户可感知业务的后台子进程时设置该档位。   | - - -## 函数说明 - - -### OH_BackgroundProcessManager_ResetProcessPriority() - -``` -int OH_BackgroundProcessManager_ResetProcessPriority (int pid) -``` -**描述** - -为子进程解压制，即子进程策略恢复为主进程调度策略。若主进程调度策略发生变化，如从后台切至前台等， 子进程会跟随主进程一同变化，等效于执行一次resetProcessPriority动作。 - -**起始版本：** 17 - -**参数:** - -| 名称 | 描述 | -| -------- | -------- | -| pid | 子进程的进程号，[OH_Ability_StartNativeChildProcess](../apis-ability-kit/c-apis-ability-childprocess.md#oh_ability_startnativechildprocess)接口创建子进程后的pid参数，即为子进程进程号。 | - -**返回：** - -返回执行的错误码。错误码定义详见[BackgroundProcessManager_ErrorCode](#backgroundprocessmanager_errorcode)。返回 ERR_BACKGROUND_PROCESS_MANAGER_SUCCESS，表示压制参数发送成功。 返回 ERR_BACKGROUND_PROCESS_MANAGER_REMOTE_ERROR，表示客户端进程请求系统服务进程，获取系统服务操作失败。 - - -### OH_BackgroundProcessManager_SetProcessPriority() - -``` -int OH_BackgroundProcessManager_SetProcessPriority (int pid, BackgroundProcessManager_ProcessPriority priority ) -``` -**描述** - -设置子进程的压制档位，子进程被压制后可获得的CPU资源将会受到限制。如果主进程调度策略发生变化，如从后台切至前台等，子进程会跟随主进程一同变化，子进程如需继续压制，需要重新调用本接口。 - -**起始版本：** 17 - -**参数:** - -| 名称 | 描述 | -| -------- | -------- | -| pid | 需要被压制子进程的进程号，[OH_Ability_StartNativeChildProcess](../apis-ability-kit/c-apis-ability-childprocess.md#oh_ability_startnativechildprocess)接口创建子进程后的pid参数，即为子进程进程号。 | -| priority | 压制档位。 | - -**返回：** - -返回执行的错误码。错误码定义详见[BackgroundProcessManager_ErrorCode](#backgroundprocessmanager_errorcode)。返回 ERR_BACKGROUND_PROCESS_MANAGER_SUCCESS，表示压制参数发送成功。 返回 ERR_BACKGROUND_PROCESS_MANAGER_INVALID_PARAM，表示参数检查失败。 返回 ERR_BACKGROUND_PROCESS_MANAGER_REMOTE_ERROR，表示客户端进程请求系统服务进程，获取系统服务操作失败。 diff --git a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-backgroundprocessmanager.md b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-backgroundprocessmanager.md new file mode 100644 index 00000000000..4932328954a --- /dev/null +++ b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-backgroundprocessmanager.md @@ -0,0 +1,12 @@ +# BackgroundProcessManager + +## 概述 + +提供后台子进程调度策略管控C接口。 + +**起始版本：** 17 +## 文件汇总 + +| 名称 | 描述 | +| -- | -- | +| [background_process_manager.h](capi-background-process-manager-h.md) | 本模块提供了后台子进程管控接口。开发者可以通过本模块接口对子进程进行压制、解压制，避免子进程过多占用系统资源，导致系统使用卡顿。本模块接口仅对通过OH_Ability_StartNativeChildProcess接口创建的子进程生效。 | -- Gitee From 2f4eac16a4ec24d71d7f6591c66e4e19ddf6c3af Mon Sep 17 00:00:00 2001 From: pdf001 <1626385780@qq.com> Date: Fri, 4 Jul 2025 06:45:47 +0000 Subject: [PATCH 3/9] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E5=A4=B4=E6=96=87?= =?UTF-8?q?=E4=BB=B6=E3=80=90transient=5Ftask=5Fapi.h=E3=80=91?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: pdf001 <1626385780@qq.com> --- .../capi-transient-task-api-h.md | 139 ++++++++++++++++++ .../transient__task__api_8h.md | 26 ---- 2 files changed, 139 insertions(+), 26 deletions(-) create mode 100644 zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transient-task-api-h.md delete mode 100644 zh-cn/application-dev/reference/apis-backgroundtasks-kit/transient__task__api_8h.md diff --git a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transient-task-api-h.md b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transient-task-api-h.md new file mode 100644 index 00000000000..d9662920465 --- /dev/null +++ b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transient-task-api-h.md @@ -0,0 +1,139 @@ +# transient_task_api.h + +## 概述 + +提供短时任务申请、查询、取消功能。 + +**引用文件：** + +**库：** libtransient_task.so + +**系统能力：** SystemCapability.ResourceSchedule.BackgroundTaskManager.TransientTask + +**起始版本：** 13 + +**相关模块：** [TransientTask](capi-transienttask.md) + +## 汇总 + +### 函数 + +| 名称 | 描述 | +| -- | -- | +| [int32_t OH_BackgroundTaskManager_RequestSuspendDelay(const char* reason,TransientTask_Callback callback, TransientTask_DelaySuspendInfo *info)](#oh_backgroundtaskmanager_requestsuspenddelay) | 申请短时任务。 | +| [int32_t OH_BackgroundTaskManager_GetRemainingDelayTime(int32_t requestId, int32_t *delayTime)](#oh_backgroundtaskmanager_getremainingdelaytime) | 获取本次短时任务的剩余时间。 | +| [int32_t OH_BackgroundTaskManager_CancelSuspendDelay(int32_t requestId)](#oh_backgroundtaskmanager_cancelsuspenddelay) | 取消短时任务。 | +| [int32_t OH_BackgroundTaskManager_GetTransientTaskInfo(TransientTask_TransientTaskInfo *transientTaskInfo)](#oh_backgroundtaskmanager_gettransienttaskinfo) | 获取所有短时任务信息，如当日剩余总配额等。 | + +## 函数说明 + +### OH_BackgroundTaskManager_RequestSuspendDelay() + +``` +int32_t OH_BackgroundTaskManager_RequestSuspendDelay(const char* reason,TransientTask_Callback callback, TransientTask_DelaySuspendInfo *info) +``` + +**描述** + +申请短时任务。 + +**系统能力：** SystemCapability.ResourceSchedule.BackgroundTaskManager.TransientTask + +**起始版本：** 13 + + +**参数：** + +| 参数项 | 描述 | +|----------------------------------------------------------------------------------------------| -- | +| const char* reason | 申请短时任务的原因。 | +| [TransientTask_Callback](capi-transient-task-type-h.md#transienttask_callback) callback | 短时任务即将超时的回调，一般在超时前6秒，通过此回调通知应用。 | +| [TransientTask_DelaySuspendInfo](capi-transienttask-transienttask-delaysuspendinfo.md) *info | 返回短时任务信息。 | + +**返回：** + +| 类型 | 说明 | +| -- | -- | +| int32_t | 返回0，表示申请成功。
返回401，表示入参错误。
返回9800002，表示Parcel读写操作失败。
返回9800003，表示IPC通信失败。
返回9800004，表示系统服务失败。
返回9900001，表示短时任务客户端信息校验失败。
返回9900002，表示短时任务服务端校验失败。
错误码的具体信息请参考[TransientTask_ErrorCode](capi-transient-task-type-h.md#transienttask_errorcode)。 | + +### OH_BackgroundTaskManager_GetRemainingDelayTime() + +``` +int32_t OH_BackgroundTaskManager_GetRemainingDelayTime(int32_t requestId, int32_t *delayTime) +``` + +**描述** + +获取本次短时任务的剩余时间。 + +**系统能力：** SystemCapability.ResourceSchedule.BackgroundTaskManager.TransientTask + +**起始版本：** 13 + + +**参数：** + +| 参数项 | 描述 | +| -- | -- | +| int32_t requestId | 短时任务的请求ID。 | +| int32_t *delayTime | 短时任务的剩余时间。 | + +**返回：** + +| 类型 | 说明 | +| -- | -- | +| int32_t | 返回0，表示查询成功。
返回401，表示入参错误。
返回9800002，表示Parcel读写操作失败。
返回9800003，表示IPC通信失败。
返回9800004，表示系统服务失败。
返回9900001，表示短时任务客户端信息校验失败。
返回9900002，表示短时任务服务端校验失败。
错误码的具体信息请参考[TransientTask_ErrorCode](capi-transient-task-type-h.md#transienttask_errorcode)。 | + +### OH_BackgroundTaskManager_CancelSuspendDelay() + +``` +int32_t OH_BackgroundTaskManager_CancelSuspendDelay(int32_t requestId) +``` + +**描述** + +取消短时任务。 + +**系统能力：** SystemCapability.ResourceSchedule.BackgroundTaskManager.TransientTask + +**起始版本：** 13 + + +**参数：** + +| 参数项 | 描述 | +| -- | -- | +| int32_t requestId | 短时任务的请求ID。 | + +**返回：** + +| 类型 | 说明 | +| -- | -- | +| int32_t | 返回0，表示取消成功。
返回401，表示入参错误。
返回9800002，表示Parcel读写操作失败。
返回9800003，表示IPC通信失败。
返回9800004，表示系统服务失败。
返回9900001，表示短时任务客户端信息校验失败。
返回9900002，表示短时任务服务端校验失败。
错误码的具体信息请参考[TransientTask_ErrorCode](capi-transient-task-type-h.md#transienttask_errorcode)。 | + +### OH_BackgroundTaskManager_GetTransientTaskInfo() + +``` +int32_t OH_BackgroundTaskManager_GetTransientTaskInfo(TransientTask_TransientTaskInfo *transientTaskInfo) +``` + +**描述** + +获取所有短时任务信息，如当日剩余总配额等。 + +**起始版本：** 20 + + +**参数：** + +| 参数项 | 描述 | +|--------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------| +| [TransientTask_TransientTaskInfo ](capi-transienttask-transienttask-transienttaskinfo.md) *transientTaskInfo | 所有短时任务信息，具体请参考[TransientTask_TransientTaskInfo](capi-transienttask-transienttask-transienttaskinfo.md)。 | + +**返回：** + +| 类型 | 说明 | +| -- | -- | +| int32_t | 返回0，表示获取成功。
返回9900001，表示短时任务客户端信息校验失败。
返回9900003，表示Parcel读写操作失败。
返回9900004，表示系统服务失败。
错误码的具体信息请参考[TransientTask_ErrorCode](capi-transient-task-type-h.md#transienttask_errorcode)。 | + + diff --git a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/transient__task__api_8h.md b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/transient__task__api_8h.md deleted file mode 100644 index d54c26e4380..00000000000 --- a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/transient__task__api_8h.md +++ /dev/null @@ -1,26 +0,0 @@ -# transient_task_api.h - - -## 概述 - -提供短时任务申请、查询、取消功能。 - -**库：** libtransient_task.so - -**系统能力：** SystemCapability.ResourceSchedule.BackgroundTaskManager.TransientTask - -**起始版本：** 13 - -**相关模块：**[TransientTask](_transient_task.md) - - -## 汇总 - - -### 函数 - -| 名称 | 描述 | -| -------- | -------- | -| int32_t [OH_BackgroundTaskManager_RequestSuspendDelay](_transient_task.md#oh_backgroundtaskmanager_requestsuspenddelay) (const char \*reason, [TransientTask_Callback](_transient_task.md#transienttask_callback) callback, [TransientTask_DelaySuspendInfo](_transient_task___delay_suspend_info.md) \*info) | 申请短时任务。 | -| int32_t [OH_BackgroundTaskManager_GetRemainingDelayTime](_transient_task.md#oh_backgroundtaskmanager_getremainingdelaytime) (int32_t requestId, int32_t \*delayTime) | 获取本次短时任务的剩余时间。 | -| int32_t [OH_BackgroundTaskManager_CancelSuspendDelay](_transient_task.md#oh_backgroundtaskmanager_cancelsuspenddelay) (int32_t requestId) | 取消短时任务。 | \ No newline at end of file -- Gitee From 223662c48481344c52e10414dd0f201050afa8c3 Mon Sep 17 00:00:00 2001 From: pdf001 <1626385780@qq.com> Date: Fri, 4 Jul 2025 06:46:36 +0000 Subject: [PATCH 4/9] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E5=A4=B4=E6=96=87?= =?UTF-8?q?=E4=BB=B6=E3=80=90transient=5Ftask=5Ftype.h=E3=80=91?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: pdf001 <1626385780@qq.com> --- .../capi-transient-task-type-h.md | 79 +++++++++++++++++++ .../transient__task__type_8h.md | 40 ---------- 2 files changed, 79 insertions(+), 40 deletions(-) create mode 100644 zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transient-task-type-h.md delete mode 100644 zh-cn/application-dev/reference/apis-backgroundtasks-kit/transient__task__type_8h.md diff --git a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transient-task-type-h.md b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transient-task-type-h.md new file mode 100644 index 00000000000..6be304790f0 --- /dev/null +++ b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transient-task-type-h.md @@ -0,0 +1,79 @@ +# transient_task_type.h + +## 概述 + +定义短时任务的错误码和结构体。 + +**引用文件：** + +**库：** libtransient_task.so + +**系统能力：** SystemCapability.ResourceSchedule.BackgroundTaskManager.TransientTask + +**起始版本：** 13 + +**相关模块：** [TransientTask](capi-transienttask.md) + +## 汇总 + +### 结构体 + +| 名称 | typedef关键字 | 描述 | +|------------------------------------------------------------------------------------------| -- | -- | +| [TransientTask_DelaySuspendInfo](capi-transienttask-transienttask-delaysuspendinfo.md) | TransientTask_DelaySuspendInfo | 定义短时任务返回信息结构体。 | +| [TransientTask_TransientTaskInfo](capi-transienttask-transienttask-transienttaskinfo.md) | TransientTask_TransientTaskInfo | 定义所有短时任务信息结构体。 | + +### 枚举 + +| 名称 | typedef关键字 | 描述 | +| -- | -- | -- | +| [TransientTask_ErrorCode](#transienttask_errorcode) | TransientTask_ErrorCode | 定义短时任务错误码。 | + +### 函数 + +| 名称 | typedef关键字 | 描述 | +| -- | -- | -- | +| [typedef void (\*TransientTask_Callback)(void)](#transienttask_callback) | TransientTask_Callback | 定义短时任务超时回调类型。 | + +## 枚举类型说明 + +### TransientTask_ErrorCode + +``` +enum TransientTask_ErrorCode +``` + +**描述** + +定义短时任务错误码。 + +**起始版本：** 13 + +| 枚举项 | 描述 | +| -- | -- | +| ERR_TRANSIENT_TASK_OK = 0 | 成功。 | +| ERR_TRANSIENT_TASK_INVALID_PARAM = 401 | 参数检查失败。可能原因：1.必选参数没有传入。2.参数类型错误。 | +| ERR_TRANSIENT_TASK_PARCEL_FAILED = 9800002 | Parcel读写操作失败。 | +| ERR_TRANSIENT_TASK_TRANSACTION_FAILED = 9800003 | IPC通信失败。 | +| ERR_TRANSIENT_TASK_SYS_NOT_READY = 9800004 | 系统服务失败。 | +| ERR_TRANSIENT_TASK_CLIENT_INFO_VERIFICATION_FAILED = 9900001 | 短时任务客户端信息校验失败。 | +| ERR_TRANSIENT_TASK_SERVICE_VERIFICATION_FAILED = 9900002 | 短时任务服务端校验失败。 | +| ERR_TRANSIENT_TASK_PARCELABLE_FAILED = 9900003 | 短时任务Parcel读写操作失败。可能原因：1.参数非法。2.申请内存失败。 | +| ERR_TRANSIENT_TASK_SERVICE_NOT_READY = 9900004 | 短时任务系统服务失败。 | + + +## 函数说明 + +### TransientTask_Callback() + +``` +typedef void (*TransientTask_Callback)(void) +``` + +**描述** + +定义短时任务超时回调类型。 + +**起始版本：** 13 + + diff --git a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/transient__task__type_8h.md b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/transient__task__type_8h.md deleted file mode 100644 index 8e2993043d1..00000000000 --- a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/transient__task__type_8h.md +++ /dev/null @@ -1,40 +0,0 @@ -# transient_task_type.h - - -## 概述 - -定义短时任务的错误码和结构体。 - -**库：** libtransient_task.so - -**系统能力：** SystemCapability.ResourceSchedule.BackgroundTaskManager.TransientTask - -**起始版本：** 13 - -**相关模块：**[TransientTask](_transient_task.md) - - -## 汇总 - - -### 结构体 - -| 名称 | 描述 | -| -------- | -------- | -| struct  [TransientTask_DelaySuspendInfo](_transient_task___delay_suspend_info.md) | 定义短时任务返回信息结构体。 | - - -### 类型定义 - -| 名称 | 描述 | -| -------- | -------- | -| typedef enum [TransientTask_ErrorCode](_transient_task.md#transienttask_errorcode) [TransientTask_ErrorCode](_transient_task.md#transienttask_errorcode) | 定义短时任务错误码。 | -| typedef struct [TransientTask_DelaySuspendInfo](_transient_task___delay_suspend_info.md) [TransientTask_DelaySuspendInfo](_transient_task.md#transienttask_delaysuspendinfo) | 定义短时任务返回信息结构体。 | -| typedef void(\* [TransientTask_Callback](_transient_task.md#transienttask_callback)) (void) | 定义短时任务超时回调类型。 | - - -### 枚举 - -| 名称 | 描述 | -| -------- | -------- | -| [TransientTask_ErrorCode](_transient_task.md#transienttask_errorcode) {
[ERR_TRANSIENT_TASK_OK](_transient_task.md) = 0, [ERR_TRANSIENT_TASK_INVALID_PARAM](_transient_task.md) = 401, [ERR_TRANSIENT_TASK_PARCEL_FAILED](_transient_task.md) = 9800002, [ERR_TRANSIENT_TASK_TRANSACTION_FAILED](_transient_task.md) = 9800003,
[ERR_TRANSIENT_TASK_SYS_NOT_READY](_transient_task.md) = 9800004, [ERR_TRANSIENT_TASK_CLIENT_INFO_VERIFICATION_FAILED](_transient_task.md) = 9900001, [ERR_TRANSIENT_TASK_SERVICE_VERIFICATION_FAILED](_transient_task.md) = 9900002
} | 定义短时任务错误码。 | -- Gitee From 6b115a79678cd371376850866440378d0c814cc4 Mon Sep 17 00:00:00 2001 From: pdf001 <1626385780@qq.com> Date: Fri, 4 Jul 2025 06:47:25 +0000 Subject: [PATCH 5/9] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E5=A4=B4=E6=96=87?= =?UTF-8?q?=E4=BB=B6=E3=80=90background=5Fprocess=5Fmanager.h=E3=80=91?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: pdf001 <1626385780@qq.com> --- .../background__process__manager_8h.md | 41 ------ .../capi-background-process-manager-h.md | 124 ++++++++++++++++++ 2 files changed, 124 insertions(+), 41 deletions(-) delete mode 100644 zh-cn/application-dev/reference/apis-backgroundtasks-kit/background__process__manager_8h.md create mode 100644 zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-background-process-manager-h.md diff --git a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/background__process__manager_8h.md b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/background__process__manager_8h.md deleted file mode 100644 index cf2e4af497f..00000000000 --- a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/background__process__manager_8h.md +++ /dev/null @@ -1,41 +0,0 @@ -# background_process_manager.h - - -## 概述 - -本模块提供了后台子进程管控接口。开发者可以通过本模块接口对子进程进行压制、解压制，避免子进程过多占用系统资源，导致系统使用卡顿。 本模块接口仅对通过[OH_Ability_StartNativeChildProcess](../apis-ability-kit/c-apis-ability-childprocess.md#oh_ability_startnativechildprocess)接口创建的子进程生效。 - -**库：** libbackground_process_manager.z.so - -**系统能力：** SystemCapability.Resourceschedule.BackgroundProcessManager - -**起始版本：** 17 - -**相关模块：**[BackgroundProcessManager](_background_process_manager.md) - - -## 汇总 - - -### 类型定义 - -| 名称 | 描述 | -| -------- | -------- | -| typedef enum [BackgroundProcessManager_ProcessPriority](_background_process_manager.md#backgroundprocessmanager_processpriority) [BackgroundProcessManager_ProcessPriority](_background_process_manager.md#backgroundprocessmanager_processpriority) | 子进程压制档位。 | -| typedef enum [BackgroundProcessManager_ErrorCode](_background_process_manager.md#backgroundprocessmanager_errorcode) [BackgroundProcessManager_ErrorCode](_background_process_manager.md#backgroundprocessmanager_errorcode) | 定义后台子进程管控错误码。 | - - -### 枚举 - -| 名称 | 描述 | -| -------- | -------- | -| [BackgroundProcessManager_ProcessPriority](_background_process_manager.md#backgroundprocessmanager_processpriority) { [PROCESS_BACKGROUND](_background_process_manager.md) = 1, [PROCESS_INACTIVE](_background_process_manager.md) = 2 } | 子进程压制档位。 | -| [BackgroundProcessManager_ErrorCode](_background_process_manager.md#backgroundprocessmanager_errorcode) { [ERR_BACKGROUND_PROCESS_MANAGER_SUCCESS](_background_process_manager.md) = 0, [ERR_BACKGROUND_PROCESS_MANAGER_INVALID_PARAM](_background_process_manager.md) = 401, [ERR_BACKGROUND_PROCESS_MANAGER_REMOTE_ERROR](_background_process_manager.md) = 31800001 } | 定义后台子进程管控错误码。 | - - -### 函数 - -| 名称 | 描述 | -| -------- | -------- | -| int [OH_BackgroundProcessManager_SetProcessPriority](_background_process_manager.md#oh_backgroundprocessmanager_setprocesspriority) (int pid, [BackgroundProcessManager_ProcessPriority](_background_process_manager.md#backgroundprocessmanager_processpriority) priority) | 设置子进程的压制档位，子进程被压制后可获得的CPU资源将会受到限制。如果主进程调度策略发生变化，如从后台切至前台等， 子进程会跟随主进程一同变化，子进程如需继续压制，需要重新调用本接口。 | -| int [OH_BackgroundProcessManager_ResetProcessPriority](_background_process_manager.md#oh_backgroundprocessmanager_resetprocesspriority) (int pid) | 为子进程解压制，即子进程策略恢复为主进程调度策略。若主进程调度策略发生变化，如从后台切至前台等， 子进程会跟随主进程一同变化，等效于执行一次resetProcessPriority动作。 | diff --git a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-background-process-manager-h.md b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-background-process-manager-h.md new file mode 100644 index 00000000000..bde696560b8 --- /dev/null +++ b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-background-process-manager-h.md @@ -0,0 +1,124 @@ +# background_process_manager.h + +## 概述 + +本模块提供了后台子进程管控接口。开发者可以通过本模块接口对子进程进行压制、解压制，避免子进程过多占用系统资源，导致系统使用卡顿。本模块接口仅对通过OH_Ability_StartNativeChildProcess接口创建的子进程生效。 + +**引用文件：** + +**库：** libbackground_process_manager.z.so + +**系统能力：** SystemCapability.Resourceschedule.BackgroundProcessManager + +**起始版本：** 17 + +**相关模块：** [BackgroundProcessManager](capi-backgroundprocessmanager.md) + +## 汇总 + +### 枚举 + +| 名称 | typedef关键字 | 描述 | +| -- | -- | -- | +| [BackgroundProcessManager_ProcessPriority](#backgroundprocessmanager_processpriority) | BackgroundProcessManager_ProcessPriority | 子进程压制档位。 | +| [BackgroundProcessManager_ErrorCode](#backgroundprocessmanager_errorcode) | BackgroundProcessManager_ErrorCode | 定义后台子进程管控错误码。 | + +### 函数 + +| 名称 | 描述 | +| -- | -- | +| [int OH_BackgroundProcessManager_SetProcessPriority(int pid, BackgroundProcessManager_ProcessPriority priority)](#oh_backgroundprocessmanager_setprocesspriority) | 设置子进程的压制档位，子进程被压制后可获得的CPU资源将会受到限制。如果主进程调度策略发生变化，如从后台切至前台等，子进程会跟随主进程一同变化，子进程如需继续压制，需要重新调用本接口。 | +| [int OH_BackgroundProcessManager_ResetProcessPriority(int pid)](#oh_backgroundprocessmanager_resetprocesspriority) | 为子进程解压制，即子进程策略恢复为主进程调度策略。若主进程调度策略发生变化，如从后台切至前台等，子进程会跟随主进程一同变化，等效于执行一次resetProcessPriority动作。 | + +## 枚举类型说明 + +### BackgroundProcessManager_ProcessPriority + +``` +enum BackgroundProcessManager_ProcessPriority +``` + +**描述** + +子进程压制档位。 + +**起始版本：** 17 + +| 枚举项 | 描述 | +| -- | -- | +| PROCESS_BACKGROUND = 1 | 该档位相较PROCESS_INACTIVE压制效果更显著，获取到的CPU资源更少。推荐执行处于后台的图文页面等用户无感知业务的后台子进程时设置该档位。 | +| PROCESS_INACTIVE = 2 | 推荐正在执行播放音频、导航等用户可感知业务的后台子进程时设置该档位。 | + +### BackgroundProcessManager_ErrorCode + +``` +enum BackgroundProcessManager_ErrorCode +``` + +**描述** + +定义后台子进程管控错误码。 + +**起始版本：** 17 + +| 枚举项 | 描述 | +| -- | -- | +| ERR_BACKGROUND_PROCESS_MANAGER_SUCCESS = 0 | 压制参数发送成功。 | +| ERR_BACKGROUND_PROCESS_MANAGER_INVALID_PARAM = 401 | 参数检查失败。 | +| ERR_BACKGROUND_PROCESS_MANAGER_REMOTE_ERROR = 31800001 | 客户端进程请求系统服务进程，获取系统服务操作失败。 | + + +## 函数说明 + +### OH_BackgroundProcessManager_SetProcessPriority() + +``` +int OH_BackgroundProcessManager_SetProcessPriority(int pid, BackgroundProcessManager_ProcessPriority priority) +``` + +**描述** + +设置子进程的压制档位，子进程被压制后可获得的CPU资源将会受到限制。如果主进程调度策略发生变化，如从后台切至前台等，子进程会跟随主进程一同变化，子进程如需继续压制，需要重新调用本接口。 + +**起始版本：** 17 + + +**参数：** + +| 参数项 | 描述 | +| -- | -- | +| int pid | 需要被压制子进程的进程号，OH_Ability_StartNativeChildProcess接口创建子进程后的pid参数，即为子进程进程号。 | +| [BackgroundProcessManager_ProcessPriority](capi-background-process-manager-h.md#backgroundprocessmanager_processpriority) priority | 压制档位。 | + +**返回：** + +| 类型 | 说明 | +| -- | -- | +| int | 返回 [ERR_BACKGROUND_PROCESS_MANAGER_SUCCESS](capi-background-process-manager-h.md#backgroundprocessmanager_errorcode)，表示压制参数发送成功。
返回 [ERR_BACKGROUND_PROCESS_MANAGER_INVALID_PARAM](capi-background-process-manager-h.md#backgroundprocessmanager_errorcode)，表示参数检查失败。 | + +### OH_BackgroundProcessManager_ResetProcessPriority() + +``` +int OH_BackgroundProcessManager_ResetProcessPriority(int pid) +``` + +**描述** + +为子进程解压制，即子进程策略恢复为主进程调度策略。若主进程调度策略发生变化，如从后台切至前台等，子进程会跟随主进程一同变化，等效于执行一次resetProcessPriority动作。 + +**起始版本：** 17 + + +**参数：** + +| 参数项 | 描述 | +| -- | -- | +| int pid | 子进程的进程号，OH_Ability_StartNativeChildProcess接口创建子进程后的pid参数，即为子进程进程号。 | + +**返回：** + +| 类型 | 说明 | +| -- | -- | +| int | 返回 [ERR_BACKGROUND_PROCESS_MANAGER_SUCCESS](capi-background-process-manager-h.md#backgroundprocessmanager_errorcode)，表示压制参数发送成功。 | + + -- Gitee From 231f44bdd9095c5ae7631214da812712f52e961f Mon Sep 17 00:00:00 2001 From: pdf001 <1626385780@qq.com> Date: Fri, 4 Jul 2025 06:48:10 +0000 Subject: [PATCH 6/9] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E7=BB=93=E6=9E=84?= =?UTF-8?q?=E4=BD=93=E3=80=90TransientTask=5FDelaySuspendInfo=E3=80=91?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: pdf001 <1626385780@qq.com> --- .../_transient_task___delay_suspend_info.md | 45 ------------------- ...ienttask-transienttask-delaysuspendinfo.md | 22 +++++++++ 2 files changed, 22 insertions(+), 45 deletions(-) delete mode 100644 zh-cn/application-dev/reference/apis-backgroundtasks-kit/_transient_task___delay_suspend_info.md create mode 100644 zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transienttask-transienttask-delaysuspendinfo.md diff --git a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/_transient_task___delay_suspend_info.md b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/_transient_task___delay_suspend_info.md deleted file mode 100644 index bb53ddc51d6..00000000000 --- a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/_transient_task___delay_suspend_info.md +++ /dev/null @@ -1,45 +0,0 @@ -# TransientTask_DelaySuspendInfo - - -## 概述 - -定义短时任务返回信息结构体。 - -**起始版本：** 13 - -**相关模块：**[TransientTask](_transient_task.md) - -**所在头文件：**[transient_task_type.h](transient__task__type_8h.md) - -## 汇总 - - -### 成员变量 - -| 名称 | 描述 | -| -------- | -------- | -| int32_t [requestId](#requestid) | 短时任务请求ID。 | -| int32_t [actualDelayTime](#actualdelaytime) | 剩余时间（单位：毫秒）。 | - - -## 结构体成员变量说明 - - -### actualDelayTime - -``` -int32_t TransientTask_DelaySuspendInfo::actualDelayTime -``` -**描述** - -剩余时间（单位：毫秒）。 - - -### requestId - -``` -int32_t TransientTask_DelaySuspendInfo::requestId -``` -**描述** - -短时任务请求ID。 diff --git a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transienttask-transienttask-delaysuspendinfo.md b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transienttask-transienttask-delaysuspendinfo.md new file mode 100644 index 00000000000..864ee7a2cd0 --- /dev/null +++ b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transienttask-transienttask-delaysuspendinfo.md @@ -0,0 +1,22 @@ +# TransientTask_DelaySuspendInfo + +## 概述 + +定义短时任务返回信息结构体。 + +**起始版本：** 13 + +**相关模块：** [TransientTask](capi-transienttask.md) + +**所在头文件：** [transient_task_type.h](capi-transient-task-type-h.md) + +## 汇总 + +### 成员变量 + +| 名称 | 描述 | +| -- | -- | +| int32_t requestId | 短时任务请求ID。 | +| int32_t actualDelayTime | 剩余时间（单位：毫秒）。 | + + -- Gitee From 13f2e5fdd126a3499249c6085a9badd3bbc8e8f8 Mon Sep 17 00:00:00 2001 From: pdf001 <1626385780@qq.com> Date: Fri, 4 Jul 2025 06:53:12 +0000 Subject: [PATCH 7/9] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E9=93=BE=E6=8E=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: pdf001 <1626385780@qq.com> --- .../reference/apis-backgroundtasks-kit/Readme-CN.md | 12 ++++++------ zh-cn/application-dev/website.md | 12 ++++++------ 2 files changed, 12 insertions(+), 12 deletions(-) diff --git a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/Readme-CN.md b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/Readme-CN.md index 72f6fe5e2e6..66d5573320f 100644 --- a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/Readme-CN.md +++ b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/Readme-CN.md @@ -27,14 +27,14 @@ - C API - 模块 - - [TransientTask](_transient_task.md) - - [BackgroundProcessManager](_background_process_manager.md) + - [BackgroundProcessManager](capi-backgroundprocessmanager.md) + - [TransientTask](capi-transienttask.md) - 头文件 - - [transient_task_api.h](transient__task__api_8h.md) - - [transient_task_type.h](transient__task__type_8h.md) - - [background_process_manager.h](background__process__manager_8h.md) + - [background_process_manager.h](capi-background-process-manager-h.md) + - [transient_task_api.h](capi-transient-task-api-h.md) + - [transient_task_type.h](capi-transient-task-type-h.md) - 结构体 - - [TransientTask_DelaySuspendInfo](_transient_task___delay_suspend_info.md) + - [TransientTask_DelaySuspendInfo](capi-transienttask-transienttask-delaysuspendinfo.md) - 错误码 - [backgroundTaskManager错误码](errorcode-backgroundTaskMgr.md) diff --git a/zh-cn/application-dev/website.md b/zh-cn/application-dev/website.md index dfff35e65dd..fd292e410dc 100644 --- a/zh-cn/application-dev/website.md +++ b/zh-cn/application-dev/website.md @@ -3200,14 +3200,14 @@ - C API - 模块 - - [TransientTask](reference/apis-backgroundtasks-kit/_transient_task.md) - - [BackgroundProcessManager](reference/apis-backgroundtasks-kit/_background_process_manager.md) + - [BackgroundProcessManager](reference/apis-backgroundtasks-kit/capi-backgroundprocessmanager.md) + - [TransientTask](reference/apis-backgroundtasks-kit/capi-transienttask.md) - 头文件 - - [transient_task_api.h](reference/apis-backgroundtasks-kit/transient__task__api_8h.md) - - [transient_task_type.h](reference/apis-backgroundtasks-kit/transient__task__type_8h.md) - - [background_process_manager.h](reference/apis-backgroundtasks-kit/background__process__manager_8h.md) + - [background_process_manager.h](reference/apis-backgroundtasks-kit/capi-background-process-manager-h.md) + - [transient_task_api.h](reference/apis-backgroundtasks-kit/capi-transient-task-api-h.md) + - [transient_task_type.h](reference/apis-backgroundtasks-kit/capi-transient-task-type-h.md) - 结构体 - - [TransientTask_DelaySuspendInfo](reference/apis-backgroundtasks-kit/_transient_task___delay_suspend_info.md) + - [TransientTask_DelaySuspendInfo](reference/apis-backgroundtasks-kit/capi-transienttask-transienttask-delaysuspendinfo.md) - 错误码 - [backgroundTaskManager错误码](reference/apis-backgroundtasks-kit/errorcode-backgroundTaskMgr.md) -- Gitee From 68ab2ac95bb07722cdba82d92865b1a9e977a635 Mon Sep 17 00:00:00 2001 From: pdf001 <1626385780@qq.com> Date: Fri, 4 Jul 2025 06:56:16 +0000 Subject: [PATCH 8/9] update zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transient-task-type-h.md. Signed-off-by: pdf001 <1626385780@qq.com> --- .../apis-backgroundtasks-kit/capi-transient-task-type-h.md | 1 - 1 file changed, 1 deletion(-) diff --git a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transient-task-type-h.md b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transient-task-type-h.md index 6be304790f0..51fc8b6bd0b 100644 --- a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transient-task-type-h.md +++ b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transient-task-type-h.md @@ -21,7 +21,6 @@ | 名称 | typedef关键字 | 描述 | |------------------------------------------------------------------------------------------| -- | -- | | [TransientTask_DelaySuspendInfo](capi-transienttask-transienttask-delaysuspendinfo.md) | TransientTask_DelaySuspendInfo | 定义短时任务返回信息结构体。 | -| [TransientTask_TransientTaskInfo](capi-transienttask-transienttask-transienttaskinfo.md) | TransientTask_TransientTaskInfo | 定义所有短时任务信息结构体。 | ### 枚举 -- Gitee From 2f79e8b9f73ffc290fed88892d308514fee7bbe7 Mon Sep 17 00:00:00 2001 From: pdf001 <1626385780@qq.com> Date: Fri, 4 Jul 2025 06:59:03 +0000 Subject: [PATCH 9/9] update zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transient-task-api-h.md. Signed-off-by: pdf001 <1626385780@qq.com> --- .../capi-transient-task-api-h.md | 28 ------------------- 1 file changed, 28 deletions(-) diff --git a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transient-task-api-h.md b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transient-task-api-h.md index d9662920465..b1eb7e4d048 100644 --- a/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transient-task-api-h.md +++ b/zh-cn/application-dev/reference/apis-backgroundtasks-kit/capi-transient-task-api-h.md @@ -23,7 +23,6 @@ | [int32_t OH_BackgroundTaskManager_RequestSuspendDelay(const char* reason,TransientTask_Callback callback, TransientTask_DelaySuspendInfo *info)](#oh_backgroundtaskmanager_requestsuspenddelay) | 申请短时任务。 | | [int32_t OH_BackgroundTaskManager_GetRemainingDelayTime(int32_t requestId, int32_t *delayTime)](#oh_backgroundtaskmanager_getremainingdelaytime) | 获取本次短时任务的剩余时间。 | | [int32_t OH_BackgroundTaskManager_CancelSuspendDelay(int32_t requestId)](#oh_backgroundtaskmanager_cancelsuspenddelay) | 取消短时任务。 | -| [int32_t OH_BackgroundTaskManager_GetTransientTaskInfo(TransientTask_TransientTaskInfo *transientTaskInfo)](#oh_backgroundtaskmanager_gettransienttaskinfo) | 获取所有短时任务信息，如当日剩余总配额等。 | ## 函数说明 @@ -110,30 +109,3 @@ int32_t OH_BackgroundTaskManager_CancelSuspendDelay(int32_t requestId) | 类型 | 说明 | | -- | -- | | int32_t | 返回0，表示取消成功。
返回401，表示入参错误。
返回9800002，表示Parcel读写操作失败。
返回9800003，表示IPC通信失败。
返回9800004，表示系统服务失败。
返回9900001，表示短时任务客户端信息校验失败。
返回9900002，表示短时任务服务端校验失败。
错误码的具体信息请参考[TransientTask_ErrorCode](capi-transient-task-type-h.md#transienttask_errorcode)。 | - -### OH_BackgroundTaskManager_GetTransientTaskInfo() - -``` -int32_t OH_BackgroundTaskManager_GetTransientTaskInfo(TransientTask_TransientTaskInfo *transientTaskInfo) -``` - -**描述** - -获取所有短时任务信息，如当日剩余总配额等。 - -**起始版本：** 20 - - -**参数：** - -| 参数项 | 描述 | -|--------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------| -| [TransientTask_TransientTaskInfo ](capi-transienttask-transienttask-transienttaskinfo.md) *transientTaskInfo | 所有短时任务信息，具体请参考[TransientTask_TransientTaskInfo](capi-transienttask-transienttask-transienttaskinfo.md)。 | - -**返回：** - -| 类型 | 说明 | -| -- | -- | -| int32_t | 返回0，表示获取成功。
返回9900001，表示短时任务客户端信息校验失败。
返回9900003，表示Parcel读写操作失败。
返回9900004，表示系统服务失败。
错误码的具体信息请参考[TransientTask_ErrorCode](capi-transient-task-type-h.md#transienttask_errorcode)。 | - - -- Gitee