From a167a1918dc55dcdbde5108a99ce17f9d574e9a8 Mon Sep 17 00:00:00 2001 From: "ester.zhou" Date: Mon, 19 Sep 2022 20:13:30 +0800 Subject: [PATCH] Update docs (8394) Signed-off-by: ester.zhou --- .../reference/apis/js-apis-notification.md | 2 +- .../reference/apis/js-apis-workScheduler.md | 65 +++++++++--------- .../reference/arkui-ts/figures/search.png | Bin 0 -> 24377 bytes .../arkui-ts/ts-basic-components-search.md | 44 ++++++------ .../work-scheduler-dev-guide.md | 56 ++++++++------- en/readme/misc-services.md | 13 ++-- 6 files changed, 93 insertions(+), 87 deletions(-) create mode 100644 en/application-dev/reference/arkui-ts/figures/search.png diff --git a/en/application-dev/reference/apis/js-apis-notification.md b/en/application-dev/reference/apis/js-apis-notification.md index 1305ce8f88..9ee2ae956f 100644 --- a/en/application-dev/reference/apis/js-apis-notification.md +++ b/en/application-dev/reference/apis/js-apis-notification.md @@ -528,7 +528,7 @@ Obtains all notification slots. This API uses an asynchronous callback to return | Name | Readable| Writable| Type | Mandatory| Description | | -------- | ---- | --- | --------------------------------- | ---- | -------------------- | -| callback | Yes | No | AsyncCallback\<[NotificationSlot](#notificationslot)\> | Yes | Callback used to return the result.| +| callback | Yes | No | AsyncCallback\\> | Yes | Callback used to return the result.| **Example** diff --git a/en/application-dev/reference/apis/js-apis-workScheduler.md b/en/application-dev/reference/apis/js-apis-workScheduler.md index 964b63aa2e..28154fb549 100644 --- a/en/application-dev/reference/apis/js-apis-workScheduler.md +++ b/en/application-dev/reference/apis/js-apis-workScheduler.md @@ -1,7 +1,12 @@ # Work Scheduler -> **NOTE**
-> The initial APIs of this module are supported since API version 9. API version 9 is a canary version for trial use. The APIs of this version may be unstable. +The **workScheduler** module provides the APIs for registering, canceling, and querying Work Scheduler tasks, which do not have real-time constraints. + +The system executes Work Scheduler tasks at an appropriate time, subject to the storage space, power consumption, temperature, and more. + +> **NOTE** +> +> The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version. ## Modules to Import @@ -100,7 +105,7 @@ Obtains the latest task status. This API uses an asynchronous callback to return ``` workScheduler.getWorkStatus(50, (err, res) => { if (err) { - console.info('workschedulerLog getWorkStatus failed, because:' + err.code); + console.info('workschedulerLog getWorkStatus failed, because:' + err.data); } else { for (let item in res) { console.info('workschedulerLog getWorkStatus success,' + item + ' is:' + res[item]); @@ -136,7 +141,7 @@ Obtains the latest task status. This API uses a promise to return the result. console.info('workschedulerLog getWorkStatus success,' + item + ' is:' + res[item]); } }).catch((err) => { - console.info('workschedulerLog getWorkStatus failed, because:' + err.code); + console.info('workschedulerLog getWorkStatus failed, because:' + err.data); }) ``` @@ -164,7 +169,7 @@ Obtains all tasks associated with this application. This API uses an asynchronou ``` workScheduler.obtainAllWorks((err, res) =>{ if (err) { - console.info('workschedulerLog obtainAllWorks failed, because:' + err.code); + console.info('workschedulerLog obtainAllWorks failed, because:' + err.data); } else { console.info('workschedulerLog obtainAllWorks success, data is:' + JSON.stringify(res)); } @@ -190,7 +195,7 @@ Obtains all tasks associated with this application. This API uses a promise to r workScheduler.obtainAllWorks().then((res) => { console.info('workschedulerLog obtainAllWorks success, data is:' + JSON.stringify(res)); }).catch((err) => { - console.info('workschedulerLog obtainAllWorks failed, because:' + err.code); + console.info('workschedulerLog obtainAllWorks failed, because:' + err.data); }) ``` @@ -233,7 +238,7 @@ Checks whether the last execution of the specified task timed out. This API uses ``` workScheduler.isLastWorkTimeOut(500, (err, res) =>{ if (err) { - console.info('workschedulerLog isLastWorkTimeOut failed, because:' + err.code); + console.info('workschedulerLog isLastWorkTimeOut failed, because:' + err.data); } else { console.info('workschedulerLog isLastWorkTimeOut success, data is:' + res); } @@ -267,32 +272,30 @@ Checks whether the last execution of the specified task timed out. This API uses console.info('workschedulerLog isLastWorkTimeOut success, data is:' + res); }) .catch(err => { - console.info('workschedulerLog isLastWorkTimeOut failed, because:' + err.code); + console.info('workschedulerLog isLastWorkTimeOut failed, because:' + err.data); }); ``` ## WorkInfo -Provides detailed information about the task. +Provides detailed information about the task. For details about the constraints on configuring **WorkInfo**, see [Work Scheduler Overview](../../task-management/work-scheduler-overview.md). **System capability**: SystemCapability.ResourceSchedule.WorkScheduler -| Name | Type | Mandatory| Description | -| --------------- | --------------------------------- | ---- | -------------------------------- | -| workId | number | Yes | Task ID. | -| bundleName | string | Yes | Name of the Work Scheduler task bundle. | -| abilityName | string | Yes | Name of the component to be notified by a Work Scheduler callback.| -| networkType | [NetworkType](#networktype) | No | Network type. | -| isCharging | boolean | No | Whether the device is charging. | -| chargerType | [ChargingType](#chargingtype) | No | Charging type. | -| batteryLevel | number | No | Battery level. | -| batteryStatus | [BatteryStatus](#batterystatus) | No | Battery status. | -| storageRequest | [StorageRequest](#storagerequest) | No | Storage status. | -| isRepeat | boolean | No | Whether the task is repeated. | -| repeatCycleTime | number | No | Repeat interval. | -| repeatCount | number | No | Number of repeat times. | -| isPersisted | boolean | No | Whether to enable persistent storage for the task. | -| isDeepIdle | boolean | No | Whether the device needs to enter the idle state. | -| idleWaitTime | number | No | Time to wait in the idle state. | +| Name | Type | Mandatory | Description | +| --------------- | --------------------------------- | ---- | ---------------- | +| workId | number | Yes | Task ID. | +| bundleName | string | Yes | Name of the Work Scheduler task bundle. | +| abilityName | string | Yes | Name of the component to be notified by a Work Scheduler callback.| +| networkType | [NetworkType](#networktype) | No | Network type. | +| isCharging | boolean | No | Whether the device is charging. | +| chargerType | [ChargingType](#chargingtype) | No | Charging type. | +| batteryLevel | number | No | Battery level. | +| batteryStatus | [BatteryStatus](#batterystatus) | No | Battery status. | +| storageRequest | [StorageRequest](#storagerequest) | No | Storage status. | +| isRepeat | boolean | No | Whether the task is repeated. | +| repeatCycleTime | number | No | Repeat interval. | +| repeatCount | number | No | Number of repeat times. | +| isPersisted | boolean | No | Whether to enable persistent storage for the task. | ## NetworkType Enumerates the network types that can trigger the task. @@ -336,8 +339,8 @@ Enumerates the storage states that can trigger the task. **System capability**: SystemCapability.ResourceSchedule.WorkScheduler - |Name |Default Value |Description| - | -------- | -------- | -------- | - |STORAGE_LEVEL_LOW |0 |The storage space is insufficient. - |STORAGE_LEVEL_OKAY |1 |The storage space is restored from insufficient to normal. - |STORAGE_LEVEL_LOW_OR_OKAY |2 |The storage space is restored from insufficient to normal, or the storage space is insufficient. +| Name | Default Value | Description | +| ------------------------- | ---- | ------------------------------ | +| STORAGE_LEVEL_LOW | 0 | The storage space is insufficient. | +| STORAGE_LEVEL_OKAY | 1 | The storage space is restored from insufficient to normal. | +| STORAGE_LEVEL_LOW_OR_OKAY | 2 | The storage space is restored from insufficient to normal, or the storage space is insufficient.| diff --git a/en/application-dev/reference/arkui-ts/figures/search.png b/en/application-dev/reference/arkui-ts/figures/search.png new file mode 100644 index 0000000000000000000000000000000000000000..fddf98d7104f3bd8a370b5be86da322834ff0180 GIT binary patch literal 24377 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 void) | Triggered when users click the search icon or the search button, or touch the search button on a soft keyboard.
-**value**: current text input.| -| onChange(callback: (value: string) => void) | Triggered when the input in the text box changes.
-**value**: current text input. | -| onCopy(callback: (value: string) => void) | Triggered when data is copied to the pasteboard.
-**value**: text copied. | -| onCut(callback: (value: string) => void) | Triggered when data is cut from the pasteboard.
-**value**: text cut. | -| onPaste(callback: (value: string) => void) | Triggered when data is pasted from the pasteboard.
-**value**: text pasted. | +| Name | Description | +| ------------------------------------------- | ------------------------------------------------------------ | +| onSubmit(callback: (value: string) => void) | Triggered when users click the search icon or the search button, or touch the search button on a soft keyboard.
- **value**: current text input. | +| onChange(callback: (value: string) => void) | Triggered when the input in the text box changes.
- **value**: current text input. | +| onCopy(callback: (value: string) => void) | Triggered when data is copied to the pasteboard.
- **value**: text copied. | +| onCut(callback: (value: string) => void) | Triggered when data is cut from the pasteboard.
- **value**: text cut. | +| onPaste(callback: (value: string) => void) | Triggered when data is pasted from the pasteboard.
- **value**: text pasted. | ## SearchController @@ -63,9 +63,9 @@ Sets the position of the caret. **Parameters** -| Name | Type | Mandatory | Default Value | Description | -| ----- | ------ | ---- | ---- | ----------------- | -| value | number | Yes | - | Length from the start of the character string to the position where the caret is located.| +| Name | Type | Mandatory | Description | +| ----- | ------ | ---- | ----------------- | +| value | number | Yes | Length from the start of the character string to the position where the caret is located.| diff --git a/en/application-dev/task-management/work-scheduler-dev-guide.md b/en/application-dev/task-management/work-scheduler-dev-guide.md index c5679dc1ea..685486ada2 100644 --- a/en/application-dev/task-management/work-scheduler-dev-guide.md +++ b/en/application-dev/task-management/work-scheduler-dev-guide.md @@ -2,7 +2,7 @@ ## When to Use -If your application needs to execute a non-real-time task, for example, data learning, you can harness the Work Scheduler mechanism, which will schedule the task based on the storage space, power consumption, temperature, and more when the preset conditions are met. +If your application needs to execute a non-real-time task, for example, data learning, you can harness the Work Scheduler mechanism, which will schedule the task based on the storage space, power consumption, temperature, and more when the preset conditions are met. For details about the constraints on the Work Scheduler usage, see [Work Scheduler Overview](./work-scheduler-overview.md). ## Available APIs @@ -20,38 +20,42 @@ import WorkSchedulerExtensionAbility from '@ohos.WorkSchedulerExtensionAbility'; **Table 1** Major workScheduler APIs -API | Description ----------------------------------------------------------|----------------------------------------- -startWork(work: WorkInfo): boolean | Starts a Work Scheduler task. -stopWork(work: WorkInfo, needCancel?: boolean): boolean | Stops a Work Scheduler task. -getWorkStatus(workId: number, callback: AsyncCallback\): void| Obtains the status of a Work Scheduler task. This method uses an asynchronous callback to return the result. -getWorkStatus(workId: number): Promise\ | Obtains the status of a Work Scheduler task. This method uses a promise to return the result. -obtainAllWorks(callback: AsyncCallback\): Array\| Obtains Work Scheduler tasks. This method uses an asynchronous callback to return the result. -obtainAllWorks(): Promise>| Obtains Work Scheduler tasks. This method uses a promise to return the result. -stopAndClearWorks(): boolean| Stops and clears Work Scheduler tasks. -isLastWorkTimeOut(workId: number, callback: AsyncCallback\): boolean| Checks whether the last execution of the specified task has timed out. This method uses an asynchronous callback to return the result. It is applicable to repeated tasks. -isLastWorkTimeOut(workId: number): Promise\| Checks whether the last execution of the specified task has timed out. This method uses a promise to return the result. It is applicable to repeated tasks. + API | Description + ------------------------------------------------------------ | ------------------------------------------------------------ + startWork(work: WorkInfo): boolean | Starts a Work Scheduler task. + stopWork(work: WorkInfo, needCancel?: boolean): boolean | Stops a Work Scheduler task. + getWorkStatus(workId: number, callback: AsyncCallback\): void | Obtains the status of a Work Scheduler task. This API uses an asynchronous callback to return the result. + getWorkStatus(workId: number): Promise\ | Obtains the status of a Work Scheduler task. This API uses a promise to return the result. + obtainAllWorks(callback: AsyncCallback\): Array\ | Obtains Work Scheduler tasks. This API uses an asynchronous callback to return the result. + obtainAllWorks(): Promise> | Obtains Work Scheduler tasks. This API uses a promise to return the result. + stopAndClearWorks(): boolean | Stops and clears Work Scheduler tasks. + isLastWorkTimeOut(workId: number, callback: AsyncCallback\): boolean | Checks whether the last execution of the specified task has timed out. This API uses an asynchronous callback to return the result. It is applicable to repeated tasks. + isLastWorkTimeOut(workId: number): Promise\ | Checks whether the last execution of the specified task has timed out. This API uses a promise to return the result. It is applicable to repeated tasks. **Table 2** WorkInfo parameters -API|Description|Type +> **NOTE** +> +> For details about the constraints on configuring **WorkInfo**, see [Work Scheduler Overview](./work-scheduler-overview.md). + +Name| Type|Description ---------------------------------------------------------|-----------------------------------------|--------------------------------------------------------- -workId | Work ID. Mandatory.|number -bundleName | Name of the Work Scheduler task bundle. Mandatory.|string -abilityName | Name of the component to be notified by a Work Scheduler callback.|string -networkType | Network type.| NetworkType -isCharging | Whether the device is charging.| boolean -chargerType | Charging type.| ChargingType -batteryLevel | Battery level.| number -batteryStatus| Battery status.| BatteryStatus -storageRequest|Storage status.| StorageRequest -isRepeat|Whether the task is repeated.| boolean -repeatCycleTime |Repeat interval.| number -repeatCount |Number of repeat times.| number +workId| number | Work ID. Mandatory. +bundleName| string | Name of the Work Scheduler task bundle. Mandatory. +abilityName| string | Name of the component to be notified by a Work Scheduler callback. Mandatory. +networkType | [NetworkType](../reference/apis/js-apis-workScheduler.md#networktype) | Network type. +isCharging| boolean | Whether the device is charging. +chargerType| [ChargingType](../reference/apis/js-apis-workScheduler.md#chargingtype) | Charging type. +batteryLevel| number | Battery level. +batteryStatus| [BatteryStatus](../reference/apis/js-apis-workScheduler.md#batterystatus) | Battery status. +storageRequest| [StorageRequest](../reference/apis/js-apis-workScheduler.md#storagerequest) |Storage status. +isRepeat| boolean |Whether the task is repeated. +repeatCycleTime| number |Repeat interval. +repeatCount | number|Number of repeat times. **Table 3** Work Scheduler callbacks -API | Description +Name | Description ---------------------------------------------------------|----------------------------------------- onWorkStart(work: WorkInfo): void | Triggered when the Work Scheduler task starts. onWorkStop(work: WorkInfo): void | Triggered when the Work Scheduler task stops. diff --git a/en/readme/misc-services.md b/en/readme/misc-services.md index 937e6cb511..cbe1e1f2ef 100755 --- a/en/readme/misc-services.md +++ b/en/readme/misc-services.md @@ -1,22 +1,21 @@ -# Misc Services +# Misc Services -## Introduction +## Introduction The Misc services subsystem provides APIs for setting the system time. -**Figure 1** Subsystem architecture +**Figure 1** Subsystem architecture ![](figures/subsystem-architecture.png "subsystem-architecture") -## Directory Structure +## Directory Structure ``` /base/miscservices └── time # Time service module ``` -## Repositories Involved +## Repositories Involved **Misc services subsystem** -miscservices\_time - +[time_time_service](https://gitee.com/openharmony/time_time_service) -- GitLab