Merge branch 'master' of gitee.com:openharmony/docs into master

Signed-off-by: mr-yx <496043997@qq.com>

.idea/.gitignore

-# Default ignored files
-/shelf/
-/workspace.xml

.idea/docs.iml

-<?xml version="1.0" encoding="UTF-8"?>
-<module type="JAVA_MODULE" version="4">
-  <component name="NewModuleRootManager" inherit-compiler-output="true">
-    <exclude-output />
-    <content url="file://$MODULE_DIR$" />
-    <orderEntry type="inheritedJdk" />
-    <orderEntry type="sourceFolder" forTests="false" />
-  </component>
-</module>
\ No newline at end of file

.idea/gradle.xml

-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="GradleSettings">
-    <option name="linkedExternalProjectsSettings">
-      <GradleProjectSettings>
-        <option name="testRunner" value="PLATFORM" />
-        <option name="distributionType" value="LOCAL" />
-        <option name="externalProjectPath" value="$PROJECT_DIR$" />
-        <option name="gradleHome" value="C:\Program Files\Huawei\DevEco Studio 3.0.0.800\tools\gradle" />
-        <option name="gradleJvm" value="#JAVA_INTERNAL" />
-        <option name="resolveModulePerSourceSet" value="false" />
-        <option name="useQualifiedModuleNames" value="false" />
-      </GradleProjectSettings>
-    </option>
-  </component>
-</project>
\ No newline at end of file

.idea/modules.xml

-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectModuleManager">
-    <modules>
-      <module fileurl="file://$PROJECT_DIR$/.idea/docs.iml" filepath="$PROJECT_DIR$/.idea/docs.iml" />
-    </modules>
-  </component>
-</project>
\ No newline at end of file

.idea/vcs.xml

-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="VcsDirectoryMappings">
-    <mapping directory="" vcs="Git" />
-  </component>
-</project>
\ No newline at end of file

OAT.xml

@@ -38,13 +38,13 @@
                 <!--filteritem type="filename" name="*.uvwxyz" desc="Describe the reason for filtering scan results"/-->
                 <!--filteritem type="filepath" name="abcdefg/.*.uvwxyz" desc="Describe the reason for filtering scan results"/-->
                 <!--filteritem type="filepath" name="projectroot/[a-zA-Z0-9]{20,}.sh" desc="Temp files"/-->
-                <filteritem type="filename" name="en/contribute" desc="already checked"/>
+                <filteritem type="filepath" name="en/contribute" desc="already checked"/>
             </filefilter>
             <filefilter name="copyrightPolicyFilter" desc="Filters for copyright header policies">
                 <!--filteritem type="filename" name="*.uvwxyz" desc="Describe the reason for filtering scan results"/-->
                 <!--filteritem type="filepath" name="abcdefg/.*.uvwxyz" desc="Describe the reason for filtering scan results"/-->
                 <!--filteritem type="filepath" name="projectroot/[a-zA-Z0-9]{20,}.sh" desc="Temp files"/-->
-                <filteritem type="filename" name="en/contribute" desc="already checked"/>
+                <filteritem type="filepath" name="en/contribute" desc="already checked"/>
             </filefilter>
             <filefilter name="licenseFileNamePolicyFilter" desc="Filters for LICENSE file policies">
                 <!--filteritem type="filename" name="*.uvwxyz" desc="Describe the reason for filtering scan results"/-->

en/application-dev/ability/ability-assistant-guidelines.md

@@ -65,18 +65,18 @@ The ability assistant enables you to start applications, atomic services, and te
   
 - **dump**
 
-  Prints ability related information.
+  Prints ability-related information.
 
   | Name             | Level-2 Parameter            | Description                                                    |
   | ----------------- | -------------------- | ------------------------------------------------------------ |
   | -h/--help         | -                    | Prints help information.                                                  |
   | -a/--all          | -                    | Prints ability information in all missions.                                |
-  | -l/--mission-list | type (All logs are printed if this parameter is left unspecified.)| Prints mission stack information.<br>The following values are available for **type**:<br>NORMAL <br>DEFAULT_STANDARD<br>DEFAULT_SINGLE<br>LAUNCHER |
+  | -l/--mission-list | type (All logs are printed if this parameter is left unspecified.)| Prints mission stack information.<br>The following values are available for **type**:<br>- NORMAL <br>- DEFAULT_STANDARD<br>- DEFAULT_SINGLE<br>- LAUNCHER |
   | -e/--extension    | elementName          | Prints extended component information.                                          |
-  | -u/--userId       | UserId               | Prints stack information of a specified user ID. This parameter must be used together with other parameters. Example commands: aa **dump -a -u 100** and **aa dump -d -u 100**.|
+  | -u/--userId       | UserId               | Prints stack information of a specified user ID. This parameter must be used together with other parameters. <br/>Example commands: aa **dump -a -u 100** and **aa dump -d -u 100**. |
   | -d/--data         | - | Prints Data ability information.                                          |
   | -i/--ability      | AbilityRecord ID     | Prints detailed information about a specified ability.                                     |
-  | -c/--client       | - | Prints detailed ability information. This parameter must be used together with other parameters. Example commands: **aa dump -a -c** and **aa dump -i 21 -c**.|
+  | -c/--client       | - | Prints detailed ability information. This parameter must be used together with other parameters. <br/>Example commands: **aa dump -a -c** and **aa dump -i 21 -c**. |
   
   **Method**
   

en/application-dev/ability/ability-brief.md

@@ -13,7 +13,7 @@ The stage model is designed to make it easier to develop complex applications in
 | -------------- | ------------------------------------------------------------ | -------------------------------------------------------- |
 | Development mode     | Web-like APIs are provided. The UI development is the same as that of the stage model.                    | Object-oriented development mode is provided. The UI development is the same as that of the FA model.            |
 | Engine instance      | Each ability in a process exclusively uses a JS VM engine instance.              | Multiple abilities in a process share one JS VM engine instance.      |
-| Intra-process object sharing| Not supported                                                    | Supported                                                  |
+| Intra-process object sharing| Not supported.                                                  | Supported.                                                 |
 | Bundle description file    | The `config.json` file is used to describe the HAP and component information. Each component must use a fixed file name.| The `module.json` file is used to describe the HAP and component information. The entry file name can be specified.|
 | Component          | Four types of components are provided: Page ability (used for UI page display), Service ability (used to provide services), Data ability (used for data sharing), and Form ability (used to provide widgets).| Two types of components are provided: Ability (used for UI page display) and Extension (scenario-based service extension).  |
 

en/application-dev/ability/fa-serviceability.md

@@ -238,7 +238,7 @@ You can use either of the following methods to connect to a Service ability:
     }
     ```
 
-### Connecting to a Remote Service Ability (Applying only to System Applications)
+### Connecting to a Remote Service Ability
 
 >**NOTE**
 >

en/application-dev/ability/stage-ability.md

 # Ability Development
 ## When to Use
-Unlike the FA model, the [stage model](stage-brief.md) requires you to declare the application package structure in the `module.json` and `app.json` files during application development. For details about the configuration file, see [Application Package Structure Configuration File](../quick-start/stage-structure.md). To develop abilities based on the stage model, implement the following logic:
-- Create abilities for an application that involves screen viewing and human-machine interaction. You must implement the following scenarios: ability lifecycle callbacks, obtaining ability configuration, requesting permissions, and notifying environment changes.
+Ability development in the [stage model](stage-brief.md) is significantly different from that in the FA model. The stage model requires you to declare the application package structure in the `module.json` and `app.json` files during application development. For details about the configuration file, see [Application Package Structure Configuration File](../quick-start/stage-structure.md). To develop an ability based on the stage model, implement the following logic:
+- Create an ability that supports screen viewing and human-machine interaction. You must implement the following scenarios: ability lifecycle callbacks, obtaining ability configuration, requesting permissions, and notifying environment changes.
 - Start an ability. You need to implement ability startup on the same device, on a remote device, or with a specified UI page.
 - Call abilities. For details, see [Call Development](stage-call.md).
 - Connect to and disconnect from a Service Extension ability. For details, see [Service Extension Ability Development](stage-serviceextension.md).
 - Continue the ability on another device. For details, see [Ability Continuation Development](stage-ability-continuation.md).
 
 ### Launch Type
-The ability supports three launch types: singleton, multi-instance, and instance-specific. Each launch type, specified by `launchType` in the `module.json` file, specifies the action that can be performed when the ability is started.
+An ability can be launched in the **standard**, **singleton**, or **specified** mode, as configured by `launchType` in the `module.json` file. Depending on the launch type, the action performed when the ability is started differs, as described below.
 
-| Launch Type    | Description    |Description            |
+| Launch Type    | Description    |Action            |
 | ----------- | -------  |---------------- |
 | standard    | Multi-instance  | A new instance is started each time an ability starts.|
-| singleton   | Singleton  | Only one instance exists in the system. If an instance already exists when an ability is started, that instance is reused.|
+| singleton   | Singleton  | The ability has only one instance in the system. If an instance already exists when an ability is started, that instance is reused.|
 | specified   | Instance-specific| The internal service of an ability determines whether to create multiple instances during running.|
 
 By default, the singleton mode is used. The following is an example of the `module.json` file:
@@ -145,9 +145,9 @@ export default class MainAbility extends Ability {
 }
 ```
 ### Requesting Permissions
-If an application needs to obtain user privacy information or use system capabilities, for example, obtaining location information or using the camera to take photos or record videos, it must request the permission from consumers. During application development, you need to specify the involved sensitive permissions, declare the required permissions in `module.json`, and use the `requestPermissionsFromUser` API to request the permission from consumers in the form of a dialog box. The following uses the permissions for calendar access as an example.
+If an application needs to obtain user privacy information or use system capabilities, for example, obtaining location information or using the camera to take photos or record videos, it must request the respective permission from consumers. During application development, you need to specify the involved sensitive permissions, declare the required permissions in `module.json`, and use the `requestPermissionsFromUser` API to request the permission from consumers in the form of a dialog box. The following uses the permission for calendar access as an example.
 
-Declare the required permissions in the `module.json` file.
+Declare the required permission in the `module.json` file.
 ```json
 "requestPermissions": [
     {
@@ -155,7 +155,7 @@ Declare the required permissions in the `module.json` file.
     }
 ]
 ```
-Request the permissions from consumers in the form of a dialog box:
+Request the permission from consumers in the form of a dialog box:
 ```ts
 let context = this.context
 let permissions: Array<string> = ['ohos.permission.READ_CALENDAR']
@@ -166,11 +166,11 @@ context.requestPermissionsFromUser(permissions).then((data) => {
 })
 ```
 ### Notifying of Environment Changes
-Environment changes include changes of global configurations and ability configurations. Currently, the global configurations include the system language and color mode. The change of global configurations is generally triggered by the configuration item in **Settings** or the icon in **Control Panel**. The ability configuration is specific to a single `Ability` instance, including the display ID, screen resolution, and screen orientation. The configuration is related to the display where the ability is located, and the change is generally triggered by the window. For details on the configuration, see [Configuration](../reference/apis/js-apis-configuration.md).
+Environment changes include changes of global configurations and ability configurations. Currently, the global configurations include the system language and color mode. The change of global configurations is generally triggered by configuration items in **Settings** or icons in **Control Panel**. The ability configuration is specific to a single `Ability` instance, including the display ID, screen resolution, and screen orientation. The configuration is related to the display where the ability is located, and the change is generally triggered by the window. For details on the configuration, see [Configuration](../reference/apis/js-apis-configuration.md).
 
 For an application in the stage model, when the configuration changes, its abilities are not restarted, but the `onConfigurationUpdated(config: Configuration)` callback is triggered. If the application needs to perform processing based on the change, you can overwrite `onConfigurationUpdated`. Note that the `Configuration` object in the callback contains all the configurations of the current ability, not only the changed configurations.
 
-The following example shows the implement of the `onConfigurationUpdated` callback in the `AbilityStage` class. The callback is triggered when the system language and color mode are changed.  
+The following example shows the implementation of the `onConfigurationUpdated` callback in the `AbilityStage` class. The callback is triggered when the system language and color mode are changed.  
 ```ts
 import Ability from '@ohos.application.Ability'
 import ConfigurationConstant from '@ohos.application.ConfigurationConstant'
@@ -184,7 +184,7 @@ export default class MyAbilityStage extends AbilityStage {
 }
 ```
 
-The following example shows the implement of the `onConfigurationUpdated` callback in the `Ability` class. The callback is triggered when the system language, color mode, or display parameters (such as the direction and density) change.  
+The following example shows the implementation of the `onConfigurationUpdated` callback in the `Ability` class. The callback is triggered when the system language, color mode, or display parameters (such as the direction and density) change.  
 ```ts
 import Ability from '@ohos.application.Ability'
 import ConfigurationConstant from '@ohos.application.ConfigurationConstant'
@@ -205,7 +205,7 @@ export default class MainAbility extends Ability {
 ```
 ## Starting an Ability
 ### Available APIs
-The `Ability` class has the `context` attribute, which belongs to the `AbilityContext` class. The `AbilityContext` class has the `abilityInfo`, `currentHapModuleInfo`, and other attributes and the APIs used for starting abilities. For details, see [AbilityContext](../reference/apis/js-apis-ability-context.md).
+The `Ability` class has the `context` attribute, which belongs to the `AbilityContext` class. The `AbilityContext` class has the `abilityInfo`, `currentHapModuleInfo`, and other attributes as well as the APIs used for starting abilities. For details, see [AbilityContext](../reference/apis/js-apis-ability-context.md).
 
 **Table 3** AbilityContext APIs
 |API|Description|
@@ -235,9 +235,8 @@ context.startAbility(want).then((data) => {
 ```
 
 ### Starting an Ability on a Remote Device
-This feature applies only to system applications, since the `getTrustedDeviceListSync` API of the `DeviceManager` class is open only to system applications.
+>This feature applies only to system applications, since the `getTrustedDeviceListSync` API of the `DeviceManager` class is open only to system applications.
 In the cross-device scenario, you must specify the ID of the remote device. The sample code is as follows:
-
 ```ts
 let context = this.context
 var want = {
@@ -268,7 +267,7 @@ function getRemoteDeviceId() {
     }
 }
 ```
-Request the permission `ohos.permission.DISTRIBUTED_DATASYNC ` from consumers. This permission is used for data synchronization. For details about the sample code for requesting the permission, see [Requesting Permissions](##requesting-permissions).
+Request the permission `ohos.permission.DISTRIBUTED_DATASYNC` from consumers. This permission is used for data synchronization. For details about the sample code for requesting the permission, see [Requesting Permissions](##requesting-permissions).
 ### Starting an Ability with the Specified Page
 If the launch type of an ability is set to `singleton` and the ability has been started, the `onNewWant` callback is triggered when the ability is started again. You can pass start options through the `want`. For example, to start an ability with the specified page, use the `uri` or `parameters` parameter in the `want` to pass the page information. Currently, the ability in the stage model cannot directly use the `router` capability. You must pass the start options to the custom component and invoke the `router` method to display the specified page during the custom component lifecycle management. The sample code is as follows:
 

en/application-dev/ability/stage-brief.md

@@ -8,7 +8,7 @@ The following figure shows the design ideas of the stage model.
 
 ![stagedesign](figures/stagedesign.png)
 
-​        The stage model is designed based on the following considerations:
+The stage model is designed based on the following considerations:
 
 - **Balance between application capabilities and overall system power consumption**
 

en/application-dev/ability/stage-formextension.md

@@ -12,7 +12,8 @@ Basic concepts:
 - Widget host: an application that displays the widget content and controls the position where the widget is displayed in the host application.
 - Widget Manager: a resident agent that manages widgets added to the system and provides functions such as periodic widget update.
 
-> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**
+> **NOTE**
+>
 > The widget host and provider do not keep running all the time. The Widget Manager starts the widget provider to obtain widget information when a widget is added, deleted, or updated.
 
 You only need to develop widget content as the widget provider. The system automatically handles the work done by the widget host and Widget Manager.
@@ -187,7 +188,7 @@ To create a widget in the stage model, implement the lifecycle callbacks of **Fo
   {
       "forms": [{
           "name": "widget",
-          "description": "This is a service widget.",
+          "description": "This is a widget.",
           "src": "./js/widget/pages/index/index",
           "window": {
               "autoDesignWidth": true,

en/application-dev/ability/stage-serviceextension.md

@@ -39,7 +39,7 @@ OpenHarmony does not support creation of a Service Extension ability for third-p
    ```
 
 
-2. Customize a class that inherits from **ServiceExtensionAbility** in the .ts file in the directory where the Service Extension ability is defined and overwrite the lifecycle callbacks of the base class. The code sample is as follows:
+2. Customize a class that inherits from **ServiceExtensionAbility** in the .ts file in the directory where the Service Extension ability is defined and override the lifecycle callbacks of the base class. The code sample is as follows:
 
     ```js
     import rpc from '@ohos.rpc'

en/application-dev/device/Readme-EN.md

@@ -13,6 +13,6 @@
 - Vibrator
   - [Vibrator Overview](vibrator-overview.md)
   - [Vibrator Development](vibrator-guidelines.md)
-- Update Servcie
+- Update Service
   - [Sample Server Overview](sample-server-overview.md)
   - [Sample Server Development](sample-server-guidelines.md)

en/application-dev/internationalization/i18n-guidelines.md

@@ -4,7 +4,7 @@ This development guide describes how to use i18n APIs that are not defined in EC
 
 ## Obtaining System Language and Region Information
 
-APIs are provided to access the system language and region information.
+You can use APIs provided in the following table to obtain the system language and region information.
 
 
 ### Available APIs
@@ -344,14 +344,14 @@ When a text is displayed in more than one line, [BreakIterator](../reference/api
 
    
    ```
-   var firstPos = breakIterator.first(); // Sets a BreakIterator object to the first break point, that is, the start position of the text.
-   var lastPos = breakIterator.last(); // Sets a BreakIterator object to the last break point, that is, the position after the text end.
-   // Moves a BreakIterator object forward or backward by a certain number of break points.
+   var firstPos = breakIterator.first(); // Set a BreakIterator object to the first break point, that is, the start position of the text.
+   var lastPos = breakIterator.last(); // Set a BreakIterator object to the last break point, that is, the position after the text end.
+   // Move a BreakIterator object forward or backward by a certain number of break points.
    // If a positive number is input, move backward. If a negative number is input, move forward. If no value is input, move one position backward.
    // When the object is moved out of the text length range, -1 is returned.
    var nextPos = breakIterator.next(-2);
-   var previousPos = breakIterator.previous(); // Moves a BreakIterator object to the previous break point. When the text length is out of the range, -1 is returned.
-   // Moves a BreakIterator object to the break point following the position specified by offset. If the object is moved out of the text length range, -1 is returned.
+   var previousPos = breakIterator.previous(); // Move a BreakIterator object to the previous break point. When the text length is out of the range, -1 is returned.
+   // Move a BreakIterator object to the break point following the position specified by offset. If the object is moved out of the text length range, -1 is returned.
    var followingPos = breakIterator.following(10); 
    ```
 

en/application-dev/internationalization/intl-guidelines.md

@@ -103,7 +103,7 @@ Use [DateTimeFormat](../reference/apis/js-apis-intl.md) APIs to format the date
    ```
 
 2. Format the date and time.<br>
-   Call the **format** method to format a **Date** object. This method returns a string representing the formatting result.
+   Call the **format** method to format the date and time in the **DateTimeFormat** object. This method returns a string representing the formatting result.
      
    ```
    Date date = new Date();
@@ -111,7 +111,7 @@ Use [DateTimeFormat](../reference/apis/js-apis-intl.md) APIs to format the date
    ```
 
 3. Format a period.<br>
-   Call the **formatRange** method to format a period. This method requires input of two **Date** objects, which respectively indicate the start date and end date of a period. This method returns a string representing the formatting result.
+   Call the **formatRange** method to format the period in the **DateTimeFormat** object. This method requires input of two **Date** objects, which respectively indicate the start date and end date of a period. This method returns a string representing the formatting result.
      
    ```
    Date startDate = new Date();
@@ -127,9 +127,9 @@ Use [DateTimeFormat](../reference/apis/js-apis-intl.md) APIs to format the date
    ```
 
 
-## Number Formatting
+## Formatting Numbers
 
-Use [NumberFormat](../reference/apis/js-apis-intl.md) APIs to format a number for a specific locale.
+Use [NumberFormat](../reference/apis/js-apis-intl.md) APIs to format numbers for a specific locale.
 
 
 ### Available APIs
@@ -175,7 +175,7 @@ Use [NumberFormat](../reference/apis/js-apis-intl.md) APIs to format a number fo
    ```
 
 
-## String Sorting
+## Sorting Strings
 
 Use [Collator](../reference/apis/js-apis-intl.md) APIs to sort strings based on a specific locale. Users in different regions have different preferences for string sorting.
 
@@ -262,7 +262,7 @@ Use [PluralRules](../reference/apis/js-apis-intl.md) APIs to determine the singu
    ```
 
 
-## Formatting Relative Time
+## Formatting the Relative Time
 
 Use [RelativeTimeFormat](../reference/apis/js-apis-intl.md) APIs to format the relative time for a specific locale.
 

en/application-dev/napi/native-window-guidelines.md

@@ -56,7 +56,7 @@ The following steps describe how to use `OH_NativeXComponent` in OpenHarmony to
 3. Define the callback `OnSurfaceCreated`. During the creation of a `Surface`, the callback is used to initialize the rendering environment, for example, the `Skia` rendering environment, and write the content to be displayed to `NativeWindow`.
 
     ```c++
-    void OnSufaceCreatedCB(NativeXComponent* component, void* window) {
+    void OnSurfaceCreatedCB(NativeXComponent* component, void* window) {
         // Obtain the width and height of the native window.
         uint64_t width_ = 0, height_ = 0;
         OH_NativeXComponent_GetXComponentSize(nativeXComponent, window, &width_, &height_);
@@ -89,8 +89,8 @@ The following steps describe how to use `OH_NativeXComponent` in OpenHarmony to
         // Create Skia Canvas and write the content to the native window.
         ...
 
-        // After the write operation is complete, flush the buffer by using OH_NativeWindwo_NativeWindowFlushBuffer so that the data is displayed on the screen.
-        Regoin region{nullptr, 0};
+        // After the write operation is complete, flush the buffer by using OH_NativeWindow_NativeWindowFlushBuffer so that the data is displayed on the screen.
+        Region region{nullptr, 0};
         OH_NativeWindow_NativeWindowFlushBuffer(nativeWindow_, buffer, fenceFd, region)
     }
     ```
@@ -99,9 +99,9 @@ The following steps describe how to use `OH_NativeXComponent` in OpenHarmony to
 
     ```c++
     OH_NativeXComponent_Callback &callback_;
-    callback_->OnSurfaceCreated = OnSufaceCreatedCB;
-    callback_->OnSurfaceChanged = OnSufaceChangedCB;
-    callback_->OnSurfaceDestoryed = OnSufaceDestoryedCB;
+    callback_->OnSurfaceCreated = OnSurfaceCreatedCB;
+    callback_->OnSurfaceChanged = OnSurfaceChangedCB;
+    callback_->OnSurfaceDestoryed = OnSurfaceDestoryedCB;
     callback_->DispatchTouchEvent = DispatchTouchEventCB;
     OH_NativeXComponent_RegisterCallback(nativeXComponent, callback_)
     ```

en/application-dev/quick-start/Readme-EN.md

@@ -11,4 +11,4 @@
   - [Application Package Structure Configuration File (Stage Model)](stage-structure.md)
   - [Resource File Categories](basic-resource-file-categories.md)
   - [SysCap](syscap.md)
-
+  - [HarmonyAppProvision Configuration File](app-provision-structure.md)

en/application-dev/quick-start/app-provision-structure.md

+#  HarmonyAppProvision Configuration File
+The **HarmonyAppProvision** configuration file (also called profile) is the file where you declare permission and signature information for your application.
+
+## Configuration File Internal Structure
+The **HarmonyAppProvision** file consists of several parts, which are described in the table below.
+
+**Table 1** Configuration file internal structure
+| Name    | Description                                                                                    | Data Type| Mandatory | Initial Value Allowed|
+| ----------- | ---------------------------------------------------------------------------------------- | -------- | -------- | -------- |
+| version-code | Version number of the **HarmonyAppProvision** file format. The value is a positive integer containing 32 or less digits.| Number  | Yes | No                |
+| version-name     | Description of the version number. It is recommended that the value consist of three segments, for example, **A.B.C**.       | String  | Yes | No|
+| uuid    | Unique ID of the **HarmonyAppProvision** file.                      | String    | Yes | No|
+| type | Type of the **HarmonyAppProvision** file. The value can be **debug** (for application debugging) and **release** (for application release). The recommended value is **debug**.| String    | Yes | No|
+| issuer | Issuer of the **HarmonyAppProvision** file.       | String    | Yes | No|
+| validity    | Validity period of the **HarmonyAppProvision** file. For details, see [Internal Structure of the validity Object](#internal-structure-of-the-validity-object). | Object    | Yes | No |
+| bundle-info | Information about the application bundle and developer. For details, see [Internal Structure of the bundle-info Object](#internal-structure-of-the-bundle-info-object).        | Object    | Yes | No |
+| acls        | Information about the Access Control Lists (ACLs). For details, see [Internal Structure of the acls Object](#internal-structure-of-the-acls-object).                          | Object    | No | No   |
+| permissions | Permissions required for your application. For details, see [Internal Structure of the permissions Object](#internal-structure-of-the-permissions-object).     | Object    | No | No   |
+| debug-info  | Additional debug information. For details, see [Internal Structure of the debug-info Object](#internal-structure-of-the-debug-info-object).         | Object    | No | No        |
+
+An example of the **HarmonyAppProvision** file is as follows:
+```json
+{
+    "version-code": 1,
+    "version-name": "1.0.0",
+	"uuid": "string",
+	"type": "debug",
+	"validity": {
+		"not-before": 1586422743,
+		"not-after": 1617958743
+	},
+	"bundle-info" : {
+		"developer-id": "OpenHarmony",
+		"development-certificate": "Base64 string",
+		"distribution-certificate": "Base64 string",
+		"bundle-name": "com.OpenHarmony.app.test",
+		"apl": "normal",
+        "app-feature": "hos_normal_app"
+	},
+	"acls": {
+		"allowed-acls": ["string"]
+    },
+	"permissions": {
+		"restricted-permissions": ["string"]
+    },
+    "debug-info" : {
+	    "device-id-type": "udid",
+	    "device-ids": ["string"]
+    },
+    "issuer": "OpenHarmony"
+}
+
+```
+
+
+### Internal Structure of the validity Object
+| Name   | Description                           | Data Type| Mandatory | Initial Value Allowed|
+| ---------- | ------------------------------- | ------- | ------- | --------- |
+| not-before | Start time of the file validity period. The value is a Unix timestamp, which is a non-negative integer.| Number   | Yes | No  |
+| not-after  | End time of the file validity period. The value is a Unix timestamp, which is a non-negative integer.| Number   | Yes | No  |
+
+### Internal Structure of the bundle-info Object
+| Name                 | Description                           | Data Type| Mandatory | Initial Value Allowed|
+| ------------------------ | ------------------------------- | ------- | -------- | --------- |
+| developer-id | Unique ID of the developer.| String   | Yes | No  |
+| development-certificate  | Information about the [debug certificate](../security/hapsigntool-guidelines.md).| Number   | Yes if **type** is set to **debug** and no otherwise | No  |
+| distribution-certificate  | Information about the [release certificate](../security/hapsigntool-guidelines.md).| Number   | Yes if **type** is set to **release** and no otherwise | No  |
+| bundle-name  | Bundle name of the application.| String   | Yes | No  |
+| apl  | [Ability privilege level (APL)](../security/accesstoken-overview.md) of your application. The value can be **normal**, **system_basic**, or **system_core**.| String   | Yes | No  |
+| app-feature  | Type of your application. The value can be **hos_system_app** (system application) or **hos_normal_app** (non-system application).| String   | Yes | No  |
+
+
+### Internal structure of the acls Object
+The **acls** object contains the [ACLs](../security/accesstoken-overview.md) configured for your application. It should be noted that you still need to fill the ACL information in the **reqPermissions** attribute in the [config.json](package-structure.md) file.
+
+**Table 4** Internal structure of the acls object
+
+| Name                 | Description                           | Data Type| Mandatory | Initial Value Allowed|
+| ------------------------ | ------------------------------- | ------- | ------- | --------- |
+| allowed-acls | [ACLs](../security/accesstoken-overview.md) configured for your application.| String array   | No | No  |
+
+### Internal Structure of the permissions Object
+The **permissions** object contains restricted permissions required for your application. Different from the ACLs set in the **acls** object, these permissions need user authorization during the running of your application. It should be noted that you still need to fill the permission information in the **reqPermissions** attribute in the [config.json](package-structure.md) file.
+
+**Table 5** Internal structure of the permissions object
+
+| Name                 | Description                           | Data Type| Mandatory | Initial Value Allowed|
+| ------------------------ | ------------------------------- | ------- | ------- | --------- |
+| restricted-permissions | [Restricted permissions](../security/accesstoken-overview.md) required for your application.| String array   | No | No  |
+
+### Internal Structure of the debug-info Object
+The **debug-info** object contains debug information of your application, mainly device management and control information.
+
+**Table 6** Internal structure of the debug-info object
+
+| Name                 | Description                           | Data Type| Mandatory | Initial Value Allowed|
+| ------------------------ | ------------------------------- | ------- | ------- | --------- |
+| device-id-type | Type of the device ID. Currently, only the udid type is supported.| String   | No | No  |
+| device-ids | IDs of devices on which your application can be debugged.| String array   | No | No  |

en/application-dev/reference/apis/js-apis-bluetooth.md

 # Bluetooth
 
-> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**<br/>
+> **NOTE**<br>
 > The initial APIs of this module are supported since API version 7. Newly added APIs will be marked with a superscript to indicate their earliest API version.
->
->  The Bluetooth module provides Classic Bluetooth capabilities and Bluetooth Low Energy (BLE) scan and advertising.
+
+Provides classic Bluetooth capabilities and Bluetooth Low Energy (BLE) scan and advertising.
 
 
 ## Modules to Import
@@ -201,7 +201,7 @@ Obtains the connection state of a profile.
 
 | Name      | Type       | Mandatory  | Description                                   |
 | --------- | --------- | ---- | ------------------------------------- |
-| ProfileId | profileId | Yes   | ID of the target profile, for example, **PROFILE_A2DP_SOURCE**.|
+| ProfileId | profileId | Yes   | ID of the profile to obtain, for example, **PROFILE_A2DP_SOURCE**.|
 
 **Return value**
 
@@ -212,7 +212,7 @@ Obtains the connection state of a profile.
 **Example**
 
 ```js
-let result = bluetooth.getProfileConnState(PROFILE_A2DP_SOURCE);
+let result = bluetooth.getProfileConnState(bluetooth.ProfileId.PROFILE_A2DP_SOURCE);
 ```
 
 
@@ -355,7 +355,7 @@ Sets the Bluetooth scan mode so that the device can be discovered by a remote de
 
 ```js
 // The device can be discovered and connected only when the discoverable and connectable mode is used.
-let result = bluetooth.setBluetoothScanMode(ScanMode.SCAN_MODE_CONNECTABLE_GENERAL_DISCOVERABLE, 100);
+let result = bluetooth.setBluetoothScanMode(bluetooth.ScanMode.SCAN_MODE_CONNECTABLE_GENERAL_DISCOVERABLE, 100);
 ```
 
 
@@ -720,7 +720,7 @@ bluetooth.off('stateChange', onReceiveEvent);
 ```
 
 
-## bluetooth.sppListen<sup>8+</sup><a name="sppListen<"></a>
+## bluetooth.sppListen<sup>8+</sup><a name="sppListen"></a>
 
 sppListen(name: string, option: SppOption, callback: AsyncCallback&lt;number&gt;): void
 
@@ -773,6 +773,14 @@ Listens for a connection to be made to this socket from the client and accepts i
 **Example**
 
 ```js
+let serverNumber = -1;
+function serverSocket(code, number) {
+  console.log('bluetooth error code: ' + code.code);
+  if (code.code == 0) {
+    console.log('bluetooth serverSocket Number: ' + number);
+    serverNumber = number;
+  }
+}
 let clientNumber = -1;
 function acceptClientSocket(code, number) {
   console.log('bluetooth error code: ' + code.code);
@@ -807,6 +815,7 @@ Initiates an SPP connection to a remote device from the client.
 **Example**
 
 ```js
+
 let clientNumber = -1;
 function clientSocket(code, number) {
   if (code.code != 0) {
@@ -838,6 +847,14 @@ Closes the listening socket of the server.
 **Example**
 
 ```js
+let serverNumber = -1;
+function serverSocket(code, number) {
+  console.log('bluetooth error code: ' + code.code);
+  if (code.code == 0) {
+    console.log('bluetooth serverSocket Number: ' + number);
+    serverNumber = number;
+  }
+}
 bluetooth.sppCloseServerSocket(serverNumber);
 ```
 
@@ -860,6 +877,15 @@ Closes the client socket.
 **Example**
 
 ```js
+let clientNumber = -1;
+function clientSocket(code, number) {
+  if (code.code != 0) {
+    return;
+  }
+  console.log('bluetooth serverSocket Number: ' + number);
+  // The obtained clientNumber is used as the socket ID for subsequent read/write operations on the client.
+  clientNumber = number;
+}
 bluetooth.sppCloseClientSocket(clientNumber);
 ```
 
@@ -888,6 +914,15 @@ Writes data to the remote device through the socket.
 **Example**
 
 ```js
+let clientNumber = -1;
+function clientSocket(code, number) {
+  if (code.code != 0) {
+    return;
+  }
+  console.log('bluetooth serverSocket Number: ' + number);
+  // The obtained clientNumber is used as the socket ID for subsequent read/write operations on the client.
+  clientNumber = number;
+}
 let arrayBuffer = new ArrayBuffer(8);
 let data = new Uint8Array(arrayBuffer);
 data[0] = 123;
@@ -923,6 +958,15 @@ No value is returned.
 **Example**
 
 ```js
+let clientNumber = -1;
+function clientSocket(code, number) {
+  if (code.code != 0) {
+    return;
+  }
+  console.log('bluetooth serverSocket Number: ' + number);
+  // The obtained clientNumber is used as the socket ID for subsequent read/write operations on the client.
+  clientNumber = number;
+}
 function dataRead(dataBuffer) {
   let data = new Uint8Array(dataBuffer);
   console.log('bluetooth data is: ' + data[0]);
@@ -954,6 +998,15 @@ No value is returned.
 **Example**
 
 ```js
+let clientNumber = -1;
+function clientSocket(code, number) {
+  if (code.code != 0) {
+    return;
+  }
+  console.log('bluetooth serverSocket Number: ' + number);
+  // The obtained clientNumber is used as the socket ID for subsequent read/write operations on the client.
+  clientNumber = number;
+}
 bluetooth.off('sppRead', clientNumber);
 ```
 
@@ -981,14 +1034,14 @@ Obtains a profile object.
 **Example**
 
 ```js
-let a2dpSrc = bluetooth.getProfile(PROFILE_A2DP_SOURCE);
+let a2dpSrc = bluetooth.getProfile(bluetooth.ProfileId.PROFILE_A2DP_SOURCE);
 ```
 
 ## bluetooth.getProfile<sup>9+</sup><a name="getProfile"></a>
 
 getProfile(profileId: ProfileId): A2dpSourceProfile | HandsFreeAudioGatewayProfile | HidHostProfile
 
-Obtains the profile object instance based on **ProfileId**. API version 9 is added with **HidHostProfile**.
+Obtains a profile instance. **HidHostProfile** is added in API version 9.
 
 **System capability**: SystemCapability.Communication.Bluetooth.Core
 
@@ -996,7 +1049,7 @@ Obtains the profile object instance based on **ProfileId**. API version 9 is add
 
 | Name      | Type       | Mandatory  | Description                                   |
 | --------- | --------- | ---- | ------------------------------------- |
-| profileId | [ProfileId](#ProfileId) | Yes   | ID of the target profile, for example, **PROFILE_A2DP_SOURCE**.|
+| profileId | [ProfileId](#ProfileId) | Yes   | ID of the profile to obtain, for example, **PROFILE_A2DP_SOURCE**.|
 
 **Return value**
 
@@ -1007,7 +1060,7 @@ Obtains the profile object instance based on **ProfileId**. API version 9 is add
 **Example**
 
 ```js
-let hidHost = bluetooth.getProfile(PROFILE_HID_HOST);
+let hidHost = bluetooth.getProfile(bluetooth.ProfileId.PROFILE_HID_HOST);
 ```
 
 
@@ -1239,7 +1292,7 @@ No value is returned.
 **Example**
 
 ```js
-let a2dpSrc = bluetooth.getProfile(PROFILE_A2DP_SOURCE)
+let a2dpSrc = bluetooth.getProfile(bluetooth.ProfileId.PROFILE_A2DP_SOURCE)
 let retArray = a2dpSrc.getConnectionDevices();
 ```
 
@@ -1257,7 +1310,7 @@ Obtains the connection state of the profile.
 
 | Name   | Type    | Mandatory  | Description     |
 | ------ | ------ | ---- | ------- |
-| device | string | Yes   | Address of the remote device.|
+| device | string | Yes   | Address of the target device.|
 
 **Return value**
 
@@ -1268,7 +1321,7 @@ Obtains the connection state of the profile.
 **Example**
 
 ```js
-let a2dpSrc = bluetooth.getProfile(PROFILE_A2DP_SOURCE)
+let a2dpSrc = bluetooth.getProfile(bluetooth.ProfileId.PROFILE_A2DP_SOURCE)
 let ret = a2dpSrc.getDeviceState('XX:XX:XX:XX:XX:XX');
 ```
 
@@ -1277,7 +1330,7 @@ let ret = a2dpSrc.getDeviceState('XX:XX:XX:XX:XX:XX');
 Before using a method of **A2dpSourceProfile**, you need to create an instance of this class by using the **getProfile()** method.
 
 
-### connect<sup>8+</sup><a name="connect"></a>
+### connect<sup>8+</sup><a name="a2dp-connect"></a>
 
 connect(device: string): boolean
 
@@ -1302,12 +1355,12 @@ Sets up an Advanced Audio Distribution Profile (A2DP) connection.
 **Example**
 
 ```js
-let a2dpSrc = bluetooth.getProfile(PROFILE_A2DP_SOURCE)
+let a2dpSrc = bluetooth.getProfile(bluetooth.ProfileId.PROFILE_A2DP_SOURCE)
 let ret = a2dpSrc.connect('XX:XX:XX:XX:XX:XX');
 ```
 
 
-### disconnect<sup>8+</sup><a name="disconnect"></a>
+### disconnect<sup>8+</sup><a name="a2dp-disconnect"></a>
 
 disconnect(device: string): boolean
 
@@ -1332,7 +1385,7 @@ Disconnects an A2DP connection.
 **Example**
 
 ```js
-let a2dpSrc = bluetooth.getProfile(PROFILE_A2DP_SOURCE);
+let a2dpSrc = bluetooth.getProfile(bluetooth.ProfileId.PROFILE_A2DP_SOURCE);
 let ret = a2dpSrc.disconnect('XX:XX:XX:XX:XX:XX');
 ```
 
@@ -1362,7 +1415,7 @@ No value is returned.
 function onReceiveEvent(data) {
     console.info('a2dp state = '+ JSON.stringify(data));
 }
-let a2dpSrc = bluetooth.getProfile(PROFILE_A2DP_SOURCE);
+let a2dpSrc = bluetooth.getProfile(bluetooth.ProfileId.PROFILE_A2DP_SOURCE);
 a2dpSrc.on('connectionStateChange', onReceiveEvent);
 ```
 
@@ -1392,7 +1445,7 @@ No value is returned.
 function onReceiveEvent(data) {
     console.info('a2dp state = '+ JSON.stringify(data));
 }
-let a2dpSrc = bluetooth.getProfile(PROFILE_A2DP_SOURCE);
+let a2dpSrc = bluetooth.getProfile(bluetooth.ProfileId.PROFILE_A2DP_SOURCE);
 a2dpSrc.on('connectionStateChange', onReceiveEvent);
 a2dpSrc.off('connectionStateChange', onReceiveEvent);
 ```
@@ -1410,7 +1463,7 @@ Obtains the playing state of a device.
 
 | Name   | Type    | Mandatory  | Description     |
 | ------ | ------ | ---- | ------- |
-| device | string | Yes   | Address of the remote device.|
+| device | string | Yes   | Address of the target device.|
 
 **Return value**
 
@@ -1421,7 +1474,7 @@ Obtains the playing state of a device.
 **Example**
 
 ```js
-let a2dpSrc = bluetooth.getProfile(PROFILE_A2DP_SOURCE);
+let a2dpSrc = bluetooth.getProfile(bluetooth.ProfileId.PROFILE_A2DP_SOURCE);
 let state = a2dpSrc.getPlayingState('XX:XX:XX:XX:XX:XX');
 ```
 
@@ -1431,7 +1484,7 @@ let state = a2dpSrc.getPlayingState('XX:XX:XX:XX:XX:XX');
 Before using a method of **HandsFreeAudioGatewayProfile**, you need to create an instance of this class by using the **getProfile()** method.
 
 
-### connect<sup>8+</sup><a name="connect"></a>
+### connect<sup>8+</sup><a name="hfp-connect"></a>
 
 connect(device: string): boolean
 
@@ -1445,7 +1498,7 @@ Sets up a Hands-free Profile (HFP) connection of a device.
 
 | Name   | Type    | Mandatory  | Description     |
 | ------ | ------ | ---- | ------- |
-| device | string | Yes   | Address of the remote device.|
+| device | string | Yes   | Address of the target device.|
 
 **Return value**
 
@@ -1456,12 +1509,12 @@ Sets up a Hands-free Profile (HFP) connection of a device.
 **Example**
 
 ```js
-let hfpAg = bluetooth.getProfile(PROFILE_HANDS_FREE_AUDIO_GATEWAY);
+let hfpAg = bluetooth.getProfile(bluetooth.ProfileId.PROFILE_HANDS_FREE_AUDIO_GATEWAY);
 let ret = hfpAg.connect('XX:XX:XX:XX:XX:XX');
 ```
 
 
-### disconnect<sup>8+</sup><a name="disconnect"></a>
+### disconnect<sup>8+</sup><a name="hfp-disconnect"></a>
 
 disconnect(device: string): boolean
 
@@ -1475,7 +1528,7 @@ Disconnects the HFP connection of a device.
 
 | Name   | Type    | Mandatory  | Description     |
 | ------ | ------ | ---- | ------- |
-| device | string | Yes   | Address of the remote device.|
+| device | string | Yes   | Address of the target device.|
 
 **Return value**
 
@@ -1486,7 +1539,7 @@ Disconnects the HFP connection of a device.
 **Example**
 
 ```js
-let hfpAg = bluetooth.getProfile(PROFILE_HANDS_FREE_AUDIO_GATEWAY);
+let hfpAg = bluetooth.getProfile(bluetooth.ProfileId.PROFILE_HANDS_FREE_AUDIO_GATEWAY);
 let ret = hfpAg.disconnect('XX:XX:XX:XX:XX:XX');
 ```
 
@@ -1516,7 +1569,7 @@ No value is returned.
 function onReceiveEvent(data) {
     console.info('hfp state = '+ JSON.stringify(data));
 }
-let hfpAg = bluetooth.getProfile(PROFILE_HANDS_FREE_AUDIO_GATEWAY);
+let hfpAg = bluetooth.getProfile(bluetooth.ProfileId.PROFILE_HANDS_FREE_AUDIO_GATEWAY);
 hfpAg.on('connectionStateChange', onReceiveEvent);
 ```
 
@@ -1546,7 +1599,7 @@ No value is returned.
 function onReceiveEvent(data) {
     console.info('hfp state = '+ JSON.stringify(data));
 }
-let hfpAg = bluetooth.getProfile(PROFILE_HANDS_FREE_AUDIO_GATEWAY);
+let hfpAg = bluetooth.getProfile(bluetooth.ProfileId.PROFILE_HANDS_FREE_AUDIO_GATEWAY);
 hfpAg.on('connectionStateChange', onReceiveEvent);
 hfpAg.off('connectionStateChange', onReceiveEvent);
 ```
@@ -1573,7 +1626,7 @@ Connects to the HidHost service of a device.
 
 | Name   | Type    | Mandatory  | Description     |
 | ------ | ------ | ---- | ------- |
-| device | string | Yes   | Address of the remote device.|
+| device | string | Yes   | Address of the target device.|
 
 **Return value**
 
@@ -1584,7 +1637,7 @@ Connects to the HidHost service of a device.
 **Example**
 
 ```js
-let hidHostProfile = bluetooth.getProfile(PROFILE_HID_HOST);
+let hidHostProfile = bluetooth.getProfile(bluetooth.ProfileId.PROFILE_HID_HOST);
 let ret = hidHostProfile.connect('XX:XX:XX:XX:XX:XX');
 ```
 
@@ -1605,7 +1658,7 @@ Disconnects from the HidHost service of a device.
 
 | Name   | Type    | Mandatory  | Description     |
 | ------ | ------ | ---- | ------- |
-| device | string | Yes   | Address of the remote device.|
+| device | string | Yes   | Address of the target device.|
 
 **Return value**
 
@@ -1616,7 +1669,7 @@ Disconnects from the HidHost service of a device.
 **Example**
 
 ```js
-let hidHostProfile = bluetooth.getProfile(PROFILE_HID_HOST);
+let hidHostProfile = bluetooth.getProfile(bluetooth.ProfileId.PROFILE_HID_HOST);
 let ret = hidHostProfile.disconnect('XX:XX:XX:XX:XX:XX');
 ```
 
@@ -1646,7 +1699,7 @@ No value is returned.
 function onReceiveEvent(data) {
     console.info('hidHost state = '+ JSON.stringify(data));
 }
-let hidHost = bluetooth.getProfile(PROFILE_HID_HOST);
+let hidHost = bluetooth.getProfile(bluetooth.ProfileId.PROFILE_HID_HOST);
 hidHost.on('connectionStateChange', onReceiveEvent);
 ```
 
@@ -1676,7 +1729,7 @@ No value is returned.
 function onReceiveEvent(data) {
     console.info('hidHost state = '+ JSON.stringify(data));
 }
-let hidHost = bluetooth.getProfile(PROFILE_HID_HOST);
+let hidHost = bluetooth.getProfile(bluetooth.ProfileId.PROFILE_HID_HOST);
 hidHost.on('connectionStateChange', onReceiveEvent);
 hidHost.off('connectionStateChange', onReceiveEvent);
 ```
@@ -1819,7 +1872,7 @@ cccV[0] = 1;
 let characteristic = {serviceUuid: '00001810-0000-1000-8000-00805F9B34FB',
   characteristicUuid: '00001820-0000-1000-8000-00805F9B34FB', characteristicValue: arrayBufferC, descriptors:descriptors};
 let characteristicN = {serviceUuid: '00001810-0000-1000-8000-00805F9B34FB',
-  characteristicUuid: '00001821-0000-1000-8000-00805F9B34FB', characteristicValue: arrayBufferC, descriptors:descriptorsN};
+  characteristicUuid: '00001821-0000-1000-8000-00805F9B34FB', characteristicValue: arrayBufferC, descriptors:descriptors};
 characteristics[0] = characteristic;
 
 // Create a gattService instance.
@@ -1911,8 +1964,11 @@ Notifies the connected client device when a characteristic value changes.
 **Example**
 
 ```js
+let arrayBufferC = new ArrayBuffer(8);
+let characteristic = {serviceUuid: '00001810-0000-1000-8000-00805F9B34FB',
+  characteristicUuid: '00001820-0000-1000-8000-00805F9B34FB', characteristicValue: arrayBufferC, descriptors:descriptors};
 let notifyCharacteristic = {serviceUuid: '00001810-0000-1000-8000-00805F9B34FB',
-  characteristicUuid: '00001821-0000-1000-8000-00805F9B34FB', characteristicValue:  notifyCcc.characteristicValue, confirm: false};
+  characteristicUuid: '00001821-0000-1000-8000-00805F9B34FB', characteristicValue: characteristic.characteristicValue, confirm: false};
 let server = bluetooth.BLE.createGattServer();
 server.notifyCharacteristicChanged('XX:XX:XX:XX:XX:XX', notifyCharacteristic);
 ```
@@ -2138,7 +2194,7 @@ Subscribes to the descriptor read request events.
 | Name     | Type                                      | Mandatory  | Description                               |
 | -------- | ---------------------------------------- | ---- | --------------------------------- |
 | type     | string                                   | Yes   | Event type. The value **descriptorRead** indicates a descriptor read request event.|
-| callback | Callback&lt;[DescriptorReadReq](#descriptorreadreq)&gt; | Yes   | Callback invoked to return a descriptor read request from the GATT client.       |
+| callback | Callback&lt;[DescriptorReadReq](#descriptorreadreq)&gt; | Yes   | Callback invoked to return a descriptor read request event from the GATT client.       |
 
 **Return value**
 
@@ -2279,7 +2335,6 @@ let gattServer = bluetooth.BLE.createGattServer();
 gattServer.off("descriptorWrite");
 ```
 
-
 ### on('connectStateChange')
 
 on(type: "connectStateChange", callback: Callback&lt;BLEConnectChangedState&gt;): void
@@ -2488,7 +2543,7 @@ Obtains all services of the remote BLE device. This API uses a promise to return
 // Promise
 let device = bluetooth.BLE.createGattClientDevice('XX:XX:XX:XX:XX:XX');
 device.connect();
-let services = device.getServices();
+var services = device.getServices();
 console.log("bluetooth services size is ", services.length);
 
 for (let i = 0; i < services.length; i++) {
@@ -2826,8 +2881,11 @@ Sets the function of notifying the GATT client when the characteristic value of
 **Example**
 
 ```js
+let arrayBufferC = new ArrayBuffer(8);
+let characteristic = {serviceUuid: '00001810-0000-1000-8000-00805F9B34FB',
+  characteristicUuid: '00001820-0000-1000-8000-00805F9B34FB', characteristicValue: arrayBufferC, descriptors:descriptors};
 let device = bluetooth.BLE.createGattClientDevice('XX:XX:XX:XX:XX:XX');
-device.setNotifyCharacteristicChanged(notifyCcc, false);
+device.setNotifyCharacteristicChanged(characteristic, false);
 ```
 
 
@@ -3296,11 +3354,19 @@ Defines the scan filter parameters.
 
 **System capability**: SystemCapability.Communication.Bluetooth.Core
 
-| Name         | Type  | Readable  | Writable  | Description                                      |
-| ----------- | ------ | ---- | ---- | ---------------------------------------- |
+| Name                                    | Type   | Readable| Writable| Description                                                        |
+| ---------------------------------------- | ----------- | ---- | ---- | ------------------------------------------------------------ |
 | deviceId                                 | string      | Yes  | Yes  | Address of the BLE device to filter, for example, XX:XX:XX:XX:XX:XX.          |
 | name                                     | string      | Yes  | Yes  | Name of the BLE device to filter.                                       |
-| serviceUuid | string | Yes   | Yes   | UUID of the service, for example, **00001888-0000-1000-8000-00805f9b34fb**.|
+| serviceUuid                              | string      | Yes  | Yes  | Service UUID of the device to filter, for example, **00001888-0000-1000-8000-00805f9b34fb**.|
+| serviceUuidMask<sup>9+</sup>             | string      | Yes  | Yes  | Service UUID mask of the device to filter, for example, **FFFFFFFF-FFFF-FFFF-FFFF-FFFFFFFFFFFF**.|
+| serviceSolicitationUuid<sup>9+</sup>     | string      | Yes  | Yes  | Service solicitation UUID of the device to filter, for example, **00001888-0000-1000-8000-00805F9B34FB**.|
+| serviceSolicitationUuidMask<sup>9+</sup> | string      | Yes  | Yes  | Service solicitation UUID mask of the device to filter, for example, **FFFFFFFF-FFFF-FFFF-FFFF-FFFFFFFFFFFF**.|
+| serviceData<sup>9+</sup>                 | ArrayBuffer | Yes  | Yes  | Service data of the device to filter, for example, **[0x90, 0x00, 0xF1, 0xF2]**.|
+| serviceDataMask<sup>9+</sup>             | ArrayBuffer | Yes  | Yes  | Service data mask of the device to filter, for example, **[0xFF,0xFF,0xFF,0xFF]**.|
+| manufacturerId<sup>9+</sup>              | number      | Yes  | Yes  | Manufacturer ID of the device to filter, for example, **0x0006**.                |
+| manufactureData<sup>9+</sup>             | ArrayBuffer | Yes  | Yes  | Manufacturer data of the device to filter, for example, **[0x1F,0x2F,0x3F]**.|
+| manufactureDataMask<sup>9+</sup>         | ArrayBuffer | Yes  | Yes  | Manufacturer data mask of the device to filter, for example, **[0xFF, 0xFF, 0xFF]**.|
 
 
 ## ScanOptions

en/application-dev/reference/apis/js-apis-formprovider.md

 # FormProvider
 
-> **NOTE**<br>
-> The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version.
+The **FormProvider** module provides APIs related to the widget provider. You can use the APIs to update a widget, set the next refresh time for a widget, obtain widget information, and release a widget release.
 
-Provides APIs related to the widget provider.
+> **NOTE**
+> 
+> The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version.
 
 ## Modules to Import
 
@@ -27,11 +28,11 @@ SystemCapability.Ability.Form
 
 **Parameters**
 
-  | Name| Type   | Mandatory| Description                                  |
-  | ------ | ------ | ---- | ------------------------------------- |
-  | formId | string | Yes  | ID of a widget.                              |
-  | minute | number | Yes  | Refresh interval, in minutes. The value must be greater than or equal to 5.    |
-  | callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the result.|
+| Name| Type   | Mandatory| Description                                  |
+| ------ | ------ | ---- | ------------------------------------- |
+| formId | string | Yes  | ID of a widget.                              |
+| minute | number | Yes  | Refresh interval, in minutes. The value must be greater than or equal to 5.    |
+| callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the result.|
 
 **Example**
 
@@ -56,16 +57,16 @@ SystemCapability.Ability.Form
 
 **Parameters**
 
-  | Name| Type   | Mandatory| Description                                  |
-  | ------ | ------ | ---- | ------------------------------------- |
-  | formId | string | Yes  | ID of a widget.                              |
-  | minute | number | Yes  | Refresh interval, in minutes. The value must be greater than or equal to 5.    |
+| Name| Type   | Mandatory| Description                                  |
+| ------ | ------ | ---- | ------------------------------------- |
+| formId | string | Yes  | ID of a widget.                              |
+| minute | number | Yes  | Refresh interval, in minutes. The value must be greater than or equal to 5.    |
 
 **Return value**
 
-  | Type         | Description                             |
-  | ------------- | ---------------------------------- |
-  | Promise\<void> |Promise used to return the result.     |
+| Type         | Description                             |
+| ------------- | ---------------------------------- |
+| Promise\<void> |Promise used to return the result.     |
 
 **Example**
 
@@ -90,11 +91,11 @@ SystemCapability.Ability.Form
 
 **Parameters**
 
-  | Name| Type                                                                   | Mandatory| Description            |
-  | ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
-  | formId | string                                                                 | Yes  | ID of the widget to update.|
-  | formBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | Yes  | Data to be used for the update.   |
-  | callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the result.|
+| Name| Type                                                                   | Mandatory| Description            |
+| ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
+| formId | string                                                                 | Yes  | ID of the widget to update.|
+| formBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | Yes  | Data to be used for the update.   |
+| callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the result.|
 
 **Example**
 
@@ -121,10 +122,10 @@ SystemCapability.Ability.Form
 
 **Parameters**
 
-  | Name| Type                                                                   | Mandatory| Description            |
-  | ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
-  | formId | string                                                                 | Yes  | ID of the widget to update.|
-  | formBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | Yes  | Data to be used for the update.   |
+| Name| Type                                                                   | Mandatory| Description            |
+| ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
+| formId | string                                                                 | Yes  | ID of the widget to update.|
+| formBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | Yes  | Data to be used for the update.   |
 
 **Return value**
 
@@ -144,3 +145,289 @@ SystemCapability.Ability.Form
       console.log('formProvider updateForm, error:' + JSON.stringify(error));
   });
   ```
+
+## getFormsInfo<sup>9+</sup>
+
+getFormsInfo(callback: AsyncCallback&lt;Array&lt;formInfo.FormInfo&gt;&gt;): void;
+
+Obtains the application's widget information on the device. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.Ability.Form
+
+**Parameters**
+
+| Name| Type   | Mandatory| Description   |
+| ------ | ------ | ---- | ------- |
+| callback | AsyncCallback&lt;Array&lt;[FormInfo](./js-apis-formInfo.md#forminfo-1)&gt;&gt; | Yes| Callback used to return the widget information.|
+
+**Example**
+
+```js
+formProvider.getFormsInfo((error, data) => {
+    if (error.code) {
+        console.log('formProvider getFormsInfo, error:' + JSON.stringify(error));
+    } else {
+        console.log('formProvider getFormsInfo, data:' + JSON.stringify(data));
+    }
+});
+```
+## getFormsInfo<sup>9+</sup>
+
+getFormsInfo(filter: formInfo.FormInfoFilter, callback: AsyncCallback&lt;Array&lt;formInfo.FormInfo&gt;&gt;): void;
+
+Obtains the application's widget information that meets a filter criterion on the device. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.Ability.Form
+
+**Parameters**
+
+| Name| Type   | Mandatory| Description   |
+| ------ | ------ | ---- | ------- |
+| filter | formInfo.FormInfoFilter | Yes| Filter criterion.|
+| callback | AsyncCallback&lt;Array&lt;[FormInfo](./js-apis-formInfo.md#forminfo-1)&gt;&gt; | Yes| Callback used to return the widget information.|
+
+**Example**
+
+```js
+const filter : formInfo.FormInfoFilter = {
+    moduleName : "entry"
+};
+formProvider.getFormsInfo(filter, (error, data) => {
+    if (error.code) {
+        console.log('formProvider getFormsInfo, error:' + JSON.stringify(error));
+    } else {
+        console.log('formProvider getFormsInfo, data:' + JSON.stringify(data));
+    }
+});
+```
+
+## getFormsInfo<sup>9+</sup>
+
+getFormsInfo(filter?: formInfo.FormInfoFilter): Promise&lt;Array&lt;formInfo.FormInfo&gt;&gt;;
+
+Obtains the application's widget information on the device. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.Ability.Form
+
+**Parameters**
+
+| Name| Type   | Mandatory| Description   |
+| ------ | ------ | ---- | ------- |
+| filter | formInfo.FormInfoFilter | No| Filter criterion.|
+
+**Return value**
+
+| Type         | Description                               |
+| :------------ | :---------------------------------- |
+| Promise&lt;Array&lt;[FormInfo](./js-apis-formInfo.md#forminfo-1)&gt;&gt; | Promise used to return the widget information.|
+
+**Example**
+
+```js
+const filter : formInfo.FormInfoFilter = {
+    moduleName : "entry"
+};
+formProvider.getFormsInfo(filter).then((data) => {
+    console.log('formProvider getFormsInfo, data:' + JSON.stringify(data));
+}).catch((error) => {
+    console.log('formProvider getFormsInfo, error:' + JSON.stringify(error));
+});
+```
+
+## requestPublishForm<sup>9+</sup>
+
+requestPublishForm(want: Want, formBindingData: formBindingData.FormBindingData, callback: AsyncCallback&lt;string&gt;): &lt;void&gt;;
+
+Requests to publish a widget carrying data to the widget host. This API uses an asynchronous callback to return the result.
+
+**System capability**
+
+SystemCapability.Ability.Form
+
+**Parameters**
+
+| Name| Type                                                                   | Mandatory| Description            |
+| ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
+| want | [Want](js-apis-application-Want.md)                           | Yes  | Information about the target widget.<br>**abilityName**: ability of the target widget.<br>**parameters**:<br>"ohos.extra.param.key.form_dimension"<br>"ohos.extra.param.key.form_name"<br>"ohos.extra.param.key.module_name" |
+| formBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | Yes  | Data used for creating the widget.|
+| callback | AsyncCallback&lt;string&gt; | Yes| Callback used to return the widget ID.|
+
+**Example**
+
+  ```js
+  import formBindingData from '@ohos.application.formBindingData';
+  var want = {
+      abilityName: "FormAbility",
+      parameters: {
+          "ohos.extra.param.key.form_dimension": 2,
+          "ohos.extra.param.key.form_name": "widget",
+          "ohos.extra.param.key.module_name": "entry"
+      }
+  };
+  let obj = formBindingData.createFormBindingData({temperature:"22c", time:"22:00"});
+  formProvider.requestPublishForm(want, obj, (error, data) => {
+      if (error.code) {
+          console.log('formProvider requestPublishForm, error: ' + JSON.stringify(error));
+      } else {
+          console.log('formProvider requestPublishForm, form ID is: ' + JSON.stringify(data));
+      }
+  });
+  ```
+
+## requestPublishForm<sup>9+</sup>
+
+requestPublishForm(want: Want, callback: AsyncCallback&lt;string&gt;): &lt;void&gt;;
+
+Requests to publish a widget to the widget host. This API uses an asynchronous callback to return the result.
+
+**System capability**
+
+SystemCapability.Ability.Form
+
+**Parameters**
+
+| Name  | Type                               | Mandatory| Description                                                        |
+| -------- | ----------------------------------- | ---- | ------------------------------------------------------------ |
+| want     | [Want](js-apis-application-Want.md) | Yes  | Information about the target widget.<br>**abilityName**: ability of the target widget.<br>**parameters**:<br>"ohos.extra.param.key.form_dimension"<br>"ohos.extra.param.key.form_name"<br>"ohos.extra.param.key.module_name" |
+| callback | AsyncCallback&lt;string&gt;         | Yes  | Callback used to return the widget ID.                                    |
+
+**Example**
+
+  ```js
+  var want = {
+      abilityName: "FormAbility",
+      parameters: {
+          "ohos.extra.param.key.form_dimension": 2,
+          "ohos.extra.param.key.form_name": "widget",
+          "ohos.extra.param.key.module_name": "entry"
+      }
+  };
+  formProvider.requestPublishForm(want, (error, data) => {
+      if (error.code) {
+          console.log('formProvider requestPublishForm, error: ' + JSON.stringify(error));
+      } else {
+          console.log('formProvider requestPublishForm, form ID is: ' + JSON.stringify(data));
+      }
+  });
+  ```
+
+## requestPublishForm<sup>9+</sup>
+
+requestPublishForm(want: Want, formBindingData?: formBindingData.FormBindingData): Promise&lt;string&gt;;
+
+Requests to publish a widget to the widget host. This API uses a promise to return the result.
+
+**System capability**
+
+SystemCapability.Ability.Form
+
+**Parameters**
+
+| Name         | Type                                                        | Mandatory| Description                                                        |
+| --------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
+| want            | [Want](js-apis-application-Want.md)                          | Yes  | Information about the target widget.<br>**abilityName**: ability of the target widget.<br>**parameters**:<br>"ohos.extra.param.key.form_dimension"<br>"ohos.extra.param.key.form_name"<br>"ohos.extra.param.key.module_name" |
+| formBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | No  | Data used for creating the widget.                                          |
+
+**Return value**
+
+| Type         | Description                               |
+| :------------ | :---------------------------------- |
+| Promise&lt;string&gt; | Promise used to return the widget ID.|
+
+**Example**
+
+  ```js
+  var want = {
+      abilityName: "FormAbility",
+      parameters: {
+          "ohos.extra.param.key.form_dimension": 2,
+          "ohos.extra.param.key.form_name": "widget",
+          "ohos.extra.param.key.module_name": "entry"
+      }
+  };
+  formProvider.requestPublishForm(want).then((data) => {
+      console.log('formProvider requestPublishForm success, form ID is :' + JSON.stringify(data));
+  }).catch((error) => {
+      console.log('formProvider requestPublishForm, error: ' + JSON.stringify(error));
+  });
+  ```
+
+## isRequestPublishFormSupported<sup>9+<sup>
+
+isRequestPublishFormSupported(callback: AsyncCallback&lt;boolean&gt;): void;
+
+Checks whether a widget can be published to the widget host. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.Ability.Form
+
+**Parameters**
+
+| Name| Type   | Mandatory| Description   |
+| ------ | ------ | ---- | ------- |
+| callback | AsyncCallback&lt;boolean&gt; | Yes| Callback used to return the result.|
+
+**Example**
+
+```js
+formProvider.isRequestPublishFormSupported((error, isSupported) => {
+  if (error.code) {
+    console.log('formProvider isRequestPublishFormSupported, error:' + JSON.stringify(error));
+  } else {
+    if (isSupported) {
+      var want = {
+      abilityName: "FormAbility",
+      parameters: {
+        "ohos.extra.param.key.form_dimension": 2,
+        "ohos.extra.param.key.form_name": "widget",
+        "ohos.extra.param.key.module_name": "entry"
+      }
+      };
+      formProvider.requestPublishForm(want, (error, data) => {
+        if (error.code) {
+          console.log('formProvider requestPublishForm, error: ' + JSON.stringify(error));
+        } else {
+          console.log('formProvider requestPublishForm, form ID is: ' + JSON.stringify(data));
+        }
+      });
+    }
+  }
+});
+```
+
+## isRequestPublishFormSupported<sup>9+</sup>
+
+isRequestPublishFormSupported(): Promise&lt;boolean&gt;;
+
+Checks whether a widget can be published to the widget host. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.Ability.Form
+
+**Return value**
+
+| Type         | Description                               |
+| :------------ | :---------------------------------- |
+| Promise&lt;boolean&gt; | Promise used to return the result.|
+
+**Example**
+
+```js
+formProvider.isRequestPublishFormSupported().then((isSupported) => {
+  if (isSupported) {
+    var want = {
+    abilityName: "FormAbility",
+    parameters: {
+        "ohos.extra.param.key.form_dimension": 2,
+        "ohos.extra.param.key.form_name": "widget",
+        "ohos.extra.param.key.module_name": "entry"
+    }
+    };
+    formProvider.requestPublishForm(want).then((data) => {
+      console.log('formProvider requestPublishForm success, form ID is :' + JSON.stringify(data));
+    }).catch((error) => {
+      console.log('formProvider requestPublishForm, error: ' + JSON.stringify(error));
+    });
+  }
+}).catch((error) => {
+  console.log('formProvider isRequestPublishFormSupported, error:' + JSON.stringify(error));
+});
+```

en/application-dev/reference/apis/js-apis-inputmethod.md

 # Input Method Framework
 
-> **NOTE**<br>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.
+> **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.
 
 
 ## Modules to Import
@@ -21,7 +22,7 @@ Provides the constants.
 | MAX_TYPE_NUM | number | Yes| No| Maximum number of supported input methods.|
 
 
-## InputMethodProperty<sup>8+</sup><a name="InputMethodProperty"></a>
+## InputMethodProperty<sup>8+</sup>
 
 Describes the input method application attributes.
 
@@ -32,7 +33,7 @@ Describes the input method application attributes.
 | packageName | string | Yes| No| Package name.|
 | methodId | string | Yes| No| Ability name.|
 
-## inputMethod.getInputMethodController<a name="getInputMethodController"></a>
+## inputMethod.getInputMethodController
 
 getInputMethodController(): InputMethodController
 
@@ -48,11 +49,11 @@ Obtains an [InputMethodController](#InputMethodController) instance.
 
 **Example**
 
-  ```js
+```js
   var InputMethodController = inputMethod.getInputMethodController();
-  ```
+```
 
-## inputMethod.getInputMethodSetting<sup>8+</sup><a name="getInputMethodSetting"></a>
+## inputMethod.getInputMethodSetting<sup>8+</sup>
 
 getInputMethodSetting(): InputMethodSetting
 
@@ -69,10 +70,10 @@ Obtains an [InputMethodSetting](#InputMethodSetting) instance.
 **Example**
 
 ```js
-var InputMethodSetting = inputMethod.getInputMethodSetting();
+  var InputMethodSetting = inputMethod.getInputMethodSetting();
 ```
 
-## InputMethodController<a name="InputMethodController"></a>
+## InputMethodController
 
 In the following API examples, you must first use [getInputMethodController](#getInputMethodController) to obtain an **InputMethodController** instance, and then call the APIs using the obtained instance.
 
@@ -120,7 +121,7 @@ Hides the keyboard. This API uses an asynchronous callback to return the result.
   console.info('stopInput isSuccess = ' + isSuccess);
 ```
 
-## InputMethodSetting<sup>8+</sup><a name="InputMethodSetting"></a>
+## InputMethodSetting<sup>8+</sup>
 
 In the following API examples, you must first use [getInputMethodSetting](#getInputMethodSetting) to obtain an **InputMethodSetting** instance, and then call the APIs using the obtained instance.
 
@@ -140,18 +141,18 @@ Obtains the list of installed input methods. This API uses an asynchronous callb
 
 **Example**
 
-  ```js
+```js
   InputMethodSetting.listInputMethod((properties)=>{
     for (var i = 0;i < properties.length; i++) {
       var property = properties[i];
       console.info(property.packageName + "/" + property.methodId);
     }
   });
-  ```
+```
 
 ### listInputMethod
 
-listInputMethod(): Promise&lt;Array&lt;InputMethodProperty&gt;&gt;
+listInputMethod(): Array&lt;InputMethodProperty&gt;
 
 Obtains the list of installed input methods. This API uses an asynchronous callback to return the result.
 
@@ -196,7 +197,7 @@ Displays a dialog box for selecting an input method. This API uses an asynchrono
 
 ### displayOptionalInputMethod
 
-displayOptionalInputMethod(): Promise&lt;void&gt;
+  displayOptionalInputMethod(): Promise&lt;void&gt;
 
 Displays a dialog box for selecting an input method. This API uses an asynchronous callback to return the result.
 

en/application-dev/reference/apis/js-apis-settings.md

 # Settings
 
-> **NOTE**<br>
+> **NOTE**
+>
 > The initial APIs of this module are supported since API version 8. Updates will be marked with a superscript to indicate their earliest API version.
 
 
@@ -55,7 +56,7 @@ Obtains the value of a data item.
 | Name| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- |
 | dataAbilityHelper | [DataAbilityHelper](js-apis-dataAbilityHelper.md) | Yes| **DataAbilityHelper** class.|
-| name | string | Yes| Name of the target data item. Data items can be classified as follows:<br> <ul><li>Existing data items in the database, for example:<br></li> <ul><li>Brightness: settings.display.SCREEN_BRIGHTNESS_STATUS<br> </li>  <li>Time format: settings.date.TIME_FORMAT<br> </li></ul> <li>Custom data items</li></ul>|
+| name | string | Yes| Name of the target data item. Data items can be classified as follows:<br> <ul><li>Existing data items in the database, for example:<br></li> <ul><li>Brightness: **settings.display.SCREEN_BRIGHTNESS_STATUS**<br> </li>  <li>Time format: **settings.date.TIME_FORMAT**<br> </li></ul> <li>Custom data items</li></ul> |
 | defValue | string | Yes| Default value This parameter is user-defined. If it is not found in the database, the default value is returned.|
 
 **Return value**
@@ -93,7 +94,7 @@ If the specified data item exists in the database, the **setValueSync** method u
 | Name| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- |
 | dataAbilityHelper | [DataAbilityHelper](js-apis-dataAbilityHelper.md) | Yes| **DataAbilityHelper** class.|
-| name | string | Yes| Name of the target data item. Data items can be classified as follows:<br> <ul><li>Existing data items in the database, for example:<br></li> <ul><li>Brightness: settings.display.SCREEN_BRIGHTNESS_STATUS<br> </li>  <li>Time format: settings.date.TIME_FORMAT<br> </li></ul> <li>Custom data items</li></ul>|
+| name | string | Yes| Name of the target data item. Data items can be classified as follows:<br> <ul><li>Existing data items in the database, for example:<br></li> <ul><li>Brightness: **settings.display.SCREEN_BRIGHTNESS_STATUS**<br> </li>  <li>Time format: **settings.date.TIME_FORMAT**<br> </li></ul> <li>Custom data items</li></ul> |
 | value | string | Yes| Value of the data item.|
 
 **Return value**

en/application-dev/reference/apis/js-apis-system-bluetooth.md

 # Bluetooth
 
 
-> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**<br/>
+> **NOTE**<br/>
 >
 > - The APIs of this module are no longer maintained since API version 7. You are advised to use [`@ohos.bluetooth`](js-apis-bluetooth.md).
 >
@@ -15,7 +15,6 @@
 import bluetooth from '@system.bluetooth';
 ```
 
-
 ## bluetooth.startBLEScan(OBJECT)
 
 Scans for Bluetooth Low Energy (BLE) devices nearby. This operation consumes system resources. Call [bluetooth.stopBLEScan](#bluetoothstopblescanobject) to stop the scan after a BLE device is detected and connected.
@@ -25,7 +24,6 @@ Scans for Bluetooth Low Energy (BLE) devices nearby. This operation consumes sys
 **System capability**: SystemCapability.Communication.Bluetooth.Lite
 
 **Parameters**
-
 **Table 1** StartBLEScanOptions
 
 | Name| Type| Mandatory| Description|
@@ -61,7 +59,6 @@ Stops scanning for BLE devices nearby. This API is used with [bluetooth.startBLE
 **System capability**: SystemCapability.Communication.Bluetooth.Lite
 
 **Parameters**
-
 **Table 2** StopBLEScanOptions
 
 | Name| Type| Mandatory| Description|
@@ -74,6 +71,7 @@ Stops scanning for BLE devices nearby. This API is used with [bluetooth.startBLE
 
   ```
   bluetooth.stopBLEScan({
+    interval:0,
     success() {
       console.log('call bluetooth.stopBLEScan success.');
     },
@@ -96,7 +94,6 @@ Subscribes to the newly detected BLE device. If this API is called multiple time
 **System capability**: SystemCapability.Communication.Bluetooth.Lite
 
 **Parameters**
-
 **Table 3** SubscribeBLEFoundOptions
 
 | Name| Type| Mandatory| Description|
@@ -123,7 +120,7 @@ Subscribes to the newly detected BLE device. If this API is called multiple time
 **Example**
 
   ```
-  bluetooth.startaBLEScan({
+  bluetooth.startBLEScan({
     success() {
       bluetooth.subscribeBLEFound({
         success(data) {

en/application-dev/reference/apis/js-apis-system-cipher.md

@@ -29,7 +29,7 @@ Encrypts or decrypts data using RSA.
 | text | string | Yes| Text to be encrypted or decrypted.<br> The text to be encrypted must be common text that meets the following requirement:<br> Maximum text length = Key length/8 - 66<br>For example, if the key is of 1024 bytes, the text to be encrypted cannot exceed 62 bytes (1024/8 -66 = 62).<br> The text to be decrypted must be binary text encoded in Base64. The default format is used for Base64 encoding.|
 | key | string | Yes| RSA key. The key is used as a public key in encryption and a private key in decryption.|
 | transformation | string | No| RSA padding. The default value is **RSA/None/OAEPWithSHA256AndMGF1Padding**.|
-| success | Function | No| Called when data is encrypted or decrypted successful.|
+| success | Function | No| Called when data is encrypted or decrypted successfully.|
 | fail | Function | No| Called when data fails to be encrypted or decrypted.|
 | complete | Function | No| Called when the execution is complete.|
 
@@ -45,15 +45,18 @@ export default {
       text: 'hello',            
       // Base64-encoded public key used for encryption.           
       key: 
-        'MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDc7GR2MrfAoefES+wrs1ns2afT\n' +            
-        'eJXSfIkEHfPXG9fVFjaws1ho4KcZfsxlA0+SXvc83f2SVGCuzULmM2lxxRCtcUN/\n' +            
-        'h7SoaYEeluhqFimL2AEjfSwINHCLqObJkcjCfoZpE1JCehPiDOJsyT50Auc08h/4\n' +            
-        'jHQfanyC1nc62LqUCQIDAQAB',            
+     'MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCx414QSP3RsYWYzf9mkBMiBAXo\n' + 
+     '6S7Lpva1fKlcuVxjoFC1iMnzD4mC0uiL4k5MNi43J64c7dbqi3qAJjdAtuwQ6NZJ\n' + 
+     '+Enz0RzmVFh/4yk6lmqRzuEFQqhQqSZzaLq6sq2N2G0Sv2Xl3sLvqAfe2HNm2oBw\n' +
+     'jBpApTJ3TeneOo6Z5QIDAQAB',  
       success: function(data) {                
-          console.log('handling success: ${data.text}');            
+        console.log(`handling successful:${data.text}`);          
       },            
       fail: function(data, code) {               
-          console.log(`### cipher.rsa encrypt fail ### ${code}: ${data}`);           
+        console.log(`### Failed to encrypt cipher.rsa ### ${code}:${data}`); 
+      },
+      complete: function() {
+        console.log(`operation complete!`);
       }
       });        
       cipher.rsa({            
@@ -61,31 +64,33 @@ export default {
         action: 'decrypt',            
         // Text to be decrypted, which is binary text encoded in Base64. The decrypted text is "hello".           
         text:            
-          'CUg3tTxTIdpCfreIxIBdws3uhd5qXLwcrVl3XDnQzZFVHyjVVCDHS16rjopaZ4C5xU2Tc8mSDzt7\n' +            
-          'gp9vBfSwi7bMtSUvXG18DlncsKJFDkJpS5t0PkpS9YrJXrY80Gpe+ME6+6dN9bjgqMljbitDdBRf\n' +            
-          'S/ZWNI4Q8Q0suNjNkGU=',            
+       'EPeCFPib6ayKbA0M6oSywARvFZ8dFYfjQv3nY8ikZGtS9UHq2sLPvAfpeIzggSiCxqbWeCftP1XQ\n' +
+       'Sa+jEpzFlT1qoSTunBbrYzugPTajIJDTg6R1IRsF/J+mmakn0POVPvi4jCo9wqavB324Bx0Wipnc\n' +
+       'EU5WO0oBHo5l4x6dTpU=',           
            // Base64-encoded private key used for decryption.           
          key:            
-           'MIICdwIBADANBgkqhkiG9w0BAQEFAASCAmEwggJdAgEAAoGBANzsZHYyt8Ch58RL\n' +            
-           '7CuzWezZp9N4ldJ8iQQd89cb19UWNrCzWGjgpxl+zGUDT5Je9zzd/ZJUYK7NQuYz\n' +            
-           'aXHFEK1xQ3+HtKhpgR6W6GoWKYvYASN9LAg0cIuo5smRyMJ+hmkTUkJ6E+IM4mzJ\n' +            
-           'PnQC5zTyH/iMdB9qfILWdzrYupQJAgMBAAECgYEAkibhH0DWR13U0gvYJeD08Lfd\n' +            
-           'Sw1PMHyquEqIcho9Yv7bF3LOXjOg2EEGPx09mvuwXFgP1Kp1e67XPytr6pQQPzK7\n' +            
-           'XAPcLPx80R/ZjZs8vNFndDOd1HgD3vSVmYQarNzmKi72tOUWMPevsaFXPHo6Xx3X\n' +            
-           '8x0wYb7XuBsQguRctTECQQD7GWX3JUiyo562iVrpTDPOXsrUxmzCrgz2OZildxMd\n' +            
-           'Pp/PkyDrx7mEXTpk4K/XnQJ3GpJNi2iDSxDuPSAeJ/aPAkEA4Tw4+1Z43S/xH3C3\n' +            
-           'nfulYBNyB4si6KEUuC0krcC1pDJ21Gd12efKo5VF8SaJI1ZUQOzguV+dqNsB/JUY\n' +            
-           'OFfX5wJAB1dKv9r7MR3Peg6x9bggm5vx2h6i914XSuuMJupASM6X5X2rrLj+F3yS\n' +            
-           'RHi9K1SPyeOg+1tkBtKfABgRZFBOyQJAbuTivUSe73AqTKuHjB4ZF0ubqgEkJ9sf\n' +            
-           'Q2rekzm9dOFvxjZGPQo1qALX09qATMi1ZN376ukby8ZAnSafLSZ64wJBAM2V37go\n' +            
-           'Sj44HF76ksRow8gecuQm48NCTGAGTicXg8riKog2GC9y8pMNHAezoR9wXJF7kk+k\n' +            
-           'lz5cHyoMZ9mcd30=',            
+        'MIICXgIBAAKBgQCx414QSP3RsYWYzf9mkBMiBAXo6S7Lpva1fKlcuVxjoFC1iMnz\n' +
+        'D4mC0uiL4k5MNi43J64c7dbqi3qAJjdAtuwQ6NZJ+Enz0RzmVFh/4yk6lmqRzuEF\n' +
+        'QqhQqSZzaLq6sq2N2G0Sv2Xl3sLvqAfe2HNm2oBwjBpApTJ3TeneOo6Z5QIDAQAB\n' +
+        'AoGBAKPNtoRQcklxqo+2wQP0j2m3Qqnib1DggjVEgb/8f/LNYQSI3U2QdROemryU\n' +
+        'u3y6N3xacZ359PktTrRKfH5+8ohmHGhIuPAnefp6bLvAFUcl4t1xm74Cow62Kyw3\n' +
+        'aSbmuTG98dxPA1sXD0jiprdtsq2wQ9CoKNyY7/d/pKoqxNuBAkEA4GytZ60NCTj9\n' +
+        'w24jACFeko5YqCFY/TTLoc4SQvWtFMnimRPclLZhtUIK0P8dib71UFedx+AxklgL\n' +
+        'A5gjcfo+2QJBAMrqiwyCh3OQ5DhyRPDwt87x1/jg5fy4hhete2ufSf2FoQCVqO+w\n' +
+        'PKoljdXmJeS6rGgzGibstuHLrP3tcIho4+0CQD3ZFWzF/xq0jxKlrpWhnJuNCRfE\n' +
+        'oO6e9yNvVA8J/5oEDSOcmqSNIp4+RhbUx8InUxnCG6Ryv5aSFu71pYcKrPkCQQCL\n' +
+        'RUGcm3ZGTnslduB0knNF+V2ndwzDUQ7P74UXT+PjurTPhujFYiuxCEd6ORVnEOzG\n' +
+        'M9TORIgdH8MjIbWsGnndAkEAw9yURDaorE8IYPLF2IEn09g1uzvWPs3phDb6smVx\n' + 
+        '8GfqIdUNf+aCG5TZK/kXBF1sqcsi7jXMAf4jBlejVbSVZg==',
          success: function(data) {                
-             console.log('handling success: ${data.text}');            
+           console.log(`handling successful:${data.text}`);          
          },            
          fail: function(data, code) {               
-             console.log(`### cipher.rsa decrypt fail ### ${code}: ${data}`);            
+           console.log(`### Failed to encrypt cipher.rsa ### ${code}:${data}`); 
          },
+         complete: function() {
+           console.log(`operation complete!`);
+         }        
        });    
    }
 }
@@ -109,9 +114,9 @@ Encrypts or decrypts data using AES.
 | key | string | Yes| Key used for encryption or decryption. It is a string encoded in Base64.|
 | transformation | string | No| Encryption mode and padding of the AES algorithm. The default value is **AES/CBC/PKCS5Padding**.|
 | iv | string | No| Initialization vector (IV) for AES-based encryption and decryption. The value is a string encoded in Base64. The default value is the key value.|
-| ivOffset | string | No| Offset of the IV for AES-based encryption and decryption. The default value is **0**.|
-| ivLen | string | No| Length of the IV for AES-based encryption and decryption, in bytes. The default value is **16**.|
-| success | Function | No| Called when data is encrypted or decrypted successful.|
+| ivOffset | string | No| Offset of the IV for AES-based encryption and decryption. The default value is **0**, which is the only value supported.|
+| ivLen | string | No| Length of the IV, in bytes. This field is reserved. The default value is **16**, which is the only value supported.|
+| success | Function | No| Called when data is encrypted or decrypted successfully.|
 | fail | Function | No| Called when data fails to be encrypted or decrypted.|
 | complete | Function | No| Called when the execution is complete.|
 
@@ -128,35 +133,38 @@ export default {
       // Base64-encoded key used for encryption.           
       key: 'NDM5Qjk2UjAzMEE0NzVCRjlFMkQwQkVGOFc1NkM1QkQ=',            
       transformation: 'AES/CBC/PKCS5Padding',            
-      ivOffset: 0,            
-      ivLen: 16,            
-      success: (data) => {                
-        console.log('handling success: ${data.text}');            
+      ivOffset: '0',            
+      ivLen: '16',            
+      success: function(data) {                
+        console.log(`handling successful:${data.text}`);          
+        },            
+      fail: function(data, code) {               
+        console.log(`### Failed to encrypt cipher.rsa ### ${code}:${data}`); 
         },
-      fail: (data, code) => {                
-        console.log(`### cipher.aes encrypt fail ### ${code}: ${data}`);            
+      complete: function() {
+        console.log(`operation complete!`);
       }
     });        
     cipher.aes({            
       // Decrypt data.           
       action: 'decrypt',            
       // Text to be decrypted, which is binary text encoded in Base64.           
-      text: 'CUg3tTxTIdpCfreIxIBdws3uhd5qXLwcrVl3XDnQzZFVHyjVVCDHS16rjopaZ4C5xU2Tc8mSDzt7\n' +            
-      'gp9vBfSwi7bMtSUvXG18DlncsKJFDkJpS5t0PkpS9YrJXrY80Gpe+ME6+6dN9bjgqMljbitDdBRf\n' +            
-      'S/ZWNI4Q8Q0suNjNkGU=',            
+      text: '1o0kf2HXwLxHkSh5W5NhzA==',            
        // Base64-encoded key used for decryption.           
        key: 'NDM5Qjk2UjAzMEE0NzVCRjlFMkQwQkVGOFc1NkM1QkQ=',            
        transformation: 'AES/CBC/PKCS5Padding',            
-       ivOffset: 0,            
-       ivLen: 16,            
-       success: (data) => {                
-         this.dealTxt = data.text;            
+       ivOffset: '0',            
+       ivLen: '16',            
+       success: function(data) {                
+         console.log(`handling success:${data.text}`);          
         },            
-       fail: (data, code) => {               
-         prompt.showToast({                    
-           message: (`### cipher.aes decrypt fail ### code = ${code}: ${data}`)                
-         })            
+       fail: function(data, code) {               
+         console.log(`### Failed to decrypt cipher.rsa ### ${code}:${data}`); 
        },
+       complete: function() {
+         console.log(`operation complete!`);
+        }
+     });        
     });    
   }
 }

en/application-dev/reference/arkui-js/js-components-media-video.md

 # video
 
 
->  **NOTE**<br>
+>  **NOTE**
 >
 > - This component is supported since API version 4. Updates will be marked with a superscript to indicate their earliest API version.
 >
@@ -15,7 +15,7 @@
 > ]
 > ```
 
-The **\<Video>** component provides a video player.
+The **\<video>** component provides a video player.
 
 
 ## Child Components
@@ -76,7 +76,8 @@ In addition to the [universal methods](../arkui-js/js-components-common-methods.
 | pause | - | Pauses a video.|
 | setCurrentTime | {&nbsp;currenttime:&nbsp;value&nbsp;} | Sets the video playback position, in seconds.|
 
->  **NOTE**<br>
+> **NOTE**
+>
 > The methods in the above table can be called after the **attached** callback is invoked.
 
 ## Example
@@ -89,7 +90,7 @@ In addition to the [universal methods](../arkui-js/js-components-common-methods.
          onpaues='pauesCallback' onfinish='finishCallback' onerror='errorCallback'
          onseeking='seekingCallback' onseeked='seekedCallback' 
          ontimeupdate='timeupdateCallback'
-         style="object-fit:fit; width:80%; height:400px;"
+         style="object-fit:fill; width:80%; height:400px;"
          onclick="change_start_pause">
    </video>
 </div>

en/application-dev/reference/arkui-ts/ts-basic-components-progress.md

 # Progress
 
 
-> **NOTE**<br>
+> **NOTE**
+>
 > This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
-The **&lt;Progress&gt;** component is used to provide a progress bar that displays the progress of content loading or an operation.
+The **\<Progress>** component is used to provide a progress bar that displays the progress of content loading or an operation.
 
 
 ## Required Permissions
@@ -15,12 +16,12 @@ None
 
 ## Child Components
 
-None
+Not supported
 
 
 ## APIs
 
-Progress(value: { value: number, total?: number, type?: ProgressType})
+Progress(value: {value: number, total?: number, type?: ProgressType})
 
 Creates a progress bar.
 
@@ -54,7 +55,8 @@ Creates a progress bar.
 ## Example
 
 
-```
+```ts
+// xxx.ets
 @Entry
 @Component
 struct ProgressExample {
@@ -88,8 +90,8 @@ struct ProgressExample {
 
       Text('Capsule Progress').fontSize(9).fontColor(0xCCCCCC).width('90%')
       Row({ space: 40 }) {
-        Progress({ value: 10, type: ProgressType.Capsule }).width(100)
-        Progress({ value: 20, total: 150, type: ProgressType.Capsule }).color(Color.Grey).value(50).width(100)
+        Progress({ value: 10, type: ProgressType.Capsule }).width(100).height(50)
+        Progress({ value: 20, total: 150, type: ProgressType.Capsule }).color(Color.Grey).value(50).width(100).height(50)
       }
     }.width('100%').margin({ top: 30 })
   }

en/application-dev/reference/arkui-ts/ts-basic-components-textarea.md

 # TextArea
 
 
-> **NOTE**<br>
+> **NOTE**
+>
 > This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
@@ -15,12 +16,12 @@ None
 
 ## Child Components
 
-None
+Not supported
 
 
 ## APIs
 
-TextArea(value?:{placeholder?: string controller?: TextAreaController})
+TextArea(value?:{placeholder?: string, controller?: TextAreaController})
 
 - Parameters
     | Name                    | Type                                     | Mandatory | Default Value | Description                            |
@@ -93,10 +94,11 @@ Sets the position of the caret.
 @Entry
 @Component
 struct TextAreaExample1 {
+  controller: TextAreaController = new TextAreaController()
   @State text: string = ''
   build() {
     Column() {
-      TextArea({ placeholder: 'input your word'})
+      TextArea({ placeholder: 'input your word', controller: this.controller})
         .placeholderColor("rgb(0,0,225)")
         .placeholderFont({ size: 30, weight: 100, family: 'cursive', style: FontStyle.Italic })
         .textAlign(TextAlign.Center)
@@ -112,6 +114,7 @@ struct TextAreaExample1 {
         })
         .onChange((value: string) => {
           this.text = value
+          this.controller.caretPosition(-1)
         })
       Text(this.text).width('90%')
     }

en/application-dev/reference/arkui-ts/ts-basic-components-textinput.md

 # TextInput
 
-> **NOTE**<br/>
+> **NOTE**
+>
 > This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
@@ -14,7 +15,7 @@ None
 
 ## Child Components
 
-None
+Not supported
 
 
 ## APIs
@@ -39,7 +40,7 @@ In addition to universal attributes, the following attributes are supported.
 | placeholderFont | {<br/>size?: Length,<br/>weight?: number\|[FontWeight](ts-universal-attributes-text-style.md),<br/>family?: string,<br/>style?: [FontStyle](ts-universal-attributes-text-style.md)<br/>} | - | Placeholder text style.<br/>- **size**: font size. If the value is of the number type, the unit fp is used.<br/>- **weight**: font weight. For the number type, the value ranges from 100 to 900, at an interval of 100. The default value is **400**. A larger value indicates a larger font weight.<br/>- **family**: font family. Use commas (,) to separate multiple fonts, for example, **'Arial, sans-serif'**. The priority of the fonts is the sequence in which they are placed.<br/>- **style**: font style. |
 | enterKeyType | EnterKeyType | EnterKeyType.Done | How the Enter key is labeled. |
 | caretColor | Color | - | Color of the caret (also known as the text insertion cursor). |
-| maxLength<sup>8+</sup> | number | - | Maximum number of characters in the text input. |
+| maxLength | number | - | Maximum number of characters in the text input. |
 | inputFilter<sup>8+</sup> | {<br/>value: [ResourceStr](../../ui/ts-types.md)<sup>8+</sup>,<br/>error?: (value: string)<br/>} | - | Regular expression for input filtering. Only inputs that comply with the regular expression can be displayed. Other inputs are ignored. The specified regular expression can match single characters, but not strings. Example: ^(? =.\*\d)(? =.\*[a-z])(? =.\*[A-Z]).{8,10}$. Strong passwords containing 8 to 10 characters cannot be filtered.<br/>- **value**: regular expression to set.<br/>- **error**: error message containing the ignored content returned when regular expression matching fails. |
 | copyOption<sup>9+</sup> | boolean\|[CopyOption](ts-basic-components-text.md) | true | Whether copy and paste is allowed. |
 
@@ -75,10 +76,10 @@ In addition to universal attributes, the following attributes are supported.
 
 ### TextInputController<sup>8+</sup>
 
-Implements the controller of the **&lt;TextInput&gt;** component.
+Implements the controller of the **\<TextInput>** component.
 
 
-### Objects to Import
+#### Objects to Import
 
 
 ```
@@ -86,7 +87,7 @@ controller: TextInputController = new TextInputController()
 ```
 
 
-### caretPosition
+#### caretPosition
 
 caretPosition(value: number): void
 
@@ -113,10 +114,9 @@ struct TextInputExample1 {
 
   build() {
     Column() {
-      TextArea({ placeholder: 'input your word' })
+      TextInput({ placeholder: 'input your word' })
         .placeholderColor("rgb(0,0,225)")
         .placeholderFont({ size: 30, weight: 100, family: 'cursive', style: FontStyle.Italic })
-        .textAlign(TextAlign.Center)
         .caretColor(Color.Blue)
         .height(50)
         .fontSize(30)

en/application-dev/reference/arkui-ts/ts-container-gridcontainer.md

@@ -5,7 +5,7 @@
 > This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
-The **<GridContainer>** component lays out components vertically. It is used only in the grid layout.
+The **<GridContainer\>** component lays out components vertically. It is used only in the grid layout.
 
 
 ## Required Permissions
@@ -33,7 +33,7 @@ GridContainer(options?: { columns?: number | 'auto', sizeType?: SizeType, gutter
 - SizeType enums
   | Name | Description | 
   | -------- | -------- |
-  | XS | Device of the minimum size. | 
+  | XS | Minimum-sized device. | 
   | SM | Small-sized device. | 
   | MD | Medium-sized device. | 
   | LG | Large-sized device. | 
@@ -42,7 +42,7 @@ GridContainer(options?: { columns?: number | 'auto', sizeType?: SizeType, gutter
 
 ## Attributes
 
-Universal attributes and [attributes](ts-container-column.md#attributes) of the **&lt;Column&gt;** component are supported.
+Universal attributes and [attributes](ts-container-column.md#attributes) of the **<Column\>** component are supported.
 
 
 ## Events

en/application-dev/reference/arkui-ts/ts-container-navigator.md

 # Navigator
 
 
-> **NOTE**<br>
+> **NOTE**
+>
 > This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
-The **Navigator** component provides redirection to the target page.
+The **\<Navigator>** component provides redirection to the target page.
 
 
 ## Required Permissions
@@ -42,25 +43,26 @@ Creates a navigator.
 
 | Name | Parameters | Default Value | Description |
 | -------- | -------- | -------- | -------- |
-| active | boolean | - | Whether the **Navigator** component is activated. If the component is activated, the corresponding navigation takes effect. | 
+| active | boolean | - | Whether the **\<Navigator>** component is activated. If the component is activated, the corresponding navigation takes effect. |
 | params | Object | undefined | Data that needs to be passed to the target page during redirection. You can use **router.getParams()** to obtain the data on the target page. |
 
 
 ## Example
 
 
-```
-// Navigator Page
+```ts
+// Navigator.ets
 @Entry
 @Component
 struct NavigatorExample {
   @State active: boolean = false
-  @State Text: string = 'news'
+  @State Text: object = {name: 'news'}
 
   build() {
     Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Start, justifyContent: FlexAlign.SpaceBetween }) {
       Navigator({ target: 'pages/container/navigator/Detail', type: NavigationType.Push }) {
-        Text('Go to ' + this.Text + ' page').width('100%').textAlign(TextAlign.Center)
+        Text('Go to ' + this.Text['name'] + ' page')
+            .width('100%').textAlign(TextAlign.Center)
       }.params({ text: this.Text })
 
       Navigator() {
@@ -75,14 +77,14 @@ struct NavigatorExample {
 ```
 
 
-```
-// Detail Page
+```ts
+// Detail.ets
 import router from '@system.router'
 
 @Entry
 @Component
 struct DetailExample {
-  @State text: string = router.getParams().text
+  @State text: any = router.getParams().text
 
   build() {
     Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Start, justifyContent: FlexAlign.SpaceBetween }) {
@@ -90,7 +92,8 @@ struct DetailExample {
         Text('Go to back page').width('100%').height(20)
       }
 
-      Text('This is ' + this.text + ' page').width('100%').textAlign(TextAlign.Center)
+      Text('This is ' + this.text['name'] + ' page')
+          .width('100%').textAlign(TextAlign.Center)
     }
     .width('100%').height(200).padding({ left: 35, right: 35, top: 35 })
   }
@@ -98,9 +101,8 @@ struct DetailExample {
 
 ```
 
-  
-```
-// Back Page
+```ts
+// Back.ets
 @Entry
 @Component
 struct BackExample {

en/application-dev/reference/arkui-ts/ts-container-panel.md

 # Panel
 
 
-> **NOTE**
->
+> **NOTE**<br>
 > This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
@@ -26,7 +25,7 @@ Panel(value:{show:boolean})
 - Parameters
   | Name | Type | Mandatory | Default Value | Description |
   | -------- | -------- | -------- | -------- | -------- |
-  | show | boolean | Yes | - | Whether the panel is shown or hidden. |
+  | show | boolean | Yes | - | Whether to show or hide the panel. |
 
 
 ## Attributes
@@ -35,7 +34,7 @@ Panel(value:{show:boolean})
 | -------- | -------- | -------- | -------- |
 | type | PanelType | PanelType.Foldable | Type of the panel. |
 | mode | PanelMode | - | Initial status of the panel. |
-| dragBar | boolean | true | Whether to enable a drag bar. The value **true** means that the drag bar will be displayed, and **false** means the opposite. |
+| dragBar | boolean | true | Whether to enable a drag bar. The value **true** means to display the drag bar, and **false** means the opposite. |
 | fullHeight | Length | - | Panel height in the **PanelMode.Full** mode. |
 | halfHeight | Length | - | Panel height in the **PanelMode.Half** mode. The default value is half of the screen height. |
 | miniHeight | Length | - | Panel height in the **PanelMode.Mini** mode. |
@@ -59,7 +58,7 @@ Panel(value:{show:boolean})
 
 | Name | Description |
 | -------- | -------- |
-| onChange(callback: (width: number, height: number, mode: PanelMode) =&gt; void) | Triggered when the status of the panel changes. The returned height value is the height of the content area. When the value of **dragbar** is **true**, the height of the panel is the drag bar height plus the height of the content area. |
+| onChange(callback: (width: number, height: number, mode: PanelMode) =&gt; void) | Triggered when the panel status changes. The returned height value is the height of the content area. When the value of **dragbar** is **true**, the height of the panel is the drag bar height plus the height of the content area. |
 
 
 ## Example

en/application-dev/reference/arkui-ts/ts-container-refresh.md

@@ -23,7 +23,7 @@ Refresh\(value: \{refreshing: boolean, offset?: Length, friction?: number\}\)
   | -------- | -------- | -------- | -------- | -------- |
   | refreshing | boolean | Yes| - | Whether the current component is being refreshed. |
   | offset | Length | No| 16 | Distance to the top of the parent component from the **<Refresh\>** component that comes to rest after a successful pull-down gesture. |
-  | friction | number | No| 62 | Coefficient of friction, which indicates the **<Refresh\>** component's sensitivity to the pull-down gesture. The value ranges from 0 to 100. <br/>- **0** indicates that the **<Refresh\>** component is not sensitive to the pull-down gesture. <br/>- **100** indicates that the **<Refresh\>** component is highly sensitive to the pull-down gesture. <br/>- A larger value indicates a more sensitive response of the **<Refresh\>** component to the pull-down gesture. |
+  | friction | number | No| 62 | Coefficient of friction, which indicates the **<Refresh\>** component's sensitivity to the pull-down gesture. The value ranges from 0 to 100. <br/>- **0**: The **<Refresh\>** component is not sensitive to the pull-down gesture. <br/>- **100**: The **<Refresh\>** component is highly sensitive to the pull-down gesture. <br/>- Value greater than **100**: The **<Refresh\>** component is much more sensitive to the pull-down gesture. |
 
 
 
@@ -32,8 +32,8 @@ Refresh\(value: \{refreshing: boolean, offset?: Length, friction?: number\}\)
 
 | Name| Description|
 | -------- | -------- |
-| onStateChange(callback: (state: RefreshStatus) => void)| Triggered when the refresh status changes. <br/>**state** indicates the refresh status.|
-| onRefreshing(callback: () => void)| Triggered when the component enters the refresh state.|
+| onStateChange(callback: (state: RefreshStatus) => void)| Triggered when the refresh status changes. <br/>**state** indicates the refresh status. |
+| onRefreshing(callback: () => void)| Triggered when the component enters the refresh state. |
 
 - RefreshStatus enums
 

en/application-dev/reference/arkui-ts/ts-container-row.md

@@ -22,17 +22,17 @@ Supported
 Row(value:{space?: Length})
 
 - Parameters
-  | Name| Type| Mandatory| Default Value | Description | 
+  | Name | Type | Mandatory | Default Value | Description | 
   | -------- | -------- | -------- | -------- | -------- |
   | space | Length | No| 0 | Space between two adjacent child components in the horizontal layout. | 
 
 
 ## Attributes
 
-| Name| Type | Default Value | Description |
+| Name | Type | Default Value | Description |
 | -------- | -------- | -------- | -------- |
-| alignItems | VerticalAlign | VerticalAlign.Center | Alignment mode of child components in the vertical direction. |
-| justifyContent8+ | [FlexAlign](ts-container-flex.md) | FlexAlign.Start | Alignment mode of child components in the horizontal direction. |
+| alignItems | VerticalAlign | VerticalAlign.Center | Alignment mode of the child components in the vertical direction. |
+| justifyContent8+ | [FlexAlign](ts-container-flex.md) | FlexAlign.Start | Alignment mode of the child components in the horizontal direction. |
 
 - VerticalAlign enums
   | Name | Description | 

en/application-dev/reference/arkui-ts/ts-container-rowsplit.md

@@ -27,7 +27,7 @@ RowSplit()
 
 | Name | Type | Description |
 | -------- | -------- | -------- |
-| resizeable | boolean | Whether the divider can be dragged. The default value is **false**. |
+| resizeable | boolean | Whether the divider is draggable. The default value is **false**. |
 
 > **NOTE**<br>
 > Similar to **<RowSplit\>**, the divider of **<RowSplit\>** can be dragged to a position that just fully holds a component.

en/application-dev/reference/arkui-ts/ts-container-scroll.md

 # Scroll
 
 
-> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**
+> **NOTE**<br>
 > This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
-The **&lt;Scroll&gt;** component scrolls the content when the layout size of a component exceeds the viewport of its parent component.
+The **<Scroll\>** component scrolls the content when the layout size of a component exceeds the viewport of its parent component.
 
 
 ## Required Permissions
@@ -42,7 +42,7 @@ Scroll(scroller?: Scroller)
 
 ## Scroller
 
-Controller of the scrollable container component. You can bind this component to the container component and use it to control the scrolling of the container component. Currently, this component can be bound to the **&lt;List&gt;** and **&lt;Scroll&gt;** components.
+Controller of the scrollable container component. You can bind this component to the container component and use it to control the scrolling of the container component. Currently, this component can be bound to the **<List\>** and **<Scroll\>** components.
 
 
 ### Objects to Import
@@ -106,7 +106,7 @@ Obtains the scrolling offset.
 - Return value
   | Type | Description |
   | -------- | -------- |
-  | {<br/>xOffset: number,<br/>yOffset: number<br/>} | **xOffset**: horizontal scrolling offset.<br/>**yOffset**: vertical scrolling offset. |
+  | {<br/>xOffset: number,<br/>yOffset: number<br/>} | - **xOffset**: horizontal scrolling offset.<br/>- **yOffset**: vertical scrolling offset. |
 
 
 ### scroller.scrollToIndex
@@ -117,8 +117,8 @@ scroller.scrollToIndex(value: number): void
 Scrolls to the specified index.
 
 
-> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**
-> Only the **&lt;List&gt;** component is supported.
+> **NOTE**<br>
+> Only the **<List\>** component is supported.
 
 
 - Parameters
@@ -131,8 +131,8 @@ Scrolls to the specified index.
 
 | Name | Description |
 | -------- | -------- |
-| onScroll(xOffset: number, yOffset: number) =&gt; void | Invoked to return the horizontal and vertical offsets during scrolling when the specified scroll event occurs. |
-| onScrollEdge(side: Edge) =&gt; void | Callback for the event of scrolling to the edge. |
+| onScroll(xOffset: number, yOffset: number) =&gt; void | Invoked to return the horizontal and vertical scrolling offsets when the specified scroll event occurs. |
+| onScrollEdge(side: Edge) =&gt; void | Invoked when an item is scrolled to the edge. |
 | onScrollEnd() =&gt; void | Invoked when scrolling stops. |
 
 

en/application-dev/reference/arkui-ts/ts-container-stack.md

 # Stack
 
 
-> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**
+> **NOTE**<br>
 > This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
-The **&lt;Stack&gt;** component provides a stack container where child components are successively stacked and the latter one overwrites the previous one.
+The **<Stack\>** component provides a stack container where child components are successively stacked and the latter one overwrites the previous one.
 
 
 ## Required Permissions

en/application-dev/reference/arkui-ts/ts-container-swiper.md

 # Swiper
 
 
-> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**
+> **NOTE**<br>
 > This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
-The **&lt;Swiper&gt;** component provides a container that allows users to switch among child components by swiping operations.
+The **<Swiper\>** component provides a container that allows users to switch among child components through swiping.
 
 
 ## Required Permissions
@@ -42,14 +42,14 @@ Swiper(value:{controller?: SwiperController})
 | itemSpace | Length | 0 | Space between child components. |
 | cachedCount<sup>8+</sup> | number | 1 | Number of child components to be cached. |
 | disableSwipe<sup>8+</sup> | boolean | false | Whether to disable the swipe feature. |
-| curve<sup>8+</sup> | [Curve](ts-animatorproperty.md) \| Curves | Curve.Ease | Animation curve. The ease-in/ease-out curve is used by default. For details about common curves, see [Curve enums](ts-animatorproperty.md). You can also create custom curves ([interpolation curve objects](ts-interpolation-calculation.md)) by using the API provided by the interpolation calculation module. |
+| curve<sup>8+</sup> | [Curve](ts-animatorproperty.md) \| Curves | Curve.Ease | Animation curve. The ease-in/ease-out curve is used by default. For details about common curves, see [Curve enums](ts-animatorproperty.md). You can also create custom curves ([interpolation curve objects](ts-interpolation-calculation.md)) by using APIs provided by the interpolation calculation module. |
 
 
 ### SwiperController
 
-Controller of the **&lt;Swiper&gt;** component. You can bind this object to the **&lt;Swiper&gt;** component and use it to control page switching.
+Controller of the **<Swiper\>** component. You can bind this object to the **<Swiper\>** component and use it to control page switching.
 
-  | Name | Description | 
+| Name | Description | 
 | -------- | -------- |
 | showNext():void | Turns to the next page. | 
 | showPrevious():void | Turns to the previous page. | 
@@ -57,7 +57,7 @@ Controller of the **&lt;Swiper&gt;** component. You can bind this object to the
 
 ## Events
 
-  | Name | Description | 
+| Name | Description | 
 | -------- | -------- |
 | onChange( index: number) =&gt; void | Triggered when the index of the currently displayed component changes. | 
 

en/application-dev/reference/arkui-ts/ts-container-tabcontent.md

 # TabContent
 
 
-> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**
+> **NOTE**<br>
 > This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
-The **&lt;TabContent&gt;** component is used only in the **&lt;Tabs&gt;** component. It corresponds to the content view of a switched tab page.
+The **<TabContent\>** component is used only in the **<Tabs\>** component. It corresponds to the content view of a switched tab page.
 
 
 ## Required Permissions
@@ -29,12 +29,12 @@ Touch target configuration is not supported.
 
 | Name | Type | Default Value | Description |
 | -------- | -------- | -------- | -------- |
-| tabBar | string \| {<br/>icon?: string,<br/>text?: string<br/>}<br/>\| [CustomBuilder](../../ui/ts-types.md)<sup>8+</sup> | - | Content displayed on the tab bar.<br/>**CustomBuilder**: builder, to which components can be passed (applicable to API version 8 and later versions).<br/>> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**<br/>> If an icon uses an SVG image, the width and height attributes of the SVG image must be deleted. Otherwise, the icon size will be determined by the width and height attributes of the SVG image. |
+| tabBar | string \| {<br/>icon?: string,<br/>text?: string<br/>}<br/>\| [CustomBuilder](../../ui/ts-types.md)<sup>8+</sup> | - | Content displayed on the tab bar.<br/>**CustomBuilder**: builder, to which components can be passed (applicable to API version 8 or later).<br/>**NOTE**<br/>If an icon uses an SVG image, the width and height attributes of the SVG image must be deleted. Otherwise, the icon size will be determined by the width and height attributes of the SVG image. |
 
-> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**
-> - The **&lt;TabContent&gt;** component does not support setting of the common width attribute. By default, its width is the same as that of the parent **&lt;Tabs&gt;** component.
+> **NOTE**
+> - The **<TabContent\>** component does not support setting of the common width attribute. By default, its width is the same as that of the parent **<Tabs\>** component.
 > 
-> - The **&lt;TabContent&gt;** component does not support setting of the common height attribute. Its height is determined by the height of the parent **&lt;Tabs&gt;** component and the **&lt;TabBar&gt;** component.
+> - The **<TabContent\>** component does not support setting of the common height attribute. Its height is determined by the height of the parent **<Tabs\>** component and the **<TabBar\>** component.
 
 
 ## Example

en/application-dev/reference/arkui-ts/ts-container-tabs.md

 # Tabs
 
 
-> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**
+> **NOTE**<br>
 > This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
-The **&lt;Tabs&gt;** component is a container component that allows users to switch between content views through tabs. Each tab page corresponds to a content view.
+The **<Tabs\>** component is a container component that allows users to switch between content views through tabs. Each tab page corresponds to a content view.
 
 
 ## Required Permissions
@@ -15,7 +15,7 @@ None
 
 ## Child Components
 
-The **&lt;Tabs&gt;** component can contain [TabContent](ts-container-tabcontent.md) child components.
+A **<Tabs\>** component can contain multiple [TabContent](ts-container-tabcontent.md) components.
 
 
 ## APIs
@@ -25,7 +25,7 @@ Tabs(value: {barPosition?: BarPosition, index?: number, controller?: [TabsContro
 - Parameters
   | Name | Type | Mandatory | Default Value | Description |
   | -------- | -------- | -------- | -------- | -------- |
-  | barPosition | BarPosition | No | BarPosition.Start | Tab bar position for creating the **&lt;Tabs&gt;** container component. |
+  | barPosition | BarPosition | No | BarPosition.Start | Tab bar position for creating the **<Tabs\>** container component. |
   | index | number | No | 0 | Initial tab index. |
   | controller | [TabsController](#tabscontroller) | No | - | Tab controller. |
 

en/application-dev/reference/arkui-ts/ts-drawing-components-circle.md

@@ -5,7 +5,7 @@
 > This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
-The **<Circle>** component is used to draw a circle.
+The **<Circle\>** component is used to draw a circle.
 
 
 ## Required Permissions
@@ -25,7 +25,7 @@ Circle(options?: {width: Length, height: Length})
 - Parameters
   | Name | Type | Mandatory | Default Value | Description | 
   | -------- | -------- | -------- | -------- | -------- |
-  | options | Object | No | - | For details, see the **options** parameters. | 
+  | options | Object | No | - | Options of the circle to draw. For details, see the **options** parameters. | 
 
 - options parameters
   | Name | Type | Mandatory | Default Value | Description | 

en/application-dev/reference/arkui-ts/ts-drawing-components-ellipse.md

@@ -5,7 +5,7 @@
 > This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
-The **<Ellipse>** component is used to draw an ellipse.
+The **<Ellipse\>** component is used to draw an ellipse.
 
 
 ## Required Permissions
@@ -25,13 +25,13 @@ ellipse(options?: {width: Length, height: Length})
 - Parameters
   | Name | Type | Mandatory | Default Value | Description | 
   | -------- | -------- | -------- | -------- | -------- |
-  | options | Object | No | - | For details, see the **options** parameters. | 
+  | options | Object | No | - | Options of the ellipse to draw. For details, see the **options** parameters. | 
 
 - options parameters
   | Name | Type | Mandatory | Default Value | Description | 
   | -------- | -------- | -------- | -------- | -------- |
-  | width | Length | Yes | - | Width. | 
-  | height | Length | Yes | - | Height. | 
+  | width | Length | Yes | - | Width of the ellipse. | 
+  | height | Length | Yes | - | Height of the ellipse. | 
 
 
 ## Attributes

en/application-dev/reference/arkui-ts/ts-drawing-components-line.md

@@ -5,7 +5,7 @@
 > This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
-The **<Line>** component is used to draw a straight line.
+The **<Line\>** component is used to draw a straight line.
 
 
 ## Required Permissions
@@ -25,13 +25,13 @@ Line(options?: {width: Length, height: Length})
 - Parameters
   | Name | Type | Mandatory | Default Value | Description | 
   | -------- | -------- | -------- | -------- | -------- |
-  | options | Object | No | - | For details, see the **options** parameters. | 
+  | options | Object | No | - | Options of the line to draw. For details, see the **options** parameters. | 
 
 - options parameters
   | Name | Type | Mandatory | Default Value | Description | 
   | -------- | -------- | -------- | -------- | -------- |
-  | width | Length | Yes | - | Width. | 
-  | height | Length | Yes | - | Height. | 
+  | width | Length | Yes | - | Line width. | 
+  | height | Length | Yes | - | Line height. | 
 
 
 ## Attributes

en/application-dev/reference/arkui-ts/ts-drawing-components-path.md

@@ -5,7 +5,7 @@
 > This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
-The **<Path>** component is used to draw a path.
+The **<Path\>** component is used to draw a path.
 
 
 ## Required Permissions
@@ -24,7 +24,7 @@ None
 | -------- | -------- | -------- | -------- | -------- |
 | width | Length | 0 | No | Width of the rectangle where the path is located. | 
 | height | Length | 0 | No | Height of the rectangle where the path is located. | 
-| commands | string | '' | Yes | Command string for drawing the path. | 
+| commands | string | '' | Yes | Commands for drawing the path. | 
 
 
 The supported commands are as follows:

en/application-dev/reference/arkui-ts/ts-drawing-components-polygon.md

@@ -5,7 +5,7 @@
 > This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
-The **<Polygon>** component is used to draw a polygon.
+The **<Polygon\>** component is used to draw a polygon.
 
 
 ## Required Permissions
@@ -25,13 +25,13 @@ Polygon(value:{options?: {width: Length, height: Length}})
 - Parameters
   | Name | Type | Mandatory | Default Value | Description | 
   | -------- | -------- | -------- | -------- | -------- |
-  | options | Object | No | - | For details, see the **options** parameters. | 
+  | options | Object | No | - | Options of the polygon to draw. For details, see the **options** parameters. | 
 
 - options parameters
   | Name | Type | Mandatory | Default Value | Description | 
   | -------- | -------- | -------- | -------- | -------- |
-  | width | Length | Yes | - | Width. | 
-  | height | Length | Yes | - | Height. | 
+  | width | Length | Yes | - | Width of the polygon. | 
+  | height | Length | Yes | - | Height of the polygon. | 
 
 
 ## Attributes

en/application-dev/reference/arkui-ts/ts-drawing-components-polyline.md

@@ -5,7 +5,7 @@
 > This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
-The **<Polyline>** component is used to draw a polyline.
+The **<Polyline\>** component is used to draw a polyline.
 
 
 ## Required Permissions
@@ -25,13 +25,13 @@ Polyline(options?: {width: Length, height: Length})
 - Parameters
   | Name | Type | Mandatory | Default Value | Description | 
   | -------- | -------- | -------- | -------- | -------- |
-  | options | Object | No | - | For details, see the **options** parameters. | 
+  | options | Object | No | - | Options of the polyline to draw. For details, see the **options** parameters. | 
 
 - options parameters
   | Name | Type | Mandatory | Default Value | Description | 
   | -------- | -------- | -------- | -------- | -------- |
-  | width | Length | Yes | - | Width. | 
-  | height | Length | Yes | - | Height. | 
+  | width | Length | Yes | - | Width of the polyline. | 
+  | height | Length | Yes | - | Height of the polyline. | 
 
 
 ## Attributes

en/application-dev/reference/arkui-ts/ts-drawing-components-rect.md

@@ -5,7 +5,7 @@
 > This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
-The **<Rect>** component is used to draw a rectangle.
+The **<Rect\>** component is used to draw a rectangle.
 
 
 ## Required Permissions
@@ -25,14 +25,14 @@ Rect(value:{options?: {width: Length,height: Length,radius?: Length | Array&lt;L
 - Parameters
   | Name | Type | Mandatory | Default Value | Description | 
   | -------- | -------- | -------- | -------- | -------- |
-  | options | Object | No | - | For details, see the **options** parameters. | 
+  | options | Object | No | - | Options of the rectangle to draw. For details, see the **options** parameters. | 
 
 - options parameters
   | Name | Type | Mandatory | Default Value | Description | 
   | -------- | -------- | -------- | -------- | -------- |
-  | width | Length | Yes | - | Width. | 
-  | height | Length | Yes | - | Height. | 
-  | radius | Length \| Array&lt;Length&gt; | No | 0 | Radius of a rounded corner. You can set the radius of four rounded corners. | 
+  | width | Length | Yes | - | Width of the rectangle. | 
+  | height | Length | Yes | - | Height of the rectangle. | 
+  | radius | Length \| Array&lt;Length&gt; | No | 0 | Radius of the rounded corner. You can set the radius of four rounded corners. | 
   | radiusWidth | Length | No | 0 | Width of the rounded corner. | 
   | radiusHeight | Length | No | 0 | Height of the rounded corner. | 
 
@@ -41,11 +41,11 @@ Rect(value:{options?: {width: Length,height: Length,radius?: Length | Array&lt;L
 
 | Name | Type | Default Value | Mandatory | Description | 
 | -------- | -------- | -------- | -------- | -------- |
-| width | Length | 0 | No | Width. | 
-| height | Length | 0 | No | Height. | 
-| radiusWidth | Length | 0 | No | Width of a rounded corner. The width and height are the same when only the width is set. | 
+| width | Length | 0 | No | Width of the rectangle. | 
+| height | Length | 0 | No | Height of the rectangle. | 
+| radiusWidth | Length | 0 | No | Width of the rounded corner. The width and height are the same when only the width is set. | 
 | radiusHeight | Length | 0 | No | Height of the rounded corner. The width and height are the same only when the height is set. | 
-| radius | Length \| Array&lt;Length&gt; | 0 | No | Size of the rounded corner. | 
+| radius | Length \| Array&lt;Length&gt; | 0 | No | Radius of the rounded corner. | 
 
 
 ## Example

en/application-dev/reference/arkui-ts/ts-drawing-components-shape.md

@@ -5,13 +5,13 @@
 > This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
-The **<Shape>** component is the parent component of the drawing components. The attributes described in this topic are universal attributes supported by all the drawing components.
+The **<Shape\>** component is the parent component of the drawing components. The attributes described in this topic are universal attributes supported by all the drawing components.
 
 
-1. The drawing components use **&lt;Shape&gt;** as the parent component to implement the effect similar to SVG.
+1. Drawing components use **<Shape\>** as their parent component to implement the effect similar to SVG.
 
 
-2. The **&lt;Shape&gt;** component is used independently to draw a specific shape.
+2. The **<Shape\>** component is used independently to draw a specific shape.
 
 
 ## Required Permissions

en/application-dev/reference/arkui-ts/ts-gesture-settings.md

@@ -19,15 +19,15 @@ Use the following attributes to bind gesture recognition to a component. When a
 | Name | Type | Default Value | Description | 
 | -------- | -------- | -------- | -------- |
 | gesture | gesture: GestureType,<br/>mask?: GestureMask | gesture: -,<br/>mask: GestureMask.Normal | Gesture to recognize.<br/>**gesture** specifies the type of the gesture to bind, and **mask** specifies the event response setting. | 
-| priorityGesture | gesture: GestureType,<br/>mask?: GestureMask | gesture: -,<br/>mask: GestureMask.Normal | Gesture to preferentially recognize.<br/>**gesture** specifies the type of the gesture to bind, and **mask** specifies the event response setting.<br/>> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**<br/>> - By default, the child component takes precedence over the parent component in gesture recognition. When **priorityGesture** is configured for the parent component, the parent component takes precedence over the child component in gesture recognition. | 
-| parallelGesture | gesture: GestureType,<br/>mask?: GestureMask | gesture: -,<br/>mask: GestureMask.Normal | Gesture that can be triggered together with the child component gesture.<br/>**gesture** specifies the type of the gesture to bind, and **mask** specifies the event response setting.<br/>> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**<br/>> - The gesture event is not a bubbling event. When **parallelGesture** is set for the parent component, gesture events that are the same for the parent component and child components can be triggered, thereby implementing a bubbling effect. | 
+| priorityGesture | gesture: GestureType,<br/>mask?: GestureMask | gesture: -,<br/>mask: GestureMask.Normal | Gesture to preferentially recognize.<br/>**gesture** specifies the type of the gesture to bind, and **mask** specifies the event response setting.<br/>**NOTE**<br/>By default, the child component takes precedence over the parent component in gesture recognition. When **priorityGesture** is configured for the parent component, the parent component takes precedence over the child component in gesture recognition. | 
+| parallelGesture | gesture: GestureType,<br/>mask?: GestureMask | gesture: -,<br/>mask: GestureMask.Normal | Gesture that can be triggered together with the child component gesture.<br/>**gesture** specifies the type of the gesture to bind, and **mask** specifies the event response setting.<br/>**NOTE**<br/>The gesture event is not a bubbling event. When **parallelGesture** is set for the parent component, gesture events that are the same for the parent component and child components can be triggered, thereby implementing a bubbling effect. | 
 
 
 - GestureMask enums
   | Name | Description | 
   | -------- | -------- |
   | Normal | The gestures of child components are not masked and are recognized based on the default gesture recognition sequence. | 
-  | IgnoreInternal | The gestures of child components are masked. Only the gestures of the current component are recognized.<br/>> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**<br/>> However, the built-in gestures of the child components are not masked. For example, when the child component is a **&lt;List&gt;** component, the built-in sliding gestures can still be triggered. | 
+  | IgnoreInternal | The gestures of child components are masked. Only the gestures of the current component are recognized.<br/>**NOTE**<br/>The built-in gestures of the child components are not masked. For example, when the child component is a **&lt;List&gt;** component, the built-in sliding gestures can still be triggered. | 
 
 
 - GestureType enums
@@ -43,7 +43,7 @@ Use the following attributes to bind gesture recognition to a component. When a
 
 ## Gesture Response Event
 
-The component uses the **gesture** method to bind the gesture object and uses the events provided in this object to respond to the gesture operation. For example, the **onAction** event of the **TapGesture** object can be used to respond to a click event. For details about the event definition, see the section of each gesture object.
+The component uses the **gesture** method to bind the gesture object and uses the events provided in this object to respond to the gesture operation. For example, the **onAction** event of the **TapGesture** object can be used to respond to a click event. For details about the events, see the section of each gesture object.
 
 - TapGesture events
   | Name | Description | 

en/application-dev/reference/arkui-ts/ts-interpolation-calculation.md

 # Interpolation Calculation
 
+
 > **NOTE**<br>
 > This animation is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
@@ -20,12 +21,12 @@ init(curve?: Curve): Object
 Implements initialization for the interpolation curve, which is used to create an interpolation curve object based on the input parameter.
 
 - Parameters
+
   | Name | Type | Mandatory | Default Value | Description |
-  | ----- | ----- | --------- | ------------- | ------------- |
+  | -------- | -------- | -------- | -------- | -------- |
   | curve | Curve | No | Linear | Curve object. |
 
-- Return value
-  
+- Return value<br>
   Curve object.
 
 ## curves.steps
@@ -35,10 +36,11 @@ steps(count: number, end: boolean): Object
 Constructs a step curve object.
 
 - Parameters
+
   | Name | Type | Mandatory | Default Value | Description |
   | -------- | -------- | -------- | -------- | -------- |
-  | count | number | Yes | - | Number of steps. Must be a positive integer. |
-  | end | boolean | Yes | true | Step change at the start or end point of each interval. Defaults to **true**, indicating that the step change occurs at the end point. |
+  | count | number | Yes | - | Number of steps. The value must be a positive integer. |
+  | end | boolean | No | true | Step change at the start or end point of each interval. Defaults to **true**, indicating that the step change occurs at the end point. |
 
 - Return value
   
@@ -51,6 +53,7 @@ cubicBezier(x1: number, y1: number, x2: number, y2: number): Object
 Constructs a third-order Bezier curve object. The curve value must be between 0 and 1.
 
 1. Parameters
+
    | Name | Type   | Mandatory | Description                                                    |
    | ---- | ------ | --------- | -------------------------------------------------------------- |
    | x1   | number | Yes       | Horizontal coordinate of the first point on the Bezier curve.  |
@@ -69,6 +72,7 @@ spring(velocity: number, mass: number, stiffness: number, damping: number): Obje
 Constructs a spring curve object.
 
 1. Parameters
+
    | Name      | Type   | Mandatory | Description       |
    | --------- | ------ | --------- | ----------------- |
    | velocity  | number | Yes       | Initial velocity. |

en/application-dev/reference/arkui-ts/ts-methods-action-sheet.md

 # Action Sheet
 
 
-> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**
+> **NOTE**<br>
 > This component is supported since API version 8. Updates will be marked with a superscript to indicate their earliest API version.
 
 
@@ -32,9 +32,8 @@ Defines and shows the action sheet.
   | sheets | Array&lt;SheetInfo&gt; | Yes | - | Options in the dialog box. Each option supports the image, text, and callback. |
 
 - SheetInfo parameters
-    | | | | | |
-  | -------- | -------- | -------- | -------- | -------- |
   | Name | Type | Mandatory | Default Value | Description |
+  | -------- | -------- | -------- | -------- | -------- |
   | title | string | Yes | - | Sheet text. |
   | icon | string | No | None | Sheet icon. |
   | action | ()=&gt;void | Yes | - | Callback when the sheet is selected. |

en/application-dev/reference/arkui-ts/ts-methods-alert-dialog-box.md

 # Alert Dialog Box
 
 
-> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**
-> This method is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
+> **NOTE**<br>
+> This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
-You can set the text content and response callback for an alert dialog box.
+The **<AlertDialog\>** component is used to display an alert dialog box. You can set the text content and response callback for an alert dialog box as needed.
 
 
 ## Attributes
 
-  | Name | Type | Default Value | Description | 
+| Name | Type | Default Value | Description | 
 | -------- | -------- | -------- | -------- |
-| show | options: { paramObject1\| paramObject2} | - | Defines and displays the **&lt;AlertDialog&gt;** component. | 
+| show | options: { paramObject1\| paramObject2} | - | Defines and displays the **<AlertDialog\>** component. | 
 
 - paramObject1 parameters
     | Name | Type | Mandatory | Default Value | Description |

en/application-dev/reference/arkui-ts/ts-methods-custom-dialog-box.md

@@ -5,7 +5,7 @@
 > This method is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
 
-The **CustomDialogController** class is used to display a custom dialog box.
+A custom dialog box is a dialog box you customize by using APIs of the **CustomDialogController** class.
 
 
 ## APIs
@@ -27,9 +27,9 @@ CustomDialogController(value:{builder: CustomDialog, cancel?: () => void, aut
 - DialogAlignment enums
   | Name | Description |
   | -------- | -------- |
-  | Top | Aligns vertically to the top. |
-  | Center | Aligns vertically to the middle. |
-  | Bottom | Aligns vertically to the bottom. |
+  | Top | Vertical top alignment. |
+  | Center | Vertical center alignment. |
+  | Bottom | Vertical bottom alignment. |
   | Default | Default alignment. |
   | TopStart<sup>8+</sup> | Top left alignment. |
   | TopEnd<sup>8+</sup> | Top right alignment. |
@@ -59,7 +59,7 @@ Opens the content of the custom dialog box. If the content has been displayed, t
 ### close
 close(): void
 
-Closes the custom dialog box. If the dialog box is closed, the setting does not take effect.
+Closes the custom dialog box. If the dialog box is closed, this API does not take effect.
 
 
 ## Example

en/application-dev/security/accesstoken-guidelines.md

@@ -72,7 +72,7 @@ Declare the permissions required by the app one by one in the **config.json** fi
 
 The permission level of **ohos.permission.PERMISSION2** is **system_basic**, which is higher than the app's APL. In this case, use the ACL.
 
-In addition to declaring all the permissions in the **config.json** file, you must declare the permissions whose levels are higher than the app's APL in the app's profile. In this example, declare the permission under the **acls** field:
+In addition to declaring all the permissions in the **config.json** file, you must declare the permissions whose levels are higher than the app's APL in the app's [profile](../quick-start/app-provision-structure.md). In this example, declare the permission under the **acls** field:
 ```json
 {
     "version-name": "1.0.0",