diff --git a/en/application-dev/quick-start/app-configuration-file.md b/en/application-dev/quick-start/app-configuration-file.md
index 3fff90e0682c4f79e63fa0ee8306a5f8aa7e9385..19e6d16258b06b5a2f613a01061fc6a683488ee2 100644
--- a/en/application-dev/quick-start/app-configuration-file.md
+++ b/en/application-dev/quick-start/app-configuration-file.md
@@ -30,21 +30,21 @@ This document gives an overview of the **app.json5** configuration file. To star
As shown above, the **app.json5** file contains several tags.
- **Table 1** Tags in the app.json5 file
+**Table 1** Tags in the app.json5 file
| Name| Description| Data Type| Initial Value Allowed|
| -------- | -------- | -------- | -------- |
| bundleName | Bundle name, which uniquely identifies an application. The value must comply with the following rules:
- Consists of letters, digits, underscores (_), and periods (.).
- Starts with a letter.
- Contains 7 to 127 bytes.
You are advised to use the reverse domain name notation, for example, *com.example.demo*, where the first part is the domain suffix **com**, the second part is the vendor/individual name, and the third part is the application name, which can be of multiple levels.
If an application is built with the system source code, you are advised to name it in *com.ohos.demo* notation, where **ohos** signifies that the application is an OpenHarmony system application.| String| No|
| debug | Whether the application can be debugged. This tag is generated during compilation and building in DevEco Studio.
- **true**: The application can be debugged.
- **false**: The application cannot be debugged.| Boolean| Yes (initial value: **false**)|
-| icon | [Icon of the application](../application-models/application-component-configuration-stage.md). The value is an icon resource index. | String| No|
-| label | [Name of the application](../application-models/application-component-configuration-stage.md). The value is a string resource index. | String| No|
-| description | Description of the application. The value is a string with a maximum of 255 bytes or a resource index to the description. | String| Yes (initial value: left empty)|
+| icon | [Icon of the application](../application-models/application-component-configuration-stage.md). The value is an icon resource index.| String| No|
+| label | [Name of the application](../application-models/application-component-configuration-stage.md). The value is a string resource index.| String| No|
+| description | Description of the application. The value is a string with a maximum of 255 bytes or a resource index to the description.| String| Yes (initial value: left empty)|
| vendor | Vendor of the application. The value is a string with a maximum of 255 bytes.| String| Yes (initial value: left empty)|
| versionCode | Version number of the application. The value is a 32-bit non-negative integer less than 2 to the power of 31. It is used only to determine whether a version is later than another version. A larger value indicates a later version. Ensure that a new version of the application uses a value greater than any of its predecessors. | Number| No|
| versionName | Version number of the application displayed to users.
The value consists of only digits and dots. The four-part format *A.B.C.D* is recommended, wherein:
Part 1 (*A*): major version number, which ranges from 0 to 99. A major version consists of major new features or large changes.
Part 2 (*B*): minor version number, which ranges from 0 to 99. A minor version consists of some new features and large bug fixes.
Part 3 (*C*): feature version number, which ranges from 0 to 99. A feature version consists of scheduled new features.
Part 4 (*D*): maintenance release number or patch number, which ranges from 0 to 999. A maintenance release or patch consists of resolution to security flaws or minor bugs.
The value contains a maximum of 127 bytes.| String| No|
| minCompatibleVersionCode | Minimum compatible version of the application. It is used to check whether the application is compatible with a version on other devices in the cross-device scenario.| Number| Yes (initial value: value of **versionCode**)|
-| minAPIVersion | Minimum API version required for running the application.| Number| Yes (initial value: value of **compatibleSdkVersion** in **bundle-profile.json5**)|
-| targetAPIVersion | Target API version required for running the application.| Number| Yes (initial value: value of **compileSdkVersion** in **bundle-profile.json5**)|
+| minAPIVersion | Minimum API version required for running the application.| Number| Yes (initial value: value of **compatibleSdkVersion** in **build-profile.json5**)|
+| targetAPIVersion | Target API version required for running the application.| Number| Yes (initial value: value of **compileSdkVersion** in **build-profile.json5**)|
| apiReleaseType | Type of the target API version required for running the application. The value can be **"CanaryN"**, **"BetaN"**, or **"Release"**, where **N** represents a positive integer.
- **Canary**: indicates a restricted release.
- **Beta**: indicates a publicly released beta version.
- **Release**: indicates a publicly released official version.
The value is set by DevEco Studio reading the stage of the SDK in use.| String| Yes (initial value: set by DevEco Studio)|
| distributedNotificationEnabled | Whether distributed notification is enabled for the application. When distributed notification is enabled and device A and device B where the application is installed are on the same distributed network, the devices behave in this way: If device A receives a message, device B will receive a distributed notification prompting the user to check the message received on device A.
- **true**: Distributed notification is enabled.
- **false**: Distributed notification is not enabled.| Boolean| Yes (initial value: **false**)|
| entityType | Type of the application. The options are as follows:
- game
- media
- communication
- news
- travel
- utility
- shopping
- education
- kids
- business
- photography
- unspecified| String| Yes (initial value: **"unspecified"**)|
diff --git a/en/application-dev/quick-start/multi-hap-release-deployment.md b/en/application-dev/quick-start/multi-hap-release-deployment.md
index 785f476bf2fa508470d433477f4e1139e76589fd..ec688879ebb61ceb595feb974f2276d700479ef5 100644
--- a/en/application-dev/quick-start/multi-hap-release-deployment.md
+++ b/en/application-dev/quick-start/multi-hap-release-deployment.md
@@ -28,12 +28,12 @@ You can use DevEco Studio to build code into one or more HAP files. Then, you ca
uninstall bundle successfully.
```
-* Using Bundle Manager (bm) for debugging
+* Using [Bundle Manager (bm)](../../application-dev/tools/bm-tool.md) for debugging
When using bm to install or update an HAP file, the HAP file path is the one on the real device. The command reference is as follows:
```
// Installation and update: Multiple file paths can be specified.
- bm install -p /data/app/entry.hap /data/app/ feature.hap
+ bm install -p /data/app/entry.hap /data/app/feature.hap
// The execution result is as follows:
install bundle successfully.
// Uninstall
diff --git a/en/application-dev/reference/apis/js-apis-inputmethod-extension-ability.md b/en/application-dev/reference/apis/js-apis-inputmethod-extension-ability.md
index 6a8cabde0302010e3739f298ba03583325491ef8..a61dd42ece2d52f0da53dd51f33770483b37757e 100644
--- a/en/application-dev/reference/apis/js-apis-inputmethod-extension-ability.md
+++ b/en/application-dev/reference/apis/js-apis-inputmethod-extension-ability.md
@@ -1,4 +1,4 @@
-# InputMethodExtensionAbility
+# @ohos.InputMethodExtensionAbility (InputMethodExtensionAbility)
The **InputMethodExtensionAbility** module provides APIs for developing input methods and managing their lifecycles.
@@ -9,7 +9,7 @@ The **InputMethodExtensionAbility** module provides APIs for developing input me
## Modules to Import
```js
-import InputMethodExtensionAbility from '@ohos.inputmethodextensionability';
+import InputMethodExtensionAbility from '@ohos.InputMethodExtensionAbility';
```
## Attributes
diff --git a/en/application-dev/reference/apis/js-apis-inputmethod-extension-context.md b/en/application-dev/reference/apis/js-apis-inputmethod-extension-context.md
index b33db13faa840a1660a42e612ef5a4d523241877..37dadd8e2ce6cd3e7c2f33ab05154f20b52cf844 100644
--- a/en/application-dev/reference/apis/js-apis-inputmethod-extension-context.md
+++ b/en/application-dev/reference/apis/js-apis-inputmethod-extension-context.md
@@ -1,4 +1,4 @@
-# @ohos.inputmethodextensioncontext (InputMethodExtensionContext)
+# @ohos.InputMethodExtensionContext (InputMethodExtensionContext)
The **InputMethodExtensionContext** module, inherited from **ExtensionContext**, provides context for **InputMethodExtension** abilities.
@@ -11,7 +11,7 @@ You can use the APIs of this module to start, terminate, connect, and disconnect
## Modules to Import
```
-import InputMethodExtensionContext from '@ohos.inputmethodextensioncontext';
+import InputMethodExtensionContext from '@ohos.InputMethodExtensionContext';
```
## Usage
@@ -19,7 +19,7 @@ import InputMethodExtensionContext from '@ohos.inputmethodextensioncontext';
Before using the **InputMethodExtensionContext** module, you must define a child class that inherits from **InputMethodExtensionAbility**.
```js
-import InputMethodExtensionAbility from '@ohos.inputmethodextensionability';
+import InputMethodExtensionAbility from '@ohos.InputMethodExtensionAbility';
class EntryAbility extends InputMethodExtensionAbility {
onCreate() {
let context = this.context;
@@ -66,9 +66,9 @@ Terminates this ability. This API uses a promise to return the result.
**Example**
```js
-this.context.destroy().then((data) => {
- console.log('success:' + JSON.stringify(data));
+this.context.destroy().then(() => {
+ console.log('Succeed in destroying context.');
}).catch((error) => {
- console.log('failed:' + JSON.stringify(error));
+ console.log('Failed to destroy context: ' + JSON.stringify(error));
});
```
diff --git a/en/application-dev/reference/apis/js-apis-inputmethod-subtype.md b/en/application-dev/reference/apis/js-apis-inputmethod-subtype.md
index 61ec49997ccb35b204f860e57b0985793598e071..8f1a3fddc9344bcf5d04a526b5c70a77837e29d0 100644
--- a/en/application-dev/reference/apis/js-apis-inputmethod-subtype.md
+++ b/en/application-dev/reference/apis/js-apis-inputmethod-subtype.md
@@ -1,6 +1,6 @@
-# @ohos.inputmethodsubtype
+# @ohos.InputMethodSubtype (Input Method Subtype)
-The **inputMethodSubtype** module provides APIs for managing the attributes of input method subtypes. Different attribute settings result in different subtypes.
+The **InputMethodSubtype** module provides APIs for managing the attributes of input method subtypes. Different attribute settings result in different subtypes.
> **NOTE**
>
@@ -9,7 +9,7 @@ The **inputMethodSubtype** module provides APIs for managing the attributes of i
## Modules to Import
```
-import inputMethodEngine from '@ohos.inputMethodSubtype';
+import InputMethodSubtype from '@ohos.InputMethodSubtype';
```
## Attributes
diff --git a/en/application-dev/reference/apis/js-apis-inputmethod.md b/en/application-dev/reference/apis/js-apis-inputmethod.md
index 424e48b357711a7ee94eb4b048f107d7ad4c7a3d..bdc166cd9d3b5a60636214b72311a2c8368c8d6d 100644
--- a/en/application-dev/reference/apis/js-apis-inputmethod.md
+++ b/en/application-dev/reference/apis/js-apis-inputmethod.md
@@ -1,4 +1,4 @@
-# @ohos.inputmethod
+# @ohos.inputMethod (Input Method Framework)
The **inputMethod** module provides an input method framework, which can be used to hide the keyboard, obtain the list of installed input methods, display the dialog box for input method selection, and more.
@@ -10,7 +10,7 @@ The **inputMethod** module provides an input method framework, which can be used
## Modules to Import
```js
-import inputMethod from '@ohos.inputmethod';
+import inputMethod from '@ohos.inputMethod';
```
## Constants8+
@@ -111,7 +111,7 @@ Switches to another input method. This API uses an asynchronous callback to retu
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| target | [InputMethodProperty](#inputmethodproperty8) | Yes| Input method to switch to.|
-| callback | AsyncCallback<boolean> | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined** and **data** is **true**. Otherwise, **err** is an error object. |
+| callback | AsyncCallback<boolean> | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined** and **data** is **true**. Otherwise, **err** is an error object.|
**Error codes**
@@ -160,15 +160,15 @@ Switches to another input method. This API uses a promise to return the result.
**Parameters**
-| Name| Type| Mandatory| Description|
-| -------- | -------- | -------- | -------- |
-|target | [InputMethodProperty](#inputmethodproperty8)| Yes| Input method to switch to.|
+ | Name| Type| Mandatory| Description|
+ | -------- | -------- | -------- | -------- |
+ |target | [InputMethodProperty](#inputmethodproperty8)| Yes| Input method to switch to.|
**Return value**
-| Type | Description |
-| ----------------------------------------- | ---------------------------- |
-| Promise\ | Promise used to return the result. The value **true** means that the switching is successful, and **false** means the opposite.|
+ | Type | Description |
+ | ----------------------------------------- | ---------------------------- |
+ | Promise\ | Promise used to return the result. The value **true** means that the switching is successful, and **false** means the opposite.|
**Error codes**
@@ -240,7 +240,7 @@ Switches to another subtype of the current input method. This API uses an asynch
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| target | [InputMethodSubtype](./js-apis-inputmethod-subtype.md#inputmethodsubtype)| Yes| Input method subtype to switch to.|
-| callback | AsyncCallback<boolean> | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined** and **data** is **true**. Otherwise, **err** is an error object. |
+| callback | AsyncCallback<boolean> | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined** and **data** is **true**. Otherwise, **err** is an error object.|
**Error codes**
@@ -376,7 +376,7 @@ Switches to a specified subtype of a specified input method. This API uses an as
| -------- | -------- | -------- | -------- |
|inputMethodProperty | [InputMethodProperty](#inputmethodproperty8)| Yes| Input method to switch to.|
|inputMethodSubtype | [InputMethodSubtype](./js-apis-inputmethod-subtype.md#inputmethodsubtype)| Yes| Input method subtype to switch to.|
-| callback | AsyncCallback<boolean> | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined** and **data** is **true**. Otherwise, **err** is an error object. |
+| callback | AsyncCallback<boolean> | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined** and **data** is **true**. Otherwise, **err** is an error object.|
**Error codes**
@@ -557,7 +557,7 @@ Ends this input session. The invoking of this API takes effect only after the in
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
-| callback | AsyncCallback<boolean> | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined** and **data** is **true**. Otherwise, **err** is an error object. |
+| callback | AsyncCallback<boolean> | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined** and **data** is **true**. Otherwise, **err** is an error object.|
**Error codes**
@@ -643,7 +643,7 @@ Shows this soft keyboard. This API must be used with the input text box and work
| Name | Type | Mandatory| Description |
| -------- | ------------------------- | ---- | ---------- |
-| callback | AsyncCallback<void> | Yes | Callback used to return the result. If the operation is successful, **err** is **undefined**. Otherwise, **err** is an error object. |
+| callback | AsyncCallback<void> | Yes | Callback used to return the result. If the operation is successful, **err** is **undefined**. Otherwise, **err** is an error object.|
**Error codes**
@@ -715,7 +715,7 @@ Hides this soft keyboard. This API must be used with the input text box and work
| Name | Type | Mandatory| Description |
| -------- | ------------------------- | ---- | ---------- |
-| callback | AsyncCallback<void> | Yes | Callback used to return the result. If the operation is successful, **err** is **undefined**. Otherwise, **err** is an error object. |
+| callback | AsyncCallback<void> | Yes | Callback used to return the result. If the operation is successful, **err** is **undefined**. Otherwise, **err** is an error object.|
**Error codes**
@@ -789,7 +789,7 @@ Ends this input session. The invoking of this API takes effect only after the in
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
-| callback | AsyncCallback<boolean> | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined** and **data** is **true**. Otherwise, **err** is an error object. |
+| callback | AsyncCallback<boolean> | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined** and **data** is **true**. Otherwise, **err** is an error object.|
**Example**
@@ -1157,7 +1157,7 @@ Displays a dialog box for selecting an input method. This API uses an asynchrono
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
-| callback | AsyncCallback<boolean> | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined** and **data** is **true**. Otherwise, **err** is an error object. |
+| callback | AsyncCallback<boolean> | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined** and **data** is **true**. Otherwise, **err** is an error object.|
**Error codes**
@@ -1291,7 +1291,7 @@ Displays a dialog box for selecting an input method. This API uses an asynchrono
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
-| callback | AsyncCallback<void> | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined**. Otherwise, **err** is an error object. |
+| callback | AsyncCallback<void> | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined**. Otherwise, **err** is an error object.|
**Example**
diff --git a/en/application-dev/reference/apis/js-apis-inputmethodengine.md b/en/application-dev/reference/apis/js-apis-inputmethodengine.md
index 2c87f74698434a68279b5e1c627e2a7352819a38..7cfb76e570ae3faf57fdf3ff31cd6cbcb9103eae 100644
--- a/en/application-dev/reference/apis/js-apis-inputmethodengine.md
+++ b/en/application-dev/reference/apis/js-apis-inputmethodengine.md
@@ -1,6 +1,6 @@
-# @ohos.inputmethodengine
+# @ohos.inputMethodEngine (Input Method Service)
-The **inputMethodEngine** module streamlines the interaction between input methods and applications. By calling APIs of this module, applications can be bound to input method services to accept text input through the input methods, request the keyboard to display or hide, listen for the input method status, and much more.
+The **inputMethodEngine** module streamlines the interactions between input methods and applications. By calling APIs of this module, applications can be bound to input method services to accept text input, request the keyboard to display or hide, listen for the input method status, and much more.
> **NOTE**
>
@@ -9,7 +9,7 @@ The **inputMethodEngine** module streamlines the interaction between input metho
## Modules to Import
```
-import inputMethodEngine from '@ohos.inputmethodengine';
+import inputMethodEngine from '@ohos.inputMethodEngine';
```
## Constants
@@ -203,7 +203,7 @@ Enables listening for a keyboard event. This API uses an asynchronous callback t
| Name | Type | Mandatory| Description |
| -------- | ------ | ---- | ------------------------------------------------------------ |
-| type | string | Yes | Listening type.
- The value **'keyboardShow'** indicates the keyboard display event.
- The value **'keyboardHide'** indicates the keyboard hiding event. |
+| type | string | Yes | Listening type.
- The value **'keyboardShow'** indicates the keyboard display event.
- The value **'keyboardHide'** indicates the keyboard hiding event.|
| callback | () => void | Yes | Callback used to return the result. |
**Example**
@@ -418,7 +418,7 @@ Disables listening for a keyboard event. This API uses an asynchronous callback
| Name | Type | Mandatory| Description |
| -------- | ------ | ---- | ------------------------------------------------------------ |
-| type | string | Yes | Listening type.
The value **'keyboardShow'** indicates the keyboard display event.
The value **'keyboardHide'** indicates the keyboard hiding event.|
+| type | string | Yes | Listening type.
- The value **'keyboardShow'** indicates the keyboard display event.
- The value **'keyboardHide'** indicates the keyboard hiding event.|
| callback | () => void | No | Callback used to return the result. |
**Example**
diff --git a/en/application-dev/reference/apis/js-apis-request.md b/en/application-dev/reference/apis/js-apis-request.md
index d3a0eeb30ea75a3109b6917d50b7b1d24cdd2fb4..0ee58f75024c1b9a8fcbcb2319f3f75482050b61 100644
--- a/en/application-dev/reference/apis/js-apis-request.md
+++ b/en/application-dev/reference/apis/js-apis-request.md
@@ -2,7 +2,8 @@
The **request** module provides applications with basic upload, download, and background transmission agent capabilities.
-> **NOTE**
+> **NOTE**
+>
> The initial APIs of this module are supported since API version 6. Newly added APIs will be marked with a superscript to indicate their earliest API version.
@@ -35,7 +36,6 @@ The **cleartextTraffic** attribute is not involved during application developmen
The download server must support the HTTP HEAD method so that the size of the data to download can be obtained through **Content-length**. Otherwise, the download task fails. If this is the case, you can check the failure cause through [on('fail')7+](#onfail7).
-Only HTTP requests are supported. HTTPS requests are not supported.
## Constants
@@ -77,7 +77,7 @@ The table below lists the causes of download pause that may be returned by [getT
| PAUSED_QUEUED_FOR_WIFI7+ | number | 0 | Download paused and queuing for a WLAN connection, because the file size exceeds the maximum value allowed by a mobile network session.|
| PAUSED_WAITING_FOR_NETWORK7+ | number | 1 | Download paused due to a network connection problem, for example, network disconnection.|
| PAUSED_WAITING_TO_RETRY7+ | number | 2 | Download paused and then retried.|
-| PAUSED_BY_USER9+ | number | 3 | The user paused the session. |
+| PAUSED_BY_USER9+ | number | 3 | The user paused the session.|
| PAUSED_UNKNOWN7+ | number | 4 | Download paused due to unknown reasons.|
### Download Task Status Codes
@@ -128,7 +128,7 @@ For details about the error codes, see [Upload and Download Error Codes](../erro
```js
let uploadTask;
let uploadConfig = {
- url: 'http://patch',
+ url: 'https://patch',
header: { key1: "value1", key2: "value2" },
method: "POST",
files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }],
@@ -176,7 +176,7 @@ For details about the error codes, see [Upload and Download Error Codes](../erro
```js
let uploadTask;
let uploadConfig = {
- url: 'http://patch',
+ url: 'https://patch',
header: { key1: "value1", key2: "value2" },
method: "POST",
files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }],
@@ -228,7 +228,7 @@ Uploads files. This API uses a promise to return the result.
```js
let uploadTask;
let uploadConfig = {
- url: 'http://patch',
+ url: 'https://patch',
header: { key1: "value1", key2: "value2" },
method: "POST",
files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }],
@@ -270,7 +270,7 @@ Uploads files. This API uses an asynchronous callback to return the result.
```js
let uploadTask;
let uploadConfig = {
- url: 'http://patch',
+ url: 'https://patch',
header: { key1: "value1", key2: "value2" },
method: "POST",
files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }],
@@ -318,7 +318,7 @@ Uploads files. This API uses a promise to return the result.
```js
let uploadTask;
let uploadConfig = {
- url: 'http://patch',
+ url: 'https://patch',
header: { key1: "value1", key2: "value2" },
method: "POST",
files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }],
@@ -359,7 +359,7 @@ Uploads files. This API uses an asynchronous callback to return the result.
```js
let uploadTask;
let uploadConfig = {
- url: 'http://patch',
+ url: 'https://patch',
header: { key1: "value1", key2: "value2" },
method: "POST",
files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }],
@@ -376,7 +376,7 @@ Uploads files. This API uses an asynchronous callback to return the result.
## UploadTask
-Implements file uploads. Before using any APIs of this class, you must obtain an **UploadTask** object through [request.uploadFile9+](#requestuploadfile9) in promise mode or [request.uploadFile9+](#requestuploadfile9-1) in callback mode.
+Implements file uploads. Before using any APIs of this class, you must obtain an **UploadTask** object.
### on('progress')
@@ -399,8 +399,8 @@ Parameters of the callback function
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
-| uploadedSize | number | Yes| Size of the uploaded files, in bytes. |
-| totalSize | number | Yes| Total size of the files to upload, in bytes. |
+| uploadedSize | number | Yes| Size of the uploaded files, in bits. |
+| totalSize | number | Yes| Total size of the files to upload, in bits. |
**Example**
@@ -504,12 +504,12 @@ Unsubscribes from an upload event. This API uses an asynchronous callback to ret
| type | string | Yes| Type of the event to unsubscribe from. The value is **'progress'** (upload progress).|
| callback | function | No| Callback for the upload progress event.|
- Parameters of the callback function
+Parameters of the callback function
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
-| uploadedSize | number | Yes| Size of the uploaded files, in bytes. |
-| totalSize | number | Yes| Total size of the files to upload, in bytes. |
+| uploadedSize | number | Yes| Size of the uploaded files, in bits. |
+| totalSize | number | Yes| Total size of the files to upload, in bits. |
**Example**
@@ -764,7 +764,7 @@ Removes this upload task. This API uses an asynchronous callback to return the r
| -------- | -------- | -------- | -------- |
| filename | string | Yes| File name in the header when **multipart** is used.|
| name | string | Yes| Name of a form item when **multipart** is used. The default value is **file**.|
-| uri | string | Yes| Local path for storing files.
The **dataability** and **internal** protocol types are supported. However, the **internal** protocol type supports only temporary directories. Below are examples:
dataability:///com.domainname.dataability.persondata/person/10/file.txt
internal://cache/path/to/file.txt |
+| uri | string | Yes| Local path for storing files.
Only the **internal** protocol type is supported. In the value, **internal://cache/** is mandatory. Example:
internal://cache/path/to/file.txt |
| type | string | Yes| Type of the file content. By default, the type is obtained based on the extension of the file name or URI.|
@@ -1027,7 +1027,7 @@ Downloads files. This API uses an asynchronous callback to return the result.
## DownloadTask
-Implements file downloads. Before using any APIs of this class, you must obtain a **DownloadTask** object through [request.downloadFile9+](#requestdownloadfile9) in promise mode or [request.downloadFile9+](#requestdownloadfile9-1) in callback mode.
+Implements file downloads. Before using any APIs of this class, you must obtain a **DownloadTask** object.
### on('progress')
@@ -1047,12 +1047,12 @@ Subscribes to a download event. This API uses an asynchronous callback to return
| type | string | Yes| Type of the event to subscribe to. The value is **'progress'** (download progress).|
| callback | function | Yes| Callback for the download progress event.|
- Parameters of the callback function
+Parameters of the callback function
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
-| receivedSize | number | Yes| Size of the downloaded files, in bytes. |
-| totalSize | number | Yes| Total size of the files to download, in bytes. |
+| receivedSize | number | Yes| Size of the downloaded files, in bits. |
+| totalSize | number | Yes| Total size of the files to download, in bits. |
**Example**
@@ -1085,8 +1085,8 @@ Parameters of the callback function
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
-| receivedSize | number | Yes| Size of the downloaded files, in bytes. |
-| totalSize | number | Yes| Total size of the files to download, in bytes. |
+| receivedSize | number | Yes| Size of the downloaded files, in bits. |
+| totalSize | number | Yes| Total size of the files to download, in bits. |
**Example**
@@ -1252,7 +1252,7 @@ Removes this download task. This API uses a promise to return the result.
delete(callback: AsyncCallback<boolean>): void
-Removes this download task. This API uses an asynchronous callback to return the result.
+Deletes this download task. This API uses an asynchronous callback to return the result.
**Required permissions**: ohos.permission.INTERNET
@@ -1262,7 +1262,7 @@ Removes this download task. This API uses an asynchronous callback to return the
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
-| callback | AsyncCallback<boolean> | Yes| Callback used to return the task removal result.|
+| callback | AsyncCallback<boolean> | Yes| Callback used to return the task deletion result. |
**Example**
diff --git a/en/application-dev/reference/apis/js-apis-system-request.md b/en/application-dev/reference/apis/js-apis-system-request.md
index a2b939bf7d0983a25202fe11b7c5dd4ddd9d3665..675a7fb9977fb5756d8a9a84296eebf0049011cb 100644
--- a/en/application-dev/reference/apis/js-apis-system-request.md
+++ b/en/application-dev/reference/apis/js-apis-system-request.md
@@ -1,9 +1,9 @@
-# @system.request
+# @system.request (Upload and Download)
The **system.request** module provides applications with basic upload and download capabilities.
> **NOTE**
-> - The APIs of this module are deprecated since API version 9. You are advised to use [`@ohos.request`](js-apis-request.md) instead.
+> - The APIs of this module are deprecated since API version 9. You are advised to use [@ohos.request](js-apis-request.md) instead.
>
> - The initial APIs of this module are supported since API version 3. Newly added APIs will be marked with a superscript to indicate their earliest API version.
@@ -25,9 +25,9 @@ Uploads a file. This API returns no value.
**Parameters**
- | Name| Type| Mandatory| Description|
- | -------- | -------- | -------- | -------- |
- | options | [UploadRequestOptions](#uploadrequestoptions) | Yes| Upload configurations.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| options | [UploadRequestOptions](#uploadrequestoptions) | Yes| Upload configurations.|
**Example**
@@ -61,27 +61,27 @@ Uploads a file. This API returns no value.
**System capability**: SystemCapability.MiscServices.Upload
- | Name| Type| Mandatory| Description|
- | -------- | -------- | -------- | -------- |
- | url | string | Yes| URL of the upload server.|
- | data | Array<[RequestData](#requestdata)> | No| Form data in the request body.|
- | files | Array<[RequestFile](#requestfile)> | Yes| List of files to upload, which is submitted through **multipart/form-data**.|
- | header | Object | No| Request header.|
- | method | string | No| Request method, which can be **'POST'** or **'PUT'**. The default value is **POST**.|
- | success | Function | No| Called when API call is successful.|
- | fail | Function | No| Called when API call has failed.|
- | complete | Function | No| Called when API call is complete.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| url | string | Yes| URL of the upload server.|
+| data | Array<[RequestData](#requestdata)> | No| Form data in the request body.|
+| files | Array<[RequestFile](#requestfile)> | Yes| List of files to upload, which is submitted through **multipart/form-data**.|
+| header | Object | No| Request header.|
+| method | string | No| Request method, which can be **'POST'** or **'PUT'**. The default value is **POST**.|
+| success | Function | No| Called when API call is successful.|
+| fail | Function | No| Called when API call has failed.|
+| complete | Function | No| Called when API call is complete.|
**success parameter**
- | Name| Type| Mandatory| Description|
- | -------- | -------- | -------- | -------- |
- | data | [UploadResponse](#uploadresponse) | Yes| Information returned when the upload task is successful.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| data | [UploadResponse](#uploadresponse) | Yes| Information returned when the upload task is successful.|
**fail parameters**
- | Name| Type| Mandatory| Description|
- | -------- | -------- | -------- | -------- |
- | data | any | Yes| Header information returned when the upload task fails.|
- | code | number | Yes| HTTP status code returned when the upload task fails.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| data | any | Yes| Header information returned when the upload task fails.|
+| code | number | Yes| HTTP status code returned when the upload task fails.|
@@ -89,33 +89,33 @@ Uploads a file. This API returns no value.
**System capability**: SystemCapability.MiscServices.Upload
- | Name| Type| Description|
- | -------- | -------- | -------- |
- | code | number | HTTP status code returned by the server.|
- | data | string | Content returned by the server. The value type is determined by the type in the returned headers.|
- | headers | Object | Headers returned by the server.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| code | number | Yes| HTTP status code returned by the server.|
+| data | string | Yes| Content returned by the server. The value type is determined by the type in the returned headers.|
+| headers | Object | Yes| Headers returned by the server.|
## RequestFile
**System capability**: SystemCapability.MiscServices.Upload
- | Name| Type| Mandatory| Description|
- | -------- | -------- | -------- | -------- |
- | filename | string | No| File name in the header when **multipart** is used.|
- | name | string | No| Name of a form item when **multipart** is used. The default value is **file**.|
- | uri | string | Yes| Local path for storing files.|
- | type | string | No| Type of the file content. By default, the type is obtained based on the extension of the file name or URI.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| filename | string | No| File name in the header when **multipart** is used.|
+| name | string | No| Name of a form item when **multipart** is used. The default value is **file**.|
+| uri | string | Yes| Local path for storing files.|
+| type | string | No| Type of the file content. By default, the type is obtained based on the extension of the file name or URI.|
## RequestData
**System capability**: SystemCapability.MiscServices.Upload
- | Name| Type| Mandatory| Description|
- | -------- | -------- | -------- | -------- |
- | name | string | Yes| Name of the form element.|
- | value | string | Yes| Value of the form element.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| name | string | Yes| Name of the form element.|
+| value | string | Yes| Value of the form element.|
@@ -129,9 +129,9 @@ Downloads a file. This API returns no value.
**Parameters**
- | Name| Type| Mandatory| Description|
- | -------- | -------- | -------- | -------- |
- | options | [DownloadRequestOptions](#downloadrequestoptions) | Yes| Download configurations.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| options | [DownloadRequestOptions](#downloadrequestoptions) | Yes| Download configurations.|
**Example**
@@ -164,34 +164,34 @@ Downloads a file. This API returns no value.
**System capability**: SystemCapability.MiscServices.Download
- | Name| Type| Mandatory| Description|
- | -------- | -------- | -------- | -------- |
- | url | string | Yes| Resource URL.|
- | filename | string | No| Name of the file to download. The value is obtained from the current request or resource URL by default.|
- | header | Object | No| Request header.|
- | description | string | No| Download description. The default value is the file name.|
- | success | Function | No| Called when API call is successful.|
- | fail | Function | No| Called when API call has failed.|
- | complete | Function | No| Called when API call is complete.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| url | string | Yes| Resource URL.|
+| filename | string | No| Name of the file to download. The value is obtained from the current request or resource URL by default.|
+| header | Object | No| Request header.|
+| description | string | No| Download description. The default value is the file name.|
+| success | Function | No| Called when API call is successful.|
+| fail | Function | No| Called when API call has failed.|
+| complete | Function | No| Called when API call is complete.|
**success parameter**
- | Name| Type| Mandatory| Description|
- | -------- | -------- | -------- | -------- |
- | data | [DownloadResponse](#downloadresponse) | Yes| Information returned when the download task is successful.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| data | [DownloadResponse](#downloadresponse) | Yes| Information returned when the download task is successful.|
**fail parameters**
- | Name| Type| Mandatory| Description|
- | -------- | -------- | -------- | -------- |
- | data | any | Yes| Header information returned when the download task fails.|
- | code | number | Yes| HTTP status code returned when the download task fails.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| data | any | Yes| Header information returned when the download task fails.|
+| code | number | Yes| HTTP status code returned when the download task fails.|
## DownloadResponse
**System capability**: SystemCapability.MiscServices.Download
- | Name| Type| Description|
- | -------- | -------- | -------- |
- | token | string | Download token, which is used to obtain the download status|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| token | string | Yes| Download token, which is used to obtain the download status|
## request.onDownloadComplete
@@ -204,9 +204,9 @@ Listens for download task status. This API returns no value.
**Parameters**
- | Name| Type| Mandatory| Description|
- | -------- | -------- | -------- | -------- |
- | options | [OnDownloadCompleteOptions](#ondownloadcompleteoptions) | Yes| Configurations of the download task.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| options | [OnDownloadCompleteOptions](#ondownloadcompleteoptions) | Yes| Configurations of the download task.|
**Example**
@@ -231,29 +231,29 @@ Listens for download task status. This API returns no value.
**System capability**: SystemCapability.MiscServices.Download
- | Name| Type| Mandatory| Description|
- | -------- | -------- | -------- | -------- |
- | token | string | Yes| Result token returned by the download API.|
- | success | Function | No| Called when API call is successful.|
- | fail | Function | No| Called when API call has failed.|
- | complete | Function | No| Called when API call is complete.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| token | string | Yes| Result token returned by the download API.|
+| success | Function | No| Called when API call is successful.|
+| fail | Function | No| Called when API call has failed.|
+| complete | Function | No| Called when API call is complete.|
**success parameter**
- | Name| Type| Mandatory| Description|
- | -------- | -------- | -------- | -------- |
- | data | [OnDownloadCompleteResponse](#ondownloadcompleteresponse) | Yes| Information returned when the download task is successful.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| data | [OnDownloadCompleteResponse](#ondownloadcompleteresponse) | Yes| Information returned when the download task is successful.|
**fail parameters**
- | Name| Type| Mandatory| Description|
- | -------- | -------- | -------- | -------- |
- | data | any | Yes| Header information returned when the download task fails.|
- | code | number | Yes| HTTP status code returned when the download task fails.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| data | any | Yes| Header information returned when the download task fails.|
+| code | number | Yes| HTTP status code returned when the download task fails.|
## OnDownloadCompleteResponse
**System capability**: SystemCapability.MiscServices.Download
- | Name| Type| Description|
- | -------- | -------- | -------- |
- | uri | string | URI of the download file.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| uri | string | Yes| URI of the download file.|
diff --git a/en/application-dev/reference/arkui-ts/ts-basic-components-scrollbar.md b/en/application-dev/reference/arkui-ts/ts-basic-components-scrollbar.md
index f87d471b580ea09127f939d391af7a1acdaf6201..0a040213c13402688e171d048e12d67b5bb17633 100644
--- a/en/application-dev/reference/arkui-ts/ts-basic-components-scrollbar.md
+++ b/en/application-dev/reference/arkui-ts/ts-basic-components-scrollbar.md
@@ -21,7 +21,7 @@ ScrollBar(value: { scroller: Scroller, direction?: ScrollBarDirection, state?: B
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| scroller | [Scroller](ts-container-scroll.md#scroller) | Yes| Scroller, which can be bound to scrollable components.|
-| direction | ScrollBarDirection | No| Scrollbar direction in which scrollable components scroll.
Default value: **ScrollBarDirection.Vertical**|
+| direction | [ScrollBarDirection](#scrollbardirection) | No| Scrollbar direction in which scrollable components scroll.
Default value: **ScrollBarDirection.Vertical**|
| state | [BarState](ts-appendix-enums.md#barstate) | No| Scrollbar state.
Default value: **BarState.Auto**|
> **NOTE**