@@ -237,3 +77,164 @@ createAnimator(options[...]): void
}
}
```
+
+## AnimatorResult
+
+定义Animator结果接口。
+
+### update
+
+update(options: AnimatorOptions): void
+
+更新当前动画器。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**参数：**
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | options | [AnimatorOptions](#animatoroptions) | 是 | 定义动画选项。|
+
+**示例：**
+```
+animator.update(options)；
+```
+
+### play
+
+play(): void
+
+启动动画。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**示例：**
+```
+animator.play()；
+```
+
+### finish
+
+finish(): void
+
+结束动画。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**示例：**
+```
+animator.finish()；
+```
+
+### pause
+
+pause(): void
+
+暂停动画。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**示例：**
+```
+animator.pause()；
+```
+
+### cancel
+
+cancel(): void
+
+删除动画。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**示例：**
+```
+animator.cancel()；
+```
+
+### reverse
+
+reverse(): void
+
+以相反的顺序播放动画。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**示例：**
+```
+animator.reverse()；
+```
+
+### onframe
+
+onframe: (progress: number) => void
+
+回调时触发。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**参数：**
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | progress | number | 是 | 动画的当前进度。|
+
+**示例：**
+```
+animator.onframe()；
+```
+
+### onfinish
+
+onfinish: () => void
+
+动画完成。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**示例：**
+```
+animator.onfinish()；
+```
+
+### oncancel
+
+oncancel: () => void
+
+动画被取消。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**示例：**
+```
+animator.oncancel()；
+```
+
+### onrepeat
+
+onrepeat: () => void
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**示例：**
+```
+animator.onrepeat()；
+```
+
+动画将重复。
+
+## AnimatorOptions
+
+定义动画选项。
+
+**系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full
+
+| 名称 | 参数类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| duration | number | 是 | 动画播放的时长，单位毫秒，默认为0。 |
+| easing | string | 是 | 动画插值曲线，默认为ease'。 |
+| delay | number | 是 | 动画延时播放时长，单位毫秒，默认为0，即不延时。 |
+| fill | "none" \| "forwards" \| "backwards" \| "both" | 是 | 动画执行后是否恢复到初始状态，默认值为"none"。动画执行后，动画结束时的状态（在最后一个关键帧中定义）将保留。 |
+| direction | "normal" \| "reverse" \| "alternate" \| "alternate-reverse" | 是 | 动画播放模式，默认值"normal"。|
+| iterations | number | 是 | 动画播放次数，默认值1。设置为0时不播放，设置为-1时无限次播放。 |
+| begin | number | 是 | 动画插值起点，不设置时默认为0。 |
+| end | number | 是 | 动画插值终点，不设置时默认为1。 |
diff --git a/zh-cn/application-dev/reference/apis/js-apis-basic-features-ohos-prompt.md b/zh-cn/application-dev/reference/apis/js-apis-basic-features-ohos-prompt.md
new file mode 100644
index 0000000000000000000000000000000000000000..b843237d0cdd8a3e5ecd9db7630de3ea4c533d85
--- /dev/null
+++ b/zh-cn/application-dev/reference/apis/js-apis-basic-features-ohos-prompt.md
@@ -0,0 +1,273 @@
+# 弹窗
+
+>  **说明**
+> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+
+## 导入模块
+
+```
+import prompt from '@ohos.prompt'
+```
+## 权限列表
+
+无
+
+## prompt.showToast
+
+showToast(options: ShowToastOptions): void
+
+创建并显示文本提示框。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**参数：**
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | options | [ShowToastOptions](#ShowToastOptions) | 是 | 文本弹窗选项。 |
+
+**示例：**
+ ```
+ export default {
+ showToast() {
+ prompt.showToast({
+ message: 'Message Info',
+ duration: 2000,
+ });
+ }
+ }
+ ```
+## ShowToastOptions
+
+文本提示框的选项。
+
+**系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full。
+
+| 名称 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| message | string | 是 | 显示的文本信息。 |
+| duration | number | 否 | 默认值1500ms，建议区间：1500ms-10000ms。
>  **说明：**
> 若小于1500ms则取默认值，最大取值为10000ms。 |
+| bottom | <length> | 否 | 设置弹窗边框距离屏幕底部的位置。
>  **说明：**
> 仅手机和平板设备支持。 |
+
+## prompt.showDialog
+
+showDialog(options: ShowDialogOptions): Promise<ShowDialogSuccessResponse>
+
+创建并显示对话框，对话框响应后同步返回结果。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**参数：**
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | options | [ShowDialogOptions](#ShowDialogOptions) | 是 | 对话框选项。|
+
+**返回值：**
+
+ | 类型 | 说明 |
+ | -------- | -------- |
+ | Promise<[ShowDialogSuccessResponse](#ShowDialogSuccessResponse)> | 对话框响应结果。|
+
+**示例：**
+
+ ```
+ export default {
+ showDialog() {
+ prompt.showDialog({
+ title: 'Title Info',
+ message: 'Message Info',
+ buttons: [
+ {
+ text: 'button1',
+ color: '#000000',
+ },
+ {
+ text: 'button2',
+ color: '#000000',
+ }
+ ],
+ })
+ .then(data => {
+ console.info('showDialog success, click button: ' + data.index);
+ })
+ .catch(err => {
+ console.info('showDialog error: ' + err);
+ })
+ }
+ }
+ ```
+
+## prompt.showDialog
+
+showDialog(options: ShowDialogOptions, callback: AsyncCallback<ShowDialogSuccessResponse>):void
+
+创建并显示对话框，对话框响应结果异步返回。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+
+**参数：**
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | options | [ShowDialogOptions](#ShowDialogOptions) | 是 | 页面显示对话框信息描述。|
+ | callback | AsyncCallback<[ShowDialogSuccessResponse](#ShowDialogSuccessResponse)> | 是 | 对话框响应结果回调。 |
+
+**示例：**
+ ```
+ export default {
+ callback(err, data) {
+ if(err) {
+ console.info('showDialog err: ' + err);
+ return;
+ }
+ console.info('showDialog success callback, click button: ' + data.index);
+ },
+ showDialog() {
+ prompt.showDialog({
+ title: 'showDialog Title Info',
+ message: 'Message Info',
+ buttons: [
+ {
+ text: 'button1',
+ color: '#000000',
+ },
+ {
+ text: 'button2',
+ color: '#000000',
+ }
+ ]
+ }, this.callback);
+ }
+ }
+ ```
+
+## ShowDialogOptions
+
+对话框的选项。
+
+**系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full。
+
+| 名称 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| title | string | 否 | 标题文本。 |
+| message | string | 否 | 内容文本。 |
+| buttons | Array | 否 | 对话框中按钮的数组，结构为：{text:'button', color: '\#666666'}，支持1-3个按钮。其中第一个为positiveButton；第二个为negativeButton；第三个为neutralButton。 |
+
+## ShowDialogSuccessResponse
+
+对话框的响应结果。
+
+**系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full。
+
+| 名称 | 类型 | 说明 |
+| -------- | -------- | -------- |
+| index | number | 选中按钮在buttons数组中的索引。 |
+
+
+## prompt.showActionMenu
+
+showActionMenu(options: ActionMenuOptions, callback: AsyncCallback<ActionMenuSuccessResponse>):void
+
+创建并显示操作菜单，菜单响应结果异步返回。
+
+**系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full。
+
+**参数：**
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | options | [ActionMenuOptions](#ActionMenuOptions) | 是 | 操作菜单选项。 |
+ | callback | AsyncCallback<[ActionMenuSuccessResponse](#ActionMenuSuccessResponse)> | 是 | 菜单响应结果回调。 |
+
+
+**示例：**
+ ```
+ export default {
+ callback(err, data) {
+ if(err) {
+ console.info('showActionMenu err: ' + err);
+ return;
+ }
+ console.info('showActionMenu success callback, click button: ' + data.index);
+ },
+ showActionMenu() {
+ prompt.showActionMenu({
+ title: 'Title Info',
+ buttons: [
+ {
+ text: 'item1',
+ color: '#666666',
+ },
+ {
+ text: 'item2',
+ color: '#000000',
+ },
+ ]
+ }, this.callback)
+ }
+ }
+ ```
+
+## prompt.showActionMenu
+
+showActionMenu(options: ActionMenuOptions): Promise
+
+创建并显示操作菜单，菜单响应后同步返回结果。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**参数：**
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | options | [ActionMenuOptions](#ActionMenuOptions) | 是 | 操作菜单选项。 |
+
+**返回值：**
+ | 类型 | 说明 |
+ | -------- | -------- |
+ | Promise<[ActionMenuSuccessResponse](#ActionMenuSuccessResponse)> | 菜单响应结果。|
+
+**示例：**
+ ```
+ export default {
+ showActionMenu() {
+ prompt.showActionMenu({
+ title: 'showActionMenu Title Info',
+ buttons: [
+ {
+ text: 'item1',
+ color: '#666666',
+ },
+ {
+ text: 'item2',
+ color: '#000000',
+ },
+ ]
+ })
+ .then(data => {
+ console.info('showActionMenu success, click button: ' + data.index);
+ })
+ .catch(err => {
+ console.info('showActionMenu error: ' + err);
+ })
+ }
+ }
+ ```
+## ActionMenuOptions
+
+操作菜单的选项。
+
+**系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full。
+
+| 名称 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| title | string | 否 | 标题文本。 |
+| buttons | Array | 是 | 菜单中菜单项按钮的数组，结构为：{text:'button', color: '\#666666'}，支持1-6个按钮。大于6个按钮时弹窗不显示。 |
+
+## ActionMenuSuccessResponse
+
+操作菜单的响应结果。
+
+**系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full。
+
+| 名称 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| index | number | 否 | 选中按钮在buttons数组中的索引，从0开始。 |
+
diff --git a/zh-cn/application-dev/reference/apis/js-apis-basic-features-ohos-router.md b/zh-cn/application-dev/reference/apis/js-apis-basic-features-ohos-router.md
new file mode 100644
index 0000000000000000000000000000000000000000..a23600c396045139e7b0a8fcf1049e0d632c2273
--- /dev/null
+++ b/zh-cn/application-dev/reference/apis/js-apis-basic-features-ohos-router.md
@@ -0,0 +1,434 @@
+# 页面路由
+
+>  **说明**
+>
+> - 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+> - 页面路由需要在页面渲染完成之后才能调用，在onInit和onReady生命周期中页面还处于渲染阶段，禁止调用页面路由方法。
+
+## 导入模块
+
+```
+import router from '@ohos.router'
+```
+
+## 权限列表
+
+无
+
+## router.push
+
+push(options: RouterOptions): void
+
+跳转到应用内的指定页面。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**参数：**
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | options | [RouterOptions](#RouterOptions) | 是 | 跳转页面描述信息。 |
+
+
+**示例：**
+ ```
+ // 在当前页面中
+ export default {
+ pushPage() {
+ router.push({
+ url: 'pages/routerpage2/routerpage2',
+ params: {
+ data1: 'message',
+ data2: {
+ data3: [123, 456, 789]
+ },
+ },
+ });
+ }
+ }
+ ```
+ ```
+ // 在routerpage2页面中
+ export default {
+ data: {
+ data1: 'default',
+ data2: {
+ data3: [1, 2, 3]
+ }
+ },
+ onInit() {
+ console.info('showData1:' + this.data1);
+ console.info('showData3:' + this.data2.data3);
+ }
+ }
+ ```
+
+
+## router.replace
+
+replace(options: RouterOptions): void
+
+用应用内的某个页面替换当前页面，并销毁被替换的页面。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**参数：**
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | options | [RouterOptions](#RouterOptions) | 是 | 替换页面描述信息。 |
+
+**示例：**
+ ```
+ // 在当前页面中
+ export default {
+ replacePage() {
+ router.replace({
+ url: 'pages/detail/detail',
+ params: {
+ data1: 'message',
+ },
+ });
+ }
+ }
+ ```
+
+ ```
+ // 在detail页面中
+ export default {
+ data: {
+ data1: 'default'
+ },
+ onInit() {
+ console.info('showData1:' + this.data1)
+ }
+ }
+ ```
+
+## router.back
+
+back(options?: RouterOptions ): void
+
+返回上一页面或指定的页面。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**参数：**
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | options | [RouterOptions](#RouterOptions) | 是 | 返回页面描述信息，其中参数url指路由跳转时会返回到指定url的界面，如果页面栈上没有url页面，则不响应该情况。如果url未设置，则返回上一页。 |
+
+**示例：**
+ ```
+ // index页面
+ export default {
+ indexPushPage() {
+ router.push({
+ url: 'pages/detail/detail',
+ });
+ }
+ }
+ ```
+
+ ```
+ // detail页面
+ export default {
+ detailPushPage() {
+ router.push({
+ url: 'pages/mall/mall',
+ });
+ }
+ }
+ ```
+
+ ```
+ // mall页面通过back，将返回detail页面
+ export default {
+ mallBackPage() {
+ router.back();
+ }
+ }
+ ```
+
+ ```
+ // detail页面通过back，将返回index页面
+ export default {
+ defaultBack() {
+ router.back();
+ }
+ }
+ ```
+
+ ```
+ // 通过back，返回到detail页面
+ export default {
+ backToDetail() {
+ router.back({uri:'pages/detail/detail'});
+ }
+ }
+ ```
+
+## router.clear
+
+clear(): void
+
+清空页面栈中的所有历史页面，仅保留当前页面作为栈顶页面。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**示例：**
+ ```
+ export default {
+ clearPage() {
+ router.clear();
+ }
+ }
+ ```
+
+## router.getLength
+
+getLength(): string
+
+获取当前在页面栈内的页面数量。
+
+**返回值：**
+ | 类型 | 说明 |
+ | -------- | -------- |
+ | string | 页面数量，页面栈支持最大数值是32。 |
+
+**示例：**
+ ```
+ export default {
+ getLength() {
+ var size = router.getLength();
+ console.log('pages stack size = ' + size);
+ }
+ }
+ ```
+
+## router.getState
+
+getState(): RouterState
+
+获取当前页面的状态信息。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**返回值：**
+
+| 类型 | 说明 |
+| --------------------------- | -------------- |
+| [RouterState](#RouterState) | 页面状态信息。 |
+## RouterState
+页面状态信息。
+
+**系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full。
+
+ | 名称 | 类型 | 说明 |
+ | -------- | -------- | -------- |
+ | index | number | 表示当前页面在页面栈中的索引。
>  **说明：**
> 从栈底到栈顶，index从1开始递增。 |
+ | name | string | 表示当前页面的名称，即对应文件名。 |
+ | path | string | 表示当前页面的路径。 |
+
+**示例：**
+ ```
+ export default {
+ getState() {
+ var page = router.getState();
+ console.log('current index = ' + page.index);
+ console.log('current name = ' + page.name);
+ console.log('current path = ' + page.path);
+ }
+ }
+ ```
+
+## router.enableAlertBeforeBackPage
+
+enableAlertBeforeBackPage(options: EnableAlertOptions): void
+
+开启页面返回询问对话框。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**参数：**
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | options | [EnableAlertOptions](#EnableAlertOptions) | 是 | 文本弹窗信息描述。 |
+
+**示例：**
+
+ ```
+ export default {
+ enableAlertBeforeBackPage() {
+ router.enableAlertBeforeBackPage({
+ message: 'Message Info',
+ success: function() {
+ console.log('success');
+ },
+ fail: function() {
+ console.log('fail');
+ },
+ });
+ }
+ }
+ ```
+## EnableAlertOptions
+
+页面返回询问对话框选项。
+
+**系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Lite。
+
+| 名称 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| message | string | 是 | 询问对话框内容。 |
+
+## router.disableAlertBeforeBackPage
+
+disableAlertBeforeBackPage(): void
+
+禁用页面返回询问对话框。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**示例：**
+ ```
+ export default {
+ disableAlertBeforeBackPage() {
+ router.disableAlertBeforeBackPage();
+ }
+ }
+ ```
+
+## router.getParams
+
+getParams(): Object
+
+获取发起跳转的页面往当前页传入的参数。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**返回值：**
+
+| 类型 | 说明 |
+| ------ | ---------------------------------- |
+| Object | 发起跳转的页面往当前页传入的参数。 |
+**示例：**
+
+- 类Web范示例
+ ```
+ // 在当前页面中
+ export default {
+ pushPage() {
+ router.push({
+ url: 'pages/detail/detail',
+ params: {
+ data1: 'message',
+ },
+ });
+ }
+ }
+ ```
+ ```
+ // 在detail页面中
+ export default {
+ onInit() {
+ console.info('showData1:' + router.getParams().data1);
+ }
+ }
+ ```
+
+- 声明式示例
+
+ ```
+ //通过router.push跳转至目标页携带params参数
+ import router from '@ohos.router'
+
+ @Entry
+ @Component
+ struct Index {
+ async routePage() {
+ let options = {
+ url: 'pages/second',
+ params: {
+ text: '这是第一页的值',
+ data: {
+ array: [12, 45, 78]
+ },
+ }
+ }
+ try {
+ await router.push(options)
+ } catch (err) {
+ console.info(` fail callback, code: ${err.code}, msg: ${err.msg}`)
+ }
+ }
+
+ build() {
+ Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
+ Text('这是第一页')
+ .fontSize(50)
+ .fontWeight(FontWeight.Bold)
+ Button() {
+ Text('next page')
+ .fontSize(25)
+ .fontWeight(FontWeight.Bold)
+ }.type(ButtonType.Capsule)
+ .margin({ top: 20 })
+ .backgroundColor('#ccc')
+ .onClick(() => {
+ this.routePage()
+ })
+ }
+ .width('100%')
+ .height('100%')
+ }
+ }
+ ```
+
+ ```
+ //在second页面中接收传递过来的参数
+ import router from '@ohos.router'
+
+ @Entry
+ @Component
+ struct Second {
+ private content: string = "这是第二页"
+ @State text: string = router.getParams().text
+ @State data: any = router.getParams().data
+ @State secondData : string = ''
+
+ build() {
+ Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
+ Text(`${this.content}`)
+ .fontSize(50)
+ .fontWeight(FontWeight.Bold)
+ Text(this.text)
+ .fontSize(30)
+ .onClick(()=>{
+ this.secondData = (this.data.array[1]).toString()
+ })
+ .margin({top:20})
+ Text('第一页传来的数值' + ' ' + this.secondData)
+ .fontSize(20)
+ .margin({top:20})
+ .backgroundColor('red')
+ }
+ .width('100%')
+ .height('100%')
+ }
+ }
+ ```
+
+## RouterOptions
+
+路由跳转选项。
+
+**系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Lite。
+
+| 名称 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| url | string | 是 | 表示目标页面的uri，可以用以下两种格式：
- 页面绝对路径，由配置文件中pages列表提供，例如：
- pages/index/index
- pages/detail/detail
- 特殊值，如果uri的值是"/"，则跳转到首页。 |
+| params | Object | 否 | 跳转时要同时传递到目标页面的数据，跳转到目标页面后，参数可以在页面中直接使用，如this.data1(data1为跳转时params参数中的key值)。如果目标页面中已有该字段，则其值会被传入的字段值覆盖。 |
+
+
+ >  **说明：**
+ > 页面路由栈支持的最大Page数量为32。
+
diff --git a/zh-cn/application-dev/reference/apis/js-apis-hashmap.md b/zh-cn/application-dev/reference/apis/js-apis-hashmap.md
index cffd137ac8152bcdad774d7135a2cdb23f22ddc0..ed609c72be5bc7b3556a759c78d8e3dd67b32c96 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-hashmap.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-hashmap.md
@@ -351,7 +351,7 @@ hashMap.forEach((value, key) => {
### entries
-entries(): IterableIterator<[K, V]>
+entries(): IterableIterator<[K, V]>
返回包含此映射中包含的键值对的新迭代器对象。
@@ -359,7 +359,7 @@ entries(): IterableIterator<[K, V]>
| 类型 | 说明 |
| -------- | -------- |
-| IterableIterator<[K, V]> | 返回一个迭代器。 |
+| IterableIterator<[K, V]> | 返回一个迭代器。 |
**示例：**
@@ -387,7 +387,7 @@ while(temp != undefined) {
| 类型 | 说明 |
| -------- | -------- |
-| IterableIterator<[K, V]> | 返回一个迭代器。 |
+| IterableIterator<[K, V]> | 返回一个迭代器。 |
**示例：**
```
diff --git a/zh-cn/application-dev/reference/apis/js-apis-list.md b/zh-cn/application-dev/reference/apis/js-apis-list.md
index 4caf882c015ee5feb18226bdc5ed4a552a693526..4a986350a38174f2f037b84ecdec23921972a95a 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-list.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-list.md
@@ -578,7 +578,7 @@ getLast(): T
**示例：**
```
-let list = new Vector();
+let list = new List();
list.add(2);
list.add(4);
list.add(5);
diff --git a/zh-cn/application-dev/reference/apis/js-apis-plainarray.md b/zh-cn/application-dev/reference/apis/js-apis-plainarray.md
index be8fbccd2715f4acdd8d7febbd4f1479f95dbe48..498e53cbf54f3b9ee2838b9eb7b2d02f6e28d0c4 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-plainarray.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-plainarray.md
@@ -416,7 +416,7 @@ plainArray.clear();
### forEach
-forEach(callbackfn: (value: T, index?: number, PlainArray?: PlainArray) => void, thisArg?: Object): void
+forEach(callbackfn: (value: T, index?: number, PlainArray?: PlainArray<T>) => void, thisArg?: Object): void
通过回调函数来遍历实例对象上的元素以及元素对应的下标。
@@ -432,7 +432,7 @@ callbackfn的参数说明：
| -------- | -------- | -------- | -------- |
| value | T | 是 | 当前遍历到的元素键值对的值。 |
| index | number | 否 | 当前遍历到的元素键值对的键。 |
-| plainArray | PlainArray | 否 | 当前调用forEach方法的实例对象。 |
+| PlainArray | PlainArray<T>| 否 | 当前调用forEach方法的实例对象。 |
**示例：**
@@ -456,7 +456,7 @@ plainArray.forEach((value, key) => {
| 类型 | 说明 |
| -------- | -------- |
-| IterableIterator<[number, T]> | 返回一个迭代器。 |
+| IterableIterator<[number, T]> | 返回一个迭代器。 |
**示例：**
diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-app.md b/zh-cn/application-dev/reference/apis/js-apis-system-app.md
index 6ceb384650f9b4c8bd8526fb198bc86788f36474..85cd58a7311f9c95214cb7661442f95220c87723 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-system-app.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-system-app.md
@@ -16,21 +16,17 @@ import app from '@system.app';
## app.getInfo
-getInfo(): <AppResponse>
+getInfo(): AppResponse
获取当前应用配置文件中声明的信息。
**系统能力：** SystemCapability.ArkUI.ArkUI.Lite
**返回值：**
-**表1** AppResponse
-| 参数名 | 类型 | 说明 |
-| -------- | -------- | -------- |
-| appID6+ | string | 表示应用的包名，用于标识应用的唯一性。 |
-| appName | string | 表示应用的名称。 |
-| versionName | string | 表示应用的版本名称。 |
-| versionCode | number | 表示应用的版本号。 |
+| 参数类型 | 说明 |
+| -------- | -------- |
+| [AppResponse](#appresponse) | 定义AppResponse信息。 |
**示例：**
@@ -43,41 +39,6 @@ getInfo(): <AppResponse>
}
```
-## app.screenOnVisible
-
-screenOnVisible(Object): void
-
-应用申请息屏不返回主表盘，再次亮屏依旧显示应用界面。
-
-**系统能力：** SystemCapability.ArkUI.ArkUI.Full
-
-**参数：**
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| visible | boolean | 否 | 是否启动保活，默认值false。 |
-| success | Function | 否 | 接口调用成功的回调函数。 |
-| fail | Function | 否 | 接口调用失败的回调函数。 |
-| complete | Function | 否 | 接口调用结束的回调函数。 |
-
-**示例：**
-
- ```
- export default {
- screenOnVisible(){
- app.screenOnVisible({
- visible: true,
- success() {
- console.log('call app.keepVisible success');
- },
- fail(data, code) {
- console.log('call app.keepVisible fail');
- },
- });
- }
- }
- ```
-
-
## app.terminate
terminate(): void
@@ -94,10 +55,9 @@ terminate(): void
app.terminate();
}}
```
-
## app.requestFullWindow
-requestFullWindow(duration: number): void
+requestFullWindow(options?: RequestFullWindowOptions): void
请求应用以全窗口运行，FA在某些场景下（如半模态FA）会以非全窗口运行，调用该接口会从非全窗口切换为全窗口运行，如果已经以全窗口运行则该接口调用无效。
@@ -108,7 +68,7 @@ requestFullWindow(duration: number): void
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| duration | number | 否 | 请求全屏时，设定非全屏到全屏的过渡时间，单位为毫秒，默认时间与非全屏到全屏的距离成正比。 |
+| options | [RequestFullWindowOptions](#requestfullwindowoptions) | 否 | 请求全屏时，设定非全屏到全屏的过渡时间，单位为毫秒，默认时间与非全屏到全屏的距离成正比。 |
**示例：**
@@ -119,4 +79,81 @@ requestFullWindow(duration: number): void
duration: 200});
}
}
- ```
+ ```
+
+## app.setImageCacheCount
+
+setImageCacheCount(value: number): void
+
+设置解码图像计数的图像缓存容量。如果未设置，应用程序将不会缓存任何解码图像。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**参数：**
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| value | number | 否 | 解码图像计数的值容量。 |
+
+## app.setImageRawDataCacheSize
+
+setImageRawDataCacheSize(value: number): void
+
+在解码前设置原始图像数据大小的图像缓存容量（以字节为单位）。如果未设置，应用程序将不会缓存任何原始图像数据。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**参数：**
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| value | number | 否 | 原始图像数据大小的值容量（以字节为单位）。 |
+
+
+## app.setImageFileCacheSize
+
+setImageFileCacheSize(value: number): void
+
+在解码前设置磁盘上的图像文件缓存大小（以字节为单位）。如果未设置，应用程序将在磁盘上缓存100MB图像文件。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**参数：**
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| value | number | 否 | 原始图像数据大小的值容量（以字节为单位）。 |
+
+## AppResponse
+
+定义AppResponse信息。
+
+**系统能力：** 以下各项对应的系统能力有所不同，详见下表。
+
+| 名称 | 参数类型 | 必填 | 说明 |
+| -------- | -------- | -------- |-------- |
+| appID6+ | string | 是 | 表示应用的包名，用于标识应用的唯一性。
**系统能力：** SystemCapability.ArkUI.ArkUI.Full|
+| appName | string | 是 | 表示应用的名称。
**系统能力：** SystemCapability.ArkUI.ArkUI.Lite|
+| versionName | string | 是 | 表示应用的版本名称。
**系统能力：** SystemCapability.ArkUI.ArkUI.Lite|
+| versionCode | number | 是 | 表示应用的版本号。
**系统能力：** SystemCapability.ArkUI.ArkUI.Lite|
+
+## ScreenOnVisibleOptions
+
+定义屏幕上可见接口的选项。
+
+**系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full
+
+| 名称 | 参数类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| visible | boolean | 否 | 是否启动保活，默认值false。 |
+| success | () => void | 否 | 接口调用成功的回调函数。 |
+| fail | (data: string, code: number) => void | 否 | 接口调用失败的回调函数。 |
+| complete | () => void | 否 | 接口调用结束的回调函数。 |
+
+## RequestFullWindowOptions
+
+定义RequestFullWindow接口的选项。
+
+**系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full
+
+| 名称 | 参数类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| duration | number | 是 | 定义动画选项的数量。 |
+
diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-mediaquery.md b/zh-cn/application-dev/reference/apis/js-apis-system-mediaquery.md
index 08ca1c593baa21327cd0ce4bf589c16fe1413025..29a7a02c3d111dc386a769351083af1b6a9b8b50 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-system-mediaquery.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-system-mediaquery.md
@@ -15,7 +15,7 @@ import mediaquery from '@system.mediaquery';
## mediaquery.matchMedia
-matchMedia(condition: string): <MediaQueryList>
+matchMedia(condition: string): MediaQueryList
根据媒体查询条件，创建MediaQueryList对象。
@@ -28,11 +28,10 @@ matchMedia(condition: string): <MediaQueryList>
| condition | string | 是 | 用于查询的条件。 |
**返回值：**
-**表1** MediaQueryList
-| 参数名 | 类型 | 说明 |
-| -------- | -------- | -------- |
-| MediaQueryList | Object | 表示创建MediaQueryList对象的属性，详情见下表 MediaQueryList说明。 |
+| 参数类型 | 说明 |
+| -------- | -------- |
+| MediaQueryList | 表示创建MediaQueryList对象的属性，详情见下表 MediaQueryList说明。 |
**示例：**
@@ -44,18 +43,47 @@ export default {
}
```
- **表2** MediaQueryList说明
+## MediaQueryEvent
-| 参数名 | 类型 | 说明 |
-| -------- | -------- | -------- |
-| matches | boolean | 如果查询条件匹配成功则返回true，否则返回值为false。只读。 |
-| media | string | 序列化的媒体查询条件，只读。 |
-| onchange | Function | matches状态变化时的执行函数。 |
+定义MediaQuery事件。
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+| 名称 | 参数类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| matches | boolean | 是 | 匹配结果。 |
+
+## MediaQueryList
+
+定义MediaQuery列表信息。
+
+### 属性
+
+**系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full
-## MediaQueryList.addListener
+| 名称 | 参数类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| media | string | 否 | 序列化媒体查询条件，该参数为只读。 |
+| matches | boolean | 是 | 匹配结果。 |
+
+### onchange
+
+onchange?: (matches: boolean) => void
+
+matches状态变化时的执行函数。
-addListener(Object): void
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| matches | boolean | 是 | matches状态变化时值。 |
+
+
+### MediaQueryList.addListener
+
+addListener(callback: (event: MediaQueryEvent) => void): void
给MediaQueryList添加回调函数，回调函数应在onShow生命周期之前添加，即需要在onInit或onReady生命周期里添加。
@@ -65,28 +93,18 @@ addListener(Object): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| callback | Function | 是 | 匹配条件发生变化的响应函数。 |
+| callback | (event: MediaQueryEvent) => void | 是 | 匹配条件发生变化的响应函数。 |
**示例：**
```
-export default {
- onReady() {
- var mMediaQueryList = mediaquery.matchMedia('(max-width: 466)');
- function maxWidthMatch(e) {
- if (e.matches) {
- // do something
- }
- }
- mMediaQueryList.addListener(maxWidthMatch);
- },
-}
+mMediaQueryList.addListener(maxWidthMatch);
```
-## MediaQueryList.removeListener
+### MediaQueryList.removeListener
-removeListener(Object): void
+removeListener(callback: (event: MediaQueryEvent) => void): void
移除MediaQueryList中的回调函数。
@@ -96,10 +114,14 @@ removeListener(Object): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| callback | Function | 是 | 匹配条件发生变化的响应函数。 |
+| callback | (event: MediaQueryEvent) => void) | 是 | 匹配条件发生变化的响应函数。 |
**示例：**
```
-query.removeListener(minWidthMatch);
-```
\ No newline at end of file
+mMediaQueryList.removeListener(maxWidthMatch);
+```
+
+
+
+
diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-router.md b/zh-cn/application-dev/reference/apis/js-apis-system-router.md
index a6264dc54e263d4a3f1223736463d624c95d31de..db092ade8ea510636bfc4f3695c6a89b51b87401 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-system-router.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-system-router.md
@@ -13,7 +13,7 @@ import router from '@system.router';
## router.push
-push(Object): void
+push(options: RouterOptions): void
跳转到应用内的指定页面。
@@ -23,8 +23,7 @@ push(Object): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| uri | string | 是 | 表示目标页面的uri，可以用以下两种格式：
- 页面绝对路径，由配置文件中pages列表提供，例如：
- pages/index/index
- pages/detail/detail
- 特殊值，如果uri的值是"/"，则跳转到首页。 |
-| params | Object | 否 | 跳转时要同时传递到目标页面的数据，跳转到目标页面后，参数可以在页面中直接使用，如this.data1(data1为跳转时params参数中的key值)。如果目标页面中已有该字段，则其值会被传入的字段值覆盖。 |
+| options | [RouterOptions](#routeroptions) | 是 | 页面路由参数，详细请参考RouterOptions。|
**示例：**
@@ -68,7 +67,7 @@ export default {
## router.replace
-replace(Object): void
+replace(options: RouterOptions): void
用应用内的某个页面替换当前页面，并销毁被替换的页面。
@@ -78,8 +77,7 @@ replace(Object): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| uri | string | 是 | 目标页面的uri，可以是以下的两种格式：
- 页面绝对路径，由配置文件中pages列表提供，例如：
- pages/index/index
- pages/detail/detail
- 特殊值，如果uri的值是"/"，则跳转到首页。 |
-| params | Object | 否 | 跳转时要同时传递到目标页面的数据，跳转到目标页面后，参数可以在页面中直接使用，如this.data1(data1为跳转时params参数中的key值)。如果目标页面中已有该字段，则其值会被传入的字段值覆盖。 |
+| options | [RouterOptions](#routeroptions) | 是 | 页面路由参数，详细请参考RouterOptions。|
**示例：**
@@ -112,7 +110,7 @@ export default {
## router.back
-back(Object): void
+back(options?: BackRouterOptions): void
返回上一页面或指定的页面。
@@ -122,8 +120,7 @@ back(Object): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| uri | string | 否 | 返回到指定uri的界面，如果页面栈上没有uri页面，则不响应该情况。如果uri未设置，则返回上一页。 |
-| params | Object | 否 | 跳转时要同时传递到目标页面的数据 |
+| options | [BackRouterOptions](#backrouteroptions) | 是 | 详细请参考BackRouterOptions。|
**示例：**
@@ -183,6 +180,20 @@ export default {
>  **说明：**
> 示例中的uri字段是页面路由，由配置文件中的pages列表指定。
+## router.getParams
+
+getParams(): ParamsInterface
+
+获取当前页面的参数信息。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+**返回值：**
+
+| 类型 | 说明 |
+| -------- | -------- |
+| [ParamsInterface](#paramsinterface) | 详细请参见ParamsInterface。|
+
## router.clear
clear(): void
@@ -228,20 +239,17 @@ export default {
## router.getState
-getState(): <RouterState>
+getState(): RouterState
获取当前页面的状态信息。
**系统能力：** SystemCapability.ArkUI.ArkUI.Full
**返回值：**
-**表1** RouterState
-| 参数名 | 类型 | 说明 |
-| -------- | -------- | -------- |
-| index | number | 表示当前页面在页面栈中的索引。
>  **说明：**
> 从栈底到栈顶，index从1开始递增。 |
-| name | string | 表示当前页面的名称，即对应文件名。 |
-| path | string | 表示当前页面的路径。 |
+| 参数类型 | 说明 |
+| -------- | -------- |
+| [RouterState](#routerstate) | 详细请参见RouterState。|
**示例：**
@@ -258,7 +266,7 @@ export default {
## router.enableAlertBeforeBackPage6+
-enableAlertBeforeBackPage(Object): void
+enableAlertBeforeBackPage(options: EnableAlertBeforeBackPageOptions): void
开启页面返回询问对话框。
@@ -268,10 +276,7 @@ enableAlertBeforeBackPage(Object): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| message | string | 是 | 询问对话框内容。 |
-| success | () => void | 否 | 接口调用成功的回调函数。 |
-| fail | () => void | 否 | 接口调用失败的回调函数。 |
-| complete | () => void | 否 | 接口调用结束的回调函数。 |
+| options | [EnableAlertBeforeBackPageOptions](#EnableAlertbeforebackpageoptions) | 是 | 详细请参见EnableAlertBeforeBackPageOptions。 |
**示例：**
@@ -293,7 +298,7 @@ export default {
## router.disableAlertBeforeBackPage6+
-disableAlertBeforeBackPage(Object): void
+disableAlertBeforeBackPage(options?: DisableAlertBeforeBackPageOptions): void
禁用页面返回询问对话框。
@@ -303,9 +308,7 @@ disableAlertBeforeBackPage(Object): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| success | () => void | 否 | 接口调用成功的回调函数。 |
-| fail | () => void | 否 | 接口调用失败的回调函数。 |
-| complete | () => void | 否 | 接口调用结束的回调函数。 |
+| options | [DisableAlertBeforeBackPageOptions](#disablealertbeforebackpageoptions)| 否 | 详细请参见DisableAlertBeforeBackPageOptions。 |
**示例：**
@@ -324,3 +327,68 @@ export default {
}
```
+## RouterOptions
+
+定义路由器的选项。
+
+**系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Lite
+
+| 名称 | 参数类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| uri | string | 是 | 目标页面的uri，可以是以下的两种格式：
1. 页面的绝对路径，由config.json文件中的页面列表提供。例如：
- pages/index/index
-pages/detail/detail
2. 特定路径。如果URI为斜杠（/），则显示主页。 |
+| params | Object | 否 | 跳转时要同时传递到目标页面的数据，跳转到目标页面后，参数可以在页面中直接使用，如this.data1(data1为跳转时params参数中的key值)。如果目标页面中已有该字段，则其值会被传入的字段值覆盖。 |
+
+
+## BackRouterOptions
+
+定义路由器返回的选项。
+
+**系统能力：** 以下各项对应的系统能力有所不同，详见下表。
+
+| 名称 | 参数类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| uri | string | 否 | 返回到指定uri的界面，如果页面栈上没有uri页面，则不响应该情况。如果uri未设置，则返回上一页。
**系统能力：** SystemCapability.ArkUI.ArkUI.Full|
+| params | Object | 否 | 跳转时要同时传递到目标页面的数据。
**系统能力：** SystemCapability.ArkUI.ArkUI.Lite|
+
+## RouterState
+
+定义路由器的状态。
+
+**系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full
+
+| 名称 | 参数类型 | 必填 | 说明 |
+| -------- | -------- | -------- |-------- |
+| index | number | 是 | 表示当前页面在页面栈中的索引。从栈底到栈顶，index从1开始递增。 |
+| name | string | 是 | 表示当前页面的名称，即对应文件名。 |
+| path | string | 是 | 表示当前页面的路径。 |
+
+## EnableAlertBeforeBackPageOptions6+
+
+定义EnableAlertBe beforeBackPage选项。
+
+**系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full
+
+| 名称 | 参数类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| message | string | 是 | 询问对话框内容。 |
+| success | (errMsg: string) => void | 否 | 弹出对话框时调用，errMsg表示返回信息。 |
+| fail | (errMsg: string) => void | 否 | 接口调用失败的回调函数，errMsg表示返回信息。 |
+| complete | () => void | 否 | 接口调用结束的回调函数。 |
+
+## DisableAlertBeforeBackPageOptions6+
+
+定义DisableAlertBeforeBackPage参数选项。
+
+**系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full
+
+| 名称 | 参数类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| success | (errMsg: string) => void | 否 | 弹出对话框时调用，errMsg表示返回信息。 |
+| fail | (errMsg: string) => void | 否 | 接口调用失败的回调函数，errMsg表示返回信息。|
+| complete | () => void | 否 | 接口调用结束的回调函数。 |
+
+## ParamsInterface
+
+| 名称 | 参数类型 | 说明 |
+| -------- | -------- | -------- |
+| [key: string] | Object| 路由参数列表。 |
diff --git a/zh-cn/application-dev/reference/apis/js-apis-treemap.md b/zh-cn/application-dev/reference/apis/js-apis-treemap.md
index d49b3e210e250dac04158bf37f36622d79885db5..2af66500fe33f80c927be0ce08e8b8b0a5bff44d 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-treemap.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-treemap.md
@@ -195,7 +195,7 @@ let result = treeMap.getLastKey();
setAll(map: TreeMap): void
-将一个treemap中的所有元素组添加到另一个treeMap中。
+将一个TreeMap中的所有元素组添加到另一个TreeMap中。
**参数：**
@@ -218,7 +218,7 @@ treeMap.setAll(map);
set(key: K, value: V): Object
-向treemap中添加一组数据。
+向容器中添加一组数据。
**参数：**
@@ -330,7 +330,7 @@ let result = treeMap.getHigherKey("sdfs");
replace(key: K, newValue: V): boolean
-对TreeMap中一组数据进行更新（替换）。
+对容器中一组数据进行更新（替换）。
**参数：**
@@ -358,7 +358,7 @@ let result = treeMap.replace("sdfs", 357);
clear(): void
-清除TreeMap中的所有元素，并把length置为0。
+清除容器中的所有元素，并把length置为0。
**示例：**
diff --git a/zh-cn/application-dev/reference/apis/js-apis-treeset.md b/zh-cn/application-dev/reference/apis/js-apis-treeset.md
index 473db461ba74cc8b961402595ee66d9abea2c3d7..b55013bd1deb75c13f43b13028724d54f25d2cc4 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-treeset.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-treeset.md
@@ -139,7 +139,7 @@ let result = treeSet.getLastValue();
add(value: T): boolean
-向TreeSet中添加一组数据。
+向容器中添加一组数据。
**参数：**
diff --git a/zh-cn/application-dev/website.md b/zh-cn/application-dev/website.md
index 207bf47591d88f88ddf0a5f7fe0d3ee0a6f174e2..a723fb9ccdacc5ed95a57600b68269c2497c59d3 100644
--- a/zh-cn/application-dev/website.md
+++ b/zh-cn/application-dev/website.md
@@ -18,7 +18,7 @@
- [应用开发包结构说明](quick-start/package-structure.md)
- [资源文件的分类](quick-start/basic-resource-file-categories.md)
- 开发
- - [Ability开发](ability/Readme-CN.md)
+ - Ability开发
- [Ability框架概述](ability/ability-brief.md)
- FA模型
- [FA模型综述](ability/fa-brief.md)
@@ -35,7 +35,7 @@
- 其他
- [WantAgent使用指导](ability/wantagent.md)
- [Ability助手使用指导](ability/ability-assistant-guidelines.md)
- - [UI开发](ui/Readme-CN.md)
+ - UI开发
- [方舟开发框架（ArkUI）概述](ui/arkui-overview.md)
- 基于JS扩展的类Web开发范式
- [概述](ui/ui-js-overview.md)
diff --git a/zh-cn/device-dev/driver/driver-peripherals-light-des.md b/zh-cn/device-dev/driver/driver-peripherals-light-des.md
index 2e0ba1e5c9cdbf36e5eb07d1e83e241d463aed35..eea5df18f69350273e96ed602b35ce8e764d4d24 100644
--- a/zh-cn/device-dev/driver/driver-peripherals-light-des.md
+++ b/zh-cn/device-dev/driver/driver-peripherals-light-des.md
@@ -1,17 +1,5 @@
# LIGHT
-- [概述](##概述)
- - [功能简介](###功能简介)
- - [运作机制](###运作机制)
-
-- [开发指导](##开发指导)
-
- - [场景介绍](###场景介绍)
-
- - [接口说明](###接口说明)
- - [开发步骤](###开发步骤)
- - [调测验证](###调测验证)
-
## 概述
@@ -21,7 +9,7 @@
**图 1** Light驱动模型图
-
+
### 运作机制
@@ -29,7 +17,7 @@
**图 2** Light驱动运行图
-
+
Light驱动模型以标准系统Hi3516DV300为例，介绍整个驱动加载及运行流程：
diff --git a/zh-cn/device-dev/driver/driver-platform-pin-develop.md b/zh-cn/device-dev/driver/driver-platform-pin-develop.md
index 3e098c1fd43fb59d5a347958817e681e76ede03b..890e385759a8fc987a2ec306b07f8375ecf373c5 100755
--- a/zh-cn/device-dev/driver/driver-platform-pin-develop.md
+++ b/zh-cn/device-dev/driver/driver-platform-pin-develop.md
@@ -1,21 +1,12 @@
-# PIN
+# PIN
-- [概述](#section1_PinDevelop)
- - [功能简介](#section2_PinDevelop)
- - [基本概念](#section3_PinDevelop)
- - [运作机制](#section4_PinDevelop)
- - [约束与限制](#section5_PinDevelop)
-- [使用指导](#section6_PinDevelop)
- - [场景介绍](#section7_PinDevelop)
- - [接口说明](#section8_PinDevelop)
- - [开发步骤](#section9_PinDevelop)
-## 概述
+## 概述
-### 功能简介
+### 功能简介
PIN即管脚控制器，用于统一管理各SoC厂商管脚资源，对外提供管脚复用功能。
-### 基本概念
+### 基本概念
PIN是一个软件层面的概念，目的是为了统一各SoC厂商PIN管脚管理，对外提供管脚复用功能，配置PIN管脚的电气特性。
@@ -27,26 +18,26 @@ PIN是一个软件层面的概念，目的是为了统一各SoC厂商PIN管脚
由于芯片自身的引脚数量有限，无法满足日益增多的外接需求。此时可以通过软件层面的寄存器设置，让引脚工作在不同的状态，从而实现相同引脚完成不同功能的目的。
-### 运作机制
+### 运作机制
-在HDF框架中，PIN模块暂不支持用户态，所以不需要发布服务，接口适配模式采用无服务模式（如图1所示），用于不需要在用户态提供API的设备类型，或者没有用户态和内核区分的OS系统，其关联方式是DevHandle直接指向设备对象内核态地址（DevHandle是一个void类型指针）。
+在HDF框架中，PIN模块暂不支持用户态，所以不需要发布服务，接口适配模式采用无服务模式（如[图1](#无服务模式结构图)所示），用于不需要在用户态提供API的设备类型，或者没有用户态和内核区分的OS系统，其关联方式是DevHandle直接指向设备对象内核态地址（DevHandle是一个void类型指针）。
PIN模块各分层作用：接口层提供获取PIN管脚、设置PIN管脚推拉方式、获取PIN管脚推拉方式、设置PIN管脚推拉强度、获取PIN管脚推拉强度、设置PIN管脚功能、获取PIN管脚功能、释放PIN管脚的接口。核心层主要提供PIN管脚资源匹配，PIN管脚控制器的添加、移除以及管理的能力，通过钩子函数与适配层交互。适配层主要是将钩子函数的功能实例化，实现具体的功能。
**图 1** 无服务模式结构图
-
+
-### 约束与限制
+### 约束与限制
- PIN模块目前仅支持轻量和小型系统内核（LiteOS）。
+PIN模块目前仅支持轻量和小型系统内核（LiteOS）。
-## 开发指导
+## 开发指导
-### 场景介绍
+### 场景介绍
PIN模块主要用于管脚资源管理。在各SoC厂商对接HDF框架时，需要来适配PIN驱动。
-### 接口说明
+### 接口说明
通过以下PinCntlrMethod中的函数调用PIN驱动对应的函数。
PinCntlrMethod定义：
@@ -73,7 +64,7 @@ struct PinCntlrMethod {
| SetPinFunc | **cntlr**：结构体指针，核心层Pin控制器；
**index**：uint32_t变量，管脚索引号；
**funcName**：char指针常量，传入Pin管脚功能； | 无 | HDF_STATUS相关状态 | PIN设置管脚功能 |
| GetPinFunc | **cntlr**：结构体指针，核心层Pin控制器；
**index**：uint32_t变量，管脚索引号； | **funcName**：char双重指针常量，传出Pin管脚功能； | HDF_STATUS相关状态 | PIN获取管脚功能 |
-### 开发步骤
+### 开发步骤
PIN模块适配包含以下四个步骤：
@@ -85,7 +76,7 @@ PIN模块适配包含以下四个步骤：
1. **实例化驱动入口：**
- 实例化HdfDriverEntry结构体成员。
- 驱动开发首先需要实例化驱动入口，驱动入口必须为HdfDriverEntry（在 hdf_device_desc.h 中定义）类型的全局变量，且moduleName要和device_info.hcs中保持一致。
+ 驱动开发首先需要实例化驱动入口，驱动入口必须为HdfDriverEntry（在 hdf_device_desc.h 中定义）类型的全局变量，且moduleName要和device_info.hcs中保持一致。
- 调用HDF_INIT将HdfDriverEntry实例化对象注册到HDF框架中。
一般在加载驱动时HDF会先调用Init函数加载该驱动。当Init调用异常时，HDF框架会调用Release释放驱动资源并退出。
@@ -292,7 +283,7 @@ PIN模块适配包含以下四个步骤：
HdfDeviceObject这个是整个驱动对外暴露的接口参数，具备HCS配置文件的信息。
返回值：
- HDF\_STATUS相关状态 （下表为部分展示，如需使用其他状态，可见/drivers/framework/include/utils/hdf\_base.h中HDF\_STATUS 定义）。
+ HDF\_STATUS相关状态（下表为部分展示，如需使用其他状态，可见/drivers/framework/include/utils/hdf\_base.h中HDF\_STATUS 定义）。
| **状态(值)** | **问题描述** |
| ---------------------- | -------------- |
diff --git a/zh-cn/device-dev/porting/Readme-CN.md b/zh-cn/device-dev/porting/Readme-CN.md
index 8154f0b712fd9c0823295e897d14b69a796d61e0..014cfa66bcf060783e552542de6a7f9f859dee8b 100755
--- a/zh-cn/device-dev/porting/Readme-CN.md
+++ b/zh-cn/device-dev/porting/Readme-CN.md
@@ -52,7 +52,7 @@ repo init -u https://gitee.com/openharmony-sig/manifest.git -b master -m devboar
- [标准系统芯片移植指导](standard-system-porting-guide.md)
- [标准系统移植指南](standard-system-porting-guide.md)
- [一种快速移植OpenHarmony Linux内核的方法](porting-linux-kernel.md)
-- [轻量和小型系统三方库移植指导]( porting-thirdparty.md)
+- [轻量和小型系统三方库移植指导](porting-thirdparty.md)
- [概述](porting-thirdparty-overview.md)
- [CMake方式组织编译的库移植](porting-thirdparty-cmake.md)
- [Makefile方式组织编译的库移植](porting-thirdparty-makefile.md)
diff --git a/zh-cn/device-dev/porting/porting-linux-kernel.md b/zh-cn/device-dev/porting/porting-linux-kernel.md
index 1139514ab02e862a9d5e2a59ff9bcecab4c640c1..f54b3a7b8d3ebb42b858459d7783f44e0423f85b 100644
--- a/zh-cn/device-dev/porting/porting-linux-kernel.md
+++ b/zh-cn/device-dev/porting/porting-linux-kernel.md
@@ -1,16 +1,5 @@
# 一种快速移植OpenHarmony Linux内核的方法
-- [移植概述](#移植概述)
-- [移植到三方芯片平台的整体思路](#移植到三方芯片平台的整体思路)
- - [内核态层和用户态层](#内核态层和用户态层)
- - [获得内核态层的两种方法](#获得内核态层的两种方法)
- - [借助已有Linux内核来移植OpenHarmony的流程](#section1233187263176)
-- [移植到三方芯片平台的步骤](#移植到三方芯片平台的步骤)
- - [整体构建环境的准备](#整体构建环境的准备)
- - [内核态基础代码的移植](#内核态基础代码的移植)
- - [内核态必选特性HDF的移植](#内核态必选特性hdf的移植)
- - [编译Image](#编译image)
- - [编译和运行HDF测试用例（可选）](#编译和运行hdf测试用例-可选-)
## 移植概述
diff --git a/zh-cn/device-dev/quick-start/quickstart-lite-package-environment.md b/zh-cn/device-dev/quick-start/quickstart-lite-package-environment.md
index 38f2e8b970ae52e01a372a44dd8607184bf46003..42c4c162fb6fd745b154dff2ac71c98e27f04eb5 100644
--- a/zh-cn/device-dev/quick-start/quickstart-lite-package-environment.md
+++ b/zh-cn/device-dev/quick-start/quickstart-lite-package-environment.md
@@ -1,8 +1,5 @@
# 使用安装包方式搭建编译环境
-- [安装必要的库和工具](#section108201740181219)
-- [安装hb](#section15794154618411)
-- [安装LLVM\(仅OpenHarmony\_v1.x分支/标签需要\)](#section711117144296)
使用安装包方式搭建Ubuntu编译环境步骤如下：
diff --git a/zh-cn/device-dev/subsystems/subsys-toolchain-hiperf.md b/zh-cn/device-dev/subsystems/subsys-toolchain-hiperf.md
index f90216596234bac89303afbc7053b4b5b6988544..8a5476185d5eed517aeff04f49d4efc3e4f3f710 100644
--- a/zh-cn/device-dev/subsystems/subsys-toolchain-hiperf.md
+++ b/zh-cn/device-dev/subsystems/subsys-toolchain-hiperf.md
@@ -1,17 +1,6 @@
# hiperf 使用指南
-- [list 命令](#list-命令)
- - [参数说明](#参数说明)
- - [使用示例](#使用示例)
-- [stat 命令](#stat-命令)
- - [参数说明](#参数说明)
- - [使用示例](#使用示例)
- - [字段说明](#字段说明)
-- [record 命令](#record-命令)
- - [参数说明](#参数说明)
- - [使用示例](#使用示例)
-- [report 命令](#report-命令)
-- [使用示例](#使用示例)
+
hiperf是为开发人员提供性能采样分析的工具，基于内核perf机制进行的用户态能力的扩展，可以对指定的程序或者整个系统进行性能采样。
diff --git a/zh-cn/device-dev/website.md b/zh-cn/device-dev/website.md
index 586eb494bbed246fdd0feb2e51bc1bfd313e0e66..d0b44faff3234d77c7397add1d1db00087f98068 100644
--- a/zh-cn/device-dev/website.md
+++ b/zh-cn/device-dev/website.md
@@ -362,7 +362,7 @@
- [DFX](subsystems/subsys-dfx.md)
- 专题
- - [HPM Part](hpm-part/Readme-CN.md)
+ - HPM Part
- [HPM Part介绍](hpm-part/hpm-part-about.md)
- [HPM Part开发指导](hpm-part/hpm-part-development.md)
- [HPM Part参考](hpm-part/hpm-part-reference.md)
@@ -388,7 +388,7 @@
- 参考
- - [常见问题-设备开发](faqs/Readme-CN.md)
+ - 常见问题-设备开发
- [常见问题概述](faqs/faqs-overview.md)
- [环境搭建常见问题](faqs/faqs-environment-setup.md)
- [编译构建子系统常见问题](faqs/faqs-building.md)
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/changelog-v3.1-release.md b/zh-cn/release-notes/api-change/v3.1-Release/changelog-v3.1-release.md
new file mode 100644
index 0000000000000000000000000000000000000000..570a1c598c434e7aed19caab163158370a293eb3
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/changelog-v3.1-release.md
@@ -0,0 +1,16 @@
+# ChangeLog
+**关键的接口/组件变更**
+## XXX子系统
+### cl.rpc.1 sendRequest返回值类型变更
+
+#### 变更影响
+……
+
+#### 关键的接口/组件变更
+**模块**
+**接口**
+**变更后接口**
+……
+
+#### 适配指导
+……
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-ability.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-ability.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-ability.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-access-control.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-access-control.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-access-control.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-accessibility.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-accessibility.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-accessibility.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-account.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-account.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-account.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-ace.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-ace.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-ace.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-battery.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-battery.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-battery.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-bundle.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-bundle.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-bundle.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-communicate.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-communicate.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-communicate.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-complier-and-runtime.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-complier-and-runtime.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-complier-and-runtime.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-config-policy.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-config-policy.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-config-policy.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-dfx.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-dfx.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-dfx.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-distributed-data.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-distributed-data.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-distributed-data.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-LTS/js-apidiff-v3.1-LTS.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-distributed-hardware.md
similarity index 100%
rename from zh-cn/release-notes/api-change/v3.1-LTS/js-apidiff-v3.1-LTS.md
rename to zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-distributed-hardware.md
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-event-and-notification.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-event-and-notification.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-event-and-notification.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-file-management.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-file-management.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-file-management.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-geolocation.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-geolocation.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-geolocation.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-global.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-global.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-global.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-graphic.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-graphic.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-graphic.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-misc.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-misc.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-misc.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-multi-modal-input.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-multi-modal-input.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-multi-modal-input.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-multimedia.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-multimedia.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-multimedia.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-network.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-network.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-network.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-recovery.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-recovery.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-recovery.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-resource-scheduler.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-resource-scheduler.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-resource-scheduler.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-security.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-security.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-security.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-sensor.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-sensor.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-sensor.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-settings.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-settings.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-settings.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-soft-bus.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-soft-bus.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-soft-bus.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-telephony.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-telephony.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-telephony.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-update.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-update.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-update.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-usb.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-usb.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-usb.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-user-authentication.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-user-authentication.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-user-authentication.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-v3.1-release.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-v3.1-release.md
new file mode 100644
index 0000000000000000000000000000000000000000..4c655b742d78cf5c842eb8c132e3352e2fc8fbef
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-v3.1-release.md
@@ -0,0 +1,37 @@
+# JS API Diff
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本的JS API变更，参见各子系统的详细记录：
+- [元能力](js-apidiff-ability.md)
+- [程序访问控制](js-apidiff-access-control.md)
+- [无障碍](js-apidiff-accessibility.md)
+- [帐号](js-apidiff-account.md)
+- [ArkUI开发框架](js-apidiff-ace.md)
+- [电源服务](js-apidiff-battery.md)
+- [包管理](js-apidiff-bundle.md)
+- [基础通信](js-apidiff-communicate.md)
+- [语言编译器运行时](js-apidiff-complier-and-runtime.md)
+- [定制](js-apidiff-config-policy.md)
+- [DFX](js-apidiff-dfx.md)
+- [分布式数据管理](js-apidiff-distributed-data.md)
+- [分布式硬件](js-apidiff-distributed-hardware.md)
+- [事件通知](js-apidiff-event-and-notification.md)
+- [文件管理](js-apidiff-file-management.md)
+- [位置服务](js-apidiff-geolocation.md)
+- [全球化](js-apidiff-global.md)
+- [图形图像](js-apidiff-graphic.md)
+- [Misc软件服务](js-apidiff-misc.md)
+- [多模输入](js-apidiff-multi-modal-input.md)
+- [OS媒体软件](js-apidiff-multimedia.md)
+- [网络管理](js-apidiff-network.md)
+- [启动恢复](js-apidiff-recovery.md)
+- [资源调度](js-apidiff-resource-scheduler.md)
+- [安全基础能力](js-apidiff-security.md)
+- [泛Sensor服务](js-apidiff-sensor.md)
+- [应用](js-apidiff-settings.md)
+- [软总线](js-apidiff-soft-bus.md)
+- [电话服务](js-apidiff-telephony.md)
+- [升级服务](js-apidiff-update.md)
+- [USB服务](js-apidiff-usb.md)
+- [用户IAM](js-apidiff-user-authentication.md)
+- [窗口管理](js-apidiff-window.md)
+
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-window.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-window.md
new file mode 100644
index 0000000000000000000000000000000000000000..dce4c7f9e083fd237d29ff4bc4ff0ca53ba0c2f4
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-window.md
@@ -0,0 +1,14 @@
+# xxx子系统JS API变更
+
+OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，XXX子系统的API变更如下:
+
+## 接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/native-apidiff-v3.1-release.md b/zh-cn/release-notes/api-change/v3.1-Release/native-apidiff-v3.1-release.md
new file mode 100644
index 0000000000000000000000000000000000000000..a9dcb0efdc5d35935032b5fef431320686d37fab
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/native-apidiff-v3.1-release.md
@@ -0,0 +1,16 @@
+# Native API 差异报告
+
+OpenHarmony 3.1 Release相较于OpenHarmony 3.0 LTS版本的API变更如下:
+
+## 标准系统接口变更
+
+| 模块名称 | 接口名称 | 变更类型 | 变更说明 |
+| -------- | -------- | -------- | -------- |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
+| | | | |
\ No newline at end of file
diff --git a/zh-cn/release-notes/api-change/v3.1-Release/readme.md b/zh-cn/release-notes/api-change/v3.1-Release/readme.md
new file mode 100644
index 0000000000000000000000000000000000000000..9f21003ae9cee469038dd19302d295d56cb8389a
--- /dev/null
+++ b/zh-cn/release-notes/api-change/v3.1-Release/readme.md
@@ -0,0 +1,11 @@
+# Readme
+
+本目录记录了OpenHarmony 3.1 Release版本相较OpenHarmony 3.0 LTS版本的API变化。
+
+API详细变更记录如下：
+- API差异报告
+ API差异报告记录了API的变更情况，包括新增、变更、废弃、删除。
+ - [JS API差异报告](js-apidiff-v3.1-release.md)
+ - [Native API差异报告](native-apidiff-v3.1-release.md)
+- [变更说明](changelog-v3.1-release.md)
+ 变更说明重点记录因API变更对开发者调用API的行为产生的影响，并针对变更影响提供适配指导。