Merge branch 'master' into idlDocs

Change-Id: Ibc1067083b12b0c0b4752064ee6596b6f89a7c26

CODEOWNERS

@@ -129,8 +129,10 @@ zh-cn/device-dev/subsystems/subsys-toolchain-hdc-guide.md @Austin23
 zh-cn/device-dev/subsystems/subsys-toolchain-hiperf.md @Austin23
 zh-cn/device-dev/subsystems/subsys-xts-guide.md @Austin23
 
-zh-cn/application-dev/ability/ @RayShih
-zh-cn/application-dev/ui/ @HelloCrease
+zh-cn/application-dev/ability/ @RayShih @littlejerry1 @gwang2008 @ccllee @chengxingzhen
+zh-cn/application-dev/IDL/ @RayShih @littlejerry1 @gwang2008 @ccllee @chengxingzhen
+zh-cn/application-dev/device-usage-statistics/ @RayShih @shuaytao @wangzhen107 @inter515
+zh-cn/application-dev/ui/ @HelloCrease @qieqiewl @tomatodevboy @niulihua
 zh-cn/application-dev/notification/ @RayShih
 zh-cn/application-dev/windowmanager/ @ge-yafang
 zh-cn/application-dev/webgl/ @ge-yafang
@@ -445,8 +447,19 @@ zh-cn/application-dev/reference/apis/js-apis-formextensioncontext.md @RayShih @l
 zh-cn/application-dev/reference/apis/js-apis-formhost.md @RayShih @littlejerry1 @gwang2008 @ccllee @chengxingzhen
 zh-cn/application-dev/reference/apis/js-apis-formInfo.md @RayShih @littlejerry1 @gwang2008 @ccllee @chengxingzhen
 zh-cn/application-dev/reference/apis/js-apis-formprovider.md @RayShih @littlejerry1 @gwang2008 @ccllee @chengxingzhen
-zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-ability.md @RayShih @littlejerry1 @gwang2008 @ccllee @chengxingzhen
-zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-context.md @RayShih @littlejerry1 @gwang2008 @ccllee @chengxingzhen
+zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-ability.md @ge-yafang
+zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-context.md @ge-yafang
+zh-cn/application-dev/reference/apis/js-apis-inputmethod-subtype.md @ge-yafang
+zh-cn/application-dev/reference/errorcodes/errcode-inputmethod-framework.md @ge-yafang
+zh-cn/application-dev/reference/errorcodes/errcode-usb.md @ge-yafang
+zh-cn/application-dev/reference/errorcodes/errorcode-datashare.md @ge-yafang
+zh-cn/application-dev/reference/errorcodes/errorcode-colorspace-manager.md @ge-yafang
+zh-cn/application-dev/reference/errorcodes/errorcode-display.md @ge-yafang
+zh-cn/application-dev/reference/errorcodes/errorcode-distributed-data_object.md @ge-yafang
+zh-cn/application-dev/reference/errorcodes/errorcode-distributedKVStore.md @ge-yafang
+zh-cn/application-dev/reference/errorcodes/errorcode-pasteboard.md @ge-yafang
+zh-cn/application-dev/reference/errorcodes/errorcode-preferences.md @ge-yafang
+zh-cn/application-dev/reference/errorcodes/errorcode-window.md @ge-yafang
 zh-cn/application-dev/reference/apis/js-apis-application-quickFixManager.md @RayShih @littlejerry1 @gwang2008 @ccllee @chengxingzhen
 zh-cn/application-dev/reference/apis/js-apis-missionManager.md @RayShih @littlejerry1 @gwang2008 @ccllee @chengxingzhen
 zh-cn/application-dev/reference/apis/js-apis-particleAbility.md @RayShih @littlejerry1 @gwang2008 @ccllee @chengxingzhen

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

@@ -68,13 +68,13 @@
   - [@ohos.bundle](js-apis-Bundle.md)
   - [@ohos.bundle.defaultAppManager](js-apis-bundle-defaultAppManager.md)
   - [@ohos.bundle.innerBundleManager)](js-apis-Bundle-InnerBundleManager.md)
-  - [@ohos.bundleState](js-apis-deviceUsageStatistics.md)
   - [@ohos.distributedBundle)](js-apis-Bundle-distributedBundle.md)
   - [@ohos.zlib](js-apis-zlib.md)
   - bundle/[AbilityInfo](js-apis-bundle-AbilityInfo.md)
   - bundle/[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)
   - bundle/[BundleInfo](js-apis-bundle-BundleInfo.md)
   - bundle/[BundleInstaller](js-apis-bundle-BundleInstaller.md)
+  - bundle/[BundleStatusCallback](js-apis-Bundle-BundleStatusCallback.md)
   - bundle/[CustomizeData](js-apis-bundle-CustomizeData.md)
   - bundle/[DispatchInfo](js-apis-dispatchInfo.md)
   - bundle/[ElementName](js-apis-bundle-ElementName.md)
@@ -96,6 +96,7 @@
   - [@ohos.animation.windowAnimationManager](js-apis-windowAnimationManager.md)
   - [@ohos.display ](js-apis-display.md)
   - [@ohos.effectKit](js-apis-effectKit.md)
+  - [@ohos.graphics.colorSpaceManager](js-apis-colorSpaceManager.md)
   - [@ohos.screen](js-apis-screen.md)
   - [@ohos.screenshot](js-apis-screenshot.md)
   - [@ohos.window](js-apis-window.md)
@@ -284,3 +285,4 @@
   - [@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)

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

+# BundleStatusCallback
+
+The **BundleStatusCallback** module provides bundle callback information, which is obtained through [innerBundleManager.on](js-apis-Bundle-InnerBundleManager.md).
+
+> **NOTE**
+>
+> The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version.
+
+## BundleStatusCallback
+
+**System API**: This is a system API and cannot be called by third-party applications.
+
+**System capability**: SystemCapability.BundleManager.BundleFramework
+
+| Name  | Type                                         | Description                                  |
+| ------ | --------------------------------------------- | -------------------------------------- |
+| add    | (bundleName : string, userId: number) => void | Callback invoked when a **launcherStatusCallback** is added.|
+| update | (bundleName : string, userId: number) => void | Callback invoked when a **launcherStatusCallback** is updated.|
+| remove | (bundleName : string, userId: number) => void | Callback invoked when a **launcherStatusCallback** is removed.|

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

@@ -106,8 +106,8 @@ This is a system API and cannot be called by third-party applications.
 
 | Name                | Type                 | Mandatory| Description                                                |
 | -------------------- | --------------------- | ---- | ---------------------------------------------------- |
-| type                 | "BundleStatusChange"  | Yes  | Event type.                                    |
-| bundleStatusCallback | BundleStatusCallback  | Yes  | Callback to register.                                  |
+| type                 | string | Yes  | Event type. Only **BundleStatusChange** is supported.            |
+| bundleStatusCallback | [BundleStatusCallback](js-apis-Bundle-BundleStatusCallback.md) | Yes  | Callback to register.                                  |
 | callback             | AsyncCallback\<string> | Yes  | Callback used to return a successful result or error information.|
 
 ## innerBundleManager.on
@@ -131,9 +131,9 @@ This is a system API and cannot be called by third-party applications.
 **Parameters**
 
 | Name                | Type                                                        | Mandatory| Description                                      |
-| -------------------- | -------------------- | ---- | ------------------ |
-| type                 | "BundleStatusChange" | Yes  | Event type.  |
-| bundleStatusCallback | BundleStatusCallback | Yes  | Callback to register.|
+| -------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------ |
+| type                 | string                                                       | Yes  | Event type. Only **BundleStatusChange** is supported.|
+| bundleStatusCallback | [BundleStatusCallback](js-apis-Bundle-BundleStatusCallback.md) | Yes  | Callback to register.                        |
 
 **Return value**
 
@@ -163,7 +163,7 @@ This is a system API and cannot be called by third-party applications.
 
 | Name    | Type                 | Mandatory| Description                                                |
 | -------- | --------------------- | ---- | ---------------------------------------------------- |
-| type     | "BundleStatusChange"  | Yes  | Event type.                                    |
+| type     | string | Yes  | Event type. Only **BundleStatusChange** is supported.              |
 | callback | AsyncCallback\<string> | Yes  | Callback used to return a successful result or error information.|
 
 ## innerBundleManager.off
@@ -187,8 +187,8 @@ This is a system API and cannot be called by third-party applications.
 **Parameters**
 
 | Name| Type  | Mandatory| Description                                      |
-| ---- | -------------------- | ---- | ---------------- |
-| type | "BundleStatusChange" | Yes  | Event type.|
+| ---- | ------ | ---- | ------------------------------------------ |
+| type | string | Yes  | Event type. Only **BundleStatusChange** is supported.|
 
 **Return value**
 

en/application-dev/reference/apis/js-apis-bundle-ElementName.md

 # ElementName
 
-The **ElementName** module provides the element name information.
+The **ElementName** module provides the element name information, which can be obtained through [Context.getElementName](js-apis-Context.md).
 
 > **NOTE**
 >
 > The initial APIs of this module are supported since API version 7. Newly added APIs will be marked with a superscript to indicate their earliest API version.
 
-## ElementName
+## ElementName<sup>(deprecated)<sup>
 
-**System capability**: SystemCapability.BundleManager.BundleFramework
+> This API is deprecated since API version 9. You are advised to use [ElementName](js-apis-bundleManager-elementName.md) instead.
+
+ **System capability**: SystemCapability.BundleManager.BundleFramework
 
 | Name                    | Type    | Readable| Writable| Description                      |
 | ----------------------- | ---------| ---- | ---- | ------------------------- |
 | deviceId                | string   | Yes  | Yes  | Device ID.                  |
 | bundleName              | string   | Yes  | Yes  | Bundle name of the application.                 |
 | abilityName             | string   | Yes  | Yes  | Name of the ability.              |
-| uri                     | string   | Yes  | Yes  | URI.                 |
+| uri                     | string   | Yes  | Yes  | Resource ID.                |
 | shortName               | string   | Yes  | Yes  | Short name of the ability.              |
 | moduleName<sup>9+</sup> | string   | Yes  | Yes  | Name of the HAP file to which the ability belongs.  |
+
+<!--no_check-->
\ No newline at end of file

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

+# Color Space Management
+
+The **colorSpaceManager** module provides APIs for creating and managing color space objects and obtaining basic color space attributes.
+
+> **NOTE**
+>
+> The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.
+
+## Modules to Import
+
+```js
+import colorSpaceManager from '@ohos.graphics.colorSpaceManager';
+```
+
+## ColorSpace
+
+Enumerates the color space types.
+
+**System capability**: SystemCapability.Graphic.Graphic2D.ColorManager.Core
+
+| Name                        | Value    | Description                   |
+| --------------------------- | ------ | ----------------------- |
+| UNKNOWN        | 0      | Unknown type.|
+| ADOBE_RGB_1998 | 1      | Adobe RGB (1998).|
+| DCI_P3         | 2      | DCI-P3.|
+| DISPLAY_P3     | 3      | Display P3.|
+| SRGB           | 4      | SRGB.<br>This is the default color space type.|
+| CUSTOM         | 5      | Custom type.|
+
+## ColorSpacePrimaries
+
+Defines the color space primaries. A color space is defined by chromaticity coordinates of the red, green, and blue additive primaries, the white point, and the gamma.
+
+**System capability**: SystemCapability.Graphic.Graphic2D.ColorManager.Core
+
+| Name                         | Type| Readable| Writable| Description                                                        |
+| ---------------------------- | -------- | ---- | ---- | ----------------------------------------------------- |
+| redX                         | number   | Yes  | Yes  | X coordinate of the red color in the color space.|
+| redY                         | number   | Yes  | Yes  | Y coordinate of the red color in the color space.|
+| greenX                       | number   | Yes  | Yes  | X coordinate of the green color in the color space.|
+| greenY                       | number   | Yes  | Yes  | Y coordinate of the green color in the color space.|
+| blueX                        | number   | Yes  | Yes  | X coordinate of the blue color in the color space.|
+| blueY                        | number   | Yes  | Yes  | Y coordinate of the blue color in the color space.|
+| whitePointX                  | number   | Yes  | Yes  | X coordinate of the white point in the color space.|
+| whitePointY                  | number   | Yes  | Yes  | Y coordinate of the white point in the color space.|
+
+## colorSpaceManager.create
+
+create(colorSpaceName: ColorSpace): ColorSpaceManager
+
+Creates a standard color space object.
+
+**System capability**: SystemCapability.Graphic.Graphic2D.ColorManager.Core
+
+**Parameters**
+
+| Parameter          | Type                    | Mandatory| Description                         |
+| --------------- | ------------------------ | ---- | -----------------------------|
+| colorSpaceName  | [ColorSpace](#colorspace)| Yes  | Type of the color space.<br>**UNKNOWN** and **CUSTOM** cannot be used when creating standard color space objects.         |
+
+**Return value**
+
+| Type               | Description                    |
+| ------------------ | ------------------------ |
+| [ColorSpaceManager](#colorspacemanager)  | Color space object created.              |
+
+**Example**
+
+```js
+let colorSpace = null;
+try {
+    colorSpace = colorSpaceManager.create(colorSpaceManager.ColorSpace.SRGB);
+} catch (err) {
+    console.log(`Failed to create SRGB colorSpace. Cause: ` + JSON.stringify(err));
+}
+```
+
+## colorSpaceManager.create
+
+create(primaries: ColorSpacePrimaries, gamma: number): ColorSpaceManager
+
+Creates a custom color space object.
+
+**System capability**: SystemCapability.Graphic.Graphic2D.ColorManager.Core
+
+**Parameters**
+
+| Parameter          | Type                                      | Mandatory| Description                         |
+| --------------- | ------------------------------------------ | ---- | -----------------------------|
+| primaries       | [ColorSpacePrimaries](#colorspaceprimaries)| Yes  | Primaries of the color space.              |
+| gamma           | number                                     | Yes  | Gamma of the color space.                |
+
+**Return value**
+
+| Type               | Description                    |
+| ------------------ | ------------------------ |
+| [ColorSpaceManager](#colorspacemanager)  | Color space object created.<br>The color space type is **CUSTOM** of [ColorSpace](#colorspace).|
+
+**Example**
+
+```js
+let colorSpace = null;
+try {
+    let primaries = {
+        redX: 0.1,
+        redY: 0.1,
+        greenX: 0.2,
+        greenY: 0.2,
+        blueX: 0.3,
+        blueY: 0.3,
+        whitePointX: 0.4,
+        whitePointY: 0.4
+    };
+    let gamma = 2.2;
+    colorSpace = colorSpaceManager.create(primaries, gamma);
+} catch (err) {
+    console.log(`Failed to create colorSpace with customized primaries and gamma. Cause: ` + JSON.stringify(err));
+}
+```
+
+## ColorSpaceManager
+
+Implements management of color space objects.
+
+Before calling any of the following APIs, you must use [create()](#colorspacemanagercreate) to create a color space object.
+
+### getColorSpaceName
+
+getColorSpaceName(): ColorSpace
+
+Obtains the color space type.
+
+**System capability**: SystemCapability.Graphic.Graphic2D.ColorManager.Core
+
+**Return value**
+
+| Type               | Description                    |
+| ------------------ | ------------------------ |
+| [ColorSpace](#colorspace)  | Color space type.|
+
+**Example**
+
+```js
+try {
+    let csType = colorSpace.getColorSpaceName();
+} catch (err) {
+    console.log(`Fail to get colorSpace's name. Cause: ` + JSON.stringify(err));
+}
+```
+
+### getWhitePoint
+
+getWhitePoint(): Array\<number\>
+
+Obtains the coordinates of the white point of the color space.
+
+**System capability**: SystemCapability.Graphic.Graphic2D.ColorManager.Core
+
+**Return value**
+
+| Type               | Description                    |
+| ------------------ | ------------------------ |
+| Array\<number\>  | Coordinates [x, y] of the white point.|
+
+**Example**
+
+```js
+try {
+    let wp = colorSpace.getWhitePoint();
+} catch (err) {
+    console.log(`Failed to get white point. Cause: ` + JSON.stringify(err));
+}
+```
+
+### getGamma
+
+getGamma(): number
+
+Obtains the gamma of the color space.
+
+**System capability**: SystemCapability.Graphic.Graphic2D.ColorManager.Core
+
+**Return value**
+
+| Type               | Description                    |
+| ------------------ | ------------------------ |
+| number  | Gamma of the color space.|
+
+**Example**
+
+```js
+try {
+    let gamma = colorSpace.getGamma();
+} catch (err) {
+    console.log(`Failed to get gamma. Cause: ` + JSON.stringify(err));
+}
+```

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

@@ -47,8 +47,9 @@ Starts an ability with the **want** parameter. This API uses an asynchronous cal
 
   ```js
     let want = {
-      "bundleName": "com.example.myapp",
-      "abilityName": "MyAbility"};
+        'bundleName': 'com.example.myapp',
+        'abilityName': 'MyAbility'
+    };
     this.context.startAbility(want, (err) => {
         console.log('startAbility result:' + JSON.stringify(err));
     });
@@ -79,8 +80,8 @@ Starts an ability with the mandatory **want** and optional **options** parameter
 
   ```js
     let want = {
-        "bundleName": "com.example.myapp",
-        "abilityName": "MyAbility"
+        'bundleName': 'com.example.myapp',
+        'abilityName': 'MyAbility'
     };
     this.context.startAbility(want).then((data) => {
         console.log('success:' + JSON.stringify(data));
@@ -110,15 +111,15 @@ Starts an ability with the **want** and **options** parameters. This API uses an
 
   ```js
   var want = {
-  	"deviceId": "",
-  	"bundleName": "com.extreme.test",
-  	"abilityName": "MainAbility"
+  	'deviceId': '',
+  	'bundleName': 'com.extreme.test',
+  	'abilityName': 'MainAbility'
   };
   var options = {
   	windowMode: 0,
   };
   this.context.startAbility(want, options, (error) => {
-    console.log("error.code = " + error.code)
+      console.log('error.code = ' + error.code)
   })
   ```
 

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

@@ -73,7 +73,7 @@ Takes a screenshot and saves it as a **PixelMap** object. This API uses an async
 **Example**
 
   ```js
-  var screenshotOptions = {
+  let screenshotOptions = {
     "screenRect": {
         "left": 200,
         "top": 100,
@@ -85,14 +85,18 @@ Takes a screenshot and saves it as a **PixelMap** object. This API uses an async
     "rotation": 0,
     "displayId": 0
   };
+  try {
     screenshot.save(screenshotOptions, (err, pixelMap) => {
       if (err) {
-        console.log('Failed to save screenshot: ' + JSON.stringify(err));
+          console.log('Failed to save screenshot. Code: ' + JSON.stringify(err));
           return;
       }
       console.log('Succeeded in saving sreenshot. Pixel bytes number: ' + pixelMap.getPixelBytesNumber());
       pixelMap.release(); // Release the memory in time after the PixelMap is used.
     });
+  } catch (exception) {
+    console.error('Failed to save screenshot. Code: ' + JSON.stringify(exception));
+  };
   ```
 
 ## screenshot.save
@@ -114,14 +118,18 @@ Takes a screenshot and saves it as a **PixelMap** object. This API uses an async
 **Example**
 
   ```js
+  try {
     screenshot.save((err, pixelMap) => {
       if (err) {
-        console.log('Failed to save screenshot: ' + JSON.stringify(err));
+          console.log('Failed to save screenshot. Code: ' + JSON.stringify(err));
           return;
       }
       console.log('Succeeded in saving sreenshot. Pixel bytes number: ' + pixelMap.getPixelBytesNumber());
       pixelMap.release(); // Release the memory in time after the PixelMap is used.
     });
+  } catch (exception) {
+    console.error('Failed to save screenshot. Code: ' + JSON.stringify(exception));
+  };
   ```
 
 ## screenshot.save
@@ -149,7 +157,7 @@ Takes a screenshot and saves it as a **PixelMap** object. This API uses a promis
 **Example**
 
   ```js
-  var screenshotOptions = {
+  let screenshotOptions = {
   	"screenRect": {
   		"left": 200,
   		"top": 100,
@@ -161,11 +169,15 @@ Takes a screenshot and saves it as a **PixelMap** object. This API uses a promis
   	"rotation": 0,
   	"displayId": 0
   };
+  try {
     let promise = screenshot.save(screenshotOptions);
     promise.then((pixelMap) => {
         console.log('Succeeded in saving sreenshot. Pixel bytes number: ' + pixelMap.getPixelBytesNumber());
         pixelMap.release(); // Release the memory in time after the PixelMap is used.
     }).catch((err) => {
-      console.log('Failed to save screenshot: ' + JSON.stringify(err));
+        console.log('Failed to save screenshot. Code: ' + JSON.stringify(err));
     });
+  } catch (exception) {
+    console.error('Failed to save screenshot. Code: ' + JSON.stringify(exception));
+  };
   ```

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

@@ -31,8 +31,8 @@ Zips a file. This API uses a promise to return the result.
 **Return value**
 
 | Type          | Description                                                        |
-| -------------- | ---------------------------------------------------- |
-| Promise\<void> | Returns **ERROR_CODE_OK** if the operation is successful; returns **ERROR_CODE_ERRNO** otherwise.|
+| -------------- | ------------------------------------------------------------ |
+| Promise\<void> | Returns [ERROR_CODE_OK](#ziperrorcode) if the operation is successful.<br>Returns [ERROR_CODE_ERRNO](#ziperrorcode) if the operation fails.|
 
 **Example 1**
 
@@ -96,7 +96,7 @@ Unzips a file. This API uses a promise to return the result.
 
 | Type          | Description                                                        |
 | -------------- | ------------------------------------------------------------ |
-| Promise\<void> | Returns **ERROR_CODE_OK** if the operation is successful; returns **ERROR_CODE_ERRNO** otherwise.|
+| Promise\<void> | Returns [ERROR_CODE_OK](#ziperrorcode) if the operation is successful.<br>Returns [ERROR_CODE_ERRNO](#ziperrorcode) if the operation fails.|
 
 **Example**
 

en/application-dev/reference/errorcodes/errorcode-display.md

+# Display Error Codes
+
+## 1400001 Invalid Display or Screen
+**Error Message**
+Invalid display or screen.
+
+**Description**
+This error code is reported when an invalid display, including a virtual screen, is operated.
+
+**Possible Causes**
+1. The virtual screen has not been created.
+2. The virtual screen has been destroyed.
+
+**Procedure**
+1. Before operating the virtual screen, check whether the virtual screen has been created.
+2. Check whether the virtual screen has been destroyed.
+
+## 1400002 Unauthorized Operation
+**Error Message**
+Unauthorized operation.
+
+**Description**
+This error code is reported when the API does not have the required permissions to operate an object.
+
+**Possible Causes**
+The virtual screen object of another process is operated.
+
+**Procedure**
+Check whether unauthorized operations are performed on the object of another process. If yes, delete the operations.
+
+## 1400003 Abnormal Display Manager Service
+**Error Message**
+This display manager service works abnormally.
+
+**Description**
+This error code is reported when the display manager service is abnormal.
+
+**Possible Causes**
+1. The display manager service is not started normally.
+2. The bottom-layer graphics synthesis and rendering are abnormal.
+
+**Procedure**
+Try again later or restart the device.

en/application-dev/reference/errorcodes/errorcode-window.md

+# Window Error Codes
+
+## 1300001 Repeated Operation
+**Error Message**
+Repeated operation.
+
+**Description**
+This error code is reported when a repeated operation is performed.
+
+**Possible Causes**
+The window to create already exists.
+
+**Procedure**
+Before creating a window, check whether the window already exists. If it already exists, use it directly.
+
+## 1300002 Abnormal Window State
+**Error Message**
+This window state is abnormal.
+
+**Description**
+This error code is reported when you operate a window in an abnormal state, for example, a window that has been destroyed.
+
+**Possible Causes**
+The window has been destroyed when being operated.
+
+**Procedure**
+Before operating the window, check whether it exists.
+
+## 1300003 Abnormal Window Manager Service
+**Error Message**
+This window manager service works abnormally.
+
+**Description**
+This error code is reported when the window manager service is abnormal.
+
+**Possible Causes**
+The internal services of the window are not started normally.
+
+**Procedure**
+Try again later or restart the device.
+
+## 1300004 Unauthorized Operation
+**Error Message**
+Unauthorized operation.
+
+**Description**
+This error code is reported when the API does not have the required permissions to operate an object.
+
+**Possible Causes**
+The window object of another process is operated.
+
+**Procedure**
+Check whether unauthorized operations are performed on the object of another process. If yes, delete the operations.
+
+## 1300005 Abnormal Window Stage
+**Error Message**
+This window stage is abnormal.
+
+**Description**
+This error code is reported when you operate a window stage in the abnormal state, for example, a window stage that has been destroyed.
+
+**Possible Causes**
+The window stage has been destroyed when being operated.
+
+**Procedure**
+Before operating a window stage, check whether it exists.
+
+## 1300006 Abnormal Window Context
+**Error Message**
+This window context is abnormal.
+
+**Description**
+This error code is reported when you operate a window context in the abnormal state, for example, a window context that has been destroyed.
+
+**Possible Causes**
+The window context has been destroyed when being operated.
+
+**Procedure**
+Before operating the window context, check whether it exists.

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

@@ -2,8 +2,9 @@
 
 - Access Control  
   - [Access Control (Permission) Overview](accesstoken-overview.md)
-  - [Guide for Requesting Permissions from User](accesstoken-guidelines.md)
-  - [Application Permission List](permission-list.md)
+  - [Permission Application Guide](accesstoken-guidelines.md)
+  - [Permission Verification Guide](permission-verify-guidelines.md)
+  - [App Permission List](permission-list.md)
 - User Authentication
   - [User Authentication Overview](userauth-overview.md)
   - [User Authentication Development](userauth-guidelines.md)

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

-# Guide for Requesting Permissions from User
+# Permission Application Guide
 
 ## When to Use
 
@@ -115,7 +115,7 @@ The permission level of **ohos.permission.PERMISSION2** is **system_basic**, whi
 
 In addition to declaring all the permissions in the configuration file, you must declare the permissions whose levels are higher that the app's APL in the app's profile. For details about the fields in the profile, see [HarmonyAppProvision Configuration File](../quick-start/app-provision-structure.md).
 
-In this example, declare the permission under the **acls** field:
+For example, declare the required permission in the **acls** field:
 
 ```json
 {

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

 # Access Control (Permission) Overview
 
-AccessTokenManager (ATM) implements unified app permission management based on access tokens on OpenHarmony.
+OpenHarmony AccessTokenManager (ATM) implements unified app permission management based on access tokens.
 
-By default, apps can access limited system resources. However, in some cases, an app needs to access excess data (including personal data) and functions of the system or another app to implement extended functions. The system or apps must also share their data or functions through interfaces in an explicit manner. OpenHarmony uses app permissions to perform access control and prevent improper or malicious use of these data or functions.
+By default, apps can access limited system resources. However, in some cases, an app needs to access excess data (including personal data) and functions of the system or another app to implement extended functions. The system or apps must also explicitly share their data or functions through APIs. OpenHarmony uses app permissions to perform access control and prevent improper or malicious use of these data or functions.
 
 App permissions are used to protect the following objects:
 
@@ -11,7 +11,7 @@ App permissions are used to protect the following objects:
 
 Without the required permissions, an app cannot access or perform operations on the target object. Permissions must be clearly defined for apps. With well-defined app permissions, the system can standardize the behavior of apps and protect user privacy. Before an app accesses the target object, the target object verifies the app's permissions and denies the access if the app does not have required permissions.
 
-Currently, ATM verifies app permissions based on the token identity (Token ID). A token ID identifies an app. The ATM manages app permissions based on the app's token ID.
+Currently, ATM verifies app permissions based on the token identity (token ID). A token ID identifies an app. ATM manages app permissions based on the app's token ID.
 
 ## Basic Principles for Permission Management
 
@@ -19,37 +19,52 @@ Observe the following principles for permission management:
 
 - Provide clear description about the app functions and scenarios for each permission required by the app so that users can clearly know why and when these permissions are required. Do not induce or mislead users' authorization. The permissions on an app must comply with the description provided in the app.
 - Use the principle of least authority for user permissions. Allow only necessary permissions for service functions.
-- When an app is started for the first time, avoid frequently displaying dialog boxes to request permissions. Allow the app to apply for permissions only when it needs to use the corresponding service functions.
-- If a user rejects to authorize a permission, the user can still use functions irrelevant to this permission and can register and access the app.
+- When an app is started for the first time, avoid frequently displaying dialog boxes to request multiple permissions. Allow the app to apply for the permission only when it needs to use the corresponding service function.
+- If a user rejects to grant a permission, the user can still use functions irrelevant to this permission and can register and access the app.
 - Provide no more message if a user rejects the authorization required by a function. Provide onscreen instructions to direct the user to grant the permission in **Settings** if the user triggers this function again or needs to use this function.
 
-- All the permissions granted to apps must come from the [Permission List](permission-list.md). Custom permissions are not allowed for apps currently.
+- All the permissions granted to apps must come from the [App Permission List](permission-list.md). Custom permissions are not allowed for apps currently.
 
-## Permission Workflow
+## Permission Workflows
 
-Determine the permissions required for an app to access data or perform an operation. Declare the required permissions in the app installation package.
+### Permission Application and Use
 
-Determine whether the required permissions need to be authorized by users. If yes, provide a dialog box dynamically to request user authorization.
+Determine the permissions required by an app, and declare the required permissions in the app installation package.
 
-After the user grants permissions to the app, the app can access the data or perform the operation.
+Determine whether the required permissions need user authorization. If yes, display a dialog box dynamically to request user authorization.
 
-The figure below shows the permission workflow.
+After the user grants the permissions, the app can access the data or perform the operation.
+
+The figure below illustrates the process.
 
 ![](figures/permission-workflow.png)
 
-1. You can refer to the figure below to determine whether an app can apply for a permission.
+1. Refer to the figure below to determine whether an app can apply for a permission.
 
 ![](figures/permission-application-process.png)
 
 1. See [Permission Levels](#permission-levels) for details about the mapping between the application Ability Privilege Level (APL) and permission level.
 
-2. The permission authorization modes include user_grant (permission granted by the user) and system_grant (permission granted by the system). For details, see [Permission Authorization Modes](#permission-authorization-mode).
+2. The permission authorization modes include user_grant (permission granted by the user) and system_grant (permission granted by the system). For details, see [Permission Types](#permission-types).
+
+3. A low-APL app can have a high-level permission by using the Access Control List (ACL). For details, see [ACL](#acl).
+
+### Permission Verification
+To protect sensitive data and eliminate security threads on core abilities, you can use the permissions in the [App Permission List](permission-list.md) to protect the related API from unauthorized calling. Each time before the API is called, a permission verification is performed to check whether the caller has the required permission. The API can be called only after the permission verification is successful.
+
+The figure below shows the permission verification process.
+
+![](figures/permission-verify-process.png)
 
-3. A low-level app can have a high-level permission by using the Access Control List (ACL). For details, see [ACL](#acl).
+1: An app permission can be used to control the access to an API that has sensitive data involved or security threats on the core abilities.
+
+2: Select the permission from the [App Permission List](permission-list.md). For example, if contact information is involved in an API provided by an app, you can use the contact-related permissions to protect the API.
+
+3: Use **verifyAccessToken()** to check whether the caller has the required permission. For details, see [Permission Verification Guide](permission-verify-guidelines.md).
 
 ## Permission Levels
 
-To protect user privacy, ATM defines different permission levels based on the sensitivity of the data involved or the security threat of the ability.
+ATM defines different permission levels based on the sensitivity of the data involved or the security threat of the ability to protect user privacy.
 
 ### App APLs
 
@@ -59,21 +74,21 @@ The table below describes the APLs.
 
 | APL         | Description                                  |
 | ---------------- | -------------------------------------- |
-| system_core | The apps of this level provide core abilities of the operating system.|
+| system_core | The apps of this level provide core abilities of the operating system (OS). |
 | system_basic| The apps of this level provide basic system services.    |
 | Normal      | The apps of this level are normal apps.                            |
 
-By default, apps are of the normal APL.
+The default APL of apps is **normal**.
 
-For the app of the system_basic or system_core APL, declare the APL in the **apl** field of **bundle-info** in the app's profile when developing the application installation package.
+To set an app's APL to **system_basic** or **system_core**, declare the APL in the **apl** field of **bundle-info** in the app's profile when developing the app's installation package.
 
 Then, use the [hapsigner](hapsigntool-overview.md) tool to generate a certificate or use DevEco Studio to [have your app automatically signed](https://developer.harmonyos.com/en/docs/documentation/doc-guides/ohos-auto-configuring-signature-information-0000001271659465#section161281722111).
 
-> **CAUTION**<br>The method of declaring the app's APL in its profile applies only to the application or service in debug phase. For a commercial app, apply for a release certificate and profile in the corresponding app market.
+> **CAUTION**<br>The method of changing the app's APL in its profile applies only to the app or service in debug mode. For a commercial app, apply for a release certificate and profile in the corresponding app market.
 
 The following is an example.
 
-This example shows only the modification of the **apl** field. Set other fields based on service requirements. For details about the fields in the profile, see [HarmonyAppProvision Configuration File](../quick-start/app-provision-structure.md).
+This example shows only the modification of the **apl** field. Set other fields based on your requirements. For details about the fields in the profile, see [HarmonyAppProvision Configuration File](../quick-start/app-provision-structure.md).
 
 ```json
 {
@@ -100,17 +115,17 @@ The permissions open to apps vary with the permission level. The permission leve
 
 - **system_basic**
 
-    The system_basic permission allows access to resources related to basic operating system services. The basic services are basic functions provided or preconfigured by the system, such as system setting and identity authentication. Access to these resources may have considerable risks to user privacy and other apps.
+    The system_basic permission allows access to resources related to basic OS services. The basic services are basic functions provided or preconfigured by the system, such as system settings and identity authentication. Access to these resources may have considerable risks to user privacy and other apps.
 
     The permissions of this level are available only to apps of the system_basic or system_core APL.
 
 - **system_core**
 
-    The system_core permission allows access to core resources of the operating system. These resources are the underlying core services of the system. If these resources are corrupted, the OS cannot run properly.
+    The system_core permission allows access to core resources of the OS. These resources are underlying core services of the system. If these resources are corrupted, the OS cannot run properly.
     
-    The permissions of this type are not open to third-party apps currently.
+    The system_core permissions are not open to third-party apps currently.
 
-## Permission Authorization Modes
+## Permission Types
 
 Permissions can be classified into the following types based on the authorization mode:
 
@@ -126,65 +141,70 @@ Permissions can be classified into the following types based on the authorizatio
 
     This type of permissions must be declared in the app installation package and authorized by users dynamically during the running of the app. The app has the permission only after user authorization.
 
-    For example, in the [Permission List](permission-list.md), the permissions for the microphone and camera are user_grant. The list provides reasons for using the permissions.
+    For example, in the [App Permission List](permission-list.md), the permissions for microphones and cameras are user_grant. The list provides reasons for using the permissions.
 
     The user_grant permission list must also be presented on the details page of the app in the app store.
 
 ### Authorization Processes
 
-The process for an app obtaining the required permissions varies depending on the permission authorization mode.
+As described in [Permission Workflows](permission-workflows), you need to first apply for the required permissions for the app.
+
+- Applying for permissions
+
+   You need to [declare the required permissions](accesstoken-guidelines.md#declaring-permissions) in the configuration file.
 
-- For a system_grant permission, you need to [declare the permission](accesstoken-guidelines.md#declaring-permissions) in the configuration file. The permission will be pre-granted when the app is installed.
+- Authorizing permissions
 
-- For a user_grant permission, you need to [declare the permission](accesstoken-guidelines.md#declaring-permissions) in the configuration file and trigger user authorization through a dialog box during the running of the app.
+   - The system_grant permission will be pre-granted when the app is installed.
+   - For a user_grant permission, you need to trigger user authorization through a dialog box during the running of the app. For details, see [Requesting User Authorization](#requesting-user-authorization).
 
-### Permission Authorization Process (user_grant)
+### Requesting User Authorization
 
 The procedure is as follows:
 
 1. In the configuration file, declare the permissions required by the app. For details, see [Access Control Development](accesstoken-guidelines.md).
 
-2. Associate the object that requires the permissions in the app with the target permissions. In this way, the user knows the operations to be granted with the specified permissions.
+2. Associate the target objects in the app with the related permissions. This allows the users to know the operations that need user authorization.
 
-3. Check whether the user has granted the required permissions to the app when the app is running. If yes, the app can access the data or perform the operation. If the user has not granted the permissions to the app, display a dialog box requesting the user authorization when the app attempts to access the data.
+3. Use an API to dynamically trigger a dialog box requesting user authorization when the target object is accessed. The API first checks whether the user has granted the required permissions to the app. If yes, the app can access the data or perform the operation. Otherwise, a dialog box will be displayed to request user authorization.
 
-4. Check the user authorization result. Allow the next step only after the user has granted the permissions to the app.
+4. Check the user authorization result. Allow the subsequent operation only after the user has granted the permissions to the app.
 
 **Precautions**
 
 - Check the app's permission each time before the operation requiring the permission is performed.
-- To check whether a user has granted specific permissions to your app, use the [verifyAccessToken](../reference/apis/js-apis-abilityAccessCtrl.md) method. This method returns [PERMISSION_GRANTED](../reference/apis/js-apis-abilityAccessCtrl.md) or [PERMISSION_DENIED](../reference/apis/js-apis-abilityAccessCtrl.md). For details about the sample code, see [Access Control Development](accesstoken-guidelines.md).
-- Users must be able to understand and control the authorization of user_grant permissions. During the running process, the app requiring user authorization must proactively call the API to dynamically request the authorization. Then, the system displays a dialog box asking the user to grant the requested permission. The user will determine whether to grant the permission based on the running context of the app.
+- To check whether a user has granted specific permissions to an app, use the [verifyAccessToken](../reference/apis/js-apis-abilityAccessCtrl.md) method. This method returns [PERMISSION_GRANTED](../reference/apis/js-apis-abilityAccessCtrl.md) or [PERMISSION_DENIED](../reference/apis/js-apis-abilityAccessCtrl.md). For details about the sample code, see [Access Control Development](accesstoken-guidelines.md).
+- Users must be able to understand and control the authorization of user_grant permissions. During the running process, the app requiring user authorization must proactively call an API to dynamically request the authorization. Then, the system displays a dialog box asking the user to grant the permission. The user will determine whether to grant the permission based on the running context of the app.
 - The permission authorized is not permanent, because the user may revoke the authorization at any time. Therefore, even if the user has granted the requested permission to the app, the app must check for the permission before calling the API controlled by this permission.
 
 ## ACL
 
 As described above, permission levels and app APLs are in one-to-one correspondence. In principle, **an app with a lower APL cannot apply for higher permissions by default**.
 
-The ACL makes low-level apps have high-level permissions.
+The ACL makes low-APL apps have high-level permissions.
 
 **Example**
 
-The APL of app A is normal. App A needs to have permission B (system_basic level) and permission C (normal level).
+The APL of app A is **normal**. App A needs to have permission B (system_basic level) and permission C (normal level).
 
 In this case, you can use the ACL to grant permission B to app A.
 
 For details, see [Using the ACL](#using-the-acl).
-For details about whether a permission can be enabled through the ACL, see the [Permission List](permission-list.md).
+For details about whether a permission can be enabled through the ACL, see the [App Permission List](permission-list.md).
 
 ### Using the ACL
 
-If the permission required by an app has higher level than the app's APL, you can use the ACL to grant the permissions required.
+If the permission required by an app has higher level than the app's APL, you can use the ACL to grant the permission required.
 
 In addition to the preceding [authorization processes](#authorization-processes), you must declare the ACL.
 
-In other words, in addition to declaring the required permissions in the app's configuration file, you must [declare the ACL](accesstoken-guidelines.md#declaring-the-acl) in the app's profile. The subsequent steps of authorization are the same.
+That is, you need to declare the required permissions in the app's configuration file, and [declare the ACL](accesstoken-guidelines.md#declaring-the-acl) in the app's profile. The subsequent steps of authorization are the same.
 
 **NOTICE**
 
-When developing an app installation package, you must declare the allowed ACLs in the **acls** field in the app's profile. Then, use the [hapsigner](hapsigntool-overview.md) tool to generate a certificate.
+When developing an app installation package, you must declare the ACL in the **acls** field in the app's profile. Then, use the [hapsigner](hapsigntool-overview.md) tool to generate a certificate.
 
-> **CAUTION**<br>The method of declaring the app's APL in its profile applies only to the application or service in debug phase. For a commercial app, apply for a release certificate and profile in the corresponding app market.
+> **CAUTION**<br>The method of changing the app's APL in its profile applies only to the app or service in debug mode. For a commercial app, apply for a release certificate and profile in the corresponding app market.
 
 ```json
 {

en/application-dev/security/permission-list.md

-# Application Permission List
+# App Permission List
 
-Before applying for required permissions, read and understand the [permission workflow](accesstoken-overview.md#permission-workflow). Then, determine whether the app can apply for the target permissions based on the table below.
+Before applying for required permissions, read and understand the [permission workflows](accesstoken-overview.md#permission-workflows). Then, determine whether the app can apply for the target permissions based on the table below.
 
-For details about permission usage examples, see [Access Control Development](accesstoken-guidelines.md).
+For details about permission usage examples, see [Permission Application Guide](accesstoken-guidelines.md).
 
 | Permission                                                  | APL    | Authorization Mode    | Enable ACL| Description                                                    |
 | -------------------------------------------------------- | ------------ | ------------ | ------- | ------------------------------------------- |

en/application-dev/security/permission-verify-guidelines.md

+# Permission Verification Guide
+
+## When to Use
+
+To protect sensitive data and eliminate security threads on core abilities, you can use the permissions in the [App Permission List](permission-list.md) to protect the related API from unauthorized calling. Each time before the API is called, a permission verification is performed to check whether the caller has the required permission.
+
+## Available APIs
+
+The table below lists only the API used in this guide. For more information, see [AbilityContext](../reference/apis/js-apis-ability-context.md).
+
+| API                                                      | Description                                            |
+| ------------------------------------------------------------ | --------------------------------------------------- |
+| verifyAccessToken(tokenID: number, permissionName: string): Promise<GrantStatus> | Checks whether an application process has the specified permission.|
+
+
+## Example
+
+The procedure is as follows:
+
+1. Obtain the caller's identity (**tokenId**).
+2. Determine the permission to verify, which is **ohos.permission.PERMISSION** in this example.
+3. Call **verifyAccessToken()** to perform a permission verification of the caller.
+4. Proceed based on the permission verification result.
+
+```js
+  import abilityAccessCtrl from '@ohos.abilityAccessCtrl'
+  import rpc from '@ohos.rpc'
+
+  class Stub extends rpc.RemoteObject {
+      onRemoteRequest(code, data, reply, option) {
+          let callerTokenId = rpc.IPCSkeleton.getCallingTokenId();
+          console.log("RpcServer: getCallingTokenId result: " + callerTokenId);
+          var atManager = abilityAccessCtrl.createAtManager();
+          var result = await atManager.verifyAccessToken(tokenID, "ohos.permission.PERMISSION");
+          if (result == abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED) {
+            // Allow the caller to invoke the API provided by the app.
+          } else {
+            // Deny the caller's access to the API.
+          }
+          return true;
+      }
+  }
+
+```
+> **NOTE**<br>
+> You can use **getCallingTokenId** to obtain the caller's **tokenId**. For details, see [RPC](../reference/apis/js-apis-rpc.md#getcallingtokenid8).

zh-cn/application-dev/IDL/idl-guidelines.md

@@ -154,7 +154,11 @@ OpenHarmony IDL容器数据类型与Ts数据类型、C++数据类型的对应关
 ![SDKpath](./figures/SDKpath.png)
 ![SDKpath](./figures/SDKpath2.png)
 
-进入对应路径后，查看toolchains->3.x.x.x（对应版本号命名文件夹）下是否存在idl工具的可执行文件，若不存在，可对应版本前往[docs仓版本目录](https://gitee.com/openharmony/docs/tree/master/zh-cn/release-notes)下载SDK包，以[3.2Beta3版本](https://gitee.com/openharmony/docs/blob/master/zh-cn/release-notes/OpenHarmony-v3.2-beta3.md#%E4%BB%8E%E9%95%9C%E5%83%8F%E7%AB%99%E7%82%B9%E8%8E%B7%E5%8F%96)为例，可通过镜像站点获取。
+进入对应路径后，查看toolchains->3.x.x.x（对应版本号命名文件夹）下是否存在idl工具的可执行文件。
+
+> **注意**：请保证使用最新版的SDK，版本老旧可能导致部分语句报错。
+
+若不存在，可对应版本前往[docs仓版本目录](https://gitee.com/openharmony/docs/tree/master/zh-cn/release-notes)下载SDK包，以[3.2Beta3版本](https://gitee.com/openharmony/docs/blob/master/zh-cn/release-notes/OpenHarmony-v3.2-beta3.md#%E4%BB%8E%E9%95%9C%E5%83%8F%E7%AB%99%E7%82%B9%E8%8E%B7%E5%8F%96)为例，可通过镜像站点获取。
 
 关于如何替换DevEco Studio的SDK包具体操作，参考[full-SDK替换指南](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/full-sdk-switch-guide.md#full-sdk%E6%9B%BF%E6%8D%A2%E6%8C%87%E5%8D%97)中的替换方法。
 

zh-cn/application-dev/faqs/Readme-CN.md

 # 常见问题
 
+- [开发语言常见问题](faqs-language.md)
 - [Ability框架开发常见问题](faqs-ability.md)
+- [应用程序包管理开发常见问题](faqs-bundle.md)
+- [ArkUI组件（ArkTS）开发常见问题](faqs-ui-ets.md)
+- [ArkUI Web组件（ArkTS）开发常见问题](faqs-web-arkts.md)
 - [UI框架（JS）开发常见问题](faqs-ui-js.md)
-- [UI框架（ArkTS）开发常见问题](faqs-ui-ets.md)
+- [公共事件与通知开发常见问题](faqs-event-notification.md)
 - [图形图像开发常见问题](faqs-graphics.md)
 - [文件管理开发常见问题](faqs-file-management.md)
+- [媒体开发常见问题](faqs-media.md)
 - [网络与连接开发常见问题](faqs-connectivity.md)
 - [数据管理开发常见问题](faqs-data-management.md)
 - [设备管理开发常见问题](faqs-device-management.md)
+- [DFX开发常见问题](faqs-dfx.md)
+- [国际化开发常见问题](faqs-international.md)
 - [Native API使用常见问题](faqs-native.md)
 - [三四方库使用常见问题](faqs-third-party-library.md)
 - [IDE使用常见问题](faqs-ide.md)

zh-cn/application-dev/faqs/faqs-ability.md

 # Ability框架开发常见问题
 
-
-
 ## Stage模型中是否有类似FA模型的DataAbility的开发指导文档
 
 适用于：OpenHarmony SDK 3.2.3.5版本， API9 Stage模型
 
 Stage模型中DataShareExtensionAbility提供了向其他应用共享以及管理其数据的方法。
 
-参考文档：[数据共享开发指导](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/database/database-datashare-guidelines.md)
+参考文档：[数据共享开发指导](../database/database-datashare-guidelines.md)
 
-## 拉起Ability为什么在界面上没反应？
+## 拉起Ability在界面上没反应
 
 适用于：OpenHarmony SDK 3.2.5.3版本，API9 Stage模型
 
@@ -22,11 +20,37 @@ Stage模型中DataShareExtensionAbility提供了向其他应用共享以及管
 
 参考文档：[OpenHarmony版本转测试信息](https://gitee.com/openharmony-sig/oh-inner-release-management/blob/master/Release-Testing-Version.md)
 
-## 调用方法的时候，如何解决方法内部的this变成undefined？
+## 如何将Ability的UI界面设置成透明
+
+适用于：OpenHarmony SDK 3.2.3.5版本，API9 Stage模型
+
+将最上层容器组件背景色设置为透明，然后通过设置XComponent组件的opacity属性值为0.01来实现。
+
+  示例：
+
+```
+build() {
+  Stack() {
+    XComponent({
+    id: 'componentId',
+    type: 'surface',
+    })
+    .width('100%')
+    .height('100%')
+    .opacity(0.01)
+    // 页面内容
+  }
+  .width('100%')
+  .height('100%')
+  .backgroundColor('rgba(255,255,255, 0)')
+}
+```
+
+## 调用方法的时候，如何解决方法内部的this变成undefined
 
 适用于：OpenHarmony SDK 3.2.5.3版本，API9 Stage模型
 
-方式一：在调用方法的时候加上.bind(this)；
+方式一：在调用方法的时候加上.bind(this)。
 
 方式二：使用箭头函数。
 
@@ -36,9 +60,9 @@ Stage模型中DataShareExtensionAbility提供了向其他应用共享以及管
 
 Ability配置中缺少startWindowIcon属性配置，需要在module.json5中abilities中配置startWindowIcon。
 
-参考文档：[Stage模型配置文件](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/stage-structure.md)
+参考文档：[Stage模型配置文件](../quick-start/stage-structure.md)
 
-  示例：
+示例：
 
 ```
 {
@@ -59,4 +83,138 @@ Ability配置中缺少startWindowIcon属性配置，需要在module.json5中abil
 
 使用Ability的onConfigurationUpdated回调实现，系统语言、颜色模式以及Display相关的参数，比如方向、Density，发生变化时触发该回调。
 
-参考文档：[Ability开发指导](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/ability/stage-ability.md)
+参考文档：[Ability开发指导](../ability/stage-ability.md)
+
+## Stage模型是否推荐用globalThis去获取Context
+
+适用于：OpenHarmony SDK 3.2.5.5版本，API9 Stage模型
+
+不推荐，Stage模型使用globalThis去获取Context是错误的使用方式。在Stage模型中，整个应用进程共用一个js虚拟机实例，其中可以运行多个Ability实例，共用一个global对象。在同一个js虚拟机内的不同的Ability中使用globalThis获取Context，存在被覆盖从而发生错误的风险。
+
+推荐使用方式参考：[Stage模型和Context详细介绍](../ability/context-userguide.md#stage%E6%A8%A1%E5%9E%8B%E5%92%8Ccontext%E8%AF%A6%E7%BB%86%E4%BB%8B%E7%BB%8D)。
+
+## 如何在应用A中去获取应用B的Hap包的安装路径
+
+适用于：OpenHarmony SDK 3..0以上版本， API9 Stage模型
+
+首先需要申请系统权限，具体参看文档：[自动化签名](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-auto-configuring-signature-information-0000001271659465)。导入bundle模块，通过调用bundle.getApplicationInfo()接口，通过包名获取应用信息。然后通过application.moduleSourceDirs获取应用存储路径。
+
+## 调用方使用startAbilityForResult，被调用方如何返回数据
+
+适用于：OpenHarmony SDK3.0, API9 Stage模型
+
+被调用方使用AbilityContext.terminateSelfWithResult方法，销毁被调用方ability，传递参数给startAbilityForResult回调函数，具体用法请参考[AbilityContext](../reference/apis/js-apis-ability-context.md#abilitycontextterminateselfwithresult)
+
+## FA卡片上架后在用户的服务中心展示时可否触发生命周期，从而实现用户没有打开过FA应用的情况下获取到用户的登录信息？
+
+适用于：OpenHarmony SDK 3.2.5.5版本, API8 FA模型
+
+服务卡片在添加卡片后就触发了oncreat()生命周期，在不启用app的情况下也可以显示相关的用户信息-静默登录，但服务卡片目前要在app安装之后手动添加。
+
+## 如何获取context
+
+适用于：OpenHarmony SDK 3.2.7.5版本, API9 Stage模型
+
+在MainAbility.ts文件中可以直接使用this.context获取context，在组件页面中可以使用getContext(this)获取context。
+
+## 访问控制管理模块abilityAccessCtrl中grantUserGrantedPermission方法在API8语法校验提示未定义
+
+适用于：OpenHarmony SDK 3.0版本, API8 FA模型
+
+当前SDK有fullSDK和publicSDK两个版本，IDE默认下载的是publicSDK。其中，publicSDK版本不会包含系统API，如果要用系统API，需要使用fullSDK。具体参考[full-SDK替换指南](../quick-start/full-sdk-switch-guide.md)。
+
+## public sdk支持哪几种ExtensionAbility（ServiceExtensionAbility、FormExtensionAbility、DataShareExtensionAbility）
+
+适用于：OpenHarmony SDK 3.2.5.6版本， API9 Stage模型
+
+上述ExtensionAbility 中，public sdk 仅可以使用FormExtensionAbility。ServiceExtensionAbility和DataShareExtensionAbility 为系统接口，需要使用full sdk。
+
+Public SDK : 面向应用开发者提供，不包含需要使用系统权限的系统接口。
+
+Full SDK : 面向OEM厂商提供，包含了需要使用系统权限的系统接口。
+
+## 服务卡片无法循环播放gif图
+
+适用于：OpenHarmony SDK 3.2.5.6版本， API9 Stage模型
+
+目前暂不支持播放GIF图片。
+
+## 如何通过卡片点击实现业务登录场景
+
+适用于：OpenHarmony SDK 3.2.5.5版本， API9 Stage模型
+
+可以通过点击卡片拉起响应的Ability后，通过Ability来实现业务登录场景。
+
+## 如何跳转到设置中应用详情页面。
+
+使用于：OpenHarmony SDK 3.2.6.5版本
+
+参考如下代码实现，示例：
+
+
+```
+this.context.startAbility(
+{
+  action: "action.settings.app.info",
+  parameters: { "settingsParamBundleName": "your app bundlename" }
+})
+```
+
+## 如何监听屏幕旋转
+
+使用于：OpenHarmony SDK 3.2.5.5版本，API9 Stage模型
+
+参考如下代码实现，示例：
+
+
+```
+let listener = mediaquery.matchMediaSync('(orientation: landscape)')
+onPortrait(mediaQueryResult) {
+if (mediaQueryResult.matches) {
+// do something here
+    } else {
+// do something here
+    }
+}
+listener.on('change', onPortrait)
+```
+
+## 如何控制checkbox选中切换过程中阴影背景的大小
+
+使用于：OpenHarmony SDK 3.2.5.5版本，API9 Stage模型
+
+设置checkbox组件padding属性，可控制阴影大小
+
+## 如何设置卡片背景为透明
+
+适用：OpenHarmony SDK 3.2.5.5版本
+
+1. 在卡片根目录widget新建widget/resources/styles/default.json文件
+
+2. 在default.json中书写如下代码：
+
+```
+{  
+ "style": {   
+      "app_background": "#00000000"   
+   } 
+}
+```
+
+## FA卡片如何的传参和接参
+
+适用：OpenHarmony SDK 3.2.5.5版本
+
+使用featureAbility.getWant()和featureAbility.getContext()在json文件中router跳转发送数据，在js文件中用featureAblity方法接收
+
+## router.disableAlertBeforeBackPage和router.enableAlertBeforeBackPage怎么触发
+
+适用：OpenHarmony SDK 3.2.5.5版本
+
+需要满足两个条件
+
+1. router.disableAlertBeforeBackPage和router.enableAlertBeforeBackPage类似一个开关，disableAlertBeforeBackPage是返回上一级页面时关闭弹窗提示，enableAlertBeforeBackPage是打开弹窗提示，默认是关闭的，当你需要使用时，首先要在一个函数里面开启功能，然后再执行跳转
+
+2. 必须要使用系统的返回按键才能触发效果。
+
+<!--no_check--> 
\ No newline at end of file

zh-cn/application-dev/faqs/faqs-bundle.md

+# 应用程序包管理开发常见问题
+
+## 如何获取应用配置的versionCode和versionName
+
+适用于：OpenHarmony SDK 3.2.3.5版本，API9 Stage模型
+
+通过\@ohos.bundle模块buniple.getBundleInfo()接口获取包信息bundleInfo，然后分别通过bundleInfo.versionCode、bundleInfo.versionName
+
+参考文档：[Bundle模块](../reference/apis/js-apis-Bundle.md#bundlegetbundleinfo)
+
+## 如何获取应用自身的bundleName
+
+适用于：OpenHarmony SDK 3.2.3.5版本，API9 Stage模型
+
+通过可以context.abilityInfo.bundleName获取。
+
+参考文档：[AbilityContext](../reference/apis/js-apis-ability-context.md#%E5%B1%9E%E6%80%A7)、[AbilityInfo](../reference/apis/js-apis-bundle-AbilityInfo.md)
+
+## 如何获取应用图标
+
+适用于：OpenHarmony SDK 3.2.3.5版本，API9 Stage模型
+
+通过\@ohos.bundle模块 getAbilityIcon 接口获取，需要配置权限：ohos.permission.GET_BUNDLE_INFO。
+
+参考文档：[Bundle模块](../reference/apis/js-apis-Bundle.md#bundlegetbundleinfo)
+
+## 如何判断某个应用是否为系统应用
+
+使用于：OpenHarmony SDK 3.2.5.5版本，API9 Stage模型
+
+使用bundle模块的getApplicationInfo接口获取待检验的应用的ApplicaitonInfo，根据ApplicaitonInfo中systemApp字段判断，若为true，则是系统应用，否则为非系统应用。
+
+<!--no_check-->
\ No newline at end of file

zh-cn/application-dev/faqs/faqs-connectivity.md

 # 网络与连接开发常见问题
 
-
-
-## Post请求时，extraData支持哪几种的数据格式？
+## 网络请求中extraData支持哪几种的数据格式
 
 适用于：OpenHarmony SDK 3.2.2.5版本， API9 Stage模型
 
@@ -14,13 +12,13 @@ extraData代表发送请求的额外数据，支持如下数据：
 
 3. 开发者传入string对象，开发者需要自行编码，将编码后的string传入。
 
-## 如何理解http请求的错误码28？
+## 如何理解http请求的错误码28
 
 适用于：OpenHarmony SDK 3.2.2.5版本，API9 Stage模型
 
 错误码28代表CURLE_OPERATION_TIMEDOUT，操作超时。网络请求底层使用libcurl库，更多错误码可以查看相应文档。
 
-参考文档：[开发指南](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-http.md#response%E5%B8%B8%E7%94%A8%E9%94%99%E8%AF%AF%E7%A0%81)和[Curl错误码](https://curl.se/libcurl/c/libcurl-errors.html)
+参考文档：[开发指南](../reference/apis/js-apis-http.md#response%E5%B8%B8%E7%94%A8%E9%94%99%E8%AF%AF%E7%A0%81)和[Curl错误码](https://curl.se/libcurl/c/libcurl-errors.html)
 
 ## \@ohos.net.http.d.ts的response错误码返回6是什么意思？
 
@@ -28,4 +26,81 @@ extraData代表发送请求的额外数据，支持如下数据：
 
 6表示地址无法解析主机，可以尝试ping一下request中的url，确认是否可以ping通。
 
-更多错误码参考[Response常用错误码](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-http.md#response%E5%B8%B8%E7%94%A8%E9%94%99%E8%AF%AF%E7%A0%81)或者[Curl错误码](https://curl.se/libcurl/c/libcurl-errors.html)
+更多错误码参考[Response常用错误码](../reference/apis/js-apis-http.md#response%E5%B8%B8%E7%94%A8%E9%94%99%E8%AF%AF%E7%A0%81)或者[Curl错误码](https://curl.se/libcurl/c/libcurl-errors.html)
+
+## 调用camera拍摄的照片怎么上传到服务器
+
+适用于：所有版本
+
+具体开发参考文档：[上传下载](https://gitee.com/openharmony/app_samples/tree/master/Network/UploadDownload)
+
+## OpenHarmony的http接口如何设置cookie
+
+适用于：OpenHarmony SDK 3.2.6.5版本，API9 Stage模型
+
+HttpRequestOptions中的header是一个Object类型，可以直接在header里设置cookie，具体开发参考文档：[数据请求](../reference/apis/js-apis-http.md#request)。
+
+## http请求的官方示例代码里的extra data部分怎么写
+
+适用于：OpenHarmony SDK 3.2.6.5版本，API9 Stage模型
+
+1. 鼠标移到extraData, ctrl+鼠标左键，跳转到sdk中，里面有关于extraData的传参说明。可以发现文档中对extraData的定义是这样的 extraData?: string | Object,也就是extraData支持string 和 Object两种类型。
+
+2. 这两种写法都可以实现：
+  a.extraData:"data to send"；
+  b. extraData:{ data:"data to send", },
+
+## 设备连接wifi后，如何获取当前设备的IP地址
+
+适用于：OpenHarmony SDK 3.2.7.5版本，API9 Stage模型
+
+使用wifi模块获取ipInfo，然后转换为IP常用格式，注意wifi.getIpInfo()接口需要权限 ohos.permission.GET_WIFI_INFO。
+
+示例：
+
+  
+```
+import wifi from '@ohos.wifi'
+@Entry
+@Component
+struct Page {
+  @State ip: string = '点击获取ip'
+
+  resolveIP(ip) {
+    if (ip < 0 || ip > 0xFFFFFFFF) {
+      throw ("The number is not normal!");
+    }
+    return (ip >>> 24) + "." + (ip >> 16 & 0xFF) + "." + (ip >> 8 & 0xFF) + "." + (ip & 0xFF);
+  }
+
+  build() {
+    Row() {
+      Column() {
+        Text(this.ip)
+          .fontSize(50)
+          .fontWeight(FontWeight.Bold)
+          .onClick(()=>{
+            this.ip = this.resolveIP(wifi.getIpInfo().ipAddress)
+          })
+      }
+      .width('100%')
+    }
+    .height('100%')
+  }
+}
+```
+
+## 如何判断当前是否有网络
+
+适用于：OpenHarmony SDK 3.2.6.5版本，API9 Stage模型
+
+通过如下hasDefaultNet接口判断是否有网络，注意需要申请 ohos.permission.GET_NETWORK_INFO 权限
+
+  
+```
+connection.hasDefaultNet().then((has)=> {
+  console.log("hasDefaultNet " + JSON.stringify(has))
+})
+```
+
+<!--no_check-->
\ No newline at end of file

zh-cn/application-dev/faqs/faqs-data-management.md

@@ -16,6 +16,60 @@ PixelMap应该被转换成相应的ArrayBuffer再放进数据库。
 
 示例：
 
-```shell
+  
+```
  hdc_std file recv /data/app/el2/100/database/com.xxxx.xxxx/entry/db/test.db ./test.db
 ```
+
+## 数据库在系统层面是否有锁机制，开发过程中是否需要关系数据库加锁问题
+
+适用于：OpenHarmony SDK 3.2.5.5版本，API9 Stage模型
+
+系统提供的分布式数据服务、关系型数据库和首选项均有锁机制，开发者无需关注。
+
+## 数据库中加事务与不加事务的区别？
+
+适用于：所有版本
+
+在rdb中进行数据操作时，有可能会导致操作失败，出现意料之外的情况。当对数据库进行大量操作时，此种情况会导致部分数据操作失败，部分操作成功，导致部分数据丢失，可能会导致应用程序发生异常甚至崩溃。加事务后，则会将某一批操作组合成一个整体，要么同时成功，要么同时失败，则不会导致强关联的数据部分缺失的情况出现。
+
+## 关系型数据库rdb支持哪些数据类型?
+
+适用于：OpenHarmony SDK 3.0版本以上，API9 Stage模型
+
+关系型数据库rdb支持的数据类型有：number、string、boolean。其中number为数组类型，支持Double，Long，Float，Int，Int64，最大精度为十进制17位数字。
+
+## 如何查看数据库db文件
+
+适用于：OpenHarmony SDK 3.2.6.5版本，API9 Stage模型
+
+1. 执行 hdc_std shell 命令进入系统
+
+2. 找到绝对路径：/data/app/el2/<userId默认是100>/database/<bundleName>
+   或找到沙箱路径：
+
+   a. 执行 ps -ef | grep hapName 命令找到对应应用的进程ID，
+
+   b. 数据库沙箱路径为：/proc/<应用进程ID>/root/data/storage/el2/database/。
+
+3. 在数据库的绝对路径或者沙箱路径下执行 find ./ -name "\*.db" 即可找到数据库文件。
+
+## 如何存储长文本数据
+
+适用于：OpenHarmony SDK 3.2.5.5版本，API 9
+
+- 首选项Preferences数据中的Value为string类型时最大支持8192字节。
+
+- 分布式数据管理KV数据模型Value最大支持4M。
+
+参考文档：[首选项概述](../database/database-preference-overview.md)、[分布式数据服务概述](../database/database-mdds-overview.md)
+
+## Stage模型数据共享DataShare开发
+
+适用于：OpenHarmony SDK 3.2.5.5版本，API 9
+
+Stage模型DataShare不可与FA模型DataAbility混用，连接的服务端应用需使用DataShareExtensionAbility实现。
+
+参考文档：[数据共享开发指导](../database/database-datashare-guidelines.md)
+
+<!--no_check-->
\ No newline at end of file

zh-cn/application-dev/faqs/faqs-development-board.md

@@ -27,6 +27,7 @@
 适用于：IDE 3.0.0.991
 
 1. 给预览器新建Profile
+   
    ![zh-cn_image_0000001361254285](figures/zh-cn_image_0000001361254285.png)
 
 2. 新建Profile的具体参数可参考如下配置：
@@ -49,3 +50,4 @@
 连接需要认证的网络后，用浏览器打开任意网址就可以进入认证页面。
 
 如果开发板上没有浏览器，可以安装[浏览器Sample应用](https://gitee.com/openharmony/app_samples/tree/master/device/Browser)。
+<!--no_check-->
\ No newline at end of file

zh-cn/application-dev/faqs/faqs-device-management.md

 # 设备管理开发常见问题
 
-
-
 ## 如何获取设备的dpi值
 
 适用于：OpenHarmony SDK 3.2.2.5版本，API9 Stage模型
 
-导入@ohos.display包，通过getDefaultDisplay方法获取。
+导入\@ohos.display包，通过getDefaultDisplay方法获取。
 
 示例：
 
@@ -22,3 +20,32 @@ display.getDefaultDisplay((err, data) => {
   console.info('Test densityDPI:' + JSON.stringify(data.densityDPI)); 
 });
 ```
+
+## 如何获取当前运行设备类型（穿戴、平板等）
+
+适用于：OpenHarmony SDK 3.2.2.5版本，API9 Stage模型
+
+导入\@ohos.deviceInfo包，然后通过deviceInfo.deviceType获取设备类型。
+
+参考文档：[设备信息](../reference/apis/js-apis-device-info.md)
+
+## 如何获取设备系统版本
+
+适用于：OpenHarmony SDK 3.2.5.5版本，API9 Stage模型
+
+通过[deviceInfo](../reference/apis/js-apis-device-info.md)对象的osFullName属性获取设备系统版本。
+
+## OpenHarmony设备如何获取UDID？
+
+适用于：OpenHarmony SDK3.0, API9 Stage模型
+
+1、如果想获取连接设备的udid，可使用 hdc shell bm get --udid命令；
+
+2、如果想在代码中获得，参考文档 [udid](../reference/apis/js-apis-device-info.md) 。
+
+## 开发快捷键功能
+
+适用于：OpenHarmony SDK 3.2.6.5版本，API9 Stage模型
+
+快捷键功能开发请使用组合按键api，具体可参考[组合按键（InputConsumer）](../reference/apis/js-apis-inputconsumer.md)
+<!--no_check-->
\ No newline at end of file

zh-cn/application-dev/faqs/faqs-dfx.md

+# DFX开发常见问题
+
+## 程序打开直接崩溃了，如何定位问题
+
+使用于：OpenHarmony SDK 3.2.5.5版本
+
+1.通过业务日志打印，定位崩溃的代码位置。
+
+2.通过Crash文件查看报错信息，Crash文件路径是：/data/log/faultlog/faultlogger/。
+
+## UiTest测试框架无法获取控件问题
+
+使用于：OpenHarmony SDK 3.2.5.5版本
+
+检查系统配置项 persist.ace.testmode.enabled 是开启。
+
+通过hdc_std shell param get persist.ace.testmode.enabled 查看，若配置项为0，
+
+可通过命令hdc_std shell param set persist.ace.testmode.enabled 1 开启配置。
+
+
+## C++代码中hilog的格式参数类型为%d或者%s时，日志打印为何显示private
+
+直接使用%d、%s等格式化参数时，标准系统默认使用private替换真实数据进行打印，防止数据泄露。如果需要打印出真实数据，需要使用%{public}d替换%d或者%{public}s替换%s。
+
+## 如何解决hilog.debug日志无法打印
+
+适用于：OpenHarmony SDK 3.2.5.5版本，API9 Stage模型
+
+通过hdc_std命令 hdc_std shell hilog -b D开启调试开关
+
+## 应用如何打印日志是使用hilog还是console，hilog接口参数domain的设置范围是什么
+
+适用于：OpenHarmony SDK 3.2.2.5版本
+
+推荐使用[hilog日志系统](../reference/apis/js-apis-hilog.md)进行日志打印，接口参数domain的设置范围可以参考[开发指南](../reference/apis/js-apis-hilog.md#hilogisloggable)。
+
+## hilog日志打印长度限制是多少，是否可以配置 
+
+适用于：OpenHarmony SDK 3.2.2.5版本
+
+日志打印的长度限制为1024个字符，该长度不能配置。
+
+## hilog接口的tag参数是否支持用空格隔开的多个字符串
+
+适用于：OpenHarmony SDK 3.2.6.5版本，API9 Stage模型
+
+不支持。
+
+## hilog中没有使用{public}标识的数据，如何打印真实数据
+
+适用于：OpenHarmony SDK 3.2.6.5版本，API9 Stage模型
+
+使用命令：hdc_std shell hilog -p off
+<!--no_check--> 
\ No newline at end of file

zh-cn/application-dev/faqs/faqs-event-notification.md

+# 公共事件与通知开发常见问题
+
+## emitter数据大小限制
+
+适用于：OpenHarmony SDK 3.2.5.3版本，API9 Stage模型
+
+emitter数据大小限制不超过10240。
+
+## 如何实现点击Notification通知打开对应App 
+
+适用于：OpenHarmony SDK 3.2.5.5版本，API9 Stage模型
+
+通过配置Notification.publish发布通知接口的参数NotificationRequest中wantAgent属性实现
+
+参考文档：[Notification](../reference/apis/js-apis-notification.md#notificationpublish)、[WantAgent](../reference/apis/js-apis-wantAgent.md)
+
+示例：
+
+```
+import WantAgent from '@ohos.wantAgent';
+
+async function publishNotification() {
+  let wantAgentInfo = {
+    wants: [
+      {
+        bundleName: "com.example.notification",
+        abilityName: "MainAbility",
+      }
+    ],
+    operationType: WantAgent.OperationType.START_ABILITIES,
+    requestCode: 0,
+  }
+  const wantAgent = await WantAgent.getWantAgent(wantAgentInfo)
+  let contentType = Notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT;
+  await Notification.publish({
+    content: {
+      contentType: contentType,
+      normal: {
+        title: "测试标题",
+        text: "测试内容",
+      }
+    },
+    id: 1,
+    wantAgent: wantAgent
+  })
+  prompt.showToast({ message: "发送成功" })
+}
+```
+<!--no_check-->
\ No newline at end of file

zh-cn/application-dev/faqs/faqs-file-management.md

 # 文件管理开发常见问题
 
+## fileio.rmdir是递归删除吗？
 
+适用于：OpenHarmony SDK 3.2.6.3版本，API9 Stage模型
+
+是递归删除。
+
+
+## 如何实现如果文件不存在则创建文件
+
+适用于：OpenHarmony SDK 3.2.6.3版本，API9 Stage模型
+
+可以通过调用函数fileio.open(filePath, 0o100, 0o666)来实现，第二个参数0o100表示若文件不存在，则创建文件。使用该选项时必须指定第三个参数 mode。
+
+## 使用fileio进行文件复制，传入沙箱路径报错call fail callback fail, code: 202, data: json arguments illegal）
+
+适用于：OpenHarmony SDK 3.2.6.3版本，API9 Stage模型
+
+使用fileio模块进行文件复制时，文件路径前缀中不能以“file:///”开头。
+
+## fileIo将数据写入流文件writeSync接口，length传参问题
+
+适用于：OpenHarmony SDK 3.2.6.5版本，API9 Stage模型
+
+一个中文字符length为3，英文字符为1，当前buffer为string类型时，length项需要开发者手动换算；如果要写入全部内容，可直接忽略length项，length长度超长时会导致接口报错。
+
+## 如何读取应用沙箱之外的文件
+
+适用于：OpenHarmony SDK 3.2.6.5版本，API9 Stage模型
+
+fileio中接口入参为path时只能是从context获取到的本应用沙箱路径，若要访问其他路径的数据，如公共数据图片视频等，需要通过数据所有者打开文件返回fd进行操作。
+
+比如向mediaLibrary请求读取/写入某文件，然后通过打开代表特定文件的URI后返回的fd进行操作，操作步骤如下：
+
+1. 通过媒体查询获取文件fileAsset对象；
+
+2. 通过fileAsset.open方法返回的fd；
+
+3. 将fd作为fileIo接口参数进行文件读写操作；
+
+## 如何解决文件的中文内容乱码
+
+适用于：OpenHarmony SDK 3.2.5.5版本，API9 Stage模型
+
+读取文件内容的buffer数据后，通过util.TextDecoder对文件内容进行解码。
+
+示例：
+
+```
+import util from '@ohos.util' 
+async function readFile(path) { 
+  let stream = fileio.createStreamSync(path, "r+"); 
+  let readOut = await stream.read(new ArrayBuffer(4096)); 
+  let textDecoder = new util.TextDecoder("utf-8", { ignoreBOM: true }); 
+  let buffer = new Uint8Array(readOut.buffer)
+  let readString = textDecoder.decode(buffer, { stream: false }); 
+  console.log("[Demo] 读取的文件内容：" + readString); 
+}
+```
 
 ## 调用媒体库getAlbums方法，没有收到返回，也没有捕获到异常是为什么
 
@@ -34,3 +91,23 @@ getAlbums方法需要权限：ohos.permission.READ_MEDIA，从[OpenHarmony权限
      })
    }
    ```
+
+## 如何解决多次通过媒体库FetchFileResult获取文件应用崩溃 
+
+适用于：OpenHarmonySDK 3.2.5.5版本，API9 Stage模型
+
+通过FetchFileResult.close()方法，在FetchFileResult对象每次调用完，释放并使其失效。
+
+## 在Stage模型下调用mediaLibrary.getMediaLibrary()接口，IDE报错
+
+适用于：OpenHarmonySDK 3.25.5版本，API9 Stage模型
+
+Stage模型下，获取媒体库实例应该调用mediaLibrary.getMediaLibrary(context: Context)。
+
+## 调用mediaLibrary.getFileAssets()接口返回的内容如何排序
+
+适用于：OpenHarmonySDK 3.2.5.5版本，API9 Stage模型
+
+通过[MediaFetchOptions](../reference/apis/js-apis-medialibrary.md#mediafetchoptions7)对象参数里面的order属性进行排序。
+
+<!--no_check-->
\ No newline at end of file

zh-cn/application-dev/faqs/faqs-graphics.md

 # 图形图像开发常见问题
 
-
-
 ## 调用window实例的setSystemBarProperties接口时，设置isStatusBarLightIcon和isNavigationBarLightIcon属性不生效 
 
 适用于：OpenHarmony SDK 3.2.5.3版本，API9 Stage模型
@@ -13,3 +11,81 @@
 适用于：OpenHarmony SDK 3.2.3.5版本，API9 Stage模型
 
 导入\@ohos.window模块，开发者可以使用window.setSystemBarProperties()接口设置状态栏样式属性，达到自定义样式的效果。
+
+## 如何隐藏状态栏，实现沉浸式效果。
+
+适用于：OpenHarmony SDK 3.2.6.3版本，API9 Stage模型
+
+1. 可以在onWindowStageCreate方法获取windowClass对象。
+     
+   ```
+   onWindowStageCreate(windowStage) {
+     // Main window is created, set main page for this ability
+     console.log("[Demo] MainAbility onWindowStageCreate")
+     windowStage.getMainWindow((err, data) => {
+       if (err.code) {
+         console.error('Failed to obtain the main window.')
+         return;
+       }
+       // 获取到窗口对象
+       globalThis.windowClass = data; 
+     })
+   }
+   ```
+
+2. 设置窗口全屏，隐藏状态栏。
+     
+   ```
+    globalThis.windowClass.setFullScreen(isFullScreen, (err, data) => {
+     if (err.code) {
+       console.error('Failed to enable the full-screen mode. Cause:' + JSON.stringify(err));
+       return;
+     }
+       console.info('Succeeded in enabling the full-screen mode. Data: ' + JSON.stringify(data));
+     });
+   ```
+
+## 如何获取窗口的宽高信息
+
+适用于：OpenHarmony SDK 3.2.3.5版本，API9 Stage模型
+
+通过\@ohos.window模块，可以使用getProperties()接口获取窗口属性，然后通过窗口属性的windowRect获取窗口宽高信息
+
+示例：
+
+  
+```
+let promise = windowClass.getProperties();
+promise.then((data)=> {
+  console.info('Succeeded in obtaining the window properties. Data: ' + JSON.stringify(data.windowRect));
+}).catch((err)=>{
+  console.error('Failed to obtain the window properties. Cause: ' + JSON.stringify(err));
+});
+```
+
+## 如何设置系统状态栏颜色
+
+适用于：OpenHarmony SDK 3.2.5.5版本，API9 Stage模型
+
+参考如下方式实现，示例：
+
+  
+```
+window.getTopWindow(globalThis.mainContext).then(win => {
+  var systemBarProperties = {
+    statusBarColor: '#19B6FF', // 状态栏背景颜色
+    navigationBarColor: '#19B6FF', // 导航栏背景颜色
+    isStatusBarLightIcon: false, // 状态栏图标是否为高亮状态。
+    isNavigationBarLightIcon: true, // 导航栏图标是否为高亮状态。
+    statusBarContentColor: '#0D0500', // 状态栏文字颜色
+    navigationBarContentColor: '#FFA500' // 导航栏文字颜色
+  };
+  win.setSystemBarProperties(systemBarProperties).catch(err => {
+    INDEX_LOGGER.info(`set System Bar Properties failed:${err}`)
+  })
+})
+.catch(err => {
+  INDEX_LOGGER.info(`get top window failed:${err}`)
+})
+```
+<!--no_check-->
\ No newline at end of file

zh-cn/application-dev/faqs/faqs-hdc-std.md

 # hdc_std命令使用常见问题
 
-
-
 ## 日志的常用命令 
 
 适用于：OpenHarmony SDK 3.2.2.5版本
@@ -26,19 +24,7 @@
 
 执行完命令后重启DevEco Studio。
 
-## 应用如何打印日志是使用hilog还是console，hilog接口参数domain的设置范围是什么？
-
-适用于：OpenHarmony SDK 3.2.2.5版本
-
-推荐使用[hilog日志系统](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-hilog.md)进行日志打印，接口参数domain的设置范围可以参考[开发指南](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-hilog.md#hilogisloggable)。
-
-## hilog日志打印长度限制是多少，是否可以配置 
-
-适用于：OpenHarmony SDK 3.2.2.5版本
-
-日志打印的长度限制为1024个字符，该长度不能配置。
-
-## 为什么有时候直接用IDE安装HAP包到开发板上无法打开？
+## 用IDE安装HAP包到开发板上无法打开
 
 适用于：OpenHarmony SDK 3.2.5.3版本，API9 Stage模型
 
@@ -50,14 +36,53 @@
 
 可以使用hdc_std file send上传文件。
 
-## 如何让RK3568开发板不熄屏？
+## 如何让RK3568开发板不熄屏
 
 适用于：OpenHarmony SDK 3.2.5.3版本，API9 Stage模型
 
 输入命令hdc_std shell "power-shell setmode 602"
 
-## 如何通过命令启动Ability？
+## 如何通过命令启动Ability
 
 适用于：OpenHarmony SDK 3.2.5.3版本，API9 Stage模型
 
 输入命令hdc_std shell aa start -a AbilityName -b bundleName -m moduleName
+
+## 如何修改开发板中文件目录为可读写权限
+
+适用于：OpenHarmony SDK 3.2.5.6版本，API9 Stage模型
+
+输入命令 hdc_std shell mount -o remount,rw /
+
+## 如何解决hdc_std file recv 使用报错：Unkonw file option -r
+
+适用于：OpenHarmony SDK 3.2.5.6版本，API9 Stage模型
+
+1. 使用设备镜像或者同版本SDK中配套的hdc工具进行使用。
+
+2. hdc工具指定的路径不要包含中文和空格。
+
+## 如何使用命令卸载应用
+
+适用于：OpenHarmony SDK 3.2.2.5版本
+
+输入命令hdc_std uninstall [-k] [package_name]
+
+## 如何查看系统是32位还是64位
+
+适用于：OpenHarmony SDK 3.2.5.5版本
+
+使用命令：hdc_std shell getconf LONG_BIT
+
+若返回64则为64位系统，否则为32位系统。
+
+## 如何查看组件树结构
+
+适用于：OpenHarmony SDK 3.2.5.5版本
+
+1. 使用命令hdc_std shell 进入命令行界面。
+
+2. 输入 aa dump -a 找到abilityID。
+
+3. aa dump -i [abilityID] -c -render 查看组件树。
+<!--no_check-->
\ No newline at end of file

zh-cn/application-dev/faqs/faqs-ide.md

 # IDE使用常见问题
 
-
-
-## 如何解决报错“npm ERR! code SELF_SIGNED_CERT_IN_CHAIN”？
+## 如何解决报错“npm ERR! code SELF_SIGNED_CERT_IN_CHAIN”
 
 适用于：OpenHarmony SDK 3.2.5.3版本，API9 Stage模型
 
@@ -10,10 +8,74 @@
 
 2. 在Dev Eco Studio terminal中执行npm install。
 
-## 手工更新DevEco的SDK后，编译HAP报错“Cannot find module 'xxx\ets\x.x.x.x\build-tools\ets-loader\node_modules\webpack\bin\webpack.js'” 
+## 手工更新DevEco的SDK后，编译HAP报错“Cannot find module 'xxx\ets\x.x.x.x\build-tools\ArkTS-loader\node_modules\webpack\bin\webpack.js'” 
 
 适用于：OpenHarmony SDK 3.2.5.3版本，API9 Stage模型
 
 1. 到SDK的ets\x.x.x.x\build-tools\ets-loader目录下执行npm install；
 
-2. 到SDK的js\x.x.x.x\build-tools\ace-loader目录下执行npm install。 完成步骤后重新编辑既可。
+2. 到SDK的js\x.x.x.x\build-tools\ace-loader目录下执行npm install。 完成步骤后重新编辑。
+
+## 如何通过命令行打包HAP
+
+适用于：OpenHarmony SDK 3.2.5.5版本，API9 Stage模型
+
+方式一：运行hvigor assembleHap。
+
+方式二：在工程的package.json的scripts中，定义构建任务脚本后，运行npm buildOhosHaps。“buildOhosHaps”字段可以自定义。
+
+  
+```
+"scripts": {
+  "buildOhosHaps": "hvigor assembleHap"
+},
+```
+
+## DevEco创建新工程为什么选不到API9
+
+适用于：DevEco Studio 3.0 Beta4 3.0.0.993(B06)版本
+
+创建新工程的时候，首先要选择OpenHarmony页签再创建工程就可以选到API9。
+
+## 下载时收不到回调且无法返回错误码
+
+适用于：OpenHarmony所有版本
+
+1. 重装hdc命令： hdc_std重裝 拉起 设备连接
+
+2. 关闭日志限流 ：hdc_std shell hilog -Q pidoff 打开"
+
+## IDE点击run按钮后，报错：error: unknow option. usage: aa start <options>
+
+适用于：OpenHarmony SDK 3.2.5.6版本，API9 Stage模型
+
+报错原因：aa命令参数错误，执行打开应用操作报错。
+
+有2种处理方法：
+
+1. 检查SDK版本和OS版本，确保SDK版本和OS版本一致。
+
+2. 点击设备上app图标，手动启动app进行使用。
+
+## IDE运行app报错：The hdc_std version of the SDK does not match the hdcd version of the device.
+
+适用于：OpenHarmony SDK 3.2.5.6版本，API9 Stage模型
+
+hdc 和 hdcd版本不匹配 ，请更新IDE至Dev Eco 3.0.1.993及以上版本。
+
+旧版本IDE检测不匹配会拦截安装，新版本IDE仅提醒不影响正常使用。
+
+## 如何在OpenHarmony 的SDK中加入自定义的\*.d.ts文件
+
+适用于：OpenHarmony SDK 3.1.7.7版本 ,  API8 FA模型
+
+将dts文件命名为\@ohos.xxxx.d.ts ,  放入SDK的路径中，重启IDE。
+
+引入时会有代码提醒。
+
+## 如何替换full-SDK
+
+适用于：OpenHarmony SDK 3.2.7.5版本
+
+参考文档[full-SDK替换指南](../quick-start/full-sdk-switch-guide.md)
+<!--no_check-->
\ No newline at end of file

zh-cn/application-dev/faqs/faqs-international.md

+# 国际化开发常见问题
+
+## AppScope中的资源如图片，文字等的引用方式是什么
+
+适用于：OpenHarmony SDK 3.2.5.5版本，API9 Stage模型
+
+通过$r('app.type.name')的形式来引用，type代表资源类型，如color，string，media等，name代表资源命名
+
+## Resource类型转为string
+
+适用于：OpenHarmony SDK3.0, API9 Stage模型
+
+Resource为string支持限定词目录使用this.context.resourceManager.getStringSync(\\$r('app.string.test').id)，可以同步转换，不支持\$r('app.string.test', 2)方式。更多用法请参考[ResourceManager(资源管理)](../reference/apis/js-apis-resource-manager.md#getstringsync9)
+
+## form_config.json文件中使用$引用常量为什么不生效 
+
+适用于：OpenHarmony SDK 3.2.6.5, API9 Stage模型
+
+form_config.json文件中不支持使用$引用常量。
+<!--no_check-->
\ No newline at end of file

zh-cn/application-dev/faqs/faqs-language.md

+# 开发语言常见问题
+
+## TS语言在生成器函数中编译失败，有哪些使用限制
+
+适用于：OpenHarmony SDK 3.2.5.3版本，API9 Stage模型
+
+TS语言的使用在生成器函数中存在以下限制：
+
+- 表达式仅允许在字符串(${expression})、if条件、ForEach的参数和组件的参数中使用；
+
+- 这些表达式中的任何一个都不能导致任何应用程序状态变量（\@State、\@Link、\@Prop）的改变，否则会导致未定义和潜在不稳定的框架行为；
+
+- 生成器函数内部不能有局部变量。
+
+上述限制都不适用于事件处理函数（例如onClick）的匿名函数实现。
+
+错误示例：
+
+  
+```
+build() {
+  let a: number = 1 // invalid: variable declaration not allowed
+  Column() {
+    Text('Hello ${this.myName.toUpperCase()}') // ok.
+    ForEach(this.arr.reverse(), ..., ...) // invalid: Array.reverse modifies the @State array variable in place
+  }
+  buildSpecial()  // invalid: no function calls
+  Text(this.calcTextValue()) // this function call is ok.
+}
+```
+
+## 如何动态替换掉资源文件中的“%s”占位符
+
+适用于：OpenHarmony SDK 3.2.5.3版本，API9 Stage模型
+
+在应用中，通过"$r('app.string.xx')"的形式引用应用资源，$r的第二个参数可用于替换%s占位符。
+
+  示例：
+  
+```
+build() {
+  //do something
+  //引用的string资源,$r的第二个参数用于替换%s
+  Text($r('app.string.entry_desc','aaa')) 
+    .fontSize(100)
+    .fontColor(Color.Black)
+  //do something
+}
+```
+
+## 如何读取Resource中的xml文件并转化为String类型
+
+适用于：OpenHarmony SDK 3.2.2.5版本， API9 Stage模型
+
+1. 通过resourceManager的RawFile接口获取Uint8Array格式数据。
+
+2. 通过String.fromCharCode将Uint8Array格式数据转化为String类型。快快快
+
+参考文档：[资源管理](../reference/apis/js-apis-resource-manager.md)
+
+示例：
+
+  
+```
+resourceManager.getRawFile(path, (error, value) => {
+  if (error != null) {
+    console.log("error is " + error);
+  } else {
+    let rawFile = value;
+    let xml = String.fromCharCode.apply(null, rawFile)
+  }
+});
+```
+
+## 如何将Resource资源对象转成string类型
+
+适用于：OpenHarmony SDK 3.2.3.5版本，API9 Stage模型
+
+通过\@ohos.resourceManager模块 resourceManager.getString()方法获取字符串。
+
+参考文档：[资源管理](../reference/apis/js-apis-resource-manager.md#getstring)
+
+## class全局静态变量无法使用的问题
+
+适用于：OpenHarmony SDK 3.2.3.5版本，API9 Stage模型
+
+Page和Ability打包后会对import的对象分别形成两个不同的闭包，即打包出两个Global对象。因此，所引用的静态变量并不是同一对象，所以无法通过class静态变量方式定义全局变量。建议使用AppStorage进行全局变量管理。
+
+参考文档：[应用程序的数据存储](../ui/ts-application-states-appstorage.md)
+
+## Stage模型下如何获取资源
+
+适用于：OpenHarmony SDK 3.2.3.5版本，API9 Stage模型
+
+Stage模型支持了通过context获取resourceManager对象的方式，再调用其内部获取资源的接口，无需再导入包，此方式FA模型不适用。
+
+示例：
+
+  
+```
+const context = getContext(this) as any
+context 
+  .resourceManager
+  .getString($r('app.string.entry_desc').id)
+  .then(value => {
+    this.message = value.toString()
+})
+```
+
+## 如何实现页面加载前从接口获取数据 
+
+适用于：OpenHarmony SDK 3.2.5.5版本，API9 Stage模型
+
+aboutToAppear函数中使用异步接口获取页面数据，使用\@State修饰变量，数据获取完成后根据变量自动刷新页面。
+
+  
+```
+@Entry
+@Component
+struct Test6Page {
+  // 数据获取成功，会自动刷新页面
+  @State message: string = 'loading.....'
+  aboutToAppear(){
+    // 模拟异步接口获取数据
+    setTimeout(()=>{
+      this.message = 'new msg'
+    },3000)
+  }
+  build() {
+    Row() {
+      Column() {
+        Text(this.message)
+          .fontSize(50)
+          .fontWeight(FontWeight.Bold)
+      }
+      .width('100%')
+    }
+    .height('100%')
+  }
+}
+```
+
+## worker线程与主线程是否运行在相同的全局上下文中
+
+适用于：OpenHarmony SDK 3.2.5.5版本，API9 Stage模型
+
+worker线程与主线程不在同一个上下文中，它们使用数据通信的方式交互。
+
+## OpenHarmony上url编码使用哪个接口
+
+适用于：OpenHarmony SDK 3.2.5.5版本，API9 Stage模型
+
+使用全局函数encodeURI进行编码，使用decodeURI进行解码。例如空格字符，编码后为%20。
+
+## OpenHarmony有解析xml的接口吗
+
+适用于：OpenHarmony SDK 3.2.5.5版本，API9 Stage模型
+
+使用ConvertXML的convert接口可以将xml文本解析为JavaScript对象。参考文档：[convertxml API文档](../reference/apis/js-apis-convertxml.md)
+
+## 应用图标一多设置
+
+适用于：OpenHarmony SDK3.0, API9 Stage模型
+
+借助资源限定词能力，实现应用图标的一多配置，具体使用参考[资源使用](../key-features/multi-device-app-dev/resource-usage.md)
+
+## Stage模型资源配置文件string.json文件中支持配置占位符吗
+
+适用于：OpenHarmony SDK3.2.6.3, API9 Stage模型
+
+资源配置文件string.json文件本身不支持配置占位符，可以在对应的页面中通过定义变量，在实际组件使用Resources和变量拼接的方式达到实现占位符的同等效果。
+
+## OpenHarmony的systemTime.getCurrentTime()接口和JS的new Date().getTime()有区别吗
+
+适用于：OpenHarmony SDK3.2.6.3, API9 Stage模型
+
+systemTime.getCurrentTime(false)和new Date().getTime()一样，都是返回1970年1月1日至今的毫秒数；systemTime.getCurrentTime(true)返回1970年1月1日至今的纳秒数。两种方式都是系统时间。
+
+## \@BuilderParam装饰器，组件传参问题
+
+适用于：OpenHarmony SDK3.2.6.5, API9 Stage模型
+
+对\@BuilderParam修饰的属性进行赋值时不带参数（如：content: this.specificParam），则此属性的类型需定义成无返回值的函数（如：\@BuilderParam content: () => void）；若带参数（如：callContent: this.specificParam1("111")），则此属性的类型需定义成any（如：\@BuilderParam callContent: any;），具体用法请参考[BuilderParam](../ui/ts-component-based-builder.md)。
+
+## ArkTS如何把string转成byte数组
+
+适用于：所有版本
+
+参考如下代码实现，示例：
+
+  
+```
+function stringToByte(str) {
+  var bytes = new Array();
+  var len,c;
+  len = str.length;
+  for(var i = 0;i<len;i++) {
+    c = str.charCodeAt(i);
+    if( c >= 0x010000 && c<= 0x10FFFF) {
+      bytes.push(((c>>18) & 0x07) | 0xf0);
+      bytes.push(((c>>12) & 0x3F) | 0x80);
+      bytes.push(((c>>6) & 0x3f) | 0x80);
+      bytes.push((c & 0x3F) | 0x80);
+    } else if(c >= 0x000800 && c<= 0x00FFF){
+      bytes.push(((c>>12) & 0x07) | 0xf0);
+      bytes.push(((c>>6) & 0x3F) | 0x80);
+      bytes.push((c & 0x3F) | 0x80);
+    } else if(c >= 0x000800 && c<= 0x0007FF) {
+      bytes.push(((c>>6) & 0x3F) | 0x80);
+      bytes.push((c & 0x3F) | 0x80);
+    } else {
+      bytes.push(c & 0xFF)
+    }
+  }
+  return bytes;
+}
+```
+
+## 创建woker时报错“Too many wokers，the number of worker exceeds the maximum”如何处理
+
+使用于：OpenHarmony SDK 3.2.6.5版本
+
+这是因为每个应用的worker上限为7个，因此在worker使用完成后需要通过termiate方法释放worker。参考[worker开发指南](../reference/apis/js-apis-worker.md#terminate)。
+
+## OpenHarmony推荐的多线程解决方案是什么
+
+使用于：OpenHarmony SDK 3.2.6.5版本 API9 Stage模型
+
+OpenHarmony推荐使用worker来处理多线程场景。
+
+参考文档：[启动一个worker](../reference/apis/js-apis-worker.md)
+
+## 使用\@Builder装饰包含自定义组件的方法与普通方法的区别是什么
+
+适用于：OpenHarmony SDK 3.2.6.5版本，API9 Stage模型
+
+\@Builder装饰的方法中使用了自定义组件，那么该方法每次被调用时，对应的自定义组件均会重新创建。
+
+## 状态管理中\@Watch监听，数组内对象属性变化无法触发watch回调函数
+
+适用于：OpenHarmony SDK 3.2.6.5版本，API9 Stage模型
+
+使用\@Watch监听的对象，只能监听一层数据变化，多层次数据变更无法监听，同\@State状态管理机制一致
+
+## 如何监听\@State深层数据变化
+
+适用于：OpenHarmony SDK 3.2.5.5版本，API9 Stage模型
+
+通过\@Observed配合\@ObjectLink装饰符实现。
+
+参考文档：[Observed和ObjectLink数据管理](../ui/ts-other-states-observed-objectlink.md)
+
+## 如何实现字符串编解码
+
+适用于：OpenHarmony SDK 3.2.5.5版本，API9 Stage模型
+
+通过util工具函数模块中的TextEncoder和TextDecoder进行解码。
+
+参考文档：[TextEncoder](../reference/apis/js-apis-util.md#textencoder)、[TextDecoder](../reference/apis/js-apis-util.md#textdecoder)
+
+## 如何导入和导出namespace命名空间
+
+适用于：OpenHarmony SDK 3.2.5.5版本，API9 Stage模型
+
+- namespace导出
+    
+  ```
+  namespace Util{
+      export function getTime(){
+          return Date.now()
+      }
+  }
+  export default Util
+  ```
+
+- namespace导入
+    
+  ```
+  import Util from './util'
+  Util.getTime()
+  ```
+
+## worker线程中能进行关系型数据库的操作吗
+
+适用于：OpenHarmony SDK 3.2.5.5版本， API9 Stage模型
+
+不支持。
+<!--no_check-->

zh-cn/application-dev/faqs/faqs-media.md

+# 媒体开发常见问题
+
+## 如何设置前置拍照
+
+适用于：OpenHarmony SDK 3.2.3.5版本，API9 Stage模型
+
+1. 设置相机位置camera.CameraPosition.CAMERA_POSITION_FRONT
+
+2. 根据相机位置和类型创建CameraInput实例
+
+参考文档：[相机管理](../reference/apis/js-apis-camera.md#%E7%9B%B8%E6%9C%BA%E7%AE%A1%E7%90%86)
+
+示例：
+
+```
+//默认设置后置相机,通过设置isFrontCamera来切换相机
+let cameraId
+let cameraInput
+for(let cameraIndex = 0; cameraIndex < this.cameraArray.length; cameraIndex++) {
+   let faceType = this.cameraArray[cameraIndex].cameraPosition
+   switch(faceType) {
+  case camera.CameraPosition.CAMERA_POSITION_FRONT://前置相机
+    if(this.isFrontCamera){
+   cameraId = this.cameraArray[cameraIndex].cameraId
+    }
+	   break
+	 case camera.CameraPosition.CAMERA_POSITION_BACK://后置相机
+	   if(!this.isFrontCamera){
+		 cameraId = this.cameraArray[cameraIndex].cameraId
+	   }
+	   break
+	 case camera.CameraPosition.CAMERA_POSITION_UNSPECIFIED:
+	 default:
+	   break
+   }
+}
+cameraInput = await this.cameraManager.createCameraInput(cameraId)熊文帅
+```
+
+## 如何进行图片剪切
+
+适用于：OpenHarmony 3.2.5.6版本，API9 Stage模型
+
+1. **通过传入的uri创建图片源实例ImageSource对象。**
+     
+   ```
+   let path = this.context.getApplicationContext().fileDirs + "test.jpg";
+   const imageSourceApi = image.createImageSource(path);
+   ```
+
+2. **设置解码参数，通过图片解码获取PixelMap图像对象，解码过程中同时支持图像处理操作。**
+   - 设置desiredSize支持按尺寸缩放，如果设置为全0，则不进行缩放。
+   - 设置desiredRegion支持按矩形区域裁剪，如果设置为全0，则不进行裁剪。
+   - 设置rotateDegrees支持旋转角度，以图像中心点顺时针旋转。
+        
+      ```
+      const decodingOptions = {
+        desiredSize: {
+        height:0,
+        width:0
+        },
+        //按矩形区域裁剪
+        desiredRegion: {
+        size: {
+         height:100,
+         width:100
+        },
+        x:0,
+        y:0
+        },
+        //旋转90度
+        rotate:90
+      }
+      imageSourceApi.createPixelMap(decodingOptions).then(pixelMap => {
+        this.handlePixelMap(pixelMap)
+      })
+      ```
+
+3. 解码完成获取到PixelMap对象后，可以进行后续处理，比如渲染显示等。
+
+## 如何申请设备上的媒体读写权限
+
+适用于：OpenHarmonySDK 3.2.5.5版本，API9 Stage模型
+
+1. 在module.json5配置文件中配置媒体读写权限ohos.permission.READ_MEDIA和ohos.permission.WRITE_MEDIA。
+   示例：
+
+     
+   ```
+   {
+     "module" : {
+       "requestPermissions":[
+         {
+           "name" : "ohos.permission.READ_MEDIA",
+           "reason": "$string:reason"
+         },
+         {
+           "name" : "ohos.permission.WRITE_MEDIA",
+           "reason": "$string:reason"
+         }
+       ]
+     }
+   }
+   ```
+
+2. 这两个权限的授权方式均为user_grant，因此需要调用requestPermissionsFromUser接口，以动态弹窗的方式向用户申请授权。
+     
+   ```
+   let permissions: Array<string> = ['ohos.permission.READ_MEDIA','ohos.permission.WRITE_MEDIA']
+   context.requestPermissionsFromUser(permissions).then((data) => {
+       console.log("Succeed to request permission from user with data: " + JSON.stringify(data))
+   }).catch((error) => {
+       console.log("Failed to request permission from user with error: " + JSON.stringify(error))
+   })
+   ```
+
+## MP4格式的视频为什么播放不了
+
+适用于：OpenHarmonySDK 3.2.7.5版本，API9 Stage模型
+
+暂不支持h.265编码格式的MP4视频播放。
+
+
+## 为什么视频创建至十几个时新创建的视频无法播放甚至崩溃
+
+适用于：OpenHarmonySDK 3.2.7.5版本，API9 Stage模型
+
+当前限制最多创建13个媒体播放实例。
+
+<!--no_check-->
\ No newline at end of file

zh-cn/application-dev/faqs/faqs-native.md

 # Native API使用常见问题
 
+## Native API是否有类似Canvas绘制接口
 
+适用于：OpenHarmony SDK 3.2.5.3版本，API9 Stage模型
+
+Native API中的[Drawing](../reference/native-apis/_drawing.md)接口可以提供2D绘制功能。
 
 ## 运行Native HAP的时候，导入的命名空间报错Obj is not a valid object
 
@@ -8,7 +12,19 @@
 
 检查模块根目录（注意不是工程根目录）下的build-profile.json5文件，如果设备是32位，需要在abiFilters参数中配置armeabi-v7a，如果设备是64位，需要在abiFilters参数中配置arm64-v8a。
 
-## NAPI开发的C++代码中，如何获取到模块 package.json 文件中的 “version” 值？
+## 运行Native HAP的时候，报错install parse profile prop check error
+
+适用于：OpenHarmony SDK 3.2.6.3版本，API9 Stage模型
+
+检查模块根目录（注意不是工程根目录）下的build-profile.json5文件，如果设备是32位，需要在abiFilters参数中配置armeabi-v7a，如果设备是64位，需要在abiFilters参数中配置arm64-v8a。
+
+## 在Native代码中使用OH_LOG_Print打印日志，报错undefined symbol: OH_LOG_Print
+
+适用于：OpenHarmony SDK 3.2.6.3版本，API9 Stage模型
+
+需要修改CMakeLists.txt文件，在target_link_libraries最后追加libhilog_ndk.z.so。
+
+## 如何获取到模块 package.json 文件中的 “version” 值
 
 适用于：OpenHarmony SDK 3.2.5.3版本，API9 Stage模型
 
@@ -55,3 +71,11 @@ static napi_value Add(napi_env env, napi_callback_info info)
     return fixed_version_value;
 }
 ```
+
+## 如何遍历rawfiles中的文件
+
+适用于：OpenHarmony SDK 3.2版本以上，API9 Stage模型
+
+使用Native API中的OH_ResourceManager_OpenRawDir()方法获取到rawfile的根目录，然后对其进行遍历。可参考文档：[Native开发指导](../reference/native-apis/rawfile.md)
+
+<!--no_check--> 
\ No newline at end of file

zh-cn/application-dev/faqs/faqs-third-party-library.md

 # 三四方库使用常见问题
 
+## 报错“Stage model module … does not support including OpenHarmony npm packages or modules in FA model. OpenHarmony build tasks will not be executed, and OpenHarmony resources will not be packed. ”如何解决
 
+适用于：OpenHarmony SDK 3.2.5.3版本，API9 Stage模型
+
+三四方件未适配API9 Stage模型，无法使用。
 
-## 报错“Stage model module … does not support including OpenHarmony npm packages or modules in FA model. OpenHarmony build tasks will not be executed, and OpenHarmony resources will not be packed. ”是什么意思？
+## 项目是否支持传递依赖
 
 适用于：OpenHarmony SDK 3.2.5.3版本，API9 Stage模型
 
-三四方件未适配API9 Stage模型，无法使用。
+比如项目A依赖项目B，项目B依赖项目C，那项目A是否能直接使用项目C提供的接口？
+
+不支持。由于项目打包使用npm工具，npm不支持传递依赖。可以在项目A增加项目C的依赖来解决问题。
+
+## 如何获取可用的三方库
+
+适用于：OpenHarmony SDK 3.2.6.5版本，API9 Stage模型
+
+参见：[OpenHarmony上可直接使用的三方组件汇总](https://gitee.com/openharmony-sig/third_party_app_libs)。
+
+## 网络相关的三方库有哪些
+
+适用于：OpenHarmony SDK 3.2.6.5版本，API9 Stage模型
+
+网络相关的三方库有[Axios](https://gitee.com/openharmony-sig/axios)。
+
+## 如何使用npm引入三四方库
+
+  适用于：OpenHarmony SDK 3.2.5.5版本，API9 Stage模型
+- 方法一：
+  1. 打开Terminal窗口，通过如下指令进入到entry目录。
+        
+      ```
+      cd entry
+      ```
+  2. 以引入“dayjs”为例，执行以下指令进行安装。
+        
+      ```
+      npm install dayjs --save
+      ```
+  3. 在对应的js文件中直接引用。
+        
+      ```
+      import dayjs from 'dayjs'; 
+      ```
+
+- 方法二：
+  1. 打开工程目录下的entry目录，找到该目录下的package.json文件。
+  2. 在package.json文件中写入想要安装的三方npm，以“dayjs”为例，示例如下：
+        
+      ```
+      {
+        "dependencies": {
+          "dayjs": "^1.10.4",
+        }
+      }
+      ```
+  3. 打开Terminal窗口，通过如下指令进入到entry目录。
+        
+      ```
+      cd entry
+      ```
+  4. 执行指令进行安装。
+        
+      ```
+      npm install
+      ```
+  5. 在对应的js文件中直接引用。
+        
+      ```
+      import dayjs from 'dayjs'; 
+      ```
+<!--no_check-->
\ No newline at end of file

zh-cn/application-dev/faqs/faqs-ui-js.md

 # UI框架（JS）开发常见问题
 
-
-
 ## 如何取出xml文件中对应的字段
 
 适用于：OpenHarmony SDK 3.2.3.5版本， API9 Stage模型
@@ -39,20 +37,11 @@ let options = {
 }
 let result: any = conv.convert(xml, options) // 将xml文本转为JS对象
 console.log('Test: ' + JSON.stringify(result))
-console.log('Test: ' + result._declaration._attributes.version) // xml字符串中version字段信息console.log('Test: ' + result._elements[0]._elements[0]._elements[0]._text) // xml字符串中title字段内容
+console.log('Test: ' + result._declaration._attributes.version) // xml字符串中version字段信息
+console.log('Test: ' + result._elements[0]._elements[0]._elements[0]._text) // xml字符串中title字段内容
 ```
 
-参考文档：[xml转换JavaScript](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-convertxml.md)
-
-## JS、TS和eTS的区别
-
-适用于：OpenHarmony SDK 3.2.3.5版本，API9 Stage模型
-
-- JS：Web 的编程语言。具有轻量级，弱类型等特点。
-
-- TS：TS是JS的超集，拓展了JS的语法。有明确的类型与更多面向对象的内容如接口，枚举等。
-
-- eTS：OpenHarmony UI开发框架语言，是对TS的扩展，通过声明式开发范式实现UI界面。
+参考文档：[xml转换JavaScript](../reference/apis/js-apis-convertxml.md)
 
 ## 如何将时间转为时分秒格式
 
@@ -101,4 +90,41 @@ export default class DateTimeUtil{
     return `${this.fill(hours)}${this.fill(minutes)}${this.fill(seconds)}`
   }
 }
+
+```
+
+## scroller如何判断回弹动画的结束误差
+
+适用于：OpenHarmony SDK 3.2.5.3版本，API8 FA模型
+
+目前可以在触摸结束之后，计算同方向的变化，如果变化方向相反，说明出现回弹了，就规避不处理了。
+
+
+## 如何实现应用数据持久化存储
+
+通过PersistentStorage类实现管理应用持久化数据，可以将特定标记的持久化数据链接到AppStorage中，并由AppStorage接口访问对应持久化数据。
+
+参考文档：[持久化数据管理](../ui/ts-application-states-apis-persistentstorage.md)
+
+示例：
+
+  
+```
+AppStorage.Link('varA')
+PersistentStorage.PersistProp("varA", "111");
+@Entry
+@Componentstruct Index {
+  @StorageLink('varA') varA: string = ''
+  build() {
+    Column() {
+      Text('varA: ' + this.varA).fontSize(20)
+      Button('Set').width(100).height(100).onClick(() => {
+        this.varA += '333'
+      })
+    }
+    .width('100%')
+    .height('100%')
+  }
+}
 ```
+<!--no_check--> 
\ No newline at end of file

zh-cn/application-dev/faqs/faqs-web-arkts.md

+# ArkUI Web组件（ArkTS）开发常见问题
+
+## Web组件domStorageAccess属性设置
+
+适用于：OpenHarmony SDK 3.2.6.5版本，API9 Stage模型
+
+设置是否开启文档对象模型存储接口（DOM Storage API）权限，默认未开启，控制web网页中localStorage的使用，对sessionStorage未做控制
+
+
+## Web组件加载的html页面内如何检测网络状态
+
+适用于：OpenHarmony SDK 3.2.7.5版本，API9 Stage模型
+
+1. 配置应用权限：ohos.permission.INTERNET 、 ohos.permission.GET_NETWORK_INFO
+
+2. html中通过window.navigator.onLine获取网络状态
+
+## Web组件加载h5页面，首次加载无法设置拼接UserAgent参数
+
+适用于：OpenHarmony SDK 3.2.6.5版本，API9 Stage模型
+
+默认UserAgent通过WebController获取。一个WebController对象只能控制一个Web组件，且必须在Web组件和WebController绑定后，才能调用WebController上的方法，因此在初次加载前设置默认UserAgent + 自定义字符串拼接，可采用此方式：
+
+1. 使用\@State定义初始userAgent，绑定到Web组件；
+
+2. 在web组件的onUrlLoadIntercept回调中，通过WebController获取默认userAgent，修改Web组件绑定的userAgent。
+   参考代码如下：
+
+     
+   ```
+   @Entry
+   @Component
+   struct Index {
+     private controller: WebController = new WebController()
+     @State userAgentPa: string = ''
+     build() {
+       Row() {
+         Column() {
+           Web({ src: 'www.example.com', controller: this.controller })
+             .width('100%')
+             .userAgent(this.userAgentPa)
+             .onUrlLoadIntercept((event) => {
+               let userAgent = this.controller.getDefaultUserAgent();
+               this.userAgentPa = userAgent + ' 111111111'
+               console.log("userAgent onUrlLoadIntercept: " + userAgent);
+               return false;
+             })
+         }
+         .width('100%').alignItems(HorizontalAlign.Start).backgroundColor(Color.Green)
+       }
+       .height('100%')
+     }
+   }
+   ```
+
+## 加载Lottie动画的逻辑应该写在onAppear函数中还是应该写在onReady函数中
+
+适用于：OpenHarmony SDK 3.2.6.5版本，API9 Stage模型
+
+onAppear方法只是定位完Canvas的位置，onReady方法才是测量完成，加载动画的逻辑应该写在onReady函数中。
+
+## 调用deleteJavaScriptRegister后是否需要调用refresh接口
+
+适用于：所有版本
+
+不需要。
+
+## 页面如何传递数据给Web组件
+
+适用于：OpenHarmony SDK 3.2.7.5版本，API9 Stage模型
+
+1. 使用WebController创建两个消息端口。
+
+2. 将消息端口1发送到HTML侧，由HTML侧保存并使用。
+
+3. 将消息端口0在应用侧注册回调事件。
+
+4. 使用应用侧的端口0给HTML侧消息端口1发送消息。
+
+使用参考：[Web组件](../reference/arkui-ts/ts-basic-components-web.md#postmessage9)
+
+<!--no_check-->
\ No newline at end of file

zh-cn/application-dev/media/audio-capturer.md

@@ -32,86 +32,70 @@ AudioCapturer提供了用于获取原始音频文件的方法。开发者可以
    在audioCapturerOptions中设置音频采集器的相关参数。该实例可用于音频采集、控制和获取采集状态，以及注册通知回调。 
 
    ```js
-   var audioStreamInfo = {
+   import audio from '@ohos.multimedia.audio';
+
+   let audioStreamInfo = {
      samplingRate: audio.AudioSamplingRate.SAMPLE_RATE_44100,
      channels: audio.AudioChannel.CHANNEL_1,
      sampleFormat: audio.AudioSampleFormat.SAMPLE_FORMAT_S16LE,
      encodingType: audio.AudioEncodingType.ENCODING_TYPE_RAW
    }
    
-   var audioCapturerInfo = {
+   let audioCapturerInfo = {
      source: audio.SourceType.SOURCE_TYPE_MIC,
-     capturerFlags: 1
+     capturerFlags: 0 // 0是音频采集器的扩展标志位，默认为0
    }
    
-   var audioCapturerOptions = {
+   let audioCapturerOptions = {
      streamInfo: audioStreamInfo,
      capturerInfo: audioCapturerInfo
    }
    
    let audioCapturer = await audio.createAudioCapturer(audioCapturerOptions);
-   var state = audioRenderer.state;
-   ```
-
-2. （可选）使用on（'stateChange'）订阅音频采集器状态更改。
-  如果应用需要在采集器状态更新时进行一些操作，可以订阅该事件。更多事件请参考[API参考文档](../reference/apis/js-apis-audio.md)。
-
-  ```js
-  audioCapturer.on('stateChange',(state) => {
-  console.info('AudioCapturerLog: Changed State to : ' + state)
-  switch (state) {
-    case audio.AudioState.STATE_PREPARED:
-      console.info('--------CHANGE IN AUDIO STATE----------PREPARED--------------');
-      console.info('Audio State is : Prepared');
-      break;
-    case audio.AudioState.STATE_RUNNING:
-      console.info('--------CHANGE IN AUDIO STATE----------RUNNING--------------');
-      console.info('Audio State is : Running');
-      break;
-    case audio.AudioState.STATE_STOPPED:
-      console.info('--------CHANGE IN AUDIO STATE----------STOPPED--------------');
-      console.info('Audio State is : stopped');
-      break;
-    case audio.AudioState.STATE_RELEASED:
-      console.info('--------CHANGE IN AUDIO STATE----------RELEASED--------------');
-      console.info('Audio State is : released');
-      break;
-    default:
-      console.info('--------CHANGE IN AUDIO STATE----------INVALID--------------');
-      console.info('Audio State is : invalid');
-      break;
-   }
-  });
+   console.log('AudioRecLog: Create audio capturer success.');
    ```
 
-3. 调用start()方法来启动/恢复采集任务。
+2. 调用start()方法来启动/恢复采集任务。
 
    启动完成后，采集器状态将变更为STATE_RUNNING，然后应用可以开始读取缓冲区。
 
    ```js
+   import audio from '@ohos.multimedia.audio';
+
+   async function startCapturer() {
+     let state = audioCapturer.state;
+     // Capturer start时的状态应该是STATE_PREPARED、STATE_PAUSED和STATE_STOPPED之一.
+     if (state != audio.AudioState.STATE_PREPARED || state != audio.AudioState.STATE_PAUSED ||
+       state != audio.AudioState.STATE_STOPPED) {
+       console.info('Capturer is not in a correct state to start');
+       return;
+     }
      await audioCapturer.start();
-   if (audioCapturer.state == audio.AudioState.STATE_RUNNING) {
+
+     let state = audioCapturer.state;
+     if (state == audio.AudioState.STATE_RUNNING) {
        console.info('AudioRecLog: Capturer started');
      } else {
-     console.info('AudioRecLog: Capturer start failed');
+       console.error('AudioRecLog: Capturer start failed');
+     }
    }
    ```
 
-4. 使用getBufferSize()方法获取要读取的最小缓冲区大小。
-
-   ```js
-   var bufferSize = await audioCapturer.getBufferSize();
-   console.info('AudioRecLog: buffer size: ' + bufferSize);
-   ```
-
-5. 读取采集器的音频数据并将其转换为字节流。重复调用read()方法读取数据，直到应用准备停止采集。   
+3. 读取采集器的音频数据并将其转换为字节流。重复调用read()方法读取数据，直到应用准备停止采集。   
 
    参考以下示例，将采集到的数据写入文件。 
 
    ```js
    import fileio from '@ohos.fileio';
 
-   const path = '/data/data/.pulse_dir/capture_js.wav';
+    let state = audioCapturer.state;
+    // 只有状态为STATE_RUNNING的时候才可以read.
+    if (state != audio.AudioState.STATE_RUNNING) {
+      console.info('Capturer is not in a correct state to read');
+      return;
+    }
+      
+   const path = '/data/data/.pulse_dir/capture_js.wav'; // 采集到的音频文件存储路径
    let fd = fileio.openSync(path, 0o102, 0o777);
    if (fd !== null) {
      console.info('AudioRecLog: file fd created');
@@ -126,38 +110,140 @@ AudioCapturer提供了用于获取原始音频文件的方法。开发者可以
      console.info('AudioRecLog: file fd opened in append mode');
    }
       
-   var numBuffersToCapture = 150;
+   let numBuffersToCapture = 150; // 循环写入150次
    while (numBuffersToCapture) {
-     var buffer = await audioCapturer.read(bufferSize, true);
+     let buffer = await audioCapturer.read(bufferSize, true);
      if (typeof(buffer) == undefined) {
-       console.info('read buffer failed');
+       console.info('AudioRecLog: read buffer failed');
      } else {
-       var number = fileio.writeSync(fd, buffer);
-       console.info('AudioRecLog: data written: ' + number);
+       let number = fileio.writeSync(fd, buffer);
+       console.info(`AudioRecLog: data written: ${number}`);
      }
       
      numBuffersToCapture--;
    }
    ```
 
-6. 采集完成后，调用stop方法，停止录制。
+4. 采集完成后，调用stop方法，停止录制。
 
    ```js
+    async function StopCapturer() {
+      let state = audioCapturer.state;
+      // 只有采集器状态为STATE_RUNNING或STATE_PAUSED的时候才可以停止
+      if (state != audio.AudioState.STATE_RUNNING && state != audio.AudioState.STATE_PAUSED) {
+        console.info('AudioRecLog: Capturer is not running or paused');
+        return;
+      }
+
       await audioCapturer.stop();
-   if (audioCapturer.state == audio.AudioState.STATE_STOPPED) {
+
+      state = audioCapturer.state;
+      if (state == audio.AudioState.STATE_STOPPED) {
         console.info('AudioRecLog: Capturer stopped');
       } else {
-     console.info('AudioRecLog: Capturer stop failed');
+        console.error('AudioRecLog: Capturer stop failed');
+      }
     }
    ```
 
-7. 任务结束，调用release()方法释放相关资源。
+5. 任务结束，调用release()方法释放相关资源。
 
    ```js
+    async function releaseCapturer() {
+      let state = audioCapturer.state;
+      // 采集器状态不是STATE_RELEASED或STATE_NEW状态，才能release
+      if (state == audio.AudioState.STATE_RELEASED || state == audio.AudioState.STATE_NEW) {
+        console.info('AudioRecLog: Capturer already released');
+        return;
+      }
+
       await audioCapturer.release();
-   if (audioCapturer.state == audio.AudioState.STATE_RELEASED) {
+
+      state = audioCapturer.state;
+      if (state == audio.AudioState.STATE_RELEASED) {
         console.info('AudioRecLog: Capturer released');
       } else {
         console.info('AudioRecLog: Capturer release failed');
       }
+    }
+   ```
+
+6. （可选）获取采集器相关信息
+   
+   通过以下代码，可以获取采集器的相关信息。
+
+   ```js
+   // 获取当前采集器状态
+   let state = audioCapturer.state;
+   
+   // 获取采集器信息
+   let audioCapturerInfo : audio.AuduioCapturerInfo = await audioCapturer.getCapturerInfo();
+
+   // 获取音频流信息
+   let audioStreamInfo : audio.AudioStreamInfo = await audioCapturer.getStreamInfo();
+
+   // 获取音频流ID
+   let audioStreamId : number = await audioCapturer.getAudioStreamId();
+
+   // 获取纳秒形式的Unix时间戳
+   let audioTime : number = await audioCapturer.getAudioTime();
+
+   // 获取合理的最小缓冲区大小
+   let bufferSize : number = await audioCapturer.getBuffersize();
+   ```
+
+7. （可选）使用on('markReach')方法订阅采集器标记到达事件，使用off('markReach')取消订阅事件。
+
+    注册markReach监听后，当采集器采集的帧数到达设定值时，会触发回调并返回设定的值。
+   
+    ```js
+    audioCapturer.on('markReach', (reachNumber) => {
+      console.info('Mark reach event Received');
+      console.info(`The Capturer reached frame: ${reachNumber}`);
+    });
+
+    audioCapturer.off('markReach'); // 取消markReach事件的订阅，后续将无法监听到“标记到达”事件
+    ```
+
+8. （可选）使用on('periodReach')方法订阅采集器区间标记到达事件，使用off('periodReach')取消订阅事件。
+
+    注册periodReach监听后，**每当**采集器采集的帧数到达设定值时，会触发回调并返回设定的值。
+   
+    ```js
+    audioCapturer.on('periodReach', (reachNumber) => {
+      console.info('Period reach event Received');
+      console.info(`In this period, the Capturer reached frame: ${reachNumber}`);
+    });
+
+    audioCapturer.off('periodReach'); // 取消periodReach事件的订阅，后续将无法监听到“区间标记到达”事件
+    ```
+
+9. 如果应用需要在采集器状态更新时进行一些操作，可以订阅该事件，当采集器状态更新时，会受到一个包含有事件类型的回调。
+
+    ```js
+    audioCapturer.on('stateChange', (state) => {
+      console.info(`AudioCapturerLog: Changed State to : ${state}`)
+      switch (state) {
+        case audio.AudioState.STATE_PREPARED:
+          console.info('--------CHANGE IN AUDIO STATE----------PREPARED--------------');
+          console.info('Audio State is : Prepared');
+          break;
+        case audio.AudioState.STATE_RUNNING:
+          console.info('--------CHANGE IN AUDIO STATE----------RUNNING--------------');
+          console.info('Audio State is : Running');
+          break;
+        case audio.AudioState.STATE_STOPPED:
+          console.info('--------CHANGE IN AUDIO STATE----------STOPPED--------------');
+          console.info('Audio State is : stopped');
+          break;
+        case audio.AudioState.STATE_RELEASED:
+          console.info('--------CHANGE IN AUDIO STATE----------RELEASED--------------');
+          console.info('Audio State is : released');
+          break;
+        default:
+          console.info('--------CHANGE IN AUDIO STATE----------INVALID--------------');
+          console.info('Audio State is : invalid');
+          break;
+      }
+    });
     ```
\ No newline at end of file

zh-cn/application-dev/napi/napi-guidelines.md

@@ -642,7 +642,7 @@ export default {
 }
 ```
 ## 相关实例
+
 针对Native API的开发，有以下相关实例可供参考：
-- [`NativeAPI`：NativeAPI（ArkTS）（API8）](https://gitee.com/openharmony/applications_app_samples/tree/master/Native/NativeAPI)
 - [第一个Native C++应用（ArkTS）（API9）](https://gitee.com/openharmony/codelabs/tree/master/NativeAPI/NativeTemplateDemo)
 - [Native Component（ArkTS）（API9）](https://gitee.com/openharmony/codelabs/tree/master/NativeAPI/XComponent)
\ No newline at end of file