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

Signed-off-by: NCoderAdo <duliqun1@h-partners.com>

en/contribute/OpenHarmony-hdf-coding-guide.md

@@ -190,7 +190,7 @@ root {
 
 [Description] The HDF places the same type of devices in the same host. You can develop and deploy the driver functionalities of the host by layer, so that one driver has multiple nodes. The following figure shows the HDF driver model.
 
-![hdf-driver-model.png]( ../device-dev/driver/figures/hdf-driver-model.png)
+![hdf-driver-model.png](figures/hdf-driver-model.png)
 
 Place devices of the same type in the same host. When adding a device, check whether the host of the same type already exists. If such a host already exists, configure the device in the host. Do not configure the same host again. A device belongs to only one driver. Therefore, do not configure the same device in different hosts.
 

zh-cn/application-dev/file-management/app-file-upload-download.md

@@ -48,7 +48,7 @@ try {
     .then((uploadTask) => {
       uploadTask.on('complete', (taskStates) => {
         for (let i = 0; i < taskStates.length; i++) {
-          console.info(`upload complete taskState: ${JSON.stringify(taskStates[i])}');
+          console.info(`upload complete taskState: ${JSON.stringify(taskStates[i])}`);
         }
       });
     })

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

@@ -23,6 +23,92 @@
 | bool OH_ResourceManager_ReleaseRawFileDescriptor(const RawFileDescriptor &descriptor) | 释放rawfile的fd。                        |
 | void OH_ResourceManager_ReleaseNativeResourceManager(NativeResourceManager *resMgr) | 释放native resource manager相关资源。    |
 
+## 函数介绍
+
+1. 根据NativeResourceManager实例，使用OH_ResourceManager_OpenRawDir接口获取RawDir实例。
+
+    ```c++
+    RawDir* rawDir = OH_ResourceManager_OpenRawDir(nativeResourceManager, path.c_str());
+    ```
+
+2. 根据RawDir实例，使用OH_ResourceManager_GetRawFileCount接口获取对应目录下的rawfile文件总数 。
+
+    ```c++
+    int count = OH_ResourceManager_GetRawFileCount(rawDir);
+    ```
+
+3. 根据RawDir实例，使用OH_ResourceManager_GetRawFileName接口获取目录下对应index的rawfile文件名。
+
+    ```c++
+    for (int index = 0; index < count; index++) {
+        std::string fileName = OH_ResourceManager_GetRawFileName(rawDir, index);
+    }
+    ```
+
+4. 根据NativeResourceManager实例，使用OH_ResourceManager_OpenRawFile接口获取指定文件名的RawFile实例
+
+    ```c++
+    RawFile* rawFile = OH_ResourceManager_OpenRawFile(nativeResourceManager, fileName.c_str());
+    ```
+
+5. 根据RawFile实例，使用OH_ResourceManager_GetRawFileSize接口获取对应rawfile文件大小。
+
+    ```c++
+    long rawFileSize = OH_ResourceManager_GetRawFileSize(rawFile);
+    ```
+
+6. 根据RawFile实例，使用OH_ResourceManager_SeekRawFile接口指定rawfile偏移量。
+
+    ```c++
+    int position = OH_ResourceManager_SeekRawFile(rawFile, 10, 0);
+    int position = OH_ResourceManager_SeekRawFile(rawFile, 0 , 1);
+    int position = OH_ResourceManager_SeekRawFile(rawFile, -10, 2);
+    ```
+
+7. 根据RawFile实例，使用OH_ResourceManager_GetRawFileOffset接口获取rawfile偏移量。
+
+    ```c++
+    long rawFileOffset = OH_ResourceManager_GetRawFileOffset(rawFile)
+    ```
+
+8. 根据RawFile实例，使用OH_ResourceManager_ReadRawFile接口读取rawfile文件内容。
+
+    ```c++
+    std::unique_ptr<char[]> mediaData = std::make_unique<char[]>(rawFileSize);
+    long rawFileOffset = OH_ResourceManager_ReadRawFile(rawFile, mediaData.get(), rawFileSize);
+    ```
+
+9. 根据RawFile实例，使用OH_ResourceManager_CloseRawFile接口释放rawfile文件相关资源。
+
+    ```c++
+    OH_ResourceManager_CloseRawFile(rawFile);
+    ```
+
+10. 根据RawDir实例，使用OH_ResourceManager_CloseRawDir接口释放rawfile目录相关资源。
+
+    ```c++
+    OH_ResourceManager_CloseRawDir(rawDir);
+    ```
+
+11. 根据RawFile实例，使用OH_ResourceManager_GetRawFileDescriptor接口获取rawfile的RawFileDescriptor。
+
+    ```c++
+    RawFileDescriptor descriptor;
+    bool result = OH_ResourceManager_GetRawFileDescriptor(rawFile, descriptor);
+    ```
+
+12. 根据RawFileDescriptor实例，使用OH_ResourceManager_ReleaseRawFileDescriptor接口关闭rawfile的fd。
+
+    ```c++
+    OH_ResourceManager_ReleaseRawFileDescriptor(descriptor);
+    ```
+
+13. 根据NativeResourceManager实例，使用OH_ResourceManager_ReleaseNativeResourceManager接口释放native resource manager。
+
+    ```c++
+    OH_ResourceManager_ReleaseNativeResourceManager(nativeResourceManager);
+    ```
+
 ## 开发步骤
 
    以Js侧获取rawfile文件列表、rawfile文件内容、rawfile描述符{fd, offset, length}三种调用方式为例。
@@ -293,89 +379,6 @@
     }
     ```
 
-## 函数介绍
-
-1. 根据NativeResourceManager实例，使用OH_ResourceManager_OpenRawDir接口获取RawDir实例。
-
-    ```c++
-    RawDir* rawDir = OH_ResourceManager_OpenRawDir(nativeResourceManager, path.c_str());
-    ```
-    
-2. 根据RawDir实例，使用OH_ResourceManager_GetRawFileCount接口获取对应目录下的rawfile文件总数 。
-
-    ```c++
-    int count = OH_ResourceManager_GetRawFileCount(rawDir);
-    ```
-    
-3. 根据RawDir实例，使用OH_ResourceManager_GetRawFileName接口获取目录下对应index的rawfile文件名。
-
-    ```c++
-    for (int index = 0; index < count; index++) {
-        std::string fileName = OH_ResourceManager_GetRawFileName(rawDir, index);
-    }
-    ```
-
-4. 根据NativeResourceManager实例，使用OH_ResourceManager_OpenRawFile接口获取指定文件名的RawFile实例
-
-    ```c++
-    RawFile* rawFile = OH_ResourceManager_OpenRawFile(nativeResourceManager, fileName.c_str());
-    ```
-    
-5. 根据RawFile实例，使用OH_ResourceManager_GetRawFileSize接口获取对应rawfile文件大小。
-
-    ```c++
-    long rawFileSize = OH_ResourceManager_GetRawFileSize(rawFile);
-    ```
-
-6. 根据RawFile实例，使用OH_ResourceManager_SeekRawFile接口指定rawfile偏移量。
-
-    ```c++
-    int position = OH_ResourceManager_SeekRawFile(rawFile, 10, 0);
-    int position = OH_ResourceManager_SeekRawFile(rawFile, 0 , 1);
-    int position = OH_ResourceManager_SeekRawFile(rawFile, -10, 2);
-    ```
-
-7. 根据RawFile实例，使用OH_ResourceManager_GetRawFileOffset接口获取rawfile偏移量。
-
-    ```c++
-    long rawFileOffset = OH_ResourceManager_GetRawFileOffset(rawFile)
-    ```
-
-8. 根据RawFile实例，使用OH_ResourceManager_ReadRawFile接口读取rawfile文件内容。
-
-    ```c++
-    std::unique_ptr<char[]> mediaData = std::make_unique<char[]>(rawFileSize);
-    long rawFileOffset = OH_ResourceManager_ReadRawFile(rawFile, mediaData.get(), rawFileSize);
-    ```
-
-9. 根据RawFile实例，使用OH_ResourceManager_CloseRawFile接口释放rawfile文件相关资源。
-
-    ```c++
-    OH_ResourceManager_CloseRawFile(rawFile);
-    ```
-
-10. 根据RawDir实例，使用OH_ResourceManager_CloseRawDir接口释放rawfile目录相关资源。
-
-    ```c++
-    OH_ResourceManager_CloseRawDir(rawDir);
-    ```
-
-11. 根据RawFile实例，使用OH_ResourceManager_GetRawFileDescriptor接口获取rawfile的RawFileDescriptor。
-
-    ```c++
-    RawFileDescriptor descriptor;
-    bool result = OH_ResourceManager_GetRawFileDescriptor(rawFile, descriptor);
-    ```
-
-12. 根据RawFileDescriptor实例，使用OH_ResourceManager_ReleaseRawFileDescriptor接口关闭rawfile的fd。
-
-    ```c++
-    OH_ResourceManager_ReleaseRawFileDescriptor(descriptor);
-    ```
-
-13. 根据NativeResourceManager实例，使用OH_ResourceManager_ReleaseNativeResourceManager接口释放native resource manager。
-
-    ```c++
-    OH_ResourceManager_ReleaseNativeResourceManager(nativeResourceManager);
-    ```
+## 相关实例
+- [`NdkRawfile`：获取Rawfile资源](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Native/NdkRawfile)
 

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

@@ -9,5 +9,6 @@
 - [接口参考（ArkTS及JS API）](apis/Readme-CN.md)
 - [错误码参考](errorcodes/Readme-CN.md)
 - 接口参考（Native API）
+  - [Native API（NDK）入门](native-api-intro.md)
   - [OpenHarmony Native API](native-apis/Readme-CN.md)
   - [Native API标准库](native-lib/Readme-CN.md)

zh-cn/application-dev/reference/apis/commonEventManager-definitions.md

@@ -647,30 +647,20 @@ Wi-Fi P2P群组信息已更改。
 - 值： usual.event.data.DISK_EJECT
 - 订阅者所需权限： ohos.permission.STORAGE_MANAGER
 
-## COMMON_EVENT_VOLUME_REMOVED<sup>9+<sup>
+## [COMMON_EVENT_VOLUME_REMOVED<sup>9+<sup>](./common_event/commonEvent-filemanagement.md)
 外部存储设备状态变更为移除时发送此公共事件。
-- 值： usual.event.data.VOLUME_REMOVED
-- 订阅者所需权限： ohos.permission.STORAGE_MANAGER
 
-## COMMON_EVENT_VOLUME_UNMOUNTED<sup>9+<sup>
+## [COMMON_EVENT_VOLUME_UNMOUNTED<sup>9+<sup>](./common_event/commonEvent-filemanagement.md)
 外部存储设备状态变更为卸载时发送此公共事件。
-- 值： usual.event.data.VOLUME_UNMOUNTED
-- 订阅者所需权限： ohos.permission.STORAGE_MANAGER
 
-## COMMON_EVENT_VOLUME_MOUNTED<sup>9+<sup>
+## [COMMON_EVENT_VOLUME_MOUNTED<sup>9+<sup>](./common_event/commonEvent-filemanagement.md)
 外部存储设备状态变更为挂载时发送此公共事件。
-- 值： usual.event.data.VOLUME_MOUNTED
-- 订阅者所需权限： ohos.permission.STORAGE_MANAGER
 
-## COMMON_EVENT_VOLUME_BAD_REMOVAL<sup>9+<sup>
+## [COMMON_EVENT_VOLUME_BAD_REMOVAL<sup>9+<sup>](./common_event/commonEvent-filemanagement.md)
 外部存储设备状态变更为挂载状态下移除时发送此公共事件。
-- 值： usual.event.data.VOLUME_BAD_REMOVAL
-- 订阅者所需权限： ohos.permission.STORAGE_MANAGER
 
-## COMMON_EVENT_VOLUME_EJECT<sup>9+<sup>
+## [COMMON_EVENT_VOLUME_EJECT<sup>9+<sup>](./common_event/commonEvent-filemanagement.md)
 用户已表示希望删除外部存储介质时发送此公共事件。
-- 值： usual.event.data.VOLUME_EJECT
-- 订阅者所需权限： ohos.permission.STORAGE_MANAGER
 
 ## COMMON_EVENT_VISIBLE_ACCOUNTS_UPDATED
 （预留事件，暂未支持）表示帐户可见更改的公共事件的动作。

zh-cn/application-dev/reference/apis/common_event/Readme-CN.md

@@ -7,3 +7,4 @@
 - [电话服务子系统公共事件定义](commonEvent-telephony.md)
 - [USB子系统公共事件定义](commonEvent-usb.md)
 - [Wifi子系统公共事件定义](commonEvent-wifi.md)
+- [文件管理子系统公共事件定义](commonEvent-filemanagement.md)

zh-cn/application-dev/reference/apis/common_event/commonEvent-filemanagement.md

+# 文件管理子系统公共事件定义
+文件管理子系统面向应用发布如下系统公共事件，应用如需订阅系统公共事件，请参考公共事件[接口文档](../js-apis-commonEventManager.md)。
+
+## COMMON_EVENT_VOLUME_REMOVED<sup>9+<sup>
+表示外部存储设备正常移除的公共事件。
+- 值： usual.event.data.VOLUME_REMOVED
+- 订阅者所需权限： ohos.permission.STORAGE_MANAGER
+
+当外部存储设备处于卸载状态，移除该设备时，会发送此公共事件。
+
+## COMMON_EVENT_VOLUME_UNMOUNTED<sup>9+<sup>
+表示外部存储设备状态变更为卸载的公共事件。
+- 值： usual.event.data.VOLUME_UNMOUNTED
+- 订阅者所需权限： ohos.permission.STORAGE_MANAGER
+
+当外部存储设备处于挂载状态时，用户选择通过调用[unmount](../js-apis-file-volumemanager.md)接口或者直接移除设备的方法弹出该设备，并且已将外部存储设备卸载成功后，会发送此公共事件。
+
+## COMMON_EVENT_VOLUME_MOUNTED<sup>9+<sup>
+表示外部存储设备状态变更为挂载的公共事件。
+- 值： usual.event.data.VOLUME_MOUNTED
+- 订阅者所需权限： ohos.permission.STORAGE_MANAGER
+
+当用户插入外部存储设备自动挂载成功或者将处于卸载状态的外部存储设备调用[mount](../js-apis-file-volumemanager.md)接口进行挂载成功后，会发送此公共事件。
+
+## COMMON_EVENT_VOLUME_BAD_REMOVAL<sup>9+<sup>
+表示外部存储设备异常移除的公共事件。
+- 值： usual.event.data.VOLUME_BAD_REMOVAL
+- 订阅者所需权限： ohos.permission.STORAGE_MANAGER
+
+当外部存储设备处于挂载状态时，用户直接移除该外部存储设备，会发送此公共事件。
+
+## COMMON_EVENT_VOLUME_EJECT<sup>9+<sup>
+表示外部存储设备即将被弹出的公共事件。
+- 值： usual.event.data.VOLUME_EJECT
+- 订阅者所需权限： ohos.permission.STORAGE_MANAGER
+
+当外部存储设备处于挂载状态时，用户选择通过调用[unmount](../js-apis-file-volumemanager.md)接口或者直接移除设备的方法弹出该设备时，会发送此公共事件。

zh-cn/application-dev/reference/apis/js-apis-data-dataShare.md

@@ -375,7 +375,7 @@ delTemplate(uri: string, subscriberId: string): void
 
 | 参数名     | 类型        | 必填 | 说明                       |
 | -------- | -------------| ---- | ------------------------- |
-| uri      | string       | 是   | 指示要插入的数据的路径。     |
+| uri      | string       | 是   | 指示要删除的数据的路径。     |
 | subscriberId | string   | 是   | 订阅者ID，每个订阅者的ID是唯一的。          |
 
 **错误码：**
@@ -558,7 +558,7 @@ let result: Array<dataShare.OperationResult> = dataShareHelper.off("publishedDat
 
 publish(data: Array&lt;PublishedItem&gt;, bundleName: string, version: number, callback: AsyncCallback&lt;Array&lt;OperationResult&gt;&gt;): void
 
-发布数据，将数据数据更新至数据库。
+发布数据，将数据更新至数据库。
 
 **系统能力：**  SystemCapability.DistributedDataManager.DataShare.Consumer
 
@@ -616,7 +616,7 @@ try {
 
 publish(data: Array&lt;PublishedItem&gt;, bundleName: string, callback: AsyncCallback&lt;Array&lt;OperationResult&gt;&gt;): void
 
-发布数据，将数据数据更新至数据库。
+发布数据，将数据更新至数据库。
 
 **系统能力：**  SystemCapability.DistributedDataManager.DataShare.Consumer
 
@@ -653,7 +653,7 @@ dataShareHelper.publish(data, "com.acts.ohos.data.datasharetest", publishCallbac
 
 publish(data: Array&lt;PublishedItem&gt;, bundleName: string, version?: number): Promise&lt;Array&lt;OperationResult&gt;&gt;
 
-发布数据，将数据数据更新至数据库。
+发布数据，将数据更新至数据库。
 
 **系统能力：**  SystemCapability.DistributedDataManager.DataShare.Consumer
 

zh-cn/application-dev/reference/apis/js-apis-huks.md

@@ -2260,10 +2260,10 @@ async function huksAbort() {
 
 | 名称                                          | 值   | 说明                           |
 | --------------------------------------------  | ---- | ------------------------------ |
-| HUKS_STORAGE_TEMP                             | 0    | 表示通过本地直接管理密钥。     |
-| HUKS_STORAGE_PERSISTENT                       | 1    | 表示通过HUKS service管理密钥。 |
-| HUKS_STORAGE_ONLY_USED_IN_HUKS<sup>10+</sup>  | 2    | 表示密钥只存储在huks中。       |
-| HUKS_STORAGE_KEY_EXPORT_ALLOWED<sup>10+</sup> | 3    | 表示密钥从huks中导出，不存储。 |
+| HUKS_STORAGE_TEMP<sup>(deprecated)</sup>      | 0    | 表示通过本地直接管理密钥。<br/>> **说明：** 从API version 10开始废弃，由于开发者正常使用密钥管理过程中并不需要使用此TAG，故无替代接口。针对针对密钥派生场景，可使用HUKS_STORAGE_ONLY_USED_IN_HUKS 与 HUKS_STORAGE_KEY_EXPORT_ALLOWED。 |
+| HUKS_STORAGE_PERSISTENT<sup>(deprecated)</sup>      | 1    | 表示通过HUKS service管理密钥。<br/>> **说明：** 从API version 10开始废弃，由于开发者正常使用密钥管理过程中并不需要使用此TAG，故无替代接口。针对密钥派生场景，可使用HUKS_STORAGE_ONLY_USED_IN_HUKS 与 HUKS_STORAGE_KEY_EXPORT_ALLOWED。 |
+| HUKS_STORAGE_ONLY_USED_IN_HUKS<sup>10+</sup>  | 2    | 表示主密钥派生的密钥存储于huks中，由HUKS进行托管       |
+| HUKS_STORAGE_KEY_EXPORT_ALLOWED<sup>10+</sup> | 3    | 表示主密钥派生的密钥直接导出给业务方，HUKS不对其进行托管服务 |
 
 ## HuksSendType
 

zh-cn/application-dev/reference/apis/js-apis-webview.md

@@ -328,6 +328,7 @@ struct WebComponent {
 }
 ```
 
+加载的html文件。
 ```html
 <!--index.html-->
 <!DOCTYPE html>
@@ -447,7 +448,7 @@ struct WebComponent {
       Button('close')
         .onClick(() => {
           try {
-            if (this.msgPort && this.msgPort[1]) {
+            if (this.msgPort && this.msgPort.length == 2) {
               this.msgPort[1].close();
             } else {
               console.error("msgPort is null, Please initialize first");
@@ -667,7 +668,7 @@ struct WebComponent {
         .onClick(() => {
           try {
             // 通过$rawfile加载本地资源文件。
-            this.controller.loadUrl($rawfile('xxx.html'));
+            this.controller.loadUrl($rawfile('index.html'));
           } catch (error) {
             console.error(`ErrorCode: ${error.code},  Message: ${error.message}`);
           }
@@ -694,7 +695,7 @@ struct WebComponent {
         .onClick(() => {
           try {
             // 通过resource协议加载本地资源文件。
-            this.controller.loadUrl("resource://rawfile/xxx.html");
+            this.controller.loadUrl("resource://rawfile/index.html");
           } catch (error) {
             console.error(`ErrorCode: ${error.code},  Message: ${error.message}`);
           }
@@ -707,8 +708,9 @@ struct WebComponent {
 
 3.通过沙箱路径加载本地文件，可以参考[web](../arkui-ts/ts-basic-components-web.md#web)加载沙箱路径的示例代码。
 
+加载的html文件。
 ```html
-<!-- xxx.html -->
+<!-- index.html -->
 <!DOCTYPE html>
 <html>
   <body>
@@ -1339,6 +1341,23 @@ struct Index {
 }
 ```
 
+加载的html文件。
+```html
+<!-- index.html -->
+<!DOCTYPE html>
+<html>
+    <meta charset="utf-8">
+    <body>
+        Hello world!
+    </body>
+    <script type="text/javascript">
+    function htmlTest() {
+        str = objName.test("test function")
+        console.log('objName.test result:'+ str)
+    }
+</script>
+</html>
+
 ### runJavaScript
 
 runJavaScript(script: string, callback : AsyncCallback\<string>): void
@@ -1402,6 +1421,24 @@ struct WebComponent {
 }
 ```
 
+加载的html文件。
+```html
+<!-- index.html -->
+<!DOCTYPE html>
+<html>
+  <meta charset="utf-8">
+  <body>
+      Hello world!
+  </body>
+  <script type="text/javascript">
+  function test() {
+      console.log('Ark WebComponent')
+      return "This value is from index.html"
+  }
+  </script>
+</html>
+```
+
 ### runJavaScript
 
 runJavaScript(script: string): Promise\<string>
@@ -1466,6 +1503,23 @@ struct WebComponent {
 }
 ```
 
+加载的html文件。
+```html
+<!-- index.html -->
+<!DOCTYPE html>
+<html>
+  <meta charset="utf-8">
+  <body>
+      Hello world!
+  </body>
+  <script type="text/javascript">
+  function test() {
+      console.log('Ark WebComponent')
+      return "This value is from index.html"
+  }
+  </script>
+</html>
+```
 
 ### runJavaScriptExt<sup>10+</sup>
 
@@ -1565,8 +1619,11 @@ struct WebComponent {
     }
   }
 }
+```
 
-//index.html
+加载的html文件。
+```html
+<!-- index.html -->
 <!DOCTYPE html>
 <html lang="en-gb">
 <body>
@@ -1677,8 +1734,11 @@ struct WebComponent {
     }
   }
 }
+```
 
-//index.html
+加载的html文件。
+```html
+<!-- index.html -->
 <!DOCTYPE html>
 <html lang="en-gb">
 <body>
@@ -2174,14 +2234,15 @@ struct WebComponent {
             console.error(`ErrorCode: ${error.code}, Message: ${error.message}`);
           }
         })
-      Web({ src: $rawfile('xxx.html'), controller: this.controller })
+      Web({ src: $rawfile('index.html'), controller: this.controller })
     }
   }
 }
 ```
 
+加载的html文件。
 ```html
-<!--xxx.html-->
+<!--index.html-->
 <!DOCTYPE html>
 <html>
 <head>
@@ -2969,14 +3030,15 @@ struct WebComponent {
             console.error(`ErrorCode: ${error.code},  Message: ${error.message}`);
           }
         })
-      Web({ src: 'www.example.com', controller: this.controller })
+      Web({ src: $rawfile('index.html'), controller: this.controller })
     }
   }
 }
 ```
 
+加载的html文件。
 ```html
-<!--xxx.html-->
+<!--index.html-->
 <!DOCTYPE html>
 <html>
 <head>
@@ -3041,14 +3103,15 @@ struct WebComponent {
             console.error(`ErrorCode: ${error.code},  Message: ${error.message}`);
           }
         })
-      Web({ src: 'www.example.com', controller: this.controller })
+      Web({ src: $rawfile('index.html'), controller: this.controller })
     }
   }
 }
 ```
 
+加载的html文件。
 ```html
-<!--xxx.html-->
+<!--index.html-->
 <!DOCTYPE html>
 <html>
 <head>
@@ -3113,14 +3176,15 @@ struct WebComponent {
             console.error(`ErrorCode: ${error.code},  Message: ${error.message}`);
           }
         })
-      Web({ src: 'www.example.com', controller: this.controller })
+      Web({ src: $rawfile('index.html'), controller: this.controller })
     }
   }
 }
 ```
 
+加载的html文件。
 ```html
-<!--xxx.html-->
+<!--index.html-->
 <!DOCTYPE html>
 <html>
 <head>

zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md

@@ -90,7 +90,7 @@ Web(options: { src: ResourceStr, controller: WebviewController | WebController})
   ```ts
   // xxx.ets
   import web_webview from '@ohos.web.webview'
-  let url = 'file://' + globalThis.filesDir + '/xxx.html'
+  let url = 'file://' + globalThis.filesDir + '/index.html'
 
   @Entry
   @Component
@@ -121,6 +121,7 @@ Web(options: { src: ResourceStr, controller: WebviewController | WebController})
   }
   ```
 
+  加载的html文件。
   ```html
   <!-- index.html -->
   <!DOCTYPE html>
@@ -585,15 +586,16 @@ horizontalScrollBarAccess(horizontalScrollBar: boolean)
     controller: web_webview.WebviewController = new web_webview.WebviewController()
     build() {
       Column() {
-        Web({ src: 'www.example.com', controller: this.controller })
+        Web({ src: $rawfile('index.html'), controller: this.controller })
         .horizontalScrollBarAccess(true)
       }
     }
   }
   ```
 
+  加载的html文件。
   ```html
-  <!--xxx.html-->
+  <!--index.html-->
   <!DOCTYPE html>
   <html>
   <head>
@@ -638,15 +640,16 @@ verticalScrollBarAccess(verticalScrollBar: boolean)
     controller: web_webview.WebviewController = new web_webview.WebviewController()
     build() {
       Column() {
-        Web({ src: 'www.example.com', controller: this.controller })
+        Web({ src: $rawfile('index.html'), controller: this.controller })
         .verticalScrollBarAccess(true)
       }
     }
   }
   ```
 
+  加载的html文件。
   ```html
-  <!--xxx.html-->
+  <!--index.html-->
   <!DOCTYPE html>
   <html>
   <head>
@@ -1418,7 +1421,7 @@ onAlert(callback: (event?: { url: string; message: string; result: JsResult }) =
     controller: web_webview.WebviewController = new web_webview.WebviewController()
     build() {
       Column() {
-        Web({ src: $rawfile("xxx.html"), controller: this.controller })
+        Web({ src: $rawfile("index.html"), controller: this.controller })
           .onAlert((event) => {
             console.log("event.url:" + event.url)
             console.log("event.message:" + event.message)
@@ -1448,8 +1451,9 @@ onAlert(callback: (event?: { url: string; message: string; result: JsResult }) =
   }
   ```
 
-  ```
-  <!--xxx.html-->
+  加载的html文件。
+  ```html
+  <!--index.html-->
   <!DOCTYPE html>
   <html>
   <head>
@@ -1500,7 +1504,7 @@ onBeforeUnload(callback: (event?: { url: string; message: string; result: JsResu
 
     build() {
       Column() {
-        Web({ src: $rawfile("xxx.html"), controller: this.controller })
+        Web({ src: $rawfile("index.html"), controller: this.controller })
           .onBeforeUnload((event) => {
             console.log("event.url:" + event.url)
             console.log("event.message:" + event.message)
@@ -1530,8 +1534,9 @@ onBeforeUnload(callback: (event?: { url: string; message: string; result: JsResu
   }
   ```
 
-  ```
-  <!--xxx.html-->
+  加载的html文件。
+  ```html
+  <!--index.html-->
   <!DOCTYPE html>
   <html>
   <head>
@@ -1582,7 +1587,7 @@ onConfirm(callback: (event?: { url: string; message: string; result: JsResult })
 
     build() {
       Column() {
-        Web({ src: $rawfile("xxx.html"), controller: this.controller })
+        Web({ src: $rawfile("index.html"), controller: this.controller })
           .onConfirm((event) => {
             console.log("event.url:" + event.url)
             console.log("event.message:" + event.message)
@@ -1612,8 +1617,9 @@ onConfirm(callback: (event?: { url: string; message: string; result: JsResult })
   }
   ```
 
-  ```
-  <!--xxx.html-->
+  加载的html文件。
+  ```html
+  <!--index.html-->
   <!DOCTYPE html>
   <html>
   <head>
@@ -1671,7 +1677,7 @@ onPrompt(callback: (event?: { url: string; message: string; value: string; resul
 
     build() {
       Column() {
-        Web({ src: $rawfile("xxx.html"), controller: this.controller })
+        Web({ src: $rawfile("index.html"), controller: this.controller })
           .onPrompt((event) => {
             console.log("url:" + event.url)
             console.log("message:" + event.message)
@@ -1702,8 +1708,9 @@ onPrompt(callback: (event?: { url: string; message: string; value: string; resul
   }
   ```
 
-  ```
-  <!--xxx.html-->
+  加载的html文件。
+  ```html
+  <!--index.html-->
   <!DOCTYPE html>
   <html>
   <head>
@@ -4933,6 +4940,7 @@ registerJavaScriptProxy(options: { object: object, name: string, methodList: Arr
   }
   ```
 
+  加载的html文件。
   ```html
   <!-- index.html -->
   <!DOCTYPE html>
@@ -4993,7 +5001,7 @@ runJavaScript(options: { script: string, callback?: (result: string) => void })
     }
   }
   ```
-
+  加载的html文件。
   ```html
   <!-- index.html -->
   <!DOCTYPE html>
@@ -5009,7 +5017,6 @@ runJavaScript(options: { script: string, callback?: (result: string) => void })
     }
     </script>
   </html>
-
   ```
 
 ### stop<sup>(deprecated)</sup>
@@ -5075,18 +5082,11 @@ clearHistory(): void
 通过WebCookie可以控制Web组件中的cookie的各种行为，其中每个应用中的所有web组件共享一个WebCookie。通过controller方法中的getCookieManager方法可以获取WebCookie对象，进行后续的cookie管理操作。
 
 ### setCookie<sup>(deprecated)</sup>
-setCookie(url: string, value: string): boolean
+setCookie(): boolean
 
 设置cookie，该方法为同步方法。设置成功返回true，否则返回false。
 从API version 9开始不再维护，建议使用[setCookie<sup>9+</sup>](../apis/js-apis-webview.md#setcookie)代替。
 
-**参数：**
-
-| 参数名   | 参数类型   | 必填   | 默认值  | 参数描述              |
-| ----- | ------ | ---- | ---- | ----------------- |
-| url   | string | 是    | -    | 要设置的cookie所属的url，建议使用完整的url。 |
-| value | string | 是    | -    | cookie的值。         |
-
 **返回值：**
 
 | 类型      | 说明            |
@@ -5106,7 +5106,7 @@ setCookie(url: string, value: string): boolean
       Column() {
         Button('setCookie')
           .onClick(() => {
-            let result = this.controller.getCookieManager().setCookie("https://www.example.com", "a=b")
+            let result = this.controller.getCookieManager().setCookie()
             console.log("result: " + result)
           })
         Web({ src: 'www.example.com', controller: this.controller })

zh-cn/application-dev/reference/arkui-ts/ts-canvasrenderingcontext2d.md

@@ -17,8 +17,8 @@ CanvasRenderingContext2D(settings?: RenderingContextSettings)
 **参数：**
 
 | 参数名      | 参数类型                                     | 必填   | 参数描述                                     |
-| ------- | ---------------------------------------- | ---- | ---------------------------------------- |
-| setting | [RenderingContextSettings](#renderingcontextsettings) | 否    | 见[RenderingContextSettings](#renderingcontextsettings)。 |
+| -------- | ---------------------------------------- | ---- | ---------------------------------------- |
+| settings | [RenderingContextSettings](#renderingcontextsettings) | 否    | 见[RenderingContextSettings](#renderingcontextsettings)。 |
 
 
 ### RenderingContextSettings
@@ -39,7 +39,7 @@ RenderingContextSettings(antialias?: boolean)
 ## 属性
 
 | 名称                                       | 类型                                       | 描述                                       |
-| ----------------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
+| ---------------------------------------- | ---------------------------------------- | ---------------------------------------- |
 | [fillStyle](#fillstyle)                  | string&nbsp;\|number<sup>10+</sup>&nbsp;\|[CanvasGradient](ts-components-canvas-canvasgradient.md)&nbsp;\|&nbsp;[CanvasPattern](ts-components-canvas-canvaspattern.md#canvaspattern) | 指定绘制的填充色。<br/>-&nbsp;类型为string时，表示设置填充区域的颜色。<br/>- 类型为number时，表示设置填充区域的颜色。<br/>-&nbsp;类型为CanvasGradient时，表示渐变对象，使用[createLinearGradient](#createlineargradient)方法创建。<br/>-&nbsp;类型为CanvasPattern时，使用[createPattern](#createpattern)方法创建。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
 | [lineWidth](#linewidth)                  | number                                   | 设置绘制线条的宽度。                               |
 | [strokeStyle](#strokestyle)              | string&nbsp;\|number<sup>10+</sup>&nbsp;\|[CanvasGradient](ts-components-canvas-canvasgradient.md)&nbsp;\|&nbsp;[CanvasPattern](ts-components-canvas-canvaspattern.md#canvaspattern) | 设置描边的颜色。<br/>-&nbsp;类型为string时，表示设置描边使用的颜色。<br/>- 类型为number时，表示设置描边使用的颜色。<br/>-&nbsp;类型为CanvasGradient时，表示渐变对象，使用[createLinearGradient](#createlineargradient)方法创建。<br/>-&nbsp;类型为CanvasPattern时，使用[createPattern](#createpattern)方法创建。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
@@ -59,9 +59,9 @@ RenderingContextSettings(antialias?: boolean)
 | [imageSmoothingEnabled](#imagesmoothingenabled) | boolean                                  | 用于设置绘制图片时是否进行图像平滑度调整，true为启用，false为不启用。 <br/>默认值：true<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
 | [height](#height)                        | number                                   | 组件高度。 <br/>单位：vp<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
 | [width](#width)                          | number                                   | 组件宽度。 <br/>单位：vp<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
-| [imageSmoothingQuality](#imagesmoothingquality)       |ImageSmoothingQuality     | imageSmoothingEnabled为true时，用于设置图像平滑度。可选值为：<br/>- 'low'：低画质<br/>- 'medium'：中画质<br/>- 'high'：高画质。<br/>默认值：low<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
-| [direction](#direction)       |CanvasDirection     | 用于设置绘制文字时使用的文字方向。可选值为：<br/>- 'inherit'：继承canvas组件已设定的文本方向<br/>- 'ltr'：从左往右<br/>- 'rtl'：从右往左。<br/>默认值：inherit<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
-| [filter](#filter)       |string     | 用于设置图像的滤镜。支持的滤镜效果如下：<br/>- 'none': 无滤镜效果<br/>- 'blur'：给图像设置高斯模糊<br/>- 'brightness'：给图片应用一种线性乘法，使其看起来更亮或更暗<br/>- 'contrast'：调整图像的对比度<br/>- 'grayscale'：将图像转换为灰度图像<br/>- 'hue-rotate'：给图像应用色相旋转<br/>- 'invert'：反转输入图像<br/>- 'opacity'：转化图像的透明程度<br/>- 'saturate'：转换图像饱和度<br/>- 'sepia'：将图像转换为深褐色<br/>默认值：'none'<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
+| [imageSmoothingQuality](#imagesmoothingquality) | ImageSmoothingQuality                    | imageSmoothingEnabled为true时，用于设置图像平滑度。可选值为：<br/>- 'low'：低画质<br/>- 'medium'：中画质<br/>- 'high'：高画质。<br/>默认值：low<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
+| [direction](#direction)                  | CanvasDirection                          | 用于设置绘制文字时使用的文字方向。可选值为：<br/>- 'inherit'：继承canvas组件已设定的文本方向<br/>- 'ltr'：从左往右<br/>- 'rtl'：从右往左。<br/>默认值：inherit<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
+| [filter](#filter)                        | string                                   | 用于设置图像的滤镜。支持的滤镜效果如下：<br/>- 'none': 无滤镜效果<br/>- 'blur'：给图像设置高斯模糊<br/>- 'brightness'：给图片应用一种线性乘法，使其看起来更亮或更暗<br/>- 'contrast'：调整图像的对比度<br/>- 'grayscale'：将图像转换为灰度图像<br/>- 'hue-rotate'：给图像应用色相旋转<br/>- 'invert'：反转输入图像<br/>- 'opacity'：转化图像的透明程度<br/>- 'saturate'：转换图像饱和度<br/>- 'sepia'：将图像转换为深褐色<br/>默认值：'none'<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
 
 > **说明：**
 >
@@ -873,7 +873,7 @@ fillText(text: string, x: number, y: number, maxWidth?: number): void
 **参数：**
 
 | 参数       | 类型     | 必填   | 默认值  | 说明              |
-| -------- | ------ | ---- | ------ | ----------------------------- |
+| -------- | ------ | ---- | ---- | --------------- |
 | text     | string | 是    | ''   | 需要绘制的文本内容。      |
 | x        | number | 是    | 0    | 需要绘制的文本的左下角x坐标。 |
 | y        | number | 是    | 0    | 需要绘制的文本的左下角y坐标。 |
@@ -920,7 +920,7 @@ strokeText(text: string, x: number, y: number, maxWidth?:number): void
 **参数：**
 
 | 参数       | 类型     | 必填   | 默认值  | 描述              |
-| -------- | ------ | ---- | ------ | ----------------------------- |
+| -------- | ------ | ---- | ---- | --------------- |
 | text     | string | 是    | ''   | 需要绘制的文本内容。      |
 | x        | number | 是    | 0    | 需要绘制的文本的左下角x坐标。 |
 | y        | number | 是    | 0    | 需要绘制的文本的左下角y坐标。 |
@@ -967,13 +967,13 @@ measureText(text: string): TextMetrics
 **参数：**
 
 | 参数   | 类型     | 必填   | 默认值  | 说明         |
-| ---- | ------ | ---- | ------ | -------------------- |
+| ---- | ------ | ---- | ---- | ---------- |
 | text | string | 是    | ''   | 需要进行测量的文本。 |
 
 **返回值：**
 
 | 类型          | 说明                                       |
-| ----------- | ------------------------------------------------------------ |
+| ----------- | ---------------------------------------- |
 | TextMetrics | 文本的尺寸信息。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
 
 **TextMetrics类型描述:**
@@ -1265,14 +1265,14 @@ createPattern(image: ImageBitmap, repetition: string | null): CanvasPattern | nu
 **参数：**
 
 | 参数         | 类型                                       | 必填   | 描述                                       |
-| ---------- | -------------------------------------------------- | ---- | ------------------------------------------------------------ |
+| ---------- | ---------------------------------------- | ---- | ---------------------------------------- |
 | image      | [ImageBitmap](ts-components-canvas-imagebitmap.md) | 是    | 图源对象，具体参考ImageBitmap对象。                  |
 | repetition | string                                   | 是    | 设置图像重复的方式，取值为：'repeat'、'repeat-x'、&nbsp'repeat-y'、'no-repeat'、'clamp'、'mirror'。<br/>默认值：'' |
 
 **返回值：**
 
 | 类型                                       | 说明                      |
-| ------------------------------- | ----------------------- |
+| ---------------------------------------- | ----------------------- |
 | [CanvasPattern](ts-components-canvas-canvaspattern.md#canvaspattern) | 通过指定图像和重复方式创建图片填充的模板对象。 |
 
 **示例：**
@@ -1517,7 +1517,7 @@ ellipse(x: number, y: number, radiusX: number, radiusY: number, rotation: number
 **参数：**
 
 | 参数               | 类型      | 必填   | 默认值   | 说明                                       |
-| ---------------- | ------- | ---- | ----- | ----------------- |
+| ---------------- | ------- | ---- | ----- | ---------------------------------------- |
 | x                | number  | 是    | 0     | 椭圆圆心的x轴坐标。                               |
 | y                | number  | 是    | 0     | 椭圆圆心的y轴坐标。                               |
 | radiusX          | number  | 是    | 0     | 椭圆x轴的半径长度。                               |
@@ -1813,7 +1813,7 @@ filter(filter: string): void
 **参数:**
 
 | 参数     | 类型     | 必填   | 默认值  | 说明                                       |
-| ------ | ------ | ---- | ---- | ------------ |
+| ------ | ------ | ---- | ---- | ---------------------------------------- |
 | filter | string | 是    | -    | 接受各类滤镜效果的函数。支持的滤镜效果如下：<br/>- 'none': 无滤镜效果<br/>- 'blur'：给图像设置高斯模糊<br/>- 'brightness'：给图片应用一种线性乘法，使其看起来更亮或更暗<br/>- 'contrast'：调整图像的对比度<br/>- 'grayscale'：将图像转换为灰度图像<br/>- 'hue-rotate'：给图像应用色相旋转<br/>- 'invert'：反转输入图像<br/>- 'opacity'：转化图像的透明程度<br/>- 'saturate'：转换图像饱和度<br/>- 'sepia'：将图像转换为深褐色<br/>默认值：'none' |
 
 **示例：**
@@ -1889,7 +1889,7 @@ getTransform(): Matrix2D
 **返回值：**
 
 | 类型                                       | 说明    |
-| ----------------------------------------------------- | ---------- |
+| ---------------------------------------- | ----- |
 | [Matrix2D](ts-components-canvas-matrix2d.md#Matrix2D) | 矩阵对象。 |
 
 
@@ -2158,7 +2158,7 @@ setTransform(transform?: Matrix2D): void
 **参数：**
 
 | 参数        | 类型                                       | 必填   | 默认值  | 描述    |
-| --------- | ----------------------------------------------------- | ---- | ------ | ---------- |
+| --------- | ---------------------------------------- | ---- | ---- | ----- |
 | transform | [Matrix2D](ts-components-canvas-matrix2d.md#Matrix2D) | 否    | null | 变换矩阵。 |
 
 ### translate
@@ -2389,7 +2389,7 @@ putImageData(imageData: ImageData, dx: number | string, dy: number | string, dir
 **参数：**
 
 | 参数          | 类型                                       | 必填   | 默认值          | 描述                            |
-| ----------- | ---------------------------------------------- | ---- | --------------- | --------------------------------------------------------- |
+| ----------- | ---------------------------------------- | ---- | ------------ | ----------------------------- |
 | imagedata   | [ImageData](ts-components-canvas-imagedata.md) | 是    | null         | 包含像素值的ImageData对象。            |
 | dx          | number&nbsp;\|&nbsp;string<sup>10+</sup> | 是    | 0            | 填充区域在x轴方向的偏移量。                |
 | dy          | number&nbsp;\|&nbsp;string<sup>10+</sup> | 是    | 0            | 填充区域在y轴方向的偏移量。                |
@@ -2874,7 +2874,7 @@ createConicGradient(startAngle: number, x: number, y: number): CanvasGradient
 **参数：**
 
 | 参数         | 类型     | 必填   | 默认值  | 描述                                  |
-| ---------- | ------ | ---- | ------ | ------------------------------------------------------------ |
+| ---------- | ------ | ---- | ---- | ----------------------------------- |
 | startAngle | number | 是    | 0    | 开始渐变的角度，以弧度为单位。角度测量从中心右侧水平开始，顺时针移动。 |
 | x          | number | 是    | 0    | 圆锥渐变的中心x轴坐标。单位：vp                   |
 | y          | number | 是    | 0    | 圆锥渐变的中心y轴坐标。单位：vp                   |

zh-cn/application-dev/reference/arkui-ts/ts-container-list.md

@@ -40,7 +40,7 @@ List(value?:{space?: number | string, initialIndex?: number, scroller?
 **参数：**
 
 | 参数名          | 参数类型                                     | 必填   | 参数描述                                     |
-| -------- | -------- | -------- | -------- |
+| ------------ | ---------------------------------------- | ---- | ---------------------------------------- |
 | space        | number&nbsp;\|&nbsp;string               | 否    | 子组件主轴方向的间隔。<br/>默认值：0<br/>**说明：** <br/>设置为除-1外其他负数或百分比时，按默认值显示。<br/>space参数值小于List分割线宽度时，子组件主轴方向的间隔取分割线宽度。 |
 | initialIndex | number                                   | 否    | 设置当前List初次加载时视口起始位置显示的item的索引值。<br/>默认值：0<br/>**说明：** <br/>设置为除-1外其他负数或超过了当前List最后一个item的索引值时视为无效取值，无效取值按默认值显示。 |
 | scroller     | [Scroller](ts-container-scroll.md#scroller) | 否    | 可滚动组件的控制器。用于与可滚动组件进行绑定。<br/>**说明：** <br/>不允许和其他滚动类组件绑定同一个滚动控制对象。 |
@@ -50,7 +50,7 @@ List(value?:{space?: number&nbsp;|&nbsp;string, initialIndex?: number, scroller?
 除支持[通用属性](ts-universal-attributes-size.md)外，还支持以下属性：
 
 | 名称                                  | 参数类型                                     | 描述                                       |
-| -------- | -------- | -------- |
+| ----------------------------------- | ---------------------------------------- | ---------------------------------------- |
 | listDirection                       | [Axis](ts-appendix-enums.md#axis)        | 设置List组件排列方向。<br/>默认值：Axis.Vertical<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
 | divider                             | {<br/>strokeWidth:&nbsp;[Length](ts-types.md#length),<br/>color?:[ResourceColor](ts-types.md#resourcecolor),<br/>startMargin?:&nbsp;Length,<br/>endMargin?:&nbsp;Length<br/>}&nbsp;\|&nbsp;null | 设置ListItem分割线样式，默认无分割线。<br/>- strokeWidth:&nbsp;分割线的线宽。<br/>- color:&nbsp;分割线的颜色。<br/>- startMargin:&nbsp;分割线与列表侧边起始端的距离。<br/>- endMargin:&nbsp;分割线与列表侧边结束端的距离。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。<br/>endMargin +startMargin 不能超过列宽度。 <br/>startMargin和endMargin不支持设置百分比。<br/>List的分割线画在主轴方向两个子组件之间，第一个子组件上方和最后一个子组件下方不会绘制分割线。<br/>多列模式下，ListItem与ListItem之间的分割线起始边距从每一列的交叉轴方向起始边开始计算，其他情况从List交叉轴方向起始边开始计算。 |
 | scrollBar                           | [BarState](ts-appendix-enums.md#barstate) | 设置滚动条状态。<br/>默认值：BarState.Off<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。<br/>**说明：** <br/>API version 9及以下版本默认值为BarState.Off，API version 10的默认值为BarState.Auto。 |
@@ -58,7 +58,7 @@ List(value?:{space?: number&nbsp;|&nbsp;string, initialIndex?: number, scroller?
 | editMode<sup>(deprecated)</sup>     | boolean                                  | 声明当前List组件是否处于可编辑模式。<br/>从API version9开始废弃。可参考[示例3](#示例3)实现删除选中的list项。<br/>默认值：false |
 | edgeEffect                          | [EdgeEffect](ts-appendix-enums.md#edgeeffect) | 设置组件的滑动效果，支持弹簧效果和阴影效果。<br/>默认值：EdgeEffect.Spring<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
 | chainAnimation                      | boolean                                  | 设置当前List是否启用链式联动动效，开启后列表滑动以及顶部和底部拖拽时会有链式联动的效果。链式联动效果：List内的list-item间隔一定距离，在基本的滑动交互行为下，主动对象驱动从动对象进行联动，驱动效果遵循弹簧物理动效。<br/>默认值：false<br/>-&nbsp;false：不启用链式联动。<br/>-&nbsp;true：启用链式联动。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。<br/>**说明：**<br/>链式动效生效后，List的分割线不显示。<br>链式动效生效需要满足以下前提条件：<br> -&nbsp; List边缘效果为Spring类型<br> -&nbsp; List没有启用多列模式 |
-|chainAnimationOptions<sup>10+</sup>| [ChainAnimationOptions](#chainanimationoptions10对象说明) | 设置链式联动动效参数。<br>**系统API：** 此接口为系统接口。 |
+| chainAnimationOptions<sup>10+</sup> | [ChainAnimationOptions](#chainanimationoptions10对象说明) | 设置链式联动动效参数。<br>**系统API：** 此接口为系统接口。      |
 | multiSelectable<sup>8+</sup>        | boolean                                  | 是否开启鼠标框选。<br/>默认值：false<br/>-&nbsp;false：关闭框选。<br/>-&nbsp;true：开启框选。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
 | lanes<sup>9+</sup>                  | number \| [LengthConstrain](ts-types.md#lengthconstrain) | 以列模式为例（listDirection为Axis.Vertical）:<br/>lanes用于决定List组件在交叉轴方向按几列布局。<br/>默认值：1<br/>规则如下：<br/>-&nbsp;lanes为指定的数量时，根据指定的数量与List组件的交叉轴尺寸除以列数作为列的宽度。<br/>-&nbsp;lanes设置了{minLength，maxLength}时，根据List组件的宽度自适应决定lanes数量（即列数），保证缩放过程中lane的宽度符合{minLength，maxLength}的限制。其中，minLength条件会被优先满足，即优先保证符合ListItem的交叉轴尺寸符合最小限制。<br/>-&nbsp;lanes设置了{minLength，maxLength}，如果父组件交叉轴方向尺寸约束为无穷大时，固定按一列排列，列宽度按显示区域内最大的ListItem计算<br/>-&nbsp;ListItemGroup在多列模式下也是独占一行，ListItemGroup中的ListItem按照List组件的lanes属性设置值来布局。<br/>-&nbsp;lanes设置了{minLength，maxLength}时，计算列数会按照ListItemGroup的交叉轴尺寸计算。当ListItemGroup交叉轴尺寸与List交叉轴尺寸不一致时ListItemGroup中的列数与List中的列数可能不一样。<br/>该接口支持在ArkTS卡片中使用。 |
 | alignListItem<sup>9+</sup>          | [ListItemAlign](#listitemalign9枚举说明)     | List交叉轴方向宽度大于ListItem交叉轴宽度 * lanes时，ListItem在List交叉轴方向的布局方式，默认为首部对齐。<br/>默认值：ListItemAlign.Start<br/>该接口支持在ArkTS卡片中使用。 |
@@ -69,7 +69,7 @@ List(value?:{space?: number&nbsp;|&nbsp;string, initialIndex?: number, scroller?
 该接口支持在ArkTS卡片中使用。
 
 | 名称     | 描述                        |
-| ------ | -------------------------------------- |
+| ------ | ------------------------- |
 | Start  | ListItem在List中，交叉轴方向首部对齐。 |
 | Center | ListItem在List中，交叉轴方向居中对齐。 |
 | End    | ListItem在List中，交叉轴方向尾部对齐。 |
@@ -79,7 +79,7 @@ List(value?:{space?: number&nbsp;|&nbsp;string, initialIndex?: number, scroller?
 该接口支持在ArkTS卡片中使用。
 
 | 名称     | 描述                                 |
-| ------ | -------------------------------------- |
+| ------ | ---------------------------------- |
 | None   | ListItemGroup的header不吸顶，footer不吸底。 |
 | Header | ListItemGroup的header吸顶，footer不吸底。  |
 | Footer | ListItemGroup的footer吸底，header不吸底。  |
@@ -91,7 +91,7 @@ List(value?:{space?: number&nbsp;|&nbsp;string, initialIndex?: number, scroller?
 **系统API：** 此接口为系统接口
 
 | 名称      | 描述                                       |
-| ------ | -------------------------------------- |
+| ------- | ---------------------------------------- |
 | DEFAULT | 默认效果，列表滚动到边缘以后继续拖动，拖拽方向上的列表项间距缩小，拖拽反方向上的列表项间距扩大。 |
 | STRETCH | 列表滚动到边缘以后继续拖动，所有列表项间距扩大。                 |
 
@@ -102,12 +102,12 @@ List(value?:{space?: number&nbsp;|&nbsp;string, initialIndex?: number, scroller?
 **系统API：** 此接口为系统接口
 
 | 名称           | 类型                                       | 必填   | 说明                                       |
-| ------ | ------ | ---- | --------------- |
+| ------------ | ---------------------------------------- | ---- | ---------------------------------------- |
 | minSpace     | [Length](ts-types.md#length)             | 是    | 设置链式联动动效最小间距。                            |
 | maxSpace     | [Length](ts-types.md#length)             | 是    | 设置链式联动动效最大间距。                            |
 | conductivity | number                                   | 否    | 设置链式联动动效传导系数。取值范围[0,1]，数值越大，动效传导范围越远。<br/>默认为0.7。 |
 | intensity    | number                                   | 否    | 设置链式联动动效效果强度。取值范围[0,1]，数值越大，动效效果越明显。<br/>默认为0.3。 |
-| edgeEffect | [ChainEdgeEffect](#chainedgeeffect10枚举说明) | 否 | 设置链式联动动效边缘效果。<br/>默认为ChainEdgeEffect.DEFAULT。|
+| edgeEffect   | [ChainEdgeEffect](#chainedgeeffect10枚举说明) | 否    | 设置链式联动动效边缘效果。<br/>默认为ChainEdgeEffect.DEFAULT。 |
 
 > **说明：** 
 >
@@ -116,7 +116,7 @@ List(value?:{space?: number&nbsp;|&nbsp;string, initialIndex?: number, scroller?
 ## 事件
 
 | 名称                                       | 功能描述                                     |
-| -------- | -------- |
+| ---------------------------------------- | ---------------------------------------- |
 | onItemDelete<sup>(deprecated)</sup>(event: (index: number) => boolean) | 当List组件在编辑模式时，点击ListItem右边出现的删除按钮时触发。<br/>从API version9开始废弃。<br/>- index: 被删除的列表项的索引值。 |
 | onScroll(event: (scrollOffset: number, scrollState: ScrollState) => void) | 列表滑动时触发。<br/>- scrollOffset: 每帧滚动的偏移量，List的内容向上滚动时偏移量为正，向下滚动时偏移量为负。<br/>- [scrollState](#scrollstate枚举说明): 当前滑动状态。<br/>使用控制器调用ScrollEdge和ScrollToIndex时不会触发，其余情况有滚动就会触发该事件。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
 | onScrollIndex(event: (start: number, end: number) => void) | 有子组件划入或划出List显示区域时触发。<br/>计算索引值时，ListItemGroup作为一个整体占一个索引值，不计算ListItemGroup内部ListItem的索引值。<br/>- start: 滑动起始位置索引值。<br/>- end: 滑动结束位置索引值。<br/>触发该事件的条件：列表初始化时会触发一次，List显示区域内第一个子组件的索引值或后一个子组件的索引值有变化时会触发。<br/>List的边缘效果为弹簧效果时，在List划动到边缘继续划动和松手回弹过程不会触发onScrollIndex事件。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
@@ -137,7 +137,7 @@ List(value?:{space?: number&nbsp;|&nbsp;string, initialIndex?: number, scroller?
 从API version 9开始，该接口支持在ArkTS卡片中使用。
 
 | 名称     | 描述                             |
-| ------ | ------------------------- |
+| ------ | ------------------------------ |
 | Idle   | 空闲状态。使用控制器提供的方法滚动、拖动滚动条滚动时触发。  |
 | Scroll | 手指拖动状态。使用手指拖动List滚动时触发。        |
 | Fling  | 惯性滚动状态。快速划动松手后惯性滚动和划动到边缘回弹时触发。 |
@@ -158,8 +158,9 @@ List(value?:{space?: number&nbsp;|&nbsp;string, initialIndex?: number, scroller?
 >
 >  - 绑定onDragStart事件，且事件回调中返回浮动UI布局。
 
+## 示例
 
-## 示例1
+### 示例1
 
 ```ts
 // xxx.ets
@@ -199,7 +200,7 @@ struct ListExample {
 ![zh-cn_image_0000001174264378](figures/zh-cn_image_0000001174264378.gif)
 
 
-## 示例2
+### 示例2
 
 ```ts
 // xxx.ets
@@ -248,7 +249,7 @@ struct ListLanesExample {
 ![list](figures/list1.gif)
 
 
-## 示例3
+### 示例3
 
 ```ts
 // xxx.ets

zh-cn/application-dev/reference/arkui-ts/ts-container-swiper.md

@@ -56,6 +56,8 @@ Swiper(controller?: SwiperController)
 | ----------- | ------------------------------------------ |
 | Stretch<sup>(deprecated)</sup>     | Swiper滑动一页的宽度为Swiper组件自身的宽度。<br>从API verdion 10开始不再维护，建议使用STRETCH代替。|
 | AutoLinear<sup>(deprecated)</sup>   | Swiper滑动一页的宽度为子组件宽度中的最大值。<br>从API verdion 10开始不再维护，建议使用AUTO_LINEAR代替。|
+| STRETCH<sup>10+</sup>     | Swiper滑动一页的宽度为Swiper组件自身的宽度。|
+| AUTO_LINEAR<sup>10+</sup>  | Swiper滑动一页的宽度为子组件宽度中的最大值。|
 
 ## SwiperController
 

zh-cn/application-dev/reference/arkui-ts/ts-offscreencanvasrenderingcontext2d.md

@@ -17,16 +17,16 @@ OffscreenCanvasRenderingContext2D(width: number, height: number, settings?: Rend
 **参数：**
 
 | 参数名      | 参数类型                                     | 必填   | 参数描述                           |
-| ------- | ------------------------------------------------------------ | ---- | ------------------------------------ |
+| -------- | ---------------------------------------- | ---- | ------------------------------ |
 | width    | number                                   | 是    | 离屏画布的宽度                        |
 | height   | number                                   | 是    | 离屏画布的高度                        |
-| setting | [RenderingContextSettings](ts-canvasrenderingcontext2d.md#renderingcontextsettings) | 否   | 见RenderingContextSettings接口描述。 |
+| settings | [RenderingContextSettings](ts-canvasrenderingcontext2d.md#renderingcontextsettings) | 否    | 见RenderingContextSettings接口描述。 |
 
 
 ## 属性
 
 | 名称                                       | 类型                                       | 描述                                       |
-| ----------------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
+| ---------------------------------------- | ---------------------------------------- | ---------------------------------------- |
 | [fillStyle](#fillstyle)                  | string&nbsp;\|number<sup>10+</sup>&nbsp;\|[CanvasGradient](ts-components-canvas-canvasgradient.md)&nbsp;\|&nbsp;[CanvasPattern](ts-components-canvas-canvaspattern.md#canvaspattern) | 指定绘制的填充色。<br/>-&nbsp;类型为string时，表示设置填充区域的颜色。<br/>- 类型为number时，表示设置填充区域的颜色。<br/>-&nbsp;类型为CanvasGradient时，表示渐变对象，使用[createLinearGradient](#createlineargradient)方法创建。<br/>-&nbsp;类型为CanvasPattern时，使用[createPattern](#createpattern)方法创建。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
 | [lineWidth](#linewidth)                  | number                                   | 设置绘制线条的宽度。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
 | [strokeStyle](#strokestyle)              | string&nbsp;\|number<sup>10+</sup>&nbsp;\|[CanvasGradient](ts-components-canvas-canvasgradient.md)&nbsp;\|&nbsp;[CanvasPattern](ts-components-canvas-canvaspattern.md#canvaspattern) | 设置描边的颜色。<br/>-&nbsp;类型为string时，表示设置描边使用的颜色。<br/>- 类型为number时，表示设置描边使用的颜色。<br/>-&nbsp;类型为CanvasGradient时，表示渐变对象，使用[createLinearGradient](#createlineargradient)方法创建。<br/>-&nbsp;类型为CanvasPattern时，使用[createPattern](#createpattern)方法创建。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
@@ -44,9 +44,9 @@ OffscreenCanvasRenderingContext2D(width: number, height: number, settings?: Rend
 | [shadowOffsetX](#shadowoffsetx)          | number                                   | 设置绘制阴影时和原有对象的水平偏移值。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
 | [shadowOffsetY](#shadowoffsety)          | number                                   | 设置绘制阴影时和原有对象的垂直偏移值。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
 | [imageSmoothingEnabled](#imagesmoothingenabled) | boolean                                  | 用于设置绘制图片时是否进行图像平滑度调整，true为启用，false为不启用。 <br/>-&nbsp;默认值：true。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
-| [imageSmoothingQuality](#imagesmoothingquality)       |ImageSmoothingQuality     | imageSmoothingEnabled为true时，用于设置图像平滑度。可选值为：<br/>- 'low'：低画质<br/>- 'medium'：中画质<br/>- 'high'：高画质。<br/>默认值：low<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
-| [direction](#direction)       |CanvasDirection     | 用于设置绘制文字时使用的文字方向。可选值为：<br/>- 'inherit'：继承canvas组件已设定的文本方向<br/>- 'ltr'：从左往右<br/>- 'rtl'：从右往左。<br/>默认值：inherit<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
-| [filter](#filter)       |string     | 用于设置图像的滤镜。支持的滤镜效果如下：<br/>- 'none': 无滤镜效果<br/>- 'blur'：给图像设置高斯模糊<br/>- 'brightness'：给图片应用一种线性乘法，使其看起来更亮或更暗<br/>- 'contrast'：调整图像的对比度<br/>- 'grayscale'：将图像转换为灰度图像<br/>- 'hue-rotate'：给图像应用色相旋转<br/>- 'invert'：反转输入图像<br/>- 'opacity'：转化图像的透明程度<br/>- 'saturate'：转换图像饱和度<br/>- 'sepia'：将图像转换为深褐色<br/>默认值：'none'<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
+| [imageSmoothingQuality](#imagesmoothingquality) | ImageSmoothingQuality                    | imageSmoothingEnabled为true时，用于设置图像平滑度。可选值为：<br/>- 'low'：低画质<br/>- 'medium'：中画质<br/>- 'high'：高画质。<br/>默认值：low<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
+| [direction](#direction)                  | CanvasDirection                          | 用于设置绘制文字时使用的文字方向。可选值为：<br/>- 'inherit'：继承canvas组件已设定的文本方向<br/>- 'ltr'：从左往右<br/>- 'rtl'：从右往左。<br/>默认值：inherit<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
+| [filter](#filter)                        | string                                   | 用于设置图像的滤镜。支持的滤镜效果如下：<br/>- 'none': 无滤镜效果<br/>- 'blur'：给图像设置高斯模糊<br/>- 'brightness'：给图片应用一种线性乘法，使其看起来更亮或更暗<br/>- 'contrast'：调整图像的对比度<br/>- 'grayscale'：将图像转换为灰度图像<br/>- 'hue-rotate'：给图像应用色相旋转<br/>- 'invert'：反转输入图像<br/>- 'opacity'：转化图像的透明程度<br/>- 'saturate'：转换图像饱和度<br/>- 'sepia'：将图像转换为深褐色<br/>默认值：'none'<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
 
 > **说明：**
 > fillStyle、shadowColor与 strokeStyle 中string类型格式为 'rgb(255, 255, 255)'，'rgba(255, 255, 255, 1.0)'，'\#FFFFFF'。
@@ -965,7 +965,7 @@ measureText(text: string): TextMetrics
  **返回值：**
 
 | 类型          | 说明                                       |
-| ----------- | ------------------------------------------------------------ |
+| ----------- | ---------------------------------------- |
 | TextMetrics | 文本的尺寸信息<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
 
 **TextMetrics类型描述:**
@@ -1279,7 +1279,7 @@ createPattern(image: ImageBitmap, repetition: string | null): CanvasPattern | nu
 **返回值：**
 
 | 类型                                       | 说明                      |
-| ------------------------------- | ----------------------- |
+| ---------------------------------------- | ----------------------- |
 | [CanvasPattern](ts-components-canvas-canvaspattern.md#canvaspattern) | 通过指定图像和重复方式创建图片填充的模板对象。 |
 
  **示例：**
@@ -1539,7 +1539,7 @@ ellipse(x: number, y: number, radiusX: number, radiusY: number, rotation: number
  **参数：**
 
 | 参数               | 类型      | 必填   | 默认值   | 说明                                       |
-| ---------------- | ------- | ---- | ----- | ----------------- |
+| ---------------- | ------- | ---- | ----- | ---------------------------------------- |
 | x                | number  | 是    | 0     | 椭圆圆心的x轴坐标。                               |
 | y                | number  | 是    | 0     | 椭圆圆心的y轴坐标。                               |
 | radiusX          | number  | 是    | 0     | 椭圆x轴的半径长度。                               |
@@ -1851,7 +1851,7 @@ filter(filter: string): void
 **参数:**
 
 | 参数     | 类型     | 必填   | 默认值  | 说明                                       |
-| ------ | ------ | ---- | ---- | ------------ |
+| ------ | ------ | ---- | ---- | ---------------------------------------- |
 | filter | string | 是    | -    | 接受各类滤镜效果的函数。支持的滤镜效果如下：<br/>- 'none': 无滤镜效果<br/>- 'blur'：给图像设置高斯模糊<br/>- 'brightness'：给图片应用一种线性乘法，使其看起来更亮或更暗<br/>- 'contrast'：调整图像的对比度<br/>- 'grayscale'：将图像转换为灰度图像<br/>- 'hue-rotate'：给图像应用色相旋转<br/>- 'invert'：反转输入图像<br/>- 'opacity'：转化图像的透明程度<br/>- 'saturate'：转换图像饱和度<br/>- 'sepia'：将图像转换为深褐色<br/>默认值：'none' |
 
 **示例：**
@@ -1928,7 +1928,7 @@ getTransform(): Matrix2D
 **返回值：**
 
 | 类型                                       | 说明    |
-| ----------------------------------------------------- | ---------- |
+| ---------------------------------------- | ----- |
 | [Matrix2D](ts-components-canvas-matrix2d.md#Matrix2D) | 矩阵对象。 |
 
 ### resetTransform
@@ -2461,7 +2461,7 @@ putImageData(imageData: Object, dx: number | string, dy: number | string, dirtyX
  **参数：**
 
 | 参数          | 类型                                       | 必填   | 默认值          | 描述                            |
-| ----------- | ---------------------------------------- | ---- | --------------- | --------------------------------------------------------- |
+| ----------- | ---------------------------------------- | ---- | ------------ | ----------------------------- |
 | imagedata   | Object                                   | 是    | null         | 包含像素值的ImageData对象。            |
 | dx          | number&nbsp;\|&nbsp;string<sup>10+</sup> | 是    | 0            | 填充区域在x轴方向的偏移量。                |
 | dy          | number&nbsp;\|&nbsp;string<sup>10+</sup> | 是    | 0            | 填充区域在y轴方向的偏移量。                |
@@ -2964,7 +2964,7 @@ createConicGradient(startAngle: number, x: number, y: number): CanvasGradient
 **参数：**
 
 | 参数         | 类型     | 必填   | 默认值  | 描述                                  |
-| ---------- | ------ | ---- | ------ | ------------------------------------------------------------ |
+| ---------- | ------ | ---- | ---- | ----------------------------------- |
 | startAngle | number | 是    | 0    | 开始渐变的角度，以弧度为单位。角度测量从中心右侧水平开始，顺时针移动。 |
 | x          | number | 是    | 0    | 圆锥渐变的中心x轴坐标。单位：vp                   |
 | y          | number | 是    | 0    | 圆锥渐变的中心y轴坐标。单位：vp                   |

zh-cn/application-dev/reference/native-apis/_huks_type_api.md

@@ -74,8 +74,9 @@
 | [OH_Huks_AlgSuite](#oh_huks_algsuite) { <br/>OH_HUKS_UNWRAP_SUITE_X25519_AES_256_GCM_NOPADDING = 1, <br/>OH_HUKS_UNWRAP_SUITE_ECDH_AES_256_GCM_NOPADDING = 2  <br/>} | 密文导入所需的算法套件类型  | 
 | [OH_Huks_KeyGenerateType](#oh_huks_keygeneratetype) { <br/>OH_HUKS_KEY_GENERATE_TYPE_DEFAULT = 0, <br/>OH_HUKS_KEY_GENERATE_TYPE_DERIVE = 1, <br/>OH_HUKS_KEY_GENERATE_TYPE_AGREE = 2 <br/>} | 生成的密钥类型。  | 
 | [OH_Huks_KeyFlag](#oh_huks_keyflag) { <br/>OH_HUKS_KEY_FLAG_IMPORT_KEY = 1, <br/>OH_HUKS_KEY_FLAG_GENERATE_KEY = 2, <br/>OH_HUKS_KEY_FLAG_AGREE_KEY = 3, <br/>OH_HUKS_KEY_FLAG_DERIVE_KEY = 4 <br/>} | 密钥的产生方式。  | 
-| [OH_Huks_KeyStorageType](#oh_huks_keystoragetype) { <br/>OH_HUKS_STORAGE_TEMP = 0, <br/>OH_HUKS_STORAGE_PERSISTENT = 1 <br/>} | 密钥的存储方式。  | 
+| [OH_Huks_KeyStorageType](#oh_huks_keystoragetype) { <br/>OH_HUKS_STORAGE_TEMP = 0, <br/>OH_HUKS_STORAGE_PERSISTENT = 1, <br/>OH_HUKS_STORAGE_ONLY_USED_IN_HUKS = 2, <br/>OH_HUKS_STORAGE_KEY_EXPORT_ALLOWED = 3 <br/>} | 密钥的存储方式。  | 
 | [OH_Huks_ImportKeyType](#oh_huks_importkeytype) { <br/>OH_HUKS_KEY_TYPE_PUBLIC_KEY = 0, <br/>OH_HUKS_KEY_TYPE_PRIVATE_KEY = 1, <br/>OH_HUKS_KEY_TYPE_KEY_PAIR = 2 <br/>} | 导入密钥的类型，默认为导入公钥，导入对称密钥时不需要该字段。  | 
+| [OH_Huks_RsaPssSaltLenType](#oh_huks_rsapsssaltlentype) { <br/> OH_HUKS_RSA_PSS_SALT_LEN_DIGEST = 0, OH_HUKS_RSA_PSS_SALT_LEN_MAX = 1 <br/>} | RSA在签名验签、填充模式为PSS时需要指定的盐值长度类型。 |
 | [OH_Huks_ErrCode](#oh_huks_errcode) {<br/>OH_HUKS_SUCCESS = 0, <br/>OH_HUKS_ERR_CODE_PERMISSION_FAIL = 201, <br/>OH_HUKS_ERR_CODE_ILLEGAL_ARGUMENT = 401, <br/>OH_HUKS_ERR_CODE_NOT_SUPPORTED_API = 801,<br/>OH_HUKS_ERR_CODE_FEATURE_NOT_SUPPORTED = 12000001, <br/>OH_HUKS_ERR_CODE_MISSING_CRYPTO_ALG_ARGUMENT = 12000002, <br/>OH_HUKS_ERR_CODE_INVALID_CRYPTO_ALG_ARGUMENT = 12000003, <br/>OH_HUKS_ERR_CODE_FILE_OPERATION_FAIL = 12000004,<br/>OH_HUKS_ERR_CODE_COMMUNICATION_FAIL = 12000005, <br/>OH_HUKS_ERR_CODE_CRYPTO_FAIL = 12000006, <br/>OH_HUKS_ERR_CODE_KEY_AUTH_PERMANENTLY_INVALIDATED = 12000007, <br/>OH_HUKS_ERR_CODE_KEY_AUTH_VERIFY_FAILED = 12000008,<br/>OH_HUKS_ERR_CODE_KEY_AUTH_TIME_OUT = 12000009, <br/>OH_HUKS_ERR_CODE_SESSION_LIMIT = 12000010, <br/>OH_HUKS_ERR_CODE_ITEM_NOT_EXIST = 12000011, <br/>OH_HUKS_ERR_CODE_INTERNAL_ERROR = 12000012,<br/>OH_HUKS_ERR_CODE_CREDENTIAL_NOT_EXIST = 12000013<br/>} | 错误码。  | 
 | [OH_Huks_TagType](#oh_huks_tagtype) {<br/>OH_HUKS_TAG_TYPE_INVALID = 0  &lt;&lt; 28, <br/>OH_HUKS_TAG_TYPE_INT = 1 &lt;&lt; 28, <br/>OH_HUKS_TAG_TYPE_UINT = 2 &lt;&lt; 28, <br/>OH_HUKS_TAG_TYPE_ULONG = 3 &lt;&lt; 28,<br/>OH_HUKS_TAG_TYPE_BOOL = 4 &lt;&lt; 28, <br/>OH_HUKS_TAG_TYPE_BYTES = 5 &lt;&lt; 28<br/>} | 参数集中参数类型的掩码值。  | 
 | [OH_Huks_UserAuthType](#oh_huks_userauthtype) { <br/>OH_HUKS_USER_AUTH_TYPE_FINGERPRINT = 1 &lt;&lt; 0, <br/>OH_HUKS_USER_AUTH_TYPE_FACE = 1 &lt;&lt; 1, <br/>OH_HUKS_USER_AUTH_TYPE_PIN = 1 &lt;&lt; 2 <br/>} | 密钥访问控制中的用户认证类型  | 
@@ -83,7 +84,7 @@
 | [OH_Huks_ChallengeType](#oh_huks_challengetype) { <br/>OH_HUKS_CHALLENGE_TYPE_NORMAL = 0, <br/>OH_HUKS_CHALLENGE_TYPE_CUSTOM = 1, <br/>OH_HUKS_CHALLENGE_TYPE_NONE = 2 <br/>} | 密钥使用时生成challenge的类型  | 
 | [OH_Huks_ChallengePosition](#oh_huks_challengeposition) { <br/>OH_HUKS_CHALLENGE_POS_0 = 0, <br/>OH_HUKS_CHALLENGE_POS_1, <br/>OH_HUKS_CHALLENGE_POS_2, <br/>OH_HUKS_CHALLENGE_POS_3 <br/>} | challenge类型为用户自定义类型时，生成的challenge有效长度仅为8字节连续的数据，且仅支持4种位置。  | 
 | [OH_Huks_SecureSignType](#oh_huks_securesigntype) { OH_HUKS_SECURE_SIGN_WITH_AUTHINFO = 1 } | 生成或导入密钥时，指定该密钥的安全签名类型。  | 
-| [OH_Huks_Tag](#oh_huks_tag) {<br/> OH_HUKS_TAG_ALGORITHM = OH_HUKS_TAG_TYPE_UINT \| 1, OH_HUKS_TAG_PURPOSE = OH_HUKS_TAG_TYPE_UINT \| 2, OH_HUKS_TAG_KEY_SIZE = OH_HUKS_TAG_TYPE_UINT \| 3,<br/>OH_HUKS_TAG_DIGEST = OH_HUKS_TAG_TYPE_UINT \| 4, OH_HUKS_TAG_PADDING = OH_HUKS_TAG_TYPE_UINT \| 5, OH_HUKS_TAG_BLOCK_MODE = OH_HUKS_TAG_TYPE_UINT \| 6, OH_HUKS_TAG_KEY_TYPE = OH_HUKS_TAG_TYPE_UINT \| 7,<br/>OH_HUKS_TAG_ASSOCIATED_DATA = OH_HUKS_TAG_TYPE_BYTES \| 8, OH_HUKS_TAG_NONCE = OH_HUKS_TAG_TYPE_BYTES \| 9, OH_HUKS_TAG_IV = OH_HUKS_TAG_TYPE_BYTES \| 10, OH_HUKS_TAG_INFO = OH_HUKS_TAG_TYPE_BYTES \| 11,<br/>OH_HUKS_TAG_SALT = OH_HUKS_TAG_TYPE_BYTES \| 12, OH_HUKS_TAG_ITERATION = OH_HUKS_TAG_TYPE_UINT \| 14, OH_HUKS_TAG_KEY_GENERATE_TYPE = OH_HUKS_TAG_TYPE_UINT \| 15, OH_HUKS_TAG_AGREE_ALG = OH_HUKS_TAG_TYPE_UINT \| 19,<br/>OH_HUKS_TAG_AGREE_PUBLIC_KEY_IS_KEY_ALIAS = OH_HUKS_TAG_TYPE_BOOL \| 20, OH_HUKS_TAG_AGREE_PRIVATE_KEY_ALIAS = OH_HUKS_TAG_TYPE_BYTES \| 21, OH_HUKS_TAG_AGREE_PUBLIC_KEY = OH_HUKS_TAG_TYPE_BYTES \| 22, OH_HUKS_TAG_KEY_ALIAS = OH_HUKS_TAG_TYPE_BYTES \| 23,<br/>OH_HUKS_TAG_DERIVE_KEY_SIZE = OH_HUKS_TAG_TYPE_UINT \| 24, OH_HUKS_TAG_IMPORT_KEY_TYPE = OH_HUKS_TAG_TYPE_UINT \| 25, OH_HUKS_TAG_UNWRAP_ALGORITHM_SUITE = OH_HUKS_TAG_TYPE_UINT \| 26, OH_HUKS_TAG_ALL_USERS = OH_HUKS_TAG_TYPE_BOOL \| 301,<br/>OH_HUKS_TAG_USER_ID = OH_HUKS_TAG_TYPE_UINT \| 302, OH_HUKS_TAG_NO_AUTH_REQUIRED = OH_HUKS_TAG_TYPE_BOOL \| 303, OH_HUKS_TAG_USER_AUTH_TYPE = OH_HUKS_TAG_TYPE_UINT \| 304, OH_HUKS_TAG_AUTH_TIMEOUT = OH_HUKS_TAG_TYPE_UINT \| 305,<br/>OH_HUKS_TAG_AUTH_TOKEN = OH_HUKS_TAG_TYPE_BYTES \| 306, OH_HUKS_TAG_KEY_AUTH_ACCESS_TYPE = OH_HUKS_TAG_TYPE_UINT \| 307, OH_HUKS_TAG_KEY_SECURE_SIGN_TYPE = OH_HUKS_TAG_TYPE_UINT \| 308, OH_HUKS_TAG_CHALLENGE_TYPE = OH_HUKS_TAG_TYPE_UINT \| 309,<br/>OH_HUKS_TAG_CHALLENGE_POS = OH_HUKS_TAG_TYPE_UINT \| 310, OH_HUKS_TAG_ATTESTATION_CHALLENGE = OH_HUKS_TAG_TYPE_BYTES \| 501, OH_HUKS_TAG_ATTESTATION_APPLICATION_ID = OH_HUKS_TAG_TYPE_BYTES \| 502, OH_HUKS_TAG_ATTESTATION_ID_ALIAS = OH_HUKS_TAG_TYPE_BYTES \| 511,<br/>OH_HUKS_TAG_ATTESTATION_ID_SEC_LEVEL_INFO = OH_HUKS_TAG_TYPE_BYTES \| 514, OH_HUKS_TAG_ATTESTATION_ID_VERSION_INFO = OH_HUKS_TAG_TYPE_BYTES \| 515,<br/>OH_HUKS_TAG_IS_KEY_ALIAS = OH_HUKS_TAG_TYPE_BOOL \| 1001, OH_HUKS_TAG_KEY_STORAGE_FLAG = OH_HUKS_TAG_TYPE_UINT \| 1002, OH_HUKS_TAG_IS_ALLOWED_WRAP = OH_HUKS_TAG_TYPE_BOOL \| 1003, OH_HUKS_TAG_KEY_WRAP_TYPE = OH_HUKS_TAG_TYPE_UINT \| 1004,<br/>OH_HUKS_TAG_KEY_AUTH_ID = OH_HUKS_TAG_TYPE_BYTES \| 1005, OH_HUKS_TAG_KEY_ROLE = OH_HUKS_TAG_TYPE_UINT \| 1006, OH_HUKS_TAG_KEY_FLAG = OH_HUKS_TAG_TYPE_UINT \| 1007, OH_HUKS_TAG_IS_ASYNCHRONIZED = OH_HUKS_TAG_TYPE_UINT \| 1008,<br/> OH_HUKS_TAG_KEY_DOMAIN = OH_HUKS_TAG_TYPE_UINT \| 1011, OH_HUKS_TAG_SYMMETRIC_KEY_DATA = OH_HUKS_TAG_TYPE_BYTES \| 20001,<br/>OH_HUKS_TAG_ASYMMETRIC_PUBLIC_KEY_DATA = OH_HUKS_TAG_TYPE_BYTES \| 20002, OH_HUKS_TAG_ASYMMETRIC_PRIVATE_KEY_DATA = OH_HUKS_TAG_TYPE_BYTES \| 20003<br/>} | 参数集所用的TAG值枚举  | 
+| [OH_Huks_Tag](#oh_huks_tag) {<br/> OH_HUKS_TAG_ALGORITHM = OH_HUKS_TAG_TYPE_UINT \| 1, OH_HUKS_TAG_PURPOSE = OH_HUKS_TAG_TYPE_UINT \| 2, OH_HUKS_TAG_KEY_SIZE = OH_HUKS_TAG_TYPE_UINT \| 3,<br/>OH_HUKS_TAG_DIGEST = OH_HUKS_TAG_TYPE_UINT \| 4, OH_HUKS_TAG_PADDING = OH_HUKS_TAG_TYPE_UINT \| 5, OH_HUKS_TAG_BLOCK_MODE = OH_HUKS_TAG_TYPE_UINT \| 6, OH_HUKS_TAG_KEY_TYPE = OH_HUKS_TAG_TYPE_UINT \| 7,<br/>OH_HUKS_TAG_ASSOCIATED_DATA = OH_HUKS_TAG_TYPE_BYTES \| 8, OH_HUKS_TAG_NONCE = OH_HUKS_TAG_TYPE_BYTES \| 9, OH_HUKS_TAG_IV = OH_HUKS_TAG_TYPE_BYTES \| 10, OH_HUKS_TAG_INFO = OH_HUKS_TAG_TYPE_BYTES \| 11,<br/>OH_HUKS_TAG_SALT = OH_HUKS_TAG_TYPE_BYTES \| 12, OH_HUKS_TAG_ITERATION = OH_HUKS_TAG_TYPE_UINT \| 14, OH_HUKS_TAG_KEY_GENERATE_TYPE = OH_HUKS_TAG_TYPE_UINT \| 15, OH_HUKS_TAG_AGREE_ALG = OH_HUKS_TAG_TYPE_UINT \| 19,<br/>OH_HUKS_TAG_AGREE_PUBLIC_KEY_IS_KEY_ALIAS = OH_HUKS_TAG_TYPE_BOOL \| 20, OH_HUKS_TAG_AGREE_PRIVATE_KEY_ALIAS = OH_HUKS_TAG_TYPE_BYTES \| 21, OH_HUKS_TAG_AGREE_PUBLIC_KEY = OH_HUKS_TAG_TYPE_BYTES \| 22, OH_HUKS_TAG_KEY_ALIAS = OH_HUKS_TAG_TYPE_BYTES \| 23,<br/>OH_HUKS_TAG_DERIVE_KEY_SIZE = OH_HUKS_TAG_TYPE_UINT \| 24, OH_HUKS_TAG_IMPORT_KEY_TYPE = OH_HUKS_TAG_TYPE_UINT \| 25, OH_HUKS_TAG_UNWRAP_ALGORITHM_SUITE = OH_HUKS_TAG_TYPE_UINT \| 26, OH_HUKS_TAG_DERIVED_AGREED_KEY_STORAGE_FLAG = OH_HUKS_TAG_TYPE_UINT \| 29, OH_HUKS_TAG_RSA_PSS_SALT_LEN_TYPE = OH_HUKS_TAG_TYPE_UINT \| 30, OH_HUKS_TAG_ALL_USERS = OH_HUKS_TAG_TYPE_BOOL \| 301,<br/>OH_HUKS_TAG_USER_ID = OH_HUKS_TAG_TYPE_UINT \| 302, OH_HUKS_TAG_NO_AUTH_REQUIRED = OH_HUKS_TAG_TYPE_BOOL \| 303, OH_HUKS_TAG_USER_AUTH_TYPE = OH_HUKS_TAG_TYPE_UINT \| 304, OH_HUKS_TAG_AUTH_TIMEOUT = OH_HUKS_TAG_TYPE_UINT \| 305,<br/>OH_HUKS_TAG_AUTH_TOKEN = OH_HUKS_TAG_TYPE_BYTES \| 306, OH_HUKS_TAG_KEY_AUTH_ACCESS_TYPE = OH_HUKS_TAG_TYPE_UINT \| 307, OH_HUKS_TAG_KEY_SECURE_SIGN_TYPE = OH_HUKS_TAG_TYPE_UINT \| 308, OH_HUKS_TAG_CHALLENGE_TYPE = OH_HUKS_TAG_TYPE_UINT \| 309,<br/>OH_HUKS_TAG_CHALLENGE_POS = OH_HUKS_TAG_TYPE_UINT \| 310, OH_HUKS_TAG_KEY_AUTH_PURPOSE = OH_HUKS_TAG_TYPE_UINT \| 311, OH_HUKS_TAG_ATTESTATION_CHALLENGE = OH_HUKS_TAG_TYPE_BYTES \| 501, OH_HUKS_TAG_ATTESTATION_APPLICATION_ID = OH_HUKS_TAG_TYPE_BYTES \| 502, OH_HUKS_TAG_ATTESTATION_ID_ALIAS = OH_HUKS_TAG_TYPE_BYTES \| 511,<br/>OH_HUKS_TAG_ATTESTATION_ID_SEC_LEVEL_INFO = OH_HUKS_TAG_TYPE_BYTES \| 514, OH_HUKS_TAG_ATTESTATION_ID_VERSION_INFO = OH_HUKS_TAG_TYPE_BYTES \| 515,<br/>OH_HUKS_TAG_IS_KEY_ALIAS = OH_HUKS_TAG_TYPE_BOOL \| 1001, OH_HUKS_TAG_KEY_STORAGE_FLAG = OH_HUKS_TAG_TYPE_UINT \| 1002, OH_HUKS_TAG_IS_ALLOWED_WRAP = OH_HUKS_TAG_TYPE_BOOL \| 1003, OH_HUKS_TAG_KEY_WRAP_TYPE = OH_HUKS_TAG_TYPE_UINT \| 1004,<br/>OH_HUKS_TAG_KEY_AUTH_ID = OH_HUKS_TAG_TYPE_BYTES \| 1005, OH_HUKS_TAG_KEY_ROLE = OH_HUKS_TAG_TYPE_UINT \| 1006, OH_HUKS_TAG_KEY_FLAG = OH_HUKS_TAG_TYPE_UINT \| 1007, OH_HUKS_TAG_IS_ASYNCHRONIZED = OH_HUKS_TAG_TYPE_UINT \| 1008,<br/> OH_HUKS_TAG_KEY_DOMAIN = OH_HUKS_TAG_TYPE_UINT \| 1011, OH_HUKS_TAG_SYMMETRIC_KEY_DATA = OH_HUKS_TAG_TYPE_BYTES \| 20001,<br/>OH_HUKS_TAG_ASYMMETRIC_PUBLIC_KEY_DATA = OH_HUKS_TAG_TYPE_BYTES \| 20002, OH_HUKS_TAG_ASYMMETRIC_PRIVATE_KEY_DATA = OH_HUKS_TAG_TYPE_BYTES \| 20003<br/>} | 参数集所用的TAG值枚举  | 
 
 
 ## 枚举类型说明
@@ -175,6 +176,23 @@ enum OH_Huks_CipherMode
 | OH_HUKS_MODE_GCM  | 使用GCM加密模式。 | 
 
 
+### OH_Huks_RsaPssSaltLenType
+
+```
+enum OH_Huks_RsaPssSaltLenType
+```
+**描述:**
+RSA在签名验签、填充模式为PSS时需要指定的盐值长度类型。
+
+**起始版本：**
+10
+
+| 枚举值 | 描述 | 
+| -------- | -------- |
+| OH_HUKS_RSA_PSS_SALT_LEN_DIGEST | 以摘要长度设置盐值长度。 |
+| OH_HUKS_RSA_PSS_SALT_LEN_MAX | 以最大长度设置盐值长度。 |
+
+
 ### OH_Huks_ErrCode
 
   
@@ -389,6 +407,8 @@ enum OH_Huks_KeyStorageType
 | -------- | -------- |
 | OH_HUKS_STORAGE_TEMP  | 通过本地直接管理密钥。 | 
 | OH_HUKS_STORAGE_PERSISTENT  | 通过HUKS service管理密钥。 | 
+| OH_HUKS_STORAGE_ONLY_USED_IN_HUKS  | 密钥只存储在huks中。 | 
+| OH_HUKS_STORAGE_KEY_EXPORT_ALLOWED  | 密钥从huks中导出，不存储。 | 
 
 
 ### OH_Huks_SecureSignType
@@ -438,6 +458,8 @@ enum OH_Huks_Tag
 | OH_HUKS_TAG_DERIVE_KEY_SIZE  | 派生密钥大小。 | 
 | OH_HUKS_TAG_IMPORT_KEY_TYPE  | 导入密钥类型, 类型可在枚举OH_Huks_ImportKeyType中选择。 | 
 | OH_HUKS_TAG_UNWRAP_ALGORITHM_SUITE  | 导入加密密钥的套件。 | 
+|  OH_HUKS_TAG_DERIVED_AGREED_KEY_STORAGE_FLAG  | 派生密钥/协商密钥的存储类型。 | 
+| OH_HUKS_TAG_RSA_PSS_SALT_LEN_TYPE | RSA算法，填充模式为PSS时的盐值长度类型。 | 
 | OH_HUKS_TAG_ALL_USERS  | 密钥使用访问控制和使用认证相关的标签取值范围: 301 - 500 多用户中的所有用户。 | 
 | OH_HUKS_TAG_USER_ID  | 表示多用户id。 | 
 | OH_HUKS_TAG_NO_AUTH_REQUIRED  | 表示是否需要密钥访问控制。 | 
@@ -448,6 +470,7 @@ enum OH_Huks_Tag
 | OH_HUKS_TAG_KEY_SECURE_SIGN_TYPE  | 表示生成或导入密钥时，指定该密钥的签名类型。 | 
 | OH_HUKS_TAG_CHALLENGE_TYPE  | 表示密钥使用时生成的challenge类型。从OH_Huks_ChallengeType中选择。 | 
 | OH_HUKS_TAG_CHALLENGE_POS  | 表示challenge类型为用户自定义类型时，huks产生的challenge有效长度仅为8字节连续的数据的位置。从OH_Huks_ChallengePosition中选择。 | 
+| H_HUKS_TAG_KEY_AUTH_PURPOSE | 表示密钥认证用途的类型。 | 
 | OH_HUKS_TAG_ATTESTATION_CHALLENGE  | 密钥认证相关的标签值: 501 - 600 密钥认证时的挑战值。 | 
 | OH_HUKS_TAG_ATTESTATION_APPLICATION_ID  | 密钥认证时拥有该密钥的application的Id。 | 
 | OH_HUKS_TAG_ATTESTATION_ID_ALIAS  | 密钥别名。 | 

zh-cn/application-dev/reference/native-apis/native__huks__type_8h.md

@@ -69,8 +69,9 @@
 | [OH_Huks_AlgSuite](_huks_type_api.md#oh_huks_algsuite) { <br/>OH_HUKS_UNWRAP_SUITE_X25519_AES_256_GCM_NOPADDING = 1, <br/>OH_HUKS_UNWRAP_SUITE_ECDH_AES_256_GCM_NOPADDING = 2  <br/>} | 密文导入所需的算法套件类型  | 
 | [OH_Huks_KeyGenerateType](_huks_type_api.md#oh_huks_keygeneratetype) { <br/>OH_HUKS_KEY_GENERATE_TYPE_DEFAULT = 0, <br/>OH_HUKS_KEY_GENERATE_TYPE_DERIVE = 1, <br/>OH_HUKS_KEY_GENERATE_TYPE_AGREE = 2 <br/>} | 生成的密钥类型。  | 
 | [OH_Huks_KeyFlag](_huks_type_api.md#oh_huks_keyflag) { <br/>OH_HUKS_KEY_FLAG_IMPORT_KEY = 1, <br/>OH_HUKS_KEY_FLAG_GENERATE_KEY = 2, <br/>OH_HUKS_KEY_FLAG_AGREE_KEY = 3, <br/>OH_HUKS_KEY_FLAG_DERIVE_KEY = 4 <br/>} | 密钥的产生方式。  | 
-| [OH_Huks_KeyStorageType](_huks_type_api.md#oh_huks_keystoragetype) { <br/>OH_HUKS_STORAGE_TEMP = 0, <br/>OH_HUKS_STORAGE_PERSISTENT = 1 <br/>} | 密钥的存储方式。  | 
+| [OH_Huks_KeyStorageType](_huks_type_api.md#oh_huks_keystoragetype) { <br/>OH_HUKS_STORAGE_TEMP = 0, <br/>OH_HUKS_STORAGE_PERSISTENT = 1, <br/>OH_HUKS_STORAGE_ONLY_USED_IN_HUKS = 2, <br/>OH_HUKS_STORAGE_KEY_EXPORT_ALLOWED = 3 <br/>} | 密钥的存储方式。  | 
 | [OH_Huks_ImportKeyType](_huks_type_api.md#oh_huks_importkeytype) { <br/>OH_HUKS_KEY_TYPE_PUBLIC_KEY = 0, <br/>OH_HUKS_KEY_TYPE_PRIVATE_KEY = 1, <br/>OH_HUKS_KEY_TYPE_KEY_PAIR = 2 <br/>}| 导入密钥的类型，默认为导入公钥，导入对称密钥时不需要该字段。  | 
+| [OH_Huks_RsaPssSaltLenType](_huks_type_api.md#oh_huks_rsapsssaltlentype) { <br/> OH_HUKS_RSA_PSS_SALT_LEN_DIGEST = 0, OH_HUKS_RSA_PSS_SALT_LEN_MAX = 1 <br/>} | RSA在签名验签、填充模式为PSS时需要指定的盐值长度类型。 |
 | [OH_Huks_ErrCode](_huks_type_api.md#oh_huks_errcode) {<br/>OH_HUKS_SUCCESS = 0, <br/>OH_HUKS_ERR_CODE_PERMISSION_FAIL = 201, <br/>OH_HUKS_ERR_CODE_ILLEGAL_ARGUMENT = 401, <br/>OH_HUKS_ERR_CODE_NOT_SUPPORTED_API = 801,<br/>OH_HUKS_ERR_CODE_FEATURE_NOT_SUPPORTED = 12000001, <br/>OH_HUKS_ERR_CODE_MISSING_CRYPTO_ALG_ARGUMENT = 12000002, <br/>OH_HUKS_ERR_CODE_INVALID_CRYPTO_ALG_ARGUMENT = 12000003, <br/>OH_HUKS_ERR_CODE_FILE_OPERATION_FAIL = 12000004,<br/>OH_HUKS_ERR_CODE_COMMUNICATION_FAIL = 12000005, <br/>OH_HUKS_ERR_CODE_CRYPTO_FAIL = 12000006, <br/>OH_HUKS_ERR_CODE_KEY_AUTH_PERMANENTLY_INVALIDATED = 12000007, <br/>OH_HUKS_ERR_CODE_KEY_AUTH_VERIFY_FAILED = 12000008,<br/>OH_HUKS_ERR_CODE_KEY_AUTH_TIME_OUT = 12000009, <br/>OH_HUKS_ERR_CODE_SESSION_LIMIT = 12000010, <br/>OH_HUKS_ERR_CODE_ITEM_NOT_EXIST = 12000011, <br/>OH_HUKS_ERR_CODE_INTERNAL_ERROR = 12000012,<br/>OH_HUKS_ERR_CODE_CREDENTIAL_NOT_EXIST = 12000013<br/>} | 错误码。  | 
 | [OH_Huks_TagType](_huks_type_api.md#oh_huks_tagtype) {<br/>OH_HUKS_TAG_TYPE_INVALID = 0  &lt;&lt; 28, <br/>OH_HUKS_TAG_TYPE_INT = 1 &lt;&lt; 28, <br/>OH_HUKS_TAG_TYPE_UINT = 2 &lt;&lt; 28, <br/>OH_HUKS_TAG_TYPE_ULONG = 3 &lt;&lt; 28,<br/>OH_HUKS_TAG_TYPE_BOOL = 4 &lt;&lt; 28, <br/>OH_HUKS_TAG_TYPE_BYTES = 5 &lt;&lt; 28<br/>} | 参数集中参数类型的掩码值。  | 
 | [OH_Huks_UserAuthType](_huks_type_api.md#oh_huks_userauthtype) { <br/>OH_HUKS_USER_AUTH_TYPE_FINGERPRINT = 1 &lt;&lt; 0, <br/>OH_HUKS_USER_AUTH_TYPE_FACE = 1 &lt;&lt; 1, <br/>OH_HUKS_USER_AUTH_TYPE_PIN = 1 &lt;&lt; 2 <br/>} | 密钥访问控制中的用户认证类型  | 
@@ -78,4 +79,4 @@
 | [OH_Huks_ChallengeType](_huks_type_api.md#oh_huks_challengetype) { <br/>OH_HUKS_CHALLENGE_TYPE_NORMAL = 0, <br/>OH_HUKS_CHALLENGE_TYPE_CUSTOM = 1, <br/>OH_HUKS_CHALLENGE_TYPE_NONE = 2 <br/>} | 密钥使用时生成challenge的类型  | 
 | [OH_Huks_ChallengePosition](_huks_type_api.md#oh_huks_challengeposition) { <br/>OH_HUKS_CHALLENGE_POS_0 = 0, <br/>OH_HUKS_CHALLENGE_POS_1, <br/>OH_HUKS_CHALLENGE_POS_2, <br/>OH_HUKS_CHALLENGE_POS_3 <br/>} | challenge类型为用户自定义类型时，生成的challenge有效长度仅为8字节连续的数据，且仅支持4种位置。  | 
 | [OH_Huks_SecureSignType](_huks_type_api.md#oh_huks_securesigntype) { OH_HUKS_SECURE_SIGN_WITH_AUTHINFO = 1 } | 生成或导入密钥时，指定该密钥的安全签名类型。  | 
-| [OH_Huks_Tag](_huks_type_api.md#oh_huks_tag) {<br/>OH_HUKS_TAG_ALGORITHM = OH_HUKS_TAG_TYPE_UINT \| 1, OH_HUKS_TAG_PURPOSE = OH_HUKS_TAG_TYPE_UINT \| 2, OH_HUKS_TAG_KEY_SIZE = OH_HUKS_TAG_TYPE_UINT \| 3,<br/>OH_HUKS_TAG_DIGEST = OH_HUKS_TAG_TYPE_UINT \| 4, OH_HUKS_TAG_PADDING = OH_HUKS_TAG_TYPE_UINT \| 5, OH_HUKS_TAG_BLOCK_MODE = OH_HUKS_TAG_TYPE_UINT \| 6, OH_HUKS_TAG_KEY_TYPE = OH_HUKS_TAG_TYPE_UINT \| 7,<br/>OH_HUKS_TAG_ASSOCIATED_DATA = OH_HUKS_TAG_TYPE_BYTES \| 8, OH_HUKS_TAG_NONCE = OH_HUKS_TAG_TYPE_BYTES \| 9, OH_HUKS_TAG_IV = OH_HUKS_TAG_TYPE_BYTES \| 10, OH_HUKS_TAG_INFO = OH_HUKS_TAG_TYPE_BYTES \| 11,<br/>OH_HUKS_TAG_SALT = OH_HUKS_TAG_TYPE_BYTES \| 12, OH_HUKS_TAG_ITERATION = OH_HUKS_TAG_TYPE_UINT \| 14, OH_HUKS_TAG_KEY_GENERATE_TYPE = OH_HUKS_TAG_TYPE_UINT \| 15,<br/>OH_HUKS_TAG_AGREE_ALG = OH_HUKS_TAG_TYPE_UINT \| 19,<br/>OH_HUKS_TAG_AGREE_PUBLIC_KEY_IS_KEY_ALIAS = OH_HUKS_TAG_TYPE_BOOL \| 20, OH_HUKS_TAG_AGREE_PRIVATE_KEY_ALIAS = OH_HUKS_TAG_TYPE_BYTES \| 21, OH_HUKS_TAG_AGREE_PUBLIC_KEY = OH_HUKS_TAG_TYPE_BYTES \| 22, OH_HUKS_TAG_KEY_ALIAS = OH_HUKS_TAG_TYPE_BYTES \| 23,<br/>OH_HUKS_TAG_DERIVE_KEY_SIZE = OH_HUKS_TAG_TYPE_UINT \| 24, OH_HUKS_TAG_IMPORT_KEY_TYPE = OH_HUKS_TAG_TYPE_UINT \| 25, OH_HUKS_TAG_UNWRAP_ALGORITHM_SUITE = OH_HUKS_TAG_TYPE_UINT \| 26, OH_HUKS_TAG_ALL_USERS = OH_HUKS_TAG_TYPE_BOOL \| 301,<br/>OH_HUKS_TAG_USER_ID = OH_HUKS_TAG_TYPE_UINT \| 302, OH_HUKS_TAG_NO_AUTH_REQUIRED = OH_HUKS_TAG_TYPE_BOOL \| 303, OH_HUKS_TAG_USER_AUTH_TYPE = OH_HUKS_TAG_TYPE_UINT \| 304, OH_HUKS_TAG_AUTH_TIMEOUT = OH_HUKS_TAG_TYPE_UINT \| 305,<br/>OH_HUKS_TAG_AUTH_TOKEN = OH_HUKS_TAG_TYPE_BYTES \| 306, OH_HUKS_TAG_KEY_AUTH_ACCESS_TYPE = OH_HUKS_TAG_TYPE_UINT \| 307, OH_HUKS_TAG_KEY_SECURE_SIGN_TYPE = OH_HUKS_TAG_TYPE_UINT \| 308, OH_HUKS_TAG_CHALLENGE_TYPE = OH_HUKS_TAG_TYPE_UINT \| 309,<br/>OH_HUKS_TAG_CHALLENGE_POS = OH_HUKS_TAG_TYPE_UINT \| 310, OH_HUKS_TAG_ATTESTATION_CHALLENGE = OH_HUKS_TAG_TYPE_BYTES \| 501, OH_HUKS_TAG_ATTESTATION_APPLICATION_ID = OH_HUKS_TAG_TYPE_BYTES \| 502,  OH_HUKS_TAG_ATTESTATION_ID_ALIAS = OH_HUKS_TAG_TYPE_BYTES \| 511,<br/> OH_HUKS_TAG_ATTESTATION_ID_SEC_LEVEL_INFO = OH_HUKS_TAG_TYPE_BYTES \| 514, OH_HUKS_TAG_ATTESTATION_ID_VERSION_INFO = OH_HUKS_TAG_TYPE_BYTES \| 515,<br/>OH_HUKS_TAG_IS_KEY_ALIAS = OH_HUKS_TAG_TYPE_BOOL \| 1001, OH_HUKS_TAG_KEY_STORAGE_FLAG = OH_HUKS_TAG_TYPE_UINT \| 1002, OH_HUKS_TAG_IS_ALLOWED_WRAP = OH_HUKS_TAG_TYPE_BOOL \| 1003, OH_HUKS_TAG_KEY_WRAP_TYPE = OH_HUKS_TAG_TYPE_UINT \| 1004,<br/>OH_HUKS_TAG_KEY_AUTH_ID = OH_HUKS_TAG_TYPE_BYTES \| 1005, OH_HUKS_TAG_KEY_ROLE = OH_HUKS_TAG_TYPE_UINT \| 1006, OH_HUKS_TAG_KEY_FLAG = OH_HUKS_TAG_TYPE_UINT \| 1007, OH_HUKS_TAG_IS_ASYNCHRONIZED = OH_HUKS_TAG_TYPE_UINT \| 1008,<br/> OH_HUKS_TAG_KEY_DOMAIN = OH_HUKS_TAG_TYPE_UINT \| 1011, OH_HUKS_TAG_SYMMETRIC_KEY_DATA = OH_HUKS_TAG_TYPE_BYTES \| 20001,<br/>OH_HUKS_TAG_ASYMMETRIC_PUBLIC_KEY_DATA = OH_HUKS_TAG_TYPE_BYTES \| 20002, OH_HUKS_TAG_ASYMMETRIC_PRIVATE_KEY_DATA = OH_HUKS_TAG_TYPE_BYTES \| 20003<br/>} | 参数集所用的TAG值枚举  | 
+| [OH_Huks_Tag](_huks_type_api.md#oh_huks_tag) {<br/> OH_HUKS_TAG_ALGORITHM = OH_HUKS_TAG_TYPE_UINT \| 1, OH_HUKS_TAG_PURPOSE = OH_HUKS_TAG_TYPE_UINT \| 2, OH_HUKS_TAG_KEY_SIZE = OH_HUKS_TAG_TYPE_UINT \| 3,<br/>OH_HUKS_TAG_DIGEST = OH_HUKS_TAG_TYPE_UINT \| 4, OH_HUKS_TAG_PADDING = OH_HUKS_TAG_TYPE_UINT \| 5, OH_HUKS_TAG_BLOCK_MODE = OH_HUKS_TAG_TYPE_UINT \| 6, OH_HUKS_TAG_KEY_TYPE = OH_HUKS_TAG_TYPE_UINT \| 7,<br/>OH_HUKS_TAG_ASSOCIATED_DATA = OH_HUKS_TAG_TYPE_BYTES \| 8, OH_HUKS_TAG_NONCE = OH_HUKS_TAG_TYPE_BYTES \| 9, OH_HUKS_TAG_IV = OH_HUKS_TAG_TYPE_BYTES \| 10, OH_HUKS_TAG_INFO = OH_HUKS_TAG_TYPE_BYTES \| 11,<br/>OH_HUKS_TAG_SALT = OH_HUKS_TAG_TYPE_BYTES \| 12, OH_HUKS_TAG_ITERATION = OH_HUKS_TAG_TYPE_UINT \| 14, OH_HUKS_TAG_KEY_GENERATE_TYPE = OH_HUKS_TAG_TYPE_UINT \| 15, OH_HUKS_TAG_AGREE_ALG = OH_HUKS_TAG_TYPE_UINT \| 19,<br/>OH_HUKS_TAG_AGREE_PUBLIC_KEY_IS_KEY_ALIAS = OH_HUKS_TAG_TYPE_BOOL \| 20, OH_HUKS_TAG_AGREE_PRIVATE_KEY_ALIAS = OH_HUKS_TAG_TYPE_BYTES \| 21, OH_HUKS_TAG_AGREE_PUBLIC_KEY = OH_HUKS_TAG_TYPE_BYTES \| 22, OH_HUKS_TAG_KEY_ALIAS = OH_HUKS_TAG_TYPE_BYTES \| 23,<br/>OH_HUKS_TAG_DERIVE_KEY_SIZE = OH_HUKS_TAG_TYPE_UINT \| 24, OH_HUKS_TAG_IMPORT_KEY_TYPE = OH_HUKS_TAG_TYPE_UINT \| 25, OH_HUKS_TAG_UNWRAP_ALGORITHM_SUITE = OH_HUKS_TAG_TYPE_UINT \| 26,<br/> OH_HUKS_TAG_DERIVED_AGREED_KEY_STORAGE_FLAG = OH_HUKS_TAG_TYPE_UINT \| 29, <br/>OH_HUKS_TAG_RSA_PSS_SALT_LEN_TYPE = OH_HUKS_TAG_TYPE_UINT \| 30, OH_HUKS_TAG_ALL_USERS = OH_HUKS_TAG_TYPE_BOOL \| 301,<br/>OH_HUKS_TAG_USER_ID = OH_HUKS_TAG_TYPE_UINT \| 302, OH_HUKS_TAG_NO_AUTH_REQUIRED = OH_HUKS_TAG_TYPE_BOOL \| 303, OH_HUKS_TAG_USER_AUTH_TYPE = OH_HUKS_TAG_TYPE_UINT \| 304, OH_HUKS_TAG_AUTH_TIMEOUT = OH_HUKS_TAG_TYPE_UINT \| 305,<br/>OH_HUKS_TAG_AUTH_TOKEN = OH_HUKS_TAG_TYPE_BYTES \| 306, OH_HUKS_TAG_KEY_AUTH_ACCESS_TYPE = OH_HUKS_TAG_TYPE_UINT \| 307, OH_HUKS_TAG_KEY_SECURE_SIGN_TYPE = OH_HUKS_TAG_TYPE_UINT \| 308, OH_HUKS_TAG_CHALLENGE_TYPE = OH_HUKS_TAG_TYPE_UINT \| 309,<br/>OH_HUKS_TAG_CHALLENGE_POS = OH_HUKS_TAG_TYPE_UINT \| 310, OH_HUKS_TAG_KEY_AUTH_PURPOSE = OH_HUKS_TAG_TYPE_UINT \| 311, OH_HUKS_TAG_ATTESTATION_CHALLENGE = OH_HUKS_TAG_TYPE_BYTES \| 501, OH_HUKS_TAG_ATTESTATION_APPLICATION_ID = OH_HUKS_TAG_TYPE_BYTES \| 502, OH_HUKS_TAG_ATTESTATION_ID_ALIAS = OH_HUKS_TAG_TYPE_BYTES \| 511,<br/>OH_HUKS_TAG_ATTESTATION_ID_SEC_LEVEL_INFO = OH_HUKS_TAG_TYPE_BYTES \| 514, OH_HUKS_TAG_ATTESTATION_ID_VERSION_INFO = OH_HUKS_TAG_TYPE_BYTES \| 515,<br/>OH_HUKS_TAG_IS_KEY_ALIAS = OH_HUKS_TAG_TYPE_BOOL \| 1001, OH_HUKS_TAG_KEY_STORAGE_FLAG = OH_HUKS_TAG_TYPE_UINT \| 1002, OH_HUKS_TAG_IS_ALLOWED_WRAP = OH_HUKS_TAG_TYPE_BOOL \| 1003, OH_HUKS_TAG_KEY_WRAP_TYPE = OH_HUKS_TAG_TYPE_UINT \| 1004,<br/>OH_HUKS_TAG_KEY_AUTH_ID = OH_HUKS_TAG_TYPE_BYTES \| 1005, OH_HUKS_TAG_KEY_ROLE = OH_HUKS_TAG_TYPE_UINT \| 1006, OH_HUKS_TAG_KEY_FLAG = OH_HUKS_TAG_TYPE_UINT \| 1007, OH_HUKS_TAG_IS_ASYNCHRONIZED = OH_HUKS_TAG_TYPE_UINT \| 1008,<br/> OH_HUKS_TAG_KEY_DOMAIN = OH_HUKS_TAG_TYPE_UINT \| 1011, OH_HUKS_TAG_SYMMETRIC_KEY_DATA = OH_HUKS_TAG_TYPE_BYTES \| 20001,<br/>OH_HUKS_TAG_ASYMMETRIC_PUBLIC_KEY_DATA = OH_HUKS_TAG_TYPE_BYTES \| 20002, OH_HUKS_TAG_ASYMMETRIC_PRIVATE_KEY_DATA = OH_HUKS_TAG_TYPE_BYTES \| 20003<br/>} | 参数集所用的TAG值枚举  | 
\ No newline at end of file

zh-cn/application-dev/reference/native-apis/rawfile.md

 # Rawfile
 
 
-提供操作rawfile目录和rawfile文件的功能。
-
-
-功能包括遍历、打开、搜索、读取和关闭rawfile。
+提供操作rawfile目录和rawfile文件的功能，包括打开、遍历、搜索、读取和关闭rawfile。
 
 
 **起始版本：**
@@ -50,12 +47,12 @@
 | [OH_ResourceManager_CloseRawDir](#oh_resourcemanager_closerawdir) ([RawDir](#rawdir) \*rawDir) | 关闭已打开的[RawDir](#rawdir)并释放所有相关联资源。       |
 | [OH_ResourceManager_ReadRawFile](#oh_resourcemanager_readrawfile) (const [RawFile](#rawfile) \*rawFile, void \*buf, size_t length) | 读取rawfile。                               |
 | [OH_ResourceManager_SeekRawFile](#oh_resourcemanager_seekrawfile) (const [RawFile](#rawfile) \*rawFile, long offset, int whence) | 基于指定的offset，在rawfile文件内搜索读写数据的位置。        |
-| [OH_ResourceManager_GetRawFileSize](#oh_resourcemanager_getrawfilesize) ([RawFile](#rawfile) \*rawFile) | 获取rawfile长度，单位为int32_t。                  |
+| [OH_ResourceManager_GetRawFileSize](#oh_resourcemanager_getrawfilesize) ([RawFile](#rawfile) \*rawFile) | 获取rawfile文件大小。                  |
 | [OH_ResourceManager_CloseRawFile](#oh_resourcemanager_closerawfile) ([RawFile](#rawfile) \*rawFile) | 关闭已打开的[RawFile](#rawfile) 以及释放所有相关联资源。   |
-| [OH_ResourceManager_GetRawFileOffset](#oh_resourcemanager_getrawfileoffset) (const [RawFile](#rawfile) \*rawFile) | 获取rawfile当前的offset，单位为int32_t。           |
-| [OH_ResourceManager_GetRawFileDescriptor](#oh_resourcemanager_getrawfiledescriptor) (const [RawFile](#rawfile) \*rawFile, [RawFileDescriptor](_raw_file_descriptor.md) &descriptor) | 基于offset(单位为int32_t)和文件长度打开rawfile，并获取rawfile文件描述符。 |
+| [OH_ResourceManager_GetRawFileOffset](#oh_resourcemanager_getrawfileoffset) (const [RawFile](#rawfile) \*rawFile) | 获取rawfile当前的offset。           |
+| [OH_ResourceManager_GetRawFileDescriptor](#oh_resourcemanager_getrawfiledescriptor) (const [RawFile](#rawfile) \*rawFile, [RawFileDescriptor](_raw_file_descriptor.md) &descriptor) | 基于offset和文件长度打开rawfile，并获取rawfile文件描述符。 |
 | [OH_ResourceManager_ReleaseRawFileDescriptor](#oh_resourcemanager_releaserawfiledescriptor) (const [RawFileDescriptor](_raw_file_descriptor.md) &descriptor) | 关闭rawfile文件描述符。                          |
-| [OH_ResourceManager_InitNativeResourceManager](#oh_resourcemanager_initnativeresourcemanager) (napi_env env, napi_value jsResMgr) | 基于JavaScript resource manager获取native resource manager。 |
+| [OH_ResourceManager_InitNativeResourceManager](#oh_resourcemanager_initnativeresourcemanager) (napi_env env, napi_value jsResMgr) | 基于JavaScript resource manager获取native resource manager。通过此对象完成rawfile相关功能。 |
 | [OH_ResourceManager_ReleaseNativeResourceManager](#oh_resourcemanager_releasenativeresourcemanager) ([NativeResourceManager](#nativeresourcemanager) \*resMgr) | 释放native resource manager。               |
 | [OH_ResourceManager_OpenRawDir](#oh_resourcemanager_openrawdir) (const [NativeResourceManager](#nativeresourcemanager) \*mgr, const char \*dirName) | 打开rawfile目录。                             |
 | [OH_ResourceManager_OpenRawFile](#oh_resourcemanager_openrawfile) (const [NativeResourceManager](#nativeresourcemanager) \*mgr, const char \*fileName) | 打开rawfile文件。                             |
@@ -64,10 +61,10 @@
 ## 详细描述
 
 
-## 类型定义说明
+### 类型定义说明
 
 
-### NativeResourceManager
+#### NativeResourceManager
 
 
 ```
@@ -78,14 +75,14 @@ typedef struct NativeResourceManager NativeResourceManager
 
 代表resource manager。
 
-此类封装了JavaScript resource manager的native实现 **ResourceManager**指针可以通过调用[OH_ResourceManager_InitNativeResourceManager](#oh_resourcemanager_initnativeresourcemanager)方法获取
+此类封装了JavaScript resource manager的native实现，**ResourceManager**指针可以通过调用[OH_ResourceManager_InitNativeResourceManager](#oh_resourcemanager_initnativeresourcemanager)方法获取。
 
 **起始版本：**
 
 8
 
 
-### RawDir
+#### RawDir
 
 
 ```
@@ -101,7 +98,7 @@ typedef struct RawDir RawDir
 8
 
 
-### RawFile
+#### RawFile
 
 
 ```
@@ -110,17 +107,17 @@ typedef struct RawFile RawFile
 
 **描述：**
 
-提供对rawfile的访问功能。
+提供对rawfile文件操作的相关功能。
 
 **起始版本：**
 
 8
 
 
-## 函数说明
+### 函数说明
 
 
-### OH_ResourceManager_CloseRawDir()
+#### OH_ResourceManager_CloseRawDir()
 
 
 ```
@@ -146,7 +143,7 @@ void OH_ResourceManager_CloseRawDir (RawDir * rawDir)
 8
 
 
-### OH_ResourceManager_CloseRawFile()
+#### OH_ResourceManager_CloseRawFile()
 
 
 ```
@@ -172,7 +169,7 @@ void OH_ResourceManager_CloseRawFile (RawFile * rawFile)
 8
 
 
-### OH_ResourceManager_GetRawFileCount()
+#### OH_ResourceManager_GetRawFileCount()
 
 
 ```
@@ -200,7 +197,7 @@ int OH_ResourceManager_GetRawFileCount (RawDir * rawDir)
 8
 
 
-### OH_ResourceManager_GetRawFileDescriptor()
+#### OH_ResourceManager_GetRawFileDescriptor()
 
 
 ```
@@ -209,7 +206,7 @@ bool OH_ResourceManager_GetRawFileDescriptor (const RawFile * rawFile, RawFileDe
 
 **描述：**
 
-基于offset(单位为int32_t)和文件长度打开rawfile，并获取rawfile文件描述符。
+基于offset和文件长度打开rawfile，并获取rawfile文件描述符。
 
 打开的文件描述符被用于读取rawfile。
 
@@ -229,7 +226,7 @@ bool OH_ResourceManager_GetRawFileDescriptor (const RawFile * rawFile, RawFileDe
 8
 
 
-### OH_ResourceManager_GetRawFileName()
+#### OH_ResourceManager_GetRawFileName()
 
 
 ```
@@ -262,7 +259,7 @@ const char* OH_ResourceManager_GetRawFileName (RawDir * rawDir, int index )
 8
 
 
-### OH_ResourceManager_GetRawFileOffset()
+#### OH_ResourceManager_GetRawFileOffset()
 
 
 ```
@@ -271,7 +268,7 @@ long OH_ResourceManager_GetRawFileOffset (const RawFile * rawFile)
 
 **描述：**
 
-获取rawfile当前的offset，单位为int32_t。
+获取rawfile当前的offset。
 
 rawfile当前的offset。
 
@@ -290,7 +287,7 @@ rawfile当前的offset。
 8
 
 
-### OH_ResourceManager_GetRawFileSize()
+#### OH_ResourceManager_GetRawFileSize()
 
 
 ```
@@ -299,7 +296,7 @@ long OH_ResourceManager_GetRawFileSize (RawFile * rawFile)
 
 **描述：**
 
-获取rawfile长度，单位为int32_t。
+获取rawfile文件大小。
 
 **参数：**
 
@@ -309,14 +306,14 @@ long OH_ResourceManager_GetRawFileSize (RawFile * rawFile)
 
 **返回：**
 
-Returns rawfile整体长度。
+Returns rawfile整体文件大小。
 
 **起始版本：**
 
 8
 
 
-### OH_ResourceManager_InitNativeResourceManager()
+#### OH_ResourceManager_InitNativeResourceManager()
 
 
 ```
@@ -345,7 +342,7 @@ NativeResourceManager* OH_ResourceManager_InitNativeResourceManager (napi_env en
 8
 
 
-### OH_ResourceManager_OpenRawDir()
+#### OH_ResourceManager_OpenRawDir()
 
 
 ```
@@ -380,7 +377,7 @@ RawDir* OH_ResourceManager_OpenRawDir (const NativeResourceManager * mgr, const
 8
 
 
-### OH_ResourceManager_OpenRawFile()
+#### OH_ResourceManager_OpenRawFile()
 
 
 ```
@@ -415,7 +412,7 @@ RawFile* OH_ResourceManager_OpenRawFile (const NativeResourceManager * mgr, cons
 8
 
 
-### OH_ResourceManager_ReadRawFile()
+#### OH_ResourceManager_ReadRawFile()
 
 
 ```
@@ -445,7 +442,7 @@ int OH_ResourceManager_ReadRawFile (const RawFile * rawFile, void * buf, size_t
 8
 
 
-### OH_ResourceManager_ReleaseNativeResourceManager()
+#### OH_ResourceManager_ReleaseNativeResourceManager()
 
 
 ```
@@ -467,7 +464,7 @@ void OH_ResourceManager_ReleaseNativeResourceManager (NativeResourceManager * re
 8
 
 
-### OH_ResourceManager_ReleaseRawFileDescriptor()
+#### OH_ResourceManager_ReleaseRawFileDescriptor()
 
 
 ```
@@ -495,7 +492,7 @@ bool OH_ResourceManager_ReleaseRawFileDescriptor (const RawFileDescriptor & desc
 8
 
 
-### OH_ResourceManager_SeekRawFile()
+#### OH_ResourceManager_SeekRawFile()
 
 
 ```

zh-cn/application-dev/security/huks-guidelines.md

@@ -2717,3 +2717,6 @@ async function AttestKeyTest() {
 2. Property 'finishSession' does not exist on type 'typeof huks'. Did you mean 'finish'?
 
    不能在huks库中找到finishSession，finishSession是API9版本的，请更新SDK版本或替换新版本的security.huks.d.ts文件。
+
+## 相关实例
+[通用密钥库系统](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Security/Huks): 本示例使用huks相关接口实现了对任意输入内容进行加密和解密的功能
\ No newline at end of file

zh-cn/application-dev/ui/arkts-graphics-display.md

@@ -26,6 +26,7 @@ Image支持加载存档图、多媒体像素图两种类型。
 存档图类型的数据源可以分为本地资源、网络资源、Resource资源、媒体库datashare资源和base64。
 
 - 本地资源
+
   创建文件夹，将本地图片放入ets文件夹下的任意位置。
 
   Image组件引入本地图片路径，即可显示图片（根目录为ets文件夹）。
@@ -36,6 +37,7 @@ Image支持加载存档图、多媒体像素图两种类型。
   ```
 
 - 网络资源
+
   引入网络图片需申请权限ohos.permission.INTERNET，具体申请方式请参考[权限申请声明](../security/accesstoken-guidelines.md)。此时，Image组件的src参数为网络图片的链接。
 
   ```ts
@@ -43,6 +45,7 @@ Image支持加载存档图、多媒体像素图两种类型。
   ```
 
 - Resource资源
+
   使用资源格式可以跨包/跨模块引入图片，resources文件夹下的图片都可以通过$r资源接口读 取到并转换到Resource格式。
 
   **图1** resouces  
@@ -68,6 +71,7 @@ Image支持加载存档图、多媒体像素图两种类型。
   ```
 
 - 媒体库datashare
+
   支持datashare://路径前缀的字符串，用于访问通过媒体库提供的图片路径。
 
   1. 调用接口获取图库的照片url。

zh-cn/application-dev/web/web-in-page-app-function-invoking.md

@@ -92,7 +92,7 @@
   > 使用[registerJavaScriptProxy()](../reference/apis/js-apis-webview.md#registerjavascriptproxy)接口注册方法时，注册后需调用[refresh()](../reference/apis/js-apis-webview.md#refresh)接口生效。
 
 
-- index.htm前端页面触发应用侧代码。
+- index.html前端页面触发应用侧代码。
 
   ```html
   <!-- index.html -->

zh-cn/application-dev/website.md

@@ -713,15 +713,16 @@
         - [颜色渐变](reference/arkui-ts/ts-universal-attributes-gradient-color.md)
         - [Popup控制](reference/arkui-ts/ts-universal-attributes-popup.md)
         - [Menu控制](reference/arkui-ts/ts-universal-attributes-menu.md)
-        - [点击控制](reference/arkui-ts/ts-universal-attributes-click.md)
         - [焦点控制](reference/arkui-ts/ts-universal-attributes-focus.md)
         - [悬浮态效果](reference/arkui-ts/ts-universal-attributes-hover-effect.md)
         - [组件标识](reference/arkui-ts/ts-universal-attributes-component-id.md)
-        - [触摸热区设置](reference/arkui-ts/ts-universal-attributes-touch-target.md)
         - [多态样式](reference/arkui-ts/ts-universal-attributes-polymorphic-style.md)
-        - [触摸测试控制](reference/arkui-ts/ts-universal-attributes-hit-test-behavior.md)
         - [分布式迁移标识](reference/arkui-ts/ts-universal-attributes-restoreId.md)
         - [前景色设置](reference/arkui-ts/ts-universal-attributes-foreground-color.md)
+        - 触摸交互控制
+          - [点击控制](reference/arkui-ts/ts-universal-attributes-click.md)
+          - [触摸热区设置](reference/arkui-ts/ts-universal-attributes-touch-target.md)
+          - [触摸测试控制](reference/arkui-ts/ts-universal-attributes-hit-test-behavior.md)
         - 模态转场设置
           - [全屏模态转场](reference/arkui-ts/ts-universal-attributes-modal-transition.md)
           - [半模态转场](reference/arkui-ts/ts-universal-attributes-sheet-transition.md)

zh-cn/contribute/OpenHarmony-hdf-coding-guide.md

@@ -190,7 +190,7 @@ root {
 
 【说明】HDF框架将一类设备驱动放在同一个Host里面，开发者也可以将Host中的驱动功能分层独立开发和部署，支持一个驱动多个Node，HDF驱动模型如下图所示：
 
-![HDF驱动模型.png](../device-dev/driver/figures/HDF驱动模型.png)
+![HDF驱动模型.png](figures/HDF驱动模型.png)
 
 开发者应当将同一类的设备放在同一个Host里面，在新增设备时，检查是否已经存在同类型的Host。如果已存在Host，则将Device配置在此Host中，禁止重复配置Host。一个驱动设备应该只属于一类驱动类型，因此也禁止将同一个Device配置在不同Host当中。
 

zh-cn/device-dev/driver/driver-peripherals-external-des.md

@@ -5,65 +5,71 @@
 
 ### 功能简介
 
-WLAN（Wireless Local Area Network）作为网络设备的一个重要特性，其驱动的开发也是设备开发过程中不可忽略的一部分。
-在OpenHarmony架构中，基于HDF（Hardware Driver Foundation）驱动框架开发的WLAN驱动模块，具备跨操作系统迁移、自适应器件差异、模块化拼装编译等特性。
+无线局域网数据传输是端侧设备不可或缺的一部分，用户可以方便地接入到无线网络进行数据传输和共享，并且在无线网络覆盖区域自由移动，彻底摆脱有线的束缚。基于HDF（Hardware Driver Foundation）驱动框架开发的WLAN驱动，能够屏蔽硬件器件差异，为上层WLAN服务提供稳定的基础能力接口，包括启动扫描、关联/取消关联热点、获取MAC地址、设置MAC地址、获取链路信息等。
 
-### 运作机制
+### 基本概念
+
+开发前，开发者应了解一下WLAN涉及的基本概念：
 
-各WLAN设备厂商的驱动开发人员可根据WLAN模块提供的向下、向上的统一接口适配各自的驱动代码：
+- AP
   
-- 向下统一接口实现的能力包括：建立/关闭WLAN热点、扫描、关联WLAN热点等。
-- 对HDI层向上提供能力包括：设置MAC地址、设置发射功率、获取设备的MAC地址等。
+  无线接入点（Access Point，简称AP），是网络的中心节点，提供无线接入服务。其它无线设备接入后，可以进行数据访问。
 
-WLAN框架如图1所示，其中WLAN Driver模块主要提供启动加载、配置文件解析、提供总线抽象接口等能力，WLAN Chip Driver模块主要提供MAC子层管理实体等。
+- STA
   
-  **图1** WLAN框架
+  站点（Station，简称STA），是无线局域网的最基本组成单元。每一个连接到无线网络中的终端（如笔记本电脑、PDA及其它可以联网的用户设备）都可称为一个站点。
 
-  ![image](figures/WLAN框架.png "WLAN框架")
+- ssid
   
-  WLAN Driver框架如图2所示。
+  无线网络的名称，用来标识一个无线网络，每个无线网络都有自己的ssid。
 
-  **图2** WLAN Driver框架
+- bssid
   
-  ![zh-cn_image_0000001300092359](figures/zh-cn_image_0000001300092359.png)
+  用于标识WLAN中的基本服务集，是唯一的48位MAC地址。
   
-WLAN Driver框架主要由如下模块组成：
+- Scan
 
-1. WLAN Message：该部件为每个服务单独提供业务接口，每个服务也可依赖其他服务形成组合业务接口，此模块支持在用户态、内核态和MCU环境运行，实现部件间的充分解耦。
+  终端设备扫描环境中的无线网络，获取到周围的无线网络信息。包括热点名称（ssid）、工作频带和信号强度等。
 
-2. WLAN Configuration Core：WLAN相关的配置文件进行解析。
+- Associate
 
-3. AP：AP（Access Point）为WLAN终端提供外部接入入口的设备。
+  终端设备指定有效的热点进行连接，成功后即可与AP端数据通信。终端同一时刻只可以和一个AP建立链路。
+
+### 运作机制
 
-4. STA：STA（Station）为接入WLAN系统的终端。
+本文主要介绍基于HDF（Hardware Driver Foundation）驱动框架开发的WLAN功能。WLAN整体框架：
 
-5. Mac80211：定义底层驱动相关的MAC层接口。
+![image](figures/WLAN驱动接口框架图.png "WLAN框架图")
 
-6. Bus：该驱动模块向上提供统一的总线抽象接口。通过向下调用Platform层提供的SDIO接口和封装适配USB、PCIE接口，屏蔽不同内核的差异；通过对不同类型的总线操作进行统一封装，屏蔽不同芯片差异，能够对不同芯片厂商提供完备的总线驱动能力，不同厂商共用此模块接口，从而使厂商的开发更为便捷和统一。
+1. 上层服务基于业务需要调用HDI接口，将用户态消息通过WPA层或HAL层下发至Client层。WPA层接口提供设置加密方式、关联热点、设置信道、隐藏热点等功能，HAL层接口作为WPA接口的补充，提供设置国家码、设置MAC地址、获取信道信息等功能。
    
-7. NetDevice：用于建立专属网络设备，屏蔽不同OS的差异，对WiFi驱动提供统一接口，提供统一的HDF NetDevice数据结构，及其统一管理、注册、去注册能力；对接轻设备及富设备上的Linux的网络设备层。
+2. Message模块将用户态的消息按组件分发至AP、STA等模块。
    
-8. NetBuf：该部件为WLAN驱动提供Linux或者LiteOS原生的网络数据缓冲的统一数据结构的封装以及对网络数据的操作接口的封装。
+3. Hdf_Mac80211定义底层驱动相关的MAC层接口。命令字段下发至Hdf_Mac80211，再通过Bus模块发送到WLAN芯片固件侧。
    
-9. FlowCtl：流控模块，当数据量过大时按照优先级策略处理数据。
+4. Bus模块向上提供统一的总线抽象接口。通过向下调用Platform层提供的SDIO接口和封装适配USB、PCIE接口，屏蔽不同内核的差异；通过对不同类型的总线操作进行统一封装，屏蔽不同芯片差异，能够对不同芯片厂商提供完备的总线驱动能力，不同厂商共用此模块接口，从而使厂商的开发更为便捷和统一。
    
-10. HCC-CFG：WLAN相关参数配置其中包括板级配置、驱动配置、Module配置。
+5. EAPOL（Extensible Authentication Protocol Over LAN），基于局域网的扩展认证协议，主要用于在客户端和设备（接入设备、服务器）之间传送EAP协议报文，以允许EAP协议报文在LAN上传送，完成认证流程，实现设备上线功能。
    
-其中主要模块关系如下：
+6. NetDevice用于建立专属网络设备，屏蔽不同OS的差异，对WiFi驱动提供统一接口，提供统一的HDF NetDevice数据结构，及其统一管理、注册、去注册能力；对接轻设备及富设备上的Linux的网络设备层。
    
-1. WLAN Driver通过HCC-CFG模块和WLAN Configuration Core模块进行配置文件的解析与加载。
+7. NetBuf为WLAN驱动提供Linux或者LiteOS原生的网络数据缓冲的统一数据结构的封装以及对网络数据的操作接口的封装。
    
-2. WLAN Message将用户态的消息按组件分发至AP、STA等模块。
+8. 协议栈与NetDevice模块、NetBuf模块共同协同完成数据流交互。
 
-3. 对于命令字段则下发至Mac80211，再通过Bus模块发送到WLAN芯片固件侧。
+### 约束与限制
 
-4. 协议栈与NetDevice模块、NetBuf模块、FlowCtl模块共同协同完成数据流交互。
+WLAN驱动为上层WLAN服务提供稳定的基础能力接口，HDI接口适用于标准系统，HAL接口适用于小型系统及轻量系统。
 
 ## 开发指导
 
+### 场景介绍
+
+WLAN驱动的主要工作是为上层WLAN服务提供稳定的基础能力接口，保证用户可以方便地接入到无线网络，实现数据传输和共享。不同WLAN模组需要适配OpenHarmony时，请参考如下的接口说明和开发步骤。
+
 ### 接口说明
 
-WLAN模块有三部分对外开放的API接口，如下图所示：
+WLAN模块有三部分对外开放的API接口：
 
 1. 对上层服务提供HDI以及HAL能力接口。
 
@@ -71,12 +77,7 @@ WLAN模块有三部分对外开放的API接口，如下图所示：
 
 3. 驱动直接调用WLAN模块能力接口。
 
-  **图3** WLAN驱动接口框架图
-
-  ![image](figures/WLAN驱动接口框架图.png "WLAN驱动接口框架图")
-
-
-- WLAN驱动模块对上层服务提供的HAL能力接口（适用于小型系统及轻量系统），主要功能有：创建/销毁 IWiFi对象、设置MAC地址等。提供的部分接口说明如表2、表3所示：
+- WLAN驱动模块对上层服务提供的能力接口，主要功能有：创建/销毁IWiFi对象、设置MAC地址、设置发射功率等。以下接口列举的为IDL接口描述生成的对应C语言函数接口，如表1、表2所示。接口声明见idl文件（/drivers/interface/wlan/v1_1/）。
 
     **表1** wifi_hal.h
 
@@ -96,7 +97,7 @@ WLAN模块有三部分对外开放的API接口，如下图所示：
   | int32_t (\*getDeviceMacAddress)(const struct IWiFiBaseFeature \*, unsigned char \*, uint8_t) | 获取设备持久化的MAC地址。 | 
   | int32_t (\*setTxPower)(const struct IWiFiBaseFeature \*, int32_t) | 设置发射功率。 |
 
-- WLAN驱动模块也提供了需要驱动开发人员自行去填充具体实现内容的能力接口，主要功能有：初始化/注销NetDevice、打开/关闭NetDevice、获取NetDevice的状态等。提供的部分接口说明如表4所示：
+- WLAN驱动模块提供了需要驱动开发人员自行去填充具体实现内容的能力接口，主要功能有：初始化/注销NetDevice、打开/关闭NetDevice、获取NetDevice的状态等。提供的部分接口说明如表3所示：
 
     **表3** net_device.h
 
@@ -111,7 +112,7 @@ WLAN模块有三部分对外开放的API接口，如下图所示：
 
 - WLAN驱动模块提供给驱动开发人员可直接调用的能力接口，主要功能有：创建/释放WifiModule、关联/取消关联、申请/释放NetBuf、lwip的pbuf和NetBuf的相互转换等。
 
-  可直接调用的接口如表5、表6和表7所示。
+  可直接调用的接口如表4、表5和表6所示。
 
     **表4** wifi_module.h
 
@@ -142,25 +143,10 @@ WLAN模块有三部分对外开放的API接口，如下图所示：
   | struct pbuf \*NetBuf2Pbuf(const struct NetBuf \*nb) | NetBuf转换为lwip的pbuf。 |
 
 ### 开发步骤
-#### 厂商适配WLAN框架
-
-WLAN驱动基于HDF框架和Platform框架开发，不区分OS和芯片平台，为不同厂商的WLAN模组提供统一的驱动模型，各WLAN模组厂商根据如下开发流程适配WLAN驱动框架。
-
-**开发流程**
-
-1. 配置硬件（例如module、芯片等）相关的参数。wlan_platform.hcs文件中对参数进行配置后，HDF框架会对该文件进行解析，并生成全量配置的结构体对象。
-
-2. 初始化和去初始化WLAN模块相关适配（如WLAN芯片初始化和去初始化、WLAN芯片驱动初始化和去初始化）。
 
-3. 控制流命令下发的适配。
+WLAN驱动基于HDF框架和Platform框架开发，不区分OS和芯片平台，为不同厂商的WLAN模组提供统一的驱动模型，各WLAN模组厂商根据如下开发流程适配WLAN驱动框架。示例以Hi3881WLAN芯片为例。
 
-4. 事件上报的调用。
-
-**开发实例**
-
-本例程提供WLAN模块初始化过程的完整使用流程。示例如下（以Hi3881WLAN芯片为例）：
-
-1. Driver的HCS配置。
+#### 配置Driver的HCS文件
 
    HCS文件配置包括：device相关配置和组件配置。
 
@@ -225,7 +211,8 @@ WLAN驱动基于HDF框架和Platform框架开发，不区分OS和芯片平台，
         }
         ```
 
-2. 驱动适配挂接WLAN芯片的初始化和去初始化、WLAN芯片驱动的初始化和去初始化。
+#### 初始化和去初始化WLAN芯片、WLAN芯片驱动
+
    - 驱动适配入口函数实现
 
      根据各自的芯片定义一个HdfDriverEntry类型的变量，主要实现Bind、Init、Release接口的函数挂接。调用HDF_INIT将驱动入口注册到HDF框架中，在加载驱动时HDF框架会先调用Bind函数，再调用Init函数加载该驱动。当Init调用异常时，HDF框架会调用Release释放驱动资源。
@@ -280,7 +267,8 @@ WLAN驱动基于HDF框架和Platform框架开发，不区分OS和芯片平台，
      }
      ```
 
-   - 芯片的初始化和去初始化
+     1. 芯片的初始化和去初始化
+
       ```c
       /* WLAN芯片的初始化函数 */
       int32_t InitHi3881Chip(struct HdfWlanDevice *device)
@@ -321,7 +309,9 @@ WLAN驱动基于HDF框架和Platform框架开发，不区分OS和芯片平台，
           return ret;
       }
       ```
-   - 芯片驱动的初始化和去初始化
+
+     2. 芯片驱动的初始化和去初始化
+   
       ```c
       /* WLAN芯片驱动挂接以及Mac80211与芯片侧的函数挂接 */
       static struct HdfChipDriver *BuildHi3881Driver(struct HdfWlanDevice *device, uint8_t ifIndex)
@@ -487,7 +477,9 @@ WLAN驱动基于HDF框架和Platform框架开发，不区分OS和芯片平台，
       }
       ```
 
-3. 命令下发绑定，包括具有公共能力的设置MAC地址、设置发射功率等；STA相关的连接、扫描等；AP相关的启动AP、设置国家码等。
+#### 适配MAC层能力接口
+
+   用户态消息下发到驱动后，驱动会调用相应的MAC层能力接口。
 
    ```c
    /* 驱动需要实现的MAC层基本能力的控制接口 */
@@ -548,7 +540,9 @@ WLAN驱动基于HDF框架和Platform框架开发，不区分OS和芯片平台，
    }
    ```
 
-4. 事件上报接口调用，WLAN框架提供了event事件的上报接口，详情见hdf_wifi_event.c，例：调用HdfWiFiEventNewSta AP上报新关联的某个STA的情况。
+#### 适配event事件上报
+   
+   WLAN框架提供了event事件的上报接口，详情见hdf_wifi_event.c，例：调用HdfWiFiEventNewSta AP上报新关联的某个STA的情况。
 
    ```c
    hi_u32 oal_cfg80211_new_sta(oal_net_device_stru *net_device, const hi_u8 *mac_addr, hi_u8 addr_len,
@@ -569,7 +563,10 @@ WLAN驱动基于HDF框架和Platform框架开发，不区分OS和芯片平台，
        return HI_SUCCESS;
    }
    ```
-**调测验证**
+
+### 调测验证
+
+#### 驱动适配验证
 
 驱动开发完成后，在WLAN模块单元测试里面开发自测试用例以及验证WLAN模块基本功能。测试环境采用开发者自测试平台（这里以Hi3516DV300标准系统为例）。
 
@@ -739,7 +736,8 @@ WLAN驱动基于HDF框架和Platform框架开发，不区分OS和芯片平台，
 
         上述xxx.xxx.xxx.xxx为当前测试终端的IP地址，若测试能够ping通测试终端则表示，WLAN驱动基本功能正常。
 
-#### 接口调用
+#### 接口使用实例
+
 WLAN驱动模块向上层提供两种能力接口：HDI接口和HAL接口。
 - HDI接口调用
 

zh-cn/release-notes/changelogs/OpenHarmony_4.0.8.2/changelogs-arkui.md

+# arkui子系统ChangeLog
+
+## cl.arkui.1 状态变量数据类型声明使用限制。
+
+所有的状态装饰器变量需要显式声明变量类型，不允许声明any。
+
+**示例：**
+
+```ts
+// xxx.ets
+@Entry
+@Component
+struct DatePickerExample {
+  // 错误写法: @State isLunar: any = false
+  @State isLunar: boolean = false
+
+  build() {
+   ...
+  }
+}
+```
+
+**变更影响**
+
+如果状态装饰器变量没有显式声明变量类型，声明any，编译拦截等级由WARN变成ERROR。
+
+```ts
+// ArkTS:ERROR Please define an explicit type, not any.
+@State isLunar: any = false
+```
+
+**关键的接口/组件变更**
+
+不涉及。
+
+**适配指导**
+
+状态装饰器变量声明具体的变量类型替代any。
+
+## cl.arkui.2 自定义组件成员变量初始化的规则与约束。
+
+不允许从父组件初始化`@LocalStorageLink`, `@LocalStorageProp`修饰的变量。
+
+**示例：**
+
+```ts
+let NextID: number = 0;
+
+@Observed
+class ClassA {
+  public id: number;
+  public c: number;
+
+  constructor(c: number) {
+    this.id = NextID++;
+    this.c = c;
+  }
+}
+
+@Entry
+@Component
+struct LocalStorageComponent {
+  build() {
+    Column() {
+      Child({
+        /* ArkTS:ERROR Property 'simpleVarName' in the custom component 'Child' cannot
+          initialize here (forbidden to specify). */
+        simpleVarName: 1,
+        /* ArkTS:ERROR Property 'objectName' in the custom component 'Child' cannot
+          initialize here (forbidden to specify). */
+        objectName: new ClassA(1)
+      })
+    }
+  }
+}
+
+@Component
+struct Child {
+  @LocalStorageLink("storageSimpleProp") simpleVarName: number = 0;
+  @LocalStorageProp("storageObjectProp") objectName: ClassA = new ClassA(1);
+
+  build() {
+  }
+}
+```
+
+**变更影响**
+
+如果父组件初始化`@LocalStorageLink`, `@LocalStorageProp`修饰的变量，编译拦截等级由WARN变成ERROR。
+
+**关键的接口/组件变更**
+
+不涉及。
+
+**适配指导**
+
+构造子组件时，不对子组件的`@LocalStorageLink`, `@LocalStorageProp`修饰的变量进行赋值。
+
+如果需要在父组件中修改子组件的`@LocalStorageLink`, `@LocalStorageProp`修饰的变量，则使用LocalStorage提供的API接口方法(比如set方法)赋值。
+