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

zh-cn/application-dev/ability/ability-assistant-guidelines.md

@@ -40,7 +40,7 @@ Ability assistant（Ability助手，简称为aa）是实现应用、原子化服
 
   当成功启动Ability时，返回“start ability successfully.”；当启动失败时，返回“error: failed to start ability.”。
 
-  使用方法：
+  **使用方法：**
 
   ```
   aa start [-d <device-id>] -a <ability-name> -b <bundle-name> [-D]
@@ -61,7 +61,7 @@ Ability assistant（Ability助手，简称为aa）是实现应用、原子化服
 
   当成功停止Service Ability时，返回“stop service ability successfully.”；当停止失败时，返回“error: failed to stop service ability.”。
 
-  使用方法：
+  **使用方法：**
 
   ```
   aa stop-service [-d <device-id>] -a <ability-name> -b <bundle-name>
@@ -71,16 +71,17 @@ Ability assistant（Ability助手，简称为aa）是实现应用、原子化服
 
   用于打印Ability的相关信息。
 
-  | 参数                   | 参数说明                               |
-  | ---------------------- | -------------------------------------- |
-  | -h/--help              | 帮助信息。                             |
-  | -a/--all               | 打印所有mission内的Ability。           |
-  | -s/--stack \<number>   | 打印指定mission stack内的Ability。     |
-  | -m/--mission \<number> | 打印指定mission内的Ability。           |
-  | -l/--stack-list        | 打印每个mission stack内的mission列表。 |
-  | -u/--ui                | 打印system ui Ability。                |
-  | -e/--serv              | 打印Service Ability。                  |
-  | -d/--data              | 打印Data Ability。                     |
+  | 参数              | 二级参数             | 参数说明                                                     |
+  | ----------------- | -------------------- | ------------------------------------------------------------ |
+  | -h/--help         | -                    | 帮助信息。                                                   |
+  | -a/--all          | -                    | 打印所有mission内的Ability。                                 |
+  | -l/--mission-list | type（缺省打印全部） | 打印任务栈信息。<br />type：<br />NORMAL <br />DEFAULT_STANDARD<br />DEFAULT_SINGLE<br />LAUNCHER |
+  | -e/--extension    | elementName          | 打印扩展组件信息。                                           |
+  | -u/--userId       | UserId               | 打印指定UserId的栈信息，需要和其他参数组合使用，例如 aa dump -a -u 100、aa dump -d -u 100、 |
+  | -d/--data         |                      | 打印Data Ability。                                           |
+  | -i/--ability      | AbilityRecord ID     | 打印指定Ability详细信息                                      |
+  | -c/--client       |                      | 打印Ability详细信息，需要和其他参数组合使用，例如 aa dump -a -c、aa dump -i 21 -c、 |
+  
 
   **使用方法：**
 

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

-# Ability框架概述
+# Ability框架概述
\ No newline at end of file
+
+​        Ability是应用所具备能力的抽象，也是应用程序的重要组成部分。Ability是系统调度应用的最小单元，是能够完成一个独立功能的组件，一个应用可以包含一个或多个Ability。 
+
+​        Ability框架模型结构具有两种形态。第一种形态为FA模型，API 8及其更早版本的应用程序只能使用FA模型进行开发， FA模型将Ability分为FA（Feature Ability）和PA（Particle Ability）两种类型，其中FA支持Page Ability，PA支持Service Ability和Data Ability；从API9开始，Ability框架引入了Stage模型作为第二种应用形态，Stage模型将Ability分为PageAbility和ExtensionAbility两大类，其中ExtensionAbility又被扩展为ServiceExtensionAbility、FormExtensionAbility、DataShareExtensionAbility等等一系列ExtensionAbility，以便满足更多的使用场景。
+
+​         Stage模型的设计，主要是为了方便开发者更加方便地开发出分布式环境下的复杂应用。对于开发者而言，两种模型的主要区别在于：
+
+* Ability类型存在差异，接口使用上也存在一定的区别；
+
+  ![favsstage](figures/favsstage.png)
+
+* Ability生命周期存在差异；
+
+  ![lifecycle](figures/lifecycle.png)
+
+* 应用的配置文件及应用包的结构存在差异，这些差异将体现在通过IDE生成的应用包中。
+
+​        两种模型的基本介绍，详见[FA模型综述](fa-brief.md)及[Stage模型综述](stage-brief.md)。
\ No newline at end of file

zh-cn/application-dev/ability/fa-brief.md

-# FA模型综述
+# FA模型综述
\ No newline at end of file
+
+## 整体架构
+鸿蒙用户程序的开发本质上就是开发Ability，OpenHarmony系统也是通过调度Ability，通过系统提供的一致性调度契约对Ability进行生命周期管理，从而实现对用户程序的调度。FA模型中Ability分为PageAbility、ServiceAbility和DataAbility三种类型。其中PageAbility具备ArkUI的Ability，是用户具体可见并可以交互的Ability实例；ServiceAbility也是Ability一种，但是没有UI，提供其他Ability调用自定义的服务，在后台运行；DataAbility也是没有UI，提供其他Ability进行数据的增删查服务，在后台运行。
+
+## 应用包结构
+**应用包结构如下图所示：**
+![fa-package-info](figures/fa-package-info.png)
+
+## 生命周期
+
+**pageAbility生命周期回调如下图所示：**
+
+![fa-pageAbility-lifecycle](figures/fa-pageAbility-lifecycle.png)
+
+开发者可以在 app.js/app.ets 中重写生命周期函数，在对应的生命周期函数内处理应用相应逻辑。
+
+
+## 进程线程模型
+应用独享独立进程，Ability独享独立线程，应用进程在Ability第一次启动时创建，并为启动的Ability创建线程，应用启动后再启动应用内其他Ability，会为每一个Ability创建相应的线程。每个Ability绑定一个独立的JSRuntime实例，因此Ability之间是隔离的。
+
+![fa-threading-nodel](figures/fa-threading-model.png)
\ No newline at end of file

zh-cn/application-dev/ability/fa-pageability.md

@@ -27,19 +27,19 @@ Page模板（以下简称“Page”）是FA唯一支持的模板，用于提供
 
 **PageAbility类型Ability生命周期回调如下图所示：**
 
-![PageAbility-Lifecycel-Callbacks](figures/page-ability-lifecycle-callbacks.png)
+![fa-pageAbility-lifecycle](figures/fa-pageAbility-lifecycle.png)
 
   
 
 ## 启动本地PageAbility
 
- 导入模块
+ * 导入模块
 
 ```
 import featureAbility from '@ohos.ability.featureAbility'
 ```
 ```
- FeatureAbility.startAbility(parameter: StartAbilityParameter, callback: AsyncCallback<number>)
+ featureAbility.startAbility(parameter: StartAbilityParameter, callback: AsyncCallback<number>)
 ```
 
 * 接口说明
@@ -50,61 +50,75 @@ import featureAbility from '@ohos.ability.featureAbility'
 
 ```javascript
 import featureAbility from '@ohos.ability.featureAbility'
-featureAbility.startAbility(
-        {
-        want:
-        {
-            action: "",
-            entities: [""],
-            type: "",
-            options: {
-                // indicates the grant to perform read operations on the URI
-                authReadUriPermission: true,
-                // indicates the grant to perform write operations on the URI
-                authWriteUriPermission: true,
-                // support forward intent result to origin ability
-                abilityForwardResult: true,
-                // used for marking the ability start-up is triggered by continuation
-                abilityContinuation: true,
-                // specifies whether a component does not belong to ohos
-                notOhosComponent: true,
-                // specifies whether an ability is started
-                abilityFormEnabled: true,
-                // indicates the grant for possible persisting on the URI.
-                authPersistableUriPermission: true,
-                // indicates the grant for possible persisting on the URI.
-                authPrefixUriPermission: true,
-                // support distributed scheduling system start up multiple devices
-                abilitySliceMultiDevice: true,
-                // indicates that an ability using the service template is started regardless of whether the
-                // host application has been started.
-                startForegroundAbility: true,
-                // install the specified ability if it's not installed.
-                installOnDemand: true,
-                // return result to origin ability slice
-                abilitySliceForwardResult: true,
-                // install the specified ability with background mode if it's not installed.
-                installWithBackgroundMode: true
-            },
-            deviceId: "",
-            bundleName: "com.example.startability",
-            abilityName: "com.example.startability.MainAbility",
-            uri: ""
-        },
+featureAbility.startAbility({
+  want:
+  {
+    action: "",
+    entities: [""],
+    type: "",
+    options: {
+      // indicates the grant to perform read operations on the URI
+      authReadUriPermission: true,
+      // indicates the grant to perform write operations on the URI
+      authWriteUriPermission: true,
+      // support forward intent result to origin ability
+      abilityForwardResult: true,
+      // used for marking the ability start-up is triggered by continuation
+      abilityContinuation: true,
+      // specifies whether a component does not belong to ohos
+      notOhosComponent: true,
+      // specifies whether an ability is started
+      abilityFormEnabled: true,
+      // indicates the grant for possible persisting on the URI.
+      authPersistableUriPermission: true,
+      // indicates the grant for possible persisting on the URI.
+      authPrefixUriPermission: true,
+      // support distributed scheduling system start up multiple devices
+      abilitySliceMultiDevice: true,
+      // indicates that an ability using the service template is started regardless of whether the
+      // host application has been started.
+      startForegroundAbility: true,
+      // install the specified ability if it's not installed.
+      installOnDemand: true,
+      // return result to origin ability slice
+      abilitySliceForwardResult: true,
+      // install the specified ability with background mode if it's not installed.
+      installWithBackgroundMode: true
     },
-  );
-)
+    deviceId: "",
+    bundleName: "com.example.startability",
+    abilityName: "com.example.startability.MainAbility",
+    uri: ""
+  },
+},
+);
+```
+want参数也可以使用parameters参数，使用key-value的方式输入。
+* 示例
+```javascript
+import featureAbility from '@ohos.ability.featureAbility'
+featureAbility.startAbility({
+    want:
+    {
+        bundleName: "com.example.startability",
+        uri: "",
+        parameters: {
+            abilityName: "com.example.startability.MainAbility"
+        }
+    },
+},
+);
 ```
 ## 启动远程PageAbility
 
- 导入模块
+* 导入模块
 
 ```
 import featureAbility from '@ohos.ability.featureAbility'
 ```
 
 ```
-FeatureAbility.startAbility(parameter: StartAbilityParameter)
+featureAbility.startAbility(parameter: StartAbilityParameter)
 ```
 * 接口说明
 
@@ -114,14 +128,13 @@ FeatureAbility.startAbility(parameter: StartAbilityParameter)
 * 示例
 
 ```javascript
-        var promise = await ability.startAbility(
-            {
-                want:
-                {
-                    deviceId: this.deviceId,
-                    bundleName: "com.example.test",
-                    abilityName: "com.example.test.MainAbility",
-                },
-            }
-        );
+var promise = await featureAbility.startAbility({
+    want:
+    {
+        deviceId: this.deviceId,
+        bundleName: "com.example.test",
+        abilityName: "com.example.test.MainAbility",
+    },
+}
+);
 ```
\ No newline at end of file

zh-cn/application-dev/notification/assistant-guidelines.md

-# 调试助手使用指导
+# 调试助手使用指导
\ No newline at end of file
+
+​        公共事件与通知提供了供开发者查看公共事件信息及通知信息、发布公共事件等一些调试功能的工具。这些工具已经随系统集成，开发者进入shell环境，可以直接调用相关命令。
+
+### cem调试助手
+
+##### publish
+
+* 介绍
+
+  发布公共事件。
+
+* 用法
+
+  `cem publish [<options>]` 
+
+  参数如下表所示
+
+  | 参数         | 参数说明                                   |
+  | ------------ | ------------------------------------------ |
+  | -e/--event   | 必选参数，发布事件名称                     |
+  | -s/--sticky  | 可选参数，发布粘性事件，默认发布非粘性事件 |
+  | -o/--ordered | 可选参数，发布有序事件，默认发布无序事件   |
+  | -c/--code    | 可选参数，公共事件结果码                   |
+  | -d/--data    | 可选参数，公共事件携带数据                 |
+  | -h/--help    | 帮助信息                                   |
+
+* 示例
+
+  `cem publish --event "testevent"`
+
+  发布名称为testevent的公共事件
+
+   ![cem-publish-event](figures/cem-publish-event.png)
+
+  
+
+  `cem publish -e "testevent" -s -o -c 100 -d "this is data" `
+
+  发布名称为testevent的粘性有序公共事件，该事件的结果码为100，携带数据内容为“this is data”
+
+   ![cem-publish-all](figures/cem-publish-all.png)
+
+##### dump
+
+* 介绍
+
+  打印公共事件相关信息。
+
+* 用法
+
+  `cem dump [<options>]`
+
+  参数如下表所示
+
+  | 参数       | 参数说明                                     |
+  | ---------- | -------------------------------------------- |
+  | -a/--all   | 打印开机以来所有已发送的公共事件及其具体信息 |
+  | -e/--event | 查询特定名称事件的具体信息                   |
+  | -h/--help  | 帮助信息                                     |
+
+* 示例
+
+​        `cem dump -e "testevent"`
+
+​        打印公共事件名称为testevent的具体信息。
+
+​        ![cem-dump-e](figures/cem-dump-e.png)
+
+##### help
+
+* 介绍
+
+  打印帮助信息。
+
+* 用法
+
+  `cem help`
+
+* 示例
+
+    ![cem-help](figures/cem-help.png)
+
+
+
+### anm调试助手
+
+##### dump
+
+* 介绍
+
+  打印通知相关信息。
+
+* 用法
+
+  `anm dump [<options>]`
+
+  参数如下表所示
+
+  | 参数             | 参数说明                                 |
+  | ---------------- | ---------------------------------------- |
+  | -A/--active      | 打印所有活跃的通知信息                   |
+  | -R/--recent      | 打印最近的通知信息                       |
+  | -D/--distributed | 打印来自其他设备的分布式通知信息         |
+  | --setRecentCount | 可选参数，设置打印最近的通知消息缓存个数 |
+  | -h/--help        | 帮助信息                                 |
+
+* 示例
+
+  `anm dump -A`
+
+  打印活跃的通知信息
+
+   ![anm-dump-A](figures/anm-dump-A.png)
+
+  
+
+  `anm dump --setRecentCount  10`
+
+  设置打印最近通知消息缓存数量为10
+
+##### help
+
+* 介绍
+
+  打印帮助信息。
+
+* 用法
+
+  `anm help`
+
+* 示例
+
+ ![anm-help](figures/anm-help.png)
\ No newline at end of file

zh-cn/application-dev/notification/notification-brief.md

-# 公共事件与通知开发概述
+# 公共事件与通知开发概述
\ No newline at end of file
+
+​        公共事件与通知提供了应用程序向系统其他应用程序发布消息、接收来自系统或其他应用特定消息的能力，这些消息可以是新闻推送、广告通知或者预警信息。
+
+​        CES（Common Event Service, 即公共事件服务）为应用程序提供发布、订阅及退订公共事件的能力。公共事件根据事件发送方不同可分为系统公共事件和自定义公共事件。
+
+![ces](figures/ces.png)
+
+- 系统公共事件：系统将收集到的事件信息，根据系统策略发送给订阅该事件的用户程序。 公共事件包括：终端设备用户可感知的亮灭屏事件，以及系统关键服务发布的系统事件（例如：USB插拔，网络连接，系统升级）等。
+
+- 自定义公共事件：由应用自身定义的期望特定订阅者可以接收到的公共事件，这些公共事件往往与应用自身的业务逻辑相关。
+
+  ANS（Advanced Notification Service，即通知增强服务）为应用程序提供发布通知的能力。这些通知常见的使用场景如下：
+
+  - 显示接收到的短消息、即时通讯消息等；
+  
+  - 显示应用的推送消息，如广告、版本更新、新闻通知等；
+  
+  - 显示当前正在进行的事件，如播放音乐、导航信息、下载进度等。
+
+​        通知消息将显示在系统下拉菜单栏，用户可对通知消息进行删除操作，或点击通知触发进一步的操作。
+
+![ans](figures/ans.png)
+
+

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

@@ -25,8 +25,7 @@
     - [访问控制](js-apis-abilityAccessCtrl.md)
     - [通用密钥库系统](js-apis-huks.md)
 - 数据管理
-    - [轻量级存储<sup>9+</sup>](js-apis-data-preferences.md)
-    - [轻量级存储](js-apis-data-storage.md)
+    - [轻量级存储](js-apis-data-preferences.md)
     - [分布式数据管理](js-apis-distributed-data.md)
     - [关系型数据库](js-apis-data-rdb.md)
     - [结果集](js-apis-data-resultset.md)
@@ -77,15 +76,17 @@
     - [USB管理](js-apis-usb.md)
     - [位置服务](js-apis-geolocation.md)
 - 基本功能
+    - [应用上下文](js-apis-basic-features-app-context.md)
+    - [日志打印](js-apis-basic-features-logs.md)
     - [页面路由](js-apis-basic-features-routes.md)
     - [弹窗](js-apis-basic-features-pop-up.md)
+    - [应用配置](js-apis-basic-features-configuration.md)
     - [定时器](js-apis-basic-features-timer.md)
     - [锁屏管理](js-apis-screen-lock.md)
     - [设置系统时间](js-apis-system-time.md)
     - [壁纸](js-apis-wallpaper.md)
     - [剪贴板](js-apis-pasteboard.md)
     - [动画](js-apis-basic-features-animator.md)
-    - [媒体查询](js-apis-mediaquery.md)
     - [WebGL](js-apis-webgl.md)
     - [WebGL2](js-apis-webgl2.md)
     - [屏幕截图](js-apis-screenshot.md)

zh-cn/application-dev/reference/apis/js-apis-ability-context.md

@@ -10,10 +10,10 @@ Ability的上下文环境，继承自Context。
 ## 使用说明
 
 
-在使用AbilityContext的功能前，需要通过Ability子类实例获取。
-
+​在使用AbilityContext的功能前，需要通过Ability子类实例获取。
 
 
+  
 ```js
 import Ability from '@ohos.application.Ability'
 class MainAbility extends Ability {
@@ -42,10 +42,10 @@ startAbility(want: Want, callback: AsyncCallback<void>): void
 
 **参数：**
 
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| want | [Want](js-apis-featureAbility.md#want) | 是 | 启动Ability的want信息。 |
-| callback | AsyncCallback<void> | 是 | callback形式返回启动结果 |
+  | 参数名 | 类型 | 必填 | 说明 | 
+  | -------- | -------- | -------- | -------- |
+  | want | [Want](js-apis-featureAbility.md#Want类型说明) | 是 | 启动Ability的want信息。 | 
+  | callback | AsyncCallback<void> | 是 | callback形式返回启动结果 | 
 
 **示例：**
 
@@ -71,11 +71,11 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void&
 
 **参数：**
 
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| want | [Want](js-apis-featureAbility.md#want) | 是 | 启动Ability的want信息。 |
-| options | StartOptions | 是 | 启动Ability所携带的参数。 |
-| callback | AsyncCallback<void> | 是 | callback形式返回启动结果。 |
+  | 参数名 | 类型 | 必填 | 说明 | 
+  | -------- | -------- | -------- | -------- |
+  | want | [Want](js-apis-featureAbility.md#Want类型说明)  | 是 | 启动Ability的want信息。 | 
+  | options | StartOptions | 是 | 启动Ability所携带的参数。 |
+  | callback | AsyncCallback<void> | 是 | callback形式返回启动结果。 | 
 
 **示例：**
     
@@ -145,10 +145,10 @@ startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>):
 
 **参数：**
 
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| want |[Want](js-apis-featureAbility.md#want) | 是 | 启动Ability的want信息。 |
-| callback | AsyncCallback<[AbilityResult](js-apis-featureAbility.md#abilityresult)> | 是 | 执行结果回调函数。 |
+  | 参数名 | 类型 | 必填 | 说明 |
+  | -------- | -------- | -------- | -------- |
+  | want |[Want](js-apis-featureAbility.md#Want类型说明) | 是 | 启动Ability的want信息。 |
+  | callback | AsyncCallback<[AbilityResult](js-apis-featureAbility.md#abilityresult)> | 是 | 执行结果回调函数。 |
 
 
 **示例：**
@@ -173,11 +173,11 @@ startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback
 
 **参数：**
 
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| want |[Want](js-apis-featureAbility.md#want) | 是 | 启动Ability的want信息。 |
-| options | StartOptions | 是 | 启动Ability所携带的参数。 |
-| callback | AsyncCallback<[AbilityResult](js-apis-featureAbility.md#abilityresult)> | 是 | 执行结果回调函数。 |
+  | 参数名 | 类型 | 必填 | 说明 |
+  | -------- | -------- | -------- | -------- |
+  | want |[Want](js-apis-featureAbility.md#Want类型说明) | 是 | 启动Ability的want信息。 |
+  | options | StartOptions | 是 | 启动Ability所携带的参数。 |
+  | callback | AsyncCallback<[AbilityResult](js-apis-featureAbility.md#abilityresult)> | 是 | 执行结果回调函数。 |
 
 
 **示例：**
@@ -353,9 +353,9 @@ startAbilityByCall(want: Want): Promise<Caller>;
 
 **参数：**
 
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| want | [Want](js-apis-featureAbility.md#want) | 是 | 传入需要启动的ability的信息，包含ability名称、包名、设备ID，设备ID缺省或为空表示启动本地ability。 |
+  | 参数名 | 类型 | 必填 | 说明 | 
+  | -------- | -------- | -------- | -------- |
+  | want | [Want](js-apis-featureAbility.md#Want类型说明) | 是 | 传入需要启动的ability的信息，包含ability名称、包名、设备ID，设备ID缺省或为空表示启动本地ability。 | 
 
 **返回值：**
 

zh-cn/application-dev/reference/apis/js-apis-basic-features-logs.md

@@ -5,6 +5,10 @@
 
 无需导入。
 
+## 权限列表
+
+无
+
 
 ## console.debug
 

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

@@ -776,7 +776,7 @@ queryContacts(attrs: ContactAttributes, callback: AsyncCallback<Array<Cont
 
 ## contact.queryContacts
 
-queryContacts(holder: Holder, attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>)
+queryContacts(holder: Holder, attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>): void
 
 查询所有联系人，使用callback方式作为异步方法。
 

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

@@ -1432,7 +1432,7 @@ lstat(path:string, callback:AsyncCallback<Stat>): void
   ```js
   fileio.lstat(path, function (err, stat) {
       // do something
-  ));
+  });
   ```
 
 
@@ -1827,7 +1827,7 @@ chown(path: string, uid: number, gid: number): Promise<void>
 - 示例：
   ```js
   let stat = fileio.statSync(path);
-  fileio.chown(path, stat.uid, stat.gid)).then(function(){
+  fileio.chown(path, stat.uid, stat.gid).then(function(){
       console.info("chown successfully");
   }).catch(function(err){
       console.info("chown failed with error:"+ err);
@@ -2127,7 +2127,7 @@ fdopenStream(fd: number, mode: string): Promise<Stream>
 - 示例：
   ```js
   fileio.fdopenStream(fd, mode).then(function(stream){
-      console.info("openStream successfully"+);
+      console.info("openStream successfully");
   }).catch(function(err){
       console.info("openStream failed with error:"+ err);
   });

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

+# FormProvider
+
+> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
+> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+
+卡片提供方相关接口。
+
+## 导入模块
+
+```
+import formProvider from '@ohos.application.formProvider';
+```
+
+## 权限
+
+无
+
+## setFormNextRefreshTime
+
+setFormNextRefreshTime(formId: string, minute: number, callback: AsyncCallback<void>): void;
+
+设置指定卡片的下一次更新时间。
+
+**系统能力：**
+
+SystemCapability.Ability.Form
+
+**参数：**
+
+  | 参数名 | 类型    | 必填 | 说明                                   |
+  | ------ | ------ | ---- | ------------------------------------- |
+  | formId | string | 是   | 卡片标识                               |
+  | minute | number | 是   | 指定多久之后更新，单位分钟，大于等于5     |
+
+**示例：**
+
+  ```js
+  var formId = "12400633174999288";
+  formProvider.setFormNextRefreshTime(formId, 5, (error, data) => {
+      if (error) {
+          console.log('formProvider setFormNextRefreshTime, error:' + error.code);
+      }
+  });
+  ```
+
+## setFormNextRefreshTime
+
+setFormNextRefreshTime(formId: string, minute: number): Promise<void>;
+
+设置指定卡片的下一次更新时间，以promise方式返回。
+
+**系统能力：**
+
+SystemCapability.Ability.Form
+
+**参数：**
+
+  | 参数名 | 类型    | 必填 | 说明                                   |
+  | ------ | ------ | ---- | ------------------------------------- |
+  | formId | string | 是   | 卡片标识                               |
+  | minute | number | 是   | 指定多久之后更新，单位分钟，大于等于5     |
+
+**示例：**
+
+  ```js
+  var formId = "12400633174999288";
+  formProvider.setFormNextRefreshTime(formId, 5).catch((error) => {
+      console.log('formProvider setFormNextRefreshTime, error:' + JSON.stringify(error));
+  });
+  ```
+
+## updateForm
+
+updateForm(formId: string, formBindingData: formBindingData.FormBindingData, callback: AsyncCallback<void>): void;
+
+更新指定的卡片。
+
+**系统能力：**
+
+SystemCapability.Ability.Form
+
+**参数：**
+
+  | 参数名 | 类型                                                                    | 必填 | 说明             |
+  | ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
+  | formId | string                                                                 | 是   | 请求更新的卡片标识 |
+  | formBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | 是   | 用于更新的数据    |
+
+**示例：**
+
+  ```js
+  import formBindingData from '@ohos.application.formBindingData';
+  var formId = "12400633174999288";
+  let obj = formBindingData.createFormBindingData({temperature:"22c", time:"22:00"});
+  formProvider.updateForm(formId, obj, (error, data) => {
+      if (error) {
+          console.log('formProvider updateForm, error:' + error.code);
+      }
+  });
+  ```
+
+## updateForm
+
+updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Promise<void>;
+
+更新指定的卡片，以promise方式返回。
+
+**系统能力：**
+
+SystemCapability.Ability.Form
+
+**参数：**
+
+  | 参数名 | 类型                                                                    | 必填 | 说明             |
+  | ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
+  | formId | string                                                                 | 是   | 请求更新的卡片标识 |
+  | formBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | 是   | 用于更新的数据    |
+
+**示例：**
+
+  ```js
+  import formBindingData from '@ohos.application.formBindingData';
+  var formId = "12400633174999288";
+  let obj = formBindingData.createFormBindingData({temperature:"22c", time:"22:00"});
+  formProvider.updateForm(formId, obj).catch((error) => {
+      console.log('formProvider updateForm, error:' + JSON.stringify(error));
+  });
+  ```
\ No newline at end of file

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

@@ -27,11 +27,11 @@ on(type: 'locationChange', request: LocationRequest, callback: Callback<Locat
 开启位置变化订阅，并发起定位请求。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 设置事件类型。type为“locationChange”，表示位置变化。 | 
-  | request | LocationRequest | 是 | 设置位置请求参数。 | 
-  | callback | Callback<[Location](#location)> | 是 | 接收位置变化状态变化监听。 | 
+  | type | string | 是 | 设置事件类型。type为“locationChange”，表示位置变化。 |
+  | request | LocationRequest | 是 | 设置位置请求参数。 |
+  | callback | Callback<[Location](#location)> | 是 | 接收位置变化状态变化监听。 |
 
 - 示例：
   
@@ -51,10 +51,10 @@ off(type: 'locationChange', callback?: Callback<Location>) : void
 关闭位置变化订阅，并删除对应的定位请求。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 设置事件类型。type为“locationChange”，表示位置变化。 | 
-  | callback | Callback<[Location](#location)> | 否 | 接收位置变化状态变化监听。 | 
+  | type | string | 是 | 设置事件类型。type为“locationChange”，表示位置变化。 |
+  | callback | Callback<[Location](#location)> | 否 | 接收位置变化状态变化监听。 |
 
 - 示例：
   
@@ -75,10 +75,10 @@ on(type: 'locationServiceState', callback: Callback<boolean>) : void
 订阅位置服务状态变化。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 设置事件类型。type为“locationServiceState”，表示位置服务状态。 | 
-  | callback | Callback<boolean> | 是 | 接收位置服务状态变化监听。 | 
+  | type | string | 是 | 设置事件类型。type为“locationServiceState”，表示位置服务状态。 |
+  | callback | Callback<boolean> | 是 | 接收位置服务状态变化监听。 |
 
 - 示例：
   
@@ -97,10 +97,10 @@ off(type: 'locationServiceState', callback?: Callback<boolean>) : void;
 取消订阅位置服务状态变化。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 设置事件类型。type为“locationServiceState”，表示位置服务状态。 | 
-  | callback | Callback<boolean> | 否 | 接收位置服务状态变化监听。 | 
+  | type | string | 是 | 设置事件类型。type为“locationServiceState”，表示位置服务状态。 |
+  | callback | Callback<boolean> | 否 | 接收位置服务状态变化监听。 |
 
 - 示例：
   
@@ -120,11 +120,11 @@ on(type: 'cachedGnssLocationsReporting', request: CachedGnssLocationsRequest, ca
 订阅缓存GNSS定位结果上报事件。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 设置事件类型。type为“cachedGnssLocationsReporting”，表示GNSS缓存定位结果上报。 | 
-  | request | CachedGnssLocationsRequest | 是 | GNSS缓存功能配置参数 | 
-  | callback | Callback<boolean> | 是 | 接收GNSS缓存位置上报。 | 
+  | type | string | 是 | 设置事件类型。type为“cachedGnssLocationsReporting”，表示GNSS缓存定位结果上报。 |
+  | request | CachedGnssLocationsRequest | 是 | GNSS缓存功能配置参数 |
+  | callback | Callback<boolean> | 是 | 接收GNSS缓存位置上报。 |
 
 - 示例：
   
@@ -144,10 +144,10 @@ off(type: 'cachedGnssLocationsReporting', callback?: Callback<Array<Locati
 取消订阅缓存GNSS定位结果上报事件。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 设置事件类型。type为“cachedGnssLocationsReporting”，表示GNSS缓存定位结果上报。 | 
-  | callback | Callback<boolean> | 否 | 接收GNSS缓存位置上报。 | 
+  | type | string | 是 | 设置事件类型。type为“cachedGnssLocationsReporting”，表示GNSS缓存定位结果上报。 |
+  | callback | Callback<boolean> | 否 | 接收GNSS缓存位置上报。 |
 
 - 示例：
   
@@ -168,10 +168,10 @@ on(type: 'gnssStatusChange', callback: Callback<SatelliteStatusInfo>) : vo
 订阅GNSS卫星状态信息上报事件。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 设置事件类型。type为“gnssStatusChange”，表示订阅GNSS卫星状态信息上报。 | 
-  | callback | Callback<SatelliteStatusInfo> | 是 | 接收GNSS卫星状态信息上报。 | 
+  | type | string | 是 | 设置事件类型。type为“gnssStatusChange”，表示订阅GNSS卫星状态信息上报。 |
+  | callback | Callback<SatelliteStatusInfo> | 是 | 接收GNSS卫星状态信息上报。 |
 
 - 示例：
   
@@ -190,10 +190,10 @@ off(type: 'gnssStatusChange', callback?: Callback<SatelliteStatusInfo>) :
 取消订阅GNSS卫星状态信息上报事件。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 设置事件类型。type为“gnssStatusChange”，表示订阅GNSS卫星状态信息上报。 | 
-  | callback | Callback<SatelliteStatusInfo> | 否 | 接收GNSS卫星状态信息上报。 | 
+  | type | string | 是 | 设置事件类型。type为“gnssStatusChange”，表示订阅GNSS卫星状态信息上报。 |
+  | callback | Callback<SatelliteStatusInfo> | 否 | 接收GNSS卫星状态信息上报。 |
 
 - 示例：
   
@@ -213,10 +213,10 @@ on(type: 'nmeaMessageChange', callback: Callback<string>) : void;
 订阅GNSS NMEA信息上报事件。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 设置事件类型。type为“nmeaMessageChange”，表示订阅GNSS NMEA信息上报。 | 
-  | callback | Callback<string> | 是 | 接收GNSS NMEA信息上报。 | 
+  | type | string | 是 | 设置事件类型。type为“nmeaMessageChange”，表示订阅GNSS NMEA信息上报。 |
+  | callback | Callback<string> | 是 | 接收GNSS NMEA信息上报。 |
 
 - 示例：
   
@@ -235,10 +235,10 @@ off(type: 'nmeaMessageChange', callback?: Callback<string>) : void;
 取消订阅GNSS NMEA信息上报事件。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 设置事件类型。type为“nmeaMessageChange”，表示订阅GNSS NMEA信息上报。 | 
-  | callback | Callback<string> | 否 | 接收GNSS NMEA信息上报。 | 
+  | type | string | 是 | 设置事件类型。type为“nmeaMessageChange”，表示订阅GNSS NMEA信息上报。 |
+  | callback | Callback<string> | 否 | 接收GNSS NMEA信息上报。 |
 
 - 示例：
   
@@ -258,11 +258,11 @@ on(type: 'fenceStatusChange', request: GeofenceRequest, want: WantAgent) : void;
 添加一个围栏，并订阅地理围栏事件。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 设置事件类型。type为“fenceStatusChange”，表示订阅围栏事件上报。 | 
-  | request | GeofenceRequest | 是 | 围栏的配置参数。 | 
-  | want | WantAgent | 是 | 用于接收地理围栏事件上报（进出围栏）。 | 
+  | type | string | 是 | 设置事件类型。type为“fenceStatusChange”，表示订阅围栏事件上报。 |
+  | request | GeofenceRequest | 是 | 围栏的配置参数。 |
+  | want | WantAgent | 是 | 用于接收地理围栏事件上报（进出围栏）。 |
 
 - 示例：
   
@@ -320,11 +320,11 @@ off(type: 'fenceStatusChange', request: GeofenceRequest, want: WantAgent) : void
 删除一个围栏，并取消订阅该围栏事件。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 设置事件类型。type为“fenceStatusChange”，表示订阅围栏事件上报。 | 
-  | request | GeofenceRequest | 是 | 围栏的配置参数。 | 
-  | want | WantAgent | 是 | 用于接收地理围栏事件上报（进出围栏）。 | 
+  | type | string | 是 | 设置事件类型。type为“fenceStatusChange”，表示订阅围栏事件上报。 |
+  | request | GeofenceRequest | 是 | 围栏的配置参数。 |
+  | want | WantAgent | 是 | 用于接收地理围栏事件上报（进出围栏）。 |
 
 - 示例：
   
@@ -385,10 +385,10 @@ getCurrentLocation(request: CurrentLocationRequest, callback: AsyncCallback<L
 
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | request | [CurrentLocationRequest](#currentlocationrequest) | 否 | 设置位置请求参数。 | 
-  | callback | AsyncCallback<[Location](#location)> | 是 | 用来接收位置信息的回调。 | 
+  | request | [CurrentLocationRequest](#currentlocationrequest) | 否 | 设置位置请求参数。 |
+  | callback | AsyncCallback<[Location](#location)> | 是 | 用来接收位置信息的回调。 |
 
 - 示例：
   
@@ -411,14 +411,14 @@ getCurrentLocation(request?: CurrentLocationRequest) : Promise<Location>
 
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | request | [CurrentLocationRequest](#currentlocationrequest) | 否 | 设置位置请求参数。 | 
+  | request | [CurrentLocationRequest](#currentlocationrequest) | 否 | 设置位置请求参数。 |
 
 - 返回值：
-    | 参数名 | 说明 | 
+    | 参数名 | 说明 |
   | -------- | -------- |
-  | Promise<[Location](#location)> | 返回位置信息。 | 
+  | Promise<[Location](#location)> | 返回位置信息。 |
 
 - 示例：
   
@@ -437,9 +437,9 @@ getLastLocation(callback: AsyncCallback<Location>) : void
 获取上一次位置，使用callback回调异步返回结果。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | callback | AsyncCallback<[Location](#location)> | 是 | 用来接收上次位置的回调。 | 
+  | callback | AsyncCallback<[Location](#location)> | 是 | 用来接收上次位置的回调。 |
 
 - 示例：
   
@@ -457,9 +457,9 @@ getLastLocation() : Promise<Location>
 获取上一次位置，使用Promise方式异步返回结果。
 
 - 返回值：
-    | 参数名 | 说明 | 
+    | 参数名 | 说明 |
   | -------- | -------- |
-  | Promise<[Location](#location)> | 返回上次位置信息。 | 
+  | Promise<[Location](#location)> | 返回上次位置信息。 |
 
 - 示例：
   
@@ -479,9 +479,9 @@ isLocationEnabled(callback: AsyncCallback<boolean>) : void
 
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | callback | AsyncCallback<boolean> | 是 | 用来接收位置服务状态的回调。 | 
+  | callback | AsyncCallback<boolean> | 是 | 用来接收位置服务状态的回调。 |
 
 - 示例：
   
@@ -499,9 +499,9 @@ isLocationEnabled() : Promise<boolean>
 判断位置服务是否已经开启，使用Promise方式异步返回结果。
 
 - 返回值：
-    | 参数名 | 说明 | 
+    | 参数名 | 说明 |
   | -------- | -------- |
-  | Promise<boolean> | 返回位置服务是否可用的状态。 | 
+  | Promise<boolean> | 返回位置服务是否可用的状态。 |
 
 - 示例：
   
@@ -521,9 +521,9 @@ requestEnableLocation(callback: AsyncCallback<boolean>) : void
 
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | callback | AsyncCallback<boolean> | 是 | 用来接收位置服务状态的回调。 | 
+  | callback | AsyncCallback<boolean> | 是 | 用来接收位置服务状态的回调。 |
 
 - 示例：
   
@@ -541,9 +541,9 @@ requestEnableLocation() : Promise<boolean>
 请求打开位置服务，使用Promise方式异步返回结果。
 
 - 返回值：
-    | 参数名 | 说明 | 
+    | 参数名 | 说明 |
   | -------- | -------- |
-  | Promise<boolean> | 返回位置服务是否可用。 | 
+  | Promise<boolean> | 返回位置服务是否可用。 |
 
 - 示例：
   
@@ -561,9 +561,9 @@ isGeoServiceAvailable(callback: AsyncCallback<boolean>) : void
 判断（逆）地理编码服务状态，使用callback回调异步返回结果。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | callback | AsyncCallback<boolean> | 是 | 用来接收地理编码服务状态的回调。 | 
+  | callback | AsyncCallback<boolean> | 是 | 用来接收地理编码服务状态的回调。 |
 
 - 示例：
   
@@ -581,9 +581,9 @@ isGeoServiceAvailable() : Promise<boolean>
 判断（逆）地理编码服务状态，使用Promise方式异步返回结果。
 
 - 返回值：
-    | 参数名 | 说明 | 
+    | 参数名 | 说明 |
   | -------- | -------- |
-  | Promise<boolean> | 返回地理编码服务是否可用的状态。 | 
+  | Promise<boolean> | 返回地理编码服务是否可用的状态。 |
 
 - 示例：
   
@@ -602,10 +602,10 @@ getAddressesFromLocation(request: ReverseGeoCodeRequest, callback: AsyncCallback
 调用逆地理编码服务，将坐标转换为地理描述，使用callback回调异步返回结果。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | request | [ReverseGeoCodeRequest](#reversegeocoderequest) | 是 | 设置逆地理编码请求的相关参数。 | 
-  | callback | AsyncCallback<Array<[GeoAddress](#geoaddress)>> | 是 | 设置接收逆地理编码请求的回调参数。 | 
+  | request | [ReverseGeoCodeRequest](#reversegeocoderequest) | 是 | 设置逆地理编码请求的相关参数。 |
+  | callback | AsyncCallback<Array<[GeoAddress](#geoaddress)>> | 是 | 设置接收逆地理编码请求的回调参数。 |
 
 - 示例：
   
@@ -624,14 +624,14 @@ getAddressesFromLocation(request: ReverseGeoCodeRequest) : Promise<Array<G
 调用逆地理编码服务，将坐标转换为地理描述，使用Promise方式异步返回结果。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | request | [ReverseGeoCodeRequest](#reversegeocoderequest) | 是 | 设置逆地理编码请求的相关参数。 | 
+  | request | [ReverseGeoCodeRequest](#reversegeocoderequest) | 是 | 设置逆地理编码请求的相关参数。 |
 
 - 返回值：
-    | 参数名 | 说明 | 
+    | 参数名 | 说明 |
   | -------- | -------- |
-  | Promise<Array<[GeoAddress](#geoaddress)>> | 返回地理描述信息。 | 
+  | Promise<Array<[GeoAddress](#geoaddress)>> | 返回地理描述信息。 |
 
 - 示例：
   
@@ -650,10 +650,10 @@ getAddressesFromLocationName(request: GeoCodeRequest, callback: AsyncCallback&lt
 调用地理编码服务，将地理描述转换为具体坐标，使用callback回调异步返回结果。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | request | [GeoCodeRequest](#geocoderequest) | 是 | 设置地理编码请求的相关参数。 | 
-  | callback | AsyncCallback<Array<[GeoAddress](#geoaddress)>> | 是 | 设置接收地理编码请求的回调参数。 | 
+  | request | [GeoCodeRequest](#geocoderequest) | 是 | 设置地理编码请求的相关参数。 |
+  | callback | AsyncCallback<Array<[GeoAddress](#geoaddress)>> | 是 | 设置接收地理编码请求的回调参数。 |
 
 - 示例：
   
@@ -672,14 +672,14 @@ getAddressesFromLocationName(request: GeoCodeRequest) : Promise<Array<GeoA
 调用地理编码服务，将地理描述转换为具体坐标，使用Promise方式异步返回结果。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | request | [GeoCodeRequest](#geocoderequest) | 是 | 设置地理编码请求的相关参数。 | 
+  | request | [GeoCodeRequest](#geocoderequest) | 是 | 设置地理编码请求的相关参数。 |
 
 - 返回值：
-    | 参数名 | 说明 | 
+    | 参数名 | 说明 |
   | -------- | -------- |
-  | Promise<Array<[GeoAddress](#geoaddress)>> | 设置接收地理编码请求的回调参数。 | 
+  | Promise<Array<[GeoAddress](#geoaddress)>> | 设置接收地理编码请求的回调参数。 |
 
 - 示例：
   
@@ -699,9 +699,9 @@ getCachedGnssLocationsSize(callback: AsyncCallback<number>) : void;
 获取GNSS芯片缓存位置的个数。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | callback | AsyncCallback<number> | 是 | 用来接收GNSS芯片缓存位置个数的回调。 | 
+  | callback | AsyncCallback<number> | 是 | 用来接收GNSS芯片缓存位置个数的回调。 |
 
 - 示例：
   
@@ -719,9 +719,9 @@ getCachedGnssLocationsSize() : Promise<number>;
 获取GNSS芯片缓存位置的个数。
 
 - 返回值：
-    | 参数名 | 说明 | 
+    | 参数名 | 说明 |
   | -------- | -------- |
-  | Promise<number> | 返回GNSS缓存位置的个数。 | 
+  | Promise<number> | 返回GNSS缓存位置的个数。 |
 
 - 示例：
   
@@ -739,9 +739,9 @@ flushCachedGnssLocations(callback: AsyncCallback<boolean>) : void;
 读取并清空GNSS芯片所有缓存位置。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | callback | AsyncCallback<boolean> | 是 | 用来接收清空GNSS芯片缓存位置操作的结果。 | 
+  | callback | AsyncCallback<boolean> | 是 | 用来接收清空GNSS芯片缓存位置操作的结果。 |
 
 - 示例：
   
@@ -759,9 +759,9 @@ flushCachedGnssLocations() : Promise<boolean>;
 读取并清空GNSS芯片所有缓存位置。
 
 - 返回值：
-    | 参数名 | 说明 | 
+    | 参数名 | 说明 |
   | -------- | -------- |
-  | Promise<boolean> | 清空所有GNSS缓存位置是否成功。 | 
+  | Promise<boolean> | 清空所有GNSS缓存位置是否成功。 |
 
 - 示例：
   
@@ -779,10 +779,10 @@ sendCommand(command: LocationCommand, callback: AsyncCallback<boolean>) :
 给位置服务子系统的各个部件发送扩展命令。只有系统应用才能调用。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | command | LocationCommand | 是 | 指定目标场景，和将要发送的命令（字符串）。 | 
-  | callback | AsyncCallback<boolean> | 是 | 用来接收命令发送的结果。 | 
+  | command | LocationCommand | 是 | 指定目标场景，和将要发送的命令（字符串）。 |
+  | callback | AsyncCallback<boolean> | 是 | 用来接收命令发送的结果。 |
 
 - 示例：
   
@@ -801,14 +801,14 @@ sendCommand(command: LocationCommand) : Promise<boolean>;
 给位置服务子系统的各个部件发送扩展命令。只有系统应用才能调用。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | command | LocationCommand | 是 | 指定目标场景，和将要发送的命令（字符串）。 | 
+  | command | LocationCommand | 是 | 指定目标场景，和将要发送的命令（字符串）。 |
 
 - 返回值：
-    | 参数名 | 说明 | 
+    | 参数名 | 说明 |
   | -------- | -------- |
-  | Promise<boolean> | 表示命令发送成功或失败。 | 
+  | Promise<boolean> | 表示命令发送成功或失败。 |
 
 - 示例：
   
@@ -827,10 +827,10 @@ isLocationPrivacyConfirmed(type : LocationPrivacyType, callback: AsyncCallback&l
 查询用户是否同意定位服务隐私申明，是否同意启用定位服务。只有系统应用才能调用。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | LocationPrivacyType | 是 | 指定隐私申明场景，例如开机向导中的隐私申明、开启网络定位功能时弹出的隐私申明等。 | 
-  | callback | AsyncCallback<boolean> | 是 | 表示用户是否同意定位服务隐私申明。 | 
+  | type | LocationPrivacyType | 是 | 指定隐私申明场景，例如开机向导中的隐私申明、开启网络定位功能时弹出的隐私申明等。 |
+  | callback | AsyncCallback<boolean> | 是 | 表示用户是否同意定位服务隐私申明。 |
 
 - 示例：
   
@@ -848,14 +848,14 @@ isLocationPrivacyConfirmed(type : LocationPrivacyType,) : Promise<boolean>
 查询用户是否同意定位服务隐私申明，是否同意启用定位服务。只有系统应用才能调用。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | LocationPrivacyType | 是 | 指定隐私申明场景，例如开机向导中的隐私申明、开启网络定位功能时弹出的隐私申明等。 | 
+  | type | LocationPrivacyType | 是 | 指定隐私申明场景，例如开机向导中的隐私申明、开启网络定位功能时弹出的隐私申明等。 |
 
 - 返回值：
-    | 参数名 | 说明 | 
+    | 参数名 | 说明 |
   | -------- | -------- |
-  | Promise<boolean> | 表示用户是否同意定位服务隐私申明。 | 
+  | Promise<boolean> | 表示用户是否同意定位服务隐私申明。 |
 
 - 示例：
   
@@ -873,11 +873,11 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed: boolean
 设置用户勾选定位服务隐私申明的状态，记录用户是否同意启用定位服务。只有系统应用才能调用。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | LocationPrivacyType | 是 | 指定隐私申明场景，例如开机向导中的隐私申明、开启网络定位功能时弹出的隐私申明等。 | 
-  | isConfirmed | boolean | 是 | 表示用户是否同意定位服务隐私申明。 | 
-  | callback | AsyncCallback<boolean> | 是 | 表示操作是否成功。 | 
+  | type | LocationPrivacyType | 是 | 指定隐私申明场景，例如开机向导中的隐私申明、开启网络定位功能时弹出的隐私申明等。 |
+  | isConfirmed | boolean | 是 | 表示用户是否同意定位服务隐私申明。 |
+  | callback | AsyncCallback<boolean> | 是 | 表示操作是否成功。 |
 
 - 示例：
   
@@ -895,15 +895,15 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolea
 设置用户勾选定位服务隐私申明的状态，记录用户是否同意启用定位服务。只有系统应用才能调用。
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | LocationPrivacyType | 是 | 指定隐私申明场景，例如开机向导中的隐私申明、开启网络定位功能时弹出的隐私申明等。 | 
-  | isConfirmed | boolean | 是 | 表示用户是否同意定位服务隐私申明。 | 
+  | type | LocationPrivacyType | 是 | 指定隐私申明场景，例如开机向导中的隐私申明、开启网络定位功能时弹出的隐私申明等。 |
+  | isConfirmed | boolean | 是 | 表示用户是否同意定位服务隐私申明。 |
 
 - 返回值：
-    | 参数名 | 说明 | 
+    | 参数名 | 说明 |
   | -------- | -------- |
-  | Promise<boolean> | 表示操作是否成功。 | 
+  | Promise<boolean> | 表示操作是否成功。 |
 
 - 示例：
   
@@ -919,201 +919,201 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolea
 
 位置请求中位置信息优先级设置。
 
-  | 名称 | 默认值 | 说明 | 
+| 名称 | 默认值 | 说明 |
 | -------- | -------- | -------- |
-| UNSET | 0x200 | 表示未设置优先级。 | 
-| ACCURACY | 0x201 | 表示精度优先。 | 
-| LOW_POWER | 0x202 | 表示低功耗优先。 | 
-| FIRST_FIX | 0x203 | 表示快速获取位置优先，如果应用希望快速拿到1个位置，可以将优先级设置为该字段。 | 
+| UNSET | 0x200 | 表示未设置优先级。 |
+| ACCURACY | 0x201 | 表示精度优先。 |
+| LOW_POWER | 0x202 | 表示低功耗优先。 |
+| FIRST_FIX | 0x203 | 表示快速获取位置优先，如果应用希望快速拿到1个位置，可以将优先级设置为该字段。 |
 
 
 ## LocationRequestScenario
 
   位置请求中定位场景设置。
-  | 名称 | 默认值 | 说明 | 
+| 名称 | 默认值 | 说明 |
 | -------- | -------- | -------- |
-| UNSET | 0x300 | 表示未设置场景信息。 | 
-| NAVIGATION | 0x301 | 表示导航场景。 | 
-| TRAJECTORY_TRACKING | 0x302 | 表示运动轨迹记录场景。 | 
-| CAR_HAILING | 0x303 | 表示打车场景。 | 
-| DAILY_LIFE_SERVICE | 0x304 | 表示日常服务使用场景。 | 
-| NO_POWER | 0x305 | 表示无功耗功场景，这种场景下不会主动触发定位，会在其他应用定位时，才给当前应用返回位置。 | 
+| UNSET | 0x300 | 表示未设置场景信息。 |
+| NAVIGATION | 0x301 | 表示导航场景。 |
+| TRAJECTORY_TRACKING | 0x302 | 表示运动轨迹记录场景。 |
+| CAR_HAILING | 0x303 | 表示打车场景。 |
+| DAILY_LIFE_SERVICE | 0x304 | 表示日常服务使用场景。 |
+| NO_POWER | 0x305 | 表示无功耗功场景，这种场景下不会主动触发定位，会在其他应用定位时，才给当前应用返回位置。 |
 
 
 ## GeoLocationErrorCode
 
 位置服务中的错误码信息。
 
-  | 名称 | 默认值 | 说明 | 
+| 名称 | 默认值 | 说明 |
 | -------- | -------- | -------- |
-| INPUT_PARAMS_ERROR | 101 | 表示输入参数错误。 | 
-| REVERSE_GEOCODE_ERROR | 102 | 表示逆地理编码接口调用失败。 | 
-| GEOCODE_ERROR | 103 | 表示地理编码接口调用失败。 | 
-| LOCATOR_ERROR | 104 | 表示定位失败。 | 
-| LOCATION_SWITCH_ERROR | 105 | 表示定位开关。 | 
-| LAST_KNOWN_LOCATION_ERROR | 106 | 表示获取上次位置失败。 | 
-| LOCATION_REQUEST_TIMEOUT_ERROR | 107 | 表示单次定位，没有在指定时间内返回位置。 | 
+| INPUT_PARAMS_ERROR | 101 | 表示输入参数错误。 |
+| REVERSE_GEOCODE_ERROR | 102 | 表示逆地理编码接口调用失败。 |
+| GEOCODE_ERROR | 103 | 表示地理编码接口调用失败。 |
+| LOCATOR_ERROR | 104 | 表示定位失败。 |
+| LOCATION_SWITCH_ERROR | 105 | 表示定位开关。 |
+| LAST_KNOWN_LOCATION_ERROR | 106 | 表示获取上次位置失败。 |
+| LOCATION_REQUEST_TIMEOUT_ERROR | 107 | 表示单次定位，没有在指定时间内返回位置。 |
 
 
 ## ReverseGeoCodeRequest
 
 逆地理编码请求接口。
 
-  | 名称 | 参数类型 | 必填 | 说明 | 
+| 名称 | 参数类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
-| locale | string | 否 | 指定位置描述信息的语言，“zh”代表中文，“en”代表英文。 | 
-| latitude | number | 是 | 表示纬度信息，正值表示北纬，负值表示南纬。 | 
-| longitude | number | 是 | 表示经度信息，正值表示东经，负值表示西经。 | 
-| maxItems | number | 否 | 指定返回位置信息的最大个数。 | 
+| locale | string | 否 | 指定位置描述信息的语言，“zh”代表中文，“en”代表英文。 |
+| latitude | number | 是 | 表示纬度信息，正值表示北纬，负值表示南纬。 |
+| longitude | number | 是 | 表示经度信息，正值表示东经，负值表示西经。 |
+| maxItems | number | 否 | 指定返回位置信息的最大个数。 |
 
 
 ## GeoCodeRequest
 
 地理编码请求接口。
 
-  | 名称 | 参数类型 | 必填 | 说明 | 
+| 名称 | 参数类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
-| locale | string | 否 | 表示位置描述信息的语言，“zh”代表中文，“en”代表英文。 | 
-| description | number | 是 | 表示位置信息描述，如“上海市浦东新区xx路xx号”。 | 
-| maxItems | number | 否 | 表示返回位置信息的最大个数。 | 
-| minLatitude | number | 否 | 表示最小纬度信息，与下面三个参数一起，表示一个经纬度范围。 | 
-| minLongitude | number | 否 | 表示最小经度信息。 | 
-| maxLatitude | number | 否 | 表示最大纬度信息。 | 
-| maxLongitude | number | 否 | 表示最大经度信息。 | 
+| locale | string | 否 | 表示位置描述信息的语言，“zh”代表中文，“en”代表英文。 |
+| description | number | 是 | 表示位置信息描述，如“上海市浦东新区xx路xx号”。 |
+| maxItems | number | 否 | 表示返回位置信息的最大个数。 |
+| minLatitude | number | 否 | 表示最小纬度信息，与下面三个参数一起，表示一个经纬度范围。 |
+| minLongitude | number | 否 | 表示最小经度信息。 |
+| maxLatitude | number | 否 | 表示最大纬度信息。 |
+| maxLongitude | number | 否 | 表示最大经度信息。 |
 
 
 ## GeoAddress
 
 地理编码类型。
 
-  | 名称 | 参数类型 | 必填 | 说明 | 
+| 名称 | 参数类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
-| latitude | number | 否 | 表示纬度信息，正值表示北纬，负值表示南纬。 | 
-| longitude | number | 否 | 表示经度信息，正值表示东经，负值表是西经。 | 
-| locale | string | 否 | 表示位置描述信息的语言，“zh”代表中文，“en”代表英文。 | 
-| placeName | string | 否 | 表示地区信息。 | 
-| countryCode | string | 否 | 表示国家码信息。 | 
-| countryName | string | 否 | 表示国家信息。 | 
-| administrativeArea | string | 否 | 表示省份区域信息。 | 
-| subAdministrativeArea | string | 否 | 表示表示子区域信息。 | 
-| locality | string | 否 | 表示城市信息。 | 
-| subLocality | string | 否 | 表示子城市信息。 | 
-| roadName | string | 否 | 表示路名信息。 | 
-| subRoadName | string | 否 | 表示子路名信息。 | 
-| premises | string | 否 | 表示门牌号信息。 | 
-| postalCode | string | 否 | 表示邮政编码信息。 | 
-| phoneNumber | string | 否 | 表示联系方式信息。 | 
-| addressUrl | string | 否 | 表示位置信息附件的网址信息。 | 
-| descriptions | Array<string> | 否 | 表示附加的描述信息。 | 
-| descriptionsSize | number | 否 | 表示附加的描述信息数量。 | 
+| latitude | number | 否 | 表示纬度信息，正值表示北纬，负值表示南纬。 |
+| longitude | number | 否 | 表示经度信息，正值表示东经，负值表是西经。 |
+| locale | string | 否 | 表示位置描述信息的语言，“zh”代表中文，“en”代表英文。 |
+| placeName | string | 否 | 表示地区信息。 |
+| countryCode | string | 否 | 表示国家码信息。 |
+| countryName | string | 否 | 表示国家信息。 |
+| administrativeArea | string | 否 | 表示省份区域信息。 |
+| subAdministrativeArea | string | 否 | 表示表示子区域信息。 |
+| locality | string | 否 | 表示城市信息。 |
+| subLocality | string | 否 | 表示子城市信息。 |
+| roadName | string | 否 | 表示路名信息。 |
+| subRoadName | string | 否 | 表示子路名信息。 |
+| premises | string | 否 | 表示门牌号信息。 |
+| postalCode | string | 否 | 表示邮政编码信息。 |
+| phoneNumber | string | 否 | 表示联系方式信息。 |
+| addressUrl | string | 否 | 表示位置信息附件的网址信息。 |
+| descriptions | Array<string> | 否 | 表示附加的描述信息。 |
+| descriptionsSize | number | 否 | 表示附加的描述信息数量。 |
 
 
 ## LocationRequest
 
 位置信息请求类型。
 
-  | 名称 | 参数类型 | 必填 | 说明 | 
+| 名称 | 参数类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
-| priority | [LocationRequestPriority](#locationrequestpriority) | 否 | 表示优先级信息。 | 
-| scenario | [LocationRequestScenario](#locationrequestscenario) | 是 | 表示场景信息。 | 
-| timeInterval | number | 否 | 表示上报位置信息的时间间隔。 | 
-| distanceInterval | number | 否 | 表示上报位置信息的距离间隔。 | 
-| maxAccuracy | number | 否 | 表示精度信息。 | 
+| priority | [LocationRequestPriority](#locationrequestpriority) | 否 | 表示优先级信息。 |
+| scenario | [LocationRequestScenario](#locationrequestscenario) | 是 | 表示场景信息。 |
+| timeInterval | number | 否 | 表示上报位置信息的时间间隔。 |
+| distanceInterval | number | 否 | 表示上报位置信息的距离间隔。 |
+| maxAccuracy | number | 否 | 表示精度信息。 |
 
 
 ## CurrentLocationRequest
 
 当前位置信息请求类型。
 
-  | 名称 | 参数类型 | 必填 | 说明 | 
+| 名称 | 参数类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
-| priority | [LocationRequestPriority](#locationrequestpriority) | 否 | 表示优先级信息。 | 
-| scenario | [LocationRequestScenario](#locationrequestscenario) | 否 | 表示场景信息。 | 
-| maxAccuracy | number | 否 | 表示精度信息，单位是米。 | 
-| timeoutMs | number | 否 | 表示超时时间，单位是毫秒，最小为1000毫秒。 | 
+| priority | [LocationRequestPriority](#locationrequestpriority) | 否 | 表示优先级信息。 |
+| scenario | [LocationRequestScenario](#locationrequestscenario) | 否 | 表示场景信息。 |
+| maxAccuracy | number | 否 | 表示精度信息，单位是米。 |
+| timeoutMs | number | 否 | 表示超时时间，单位是毫秒，最小为1000毫秒。 |
 
 
 ## SatelliteStatusInfo
 
 卫星状态信息。
 
-  | 名称 | 参数类型 | 必填 | 说明 | 
+| 名称 | 参数类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
-| satellitesNumber | number | 是 | 表示卫星个数。 | 
-| satelliteIds | Array<number> | 是 | 表示每个卫星的ID，数组类型。 | 
-| carrierToNoiseDensitys | Array<number> | 是 | 表示载波噪声功率谱密度比，即cn0。 | 
-| altitudes | Array<number> | 是 | 表示高程信息。 | 
-| azimuths | Array<number> | 是 | 表示方位角。 | 
-| carrierFrequencies | Array<number> | 是 | 表示载波频率。 | 
+| satellitesNumber | number | 是 | 表示卫星个数。 |
+| satelliteIds | Array<number> | 是 | 表示每个卫星的ID，数组类型。 |
+| carrierToNoiseDensitys | Array<number> | 是 | 表示载波噪声功率谱密度比，即cn0。 |
+| altitudes | Array<number> | 是 | 表示高程信息。 |
+| azimuths | Array<number> | 是 | 表示方位角。 |
+| carrierFrequencies | Array<number> | 是 | 表示载波频率。 |
 
 
 ## CachedGnssLocationsRequest
 
 请求订阅GNSS缓存位置上报功能接口的配置参数。
 
-  | 名称 | 参数类型 | 必填 | 说明 | 
+| 名称 | 参数类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
-| reportingPeriodSec | number | 是 | 表示GNSS缓存位置上报的周期，单位是毫秒。 | 
-| wakeUpCacheQueueFull | boolean | 是 | true表示GNSS芯片底层缓存队列满之后会主动唤醒AP芯片，并把缓存位置上报给应用。<br/>false表示GNSS芯片底层缓存队列满之后不会主动唤醒AP芯片，会把缓存位置直接丢弃。 | 
+| reportingPeriodSec | number | 是 | 表示GNSS缓存位置上报的周期，单位是毫秒。 |
+| wakeUpCacheQueueFull | boolean | 是 | true表示GNSS芯片底层缓存队列满之后会主动唤醒AP芯片，并把缓存位置上报给应用。<br/>false表示GNSS芯片底层缓存队列满之后不会主动唤醒AP芯片，会把缓存位置直接丢弃。 |
 
 
 ## Geofence
 
 GNSS围栏的配置参数。目前只支持圆形围栏。
 
-  | 名称 | 参数类型 | 必填 | 说明 | 
+| 名称 | 参数类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
-| latitude | number | 是 | 表示纬度。 | 
-| longitude | number | 是 | 表示经度。 | 
-| radius | number | 是 | 表示圆形围栏的半径。 | 
-| expiration | number | 是 | 围栏存活的时间，单位是毫秒。 | 
+| latitude | number | 是 | 表示纬度。 |
+| longitude | number | 是 | 表示经度。 |
+| radius | number | 是 | 表示圆形围栏的半径。 |
+| expiration | number | 是 | 围栏存活的时间，单位是毫秒。 |
 
 
 ## GeofenceRequest
 
 请求添加GNSS围栏消息中携带的参数，包括定位优先级、定位场景和围栏信息。
 
-  | 名称 | 参数类型 | 必填 | 说明 | 
+| 名称 | 参数类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
-| priority | LocationRequestPriority | 是 | 表示位置信息优先级。 | 
-| scenario | LocationRequestScenario | 是 | 表示定位场景。 | 
-| geofence | Geofence | 是 | 表示围栏信息。 | 
+| priority | LocationRequestPriority | 是 | 表示位置信息优先级。 |
+| scenario | LocationRequestScenario | 是 | 表示定位场景。 |
+| geofence | Geofence | 是 | 表示围栏信息。 |
 
 
 ## LocationPrivacyType
 
 定位服务隐私协议类型。
 
-  | 名称 | 默认值 | 说明 | 
+| 名称 | 默认值 | 说明 |
 | -------- | -------- | -------- |
-| OTHERS | 0 | 其他场景。 | 
-| STARTUP | 1 | 开机向导场景下的隐私协议。 | 
-| CORE_LOCATION | 2 | 开启网络定位时弹出的隐私协议。 | 
+| OTHERS | 0 | 其他场景。 |
+| STARTUP | 1 | 开机向导场景下的隐私协议。 |
+| CORE_LOCATION | 2 | 开启网络定位时弹出的隐私协议。 |
 
 
 ## LocationCommand
 
 扩展命令结构体。
 
-  | 名称 | 参数类型 | 必填 | 说明 | 
+| 名称 | 参数类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
-| scenario | LocationRequestScenario | 是 | 表示定位场景。 | 
-| command | string | 是 | 扩展命令字符串。 | 
+| scenario | LocationRequestScenario | 是 | 表示定位场景。 |
+| command | string | 是 | 扩展命令字符串。 |
 
 
 ## Location
 
 位置信息类型。
 
-  | 名称 | 参数类型 | 必填 | 说明 | 
+| 名称 | 参数类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
-| latitude | number | 是 | 表示纬度信息，正值表示北纬，负值表示南纬。 | 
-| longitude | number | 是 | 表示经度信息，正值表示东经，负值表是西经。 | 
-| altitude | number | 是 | 表示高度信息，单位米。 | 
-| accuracy | number | 是 | 表示精度信息，单位米。 | 
-| speed | number | 是 | 表示速度信息，单位米每秒。 | 
-| timeStamp | number | 是 | 表示位置时间戳，UTC格式。 | 
-| direction | number | 是 | 表示航向信息。 | 
-| timeSinceBoot | number | 是 | 表示位置时间戳，开机时间格式。 | 
-| additions | Array&lt;string&gt; | 否 | 附加信息。 | 
-| additionSize | number | 否 | 附加信息数量。 | 
+| latitude | number | 是 | 表示纬度信息，正值表示北纬，负值表示南纬。 |
+| longitude | number | 是 | 表示经度信息，正值表示东经，负值表是西经。 |
+| altitude | number | 是 | 表示高度信息，单位米。 |
+| accuracy | number | 是 | 表示精度信息，单位米。 |
+| speed | number | 是 | 表示速度信息，单位米每秒。 |
+| timeStamp | number | 是 | 表示位置时间戳，UTC格式。 |
+| direction | number | 是 | 表示航向信息。 |
+| timeSinceBoot | number | 是 | 表示位置时间戳，开机时间格式。 |
+| additions | Array&lt;string&gt; | 否 | 附加信息。 |
+| additionSize | number | 否 | 附加信息数量。 |

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

@@ -137,25 +137,25 @@ request\(url: string, options: HttpRequestOptions, callback: AsyncCallback<HttpR
 ```
 httpRequest.request("EXAMPLE_URL",
 {
-  method: 'GET',
-  header: {
-	'Content-Type': 'application/json'
-  },
-  readTimeout: 60000,
-  connectTimeout: 60000
-},(err, data) => {
-  if (!err) {
-	console.info('Result:' + data.result);
-	console.info('code:' + data.responseCode);
-	console.info('header:' + data.header);
-	console.info('cookies:' + data.cookies); // 8+
-	console.info('header['Content-Type']:' + data.header['Content-Type']);
-	console.info('header['Status-Line']:' + data.header['Status-Line']);
-	console.info('header.Date:' + data.header.Date);
-	console.info('header.Server:' + data.header.Server);
-  } else {
-	console.info('error:' + err.data);
-  }
+    method: 'GET',
+    header: {
+        'Content-Type': 'application/json'
+    },
+    readTimeout: 60000,
+    connectTimeout: 60000
+}, (err, data) => {
+    if (!err) {
+        console.info('Result:' + data.result);
+        console.info('code:' + data.responseCode);
+        console.info('header:' + data.header);
+        console.info('cookies:' + data.cookies); // 8+
+        console.info('header.Content-Type:' + data.header['Content-Type']);
+        console.info('header.Status-Line:' + data.header['Status-Line']);
+        console.info('header.Date:' + data.header.Date);
+        console.info('header.Server:' + data.header.Server);
+    } else {
+        console.info('error:' + err.data);
+    }
 });
 ```
 
@@ -188,24 +188,24 @@ request\(url: string, options? : HttpRequestOptions\): Promise<HttpResponse\>
 
 ```
 let promise = httpRequest.request("EXAMPLE_URL", {
-  method: "GET",
-  connectTimeout: 60000,
-  readTimeout: 60000,
-  header: {
-	'Content-Type': 'application/json'
-  }
+    method: "GET",
+    connectTimeout: 60000,
+    readTimeout: 60000,
+    header: {
+        'Content-Type': 'application/json'
+    }
 });
 promise.then((value) => {
-	console.info('Result:' + value.result);
-	console.info('code:' + value.responseCode);
-	console.info('header:' + value.header);
-	console.info('cookies:' + value.cookies); // 8+
-	console.info('header['Content-Type']:' + value.header['Content-Type']);
-	console.info('header['Status-Line']:' + value.header['Status-Line']);
-	console.info('header.Date:' + value.header.Date);
-	console.info('header.Server:' + value.header.Server);
+    console.info('Result:' + value.result);
+    console.info('code:' + value.responseCode);
+    console.info('header:' + value.header);
+    console.info('cookies:' + value.cookies); // 8+
+    console.info('header.Content-Type:' + value.header['Content-Type']);
+    console.info('header.Status-Line:' + value.header['Status-Line']);
+    console.info('header.Date:' + value.header.Date);
+    console.info('header.Server:' + value.header.Server);
 }).catch((err) => {
-	console.error(`errCode:${err.code}, errMessage:${err.data}`);
+    console.error(`errCode:${err.code}, errMessage:${err.data}`);
 });
 ```
 
@@ -246,9 +246,9 @@ on\(type: 'headerReceive', callback: AsyncCallback<Object\>\): void
 ```
 httpRequest.on('headerReceive', (err, data) => {
   if (!err) {
-	console.info('header: ' + data.header);
+    console.info('header: ' + data.header);
   } else {
-	console.info('error:' + err.data);
+    console.info('error:' + err.data);
   }
 });
 ```
@@ -280,9 +280,9 @@ off\(type: 'headerReceive', callback?: AsyncCallback<Object\>\): void
 ```
 httpRequest.on('headerReceive', (err, data) => {
   if (!err) {
-	console.info('header: ' + data.header);
+    console.info('header: ' + data.header);
   } else {
-	console.info('error:' + err.data);
+    console.info('error:' + err.data);
   }
 });
 httpRequest.off('headerReceive');

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

@@ -70,14 +70,14 @@ upload(config: UploadConfig): Promise<UploadTask>
 **系统能力**: SystemCapability.MiscServices.Upload
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 | 
+  | config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 |
 
 - 返回值：
-    | 类型 | 说明 | 
+    | 类型 | 说明 |
   | -------- | -------- |
-  | Promise<[UploadTask](#uploadtask)> | 返回上传任务。 | 
+  | Promise<[UploadTask](#uploadtask)> | 返回上传任务。 |
 
 - 示例：
   
@@ -101,10 +101,10 @@ upload(config: UploadConfig, callback: AsyncCallback<UploadTask>): void
 **系统能力**: SystemCapability.MiscServices.Upload
 
 - 参数
-    | 参数名 | 参数类型 | 必填 | 说明 | 
+    | 参数名 | 参数类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 | 
-  | callback | AsyncCallback<[UploadTask](#uploadtask)> | 否 | 回调函数，异步返回UploadTask对象。 | 
+  | config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 |
+  | callback | AsyncCallback<[UploadTask](#uploadtask)> | 否 | 回调函数，异步返回UploadTask对象。 |
 
 - 示例：
   
@@ -135,10 +135,10 @@ on(type: 'progress', callback:AsyncCallback <uploadedSize: number, totalSize:
 **系统能力**: SystemCapability.MiscServices.Upload
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 订阅的事件类型，取值为'progress'（上传的进度信息）。 | 
-  | callback | function | 是 | 上传进度的回调函数。 | 
+  | type | string | 是 | 订阅的事件类型，取值为'progress'（上传的进度信息）。 |
+  | callback | function | 是 | 上传进度的回调函数。 |
 
   回调函数的参数：
 
@@ -168,10 +168,10 @@ on(type: 'headerReceive', callback: AsyncCallback<object> => void): voi
 **系统能力**: SystemCapability.MiscServices.Upload
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 订阅的事件类型，取值为'headerReceive'（接收响应头）。 | 
-  | callback | AsyncCallback<object> | 是 | HTTP Response Header事件的回调函数。 | 
+  | type | string | 是 | 订阅的事件类型，取值为'headerReceive'（接收响应头）。 |
+  | callback | AsyncCallback<object> | 是 | HTTP Response Header事件的回调函数。 |
 
   回调函数的参数：
 
@@ -200,10 +200,10 @@ off(type: 'progress', callback:AsyncCallback<uploadedSize: number, totalSize:
 **系统能力**: SystemCapability.MiscServices.Upload
 
 - 参数：
-    | 参数名 | 参数类型 | 必填 | 说明 | 
+    | 参数名 | 参数类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 取消订阅的事件类型，取值为'progress'（上传的进度信息）。 | 
-  | callback | function | 否 | 上传任务的回调函数。 | 
+  | type | string | 是 | 取消订阅的事件类型，取值为'progress'（上传的进度信息）。 |
+  | callback | function | 否 | 上传任务的回调函数。 |
 
   回调函数的参数：
 
@@ -233,10 +233,10 @@ off(type: 'headerReceive', callback:AsyncCallback<object> => void): voi
 **系统能力**: SystemCapability.MiscServices.Upload
 
 - 参数：
-    | 参数名 | 参数类型 | 必填 | 说明 | 
+    | 参数名 | 参数类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 取消订阅的事件类型，取值为'headerReceive'（接收响应头）。 | 
-  | callback | AsyncCallback<object> | 否 | HTTP Response Header事件的回调函数。 | 
+  | type | string | 是 | 取消订阅的事件类型，取值为'headerReceive'（接收响应头）。 |
+  | callback | AsyncCallback<object> | 否 | HTTP Response Header事件的回调函数。 |
 
   回调函数的参数：
 
@@ -265,9 +265,9 @@ remove(): Promise<boolean>
 **系统能力**: SystemCapability.MiscServices.Upload
 
 - 返回值：
-    | 类型 | 说明 | 
+    | 类型 | 说明 |
   | -------- | -------- |
-  | Promise<boolean> | 移除任务是否成功。true：成功，false：不成功。 | 
+  | Promise<boolean> | 移除任务是否成功。true：成功，false：不成功。 |
 
 - 示例
   
@@ -295,9 +295,9 @@ remove(callback: AsyncCallback<boolean>): void
 **系统能力**: SystemCapability.MiscServices.Upload
 
 - 参数
-    | 参数名 | 参数类型 | 必填 | 说明 | 
+    | 参数名 | 参数类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | callback | AsyncCallback<boolean> | 是 | 移除任务的回调函数。 | 
+  | callback | AsyncCallback<boolean> | 是 | 移除任务的回调函数。 |
 
 - 示例
   
@@ -320,35 +320,35 @@ remove(callback: AsyncCallback<boolean>): void
 
 **系统能力**: 以下各项对应的系统能力均为SystemCapability.MiscServices.Upload。
 
-  | 名称 | 类型 | 必填 | 说明 | 
+| 名称 | 类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
-| url | string | 是 | 资源地址。 | 
-| header | object | 否 | 添加要包含在上载请求中的HTTP或HTTPS标志头。 | 
-| method | string | 否 | 请求方法：POST、PUT。缺省为POST。 | 
-| files | Array<[File](#file)> | 是 | 要上传的文件列表。请使用 multipart/form-data提交。 | 
-| data | Array<[RequestData](#requestdata)> | 否 | 请求的表单数据。 | 
+| url | string | 是 | 资源地址。 |
+| header | object | 否 | 添加要包含在上载请求中的HTTP或HTTPS标志头。 |
+| method | string | 否 | 请求方法：POST、PUT。缺省为POST。 |
+| files | Array<[File](#file)> | 是 | 要上传的文件列表。请使用 multipart/form-data提交。 |
+| data | Array<[RequestData](#requestdata)> | 否 | 请求的表单数据。 |
 
 
 ## File
 
 **系统能力**: 以下各项对应的系统能力均为SystemCapability.MiscServices.Upload。
 
-  | 名称 | 类型 | 必填 | 说明 | 
+| 名称 | 类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
-| filename | string | 否 | multipart提交时，请求头中的文件名。 | 
-| name | string | 否 | multipart提交时，表单项目的名称，缺省为file。 | 
-| url | string | 是 | 文件的本地存储路径。<br/>支持“dataability”和“internal”两种协议类型，但“internal”仅支持临时目录，示例：<br/>dataability:///com.domainname.dataability.persondata/person/10/file.txt<br/>internal://cache/path/to/file.txt | 
-| type | string | 否 | 文件的内容类型，默认根据文件名或路径的后缀获取。 | 
+| filename | string | 否 | multipart提交时，请求头中的文件名。 |
+| name | string | 否 | multipart提交时，表单项目的名称，缺省为file。 |
+| url | string | 是 | 文件的本地存储路径。<br/>支持“dataability”和“internal”两种协议类型，但“internal”仅支持临时目录，示例：<br/>dataability:///com.domainname.dataability.persondata/person/10/file.txt<br/>internal://cache/path/to/file.txt |
+| type | string | 否 | 文件的内容类型，默认根据文件名或路径的后缀获取。 |
 
 
 ## RequestData
 
 **系统能力**: 以下各项对应的系统能力均为SystemCapability.MiscServices.Upload。
 
-  | 名称 | 类型 | 必填 | 说明 | 
+| 名称 | 类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
-| name | string | 是 | 表示表单元素的名称。 | 
-| value | string | 是 | 表示表单元素的值。 | 
+| name | string | 是 | 表示表单元素的名称。 |
+| value | string | 是 | 表示表单元素的值。 |
 
 
 ## request.download
@@ -362,14 +362,14 @@ download(config: DownloadConfig): Promise&lt;DownloadTask&gt;
 **系统能力**: SystemCapability.MiscServices.Download
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 | 
+  | config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 |
 
 - 返回值：
-    | 类型 | 说明 | 
+    | 类型 | 说明 |
   | -------- | -------- |
-  | Promise&lt;[DownloadTask](#downloadtask)&gt; | 返回下载任务。 | 
+  | Promise&lt;[DownloadTask](#downloadtask)&gt; | 返回下载任务。 |
 
 - 示例
   
@@ -393,10 +393,10 @@ download(config: DownloadConfig, callback: AsyncCallback&lt;DownloadTask&gt;): v
 **系统能力**: SystemCapability.MiscServices.Download
 
 - 参数
-    | 参数名 | 参数类型 | 必填 | 说明 | 
+    | 参数名 | 参数类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 | 
-  | callback | AsyncCallback&lt;[DownloadTask](#downloadtask)&gt; | 否 | 下载接口的回调函数。 | 
+  | config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 |
+  | callback | AsyncCallback&lt;[DownloadTask](#downloadtask)&gt; | 否 | 下载接口的回调函数。 |
 
 - 示例
   
@@ -428,10 +428,10 @@ on(type: 'progress', callback:AsyncCallback&lt;receivedSize: number, totalSize:
 **系统能力**: SystemCapability.MiscServices.Download
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 订阅的事件类型，取值为'progress'（下载的进度信息）。 | 
-  | callback | function | 是 | 下载的回调函数。 | 
+  | type | string | 是 | 订阅的事件类型，取值为'progress'（下载的进度信息）。 |
+  | callback | function | 是 | 下载的回调函数。 |
 
   回调函数的参数：
 
@@ -468,10 +468,10 @@ off(type: 'progress', callback: AsyncCallback&lt;receivedSize: number, totalSize
 **系统能力**: SystemCapability.MiscServices.Download
 
 - 参数：
-    | 参数名 | 参数类型 | 必填 | 说明 | 
+    | 参数名 | 参数类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 取消订阅的事件类型，取值为'progress'（下载的进度信息）。 | 
-  | callback | function | 否 | 下载任务的回调函数。 | 
+  | type | string | 是 | 取消订阅的事件类型，取值为'progress'（下载的进度信息）。 |
+  | callback | function | 否 | 下载任务的回调函数。 |
 
   回调函数的参数：
 
@@ -508,10 +508,10 @@ on(type: 'complete', callback:AsyncCallback&lt;&gt; =&gt; void): void
 **系统能力**: SystemCapability.MiscServices.Download
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 订阅的事件类型，取值为'complete'（下载任务完成）。 | 
-  | callback | function | 是 | 下载完成的回调函数。 | 
+  | type | string | 是 | 订阅的事件类型，取值为'complete'（下载任务完成）。 |
+  | callback | function | 是 | 下载完成的回调函数。 |
 
 - 示例：
   
@@ -541,10 +541,10 @@ off(type: 'complete', callback:AsyncCallback&lt;&gt; =&gt; void): void
 **系统能力**: SystemCapability.MiscServices.Download
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 取消订阅的事件类型，取值为'complete'（下载任务完成）。 | 
-  | callback | function | 否 | 取消下载完成的回调函数。 | 
+  | type | string | 是 | 取消订阅的事件类型，取值为'complete'（下载任务完成）。 |
+  | callback | function | 否 | 取消下载完成的回调函数。 |
 
 - 示例：
   
@@ -574,10 +574,10 @@ on(type: 'fail', callback:AsyncCallback&lt;err: number&gt; =&gt; void): void
 **系统能力**: SystemCapability.MiscServices.Download
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 订阅的事件类型，取值为'fail'（下载失败）。 | 
-  | callback | function | 是 | 下载失败的回调函数。 | 
+  | type | string | 是 | 订阅的事件类型，取值为'fail'（下载失败）。 |
+  | callback | function | 是 | 下载失败的回调函数。 |
 
   回调函数的参数：
 
@@ -613,10 +613,10 @@ off(type: 'fail', callback:AsyncCallback&lt;err: number&gt; =&gt; void): void
 **系统能力**: SystemCapability.MiscServices.Download
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 取消订阅的事件类型，取值为'fail'（下载失败）。 | 
-  | callback | function | 否 | 取消下载失败的回调函数。 | 
+  | type | string | 是 | 取消订阅的事件类型，取值为'fail'（下载失败）。 |
+  | callback | function | 否 | 取消下载失败的回调函数。 |
 
   回调函数的参数
 
@@ -652,10 +652,10 @@ on(type: 'pause', callback:AsyncCallback&lt;&gt; =&gt; void): void
 **系统能力**: SystemCapability.MiscServices.Download
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 订阅的事件类型，取值为'pause'（下载暂停）。 | 
-  | callback | function | 是 | 下载暂停的回调函数。 | 
+  | type | string | 是 | 订阅的事件类型，取值为'pause'（下载暂停）。 |
+  | callback | function | 是 | 下载暂停的回调函数。 |
 
 - 示例：
   
@@ -685,10 +685,10 @@ off(type: 'pause', callback:AsyncCallback&lt;&gt; =&gt; void): void
 **系统能力**: SystemCapability.MiscServices.Download
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 取消订阅的事件类型，取值为'pause'（下载暂停）。 | 
-  | callback | function | 否 | 取消下载暂停的回调函数。 | 
+  | type | string | 是 | 取消订阅的事件类型，取值为'pause'（下载暂停）。 |
+  | callback | function | 否 | 取消下载暂停的回调函数。 |
 
 - 示例：
   
@@ -718,10 +718,10 @@ on(type: 'remove', callback:AsyncCallback&lt;&gt; =&gt; void): void
 **系统能力**: SystemCapability.MiscServices.Download
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 订阅的事件类型，取值为'remove'（下载任务移除）。 | 
-  | callback | function | 是 | 下载移除的回调函数。 | 
+  | type | string | 是 | 订阅的事件类型，取值为'remove'（下载任务移除）。 |
+  | callback | function | 是 | 下载移除的回调函数。 |
 
 - 示例:
   
@@ -751,10 +751,10 @@ off(type: 'remove', callback:AsyncCallback&lt;&gt; =&gt; void): void
 **系统能力**: SystemCapability.MiscServices.Download
 
 - 参数：
-    | 参数名 | 类型 | 必填 | 说明 | 
+    | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | type | string | 是 | 取消订阅的事件类型，取值为'remove'（下载任务移除）。 | 
-  | callback | function | 否 | 取消下载移除的回调函数。 | 
+  | type | string | 是 | 取消订阅的事件类型，取值为'remove'（下载任务移除）。 |
+  | callback | function | 否 | 取消下载移除的回调函数。 |
 
 - 示例：
   
@@ -783,9 +783,9 @@ remove(): Promise&lt;boolean&gt;
 **系统能力**: SystemCapability.MiscServices.Download
 
 - 返回值：
-    | 类型 | 说明 | 
+    | 类型 | 说明 |
   | -------- | -------- |
-  | Promise&lt;boolean&gt; | 移除任务是否成功。 | 
+  | Promise&lt;boolean&gt; | 移除任务是否成功。 |
 
 - 示例
   
@@ -813,9 +813,9 @@ remove(callback: AsyncCallback&lt;boolean&gt;): void
 **系统能力**: SystemCapability.MiscServices.Download
 
 - 参数
-    | 参数名 | 参数类型 | 必填 | 说明 | 
+    | 参数名 | 参数类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | callback | AsyncCallback&lt;boolean&gt; | 是 | 移除任务是否成功。 | 
+  | callback | AsyncCallback&lt;boolean&gt; | 是 | 移除任务是否成功。 |
 
 - 示例
   
@@ -845,9 +845,9 @@ query(): Promise&lt;DownloadInfo&gt;
 **系统能力**: SystemCapability.MiscServices.Download
 
 - 参数：
-    | 类型 | 说明 | 
+    | 类型 | 说明 |
   | -------- | -------- |
-  | Promise&lt;[DownloadInfo](#downloadinfo)&gt; | 查询下载任务信息。 | 
+  | Promise&lt;[DownloadInfo](#downloadinfo)&gt; | 查询下载任务信息。 |
 
 - 示例
   
@@ -871,9 +871,9 @@ query(callback: AsyncCallback&lt;DownloadInfo&gt;): void
 **系统能力**: SystemCapability.MiscServices.Download
 
 - 参数：
-    | 参数名 | 参数类型 | 必填 | 说明 | 
+    | 参数名 | 参数类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | callback | AsyncCallback&lt;[DownloadInfo](#downloadinfo)&gt; | 是 | 查询下载任务的回调函数。 | 
+  | callback | AsyncCallback&lt;[DownloadInfo](#downloadinfo)&gt; | 是 | 查询下载任务的回调函数。 |
 
 - 示例：
   
@@ -899,9 +899,9 @@ queryMimeType(): Promise&lt;string&gt;
 **系统能力**: SystemCapability.MiscServices.Download
 
 - 返回值：
-    | 类型 | 说明 | 
+    | 类型 | 说明 |
   | -------- | -------- |
-  | Promise&lt;string&gt; | 查询下载任务的MimeType。 | 
+  | Promise&lt;string&gt; | 查询下载任务的MimeType。 |
 
 - 示例
   
@@ -925,9 +925,9 @@ queryMimeType(callback: AsyncCallback&lt;string&gt;): void;
 **系统能力**: SystemCapability.MiscServices.Download
 
 - 参数
-    | 参数名 | 参数类型 | 必填 | 说明 | 
+    | 参数名 | 参数类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | callback | AsyncCallback&lt;string&gt; | 是 | 查询下载任务的MimeType的回调函数。 | 
+  | callback | AsyncCallback&lt;string&gt; | 是 | 查询下载任务的MimeType的回调函数。 |
 
 - 示例
   
@@ -953,9 +953,9 @@ pause(): Promise&lt;boolean&gt;
 **系统能力**: SystemCapability.MiscServices.Download
 
 - 返回值：
-    | 类型 | 说明 | 
+    | 类型 | 说明 |
   | -------- | -------- |
-  | Promise&lt;boolean&gt; | 暂停下载任务是否成功。 | 
+  | Promise&lt;boolean&gt; | 暂停下载任务是否成功。 |
 
 - 示例
   
@@ -983,9 +983,9 @@ pause(callback: AsyncCallback&lt;boolean&gt;): void
 **系统能力**: SystemCapability.MiscServices.Download
 
 - 参数
-    | 参数名 | 参数类型 | 必填 | 说明 | 
+    | 参数名 | 参数类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | callback | AsyncCallback&lt;boolean&gt; | 是 | 暂停下载任务的回调函数。 | 
+  | callback | AsyncCallback&lt;boolean&gt; | 是 | 暂停下载任务的回调函数。 |
 
 - 示例
   
@@ -1015,9 +1015,9 @@ resume(): Promise&lt;boolean&gt;
 **系统能力**: SystemCapability.MiscServices.Download
 
 - 参数：
-    | 类型 | 说明 | 
+    | 类型 | 说明 |
   | -------- | -------- |
-  | Promise&lt;boolean&gt; | 重新启动暂停的下载任务是否成功。 | 
+  | Promise&lt;boolean&gt; | 重新启动暂停的下载任务是否成功。 |
 
 - 示例
   
@@ -1046,9 +1046,9 @@ resume(callback: AsyncCallback&lt;boolean&gt;): void
 **系统能力**: SystemCapability.MiscServices.Download
 
 - 参数
-    | 参数名 | 参数类型 | 必填 | 说明 | 
+    | 参数名 | 参数类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | callback | AsyncCallback&lt;boolean&gt; | 是 | 重新启动暂停的下载任务的回调函数。 | 
+  | callback | AsyncCallback&lt;boolean&gt; | 是 | 重新启动暂停的下载任务的回调函数。 |
 
 - 示例
   
@@ -1087,16 +1087,16 @@ resume(callback: AsyncCallback&lt;boolean&gt;): void
 
 **系统能力**: SystemCapability.MiscServices.Download
 
-  | 名称 | 类型 | 必填 | 说明 | 
+| 名称 | 类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
-| downloadId | number | 是 | 下载的文件ID。 | 
-| failedReason | number | 否 | 下载失败原因，可以是任何[ERROR_*](#常量)常量。 | 
-| fileName | string | 是 | 下载的文件名。 | 
-| filePath | string | 是 | 存储文件的URI。 | 
-| pausedReason | number | 否 | 会话暂停的原因，可以是任何[PAUSED_*](#常量)常量。 | 
-| status | number | 是 | 下载状态代码，可以是任何[SESSION_*](#常量)常量。 | 
-| targetURI | string | 是 | 下载文件的URI。 | 
-| downloadTitle | string | 是 | 下载的文件的标题。 | 
-| downloadTotalBytes | number | 是 | 下载的文件的总大小（int&nbsp;bytes）。 | 
-| description | string | 是 | 待下载文件的描述信息。 | 
-| downloadedBytes | number | 是 | 实时下载大小（int&nbsp;&nbsp;bytes）。 | 
+| downloadId | number | 是 | 下载的文件ID。 |
+| failedReason | number | 否 | 下载失败原因，可以是任何[ERROR_*](#常量)常量。 |
+| fileName | string | 是 | 下载的文件名。 |
+| filePath | string | 是 | 存储文件的URI。 |
+| pausedReason | number | 否 | 会话暂停的原因，可以是任何[PAUSED_*](#常量)常量。 |
+| status | number | 是 | 下载状态代码，可以是任何[SESSION_*](#常量)常量。 |
+| targetURI | string | 是 | 下载文件的URI。 |
+| downloadTitle | string | 是 | 下载的文件的标题。 |
+| downloadTotalBytes | number | 是 | 下载的文件的总大小（int&nbsp;bytes）。 |
+| description | string | 是 | 待下载文件的描述信息。 |
+| downloadedBytes | number | 是 | 实时下载大小（int&nbsp;&nbsp;bytes）。 |

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

@@ -1532,7 +1532,7 @@ writeCharArray(charArray: number[]): boolean
 
 ### readCharArray
 
-readCharArray(dataIn: boolean[]) : void
+readCharArray(dataIn: number[]) : void
 
 从MessageParcel实例中读取单个字符数组。
 
@@ -1541,7 +1541,7 @@ readCharArray(dataIn: boolean[]) : void
 - 参数
     | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | dataIn | boolean[] | 是 | 要读取的单个字符数组。 |
+  | dataIn | number[] | 是 | 要读取的单个字符数组。 |
 
 - 示例
 
@@ -1556,7 +1556,7 @@ readCharArray(dataIn: boolean[]) : void
 
 ### readCharArray
 
-readCharArray(): boolean[]
+readCharArray(): number[]
 
 从MessageParcel实例读取单个字符数组。
 
@@ -1565,7 +1565,7 @@ readCharArray(): boolean[]
 - 返回值
     | 类型 | 说明 |
   | -------- | -------- |
-  | boolean[] | 返回单个字符数组。 |
+  | number[] | 返回单个字符数组。 |
 
 - 示例
 
@@ -2191,69 +2191,6 @@ readRawData(size: number): number[]
   console.log("RpcTest: parcel read raw data result is : " + result);
   ```
 
-
-### getDataVersion<sup>8+</sup>
-
-getDataVersion(): number
-
-从MessageParcel对象返回数据格式版本。
-
-**系统能力**：SystemCapability.Communication.IPC.Core
-
-- 返回值
-    | 类型 | 说明 |
-  | -------- | -------- |
-  | number | 从MessageParcel返回数据格式版本。 |
-
-- 示例
-
-  ```
-  let parcel = new rpc.MessageParcel();
-  let version = parcel.getDataVersion();
-  console.log("RpcTest: parcel get data version is : " + version);
-  ```
-
-
-### updateDataVersion<sup>8+</sup>
-
-updateDataVersion(proxy: IRemoteObject): void
-
-将远程对象数据格式版本更新到MessageParcel对象。
-
-**系统能力**：SystemCapability.Communication.IPC.Core
-
-- 参数
-    | 参数名 | 类型 | 必填 | 说明 |
-  | -------- | -------- | -------- | -------- |
-  | proxy | IRemoteObject | 是 | 使用该MessageParcel对象发送请求的远程对象。 |
-
-- 示例
-
-  ```
-  import FA from "@ohos.ability.featureAbility";
-  let proxy;
-  let connect = {
-      onConnect: function(elementName, remoteProxy) {
-          console.log("RpcClient: js onConnect called.");
-          proxy = remoteProxy;
-      },
-      onDisconnect: function(elementName) {
-          console.log("RpcClient: onDisconnect");
-      },
-      onFailed: function() {
-          console.log("RpcClient: onFailed");
-      }
-  };
-  let want = {
-      "bundleName": "com.huawei.server",
-      "abilityName": "com.huawei.server.MainAbility",
-  };
-  FA.connectAbility(want, connect);
-  let parcel = new rpc.MessageParcel();
-  parcel.updateDataVersion(proxy);
-  ```
-
-
 ## Sequenceable
 
 在进程间通信（IPC）期间，将类的对象写入MessageParcel并从MessageParcel中恢复它们。
@@ -2459,7 +2396,7 @@ queryLocalInterface(descriptor: string): IRemoteBroker
 
 ### sendRequest
 
-sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): Promise&lt;number&gt;<sup>7</sup>
+sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): boolean;<sup>7</sup>
 
 sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): Promise&lt;SendRequestResult&gt;<sup>8+</sup>
 
@@ -2571,10 +2508,22 @@ isObjectDead(): boolean
 
 实现IRemoteObject代理对象。
 
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Communication.IPC.Core。
+
+| 参数                  | 值                      | 说明                              |
+| --------------------- | ----------------------- | --------------------------------- |
+| PING_TRANSACTION      | 1599098439 (0x5f504e47) | 内部指令码，用于测试IPC服务正常。 |
+| DUMP_TRANSACTION      | 1598311760 (0x5f444d50) | 内部指令码，获取Binder内部状态。 |
+| INTERFACE_TRANSACTION | 1598968902 (0x5f4e5446) | 内部指令码，获取对端接口描述符。  |
+| MIN_TRANSACTION_ID    | 1 (0x00000001)          | 最小有效指令码。                  |
+| MAX_TRANSACTION_ID    | 16777215 (0x00FFFFFF)   | 最大有效指令码。                  |
+
+
+
 
 ### sendRequest
 
-sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): Promise&lt;number&gt;<sup>7</sup>
+sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): boolean;<sup>7</sup>
 
 sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): Promise&lt;SendRequestResult&gt;<sup>8+</sup>
 
@@ -2977,51 +2926,6 @@ isObjectDead(): boolean
   ```
 
 
-### setDataVersion<sup>8+</sup>
-
-setDataVersion(dataVersion: number): boolean
-
-将数据格式版本设置到RemoteProxy对象。
-
-**系统能力**：SystemCapability.Communication.IPC.Core
-
-- 参数
-    | 参数名 | 类型 | 必填 | 说明 |
-  | -------- | -------- | -------- | -------- |
-  | dataVersion | number | 是 | 数据格式版本。 |
-
-- 返回值
-    | 类型 | 说明 |
-  | -------- | -------- |
-  | boolean | 如果设置数据格式版本成功，则返回true；否则返回false。 |
-
-- 示例
-
-  ```
-  import FA from "@ohos.ability.featureAbility";
-  let proxy;
-  let connect = {
-      onConnect: function(elementName, remoteProxy) {
-          console.log("RpcClient: js onConnect called.");
-          proxy = remoteProxy;
-      },
-      onDisconnect: function(elementName) {
-          console.log("RpcClient: onDisconnect");
-      },
-      onFailed: function() {
-          console.log("RpcClient: onFailed");
-      }
-  };
-  let want = {
-      "bundleName": "com.huawei.server",
-      "abilityName": "com.huawei.server.MainAbility",
-  };
-  FA.connectAbility(want, connect);
-  let result = proxy.setDataVersion(1);
-  console.log("RpcClient: set Data Version is " + result);
-  ```
-
-
 ## MessageOption
 
 公共消息选项（int标志，int等待时间），使用标志中指定的标志构造指定的MessageOption对象。
@@ -3184,6 +3088,32 @@ static getCallingUid(): number
   }
   ```
 
+### getCallingTokenId
+
+static getCallingTokenId(): number;
+
+获取调用者的TokenId，用于被调用方对调用方的身份校验。
+
+**系统能力**：SystemCapability.Communication.IPC.Core
+
+* 返回值
+
+    | 类型   | 说明                  |
+  | ------ | --------------------- |
+  | number | 返回调用者的TokenId。 |
+
+* 示例
+
+  ```
+  class Stub extends rpc.RemoteObject {
+      onRemoteRequest(code, data, reply, option) {
+          let callerTokenId = rpc.IPCSkeleton.getCallingTokenId();
+          console.log("RpcServer: getCallingTokenId result: " + callerTokenId);
+          return true;
+      }
+  }
+  ```
+
 
 ### getCalligDeviceID
 
@@ -3375,7 +3305,7 @@ RemoteObject构造函数。
 
 ### sendRequest
 
-sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): Promise&lt;number&gt;<sup>7</sup>
+sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): boolean;<sup>7</sup>
 
 sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): Promise&lt;SendRequestResult&gt;<sup>8+</sup>
 
@@ -3612,7 +3542,7 @@ getCallingPid(): number
 
 ### queryLocalInterface
 
-queryLocalInterface(descriptor: descriptor): IRemoteBroker
+queryLocalInterface(descriptor: string): IRemoteBroker
 
 查询并获取当前接口描述符对应的远端对象是否已经存在。
 
@@ -3621,7 +3551,7 @@ queryLocalInterface(descriptor: descriptor): IRemoteBroker
 - 参数
     | 参数名 | 类型 | 必填 | 说明 |
   | -------- | -------- | -------- | -------- |
-  | descriptor | descriptor | 是 | 需要查询的接口描述符。 |
+  | descriptor | string | 是 | 需要查询的接口描述符。 |
 
 - 返回值
     | 类型 | 说明 |
@@ -3714,7 +3644,7 @@ attachLocalInterface(localInterface: IRemoteBroker, descriptor: string): void
 | PROT_WRITE | 2 | 映射的内存可写 |
 
 
-### createAshmem
+### createAshmem<sup>8+</sup>
 
 static createAshmem(name: string, size: number): Ashmem
 
@@ -3743,7 +3673,7 @@ static createAshmem(name: string, size: number): Ashmem
   ```
 
 
-### createAshmemFromExisting
+### createAshmemFromExisting<sup>8+</sup>
 
 static createAshmemFromExisting(ashmem: Ashmem): Ashmem
 
@@ -3772,7 +3702,7 @@ static createAshmemFromExisting(ashmem: Ashmem): Ashmem
   ```
 
 
-### closeAshmem
+### closeAshmem<sup>8+</sup>
 
 closeAshmem(): void
 
@@ -3788,7 +3718,7 @@ closeAshmem(): void
   ```
 
 
-### unmapAshmem
+### unmapAshmem<sup>8+</sup>
 
 unmapAshmem(): void
 
@@ -3804,7 +3734,7 @@ unmapAshmem(): void
   ```
 
 
-### getAshmemSize
+### getAshmemSize<sup>8+</sup>
 
 getAshmemSize(): number
 
@@ -3826,7 +3756,7 @@ getAshmemSize(): number
   ```
 
 
-### mapAshmem
+### mapAshmem<sup>8+</sup>
 
 mapAshmem(mapType: number): boolean
 
@@ -3853,7 +3783,7 @@ mapAshmem(mapType: number): boolean
   ```
 
 
-### mapReadAndWriteAshmem
+### mapReadAndWriteAshmem<sup>8+</sup>
 
 mapReadAndWriteAshmem(): boolean
 
@@ -3875,7 +3805,7 @@ mapReadAndWriteAshmem(): boolean
   ```
 
 
-### mapReadOnlyAshmem
+### mapReadOnlyAshmem<sup>8+</sup>
 
 mapReadOnlyAshmem(): boolean
 
@@ -3897,7 +3827,7 @@ mapReadOnlyAshmem(): boolean
   ```
 
 
-### setProtection
+### setProtection<sup>8+</sup>
 
 setProtection(protectionType: number): boolean
 
@@ -3924,7 +3854,7 @@ setProtection(protectionType: number): boolean
   ```
 
 
-### writeToAshmem
+### writeToAshmem<sup>8+</sup>
 
 writeToAshmem(buf: number[], size: number, offset: number): boolean
 
@@ -3954,7 +3884,7 @@ writeToAshmem(buf: number[], size: number, offset: number): boolean
   ```
 
 
-### readFromAshmem
+### readFromAshmem<sup>8+</sup>
 
 readFromAshmem(size: number, offset: number): number[]
 

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

@@ -140,7 +140,7 @@ sim.hasOperatorPrivileges(0, (err, data) => {
 
 ## sim.hasOperatorPrivileges<sup>7+</sup>
 
-hasOperatorPrivileges(slotId: number): Promise<boolean>
+hasOperatorPrivileges(slotId: number): Promise<boolean\>
 
 检查应用（调用者）是否已被授予运营商权限，使用Promise方式作为异步方法。
 

zh-cn/application-dev/reference/apis/js-apis-system-time.md

@@ -6,7 +6,7 @@
 
 ## 导入模块
 
-
+  
 ```
 import systemTime from '@ohos.systemTime';
 ```
@@ -29,7 +29,7 @@ setTime(time : number, callback : AsyncCallback<void>) : void
   | callback | AsyncCallback<void> | 是 | 回调函数，可以在回调函数中处理接口返回值。 | 
 
 - 示例：
-  
+    
   ```
   // time对应的时间为2021-01-20 02:36:25
   var time = 1611081385000;
@@ -64,7 +64,7 @@ setTime(time : number) : Promise<void>
   | Promise<void> | 返回的异步回调函数。 | 
 
 - 示例：
-  
+    
   ```
   // time对应的时间为2021-01-20 02:36:25
   var time = 1611081385000;
@@ -91,7 +91,7 @@ getCurrentTime(isNano?: boolean, callback: AsyncCallback<number>): void
   | callback | AsyncCallback<number> | 是 | 回调函数，返回自 Unix 纪元以来经过的时间。 | 
 
 - 示例：
-  
+    
   ```
   systemTime.getCurrentTime(true, (error, data) => {
       if (error) {
@@ -122,7 +122,7 @@ getCurrentTime(isNano?: boolean): Promise<number>
   | Promise<number> | 以Promise形式返回结果，返回自 Unix 纪元以来经过的时间。 | 
 
 - 示例：
-  
+    
   ```
   systemTime.getCurrentTime().then((data) => {
       console.log(`systemTime.getCurrentTime success data : ` + JSON.stringify(data));
@@ -147,7 +147,7 @@ getRealActiveTime(isNano?: boolean, callback: AsyncCallback<number>): void
   | callback | AsyncCallback<number> | 是 | 回调函数，返回自系统启动以来但不包括度睡眠时间经过的时间。 | 
 
 - 示例：
-  
+    
   ```
   systemTime.getRealActiveTime(true, (error, data) => {
       if (error) {
@@ -178,7 +178,7 @@ getRealActiveTime(isNano?: boolean): Promise<number>
   | Promise<number> | 以Promise形式返回结果，返回自系统启动以来但不包括度睡眠时间经过的时间。 | 
 
 - 示例：
-  
+    
   ```
   systemTime.getCurrentTime().then((data) => {
       console.log(`systemTime.getRealActiveTime success data : ` + JSON.stringify(data));
@@ -203,7 +203,7 @@ getRealTime(callback: AsyncCallback<number>): void
   | callback | AsyncCallback<number> | 是 | 回调函数，返回自系统启动以来包括深度睡眠时间经过的毫秒数。 | 
 
 - 示例：
-  
+    
   ```
   systemTime.getRealTime(true, (error, data) => {
       if (error) {
@@ -234,7 +234,7 @@ getRealTime(): Promise<number>
   | Promise<number> | 以Promise形式返回结果，返回自系统启动以来包括深度睡眠时间经过的时间。 | 
 
 - 示例：
-  
+    
   ```
   systemTime.getRealTime().then((data) => {
       console.log(`systemTime.getRealTime success data: ` + JSON.stringify(data));
@@ -261,7 +261,7 @@ setDate(date: Date, callback: AsyncCallback<void>): void
   | callback | AsyncCallback<void> | 是 | 回调函数，可以在回调函数中处理接口返回值。 | 
 
 - 示例：
-  
+    
   ```
   var data = new Date("October 13, 2020 11:13:00");
   systemTime.setDate(data,(error, data) => {       
@@ -295,7 +295,7 @@ setDate(date: Date): Promise<void>
   | Promise<void> | 返回的异步回调函数。 | 
 
 - 示例：
-  
+    
   ```
   var data = new Date("October 13, 2020 11:13:00"); 
   systemTime.setDate(data).then((value) => {        
@@ -320,7 +320,7 @@ getDate(callback: AsyncCallback<Date>): void
   | callback | AsyncCallback<Date> | 是 | 回调函数，返回当前系统日期。 | 
 
 - 示例：
-  
+    
   ```
   systemTime.getDate((error, data) => {
       if (error) {
@@ -346,7 +346,7 @@ getDate(): Promise<Date>
   | Promise<Date> | 以Promise形式返回结果，返回当前系统日期。 | 
 
 - 示例：
-  
+    
   ```
   systemTime.getDate().then((data) => {
       console.log(`systemTime.getDate success data : ` + JSON.stringify(data));
@@ -373,7 +373,7 @@ setTimezone(timezone: string, callback: AsyncCallback<void>): void
   | callback | AsyncCallback<void> | 是 | 回调函数，可以在回调函数中处理接口返回值。 | 
 
 - 示例：
-  
+    
   ```
   systemTime.setTimezone('Asia/Shanghai', (error, data) => {       
       if (error) {          
@@ -406,7 +406,7 @@ setTimezone(timezone: string): Promise<void>
   | Promise<void> | 返回的异步回调函数。 | 
 
 - 示例：
-  
+    
   ```
   systemTime.setTimezone('Asia/Shanghai').then((data) => {        
       console.log(`systemTime.setTimezone success data : ` + JSON.stringify(data));     
@@ -430,7 +430,7 @@ getTimeZone(callback: AsyncCallback<string>): void
   | callback | AsyncCallback<string> | 是 | 回调函数，返回系统时区。 | 
 
 - 示例：
-  
+    
   ```
   systemTime.getTimeZone((error, data) => {
       if (error) {
@@ -456,7 +456,7 @@ getTimeZone(): Promise<string>
   | Promise<string> | 以Promise形式返回结果，返回系统时区。 | 
 
 - 示例：
-  
+    
   ```
   systemTime.getDate().then((data) => {
       console.log(`systemTime.getTimeZone success data : ` + JSON.stringify(data));

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

@@ -174,6 +174,6 @@ unmount(volumeId: string, callback:AsyncCallback<boolean>):void
 | id<sup>9+</sup>          | number  | 卷id                 |
 | uuid<sup>9+</sup>        | string  | 卷uuid               |
 | description<sup>9+</sup> | string  | 卷相关描述           |
-| removeAble<sup>9+</sup>  | boolean | 是否为可移动存储设备 |
+| removable<sup>9+</sup> | boolean | 是否为可移动存储设备 |
 | state<sup>9+</sup>       | int     | 当前卷状态           |
 | path<sup>9+</sup>        | string  | 卷的挂载地址         |
\ No newline at end of file

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

@@ -269,7 +269,6 @@ isLastWorkTimeOut(workId: number): Promise\<boolean>
     .catch(err =>  {
       console.info('workschedulerLog isLastWorkTimeOut failed, because:' + err.data);
     });
-  })
 ```
 
 ## WorkInfo

zh-cn/application-dev/reference/arkui-js/js-components-common-transition.md

@@ -48,10 +48,8 @@ PageA跳转到PageB，跳转的共享元素为image， shareid为“shareImage
 <div>
   <list>
     <list-item type="description">
-      <div>
-        <image src="item.jpg" shareid="shareImage" onclick="jump" class="shared-transition-style"></image>
-        <text onclick="jump">Click on picture to Jump to ths details</text>
-      </div>
+      <image src="item.jpg" shareid="shareImage" onclick="jump" class="shared-transition-style"></image>
+      <text onclick="jump">Click on picture to Jump to ths details</text>
     </list-item>
   </list>
 </div>
@@ -237,3 +235,145 @@ export default {
 
    b. back场景下：退出页面栈的Page2.js应用transition-enter描述的动画配置，并进行倒播；从页面栈第二位置进入栈顶位置的Page1.js应用transition-exit描述的动画配置，并进行倒播。
    ![zh-cn_image_0000001238184345](figures/zh-cn_image_0000001238184345.png)
+
+### 示例
+
+Page1有一个不透明盒子，点击盒子会跳转到Page2，当点击Page2中的盒子，会回退到Page1页面。
+
+1. Page1
+
+   ```
+   <!-- xxx.hml -->
+   <div class="container">
+       <text>index</text>
+       <div class="move_page" onclick="jump"></div>
+   </div>
+   ```
+
+   ```
+   <!-- xxx.js -->
+   import router from '@system.router';
+   export default {
+       data: {
+   
+       },
+       jump() {
+           router.push({
+               uri:'pages/transition2/transition2'
+           })
+       }
+   }
+   ```
+
+   ```
+   <!-- xxx.css -->
+   .container {
+       flex-direction: column;
+       justify-content: center;
+       align-items: center;
+       width: 100%;
+       height: 100%;
+   }
+   .move_page {
+       width: 100px;
+       height: 100px;
+       background-color: #72d3fa;
+       transition-enter: go_page;
+       transition-exit: exit_page;
+       transition-duration: 5s;
+       transition-timing-function: friction;
+   }
+   
+   @keyframes go_page {
+       from {
+           opacity: 0;
+           transform: translate(0px) rotate(60deg) scale(1.0);
+       }
+   
+       to {
+           opacity: 1;
+           transform: translate(100px) rotate(360deg) scale(1.0);
+       }
+   }
+   @keyframes exit_page {
+       from {
+           opacity: 1;
+           transform: translate(200px) rotate(60deg) scale(2);
+       }
+   
+       to {
+           opacity: 0;
+           transform: translate(200px) rotate(360deg) scale(2);
+       }
+   }
+   ```
+
+   
+
+2. Page2
+
+   ```
+   <!-- xxx.hml -->
+   <div class="container">
+       <text>transition</text>
+       <div class="move_page" onclick="jumpBack"></div>
+   </div
+   ```
+
+   ```
+   <!-- xxx.js -->
+   import router from '@system.router';
+   export default {
+       data: {
+   
+       },
+       jumpBack() {
+           router.back()
+       }
+   }
+   ```
+
+   ```
+   <!-- xxx.css -->
+   .container {
+       flex-direction: column;
+       justify-content: center;
+       align-items: center;
+       width: 100%;
+       height: 100%;
+   }
+   
+   .move_page {
+       width: 100px;
+       height: 100px;
+       background-color: #f172fa;
+       transition-enter: go_page;
+       transition-exit: exit_page;
+       transition-duration: 5s;
+       transition-timing-function: ease;
+   }
+   
+   @keyframes go_page {
+       from {
+           opacity: 0;
+           transform:translate(100px) rotate(0deg) scale(1.0);
+       }
+       to {
+           opacity: 1;
+           transform:translate(100px) rotate(180deg) scale(2.0);
+       }
+   }
+   
+   @keyframes exit_page {
+       from {
+           opacity: 1;
+           transform: translate(0px) rotate(60deg) scale(1);
+       }
+       to {
+           opacity: 0;
+           transform: translate(0px) rotate(360deg) scale(1);
+       }
+   }
+   ```
+   
+   ![transition](figures/transition.gif)