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

Signed-off-by: NHollokin <taoyuxin2@huawei.com>

README_zh.md

@@ -18,15 +18,15 @@
 
  - master：最新开发版本。  
 
- - OpenHarmony 3.2 Beta2版本：点击[此处](zh-cn/release-notes/OpenHarmony-v3.2-beta2.md)了解版本详情。
+ - OpenHarmony 3.2 Beta3版本：点击[此处](zh-cn/release-notes/OpenHarmony-v3.2-beta3.md)了解版本详情。
 
  - OpenHarmony 3.1 Release版本：点击[此处](zh-cn/release-notes/OpenHarmony-v3.1-release.md)了解版本详情。
 
-    该已更新至OpenHarmony 3.1.1 Release，点击[此处](zh-cn/release-notes/OpenHarmony-v3.1.1-release.md)了解版本详情。
+    该版本已更新至OpenHarmony 3.1.3 Release，点击[此处](zh-cn/release-notes/OpenHarmony-v3.1.3-release.md)了解版本详情。
 
  - OpenHarmony 3.0 LTS版本：点击[此处](zh-cn/release-notes/OpenHarmony-v3.0-LTS.md)了解版本详情。
 
-    该版本已更新至OpenHarmony 3.0.5 LTS，点击[此处](zh-cn/release-notes/OpenHarmony-v3.0.5-LTS.md)了解版本详情。
+    该版本已更新至OpenHarmony 3.0.6 LTS，点击[此处](zh-cn/release-notes/OpenHarmony-v3.0.6-LTS.md)了解版本详情。
 
  - OpenHarmony 2.2 Beta2版本：点击[此处](zh-cn/release-notes/OpenHarmony-v2.2-beta2.md)了解版本详情。
 
@@ -34,7 +34,7 @@
 
 ### 历史稳定版本
 
-OpenHarmony_v1.x_release：OpenHarmony 1.1.4 LTS稳定版本，点击[此处](zh-cn/release-notes/OpenHarmony-v1-1-4-LTS.md)了解版本详情。
+OpenHarmony_v1.x_release：OpenHarmony 1.1.5 LTS稳定版本，点击[此处](zh-cn/release-notes/OpenHarmony-v1.1.5-LTS.md)了解版本详情。
 
 如需了解更多版本详情，点击[此处](zh-cn/release-notes/)。
 

en/application-dev/Readme-EN.md

@@ -16,6 +16,7 @@
         - [Application Package Structure Configuration File (Stage Model)](quick-start/stage-structure.md)
         - [SysCap](quick-start/syscap.md)
         - [HarmonyAppProvision Configuration File](quick-start/app-provision-structure.md)
+
 - Development
     - [Ability Development](ability/Readme-EN.md)
     - [UI Development](ui/Readme-EN.md)
@@ -26,6 +27,7 @@
     - [Security](security/Readme-EN.md)
     - [Connectivity](connectivity/Readme-EN.md)
     - [Data Management](database/Readme-EN.md)
+    - [File Management](file-management/Readme-EN.md)
     - [Telephony](telephony/Readme-EN.md)
     - [Task Management](task-management/Readme-EN.md)
     - [Device Management](device/Readme-EN.md)

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

@@ -5,7 +5,7 @@ An ability is the abstraction of a functionality that an application can provide
 The ability framework model has two forms:
 
 - FA model, which applies to application development using API version 8 and earlier versions. In the FA model, there is Feature Ability (FA) and Particle Ability (PA). The FA supports Page abilities, and the PA supports Service, Data, and Form abilities. 
-- Stage model, which is introduced since API version 9. In the stage model, there is `Ability` and `ExtensionAbility`. `ExtensionAbility` is further extended to `ServiceExtensionAbility`, `FormExtensionAbility`, `DataShareExtensionAbility`, and more.
+- Stage model, which is introduced since API version 9. In the stage model, there is `PageAbility` and `ExtensionAbility`. `ExtensionAbility` is further extended to `ServiceExtensionAbility`, `FormExtensionAbility`, `DataShareExtensionAbility`, and more.
 
 The stage model is designed to make it easier to develop complex applications in the distributed environment. The table below lists the design differences between the two models.
 

en/application-dev/ability/context-userguide.md

@@ -56,7 +56,7 @@ The methods are used to set the display orientation of the current ability.
 **Example**
 ```javascript
 import featureAbility from '@ohos.ability.featureAbility'
-import bundle from '../@ohos.bundle';
+import bundle from '@ohos.bundle';
 
 export default {
   onCreate() {
@@ -79,7 +79,7 @@ The following describes the contexts provided by the stage model in detail.
 
 ### application/Context
 
-**application/Context** is the base class context that provides basic application information such as **resourceManager**, **applicationInfo**, **cacheDir**, and **area**. It also provides basic application methods such as **createBundleContext**.
+**application/Context** is the base class context. It provides basic application information, such as **resourceManager**, **applicationInfo**, **cacheDir**, and **area**. It also provides basic application methods such as **createModuleContext**.
 
 **d.ts statement**
 
@@ -235,13 +235,13 @@ export default class MainAbility extends Ability {
 
 For details, see [FormExtensionContext](../reference/apis/js-apis-formextensioncontext.md).
 
-### Obtaining the Context on an eTS Page
+### Obtaining the Context on an ArkTS Page
 
-In the stage model, in the `onWindowStageCreate` lifecycle of an ability, you can call `SetUIContent` of `WindowStage` to load an eTS page. In some scenarios, you need to obtain the context on the page to call related APIs.
+In the stage model, in the `onWindowStageCreate` lifecycle of an ability, you can call `SetUIContent` of `WindowStage` to load an ArkTS page. In some scenarios, you need to obtain the context on the page to call related APIs.
 
 **How to Obtain**
 
-Use the API described in the table below to obtain the context associated with an eTS page.
+Use the API described in the table below to obtain the context associated with an ArkTS page.
 
 | API                                  | Description                          |
 | :------------------------------------ | :--------------------------- |

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

@@ -12,6 +12,7 @@ The Feature Ability (FA) model applies to application development using API vers
 ## Lifecycle
 
 Among all abilities, the Page ability has the most complex lifecycle, because it has a UI and acts as a touchpoint for interacting with users.
+
 **The following figure shows the lifecycle of the Page ability.**
 
 ![fa-pageAbility-lifecycle](figures/fa-pageAbility-lifecycle.png)
@@ -26,3 +27,9 @@ Currently, the **app.js** file provides only the **onCreate** and **onDestroy**
 An application exclusively uses an independent process, and an ability exclusively uses an independent thread. When an ability is started for the first time, an application process as well as a thread for this ability is created. After the application is started, other abilities in the application are started, and a thread is created for every of these started abilities. Each ability is bound to an independent JSRuntime instance. In this way, abilities are isolated from each other.
 
 ![fa-threading-model](figures/fa-threading-model.png)
+
+## Application Package Structure
+
+For details about the project directory structure of the FA model, see [OpenHarmony Project Overview](https://developer.harmonyos.com/en/docs/documentation/doc-guides/ohos-project-overview-0000001218440650#section4154183910141).
+
+For details about how to configure the application package structure of the FA model, see [Application Package Structure Configuration File](../quick-start/package-structure.md).

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

@@ -92,7 +92,7 @@ After the preceding code is executed, the **startAbility()** API is called to st
 - If the Service ability is not running, the system calls **onStart()** to initialize the Service ability, and then calls **onCommand()** on the Service ability.
 - If the Service ability is running, the system directly calls **onCommand()** on the Service ability.
 
-The following code snippet shows how to start a Service ability running on the remote device. For details about **getRemoteDeviceId()**, see [Connecting to a Remote Service Ability](#connecting-to-a-remote-service-ability-applying-only-to-system-applications).
+The following code snippet shows how to start a Service ability running on the remote device. For details about **getRemoteDeviceId()**, see [Connecting to a Remote Service Ability](#connecting-to-a-remote-service-ability).
 
 ```javascript
 import featureAbility from '@ohos.ability.featureAbility';

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

@@ -12,8 +12,8 @@ An ability can be launched in the **standard**, **singleton**, or **specified**
 
 | Launch Type    | Description    |Action            |
 | ----------- | -------  |---------------- |
-| standard    | Multi-instance  | A new instance is started each time an ability starts.|
-| 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.|
+| standard    | Standard mode.  | A new instance is started each time an ability starts.|
+| singleton   | Singleton mode.  | 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.json5` file:

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

@@ -49,6 +49,8 @@ The ability and ability stage lifecycles are the rudiments of the basic process
 
 To implement device-specific tailoring and multi-window scalability, OpenHarmony decouples the component manager from the window manager. The ability lifecycle defined in the stage model includes only the creation, destruction, foreground, and background states. The gain focus and lose focus states that are closely related to UI content are defined in the window stage. This implements weak coupling between the abilities and windows. On the service side, the window manager notifies the component manager of the foreground and background changes, so the component manager only senses the foreground and background changes but not the focus changes.
 
+There are two lifecycle states related to **WindowStage** in **Ability**: **onWindowStageCreate** and **onWindowStageDestroy**. They are valid only for devices with the window display capability. **onWindowStageCreate** is invoked when a window stage is created, where you can call **loadContent** to set pages to be loaded for the ability. **onWindowStageDestroy** is invoked when the window stage is destroyed, where you can release resources.
+
 
 ## Ability Instances and Missions
 
@@ -58,7 +60,7 @@ Abilities can be started in any of the following modes:
 
 + **Standard**: Each time **startAbility** is called, an instance of the specified ability type is created in the application process. **Ability2** in the figure below is started in standard mode.
 
-+ **Specified**: Before creating an **AbilityRecord**, you can create a key for the instance. Each time **startAbility** is called, the system asks the application which ability instance (corresponding to a key) will be used. **Ability3** in the figure below is started in specified mode.
++ **Specified**: Before creating an **Ability** instance, you can create a key for the instance. Each time **startAbility** is called, the system asks the application which ability instance (corresponding to a key) will be used. **Ability3** in the figure below is started in specified mode.
 
 Each ability instance corresponds to a mission in **Launcher Recent**.
 
@@ -92,6 +94,12 @@ All OpenHarmony applications are designed to meet the single-process model. In t
 
 - Render process: created for the WebView and used to load the WebView rendering library.
 
-  The following figure shows the process model of an application.
+The following figure shows the process model of an application.
+
+![stageprocessmodel](figures/stageprocessmodel.png)
+
+## Application Package Structure
+
+For details about the project directory structure of the stage model, see [OpenHarmony Project Overview](https://developer.harmonyos.com/en/docs/documentation/doc-guides/ohos-project-overview-0000001218440650#section56487581904).
 
-  ![stageprocessmodel](figures/stageprocessmodel.png)
+For details about how to configure the application package structure of the stage model, see [Application Package Structure Configuration File (Stage Model)](../quick-start/stage-structure.md).

en/application-dev/connectivity/http-request.md

@@ -12,7 +12,7 @@ To use related APIs, you must declare the **ohos.permission.INTERNET** permissio
 
 For details about how to apply for permissions, see [Access Control Development](../security/accesstoken-guidelines.md).
 
-The following table describes the related APIs.
+The following table provides only a simple description of the related APIs. For details, see [API Reference](../reference/apis/js-apis-http.md).
 
 | API                                       | Description                                               |
 | ----------------------------------------- | --------------------------------------------------------- |

en/application-dev/database/database-datashare-guidelines.md

@@ -52,9 +52,9 @@ Examples are given below.
 3. Implement the data provider services. For example, implement data storage of the data provider by using a database, reading and writing files, or accessing the network.
 
    ```ts
-   let DB_NAME = "DB00.db";
-   let TBL_NAME = "TBL00";
-   let DDL_TBL_CREATE = "CREATE TABLE IF NOT EXISTS "
+   const DB_NAME = "DB00.db";
+   const TBL_NAME = "TBL00";
+   const DDL_TBL_CREATE = "CREATE TABLE IF NOT EXISTS "
    + TBL_NAME
    + " (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, age INTEGER, isStudent BOOLEAN, Binary BINARY)";
    
@@ -132,9 +132,9 @@ Examples are given below.
 1. Import the dependencies.
 
    ```ts
-   import Ability from '@ohos.application.Ability'
-   import dataShare from '@ohos.data.dataShare'
-   import dataSharePredicates from '@ohos.data.dataSharePredicates'
+   import Ability from '@ohos.application.Ability';
+   import dataShare from '@ohos.data.dataShare';
+   import dataSharePredicates from '@ohos.data.dataSharePredicates';
    ```
    
 2. Define the URI string for communicating with the data provider.
@@ -164,29 +164,25 @@ Examples are given below.
 
    ```ts
    // Construct a piece of data.
-   var valuesBucket = { "name": "ZhangSan", "age": 21, "isStudent": false, "Binary": new Uint8Array([1, 2, 3]) };
-   var updateBucket = { "name": "LiSi", "age": 18, "isStudent": true, "Binary": new Uint8Array([1, 2, 3]) };
-   let da = new dataSharePredicates.DataSharePredicates();
-   var valArray = new Array("*");
-   let people = new Array(
-     { "name": "LiSi", "age": 41, "Binary": ar },
-     { "name": "WangWu", "age": 21, "Binary": arr },
-     { "name": "ZhaoLiu", "age": 61, "Binary": arr });
+   let valuesBucket = { "name": "ZhangSan", "age": 21, "isStudent": false, "Binary": new Uint8Array([1, 2, 3]) };
+   let updateBucket = { "name": "LiSi", "age": 18, "isStudent": true, "Binary": new Uint8Array([1, 2, 3]) };
+   let predicates = new dataSharePredicates.DataSharePredicates();
+   let valArray = new Array("*");
    // Insert a piece of data.
    dsHelper.insert(dseUri, valuesBucket, (err, data) => {
      console.log("dsHelper insert result: " + data);
    });
-   // Delete data.
-   dsHelper.delete(dseUri, da, (err, data) => {
-     console.log("dsHelper delete result: " + data);
-   });
    // Update data.
-   dsHelper.update(dseUri, da, updateBucket, (err, data) => {
+   dsHelper.update(dseUri, predicates, updateBucket, (err, data) => {
      console.log("dsHelper update result: " + data);
    });
    // Query data.
-   dsHelper.query(dseUri, da, valArray, (err, data) => {
+   dsHelper.query(dseUri, predicates, valArray, (err, data) => {
      console.log("dsHelper query result: " + data);
    });
+   // Delete data.
+   dsHelper.delete(dseUri, predicates, (err, data) => {
+     console.log("dsHelper delete result: " + data);   
+   });
    ```
    

en/application-dev/database/database-datashare-overview.md

@@ -22,7 +22,7 @@ Before you get started, familiarize yourself with the following concepts:
 
   An application that accesses the data or services provided by a data provider. It is also called a client.
 
-- Value bucket (**ValuesBucket**)
+- **ValuesBucket**
 
   One or more data records stored in the form of key-value (KV) pairs. The keys are of the string type. The values can be of the number, string, Boolean, or Unit8Array type.
 

en/application-dev/database/database-distributedobject-overview.md

@@ -12,7 +12,7 @@ The distributed data object management framework provides object-oriented in-mem
 
 - **Distributed data object**
 
-  A distributed data object is an encapsulation of the JS object type. Each distributed data object instance creates a data table in the in-memory database. The in-memory databases created for different applications are isolated from each other. Reading data from and writing data to a distributed data object are mapped to the **put** and **get** operations in the corresponding database, respectively.
+  A distributed data object is an encapsulation of the JS object type. Each distributed data object instance creates a data table in the in-memory database. The in-memory databases created for different applications are isolated from each other. Reading data from and writing data to a distributed data object are mapped to the **get** and **put** operations in the corresponding database, respectively.
 
   The distributed data object can be in the following states in its lifecycle:
 

en/application-dev/database/database-preference-guidelines.md

@@ -88,15 +88,22 @@ Use the following APIs to delete a **Preferences** instance or data file.
 2. Obtain a **Preferences** instance.
 
    Read the specified file and load its data to the **Preferences** instance for data operations.
-   
+
    FA model:
 
    ```js
    // Obtain the context.
    import featureAbility from '@ohos.ability.featureAbility'
-   var context = featureAbility.getContext()
-
+   let context = featureAbility.getContext();
+   
+   let preferences = null;
    let promise = data_preferences.getPreferences(context, 'mystore');
+   
+   promise.then((pref) => {
+       preferences = pref;
+   }).catch((err) => {
+       console.info("Failed to get the preferences.");
+   })
    ```
 
    Stage model:
@@ -104,14 +111,21 @@ Use the following APIs to delete a **Preferences** instance or data file.
    ```ts
    // Obtain the context.
    import Ability from '@ohos.application.Ability'
-   var context
-   class MainAbility extends Ability{
+   let context = null;
+   let preferences = null;
+   export default class MainAbility extends Ability {
        onWindowStageCreate(windowStage){
-           context = this.context
+           context = this.context;
        }
    }
-
+   
    let promise = data_preferences.getPreferences(context, 'mystore');
+   
+   promise.then((pref) => {
+       preferences = pref;
+   }).catch((err) => {
+       console.info("Failed to get the preferences.");
+   })
    ```
 
 3. Write data.
@@ -119,35 +133,27 @@ Use the following APIs to delete a **Preferences** instance or data file.
    Use the **preferences.put()** method to write data to the **Preferences** instance.
 
    ```js
-   promise.then((preferences) => {
-       let putPromise = preferences.put('startup', 'auto');
-       putPromise.then(() => {
-           console.info("Put the value of 'startup' successfully.");
-       }).catch((err) => {
-           console.info("Failed to put the value of 'startup'. Cause: " + err);
-       })
+   let putPromise = preferences.put('startup', 'auto');
+   putPromise.then(() => {
+       console.info("Put the value of 'startup' successfully.");
    }).catch((err) => {
-       console.info("Failed to get the preferences.");
+       console.info("Failed to put the value of 'startup'. Cause: " + err);
    })
    ```
-
+   
 4. Read data.
 
    Use the **preferences.get()** method to read data.
 
    ```js
-   promise.then((preferences) => {
-     let getPromise = preferences.get('startup', 'default');
-     getPromise.then((value) => {
+   let getPromise = preferences.get('startup', 'default');
+   getPromise.then((value) => {
        console.info("The value of 'startup' is " + value);
-     }).catch((err) => {
-       console.info("Failed to get the value of 'startup'. Cause: " + err);
-     })
    }).catch((err) => {
-       console.info("Failed to get the preferences.")
-   });
+       console.info("Failed to get the value of 'startup'. Cause: " + err);
+   })
    ```
-
+   
 5. Store data persistently.
 
    Use the **flush()** method to flush data from the **Preferences** instance to its file.
@@ -161,11 +167,12 @@ Use the following APIs to delete a **Preferences** instance or data file.
    Specify an observer as the callback to subscribe to data changes for an application. When the value of the subscribed key is changed and saved by **flush()**, the observer callback will be invoked to return the new data.
 
    ```js
-   var observer = function (key) {
+   let observer = function (key) {
        console.info("The key" + key + " changed.");
    }
    preferences.on('change', observer);
-   preferences.put('startup', 'auto', function (err) {
+   // The data is changed from 'auto' to 'manual'.
+   preferences.put('startup', 'manual', function (err) {
        if (err) {
            console.info("Failed to put the value of 'startup'. Cause: " + err);
            return;

en/application-dev/database/database-relational-guidelines.md

@@ -140,7 +140,7 @@ You can obtain the distributed table name for a remote device based on the local
 
 | Class    | API                                                      | Description                                                        |
 | -------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
-| RdbStore | sync(mode: SyncMode, predicates: RdbPredicates): Promise\<Array\<[string, number]>> | Synchronizes data between devices. This API uses a promise to return the result.<br>- **mode**: synchronization mode.  **SYNC_MODE_PUSH** means to push data from the local device to a remote device. **SYNC_MODE_PULL** means to pull data from a remote device to the local device.<br>- **predicates**: specifies the data and devices to synchronize.<br>- **string**: device ID. <br>- **number**: synchronization status of that device. The value **0** indicates a successful synchronization. Other values indicate a synchronization failure.|
+| RdbStore | sync(mode: SyncMode, predicates: RdbPredicates): Promise\<Array\<[string, number]>> | Synchronizes data between devices. This API uses a promise to return the result.<br>- **mode**: synchronization mode.  **SYNC_MODE_PUSH** means to push data from the local device to a remote device. **SYNC_MODE_PULL** means to pull data from a remote device to the local device.<br>- **predicates**: specifies the data and devices to synchronize.<br>- **string**: device ID. <br>- **number**: synchronization status of each device. The value **0** indicates a successful synchronization. Other values indicate a synchronization failure.|
 
 **Registering an RDB Store Observer**
 

en/application-dev/device-usage-statistics/device-usage-statistics-dev-guide.md

@@ -22,8 +22,8 @@ import stats from '@ohos.bundleState';
 | function queryAppUsagePriorityGroup(callback: AsyncCallback<number>): void | Queries the priority group of this application. This API uses an asynchronous callback to return the result.|
 | function queryAppUsagePriorityGroup(): Promise<number>; | Queries the priority group of this application. This API uses a promise to return the result.|
 | function isIdleState(bundleName: string, callback: AsyncCallback<boolean>): void | Checks whether the application specified by **bundleName** is in the idle state. |
-| function getRecentlyUsedModules(callback: AsyncCallback<BundleActiveModuleInfo>): void | Obtains the number of FA usage records specified by **1000**.|
-| function getRecentlyUsedModules(maxNum: number, callback: AsyncCallback<BundleActiveModuleInfo>): void | Obtains the number of FA usage records specified by **maxNum**.|
+| function getRecentlyUsedModules(callback: AsyncCallback<BundleActiveModuleInfo>): void | Obtains a maximum of 1000 FA usage records. |
+| function getRecentlyUsedModules(maxNum: number, callback: AsyncCallback<BundleActiveModuleInfo>): void | Obtains the number of FA usage records specified by **maxNum**, which cannot exceed 1000.|
 | function queryAppNotificationNumber(begin: number, end: number, callback: AsyncCallback<Array<BundleActiveEventState>>): void | Queries the number of notifications from all applications based on the specified start time and end time.|
 | function queryBundleActiveEventStates(begin: number, end: number, callback: AsyncCallback<Array<BundleActiveEventState>>): void | Queries statistics about system events (hibernation, wakeup, unlocking, and screen locking) that occur between the specified start time and end time.|
 | function queryAppUsagePriorityGroup(bundleName : string, callback: AsyncCallback<number>): void | Queries the priority group of the application specified by **bundleName**. This API uses an asynchronous callback to return the result.|
@@ -326,14 +326,14 @@ import stats from '@ohos.bundleState';
      ```js
      import stats from '@ohos.bundleState'
 
-     // Promise mode without parameters
+     // Promise mode when bundleName is not specified
      stats.queryAppUsagePriorityGroup().then(res => {
          console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup promise succeeded. result: ' + JSON.stringify(res));
      }).catch(err => {
          console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup promise failed. because: ' + err.code);
      });
 
-     // Asynchronous callback mode without parameters
+     // Asynchronous callback mode when bundleName is not specified
      stats.queryAppUsagePriorityGroup((err, res) => {
          if (err) {
              console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup callback failed. because: ' + err.code);
@@ -341,16 +341,16 @@ import stats from '@ohos.bundleState';
              console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup callback succeeded. result: ' + JSON.stringify(res));
          }
      });
-
-     // Promise mode with parameters
-     stats.queryAppUsagePriorityGroup(this.bundleName).then(res => {
+    let bundleName = "com.ohos.camera";
+     // Promise mode when bundleName is specified
+     stats.queryAppUsagePriorityGroup(bundleName).then(res => {
          console.log('BUNDLE_ACTIVE QueryPackageGroup promise succeeded. result: ' + JSON.stringify(res));
      }).catch(err => {
          console.log('BUNDLE_ACTIVE QueryPackageGroup promise failed. because: ' + err.code);
      });
 
-     // Asynchronous callback mode with parameters
-     stats.queryAppUsagePriorityGroup(this.bundleName, (err, res) => {
+     // Asynchronous callback mode when bundleName is specified
+     stats.queryAppUsagePriorityGroup(bundleName, (err, res) => {
          if (err) {
              console.log('BUNDLE_ACTIVE QueryPackageGroup callback failed. because: ' + err.code);
          } else {
@@ -437,3 +437,4 @@ import stats from '@ohos.bundleState';
         }
     });
     ```
+

en/application-dev/device/device-location-overview.md

@@ -15,15 +15,18 @@ Your application can call location-specific APIs to obtain the location informat
 Location awareness helps determine where a mobile device locates. The system identifies the location of a mobile device with its coordinates, and uses location technologies such as Global Navigation Satellite System (GNSS) and network positioning (for example, base station positioning or WLAN/Bluetooth positioning) to provide diverse location-based services. These advanced location technologies make it possible to obtain the accurate location of the mobile device, regardless of whether it is indoors or outdoors.
 
 - **Coordinate**
+
   A coordinate describes a location on the earth using the longitude and latitude in reference to the World Geodetic Coordinate System 1984.
 
 - **GNSS positioning**
   GNSS positioning locates a mobile device by using the location algorithm offered by the device chip to compute the location information provided by the Global Navigation Satellite System, for example, GPS, GLONASS, BeiDou, and Galileo. Whichever positioning system will be used during the location process depends on a hardware capability of the device.
 
 - **Base station positioning**
+
   Base station positioning estimates the current location of a mobile device based on the location of the resident base station in reference to the neighboring base stations. This technology provides only a low accuracy and requires access to the cellular network.
 
 - **WLAN or Bluetooth positioning**
+
   WLAN or Bluetooth positioning estimates the current location of a mobile device based on the locations of WLANs and Bluetooth devices that can be discovered by the device. The location accuracy of this technology depends on the distribution of fixed WLAN access points (APs) and Bluetooth devices around the device. A high density of WLAN APs and Bluetooth devices can produce a more accurate location result than base station positioning. This technology also requires access to the network.
 
 

en/application-dev/device/sample-server-guidelines.md

@@ -2,7 +2,7 @@
 
 ## When to Use
 
-The sample server provides a package search server for checking update packages and obtaining the update package download URLs, which was previously unavailable in the real-world update service. The sample server supports update service testing and secondary development function verification, building an end-to-end environment to cater for diverse update service use cases.
+The sample server provides a package search server for checking update packages and obtaining the update package download URLs, which was previously unavailable in the real-world update service. The sample server supports update service testing and functional verification for secondary development, building an end-to-end environment to cater for diverse update service use cases.
 
 ## How to Develop
 
@@ -14,8 +14,6 @@ The sample server provides a package search server for checking update packages
 	openssl req -newkey rsa:2048 -nodes -keyout serverKey.pem -x509 -days 365 -out serverCert.cer -subj "/C=CN/ST=GD/L=GZ/O=abc/OU=defg/CN=hijk/emailAddress=test.com"
 	```
 
-
-
 2. Modify the **bundle.json** file.
 
 	Add **sub_component** to the **build** field.
@@ -32,13 +30,13 @@ The sample server provides a package search server for checking update packages
 	Go to the **update_updateservice** directory and run the following commands to create a code directory:
 
 	```
-	mkdir server_sample                        // Create the server_sample folder.
-	touch server_sample/BUILD.gn               // Create the BUILD.gn file.
-	mkdir server_sample/include                // Create the include folder to store the header file of the sample server.
-	touch server_process.h                     // Create the server_process.h header file.
-	mkdir server_sample/src                    // Create the src folder to store the C/C++ files of the sample server.
-	touch server_sample/src/server_process.c   // Create the server_process.c file.
-	touch server_sample/src/main.cpp           // Create the main.cpp file.
+	mkdir server_sample                            // Create the server_sample folder.
+	touch server_sample/BUILD.gn                   // Create the BUILD.gn file.
+	mkdir server_sample/include                    // Create the include folder to store the header file of the sample server.
+	touch server_process.h                         // Create the server_process.h header file.
+	mkdir server_sample/src                        // Create the src folder to store the C/C++ files of the sample server.
+	touch server_sample/src/server_process.c       // Create the server_process.c file.
+	touch server_sample/src/main.cpp               // Create the main.cpp file.
 	```
 
 4. Write the **BUILD.gn** file.

en/application-dev/device/usb-guidelines.md

@@ -38,7 +38,7 @@ You can set a USB device as the USB host to connect to other USB devices for dat
     // Import the USB API package.
     import usb from '@ohos.usb';
     // Obtain the USB device list.
-    var deviceList = usb.getDevices();
+    let deviceList = usb.getDevices();
     /*
     Example deviceList structure
     [
@@ -81,21 +81,21 @@ You can set a USB device as the USB host to connect to other USB devices for dat
                     number: 1,
                     type: 3,
                     interfaceId: 0,
-                  },
-                ],
-              },
-            ],
-          },
-        ],
-      },
-    ],
+                 }
+               ]
+             }
+           ]
+         }
+       ]
+     }
+   ]
     */
     ```
 
 2.  Obtain the device operation permissions.
 
     ```js
-    var deviceName = deviceList[0].name;
+    let deviceName = deviceList[0].name;
     // Request the permissions to operate a specified device.
     usb.requestRight(deviceName).then(hasRight => {
       console.info("usb device request right result: " + hasRight);
@@ -108,7 +108,7 @@ You can set a USB device as the USB host to connect to other USB devices for dat
 
     ```js
     // Open the device, and obtain the USB device pipe for data transfer.
-    var pipe = usb.connectDevice(deviceList[0]);
+    let pipe = usb.connectDevice(deviceList[0]);
     /*
     Claim the corresponding interface from deviceList.
     interface1 must be one present in the device configuration.
@@ -127,7 +127,7 @@ You can set a USB device as the USB host to connect to other USB devices for dat
     usb.bulkTransfer(pipe, inEndpoint, dataUint8Array, 15000).then(dataLength => {
     if (dataLength >= 0) {
       console.info("usb readData result Length : " + dataLength);
-      var resultStr = this.ab2str(dataUint8Array); // Convert uint8 data into a string.
+      let resultStr = this.ab2str(dataUint8Array); // Convert uint8 data into a string.
       console.info("usb readData buffer : " + resultStr);
     } else {
       console.info("usb readData failed : " + dataLength);

en/application-dev/dfx/hiappevent-guidelines.md

@@ -12,12 +12,10 @@ The following table provides only a brief description of related APIs. For detai
 
 **Table 1** APIs for application event logging
 
-| API                                                      | Description                                                        |
-| ------------------------------------------------------------ | ------------------------------------------------------------ |
-| write(string eventName, EventType type, object keyValues, AsyncCallback\<void> callback): void | Logs application events in asynchronous mode. This API uses an asynchronous callback to return the result.        |
-| write(string eventName, EventType type, object keyValues): Promise\<void> | Logs application events in asynchronous mode. This API uses a promise to return the result.         |
-| write(AppEventInfo info, AsyncCallback\<void> callback): void | Logs application events by domain in asynchronous mode. This API uses an asynchronous callback to return the result.|
-| write(AppEventInfo info): Promise\<void>                     | Logs application events by domain in asynchronous mode. This API uses a promise to return the result.|
+| API                                                      | Description                                                |
+| ------------------------------------------------------------ | ---------------------------------------------------- |
+| write(AppEventInfo info, AsyncCallback\<void> callback): void | Logs application events in asynchronous mode. This API uses an asynchronous callback to return the result.|
+| write(AppEventInfo info): Promise\<void>                     | Logs application events in asynchronous mode. This API uses a promise to return the result. |
 
 When an asynchronous callback is used, the return value can be processed directly in the callback.
 
@@ -84,6 +82,7 @@ The following uses a one-time event watcher as an example to illustrate the deve
              .fontWeight(FontWeight.Bold)
    
            Button("1 writeTest").onClick(()=>{
+             // Perform event logging based on the input event parameters.
              hiAppEvent.write({
                domain: "test_domain",
                name: "test_event",
@@ -100,6 +99,7 @@ The following uses a one-time event watcher as an example to illustrate the deve
            })
    
            Button("2 addWatcherTest").onClick(()=>{
+             // Add an event watcher based on the input subscription parameters.
              hiAppEvent.addWatcher({
                name: "watcher1",
                appEventFilters: [{ domain: "test_domain" }],
@@ -109,17 +109,23 @@ The following uses a one-time event watcher as an example to illustrate the deve
                  timeOut: 2
                },
                onTrigger: function (curRow, curSize, holder) {
+                 // If the holder object is null, return an error after recording it in the log.
                  if (holder == null) {
                    console.error("HiAppEvent holder is null");
                    return;
                  }
+                 // Set the size threshold to 1,000 bytes for obtaining an event package.
+                 holder.setSize(1000);
                  let eventPkg = null;
+                 // Obtain the event package based on the configured size threshold. If returned event package is null, all event data has been obtained.
                  while ((eventPkg = holder.takeNext()) != null) {
-                   console.info("HiAppEvent eventPkg.packageId=" + eventPkg.packageId);
-                   console.info("HiAppEvent eventPkg.row=" + eventPkg.row);
-                   console.info("HiAppEvent eventPkg.size=" + eventPkg.size);
+                   // Parse the obtained event package and display the result on the Log page.
+                   console.info('HiAppEvent eventPkg.packageId=' + eventPkg.packageId);
+                   console.info('HiAppEvent eventPkg.row=' + eventPkg.row);
+                   console.info('HiAppEvent eventPkg.size=' + eventPkg.size);
+                   // Traverse and parse event string arrays in the obtained event package.
                    for (const eventInfo of eventPkg.data) {
-                     console.info("HiAppEvent eventPkg.data=" + eventInfo);
+                     console.info('HiAppEvent eventPkg.data=' + eventInfo);
                    }
                  }
                }
@@ -127,6 +133,7 @@ The following uses a one-time event watcher as an example to illustrate the deve
            })
    
            Button("3 removeWatcherTest").onClick(()=>{
+             // Remove the specified event watcher.
              hiAppEvent.removeWatcher({
                name: "watcher1"
              })

en/application-dev/dfx/hitracemeter-guidelines.md

@@ -12,7 +12,7 @@ The performance tracing APIs are provided by the **hiTraceMeter** module. For de
 
 | API| Return Value| Description|
 | ---------------------------------------------------------------------------- | --------- | ------------ |
-| hiTraceMeter.startTrace(name: string, taskId: number, expectedTime?: number) | void      | Starts a trace task. If multiple trace tasks with the same name need to be performed at the same time or a trace task needs to be performed multiple times concurrently, different task IDs must be specified in **startTrace**. If the trace tasks with the same name are not performed at the same time, the same task ID can be used.|
+| hiTraceMeter.startTrace(name: string, taskId: number) | void      | Starts a trace task. If multiple trace tasks with the same name need to be performed at the same time or a trace task needs to be performed multiple times concurrently, different task IDs must be specified in **startTrace**. If the trace tasks with the same name are not performed at the same time, the same task ID can be used.|
 | hiTraceMeter.finishTrace(name: string, taskId: number)                       | void      | Stops a trace task. The values of **name** and **taskId** must be the same as those of **hiTraceMeter.startTrace**.|
 | hiTraceMeter.traceByValue(name: string, value: number)                       | void      | Traces the value changes of a variable.|
 
@@ -31,10 +31,6 @@ In this example, distributed call chain tracing begins when the application star
        },
        onInit() {
            this.title = this.$t('strings.world');
-
-           // The expected duration of the trace task is 5 ms.
-           hiTraceMeter.startTrace("business", 1);
-           hiTraceMeter.startTrace("business", 1, 5); 
            
            // Start track tasks with the same name concurrently.
            hiTraceMeter.startTrace("business", 1);

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

 # FAQs
 
 - [Ability Framework Development](faqs-ability.md)
-- [Data Management Development](faqs-data-management.md)
-- [File Management Development](faqs-file-management.md)
-- [Graphics and Image Development](faqs-graphics.md)
-- [hdc_std Command Usage](faqs-ide.md)
-- [IDE Usage](faqs-hdc-std.md)
 - [ArkUI (JavaScript) Development](faqs-ui-js.md)
 - [ArkUI (eTS) Development](faqs-ui-ets.md)
 - [Graphics and Image Development](faqs-graphics.md)
 - [File Management Development](faqs-file-management.md)
+- [Network and Connection Development](faqs-connectivity.md)
 - [Data Management Development](faqs-data-management.md)
 - [Device Management Development](faqs-device-management.md)
 - [Native API Usage](faqs-native.md)
-- [Network and Connection Development](faqs-connectivity.md)
 - [Usage of Third- and Fourth-Party Libraries](faqs-third-party-library.md)
+- [hdc_std Command Usage](faqs-ide.md)
+- [IDE Usage](faqs-hdc-std.md)
 - [Development Board](faqs-development-board.md)
-

en/application-dev/faqs/faqs-connectivity.md

@@ -19,7 +19,7 @@ Applicable to: OpenHarmony SDK 3.2.2.5, stage model of API version 9
 
 Applicable to: OpenHarmony SDK 3.2.2.5, stage model of API version 9
 
-Error code 28 refers to **CURLE_OPERATION_TIMEDOUT**, which means a libcurl library operation timeout. For details, see any HTTP status code description available.
+Error code 28 refers to **CURLE_OPERATION_TIMEDOUT**, which means a cURL operation timeout. For details, see any HTTP status code description available.
 
 Reference: [Development Guide](https://gitee.com/openharmony/docs/blob/master/en/application-dev/reference/apis/js-apis-http.md#httpresponse) and [Curl Error Codes](https://curl.se/libcurl/c/libcurl-errors.html)
 

en/application-dev/faqs/faqs-ui-ets.md

@@ -202,7 +202,7 @@ struct DialogTest {
 
 Applicable to: OpenHarmony SDK 3.2.5.3, stage model of API version 9
 
-The **\<List>** component is a scrollable container. By default, it taks up the entire screen height. When any component with a fixed height takes up part of the screen height, you need to explicitly specify **layoutWeight(1)** for the parent container of the **\<List>** component to take up the remaining height instead of the entire screen height.
+The **\<List>** component is a scrollable container. By default, it takes up the entire screen height. When any component with a fixed height takes up part of the screen height, you need to explicitly specify **layoutWeight(1)** for the parent container of the **\<List>** component to take up the remaining height instead of the entire screen height.
 
 ## How do I center child components in a grid container?
 

en/application-dev/faqs/faqs-ui-js.md

@@ -30,7 +30,7 @@ let options = {trim : false, declarationKey:"_declaration",
   nameKey : "_name", elementsKey : "_elements"}
 let result:any = conv.convert(xml, options) // Convert fields in the XML file into JavaScript objects.
 console.log('Test: ' + JSON.stringify(result))
-console.log('Test: ' + result._declaration._attributes.version) // vesion field in XML file
+console.log('Test: ' + result._declaration._attributes.version) // version field in XML file
 console.log('Test: ' + result._elements[0]._elements[0]._elements[0]._text) // title field in XML file
 ```
 

en/application-dev/file-management/Readme-EN.md

+# File Management
+- MediaLibrary Management
+  - [MediaLibrary Overview](medialibrary-overview.md)
+  - [Media Asset Management](medialibrary-resource-guidelines.md)
+  - [File Path Management](medialibrary-filepath-guidelines.md)
+  - [Album Management](medialibrary-album-guidelines.md)
\ No newline at end of file

en/application-dev/file-management/medialibrary-album-guidelines.md

+# Album Management
+
+You can use the APIs provided by the **mediaLibrary** module to create and delete an album and obtain images in the album.
+
+> **NOTE**
+>
+> Before developing features, read [MediaLibrary Overview](medialibrary-overview.md) to learn how to obtain a **MediaLibrary** instance and request the permissions to call the APIs of **MediaLibrary**.
+
+To ensure the application running efficiency, most **MediaLibrary** API calls are asynchronous, and both callback and promise modes are provided for these APIs. The following code samples use the promise mode. For details about the APIs, see [MediaLibrary API Reference](../reference/apis/js-apis-medialibrary.md).
+
+## Obtaining Images and Videos in an Album
+
+You can obtain images and videos in an album in either of the following ways:
+
+- Call [MediaLibrary.getFileAssets](../reference/apis/js-apis-medialibrary.md#getfileassets7-1) with an album specified to obtain the media assets. For details, see [Querying Media Assets with the Specified Album Name](medialibrary-resource-guidelines#querying-media-assets-with-the-specified-album-name).
+
+- Call [Album.getFileAssets](../reference/apis/js-apis-medialibrary.md#getfileassets7-3) to obtain an **Album** instance, so as to obtain the media assets in it. For details, see [Obtaining Images and Videos in an Album](medialibrary-resource-guidelines#obtaining-images-and-videos-in-an-album).
+
+## Creating an Album
+
+You can use [MediaLibrary.createAsset](../reference/apis/js-apis-medialibrary.md#createasset8-1), with the relative path set, to create an album while adding a media asset to the album. The relative path is the album name.
+
+**Prerequisites**
+
+- You have obtained a **MediaLibrary** instance.
+- You have granted the permission **ohos.permission.WRITE_MEDIA**.
+
+The following describes how to create an album named **myAlbum**.
+
+**How to Develop**
+
+1. Call **getPublicDirectory** to obtain the public directory that stores files of a certain type.
+
+   For details about the operation, see [Obtaining a Public Directory](medialibrary-filepath-guidelines.md#obtaining-a-public-directory).
+
+2. Call **createAsset** to create an image, with the relative path set to **path + 'myAlbum/'**.
+
+   This operation creates an album and adds an image to it.
+
+```ts
+async function example() {
+    let mediaType = mediaLibrary.MediaType.IMAGE;
+    let DIR_IMAGE = mediaLibrary.DirectoryType.DIR_IMAGE;
+    const context = getContext(this);
+    var media = mediaLibrary.getMediaLibrary(context);
+    const path = await media.getPublicDirectory(DIR_IMAGE)
+    // myAlbum is the path for storing the new file and the name of the new album.
+    media.createAsset(mediaType, 'test.jpg', path + 'myAlbum/', (err, fileAsset) => {
+        if (fileAsset != undefined) {
+        console.info('createAlbum successfully, message = ' + fileAsset);
+        } else {
+        console.info('createAlbum failed, message = ' + err);
+        }
+    });
+}
+```
+
+## Renaming an Album
+
+Renaming modifies the **FileAsset.albumName** attribute of the album, that is, the album name. After the modification, call [Album.commitModify](../reference/apis/js-apis-medialibrary.md#commitmodify8-3) to commit the modification to the database.
+
+**Prerequisites**
+
+- You have obtained a **MediaLibrary** instance.
+- You have granted the permission **ohos.permission.WRITE_MEDIA**.
+
+The following describes how to rename the album **newAlbum**.
+
+**How to Develop**
+
+1. Create a retrieval condition for obtaining the target album.
+2. Call **getAlbums** to obtain the album list.
+3. Rename the album **newAlbum**.
+4. Call **Album.commitModify** to commit the modification of the attributes to the database.
+
+```ts
+async function example() {
+    let AlbumNoArgsfetchOp = {
+        selections: '',
+        selectionArgs: [],
+    };
+    const context = getContext(this);
+    var media = mediaLibrary.getMediaLibrary(context);
+    let albumList = await media.getAlbums(AlbumNoArgsfetchOp);
+    let album = albumList[0];
+    album.albumName = 'newAlbum';
+    // Void callback.
+    album.commitModify().then(function() {
+        console.info("albumRename successfully");
+    }).catch(function(err){
+        console.info("albumRename failed with error:"+ err);
+    });
+}
+```

en/application-dev/file-management/medialibrary-filepath-guidelines.md

+# File Path Management
+
+User data on OpenHarmony is managed by the **mediaLibrary** module in a unified manner. You can use the APIs provided by this module to access and operate the user data.
+
+> **NOTE**
+>
+> Before developing features, read [MediaLibrary Overview](medialibrary-overview.md) to learn how to obtain a **MediaLibrary** instance and request the permissions to call the APIs of **MediaLibrary**.
+
+To ensure the application running efficiency, most **MediaLibrary** API calls are asynchronous, and both callback and promise modes are provided for these APIs. The following code samples use the promise mode. For details about the APIs, see [MediaLibrary API Reference](../reference/apis/js-apis-medialibrary.md).
+
+## File Formats Supported by Public Directories
+
+Before using file paths for development, learn the file formats supported by each public directory.
+> **CAUTION**
+>
+> The following table lists only the file types that can be identified by the system. In your application development, pay attention to the file formats supported by the corresponding interfaces. <br> For example, only .jpeg and .webp can be used for image encoding, and only .jpg, .png, .gif, .bmp, .webp, and .raw can be used for image decoding.
+
+| Directory  | Directory Type     | Media Type     | Description          | Supported File Format                                              |
+| ---------- | ------------- | ------------- | -------------- | ------------------------------------------------------------ |
+| Camera/    | DIR_CAMERA    |    VIDEO and IMAGE     | Directory for storing images and videos taken by the camera. Videos and images can be stored in this directory and its subdirectories.| .bmp / .bm / .gif / .jpg /. jpeg / .jpe / .png / .webp / .raw / .svg / .heif / .mp4 / .3gp / .mpg / .mov / .webm / .mkv |
+| Videos/    | DIR_VIDEO     | VIDEO | Dedicated video directory. Only videos can be stored in this directory and its subdirectories.| .mp4 / .3gp / .mpg / .mov / .webm / .mkv                     |
+| Pictures/  | DIR_IMAGE     | IMAGE | Dedicated image directory. Only images can be stored in this directory and its subdirectories.| .bmp / .bm / .gif / .jpg /. jpeg / .jpe / .png / .webp / .raw / .svg / .heif |
+| Audios/    | DIR_AUDIO     | AUDIO |Dedicated audio directory. Only audio files can be stored in this directory and its subdirectories.| .aac/.mp3/.flac/.wav/.ogg                                    |
+| Documents/ | DIR_DOCUMENTS | FILE  |Dedicated file directory. Only files except audios, images, and videos can be stored in this directory and its subdirectories.| -                                                |
+| Download/  | DIR_DOWNLOAD  | ALLTYPE       |Directory for storing downloaded files. The types of files in this directory and its subdirectories are not restricted.| -                                                    |
+
+## Obtaining a Public Directory
+
+Different types of files are stored in different public directories. You can call [getPublicDirectory](../reference/apis/js-apis-medialibrary.md#getpublicdirectory8-1) to obtain the public directory that stores files of a certain type.
+
+**Prerequisites**
+
+- You have obtained a **MediaLibrary** instance.
+- You have granted the permission **ohos.permission.READ_MEDIA**.
+
+The following describes how to obtain the public directory that stores camera files.
+
+```ts
+async function example(){
+    const context = getContext(this);
+    var media = mediaLibrary.getMediaLibrary(context);
+    let DIR_CAMERA = mediaLibrary.DirectoryType.DIR_CAMERA;
+    const dicResult = await media.getPublicDirectory(DIR_CAMERA);
+    if (dicResult == 'Camera/') {
+        console.info('mediaLibraryTest : getPublicDirectory passed');
+    } else {
+        console.info('mediaLibraryTest : getPublicDirectory failed');
+    }
+}
+```
+
+## Copying Files Between the Application Sandbox and the Public Directory
+
+OpenHarmony provides the application sandbox to minimize the leakage of application data and user privacy information.
+
+Users can access files stored in the public directories through the system applications **Files** and **Gallery**. However, files in the application sandbox can be accessed only by the application itself.
+
+### Copying a File
+
+You can call [mediaLibrary.FileAsset.open](../reference/apis/js-apis-medialibrary.md#open8-1) to open a file in a public directory.
+
+You can call [fileio.open](../reference/apis/js-apis-fileio.md#fileioopen7) to open a file in the application sandbox. The sandbox directory can be accessed only through the application context.
+
+**Prerequisites**
+
+- You have obtained a **MediaLibrary** instance.
+- You have granted the permission **ohos.permission.WRITE_MEDIA**.
+- You have imported the module [@ohos.fileio](../reference/apis/js-apis-fileio.md) in addition to @ohos.multimedia.mediaLibrary.
+
+**How to Develop**
+
+1. Call [Context.getFilesDir](../reference/apis/js-apis-Context.md#contextgetfilesdir) to obtain the directory of the application sandbox.
+2. Call **MediaLibrary.getFileAssets** and **FetchFileResult.getFirstObject** to obtain the first file in the result set of the public directory.
+3. Call **fileio.open** to open the file in the sandbox.
+4. Call **fileAsset.open** to open the file in the public directory.
+5. Call **fileio.copyfile** to copy the file.
+6. Call **fileAsset.close** and **fileio.close** to close the file.
+
+**Example 1: Copying Files from the Public Directory to the Sandbox**
+
+```ts
+async function copyPublic2Sandbox() {
+    const context = getContext(this);
+    var media = mediaLibrary.getMediaLibrary(context);
+    let sandboxDirPath = globalThis.context.filesDir;
+    let fileKeyObj = mediaLibrary.FileKey
+    let fileAssetFetchOp = {
+        selections: fileKeyObj.DISPLAY_NAME + '= ?' ,
+        selectionArgs: ['testFile.txt'],
+    };
+    let fetchResult = await media.getFileAssets(fileAssetFetchOp);
+    let fileAsset = await fetchResult.getFirstObject();
+
+    let fdPub = await fileAsset.open('rw');
+    let fdSand = await fileio.open(sandboxDirPath + '/testFile.txt', 0o2 | 0o100, 0o666);
+    await fileio.copyFile(fdPub, fdSand);
+
+    await fileAsset.close(fdPub);
+    await fileio.close(fdSand);
+
+    let content_sand = await fileio.readText(sandboxDirPath + '/testFile.txt');
+    console.log('content read from sandbox file: ', content_sand)
+}
+```
+
+**Example 2: Copying a File from the Sandbox to the Public Directory**
+
+```ts
+async function copySandbox2Public() {
+    const context = getContext(this);
+    var media = mediaLibrary.getMediaLibrary(context);
+    let sandboxDirPath = globalThis.context.filesDir;
+
+    let DIR_DOCUMENTS = mediaLibrary.DirectoryType.DIR_DOCUMENTS;
+    const publicDirPath = await media.getPublicDirectory(DIR_DOCUMENTS);
+    try {
+        let fileAsset = await media.createAsset(mediaLibrary.MediaType.FILE, 'testFile02.txt', publicDirPath);
+        console.info('createFile successfully, message = ' + fileAsset);
+    } catch (err) {
+        console.info('createFile failed, message = ' + err);
+    }
+    try {
+        let fileKeyObj = mediaLibrary.FileKey
+        let fileAssetFetchOp = {
+            selections: fileKeyObj.DISPLAY_NAME + '= ?' ,
+            selectionArgs: ['testFile02.txt'],
+        };
+        let fetchResult = await media.getFileAssets(fileAssetFetchOp);
+        var fileAsset = await fetchResult.getFirstObject();
+    } catch (err) {
+        console.info('file asset get failed, message = ', err)
+    }
+    var fdPub = await fileAsset.open('rw');
+    var fdSand = await fileio.open(sandboxDirPath + 'testFile.txt', 0o2);
+    await fileio.copyFile(fdSand, fdPub);
+    await fileio.close(fdPub);
+    await fileio.close(fdSand);
+    let fdPubRead = await fileAsset.open('rw');
+    try {
+        var arrayBuffer = new ArrayBuffer(4096);
+        await fileio.read(fdPubRead, arrayBuffer);
+        var content_pub = String.fromCharCode(new Uint8Array(arrayBuffer));
+        fileAsset.close(fdPubRead);
+    } catch (err) {
+        console.log('read text failed, message = ', err);
+    }
+    console.log('content read from public file: ', content_pub);
+}
+```
+
+### Reading and Writing a File
+
+You can use **FileAsset.open** and **FileAsset.close** of [mediaLibrary](../reference/apis/js-apis-medialibrary.md) to open and close a file, and use **fileio.read** and **fileio.write** of [fileio](../reference/apis/js-apis-fileio.md) to read and write a file.
+
+**Prerequisites**
+
+- You have obtained a **MediaLibrary** instance.
+- You have granted the permission **ohos.permission.WRITE_MEDIA**.
+- You have imported the module [@ohos.fileio](../reference/apis/js-apis-fileio.md) in addition to @ohos.multimedia.mediaLibrary.
+
+**How to Develop**
+
+1. Create a file.
+
+   ```ts
+   async function example() {
+       let mediaType = mediaLibrary.MediaType.FILE;
+       let DIR_DOCUMENTS = mediaLibrary.DirectoryType.DIR_DOCUMENTS;
+       const context = getContext(this);
+       var media = mediaLibrary.getMediaLibrary(context);
+       const path = await media.getPublicDirectory(DIR_DOCUMENTS);
+       media.createAsset(mediaType, "testFile.text", path).then (function (asset) {
+           console.info("createAsset successfully:"+ JSON.stringify(asset));
+       }).catch(function(err){
+           console.info("createAsset failed with error:"+ err);
+       });
+   }
+   ```
+
+2. Call **FileAsset.open** to open the file.
+
+3. Call **fileio.write** to write a string to the file.
+
+4. Call **fileio.read** to read the file and save the data read in an array buffer.
+
+5. Convert the array buffer to a string.
+
+6. Use **FileAsset.close** to close the file.
+
+**Example 1: Opening an Existing File and Writing Data to It**
+
+```ts
+async function writeOnlyPromise() {
+    const context = getContext(this);
+    var media = mediaLibrary.getMediaLibrary(context);
+    let fileKeyObj = mediaLibrary.FileKey
+    let fileAssetFetchOp = {
+        selections: fileKeyObj.DISPLAY_NAME + '= ?' ,
+        selectionArgs: ['testFile.txt'],
+    };
+    let fetchResult = await media.getFileAssets(fileAssetFetchOp);
+    let fileAsset = await fetchResult.getFirstObject();
+    console.info('fileAssetName: ', fileAsset.displayName);
+
+    try {
+        let fd = await fileAsset.open('w');
+        console.info('file descriptor: ', fd);
+        await fileio.write(fd, "Write file test content.");
+        await fileAsset.close(fd);
+    } catch (err) {
+        console.info('write file failed, message = ', err);
+    }
+}
+```
+
+**Example 2: Opening an Existing File and Reading Data from It**
+
+```ts
+async function readOnlyPromise() {
+    const context = getContext(this);
+    var media = mediaLibrary.getMediaLibrary(context);
+    let fileKeyObj = mediaLibrary.FileKey
+    let fileAssetFetchOp = {
+        selections: fileKeyObj.DISPLAY_NAME + '= ?' ,
+        selectionArgs: ['testFile.txt'],
+    };
+    let fetchResult = await media.getFileAssets(fileAssetFetchOp);
+    let fileAsset = await fetchResult.getFirstObject();
+    console.info('fileAssetName: ', fileAsset.displayName);
+
+    try {
+        let fd = await fileAsset.open('r');
+        let arrayBuffer = new ArrayBuffer(4096);
+        await fileio.read(fd, arrayBuffer);
+        let fileContent = String.fromCharCode(...new Uint8Array(arrayBuffer));
+        globalThis.fileContent = fileContent
+        globalThis.fileName = fileAsset.displayName;
+        console.info('file content: ', fileContent);
+        await fileAsset.close(fd);
+    } catch (err) {
+        console.info('read file failed, message = ', err);
+    }
+}
+```

en/application-dev/file-management/medialibrary-overview.md

+# MediaLibrary Development Overview
+
+The **mediaLibrary** module provides APIs for you to access and modify media files.
+
+- You can manage [media assets (audios, videos, image, and files)](medialibrary-resource-guidelines.md) as follows:
+  - Query media assets.
+  - Obtain an image or a video.
+  - Obtain the thumbnail of an image or a video.
+  - Create a media asset.
+  - Rename a media asset.
+  - Move a media asset to the recycle bin.
+- You can manage [file paths](medialibrary-filepath-guidelines.md) as follows:
+  - Obtain the public directory that stores files of a certain type.
+  - Copy files between the application sandbox and the public directory.
+  - Read and write a file.
+- You can manage [albums](medialibrary-album-guidelines.md) as follows:
+  - Obtain images and videos in an album.
+  - Create an album.
+  - Rename an album.
+
+> **NOTE**
+>
+> This development guide applies only to the stage model (available from API version 9).
+
+To access and modify personal media data, an application must obtain a **MediaLibrary** instance and request the media asset read and write permissions from the user.
+
+Before using the **MediaLibrary** APIs to develop features, you must learn how to:
+
+- [Obtain a MediaLibrary Instance](#obtaining-a-medialibrary-instance)
+- [Request Permissions](#requesting-permissions)
+
+## Obtaining a MediaLibrary Instance
+
+An application must call [getMediaLibrary](../reference/apis/js-apis-medialibrary.md#medialibrarygetmedialibrary8) to obtain a **MediaLibrary** instance based on the application context. Through this instance, the application can access and modify personal media data (such as audios, videos, images, and files).
+
+**How to Develop**
+
+1. Import the **mediaLibrary** module.
+2. Call **getContext** to obtain the application context.
+3. Obtain a **MediaLibrary** instance.
+
+```ts
+import mediaLibrary from '@ohos.multimedia.mediaLibrary';
+
+const context = getContext(this);
+var media = mediaLibrary.getMediaLibrary(context);
+```
+
+## Requesting Permissions
+
+To read and write a **MediaLibrary** instance, you must have the required permissions, as described in the table below. Before requesting the permissions, ensure that the [basic principles for permission management](../security/accesstoken-overview.md#basic-principles-for-permission-management) are met.  
+
+| Permission                        | Description                                      | Authorization Mode  |
+| ------------------------------ | ------------------------------------------ | ---------- |
+| ohos.permission.READ_MEDIA     | Allows an application to read media files from the user's external storage.| user_grant |
+| ohos.permission.WRITE_MEDIA    | Allows an application to read media files from and write media files into the user's external storage.| user_grant |
+| ohos.permission.MEDIA_LOCATION | Allows an application to access geographical locations in the user's media file.| user_grant |
+
+After configuring the permissions in the **module.json5** file, the application must call [Context.requestPermissionsFromUser](../reference/apis/js-apis-ability-context.md#abilitycontextrequestpermissionsfromuser) to check for the required permissions and if they are not granted, request the permissions from the user by displaying a dialog box.
+
+> **NOTE**<br>Even if the user has granted a permission, the application must check for the permission before calling an API protected by the permission. It should not persist the permission granted status, because the user can revoke the permission through the system application **Settings**.
+
+**How to Develop**
+
+1. Declare the permissions in the **module.json5** file. Add the **requestPermissions** tag under **module** in the file, and set the tag based on the project requirements. For details about the tag, see [Guide for Requesting Permissions from User](../security/accesstoken-guidelines.md).
+
+   ```json
+   {
+       "module": {
+           "requestPermissions": [
+               {
+                   "name": "ohos.permission.MEDIA_LOCATION",
+                   "reason": "$string:reason",
+                   "usedScene": {
+                       "abilities": [
+                         "MainAbility"
+                       ],
+                       "when": "always"
+               }
+               },
+               {
+                   "name": "ohos.permission.READ_MEDIA",
+                   "reason": "$string:reason",
+                   "usedScene": {
+                       "abilities": [
+                           "MainAbility"
+                       ],
+                       "when": "always"
+                   }
+               },
+               {
+                   "name": "ohos.permission.WRITE_MEDIA",
+                   "reason": "$string:reason",
+                   "usedScene": {
+                       "abilities": [
+                           "MainAbility"
+                       ],
+                       "when": "always"
+                   }
+               }
+           ]
+       }
+   }    
+   ```
+
+2. Call **requestPermissionsFromUser** to check for the required permissions and if they are not granted, request the permissions from the user by displaying a dialog box.
+
+   ```ts
+   import Ability from '@ohos.application.Ability'
+   
+   export default class MainAbility extends Ability {
+       onWindowStageCreate(windowStage) {
+           var permissions=['ohos.permission.READ_MEDIA','ohos.permission.WRITE_MEDIA']
+           var permissionRequestResult;
+           this.context.requestPermissionsFromUser(permissions,(err,result) => {
+               if(err){
+                   console.log('requestPermissionsFromUserError: ' + JSON.stringify(err));
+               }else{
+                   permissionRequestResult=result;
+                   console.log('permissionRequestResult: ' + JSON.stringify(permissionRequestResult));
+               }    
+           });       
+       }
+   }
+   ```
+
+   

en/application-dev/file-management/medialibrary-resource-guidelines.md

+# Media Asset Management
+
+Your applications can use the APIs provided by the **mediaLibrary** module to perform operations on media assets such as audios, videos, images, and files.
+
+> **NOTE**
+>
+> Before developing features, read [MediaLibrary Overview](medialibrary-overview.md) to learn how to obtain a **MediaLibrary** instance and request the permissions to call the APIs of **MediaLibrary**.
+
+To ensure the application running efficiency, most **MediaLibrary** API calls are asynchronous, and both callback and promise modes are provided for these APIs. The following code samples use the promise mode. For details about the APIs, see [MediaLibrary API Reference](../reference/apis/js-apis-medialibrary.md).
+
+## Querying Media Assets
+
+You can query media assets by condition such as the media type, date, or album name.
+
+To do so, call [MediaLibrary.getFileAssets](../reference/apis/js-apis-medialibrary.md#getfileassets7-1), with a **MediaFetchOptions** object passed in to specify the conditions. In this object, **MediaFetchOptions.selections** are the retrieval conditions, and the enumerated values of **FileKey** are used as the column names of the conditions; **MediaFetchOptions.selectionArgs** are the values of the conditions. You can also specify **order** (sorting mode of the search result), **uri** (file URI), and **networkId** (network ID of the registered device) as the conditions.
+
+To obtain the object at the specified position (for example, the first, the last, or with the specified index) in the result set, call [FetchFileResult](../reference/apis/js-apis-medialibrary.md#fetchfileresult7). In this section, **getNextObject** is used cyclically to obtain all media assets in the result set.
+
+**Prerequisites**
+
+- You have obtained a **MediaLibrary** instance.
+- You have granted the permission **ohos.permission.READ_MEDIA**.
+
+### Querying Media Assets with the Specified Media Type
+
+The following describes how to obtain images.
+
+**How to Develop**
+
+To specify the media type as the retrieval condition, set **selections** to **FileKey.MEDIA_TYPE**.
+
+To specify the image as the media type, set **selectionArgs** to **MediaType.IMAGE**.
+
+```ts
+async function example() {
+    let fileKeyObj = mediaLibrary.FileKey
+    let fileType = mediaLibrary.MediaType.IMAGE
+    let option = {
+        selections: fileKeyObj.MEDIA_TYPE + '= ?',
+        selectionArgs: [fileType.toString()],
+    };
+    const context = getContext(this);
+    var media = mediaLibrary.getMediaLibrary(context);
+    const fetchFileResult = await media.getFileAssets(option);
+    for (let i = 0; i < fetchFileResult.getCount(); i++) {
+        fetchFileResult.getNextObject((err, fileAsset) => {
+        if (err) {
+            console.error('Failed ');
+            return;
+        }
+        console.log('fileAsset.displayName ' + i + ': ' + fileAsset.displayName);
+        })
+    } 
+}
+```
+
+### Querying Media Assets with the Specified Date
+
+The following describes how to obtain media assets that are added on the specified date. You can also use the modification date and shooting date as the retrieval conditions.
+
+To specify the date when the files are added as the retrieval condition, set **selections** to **FileKey.DATE_ADDED**.
+
+To specify the date 2022-8-5, set **selectionArgs** to **2022-8-5**.
+
+```ts
+async function example() {
+    let fileKeyObj = mediaLibrary.FileKey
+    let option = {
+        selections: fileKeyObj.DATE_ADDED + '= ?',
+        selectionArgs: ['2022-8-5'],
+    };
+    const context = getContext(this);
+    var media = mediaLibrary.getMediaLibrary(context);
+    const fetchFileResult = await media.getFileAssets(option);
+    for (let i = 0; i < fetchFileResult.getCount(); i++) {
+        fetchFileResult.getNextObject((err, fileAsset) => {
+        if (err) {
+            console.error('Failed ');
+            return;
+        }
+        console.log('fileAsset.displayName ' + i + ': ' + fileAsset.displayName);
+        })
+    } 
+}
+```
+
+### Querying Media Assets and Sorting Them
+
+The following describes how to query images and sort them in descending order by the date when they are added. You can also sort them in ascending order.
+
+To sort files in descending order by the date when they are added, set **order** to **FileKey.DATE_ADDED + " DESC"**.
+
+```ts
+async function example() {
+    let fileKeyObj = mediaLibrary.FileKey
+    let fileType = mediaLibrary.MediaType.IMAGE
+    let option = {
+        selections: fileKeyObj.MEDIA_TYPE + '= ?',
+        selectionArgs: [fileType.toString()],
+        order: fileKeyObj.DATE_ADDED + " DESC",
+    };
+    const context = getContext(this);
+    var media = mediaLibrary.getMediaLibrary(context);
+    const fetchFileResult = await media.getFileAssets(option);
+    for (let i = 0; i < fetchFileResult.getCount(); i++) {
+        fetchFileResult.getNextObject((err, fileAsset) => {
+        if (err) {
+            console.error('Failed ');
+            return;
+        }
+        console.log('fileAsset.displayName ' + i + ': ' + fileAsset.displayName);
+        })
+    } 
+}
+```
+
+### Querying Media Assets with the Specified Album Name
+
+The following describes how to query media assets in **myAlbum**.
+
+To specify the album name as the retrieval condition, set **selections** to **FileKey.ALBUM_NAME**.
+
+To specify the album name **'myAlbum'**, set **selectionArgs** to **'myAlbum'**.
+
+```ts
+async function example() {
+    let fileKeyObj = mediaLibrary.FileKey
+    let fileType = mediaLibrary.MediaType.IMAGE
+    let option = {
+        selections: fileKeyObj.ALBUM_NAME + '= ?',
+        selectionArgs: ['myAlbum'],
+    };
+    const context = getContext(this);
+    var media = mediaLibrary.getMediaLibrary(context);
+    const fetchFileResult = await media.getFileAssets(option);
+    for (let i = 0; i < fetchFileResult.getCount(); i++) {
+        fetchFileResult.getNextObject((err, fileAsset) => {
+        if (err) {
+            console.error('Failed ');
+            return;
+        }
+        console.log('fileAsset.displayName ' + i + ': ' + fileAsset.displayName);
+        })
+    } 
+}
+```
+
+## Obtaining Images and Videos in an Album
+
+You can obtain media assets in an album in either of the following ways:
+
+- Call [MediaLibrary.getFileAssets](../reference/apis/js-apis-medialibrary.md#getfileassets7-1) with an album specified, as described in [Querying Media Assets with the Specfied Album Name](#querying-media-assets-with-the-specified-album-name).
+- Call [Album.getFileAssets](../reference/apis/js-apis-medialibrary.md#getfileassets7-3) to obtain an **Album** instance, so as to obtain the media assets in it.
+
+**Prerequisites**
+
+- You have obtained a **MediaLibrary** instance.
+- You have granted the permission **ohos.permission.READ_MEDIA**.
+
+**How to Develop**
+
+The following describes how to obtain videos in an album named **New Album 1**.
+
+1. Create a retrieval condition for obtaining the target **Album** instance.
+
+   ```ts
+   let fileKeyObj = mediaLibrary.FileKey;
+   let AlbumNoArgsFetchOp = {
+       selections: fileKeyObj.ALBUM_NAME + '= ?',
+       selectionArgs:['New Album 1']
+   }
+   ```
+
+2. Create a retrieval condition for obtaining videos in the target album.
+
+   ```ts
+   let fileKeyObj = mediaLibrary.FileKey;
+   let imageType = mediaLibrary.MediaType.VIDEO;
+   let imagesFetchOp  = {
+       selections: fileKeyObj.MEDIA_TYPE + '= ?',
+       selectionArgs: [imageType.toString()],
+   }
+   ```
+
+3. Call **Album.getFileAssets** to obtain the videos in the target album.
+
+Complete sample code:
+
+```ts
+async function getCameraImagePromise() {
+    const context = getContext(this);
+    var media = mediaLibrary.getMediaLibrary(context);
+    let fileKeyObj = mediaLibrary.FileKey;
+    let imageType = mediaLibrary.MediaType.IMAGE;
+    let imagesFetchOp = {
+        selections: fileKeyObj.MEDIA_TYPE + '= ?',
+        selectionArgs: [imageType.toString()],
+    }
+    let AlbumNoArgsFetchOp = {
+        selections: fileKeyObj.ALBUM_NAME + '= ?',
+        selectionArgs:['New Album 1']
+    }
+
+    let albumList = await media.getAlbums(AlbumNoArgsFetchOp);
+    if (albumList.length > 0) {
+        const album = albumList[0];
+        let fetchFileResult = await album.getFileAssets(imagesFetchOp);
+        let count = fetchFileResult.getCount();
+        console.info("get mediaLibrary IMAGE number", count);
+    } else {
+        console.info('getAlbum list is: 0');
+    }
+}
+```
+
+## Obtaining the Thumbnail of an Image or a Video
+
+You can call [FileAsset.getThumbnail](../reference/apis/js-apis-medialibrary.md#getthumbnail8-2) with the thumbnail size passed in to obtain the thumbnail of an image or a video. Thumbnails are usually displayed on the UI.
+
+**Prerequisites**
+
+- You have obtained a **MediaLibrary** instance.
+- You have granted the permission **ohos.permission.READ_MEDIA**.
+
+### Obtaining the Thumbnail of an Image
+
+Your application may need to obtain the thumbnail of an image for preview purposes.
+
+The following describes how to obtain the thumbnail (size: 720 x 720) of the first image in the album.
+
+**How to Develop**
+
+1. Create a retrieval condition for obtaining images in the target album.
+2. Call **getFileAssets** to obtain the images in the target album.
+3. Call **getFirstObject** to obtain the first image among all the images obtained.
+4. Call **getThumbnail** to obtain the thumbnail of the first image.
+
+```ts
+async function getFirstThumbnailPromise() {
+    const context = getContext(this);
+    var media = mediaLibrary.getMediaLibrary(context);
+    let fileKeyObj = mediaLibrary.FileKey;
+    let imageType = mediaLibrary.MediaType.IMAGE;
+    let imagesFetchOp = {
+        selections: fileKeyObj.MEDIA_TYPE + '= ?',
+        selectionArgs: [imageType.toString()],
+    }
+
+    let size = { width: 720, height: 720 };
+    const fetchFileResult = await media.getFileAssets(imagesFetchOp);
+    if (fetchFileResult != undefined) {
+        const asset = await fetchFileResult.getFirstObject();
+        asset.getThumbnail(size).then((pixelMap) => {
+          pixelMap.getImageInfo().then((info) => {
+              console.info('get Thumbnail info: ' + "width: " + info.size.width + " height: " + info.size.height);
+          }).catch((err) => {
+              console.info("getImageInfo failed with error:" + err);
+          });
+        }).catch((err) => {
+            console.info("getImageInfo failed with error:" + err);
+        });
+    } else {
+        console.info("get image failed with error");
+    }
+}
+```
+
+## Creating a Media Asset
+
+You can call [MediaLibrary.createAsset](../reference/apis/js-apis-medialibrary.md#createasset8-1) to create a media asset.
+
+**Prerequisites**
+
+- You have obtained a **MediaLibrary** instance.
+- You have granted the permission **ohos.permission.WRITE_MEDIA**.
+- [Obtain the public directory](medialibrary-filepath-guidelines.md).
+
+The following describes how to create a file of the **MediaType.FILE** type.
+
+```ts
+async function example() {
+    let mediaType = mediaLibrary.MediaType.FILE;
+    let DIR_DOCUMENTS = mediaLibrary.DirectoryType.DIR_DOCUMENTS;
+    const context = getContext(this);
+    var media = mediaLibrary.getMediaLibrary(context);
+    const path = await media.getPublicDirectory(DIR_DOCUMENTS);
+    media.createAsset(mediaType, "testFile.text", path).then ((asset) => {
+        console.info("createAsset successfully:"+ JSON.stringify(asset));
+    }).catch((err) => {
+        console.info("createAsset failed with error:"+ err);
+    });
+}
+```
+
+## Moving a Media Asset to the Recycle Bin
+
+You can use [FileAsset.trash](../reference/apis/js-apis-medialibrary.md#trash8) to move a media asset to the recycle bin.
+
+By default, files in the recycle bin will be stored for 30 days. During this period, you can set **isTrash** in **trash** to **false** to recover the files from the recycle bin. Application users can also recover the files through the system applications **Files** or **Gallery**.
+
+**Prerequisites**
+
+- You have obtained a **MediaLibrary** instance.
+- You have granted the permission **ohos.permission.WRITE_MEDIA**.
+
+The following describes how to move the first file in the result set to the recycle bin.
+
+**How to Develop**
+
+1. Create a retrieval condition for obtaining images in the target album.
+2. Call **getFileAssets** to obtain the images in the target album.
+3. Call **getFirstObject** to obtain the first image among all the images obtained.
+4. Call **trash** to move the first image to the recycle bin.
+
+```ts
+async function example() {
+    let fileKeyObj = mediaLibrary.FileKey
+    let fileType = mediaLibrary.MediaType.FILE
+    let option = {
+        selections: fileKeyObj.MEDIA_TYPE + '= ?',
+        selectionArgs: [fileType.toString()],
+    };
+    const context = getContext(this);
+    var media = mediaLibrary.getMediaLibrary(context);
+    const fetchFileResult = await media.getFileAssets(option);
+    let asset = await fetchFileResult.getFirstObject();
+    if (asset == undefined) {
+      console.error('asset not exist')
+      return
+    }
+    // Void callback.
+    asset.trash(true).then(() => {
+        console.info("trash successfully");
+    }).catch((err) => {
+        console.info("trash failed with error:"+ err);
+    });
+}
+```
+
+## Renaming a Media Asset
+
+Renaming modifies the **FileAsset.displayName** attribute of a file, that is, the displayed file name, including the file name extension.
+
+After the modification, call [FileAsset.commitModify](../reference/apis/js-apis-medialibrary.md#commitmodify8-1) to commit the modification to the database.
+
+Before renaming a file, you must call [FetchFileResult](../reference/apis/js-apis-medialibrary.md#fetchfileresult7) to obtain the file.
+
+**Prerequisites**
+
+- You have obtained a **MediaLibrary** instance.
+- You have granted the permission **ohos.permission.WRITE_MEDIA**.
+
+The following describes how to rename the first file in the result set as **newtitle.text**.
+
+**How to Develop**
+
+1. Create a retrieval condition for obtaining images in the target album.
+2. Call **getFileAssets** to obtain the images in the target album.
+3. Call **getFirstObject** to obtain the first image among all the images obtained.
+4. Rename the image as **newImage.jpg**.
+5. Call **FileAsset.commitModify** to commit the modification of the attributes to the database.
+
+```ts
+async function example() {
+    let fileKeyObj = mediaLibrary.FileKey
+    let fileType = mediaLibrary.MediaType.FILE
+    let option = {
+        selections: fileKeyObj.MEDIA_TYPE + '= ?',
+        selectionArgs: [fileType.toString()],
+    };
+    const context = getContext(this);
+    var media = mediaLibrary.getMediaLibrary(context);
+    const fetchFileResult = await media.getFileAssets(option);
+    let asset = await fetchFileResult.getFirstObject();
+    if (asset == undefined) {
+      console.error('asset not exist')
+      return
+    }
+    asset.displayName = 'newImage.jpg';
+    // Void callback.
+    asset.commitModify((err) => {
+       if (err) {
+           console.error('fileRename Failed ');
+           return;
+       }
+       console.log('fileRename successful.');
+    })
+}
+```

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

@@ -9,15 +9,15 @@ You can use APIs provided in the following table to obtain the system language a
 
 ### Available APIs
 
-| Module | API | Description | 
+| Module | API | Description |
 | -------- | -------- | -------- |
-| ohos.i18n | getSystemLanguage(): string | Obtains the system language. | 
-| ohos.i18n | getSystemRegion(): string | Obtains the system region. | 
-| ohos.i18n | getSystemLocale(): string | Obtains the system locale. | 
-| ohos.i18n | isRTL(locale: string): boolean<sup>7+</sup> | Checks whether the locale uses a right-to-left (RTL) language. | 
-| ohos.i18n | is24HourClock(): boolean<sup>7+</sup> | Checks whether the system uses a 24-hour clock. | 
-| ohos.i18n | getDisplayLanguage(language: string, locale: string, sentenceCase?: boolean): string | Obtains the localized display of a language. | 
-| ohos.i18n | getDisplayCountry(country: string, locale: string, sentenceCase?: boolean): string | Obtains the localized display of a country name. | 
+| ohos.i18n | getSystemLanguage(): string | Obtains the system language. |
+| ohos.i18n | getSystemRegion(): string | Obtains the system region. |
+| ohos.i18n | getSystemLocale(): string | Obtains the system locale. |
+| ohos.i18n | isRTL(locale: string): boolean<sup>7+</sup> | Checks whether the locale uses a right-to-left (RTL) language. |
+| ohos.i18n | is24HourClock(): boolean<sup>7+</sup> | Checks whether the system uses a 24-hour clock. |
+| ohos.i18n | getDisplayLanguage(language: string, locale: string, sentenceCase?: boolean): string | Obtains the localized display of a language. |
+| ohos.i18n | getDisplayCountry(country: string, locale: string, sentenceCase?: boolean): string | Obtains the localized display of a country name. |
 
 
 ### How to Develop
@@ -26,7 +26,7 @@ You can use APIs provided in the following table to obtain the system language a
 
     Call the **getSystemLanguage** method to obtain the system language (**i18n** is the name of the imported module).
 
-   
+
     ```js
    var language = i18n.getSystemLanguage();
    ```
@@ -42,7 +42,7 @@ You can use APIs provided in the following table to obtain the system language a
 3. Obtain the system locale.
 
     Call the **getSystemLocale** method to obtain the system locale.
-     
+    
     ```js
    var locale = i18n.getSystemLocale();
    ```
@@ -51,7 +51,7 @@ You can use APIs provided in the following table to obtain the system language a
 
     Call the **isRTL** method to check whether the locale's language is RTL.
 
-   
+
     ```js
    var rtl = i18n.isRTL("zh-CN");
    ```
@@ -67,7 +67,7 @@ You can use APIs provided in the following table to obtain the system language a
 6. Obtain the localized display of a language.
 
     Call the **getDisplayLanguage** method to obtain the localized display of a language. **language** indicates the language to be localized, **locale** indicates the locale, and **sentenceCase** indicates whether the first letter of the result must be capitalized.
-     
+    
     ```js
    var language = "en";
    var locale = "zh-CN";
@@ -78,7 +78,7 @@ You can use APIs provided in the following table to obtain the system language a
 7. Obtain the localized display of a country.
 
     Call the **getDisplayCountry** method to obtain the localized display of a country name. **country** indicates the country code (a two-letter code in compliance with ISO-3166, for example, CN), **locale** indicates the locale, and **sentenceCase** indicates whether the first letter of the result must be capitalized.
-     
+    
     ```js
    var country = "US";
    var locale = "zh-CN";
@@ -116,7 +116,7 @@ You can use APIs provided in the following table to obtain the system language a
 
     Call the **getCalendar** method to obtain the time zone object of a specific locale and type (**i18n** is the name of the imported module). **type** indicates the valid calendar type, for example, **buddhist**, **chinese**, **coptic**, **ethiopic**, **hebrew**, **gregory**, **indian**, **islamic_civil**, **islamic_tbla**, **islamic_umalqura**, **japanese**, and **persian**. If **type** is left unspecified, the default calendar type of the locale is used.
 
-   
+
     ```js
    var calendar = i18n.getCalendar("zh-CN", "gregory");
    ```
@@ -135,7 +135,7 @@ You can use APIs provided in the following table to obtain the system language a
 3. Set the year, month, day, hour, minute, and second for the **Calendar** object.
 
     Call the **set** method to set the year, month, day, hour, minute, and second for the **Calendar** object.
-     
+    
     ```js
    calendar.set(2021, 12, 21, 6, 0, 0)
    ```
@@ -144,7 +144,7 @@ You can use APIs provided in the following table to obtain the system language a
 
     Call the **setTimeZone** and **getTimeZone** methods to set and obtain the time zone for the **Calendar** object. The **setTimeZone** method requires an input string to indicate the time zone to be set.
 
-   
+
     ```js
    calendar.setTimeZone("Asia/Shanghai");
    var timezone = calendar.getTimeZone();
@@ -163,7 +163,7 @@ You can use APIs provided in the following table to obtain the system language a
 6. Set and obtain the minimum count of days in the first week for the **Calendar** object.
 
     Call the **setMinimalDaysInFirstWeek** and **getMinimalDaysInFirstWeek** methods to set and obtain the minimum count of days in the first week for the **Calendar** object.
-     
+    
     ```js
    calendar.setMinimalDaysInFirstWeek(3);
    var minimalDaysInFirstWeek = calendar.getMinimalDaysInFirstWeek();
@@ -173,7 +173,7 @@ You can use APIs provided in the following table to obtain the system language a
 
     Call the **getDisplayName** method to obtain the localized display of the **Calendar** object.
 
-   
+
     ```js
    var localizedName = calendar.getDisplayName("zh-CN");
    ```
@@ -196,11 +196,11 @@ You can use APIs provided in the following table to obtain the system language a
 
 ### Available APIs
 
-| Module | API | Description | 
+| Module | API | Description |
 | -------- | -------- | -------- |
-| ohos.i18n | constructor(country: string, options?: PhoneNumberFormatOptions)<sup>8+</sup> | Instantiates a **PhoneNumberFormat** object. | 
-| ohos.i18n | isValidNumber(number: string): boolean<sup>8+</sup> | Checks whether the value of **number** is a phone number in the correct format. | 
-| ohos.i18n | format(number: string): string<sup>8+</sup> | Formats the value of **number** based on the specified country and style. | 
+| ohos.i18n | constructor(country: string, options?: PhoneNumberFormatOptions)<sup>8+</sup> | Instantiates a **PhoneNumberFormat** object. |
+| ohos.i18n | isValidNumber(number: string): boolean<sup>8+</sup> | Checks whether the value of **number** is a phone number in the correct format. |
+| ohos.i18n | format(number: string): string<sup>8+</sup> | Formats the value of **number** based on the specified country and style. |
 
 
 ### How to Develop
@@ -209,7 +209,7 @@ You can use APIs provided in the following table to obtain the system language a
 
     Call the **PhoneNumberFormat** constructor to instantiate a **PhoneNumberFormat** object. The country code and formatting options of the phone number need to be passed into this constructor. The formatting options are optional, including a style option. Values of this option include: **E164**, **INTERNATIONAL**, **NATIONAL**, and **RFC3966**.
 
-   
+
     ```js
    var phoneNumberFormat = new i18n.PhoneNumberFormat("CN", {type: "E164"});
    ```
@@ -223,7 +223,7 @@ You can use APIs provided in the following table to obtain the system language a
 
 3. Format a phone number.
     Call the **format** method of **PhoneNumberFormat** to format the input phone number.
-     
+    
     ```js
    var formattedNumber = phoneNumberFormat.format("15812341234");
    ```
@@ -236,15 +236,15 @@ The **unitConvert** API is provided to help you implement measurement conversion
 
 ### Available APIs
 
-| Module | API | Description | 
+| Module | API | Description |
 | -------- | -------- | -------- |
-| ohos.i18n | unitConvert(fromUnit: UnitInfo, toUnit: UnitInfo, value: number, locale: string, style?: string): string<sup>8+</sup> | Converts one measurement unit (**fromUnit**) into another (**toUnit**) and formats the unit based on the specified locale and style. | 
+| ohos.i18n | unitConvert(fromUnit: UnitInfo, toUnit: UnitInfo, value: number, locale: string, style?: string): string<sup>8+</sup> | Converts one measurement unit (**fromUnit**) into another (**toUnit**) and formats the unit based on the specified locale and style. |
 
 
 ### How to Develop
 
 1. Convert a measurement unit.
-   Call the [unitConvert](../reference/apis/js-apis-i18n.md#unitconvert8) method to convert a measurement unit and format the display result.
+   Call the [unitConvert](../reference/apis/js-apis-i18n.md#unitconvert9) method to convert a measurement unit and format the display result.
 
    
     ```js
@@ -254,7 +254,7 @@ The **unitConvert** API is provided to help you implement measurement conversion
    var locale = "en-US";
    var style = "long";
    i18n.Util.unitConvert(fromUtil, toUtil, number, locale, style);
-   ```
+    ```
 
 
 ## Alphabet Index
@@ -278,7 +278,7 @@ The **unitConvert** API is provided to help you implement measurement conversion
 
     Call the **getInstance** method to instantiate an **IndexUtil** object for a specific locale. When the **locale** parameter is empty, instantiate an **IndexUtil** object of the default locale.
 
-   
+
     ```js
    var indexUtil = i18n.getInstance("zh-CN");
    ```
@@ -294,7 +294,7 @@ The **unitConvert** API is provided to help you implement measurement conversion
 3. Add an index.
 
     Call the **addLocale** method to add the alphabet index of a new locale to the current index list.
-     
+    
     ```js
    indexUtil.addLocale("ar")
    ```
@@ -302,7 +302,7 @@ The **unitConvert** API is provided to help you implement measurement conversion
 4. Obtain the index of a string.
 
     Call the **getIndex** method to obtain the alphabet index of a string.
-     
+    
     ```js
    var text = "access index";
    indexUtil.getIndex(text);
@@ -336,7 +336,7 @@ When a text is displayed in more than one line, [BreakIterator8](../reference/ap
 
     Call the **getLineInstance** method to instantiate a **BreakIterator** object.
 
-   
+
     ```js
    var locale = "en-US"
    var breakIterator = i18n.getLineInstance(locale);
@@ -357,7 +357,7 @@ When a text is displayed in more than one line, [BreakIterator8](../reference/ap
 
     Call the **current** method to obtain the current position of the **BreakIterator** object in the text being processed.
 
-   
+
     ```js
    var pos = breakIterator.current();
    ```
@@ -383,7 +383,9 @@ When a text is displayed in more than one line, [BreakIterator8](../reference/ap
 
     Call the **isBoundary** method to determine whether a position is a break point. If yes, **true** is returned and the **BreakIterator** object is moved to this position. If no, **false** is returned and the **BreakIterator** object is moved to a break point after this position.
 
-   
+
     ```js
    var isboundary = breakIterator.isBoundary(5);
    ```
+
+   ```
\ No newline at end of file

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

@@ -13,13 +13,13 @@ Use [Locale](../reference/apis/js-apis-intl.md#locale) APIs to maximize or minim
 
 ### Available APIs
 
-| Module | API | Description | 
+| Module | API | Description |
 | -------- | -------- | -------- |
-| ohos.intl | constructor()<sup>8+</sup> | Instantiates a **Locale** object. | 
-| ohos.intl | constructor(locale?: string, options?: options) | Instantiates a **Locale** object based on the locale parameter and options. | 
-| ohos.intl | toString(): string | Converts locale information into a string. | 
-| ohos.intl | maximize(): Locale | Maximizes locale information. | 
-| ohos.intl | minimize(): Locale | Minimizes locale information. | 
+| ohos.intl | constructor()<sup>8+</sup> | Instantiates a **Locale** object. |
+| ohos.intl | constructor(locale?: string, options?: options) | Instantiates a **Locale** object based on the locale parameter and options. |
+| ohos.intl | toString(): string | Converts locale information into a string. |
+| ohos.intl | maximize(): Locale | Maximizes locale information. |
+| ohos.intl | minimize(): Locale | Minimizes locale information. |
 
 
 ### How to Develop
@@ -81,13 +81,13 @@ Use [DateTimeFormat](../reference/apis/js-apis-intl.md#datetimeformat) APIs to f
 
 ### Available APIs
 
-| Module | API | Description | 
+| Module | API | Description |
 | -------- | -------- | -------- |
-| ohos.intl | constructor()<sup>8+</sup> | Creates a **DateTimeFormat** object. | 
-| ohos.intl | constructor(locale: string \| Array&lt;string&gt;, options?: DateTimeOptions) | Creates a **DateTimeFormat** object and sets the locale and other formatting-related attributes. | 
-| ohos.intl | format(date: Date): string | Calculates the date and time based on the locale and other formatting-related attributes of the **DateTimeFormat** object. | 
-| ohos.intl | formatRange(startDate: Date, endDate: Date): string | Calculates the period based on the locale and other formatting-related attributes of the **DateTimeFormat** object. | 
-| ohos.intl | resolvedOptions(): DateTimeOptions | Obtains the related attributes of the **DateTimeFormat** object. | 
+| ohos.intl | constructor()<sup>8+</sup> | Creates a **DateTimeFormat** object. |
+| ohos.intl | constructor(locale: string \| Array&lt;string&gt;, options?: DateTimeOptions) | Creates a **DateTimeFormat** object and sets the locale and other formatting-related attributes. |
+| ohos.intl | format(date: Date): string | Calculates the date and time based on the locale and other formatting-related attributes of the **DateTimeFormat** object. |
+| ohos.intl | formatRange(startDate: Date, endDate: Date): string | Calculates the period based on the locale and other formatting-related attributes of the **DateTimeFormat** object. |
+| ohos.intl | resolvedOptions(): DateTimeOptions | Obtains the related attributes of the **DateTimeFormat** object. |
 
 
 ### How to Develop
@@ -144,12 +144,12 @@ Use [NumberFormat](../reference/apis/js-apis-intl.md#numberformat) APIs to forma
 
 ### Available APIs
 
-| Module | API | Description | 
+| Module | API | Description |
 | -------- | -------- | -------- |
-| ohos.intl | constructor()<sup>8+</sup> | Creates a **NumberFormat** object. | 
-| ohos.intl | constructor(locale: string \| Array&lt;string&gt;, options?: NumberOptions) | Creates a **NumberFormat** object and sets the locale and other formatting-related attributes. | 
-| ohos.intl | format(number: number): string | Calculates the number based on the locale and other formatting-related attributes of the **NumberFormat** object. | 
-| ohos.intl | resolvedOptions(): NumberOptions | Obtains attributes of the **NumberFormat** object. | 
+| ohos.intl | constructor()<sup>8+</sup> | Creates a **NumberFormat** object. |
+| ohos.intl | constructor(locale: string \| Array&lt;string&gt;, options?: NumberOptions) | Creates a **NumberFormat** object and sets the locale and other formatting-related attributes. |
+| ohos.intl | format(number: number): string | Calculates the number based on the locale and other formatting-related attributes of the **NumberFormat** object. |
+| ohos.intl | resolvedOptions(): NumberOptions | Obtains attributes of the **NumberFormat** object. |
 
 
 ### How to Develop
@@ -195,12 +195,12 @@ Use [Collator](../reference/apis/js-apis-intl.md#collator8) APIs to sort strings
 
 ### Available APIs
 
-| Module | API | Description | 
+| Module | API | Description |
 | -------- | -------- | -------- |
-| ohos.intl | constructor()<sup>8+</sup> | Creates a **Collator** object. | 
-| ohos.intl | constructor(locale: string \| Array&lt;string&gt;, options?: CollatorOptions)<sup>8+</sup> | Creates a **Collator** object and sets the locale and other related attributes. | 
-| ohos.intl | compare(first: string, second: string): number<sup>8+</sup> | Calculates the comparison result of two strings based on the locale and other attributes of the **Collator** object. | 
-| ohos.intl | resolvedOptions(): CollatorOptions<sup>8+</sup> | Obtains attributes of the **Collator** object. | 
+| ohos.intl | constructor()<sup>8+</sup> | Creates a **Collator** object. |
+| ohos.intl | constructor(locale: string \| Array&lt;string&gt;, options?: CollatorOptions)<sup>8+</sup> | Creates a **Collator** object and sets the locale and other related attributes. |
+| ohos.intl | compare(first: string, second: string): number<sup>8+</sup> | Calculates the comparison result of two strings based on the locale and other attributes of the **Collator** object. |
+| ohos.intl | resolvedOptions(): CollatorOptions<sup>8+</sup> | Obtains attributes of the **Collator** object. |
 
 
 ### How to Develop
@@ -214,7 +214,7 @@ Use [Collator](../reference/apis/js-apis-intl.md#collator8) APIs to sort strings
    var collator = new intl.Collator();
    ```
 
-   Alternatively, use your own locale and formatting parameters to create a **Collator** object. For a full list of parameters, see [CollatorOptions](../reference/apis/js-apis-intl.md#collatoroptions8).
+   Alternatively, use your own locale and formatting parameters to create a **Collator** object. For a full list of parameters, see [CollatorOptions](../reference/apis/js-apis-intl.md#collatoroptions9).
    
    ```js
    var collator= new intl.Collator("zh-CN", {localeMatcher: "best fit", usage: "sort"});
@@ -246,11 +246,11 @@ Use [PluralRules](../reference/apis/js-apis-intl.md#pluralrules8) APIs to determ
 
 ### Available APIs
 
-| Module | API | Description | 
+| Module | API | Description |
 | -------- | -------- | -------- |
-| ohos.intl | constructor()<sup>8+</sup> | Creates a **PluralRules** object. | 
-| ohos.intl | constructor(locale: string \| Array&lt;string&gt;, options?: PluralRulesOptions)<sup>8+</sup> | Creates a **PluralRules** object and sets the locale and other related attributes. | 
-| ohos.intl | select(n: number): string<sup>8+</sup> | Determines the singular-plural type based on the locale and other formatting-related attributes of the **PluralRules** object. | 
+| ohos.intl | constructor()<sup>8+</sup> | Creates a **PluralRules** object. |
+| ohos.intl | constructor(locale: string \| Array&lt;string&gt;, options?: PluralRulesOptions)<sup>8+</sup> | Creates a **PluralRules** object and sets the locale and other related attributes. |
+| ohos.intl | select(n: number): string<sup>8+</sup> | Determines the singular-plural type based on the locale and other formatting-related attributes of the **PluralRules** object. |
 
 
 ### How to Develop
@@ -264,7 +264,7 @@ Use [PluralRules](../reference/apis/js-apis-intl.md#pluralrules8) APIs to determ
    var pluralRules = new intl.PluralRules();
    ```
 
-   Alternatively, use your own locale and formatting parameters to create a **PluralRules** object. For a full list of parameters, see [PluralRulesOptions](../reference/apis/js-apis-intl.md#pluralrulesoptions8).
+   Alternatively, use your own locale and formatting parameters to create a **PluralRules** object. For a full list of parameters, see [PluralRulesOptions](../reference/apis/js-apis-intl.md#pluralrulesoptions9).
    
    ```js
    var pluralRules = new intl.PluralRules("zh-CN", {localeMatcher: "best fit", type: "cardinal"});
@@ -287,13 +287,13 @@ Use [RelativeTimeFormat](../reference/apis/js-apis-intl.md#relativetimeformat8)
 
 ### Available APIs
 
-| Module | API | Description | 
+| Module | API | Description |
 | -------- | -------- | -------- |
-| ohos.intl | constructor()<sup>8+</sup> | Creates a **RelativeTimeFormat** object. | 
-| ohos.intl | constructor(locale: string \| Array&lt;string&gt;, options?: RelativeTimeFormatInputOptions)<sup>8+</sup> | Creates a **RelativeTimeFormat** object and sets the locale and other formatting-related attributes. | 
-| ohos.intl | format(value: number, unit: string): string<sup>8+</sup> | Calculates the relative time format based on the locale and other formatting-related attributes of the **RelativeTimeFormat** object. | 
-| ohos.intl | formatToParts(value: number, unit: string): Array&lt;object&gt;<sup>8+</sup> | Returns each part of the relative time format based on the locale and other formatting-related attributes of the **RelativeTimeFormat** object. | 
-| ohos.intl | resolvedOptions(): RelativeTimeFormatResolvedOptions<sup>8+</sup> | Obtains attributes of the **RelativeTimeFormat** object. | 
+| ohos.intl | constructor()<sup>8+</sup> | Creates a **RelativeTimeFormat** object. |
+| ohos.intl | constructor(locale: string \| Array&lt;string&gt;, options?: RelativeTimeFormatInputOptions)<sup>8+</sup> | Creates a **RelativeTimeFormat** object and sets the locale and other formatting-related attributes. |
+| ohos.intl | format(value: number, unit: string): string<sup>8+</sup> | Calculates the relative time format based on the locale and other formatting-related attributes of the **RelativeTimeFormat** object. |
+| ohos.intl | formatToParts(value: number, unit: string): Array&lt;object&gt;<sup>8+</sup> | Returns each part of the relative time format based on the locale and other formatting-related attributes of the **RelativeTimeFormat** object. |
+| ohos.intl | resolvedOptions(): RelativeTimeFormatResolvedOptions<sup>8+</sup> | Obtains attributes of the **RelativeTimeFormat** object. |
 
 
 ### How to Develop
@@ -307,7 +307,7 @@ Use [RelativeTimeFormat](../reference/apis/js-apis-intl.md#relativetimeformat8)
    var relativeTimeFormat = new intl.RelativeTimeFormat();
    ```
 
-   Alternatively, use your own locale and formatting parameters to create a **RelativeTimeFormat** object. Formatting parameters are optional. For a full list of formatting parameters, see [RelativeTimeFormatInputOptions](../reference/apis/js-apis-intl.md#relativetimeformatinputoptions8).
+   Alternatively, use your own locale and formatting parameters to create a **RelativeTimeFormat** object. Formatting parameters are optional. For a full list of formatting parameters, see [RelativeTimeFormatInputOptions](../reference/apis/js-apis-intl.md#relativetimeformatinputoptions9).
    
    ```js
    var relativeTimeFormat = new intl.RelativeTimeFormat("zh-CN", {numeric: "always", style: "long"});

en/application-dev/media/image.md

@@ -21,45 +21,43 @@ let opts = { alphaType: 0, editable: true, pixelFormat: 4, scaleMode: 1, size: {
 // Create a PixelMap object.
 const color = new ArrayBuffer(96);
 let opts = { alphaType: 0, editable: true, pixelFormat: 4, scaleMode: 1, size: { height: 2, width: 3 } }
-        image.createPixelMap(color, opts, pixelmap => {
-            expect(pixelmap !== null).assertTrue();
-            console.info('TC_001-1 success');
-            done();
-        })
+image.createPixelMap(color, opts, pixelmap => {
+    console.log('Succeeded in creating pixelmap.');
+})
+
 // Read pixels.
 pixelmap.readPixels(area,(data) => {
- 	if(data !== null) {
-		var bufferArr = new Uint8Array(area.pixels);
+    if(data !== null) {
+        var bufferArr = new Uint8Array(area.pixels);
         var res = true;
         for (var i = 0; i < bufferArr.length; i++) {
-			console.info('TC_021-1 buffer ' + bufferArr[i]);
-				if(res) {
-					if(bufferArr[i] == 0) {
-						res = false;
-                        console.info('TC_021-1 Success');
-                        expect(true).assertTrue();
-                        done();
-                        break;
-                        }
-                    }
+            console.info(' buffer ' + bufferArr[i]);
+            if(res) {
+                if(bufferArr[i] == 0) {
+                    res = false;
+                    console.log('readPixels end.');
+                    break;
                 }
+            }
+        }
+    }
+})
  
 // Store pixels.
 const readBuffer = new ArrayBuffer(96);
 pixelmap.readPixelsToBuffer(readBuffer,() => {
-var bufferArr = new Uint8Array(readBuffer);
-var res = true;
-for (var i = 0; i < bufferArr.length; i++) {
-    if(res) {
-        if (bufferArr[i] !== 0) {
-            res = false;
-            console.info('TC_020-1 Success');
-            expect(true).assertTrue();
-            done();
-            break;
+    var bufferArr = new Uint8Array(readBuffer);
+    var res = true;
+    for (var i = 0; i < bufferArr.length; i++) {
+        if(res) {
+            if (bufferArr[i] !== 0) {
+                res = false;
+                console.log('readPixelsToBuffer end.');
+                break;
+            }
         }
     }
-}
+})
     
 // Write pixels.
 pixelmap.writePixels(area,() => {
@@ -71,56 +69,51 @@ pixelmap.writePixels(area,() => {
             if(res) {
                 if (readArr[i] !== 0) {
                     res = false;
-                    console.info('TC_022-1 Success');
-                    expect(true).assertTrue();
-                    done();
+                    console.log('readPixels end.please check buffer');
                     break;
                 }
             }
         }
+    })
+})
   
 // Write pixels to the buffer.
 pixelmap.writeBufferToPixels(writeColor).then(() => {
     const readBuffer = new ArrayBuffer(96);
     pixelmap.readPixelsToBuffer(readBuffer).then (() => {
-    	var bufferArr = new Uint8Array(readBuffer);
-     	var res = true;
-     	for (var i = 0; i < bufferArr.length; i++) {
-     		if(res) {
-     			if (bufferArr[i] !== i) {
-     				res = false;
-                    console.info('TC_023 Success');
-                    expect(true).assertTrue()
-                    done();
+        var bufferArr = new Uint8Array(readBuffer);
+        var res = true;
+        for (var i = 0; i < bufferArr.length; i++) {
+            if(res) {
+                if (bufferArr[i] !== i) {
+                    res = false;
+                    console.log('readPixels end.please check buffer');
                     break;
                 }
             }
         }
+    })
+})
 
 // Obtain image information.
 pixelmap.getImageInfo( imageInfo => {
     if (imageInfo !== null) {
-        console.info('TC_024-1 imageInfo is ready');
-        expect(imageInfo.size.height == 4).assertTrue();
-        expect(imageInfo.size.width == 6).assertTrue();
-        expect(imageInfo.pixelFormat == 4).assertTrue();
-        done();
+	    console.log('Succeeded in getting imageInfo');
     } 
 })
 
 // Release the PixelMap object.
 pixelmap.release(()=>{
-    expect(true).assertTrue();
-    console.log('TC_027-1 suc');
-    done();
+    console.log('Succeeded in releasing pixelmap');
 })
 
-let path = '/data/local/tmp/test.jpg';
 // Create an image source (uri).
-const imageSourceApi = image.createImageSource(path); // '/data/local/tmp/test.jpg'
+let path = '/data/local/tmp/test.jpg';
+const imageSourceApi = image.createImageSource(path);
 
 // Create an image source (fd).
-const imageSourceApi = image.createImageSource(29);
+let fd = 29;
+const imageSourceApi = image.createImageSource(fd);
 
 // Create an image source (data).
 const data = new ArrayBuffer(96);
@@ -128,15 +121,15 @@ const imageSourceApi = image.createImageSource(data);
 
 // Release the image source.
 imageSourceApi.release(() => {
-    console.info('TC_044-1 Success');
-    })
+    console.log('Succeeded in releasing imagesource');
+})
     
 // Encode the image.
 const imagePackerApi = image.createImagePacker();
+const imageSourceApi = image.createImageSource(0);
+let packOpts = { format:"image/jpeg", quality:98 };
 imagePackerApi.packing(imageSourceApi, packOpts, data => {
-    console.info('TC_062-1 finished');
-    expect(data !== null).assertTrue();
-    done();
+    console.log('Succeeded in packing');
 })
  
 // Release the ImagePacker object.
@@ -164,59 +157,40 @@ let decodingOptions = {
     
 // Create a pixel map in callback mode.
 imageSourceApi.createPixelMap(decodingOptions, pixelmap => {
-    console.info('TC_050 createPixelMap ');
-    expect(pixelmap !== null ).assertTrue();
-    done();
-    })
-}  
+    console.log('Succeeded in creating pixelmap.');
+})
 
 // Create a pixel map in promise mode.
 imageSourceApi.createPixelMap().then(pixelmap => {
-    console.info('TC_050-11 createPixelMap ');
-    expect(pixelmap !== null ).assertTrue();
-    done();
+    console.log('Succeeded in creating pixelmap.');
 })
 
 // Capture error information when an exception occurs during function invoking.
 catch(error => {
-    console.log('TC_050-11 error: ' + error);
-    expect().assertFail();
-    done();
+    console.log('Failed in creating pixelmap.' + error);
 })
 
 // Obtain the number of bytes in each line of pixels.
 pixelmap.getBytesNumberPerRow( num => {
-	console.info('TC_025-1 num is ' + num);
-	expect(num == expectNum).assertTrue();
-	done();
+    console.log('Succeeded in getting BytesNumber PerRow.');
 })
 
 // Obtain the total number of pixel bytes.
 pixelmap.getPixelBytesNumber(num => {
-    console.info('TC_026-1 num is ' + num);
-    expect(num == expectNum).assertTrue();
-    done();
+    console.log('Succeeded in getting PixelBytesNumber.');
 })
 
 // Obtain the pixel map information.
 pixelmap.getImageInfo( imageInfo => {})
- 
-// Print the failure information.
-console.info('TC_024-1 imageInfo is empty');
-expect(false).assertTrue()
 
 // Release the PixelMap object.
 pixelmap.release(()=>{
-    expect(true).assertTrue();
-    console.log('TC_027-1 suc');
-    done();
+    console.log('Succeeded in releasing pixelmap');
 })    
 
 // Capture release failure information.
 catch(error => {
-    console.log('TC_027-1 error: ' + error);
-    expect().assertFail();
-    done();
+    console.log('Failed in releasing pixelmap.' + error);
 })
 ```
 
@@ -230,9 +204,7 @@ const imageSourceApi = image.createImageSource(path); // '/data/local/tmp/test.p
  
 // Print the error message if the image source fails to be created.
 if (imageSourceApi == null) {
-    console.info('TC_062 create image source failed');
-    expect(false).assertTrue();
-    done();
+    console.log('Failed in creating imageSource.');
 }
    
 // Create an image packer if the image source is successfully created.
@@ -240,9 +212,7 @@ const imagePackerApi = image.createImagePacker();
 
 // Print the error information if the image packer fails to be created.
 if (imagePackerApi == null) {
-    console.info('TC_062 create image packer failed');
-    expect(false).assertTrue();
-    done();
+    console.log('Failed in creating imagePacker.');
 }
 
 // Set encoding parameters if the image packer is successfully created.
@@ -252,19 +222,15 @@ let packOpts = { format:["image/jpeg"], // The supported encoding format is jpg.
 // Encode the image.
 imagePackerApi.packing(imageSourceApi, packOpts)
 .then( data => {
-    console.info('TC_062 finished');
-    expect(data !== null).assertTrue();
-    done();
+    console.log('Succeeded in packing');
 })
-             
+         
 // Release the image packer after the encoding is complete.
 imagePackerApi.release();
 
 // Obtain the image source information.
 imageSourceApi.getImageInfo(imageInfo => {
-    console.info('TC_045 imageInfo');
-    expect(imageInfo !== null).assertTrue();
-    done();
+    console.log('Succeeded in getting imageInfo');
 })
 
 // Update incremental data.

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

@@ -4,5 +4,6 @@
 - [Drawing Development](drawing-guidelines.md)
 - [Raw File Development](rawfile-guidelines.md)
 - [Native Window Development](native-window-guidelines.md)
+- [Using MindSpore Lite for Model Inference](native-window-guidelines.md)
 
 

en/application-dev/napi/mindspore-lite-guidelines.md

+# Using MindSpore Lite for Model Inference
+
+## When to Use
+
+MindSpore Lite is an AI engine that provides AI model inference for different hardware devices. It has been used in a wide range of fields, such as image classification, target recognition, facial recognition, and character recognition.
+
+This document describes the general development process for MindSpore Lite model inference.
+
+## Basic Concepts
+
+Before getting started, you need to understand the following basic concepts:
+
+**Tensor**: a special data structure that is similar to arrays and matrices. It is a basic data structure used in MindSpore Lite network operations.
+
+**Float16 inference**: a mode in which Float16 is used for inference. Float16, also called half-precision, uses 16 bits to represent a number. 
+
+
+
+## Available APIs
+APIs involved in MindSpore Lite model inference are categorized into context APIs, model APIs, and tensor APIs.
+### Context APIs
+
+| API       | Description       |
+| ------------------ | ----------------- |
+|OH_AI_ContextHandle OH_AI_ContextCreate()|Creates a context object.|
+|void OH_AI_ContextSetThreadNum(OH_AI_ContextHandle context, int32_t thread_num)|Sets the number of runtime threads.|
+| void OH_AI_ContextSetThreadAffinityMode(OH_AI_ContextHandle context, int mode)|Sets the affinity mode for binding runtime threads to CPU cores, which are categorized into little cores and big cores depending on the CPU frequency.|
+|OH_AI_DeviceInfoHandle OH_AI_DeviceInfoCreate(OH_AI_DeviceType device_type)|Creates a runtime device information object.|
+|void OH_AI_ContextDestroy(OH_AI_ContextHandle *context)|Destroys a context object.|
+|void OH_AI_DeviceInfoSetEnableFP16(OH_AI_DeviceInfoHandle device_info, bool is_fp16)|Sets whether to enable float16 inference. This function is available only for CPU and GPU devices.|
+|void OH_AI_ContextAddDeviceInfo(OH_AI_ContextHandle context, OH_AI_DeviceInfoHandle device_info)|Adds a runtime device information object.|
+
+### Model APIs
+
+| API       | Description       |
+| ------------------ | ----------------- |
+|OH_AI_ModelHandle OH_AI_ModelCreate()|Creates a model object.|
+|OH_AI_Status OH_AI_ModelBuildFromFile(OH_AI_ModelHandle model, const char *model_path,OH_AI_ModelType odel_type, const OH_AI_ContextHandle model_context)|Loads and builds a MindSpore model from a model file.|
+|void OH_AI_ModelDestroy(OH_AI_ModelHandle *model)|Destroys a model object.|
+
+### Tensor APIs
+
+| API       | Description       |
+| ------------------ | ----------------- |
+|OH_AI_TensorHandleArray OH_AI_ModelGetInputs(const OH_AI_ModelHandle model)|Obtains the input tensor array structure of a model.|
+|int64_t OH_AI_TensorGetElementNum(const OH_AI_TensorHandle tensor)|Obtains the number of tensor elements.|
+|const char *OH_AI_TensorGetName(const OH_AI_TensorHandle tensor)|Obtains the name of a tensor.|
+|OH_AI_DataType OH_AI_TensorGetDataType(const OH_AI_TensorHandle tensor)|Obtains the tensor data type.|
+|void *OH_AI_TensorGetMutableData(const OH_AI_TensorHandle tensor)|Obtains the pointer to variable tensor data.|
+
+## How to Develop
+The following figure shows the development process for MindSpore Lite model inference.
+
+**Figure 1** Development process for MindSpore Lite model inference
+![how-to-use-mindspore-lite](figures/01.png)
+
+The development process consists of the following main steps:
+
+1. Prepare the required model.
+
+    The required model can be downloaded directly or obtained using the model conversion tool.
+  
+     - If the downloaded model is in the `.ms` format, you can use it directly for inference. The following uses the **mobilenetv2.ms** model as an example.
+     - If the downloaded model uses a third-party framework, such as TensorFlow, TensorFlow Lite, Caffe, or ONNX, you can use the [model conversion tool](https://www.mindspore.cn/lite/docs/en/r1.5/use/benchmark_tool.html) to convert it to the `.ms` format.
+
+2. Create a context, and set parameters such as the number of runtime threads and device type.
+  
+    ```c
+    // Create a context, and set the number of runtime threads to 2 and the thread affinity mode to 1 (big cores first).
+    OH_AI_ContextHandle context = OH_AI_ContextCreate();
+    if (context == NULL) {
+      printf("OH_AI_ContextCreate failed.\n");
+      return OH_AI_STATUS_LITE_ERROR;
+    }
+    const int thread_num = 2;
+    OH_AI_ContextSetThreadNum(context, thread_num);
+    OH_AI_ContextSetThreadAffinityMode(context, 1);
+    // Set the device type to CPU, and disable Float16 inference.
+    OH_AI_DeviceInfoHandle cpu_device_info = OH_AI_DeviceInfoCreate(OH_AI_DEVICETYPE_CPU);
+    if (cpu_device_info == NULL) {
+      printf("OH_AI_DeviceInfoCreate failed.\n");
+      OH_AI_ContextDestroy(&context);
+      return OH_AI_STATUS_LITE_ERROR;
+    }
+    OH_AI_DeviceInfoSetEnableFP16(cpu_device_info, false);
+    OH_AI_ContextAddDeviceInfo(context, cpu_device_info);
+    ```
+
+3. Create, load, and build the model.
+
+    Call **OH_AI_ModelBuildFromFile** to load and build the model.
+
+    In this example, the **argv[1]** parameter passed to **OH_AI_ModelBuildFromFile** indicates the specified model file path.
+
+    ```c
+    // Create a model.
+    OH_AI_ModelHandle model = OH_AI_ModelCreate();
+    if (model == NULL) {
+      printf("OH_AI_ModelCreate failed.\n");
+      OH_AI_ContextDestroy(&context);
+      return OH_AI_STATUS_LITE_ERROR;
+    }
+
+    // Load and build the model. The model type is OH_AI_ModelTypeMindIR.
+    int ret = OH_AI_ModelBuildFromFile(model, argv[1], OH_AI_ModelTypeMindIR, context);
+    if (ret != OH_AI_STATUS_SUCCESS) {
+      printf("OH_AI_ModelBuildFromFile failed, ret: %d.\n", ret);
+      OH_AI_ModelDestroy(&model);
+      return ret;
+    }
+    ```
+
+4. Input data.
+ 
+    Before executing model inference, you need to populate data to the input tensor. In this example, random data is used to populate the model.
+
+    ```c
+    // Obtain the input tensor.
+    OH_AI_TensorHandleArray inputs = OH_AI_ModelGetInputs(model);
+    if (inputs.handle_list == NULL) {
+      printf("OH_AI_ModelGetInputs failed, ret: %d.\n", ret);
+      OH_AI_ModelDestroy(&model);
+      return ret;
+    }
+    // Use random data to populate the tensor.
+    ret = GenerateInputDataWithRandom(inputs);
+    if (ret != OH_AI_STATUS_SUCCESS) {
+      printf("GenerateInputDataWithRandom failed, ret: %d.\n", ret);
+      OH_AI_ModelDestroy(&model);
+      return ret;
+    }
+   ```
+
+5. Execute model inference.
+
+    Call **OH_AI_ModelPredict** to perform model inference.
+
+    ```c
+    // Execute model inference.
+    OH_AI_TensorHandleArray outputs;
+    ret = OH_AI_ModelPredict(model, inputs, &outputs, NULL, NULL);
+    if (ret != OH_AI_STATUS_SUCCESS) {
+      printf("OH_AI_ModelPredict failed, ret: %d.\n", ret);
+      OH_AI_ModelDestroy(&model);
+      return ret;
+    }
+    ```
+
+6. Obtain the output.
+
+    After model inference is complete, you can obtain the inference result through the output tensor.
+
+    ```c
+    // Obtain the output tensor and print the information.
+    for (size_t i = 0; i < outputs.handle_num; ++i) {
+      OH_AI_TensorHandle tensor = outputs.handle_list[i];
+      int64_t element_num = OH_AI_TensorGetElementNum(tensor);
+      printf("Tensor name: %s, tensor size is %zu ,elements num: %lld.\n", OH_AI_TensorGetName(tensor),
+            OH_AI_TensorGetDataSize(tensor), element_num);
+      const float *data = (const float *)OH_AI_TensorGetData(tensor);
+      printf("output data is:\n");
+      const int max_print_num = 50;
+      for (int j = 0; j < element_num && j <= max_print_num; ++j) {
+        printf("%f ", data[j]);
+      }
+      printf("\n");
+    }
+    ```
+
+7. Destroy the model.
+
+    If the MindSpore Lite inference framework is no longer needed, you need to destroy the created model.
+
+    ```c
+    // Destroy the model.
+    OH_AI_ModelDestroy(&model);
+    ```
+
+## Verification
+
+1. Compile **CMakeLists.txt**.
+
+    ```cmake
+    cmake_minimum_required(VERSION 3.14)
+    project(Demo)
+
+    add_executable(demo main.c)
+
+    target_link_libraries(
+            demo
+            mindspore-lite.huawei
+            pthread
+            dl
+    )
+    ```
+   - To use ohos-sdk for cross compilation, you need to set the native toolchain path for the CMake tool as follows: `-DCMAKE_TOOLCHAIN_FILE="/xxx/ohos-sdk/linux/native/build/cmake/ohos.toolchain.cmake"`.
+    
+   - The toolchain builds a 64-bit application by default. To build a 32-bit application, add the following configuration: `-DOHOS_ARCH="armeabi-v7a"`.
+
+2. Run the CMake tool.
+
+    - Use hdc_std to connect to the RK3568 development board and put **demo** and **mobilenetv2.ms** to the same directory on the board.
+    - Run the hdc_std shell command to access the development board, go to the directory where **demo** is located, and run the following command:
+
+    ```shell
+    ./demo mobilenetv2.ms
+    ```
+
+    The inference is successful if the output is similar to the following:
+
+    ```shell
+    # ./QuickStart ./mobilenetv2.ms                                            
+    Tensor name: Softmax-65, tensor size is 4004 ,elements num: 1001.
+    output data is:
+    0.000018 0.000012 0.000026 0.000194 0.000156 0.001501 0.000240 0.000825 0.000016 0.000006 0.000007 0.000004 0.000004 0.000004 0.000015 0.000099 0.000011 0.000013 0.000005 0.000023 0.000004 0.000008 0.000003 0.000003 0.000008 0.000014 0.000012 0.000006 0.000019 0.000006 0.000018 0.000024 0.000010 0.000002 0.000028 0.000372 0.000010 0.000017 0.000008 0.000004 0.000007 0.000010 0.000007 0.000012 0.000005 0.000015 0.000007 0.000040 0.000004 0.000085 0.000023 
+    ```

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

@@ -17,11 +17,11 @@ You can `import` the native .so that contains the JS processing logic. For examp
 
 ### .so Naming Rules
 
-Each module has a .so file. For example, if the module name is `hello`, name the .so file **libhello.so**. The `nm_modname` field in `napi_module` must be `hello`, which is the same as the module name. The sample code for importing the .so file is `import hello from 'libhello.so'`.
+Each module has a .so file. For example, if the module name is `hello`, name the .so file `libhello.so`. The `nm_modname` field in `napi_module` must be `hello`, which is the same as the module name. The sample code for importing the .so file is `import hello from 'libhello.so'`.
 
 ### JS Objects and Threads
 
-The Ark engine prevents NAPIs from being called to operate JS objects in non-JS threads. Otherwise, the application will crash.
+The Ark engine prevents NAPIs from being called to operate JS objects in non-JS threads. Otherwise, the application will crash. Observe the following rules:
 
 * The NAPIs can be used only in JS threads.
 * **env** is bound to a thread and cannot be used across threads. The JS object created by a NAPI can be used only in the thread, in which the object is created, that is, the JS object is bound to the **env** of the thread.
@@ -640,8 +640,3 @@ export default {
   }
 }
 ```
-## Samples
-The following samples are provided for native API development:
-- [`NativeAPI`: NativeAPI (eTS) (API8)](https://gitee.com/openharmony/app_samples/tree/master/Native/NativeAPI)
-- [First Native C++ Application (eTS) (API9)](https://gitee.com/openharmony/codelabs/tree/master/NativeAPI/NativeTemplateDemo)
-- [Native Component (eTS) (API9) ](https://gitee.com/openharmony/codelabs/tree/master/NativeAPI/XComponent)

en/application-dev/notification/background-agent-scheduled-reminder-guide.md

@@ -37,9 +37,7 @@ For details about the APIs, see [reminderAgent](../reference/apis/js-apis-remind
    import reminderAgent from '@ohos.reminderAgent';
    import notification from '@ohos.notification';
    export default {
-       // For a JS project:
-       // timer: {
-       // For an eTS project:
+       // eTS project:
        let timer : reminderAgent.ReminderRequestTimer = {
            reminderType: reminderAgent.ReminderType.REMINDER_TYPE_TIMER,
            triggerTimeInSeconds: 10,
@@ -69,9 +67,7 @@ For details about the APIs, see [reminderAgent](../reference/apis/js-apis-remind
    Sample code for defining a reminder agent for a calendar event:
 
     ```js
-    // For a JS project:
-    // calendar: {
-    // For an eTS project:
+    // eTS project:
     let calendar : reminderAgent.ReminderRequestCalendar = {
         reminderType: reminderAgent.ReminderType.REMINDER_TYPE_CALENDAR,
         dateTime: {
@@ -117,9 +113,7 @@ For details about the APIs, see [reminderAgent](../reference/apis/js-apis-remind
     Sample code for defining a reminder agent for an alarm:
 
     ```js
-    // For a JS project:
-    // alarm: {
-    // For an eTS project:
+    // eTS project:
     let alarm : reminderAgent.ReminderRequestAlarm = {
         reminderType: reminderAgent.ReminderType.REMINDER_TYPE_ALARM,
         hour: 11,
@@ -171,4 +165,3 @@ For details about the APIs, see [reminderAgent](../reference/apis/js-apis-remind
        <button type="text" value="publishReminder" onclick="startTimer"></button>
    </div>
    ```
-

en/application-dev/notification/common-event.md

@@ -13,14 +13,14 @@ Each application can subscribe to common events as required. After your applicat
 ## Common Event Subscription Development
 
 ### When to Use
-You can create a subscriber object to subscribe to a common event to obtain the parameters passed in the event. Certain system common events require specific permissions to subscribe to. For details, see [Required Permissions](../reference/apis/js-apis-commonEvent.md).
+You can create a subscriber object to subscribe to a common event to obtain the parameters passed in the event. Certain system common events require specific permissions to subscribe to. For details, see [Required Permissions](../reference/apis/js-apis-commonEvent.md#support).
 
 ### Available APIs
 | API                                                                                         | Description|
 | ---------------------------------------------------------------------------------------------- | ----------- |
-| commonEvent.createSubscriber(subscribeInfo: CommonEventSubscribeInfo, callback: AsyncCallback) | Creates a subscriber. This API uses a callback to return the result.|
-| commonEvent.createSubscriber(subscribeInfo: CommonEventSubscribeInfo)                          | Creates a subscriber. This API uses a promise to return the result. |
-| commonEvent.subscribe(subscriber: CommonEventSubscriber, callback: AsyncCallback)              | Subscribes to common events.|
+| createSubscriber(subscribeInfo: CommonEventSubscribeInfo, callback: AsyncCallback) | Creates a subscriber. This API uses a callback to return the result.|
+| createSubscriber(subscribeInfo: CommonEventSubscribeInfo)                          | Creates a subscriber. This API uses a promise to return the result. |
+| subscribe(subscriber: CommonEventSubscriber, callback: AsyncCallback)              | Subscribes to common events.|
 
 ### How to Develop
 1. Import the **commonEvent** module.
@@ -32,7 +32,8 @@ import commonEvent from '@ohos.commonEvent';
 2. Create a **subscribeInfo** object. For details about the data types and parameters of the object, see [CommonEventSubscribeInfo](../reference/apis/js-apis-commonEvent.md#commoneventsubscribeinfo).
 
 ```js
-private subscriber = null	// Used to save the created subscriber object for subsequent subscription and unsubscription.
+// Used to save the created subscriber object for subsequent subscription and unsubscription.
+private subscriber = null
 
 // Subscriber information
 var subscribeInfo = {
@@ -82,8 +83,8 @@ You can use the **publish** APIs to publish a custom common event, which can car
 ### Available APIs
 | API                             | Description|
 | ---------------------------------- | ------ |
-| commonEvent.publish(event: string, callback: AsyncCallback) | Publishes a common event.|
-| commonEvent.publish(event: string, options: CommonEventPublishData, callback: AsyncCallback) | Publishes a common event with given attributes.|
+| publish(event: string, callback: AsyncCallback) | Publishes a common event.|
+| publish(event: string, options: CommonEventPublishData, callback: AsyncCallback) | Publishes a common event with given attributes.|
 
 ### How to Develop
 #### Development for Publishing a Common Event
@@ -119,7 +120,7 @@ import commonEvent from '@ohos.commonEvent'
 // Attributes of a common event.
 var options = {
     code: 1,			 // Result code of the common event
-    data: "initial data",// Result data of the common event
+    data: "initial data";// Result data of the common event
 }
 ```
 
@@ -144,7 +145,7 @@ You can use the **unsubscribe** API to unsubscribe from a common event.
 ### Available APIs
 | API                             | Description|
 | ---------------------------------- | ------ |
-| commonEvent.unsubscribe(subscriber: CommonEventSubscriber, callback?: AsyncCallback) | Unsubscribes from a common event.|
+| unsubscribe(subscriber: CommonEventSubscriber, callback?: AsyncCallback) | Unsubscribes from a common event.|
 
 ### How to Develop
 1. Import the **commonEvent** module.
@@ -153,7 +154,7 @@ You can use the **unsubscribe** API to unsubscribe from a common event.
 import commonEvent from '@ohos.commonEvent';
 ```
 
-2. Subscribe to a common event by following instructions in [Common Event Subscription Development](#Common-Event-Subscription-Development).
+2. Subscribe to a common event by following instructions in [Common Event Subscription Development](#common-event-subscription-development).
 3. Invoke the **unsubscribe** API in **CommonEvent** to unsubscribe from the common event.
 
 ```js

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

 # Common Event and Notification Overview
 
-The common event and notification module enables applications to publish messages to other applications, and receive messages from the system or other applications. These messages can be news push messages, advertisement notifications, or warning information.
+The common event and notification module enables applications to publish messages to other applications, and receive messages from the system or other applications. These messages can be news push messages, advertisement notifications, warning information, and more.
 
 Common Event Service (CES) enables applications to publish, subscribe to, and unsubscribe from common events. Based on the sender type, common events are classified into system common events and custom common events.
 
 ![ces](figures/ces.png)
 
 - System common event: sent by the system based on system policies to the applications that have subscribed to the event. This type of event includes the screen-on/off events that the users are aware of and the system events published by key system services, such as USB device attachment or detachment, network connection, and system update events.
-
 - Custom common event: customized by applications to be received by specific subscribers. This type of event is usually related to the service logic of the sender applications.
 
-  The Advanced Notification Service (ANS) enables applications to publish notifications. Below are some typical use cases for publishing notifications:
+The Advanced Notification Service (ANS) enables applications to publish notifications. Below are some typical use cases for publishing notifications:
 
-  - Display received SMS messages and instant messages.
-  
-  - Display push messages of applications, such as advertisements, version updates, and news notifications.
-  
-  - Display ongoing events, such as music playback, navigation information, and download progress.
+- Display received SMS messages and instant messages.
+- Display push messages of applications, such as advertisements, version updates, and news notifications.
+- Display ongoing events, such as music playback, navigation information, and download progress.
 
 Notifications are displayed in the notification panel. Uses can delete a notification or click the notification to trigger predefined actions.
 

en/application-dev/quick-start/deveco-studio-user-guide-for-openharmony.md

@@ -2,18 +2,15 @@
 
 
 
-HUAWEI DevEco Studio For OpenHarmony (DevEco Studio for short) is a one-stop, distributed platform developed based on the IntelliJ IDEA Community (Open Source) Edition. It helps you develop versatile all-device, all-scenario applications, offering distributed multi-device development, debugging, and simulation, as well as comprehensive quality and security safeguards.
+HUAWEI DevEco Studio For OpenHarmony (DevEco Studio for short) is a one-stop integrated development environment (IDE) powered by the IntelliJ IDEA Community Edition and oriented to OpenHarmony devices in all scenarios. It allows you to create project templates, and develop, build, debug, and release OpenHarmony applications from end to end.
 
-[DevEco Studio 3.0 Beta3](https://developer.harmonyos.com/cn/develop/deveco-studio#download_beta_openharmony) stands out in the following aspects:
+[DevEco Studio](https://developer.harmonyos.com/en/develop/deveco-studio/) stands out in the following aspects:
 
-- One-stop information acquisition platform
-- A wide range of device project templates
-- Efficient code editing
-- Visualized UI development
-- Bidirectional and instant UI preview
-- High-performing compilation tool Hvigor
-- Support for application development based on the device System Capability (SysCap) sets
-- Automatic application signing mechanism
-- A diverse array of code debugging and profiling features
+- **Efficient and intelligent code editing**: Code highlighting, intelligent code completion, code error check, automatic code navigation, code formatting, and code search for programming languages such as ArkTS, JavaScript, and C/C++. For details, see [Editor Usage Tips](https://developer.harmonyos.com/en/docs/documentation/doc-guides/ohos-editor-usage-tips-0000001263360493).
+- **Low-code development**: A diverse array of features to punch up your UI development productivity, including component drag and drop, visualized data binding, instant previewing, and low-code development for service widgets. For details, see [Using Low-Code Development](https://developer.harmonyos.com/en/docs/documentation/doc-guides/ohos-low-code-development-0000001218440652).
+- **Multi-device bidirectional real-time preview**: Bidirectional preview, real-time preview, live preview, component preview, and multi-device preview of UI code to quickly view how your code runs on devices. For details, see [Previewing Your App/Service](https://developer.harmonyos.com/en/docs/documentation/doc-guides/ohos-previewing-app-service-0000001218760596).
+- **High-performance build system**: Hvigor, a compilation and building tool to compile and package applications/services in one-click mode, better supporting ArkTS/JS development.
+- **One-stop information acquisition**: A one-stop information acquisition platform that takes into account the developer journey of learning, development, and help seeking, in order to facilitate developer activities.
+- **Efficient code debugging**: Various debugging capabilities such as TS, JS, and C/C++ code breakpoint setting, single-step execution, and variable viewing, improving the efficiency of analyzing application/service issues.
 
-For more information, see [HUAWEI DevEco Studio For OpenHarmony User Guide](https://developer.harmonyos.com/en/docs/documentation/doc-guides/ohos-deveco-studio-overview-0000001263280421).
+For more information, see [DevEco Studio (OpenHarmony) User Guide](https://developer.harmonyos.com/en/docs/documentation/doc-guides/ohos-deveco-studio-overview-0000001263280421).

en/application-dev/quick-start/syscap.md

@@ -8,6 +8,10 @@ SysCap is short for System Capability. It refers to a standalone feature in the
 
 ![image-20220326064841782](figures/image-20220326064841782.png)
 
+For details about the SysCap sets in OpenHarmony, see [SysCap List](../reference/syscap-list.md).
+
+
+
 ### Supported SysCap Set, Associated SysCap Set, and Required SysCap Set
 
 The supported SysCap set, associated SysCap set, and required SysCap set are collections of SysCaps.
@@ -60,14 +64,14 @@ You can add APIs to the associated SysCap set in DevEco Studio by adding system
 Exercise caution when modifying the required SysCap set. Incorrect modifications may result in the application being unable to be distributed to the target device.
 
 ```json
-/* syscap.json */
+// syscap.json
 {
 	"devices": {
-		"general": [            /* General devices. Each general device supports a SysCap set. Multiple general devices can be configured. */
+		"general": [            // General devices. Each general device supports a SysCap set. Multiple general devices can be configured.
 			"default",
 			"car"
 		],
-		"custom": [             /* Custom devices. */
+		"custom": [             // Custom devices.
 			{
 				"Custom device": [
 					"SystemCapability.Communication.SoftBus.Core"
@@ -75,12 +79,12 @@ Exercise caution when modifying the required SysCap set. Incorrect modifications
 			}
 		]
 	},
-	"development": {             /* The SysCap set in addedSysCaps and the SysCap set supported by each device configured in devices form the associated SysCap set. */
+	"development": {             // The SysCap set in addedSysCaps and the SysCap set supported by each device configured in devices form the associated SysCap set.
 		"addedSysCaps": [
 			"SystemCapability.Location.Location.Lite"
 		]
 	},
-	"production": {              /* Used to generate the RPCID. Exercise caution when adding this parameter. Under incorrect settings, applications may fail to be distributed to target devices. */
+	"production": {              // Used to generate the RPCID. Exercise caution when adding this parameter. Under incorrect settings, applications may fail to be distributed to target devices.
 		"addedSysCaps": [],      // Intersection of SysCap sets supported by devices configured in devices. It is the required SysCap set with addedSysCaps set and removedSysCaps set.
 		"removedSysCaps": []     // When the required SysCap set is a capability subset of a device, the application can be distributed to the device.
 	}

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

 # Development References
-
--   [Component Reference (TypeScript-based Declarative Development Paradigm)](arkui-ts/Readme-EN.md)
--   [Component Reference (JavaScript-based Web-like Development Paradigm)](arkui-js/Readme-EN.md)
--   [API Reference (JS and TS APIs)](apis/Readme-EN.md)
--   API Reference (Native APIs)
-    -   [Standard Libraries Supported by Native APIs](native-lib/Readme-EN.md)
+- [SysCap List](syscap-list.md)
+- [Component Reference (ArkTS-based Declarative Development Paradigm)](arkui-ts/Readme-EN.md)
+- [Component Reference (JavaScript-compatible Web-like Development Paradigm)](arkui-js/Readme-EN.md)
+- [API Reference (JS and TS APIs)](apis/Readme-EN.md)
+- API Reference (Native APIs)
+  -   [Standard Libraries Supported by Native APIs](native-lib/Readme-EN.md)
 

en/application-dev/reference/apis/Readme-EN.md

 # APIs
 
 - [API Reference Document Description](development-intro.md)
-
 - Ability Framework
-
   - FA Model
     - [@ohos.ability.featureAbility](js-apis-featureAbility.md)
     - [@ohos.ability.particleAbility](js-apis-particleAbility.md)
@@ -28,8 +26,6 @@
     - application/[FormExtensionContext](js-apis-formextensioncontext.md)
     - application/[PermissionRequestResult](js-apis-permissionrequestresult.md)
     - application/[ServiceExtensionContext](js-apis-service-extension-context.md)
-    - [InputMethodExtensionAbility](js-apis-inputmethod-extension-ability.md)
-    - [InputMethodExtensionContext](js-apis-inputmethod-extension-context.md)
   - FA and Stage Models
     - [@ohos.ability.dataUriUtils](js-apis-DataUriUtils.md)
     - [@ohos.ability.errorCode](js-apis-ability-errorCode.md)
@@ -60,18 +56,15 @@
     - application/[ExtensionRunningInfo](js-apis-extensionrunninginfo.md)
     - application/[MissionSnapshot](js-apis-application-MissionSnapshot.md)
     - application/[ProcessRunningInfo](js-apis-processrunninginfo.md)
+    - application/[ProcessRunningInformation](js-apis-processrunninginformation.md)
     - application/[shellCmdResult](js-apis-application-shellCmdResult.md)
     - continuation/[ContinuationResult](js-apis-continuation-continuationResult.md)
 - Common Event and Notification
-
   - [@ohos.commonEvent](js-apis-commonEvent.md)
   - [@ohos.events.emitter](js-apis-emitter.md)
   - [@ohos.notification](js-apis-notification.md)
-  - [@ohos.reminderAgent](js-apis-reminderAgent.md)
   - application/[EventHub](js-apis-eventhub.md)
-  
-- Bundle Management
-
+ - Bundle Management 
   - [@ohos.bundle](js-apis-Bundle.md)
   - [@ohos.bundle.defaultAppManager](js-apis-bundle-defaultAppManager.md)
   - [@ohos.bundle.innerBundleManager)](js-apis-Bundle-InnerBundleManager.md)
@@ -92,17 +85,14 @@
   - bundle/[ModuleInfo](js-apis-bundle-ModuleInfo.md)
   - bundle/[PermissionDef](js-apis-bundle-PermissionDef.md)
   - bundle/[RemoteAbilityInfo](js-apis-bundle-remoteAbilityInfo.md)
-  - bundle/[ShortcutInfo](js-apis-bundle-ShortcutInfo.md)
+  - bundle/[ShortcutInfo<sup>(deprecated)</sup>](js-apis-bundle-ShortcutInfo.md)
+  - bundle/[PackInfo](js-apis-bundle-PackInfo.md)
 - UI Page
-
   - [@ohos.animator](js-apis-animator.md)
   - [@ohos.mediaquery](js-apis-mediaquery.md)
-  - [@ohos.prompt](js-apis-prompt.md)
   - [@ohos.router](js-apis-router.md)
   - [@ohos.uiAppearance](js-apis-uiappearance.md)
-  
-- Graphics
-
+ - Graphics 
   - [@ohos.animation.windowAnimationManager](js-apis-windowAnimationManager.md)
   - [@ohos.display ](js-apis-display.md)
   - [@ohos.effectKit](js-apis-effectKit.md)
@@ -111,42 +101,31 @@
   - [@ohos.window](js-apis-window.md)
   - [webgl](js-apis-webgl.md)
   - [webgl2](js-apis-webgl2.md)
-  
 - Media
-
   - [@ohos.multimedia.audio](js-apis-audio.md)
   - [@ohos.multimedia.camera](js-apis-camera.md)
   - [@ohos.multimedia.image](js-apis-image.md)
   - [@ohos.multimedia.media](js-apis-media.md)
-  - [@ohos.multimedia.medialibrary](js-apis-medialibrary.md)
-  
 - Resource Management
-
   - [@ohos.i18n](js-apis-i18n.md)
   - [@ohos.intl](js-apis-intl.md)
   - [@ohos.resourceManager](js-apis-resource-manager.md)
-  
-- Resource Scheduling
-
+- Resource Scheduling  
   - [@ohos.backgroundTaskManager](js-apis-backgroundTaskManager.md)
   - [@ohos.distributedMissionManager](js-apis-distributedMissionManager.md)
   - [@ohos.workScheduler ](js-apis-workScheduler.md)
   - [@ohos.WorkSchedulerExtensionAbility](js-apis-WorkSchedulerExtensionAbility.md)
-  
 - Custom Management
-
   - [@ohos.configPolicy](js-apis-config-policy.md)
-  - [@ohos.enterpriseDeviceManager](js-apis-enterprise-device-manager.md)
   - [@ohos.EnterpriseAdminExtensionAbility](js-apis-EnterpriseAdminExtensionAbility.md)
+  - [@ohos.enterpriseDeviceManager](js-apis-enterprise-device-manager.md)
   - enterpriseDeviceManager/[DeviceSettingsManager](js-apis-enterpriseDeviceManager-DeviceSettingsManager.md)
-  
 - Security
-
   - [@ohos.abilityAccessCtrl](js-apis-abilityAccessCtrl.md)
   - [@ohos.privacyManager](js-apis-privacyManager.md)
   - [@ohos.security.huks ](js-apis-huks.md)
-  - [@ohos.userIAM.userAuth ](js-apis-useriam-userauth.md)
   - [@ohos.userIAM.faceAuth](js-apis-useriam-faceauth.md)
+  - [@ohos.userIAM.userAuth ](js-apis-useriam-userauth.md)
   - [@system.cipher](js-apis-system-cipher.md)
   
 - Data Management
@@ -155,7 +134,6 @@
   - [@ohos.data.dataShare](js-apis-data-dataShare.md)
   - [@ohos.data.dataSharePredicates](js-apis-data-dataSharePredicates.md)
   - [@ohos.data.dataShareResultSet](js-apis-data-DataShareResultSet.md)
-  - [@ohos.data.distributedData](js-apis-distributed-data.md)
   - [@ohos.data.distributedDataObject](js-apis-data-distributedobject.md)
   - [@ohos.data.preferences](js-apis-data-preferences.md)
   - [@ohos.data.rdb](js-apis-data-rdb.md)
@@ -167,46 +145,44 @@
   - [@ohos.document](js-apis-document.md)
   - [@ohos.environment](js-apis-environment.md)
   - [@ohos.fileio](js-apis-fileio.md)
-  - [@ohos.fileManager](js-apis-filemanager.md)
+  - [@ohos.multimedia.medialibrary](js-apis-medialibrary.md)
+  - [@ohos.securityLabel](js-apis-securityLabel.md)
   - [@ohos.statfs](js-apis-statfs.md)
   - [@ohos.storageStatistics](js-apis-storage-statistics.md)
   - [@ohos.volumeManager](js-apis-volumemanager.md)
-  - [@ohos.securityLabel](js-apis-securityLabel.md)
-  
 - Telephony Service
-
   - [@ohos.contact](js-apis-contact.md)
   - [@ohos.telephony.call](js-apis-call.md)
+  - [@ohos.telephony.data](js-apis-telephony-data.md)
   - [@ohos.telephony.observer](js-apis-observer.md)
   - [@ohos.telephony.radio](js-apis-radio.md)
   - [@ohos.telephony.sim](js-apis-sim.md)
   - [@ohos.telephony.sms](js-apis-sms.md)
-  - [@ohos.telephony.data](js-apis-telephony-data.md)
-  
 - Network Management
-
   - [@ohos.net.connection](js-apis-net-connection.md)
+  - [@ohos.net.ethernet](js-apis-net-ethernet.md)
   - [@ohos.net.http](js-apis-http.md)
-  - [@ohos.request](js-apis-request.md)
+  - [@ohos.net.policy](js-apis-net-policy.md)
+  - [@ohos.net.sharing](js-apis-net-sharing.md)
   - [@ohos.net.socket](js-apis-socket.md)
+  - [@ohos.net.statistics](js-apis-net-statistics.md)
+  - [@ohos.net.tlsSocket](js-apis-tlsSocket.md)
   - [@ohos.net.webSocket](js-apis-webSocket.md)
-  
+  - [@ohos.request](js-apis-request.md)
 - Connectivity
-
   - [@ohos.bluetooth](js-apis-bluetooth.md)
   - [@ohos.connectedTag](js-apis-connectedTag.md)
   - [@ohos.nfc.cardEmulation](js-apis-cardEmulation.md)
   - [@ohos.nfc.controller](js-apis-nfcController.md)
   - [@ohos.nfc.tag](js-apis-nfcTag.md)
-  - [@ohos.nfc.tag](js-apis-nfctech.md)
-  - [@ohos.nfc.tag](js-apis-tagSession.md)
   - [@ohos.rpc](js-apis-rpc.md)
   - [@ohos.wifi](js-apis-wifi.md)
   - [@ohos.wifiext](js-apis-wifiext.md)
-  
+  - tag/[nfctech](js-apis-nfctech.md)
+  - tag/[tagSession](js-apis-tagSession.md)
 - Basic Features
-
   - [@ohos.accessibility](js-apis-accessibility.md)
+  - [@ohos.accessibility.config](js-apis-accessibility-config.md)
   - [@ohos.faultLogger](js-apis-faultLogger.md)
   - [@ohos.hiAppEvent](js-apis-hiappevent.md)
   - [@ohos.hichecker](js-apis-hichecker.md)
@@ -217,13 +193,16 @@
   - [@ohos.hiTraceMeter](js-apis-hitracemeter.md)
   - [@ohos.inputMethod](js-apis-inputmethod.md)
   - [@ohos.inputMethodEngine](js-apis-inputmethodengine.md)
+  - [@ohos.inputmethodextensionability](js-apis-inputmethod-extension-ability.md)
+  - [@ohos.inputmethodextensioncontext](js-apis-inputmethod-extension-context.md)
   - [@ohos.pasteboard](js-apis-pasteboard.md)
   - [@ohos.screenLock](js-apis-screen-lock.md)
   - [@ohos.systemTime](js-apis-system-time.md)
   - [@ohos.systemTimer](js-apis-system-timer.md)
   - [@ohos.wallpaper](js-apis-wallpaper.md)
+  - [console](js-apis-logs.md)
   - [Timer](js-apis-timer.md)
-  
+
 - Device Management
 
   - [@ohos.batteryInfo ](js-apis-battery-info.md)
@@ -239,6 +218,7 @@
   - [@ohos.multimodalInput.keyCode](js-apis-keycode.md)
   - [@ohos.multimodalInput.keyEvent](js-apis-keyevent.md)
   - [@ohos.multimodalInput.mouseEvent](js-apis-mouseevent.md)
+  - [@ohos.multimodalInput.pointer](js-apis-pointer.md)
   - [@ohos.multimodalInput.touchEvent](js-apis-touchevent.md)
   - [@ohos.power](js-apis-power.md)
   - [@ohos.runningLock](js-apis-runninglock.md)
@@ -249,15 +229,12 @@
   - [@ohos.update](js-apis-update.md)
   - [@ohos.usb](js-apis-usb.md)
   - [@ohos.vibrator](js-apis-vibrator.md)
-  
-- Account Management
-
+- Account Management  
   - [@ohos.account.appAccount](js-apis-appAccount.md)
   - [@ohos.account.distributedAccount](js-apis-distributed-account.md)
   - [@ohos.account.osAccount](js-apis-osAccount.md)
-  
-- Language Base Class Library
-
+ - Language Base Class Library 
+  - [@ohos.buffer](js-apis-buffer.md)
   - [@ohos.convertxml](js-apis-convertxml.md)
   - [@ohos.process](js-apis-process.md)
   - [@ohos.uri](js-apis-uri.md)
@@ -279,16 +256,15 @@
   - [@ohos.util.Vector](js-apis-vector.md)
   - [@ohos.worker](js-apis-worker.md)
   - [@ohos.xml](js-apis-xml.md)
-  
 - Test
-
   - [@ohos.application.testRunner](js-apis-testRunner.md)
   - [@ohos.uitest](js-apis-uitest.md)
-  
-- APIs No Longer Maintained
-
+- APIs No Longer Maintained 
   - [@ohos.bytrace](js-apis-bytrace.md)
   - [@ohos.data.storage](js-apis-data-storage.md)
+  - [@ohos.data.distributedData](js-apis-distributed-data.md)
+  - [@ohos.prompt](js-apis-prompt.md)
+  - [@ohos.reminderAgent](js-apis-reminderAgent.md)
   - [@system.app](js-apis-system-app.md)
   - [@system.battery](js-apis-system-battery.md)
   - [@system.bluetooth](js-apis-system-bluetooth.md)
@@ -308,4 +284,3 @@
   - [@system.sensor](js-apis-system-sensor.md)
   - [@system.storage](js-apis-system-storage.md)
   - [@system.vibrator](js-apis-system-vibrate.md)
-  - [console](js-apis-logs.md)
\ No newline at end of file

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

@@ -139,6 +139,80 @@ bundle.getApplicationInfo(bundleName, bundleFlags, (err, data) => {
  })
 ```
 
+## bundle.getApplicationInfoSync<sup>9+</sup>
+
+getApplicationInfoSync(bundleName: string, bundleFlags: number, userId: number): ApplicationInfo;
+
+Obtains the application information of the specified user based on a given bundle name. This API returns the result synchronously.
+
+**Required permissions**
+
+ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO
+
+**System capability**
+
+SystemCapability.BundleManager.BundleFramework
+
+**Parameters**
+
+| Name       | Type  | Mandatory| Description                                                        |
+| ----------- | ------ | ---- | ------------------------------------------------------------ |
+| bundleName  | string | Yes  | Bundle name of an application.                                              |
+| bundleFlags | number | Yes  | Type of information that will be returned. The default value is **0**. For details on the available enumerated values, see the application information flags in [BundleFlag](#bundleflag).|
+| userId      | number | Yes  | User ID. The default value is the user ID of the caller. The value must be greater than or equal to 0.       |
+
+**Return value**
+
+| Type                                                | Description               |
+| ---------------------------------------------------- | ------------------- |
+| [ApplicationInfo](js-apis-bundle-ApplicationInfo.md) | **ApplicationInfo** object.|
+
+**Example**
+
+```js
+let bundleName = "com.example.myapplication";
+let bundleFlags = 0;
+let userId = 100;
+var applicationInfo = bundle.getApplicationInfoSync(bundleName, bundleFlags, userId);
+console.info('Operation successful. Name:' + applicationInfo.name);
+```
+
+## bundle.getApplicationInfoSync<sup>9+</sup>
+
+getApplicationInfoSync(bundleName: string, bundleFlags: number) : ApplicationInfo;
+
+Obtains the application information based on a given bundle name. This API returns the result synchronously.
+
+**Required permissions**
+
+ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO
+
+**System capability**
+
+SystemCapability.BundleManager.BundleFramework
+
+**Parameters**
+
+| Name       | Type  | Mandatory| Description                                                        |
+| ----------- | ------ | ---- | ------------------------------------------------------------ |
+| bundleName  | string | Yes  | Bundle name of an application.                                              |
+| bundleFlags | number | Yes  | Type of information that will be returned. The default value is **0**. For details on the available enumerated values, see the application information flags in [BundleFlag](#bundleflag).|
+
+**Return value**
+
+| Type                                                | Description               |
+| ---------------------------------------------------- | ------------------- |
+| [ApplicationInfo](js-apis-bundle-ApplicationInfo.md) | **ApplicationInfo** object.|
+
+**Example**
+
+```js
+let bundleName = "com.example.myapplication";
+let bundleFlags = 0;
+var applicationInfo = bundle.getApplicationInfoSync(bundleName, bundleFlags);
+console.info('Operation successful. Name:' + applicationInfo.name);
+```
+
 ## bundle.getAllBundleInfo
 
 getAllBundleInfo(bundleFlag: BundleFlag, userId?: number): Promise<Array\<BundleInfo>>
@@ -370,6 +444,82 @@ bundle.getBundleInfo(bundleName, bundleFlags, options, (err, data) => {
 })
 ```
 
+## bundle.getBundleInfoSync<sup>9+</sup>
+
+getBundleInfoSync(bundleName: string, bundleFlags: number, options: BundleOptions): BundleInfo;
+
+Obtains the bundle information based on a given bundle name and bundle options. This API returns the result synchronously.
+
+**Required permissions**
+
+ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO
+
+**System capability**
+
+SystemCapability.BundleManager.BundleFramework
+
+**Parameters**
+
+| Name       | Type                           | Mandatory| Description                                                        |
+| ----------- | ------------------------------- | ---- | ------------------------------------------------------------ |
+| bundleName  | string                          | Yes  | Bundle name of an application.                                              |
+| bundleFlags | number                          | Yes  | Type of information that will be returned. The default value is **0**. For details on the available enumerated values, see the bundle information flags in [BundleFlag](#bundleflag).|
+| options     | [BundleOptions](#bundleoptions) | Yes  | Options of the bundle.                                              |
+
+**Return value**
+
+| Type                                      | Description          |
+| ------------------------------------------ | -------------- |
+| [BundleInfo](js-apis-bundle-BundleInfo.md) | **BundleInfo** object.|
+
+**Example**
+
+```js
+let bundleName = "com.example.myapplication";
+let bundleFlags = 1;
+let options = {
+  "userId" : 100
+};
+var bundleInfo = bundle.getBundleInfoSync(bundleName, bundleFlags, options);
+console.info('Operation successful. Name:' + bundleInfo.name);
+```
+
+## bundle.getBundleInfoSync<sup>9+</sup>
+
+getBundleInfoSync(bundleName: string, bundleFlags: number): BundleInfo;
+
+Obtains the bundle information based on a given bundle name. This API returns the result synchronously.
+
+**Required permissions**
+
+ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO
+
+**System capability**
+
+SystemCapability.BundleManager.BundleFramework
+
+**Parameters**
+
+| Name       | Type  | Mandatory| Description                                                        |
+| ----------- | ------ | ---- | ------------------------------------------------------------ |
+| bundleName  | string | Yes  | Bundle name of an application.                                              |
+| bundleFlags | number | Yes  | Type of information that will be returned. The default value is **0**. For details on the available enumerated values, see the bundle information flags in [BundleFlag](#bundleflag).|
+
+**Return value**
+
+| Type                                      | Description          |
+| ------------------------------------------ | -------------- |
+| [BundleInfo](js-apis-bundle-BundleInfo.md) | **BundleInfo** object.|
+
+**Example**
+
+```js
+let bundleName = "com.example.myapplication";
+let bundleFlags = 1;
+var bundleInfo = bundle.getBundleInfoSync(bundleName, bundleFlags);
+console.info('Operation successful. Name:' + bundleInfo.name);
+```
+
 ## bundle.getBundleInstaller
 
 getBundleInstaller(): Promise&lt;BundleInstaller&gt;;
@@ -685,7 +835,7 @@ This is a system API and cannot be called by third-party applications.
 | ----------- | --------------------------- | ---- | ---------------------- |
 | bundleName  | string                      | Yes  | Bundle name of an application.      |
 | moduleName  | string                      | Yes  | Module name of the application.    |
-| upgradeFlag | [UpgradeFlag](#upgradeflag) | Yes  | Upgrade flag, which is  for internal use only.|
+| upgradeFlag | [UpgradeFlag](#upgradeflag) | Yes  | Upgrade flag, which is for internal use only.|
 
 **Return value**
 
@@ -758,10 +908,10 @@ This is a system API and cannot be called by third-party applications.
 
 **Parameters**
 
-| Name          | Type                              | Mandatory| Description                                                |
-| -------------- | ---------------------------------- | ---- | ---------------------------------------------------- |
-| bundleName     | string                             | Yes  | Bundle name of an application.                                    |
-| bundlePackFlag | pack.BundlePackFlag                | Yes  | Flags of the bundle package.                              |
+| Name          | Type                                                        | Mandatory| Description                                                |
+| -------------- | ------------------------------------------------------------ | ---- | ---------------------------------------------------- |
+| bundleName     | string                                                       | Yes  | Bundle name of an application.                                    |
+| bundlePackFlag | pack.BundlePackFlag            | Yes  | Flags of the bundle package.                              |
 | callback       | AsyncCallback<pack.BundlePackInfo> | Yes  | Callback used to return the bundle package information.|
 
 ## bundle.getBundlePackInfo<sup>9+</sup>
@@ -780,16 +930,16 @@ This is a system API and cannot be called by third-party applications.
 
 **Parameters**
 
-| Name          | Type               | Mandatory| Description                  |
-| -------------- | ------------------- | ---- | ---------------------- |
-| bundleName     | string              | Yes  | Bundle name of an application.      |
+| Name          | Type                                             | Mandatory| Description                  |
+| -------------- | ------------------------------------------------- | ---- | ---------------------- |
+| bundleName     | string                                            | Yes  | Bundle name of an application.      |
 | bundlePackFlag | pack.BundlePackFlag | Yes  | Flags of the bundle package.|
 
 **Return value**
 
-| Type                        | Description                               |
-| ---------------------------- | ----------------------------------- |
-| Promise<pack.BundlePackInfo> | Promise used to return the bundle package information.|
+| Type                         | Description                                            |
+| ---------------------------- | ------------------------------------------------------ |
+| Promise<pack.BundlePackInfo> | Promise used to return the bundle package information. |
 
 ## bundle.getDispatcherVersion<sup>9+</sup>
 
@@ -1894,7 +2044,7 @@ SystemCapability.BundleManager.BundleFramework
 | -------------- | ------ | ---- | ---------------------------------------- |
 | want           | [Want](js-apis-application-Want.md)   | Yes   | Want that contains the bundle name.                       |
 | extensionType  | number | Yes   | Type of the Extension ability information to obtain. The default value is **0**. For details on the available enumerated values, see [ExtensionAbilityType](#extensionabilitytype9).|
-| extensionFlags | number | Yes   | Extension ability information to be returned. The default value is **0**. For details on the available enumerated values, see  [ExtensionFlags](#extensionflag9).|
+| extensionFlags | number | Yes   | Extension ability information to be returned. The default value is **0**. For details on the available enumerated values, see [ExtensionFlags](#extensionflag9).|
 | userId         | number | No   | User ID. The default value is the user ID of the caller. The value must be greater than or equal to 0.             |
 
 **Return value**
@@ -1943,7 +2093,7 @@ SystemCapability.BundleManager.BundleFramework
 | -------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
 | want           | [Want](js-apis-application-Want.md)                                                        | Yes  | Want that contains the bundle name.                      |
 | extensionType  | number                                                       | Yes  | Type of the Extension ability information to obtain. The default value is **0**. For details on the available enumerated values, see [ExtensionAbilityType](#extensionabilitytype9).|
-| extensionFlags | number                                                       | Yes  | Extension ability information to be returned. The default value is **0**. For details on the available enumerated values, see  [ExtensionFlags](#extensionflag9).|
+| extensionFlags | number                                                       | Yes  | Extension ability information to be returned. The default value is **0**. For details on the available enumerated values, see [ExtensionFlags](#extensionflag9).|
 | userId         | number                                                       | Yes  | User ID. The default value is the user ID of the caller. The value must be greater than or equal to 0.         |
 | callback       | AsyncCallback<Array\<[ExtensionAbilityInfo](js-apis-bundle-ExtensionAbilityInfo.md)>> | Yes  | Callback used to return the Extension ability information.      |
 
@@ -1986,7 +2136,7 @@ SystemCapability.BundleManager.BundleFramework
 | -------------- | ---------------------------------------- | ---- | ---------------------------------------- |
 | want           | [Want](js-apis-application-Want.md)                                     | Yes   | Want that contains the bundle name.                     |
 | extensionType  | number                                   | Yes   | Type of the Extension ability information to obtain. The default value is **0**. For details on the available enumerated values, see [ExtensionAbilityType](#extensionabilitytype9).|
-| extensionFlags | number                                   | Yes   | Extension ability information to be returned. The default value is **0**. For details on the available enumerated values, see  [ExtensionFlags](#extensionflag9).|
+| extensionFlags | number                                   | Yes   | Extension ability information to be returned. The default value is **0**. For details on the available enumerated values, see [ExtensionFlags](#extensionflag9).|
 | callback       | AsyncCallback<Array\<[ExtensionAbilityInfo](js-apis-bundle-ExtensionAbilityInfo.md)>> | Yes   | Callback used to return the Extension ability information.     |
 
 **Example**

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

@@ -381,6 +381,53 @@ context.getDisplayOrientation().then((data) => {
 });
 ```
 
+## Context.getExternalCacheDir
+
+getExternalCacheDir(callback: AsyncCallback\<string>): void
+
+Obtains the external cache directory of the application. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Parameters**
+
+| Name      | Type                    | Mandatory  | Description                |
+| -------- | ---------------------- | ---- | ------------------ |
+| callback | AsyncCallback\<string> | Yes   | Callback used to return the absolute path of the cache directory.|
+
+**Example**
+
+```js
+import featureAbility from '@ohos.ability.featureAbility'
+var context = featureAbility.getContext();
+context.getExternalCacheDir()
+```
+
+## Context.getExternalCacheDir
+
+getExternalCacheDir(): Promise\<string>;
+
+Obtains the external cache directory of the application. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.Ability.AbilityRuntime.Core
+
+**Return value**
+
+| Type              | Description              |
+| ---------------- | ---------------- |
+| Promise\<string> | Promise used to return the absolute path of the cache directory.|
+
+**Example**
+
+```js
+import featureAbility from '@ohos.ability.featureAbility'
+var context = featureAbility.getContext();
+context.getExternalCacheDir().then((data) => {
+    console.info("=======================>getExternalCacheDirCallback====================>");
+    console.info("====>data====>" + JSON.stringify(data));
+});
+```
+
 ## Context.setDisplayOrientation<sup>7+</sup>
 
 setDisplayOrientation(orientation: bundle.DisplayOrientation, callback: AsyncCallback\<void>): void

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

@@ -49,3 +49,51 @@ export default class EnterpriseAdminAbility extends EnterpriseAdminExtensionAbil
   }
 };
 ```
+
+## EnterpriseAdminExtensionAbility.onBundleAdded
+
+onBundleAdded(bundleName: string): void
+
+Called when a bundle is added.
+
+**System capability**: SystemCapability.Customization.EnterpriseDeviceManager
+
+**Parameters**
+
+| Parameter  | Type                                 | Mandatory  | Description     |
+| ----- | ----------------------------------- | ---- | ------- |
+| bundleName | string | Yes   | Name of the bundle added.|
+
+**Example**
+
+```ts
+export default class EnterpriseAdminAbility extends EnterpriseAdminExtensionAbility {
+  onBundleAdded(bundleName: string) {
+    console.log("added bundle name: " + bundleName);
+  }
+};
+```
+
+## EnterpriseAdminExtensionAbility.onBundleRemoved
+
+onBundleRemoved(bundleName: string): void
+
+Called when a bundle is removed.
+
+**System capability**: SystemCapability.Customization.EnterpriseDeviceManager
+
+**Parameters**
+
+| Parameter  | Type                                 | Mandatory  | Description     |
+| ----- | ----------------------------------- | ---- | ------- |
+| bundleName | string | Yes   | Name of the bundle removed.|
+
+**Example**
+
+```ts
+export default class EnterpriseAdminAbility extends EnterpriseAdminExtensionAbility {
+  onBundleAdded(bundleName: string) {
+    console.log("removed bundle name: " + bundleName);
+  }
+};
+```

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

@@ -19,5 +19,5 @@ import StartOptions from '@ohos.application.StartOptions';
 
 | Name| Readable| Writable| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- | -------- | -------- |
-| [windowMode](js-apis-application-abilityConstant.md#AbilityConstant.WindowMode) | Yes| No| number | No| Window mode.|
+| [windowMode](js-apis-application-abilityConstant.md#abilityconstantwindowmode) | Yes| No| number | No| Window mode.|
 | displayId | Yes| No| number | No| Display ID.|

en/application-dev/reference/apis/js-apis-data-ability.md

@@ -726,7 +726,7 @@ Sets a **DataAbilityPredicates** object to specify the index column.
 
 in(field: string, value: Array<ValueType>): DataAbilityPredicates
 
-Sets a **DataAbilityPredicates** object to match the field with data type Array<ValueType> and value within the specified range.
+Sets a **DataAbilityPredicates** object to match the field with data type Array\<ValueType> and value within the specified range.
 
 **System capability**: SystemCapability.DistributedDataManager.DataShare.Core
 
@@ -754,7 +754,7 @@ Sets a **DataAbilityPredicates** object to match the field with data type Array<
 
 notIn(field: string, value: Array&lt;ValueType&gt;): DataAbilityPredicates
 
-Sets a **DataAbilityPredicates** object to match the field with data type Array<ValueType> and value out of the specified range.
+Sets a **DataAbilityPredicates** object to match the field with data type Array\<ValueType> and value out of the specified range.
 
 **System capability**: SystemCapability.DistributedDataManager.DataShare.Core