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

zh-cn/application-dev/arkts-utils/linear-container.md

@@ -20,7 +20,7 @@ ArrayList进行增、删、改、查操作的相关API如下：
 | 增加元素 | 通过add(element: T)函数每次在数组尾部增加一个元素。 |
 | 增加元素 | 通过insert(element: T, index: number)在指定位置插入一个元素。 |
 | 访问元素 | 通过arr\[index]获取指定index对应的value值，通过指令获取保证访问速度。 |
-| 访问元素 | 通过forEach(callbackFn: (value: T, index?: number, vector?: Vector<T>) => void, thisArg?: Object): void访问整个ArrayList容器的元素。 |
+| 访问元素 | 通过forEach(callbackFn: (value: T, index?: number, arrlist?: ArrayList<T>) => void, thisArg?: Object): void访问整个ArrayList容器的元素。 |
 | 访问元素 | 通过\[Symbol.iterator]():IterableIterator<T>迭代器进行数据访问。 |
 | 修改元素 | 通过arr\[index] = xxx修改指定index位置对应的value值。 |
 | 删除元素 | 通过remove(element: T)删除第一个匹配到的元素。 |
@@ -46,7 +46,7 @@ Vector进行增、删、改、查操作的相关API如下：
 | 访问元素 | 通过getLastElement()获取最后一个元素。 |
 | 访问元素 | 通过getlndexOf(element:T)获取第一个匹配到元素的位置。 |
 | 访问元素 | 通过getLastlndexOf(element:T)获取最后一个匹配到元素的位置。 |
-| 访问元素 | 通过forEach(callbackfn: (value: T, index?: number, Vector?: Vector<T>) => thisArg?: Object)访问整个Vector的元素。 |
+| 访问元素 | 通过forEach(callbackFn: (value: T, index?: number, Vector?: Vector<T>) => void, thisArg?: Object)访问整个Vector的元素。 |
 | 访问元素 | 通过\[Symbol.iterator]():IterableIterator<T>迭代器进行数据访问。 |
 | 修改元素 | 通过vec\[index]=xxx修改指定index位置对应的value值。 |
 | 修改元素 | 通过set(index:number,element:T)修改指定index位置的元素值为element。 |
@@ -79,10 +79,9 @@ List和[LinkedList](../reference/apis/js-apis-linkedlist.md)相比，LinkedList
 | 访问元素 | 通过forEach(callbackfn: (value:T, index?: number, list?: List<T>)=> void,thisArg?: Object)访问整个List的元素。 |
 | 修改元素 | 通过list\[index] = xxx修改指定index位置对应的value值。 |
 | 修改元素 | 通过set(index:number, element: T)修改指定index位置的元素值为element。 |
-| 修改元素 | 通过replaceAllElements(callbackfn:(value: T,index?: number,list?: List<T>)=>T,thisArg?: Object)对List内元素进行替换操作。 |
+| 修改元素 | 通过replaceAllElements(callbackFn:(value: T,index?: number,list?: List<T>)=>T,thisArg?: Object)对List内元素进行替换操作。 |
 | 删除元素 | 通过removeBylndex(index:number)删除index位置对应的value值。 |
 | 删除元素 | 通过remove(element:T)删除第一个匹配到的元素。 |
-| 删除元素 | 通过removeByRange(fromIndex:number,toIndex:number)删除指定范围内的元素。 |
 
 
 ## LinkedList
@@ -100,17 +99,16 @@ LinkedList和[ArrayList](../reference/apis/js-apis-arraylist.md)相比，插入
 | 操作 | 描述 |
 | ---------- | ------ |
 | 增加元素 | 通过add(element: T)函数每次在数组尾部增加一个元素。 |
-| 增加元素 | 通过insert(element: T, index: number)在指定位置插入一个元素。 |
+| 增加元素 | 通过insert(index: number, element: T)在指定位置插入一个元素。 |
 | 访问元素 | 通过list\[index]获取指定index对应的value值，通过指令获取保证访问速度。 |
 | 访问元素 | 通过get(index: number)获取指定index位置对应的元素。 |
 | 访问元素 | 通过getFirst()获取第一个元素。 |
 | 访问元素 | 通过getLast()获取最后一个元素。 |
 | 访问元素 | 通过getlndexOf(element: T)获取第一个匹配到元素的位置。 |
-| 访问元素 | 通过getLastlndexOf(element: T)获取最后一个匹配到元素的位置 |
-| 访问元素 | 通过forEach(callbackfn: (value: T, index?: number, list?: LinkedList<T>) => void,thisArg?: Object)访问整个LinkedList的元素。 |
+| 访问元素 | 通过getLastlndexOf(element: T)获取最后一个匹配到元素的位置。 |
+| 访问元素 | 通过forEach(callbackFn: (value: T, index?: number, list?: LinkedList<T>) => void, thisArg?: Object)访问整个LinkedList的元素。 |
 | 修改元素 | 通过list\[index]=xxx修改指定index位置对应的value值。 |
 | 修改元素 | 通过set(index: number,element: T)修改指定index位置的元素值为element。 |
-| 修改元素 | 通过replaceAllElements(callbackfn:(value: T,index?: number,list?: LinkedList<T>)=>T,thisArg?: Object)对List内元素进行替换操作。 |
 | 删除元素 | 通过removeBylndex(index: number)删除index位置对应的value值。 |
 | 删除元素 | 通过remove(element: T)删除第一个匹配到的元素。 |
 
@@ -137,9 +135,9 @@ Deque进行增、删、改、查操作的相关API如下：
 | 访问元素 | 通过getLast()获取队尾元素的value值，但是不进行出队操作。 |
 | 访问元素 | 通过popFirst()获取队首元素的value值，并进行出队操作。 |
 | 访问元素 | 通过popLast()获取队尾元素的value值，并进行出队操作。 |
-| 访问元素 | 通过forEach(callbackfn:(value: T, index?: number, deque?: Deque<T>) => void,thisArg?: Object)访问整个Deque的元素。 |
+| 访问元素 | 通过forEach(callbackFn:(value: T, index?: number, deque?: Deque<T>) => void, thisArg?: Object)访问整个Deque的元素。 |
 | 访问元素 | 通过\[Symbol.iterator]():IterableIterator<T>迭代器进行数据访问。 |
-| 修改元素 | 通过forEach(callbackfn:(value: T, index?: number, deque?: Deque<T>)=> void,thisArg?: Object)对队列进行修改操作。 |
+| 修改元素 | 通过forEach(callbackFn:(value: T, index?: number, deque?: Deque<T>)=> void, thisArg?: Object)对队列进行修改操作。 |
 | 删除元素 | 通过popFirst()对队首元素进行出队操作并删除。 |
 | 删除元素 | 通过popLast()对队尾元素进行出队操作并删除。 |
 
@@ -163,9 +161,9 @@ Queue进行增、删、改、查操作的相关API如下：
 | 增加元素 | 通过add(element: T)函数每次在队尾增加一个元素。 |
 | 访问元素 | 通过getFirst()获取队首元素的value值，但是不进行出队操作。 |
 | 访问元素 | 通过pop()获取队首元素的value值，并进行出队操作。 |
-| 访问元素 | 通过forEach(callbackfn: (value: T, index?: number, queue?: Queue<T>) => void,thisArg?: Object)访问整个Queue的元素。 |
+| 访问元素 | 通过forEach(callbackFn: (value: T, index?: number, queue?: Queue<T>) => void,thisArg?: Object)访问整个Queue的元素。 |
 | 访问元素 | 通过\[Symbol.iterator]():IterableIterator<T>迭代器进行数据访问。 |
-| 修改元素 | 通过forEach(callbackfn:(value: T, index?: number, queue?: Queue<T>) => void,thisArg?: Object)对队列进行修改操作。 |
+| 修改元素 | 通过forEach(callbackFn:(value: T, index?: number, queue?: Queue<T>) => void,thisArg?: Object)对队列进行修改操作。 |
 | 删除元素 | 通过pop()对队首进行出队操作并删除。 |
 
 
@@ -186,10 +184,10 @@ Stack进行增、删、改、查操作的相关API如下：
 | 增加元素 | 通过push(item: T)函数每次在栈顶增加一个元素。 |
 | 访问元素 | 通过peek()获取栈顶元素的value值，但是不进行出栈操作。 |
 | 访问元素 | 通过pop()获取栈顶的value值，并进行出栈操作。 |
-| 访问元素 | 通过forEach(callbackfn: (value: T, index?: number, stack?: Stack<T>) => void, thisArg?: Object)访问整个Stack的元素。 |
+| 访问元素 | 通过forEach(callbackFn: (value: T, index?: number, stack?: Stack<T>) => void, thisArg?: Object)访问整个Stack的元素。 |
 | 访问元素 | 通过\[Symbol.iterator]():IterableIterator<T>迭代器进行数据访问。 |
 | 访问元素 | 通过locate(element: T)获取元素对应的位置。 |
-| 修改元素 | 通过forEach(callbackfn:(value: T, index?: number, stack?: Stack<T>) => void,thisArg?: Object)对栈内元素进行修改操作。 |
+| 修改元素 | 通过forEach(callbackFn:(value: T, index?: number, stack?: Stack<T>) => void, thisArg?: Object)对栈内元素进行修改操作。 |
 | 删除元素 | 通过pop()对栈顶进行出栈操作并删除。 |
 
 

zh-cn/application-dev/quick-start/module-configuration-file.md

@@ -745,8 +745,8 @@ dependencies标签示例：
 | 属性名称    | 含义                           | 数据类型 | 是否可缺省 |
 | ----------- | ------------------------------ | -------- | ---------- |
 | uri | 标识用于访问该数据代理的uri，不同的数据代理配置的uri不可重复，且需要满足`datashareproxy://当前应用包名/xxx`的格式。  | 字符串   | 不可缺省。 |
-| requiredReadPermission  | 标识从该数据代理中读取数据所需要的权限，非系统应用配置的权限的等级需为system_basic或system_core，系统应用可以不配置权限，且权限的等级没有限制。权限等级可以参考[权限列表](../security/permission-list.md)。 | 字符串   | 可缺省，缺省值为空。 |
-| requiredWritePermission | 标识向该数据代理中读取数据所需要的权限。非系统应用配置的权限的等级需为system_basic或system_core，系统应用可以不配置权限，且权限的等级没有限制。权限等级可以参考[权限列表](../security/permission-list.md)。 | 字符串   | 可缺省，缺省值为空。 |
+| requiredReadPermission  | 标识从该数据代理中读取数据所需要的权限，若不配置，则其他应用无法使用该代理。非系统应用配置的权限的等级需为system_basic或system_core，系统应用配置的权限的等级没有限制。权限等级可以参考[权限列表](../security/permission-list.md)。 | 字符串   | 可缺省，缺省值为空。 |
+| requiredWritePermission | 标识向该数据代理中写入数据所需要的权限，若不配置，则其他应用无法使用该代理。非系统应用配置的权限的等级需为system_basic或system_core，系统应用配置的权限的等级没有限制。权限等级可以参考[权限列表](../security/permission-list.md)。 | 字符串   | 可缺省，缺省值为空。 |
 | [metadata](#metadata标签) | 标识该数据代理的元信息，只支持配置name和resource字段。 | 对象 | 可缺省，缺省值为空。 |
 
 proxyData标签示例：

zh-cn/application-dev/reference/apis/js-apis-bundleManager-abilityInfo.md

@@ -14,11 +14,11 @@ Ability信息，系统应用可以通过[bundleManager.queryAbilityInfo](js-apis
 | bundleName            | string                                                   | 是   | 否   | 应用Bundle名称。                            |
 | moduleName            | string                                                   | 是   | 否   | Ability所属的HAP的名称。                    |
 | name                  | string                                                   | 是   | 否   | Ability名称。                               |
-| label                 | string                                                   | 是   | 否   | Ability对用户显示的名称。                   |
+| label                 | string                                                   | 是   | 否   | Ability对用户显示的名称的资源描述符，如："label": "$string: mainability_description"。                   |
 | labelId               | number                                                   | 是   | 否   | Ability的标签资源id。                       |
 | description           | string                                                   | 是   | 否   | Ability的描述。                             |
 | descriptionId         | number                                                   | 是   | 否   | Ability的描述资源id。                       |
-| icon                  | string                                                   | 是   | 否   | Ability的图标资源文件索引。                 |
+| icon                  | string                                                   | 是   | 否   | Ability的图标资源描述符，如"icon": "$media:icon"。                 |
 | iconId                | number                                                   | 是   | 否   | Ability的图标资源id。                       |
 | process               | string                                                   | 是   | 否   | Ability的进程，如果不设置，默认为包的名称。 |
 | exported             | boolean                                                  | 是   | 否   | 判断Ability是否可以被其他应用调用。         |

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

@@ -83,7 +83,7 @@ struct RichTextExample {
           console.info('RichText onComplete');
         })
         .width(500)
-        .height(400)
+        .height(500)
         .backgroundColor(0XBDDB69)
       RichText('layoutWeight(1)')
         .onStart(() => {

zh-cn/release-notes/changelogs/OpenHarmony_4.0.9.5/changelogs-formfwk.md

@@ -11,8 +11,6 @@
 
 **关键的接口/组件变更**
 
-涉及接口移动、权限修改前的接口原型：
-
 |     接口      | 修改前所属d.ts | 修改后所属d.ts | 修改前所需权限 | 修改后所需权限 |
 |   --------    |   --------    |   --------    | --------      | --------  |
 | on('formAdd') | @ohos.app.form.formHost.d.ts | @ohos.app.form.formObserver.d.ts | ohos.permission.REQUIRE_FORM | ohos.permission.OBSERVE_FORM_RUNNING | @ohos.app.form.formHost.d.ts | @ohos.app.form.formObserver.d.ts | ohos.permission.REQUIRE_FORM|ohos.permission.OBSERVE_FORM_RUNNING|
@@ -49,3 +47,98 @@ try {
 }
 ```
 
+## cl.formfwk.2 事件订阅，取消订阅相关接口（on/off）参数顺序调整
+
+事件订阅，取消订阅相关接口（on/off）中的callback调整为接口最后一个参数。
+
+**变更影响**
+
+对于已发布的js接口，可能影响三方应用的兼容性。
+
+**关键的接口/组件变更**
+
+修改前的接口原型：
+
+```js
+function on(type: 'formAdd', observerCallback: Callback<formInfo.RunningFormInfo>, bundleName?: string): void;
+function off(type: 'formAdd', observerCallback?: Callback<formInfo.RunningFormInfo>, bundleName?: string): void;
+
+function on(type: 'formRemove', observerCallback: Callback<formInfo.RunningFormInfo>, bundleName?: string): void;
+function off(type: 'formRemove', observerCallback?: Callback<formInfo.RunningFormInfo>, bundleName?: string): void;
+
+function on(
+    type: 'notifyVisible',
+    observerCallback: Callback<Array<formInfo.RunningFormInfo>>,
+    hostBundleName?: string
+  ): void;
+function off(
+    type: 'notifyVisible',
+    observerCallback?: Callback<Array<formInfo.RunningFormInfo>>,
+    hostBundleName?: string
+  ): void;
+
+function on(
+    type: 'notifyInvisible',
+    observerCallback: Callback<Array<formInfo.RunningFormInfo>>,
+    hostBundleName?: string
+  ): void;
+function off(
+    type: 'notifyInvisible',
+    observerCallback?: Callback<Array<formInfo.RunningFormInfo>>,
+    hostBundleName?: string
+  ): void;
+```
+
+修改后的接口原型：
+
+```js
+function on(type: 'formAdd', observerCallback: Callback<formInfo.RunningFormInfo>): void;
+function on(type: 'formAdd', hostBundleName: string, observerCallback: Callback<formInfo.RunningFormInfo>): void;
+function off(type: 'formAdd', hostBundleName?: string, observerCallback?: Callback<formInfo.RunningFormInfo>): void;
+
+function on(type: 'formRemove', observerCallback: Callback<formInfo.RunningFormInfo>): void;
+function on(type: 'formRemove', hostBundleName: string, observerCallback: Callback<formInfo.RunningFormInfo>): void;
+function off(type: 'formRemove', hostBundleName?: string, observerCallback?: Callback<formInfo.RunningFormInfo>): void;
+
+function on(type: 'notifyVisible', observerCallback: Callback<Array<formInfo.RunningFormInfo>>): void;
+function on(
+    type: 'notifyVisible',
+    hostBundleName: string,
+    observerCallback: Callback<Array<formInfo.RunningFormInfo>>
+  ): void;
+function off(
+    type: 'notifyVisible',
+    hostBundleName?: string,
+    observerCallback?: Callback<Array<formInfo.RunningFormInfo>>
+  ): void;
+
+function on(type: 'notifyInvisible', observerCallback: Callback<Array<formInfo.RunningFormInfo>>): void;
+function on(
+    type: 'notifyInvisible',
+    hostBundleName: string,
+    observerCallback: Callback<Array<formInfo.RunningFormInfo>>,
+  ): void;
+function off(
+    type: 'notifyInvisible',
+    hostBundleName?: string,
+    observerCallback?: Callback<Array<formInfo.RunningFormInfo>>
+  ): void;
+```
+
+
+**适配指导**
+
+已使用相关接口开发的应用工程，需要对接口进行适配。从OpenHarmony 4.0.9.5版本起，相关接口使用应注意入参顺序的调整，将callback作为最后一个参数进行接口调用。
+
+**示例：**
+```js
+import formObserver from @ohos.app.form.formObserver.d.ts;
+
+let bundleName = 'ohos.samples.FormApplication';
+let callback = function(data) {
+  console.log('a new form added, data: ${JSON.stringify(data)');
+}
+
+formHost.on('formAdd', callback);
+formHost.on('formAdd', bundleName, callback);
+```
\ No newline at end of file