From 248bbc5d580a4edd3ce482082ef3754c2e155fc8 Mon Sep 17 00:00:00 2001 From: wangqing Date: Wed, 23 Mar 2022 21:29:26 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=87=E6=A1=A3=E4=BF=AE=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: wangqing --- .../background-task-dev-guide.md | 12 ++++----- .../apis/js-apis-backgroundTaskManager.md | 27 ++++++++++--------- .../reference/apis/js-apis-particleAbility.md | 8 +++--- 3 files changed, 24 insertions(+), 23 deletions(-) diff --git a/zh-cn/application-dev/background-task-management/background-task-dev-guide.md b/zh-cn/application-dev/background-task-management/background-task-dev-guide.md index 46806fcbf0..c824780f09 100644 --- a/zh-cn/application-dev/background-task-management/background-task-dev-guide.md +++ b/zh-cn/application-dev/background-task-management/background-task-dev-guide.md @@ -106,7 +106,7 @@ ohos.permission.KEEP_BACKGROUND_RUNNING | function stopBackgroundRunning(context: Context, callback: AsyncCallback<void>): void;
function stopBackgroundRunning(context: Context): Promise<void>; | 停止后台长时任务的运行 | -其中，wantAgent的信息详见（[WantAgent](../reference/apis/js-apis-notification.md#WantAgent接口)） +其中，wantAgent的信息详见（[WantAgent](../reference/apis/js-apis-wantAgent.md)） **表4** 后台模式类型 @@ -125,21 +125,21 @@ ohos.permission.KEEP_BACKGROUND_RUNNING ## 开发步骤 -1. 在config.json文件中配置长时任务权限和后台模式类型。其中ability类型为service +1. 在config.json文件中配置长时任务权限和后台模式类型，其中ability类型为service。 ```json "module": { "package": "com.example.myapplication", - ... + //... "abilities": [ - ... + //... { "backgroundModes": [ "dataTransfer", "location", - ... + //... ], - ... + //... "type": "service" } ], diff --git a/zh-cn/application-dev/reference/apis/js-apis-backgroundTaskManager.md b/zh-cn/application-dev/reference/apis/js-apis-backgroundTaskManager.md index 6c5afd5cdc..8e31d851fc 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-backgroundTaskManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-backgroundTaskManager.md @@ -56,6 +56,7 @@ getRemainingDelayTime(requestId: number, callback: AsyncCallback<number>): | callback | AsyncCallback<number> | 是 | 指定的callback回调方法。用于返回应用程序进入挂起状态之前的剩余时间，以毫秒为单位。 | **示例**： + ```js let id = 1; backgroundTaskManager.getRemainingDelayTime(id, (err, res) => { @@ -127,12 +128,12 @@ startBackgroundRunning(context: Context, bgMode: BackgroundMode, wantAgent: Want **系统能力:** SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask **参数**： - | 参数名 | 类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | context | [Context](js-apis-Context.md) | 是 | 应用运行的上下文。 | - | bgMode | [BackgroundMode](#backgroundmode8) | 是 | 向系统申请的后台模式。| - | wantAgent | [WantAgent](js-apis-notification.md#WantAgent接口) | 是 | 通知参数，用于指定长时任务通知点击后跳转的界面。 | - | callback | AsyncCallback<void> | 是 | callback形式返回启动长时任务的结果。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| context | [Context](js-apis-Context.md) | 是 | 应用运行的上下文。 | +| bgMode | [BackgroundMode](#backgroundmode8) | 是 | 向系统申请的后台模式。| +| wantAgent | [WantAgent](js-apis-wantAgent.md) | 是 | 通知参数，用于指定长时任务通知点击后跳转的界面。 | +| callback | AsyncCallback<void> | 是 | callback形式返回启动长时任务的结果。 | **示例**： ```js @@ -178,13 +179,13 @@ startBackgroundRunning(context: Context, bgMode: BackgroundMode, wantAgent: Want **系统能力:** SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask **参数**： - - | 参数名 | 类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | context | [Context](js-apis-Context.md) | 是 | 应用运行的上下文。 | - | bgMode | [BackgroundMode](#backgroundmode8) | 是 | 向系统申请的后台模式。 | - | wantAgent | [WantAgent](js-apis-notification.md#WantAgent接口) | 是 | 通知参数，用于指定长时任务通知点击跳转的界面。 | - + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| context | [Context](js-apis-Context.md) | 是 | 应用运行的上下文。 | +| bgMode | [BackgroundMode](#backgroundmode8) | 是 | 向系统申请的后台模式。 | +| wantAgent | [WantAgent](js-apis-wantAgent.md) | 是 | 通知参数，用于指定长时任务通知点击跳转的界面。 | + **返回值** | 类型 | 说明 | | -------------- | ------------------------- | diff --git a/zh-cn/application-dev/reference/apis/js-apis-particleAbility.md b/zh-cn/application-dev/reference/apis/js-apis-particleAbility.md index 0f7085bf8e..f8d2b2d453 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-particleAbility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-particleAbility.md @@ -188,7 +188,7 @@ particleAbility.acquireDataAbilityHelper(uri) startBackgroundRunning(id: number, request: NotificationRequest, callback: AsyncCallback<void>): void; -向系统申请长时任务，使用callback形式返回结果。（此接口为api7接口，后续会被废弃，请使用新的[api8接口](js-apis-backgroundTaskManager.md)） +向系统申请长时任务，使用callback形式返回结果。（此接口为api7接口,[建议使用新接口](js-apis-backgroundTaskManager.md#backgroundtaskmanager.startbackgroundrunning8)） **系统能力**：SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask @@ -252,7 +252,7 @@ startBackgroundRunning(id: number, request: NotificationRequest): Promise<voi **系统能力**：SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask -向系统申请长时任务，使用promise形式返回结果。（此接口为api7接口，后续会被废弃，请使用新的[api8接口](js-apis-backgroundTaskManager.md)） +向系统申请长时任务，使用promise形式返回结果。（此接口为api7接口，[建议使用新接口](js-apis-backgroundTaskManager.md#backgroundtaskmanager.startbackgroundrunning8)） **参数：** @@ -313,7 +313,7 @@ wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => { cancelBackgroundRunning(callback: AsyncCallback<void>): void; -向系统申请取消长时任务，使用callback形式返回结果。（此接口为api7接口，后续会被废弃，请使用新的[api8接口](js-apis-backgroundTaskManager.md)） +向系统申请取消长时任务，使用callback形式返回结果。（此接口为api7接口，[建议使用新接口](js-apis-backgroundTaskManager.md#backgroundtaskmanager.stopbackgroundrunning8)） **系统能力**：SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask @@ -344,7 +344,7 @@ particleAbility.cancelBackgroundRunning(callback); cancelBackgroundRunning(): Promise<void>; -向系统申请取消长时任务，使用promise形式返回结果。（此接口为api7接口，后续会被废弃，请使用新的[api8接口](js-apis-backgroundTaskManager.md)） +向系统申请取消长时任务，使用promise形式返回结果。（此接口为api7接口，[建议使用新接口](js-apis-backgroundTaskManager.md#backgroundtaskmanager.stopbackgroundrunning8)） **系统能力**：SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask -- GitLab