!15208 api9发布前终审修改

Merge pull request !15208 from zzs110/monthly_20221018

!15208 api9发布前终审修改
Merge pull request !15208 from zzs110/monthly_20221018
c8a41597 · openharmony_ci · Gitee · 7d538723 · b8e32a05 · c8a41597
2 changed file
--- a/zh-cn/application-dev/reference/apis/js-apis-pasteboard.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-pasteboard.md
@@ -63,7 +63,7 @@ createData(mimeType: string, value: ValueType): PasteData

  ```js
  let dataXml = new ArrayBuffer(256);
-  let pasteData = pasteboard.createData('app/xml', dataXml);
+let pasteData = pasteboard.createData('app/xml', dataXml);
  ```

 ## pasteboard.createRecord<sup>9+</sup>
@@ -90,8 +90,8 @@ createRecord(mimeType: string, value: ValueType):PasteDataRecord;
 **示例：**

  ```js
-  let dataXml = new ArrayBuffer(256);
-  let pasteDataRecord = pasteboard.createRecord('app/xml', dataXml);
+let dataXml = new ArrayBuffer(256);
+let pasteDataRecord = pasteboard.createRecord('app/xml', dataXml);
  ```

 ## pasteboard.getSystemPasteboard
@@ -120,11 +120,11 @@ let systemPasteboard = pasteboard.getSystemPasteboard();

 **系统能力：** SystemCapability.MiscServices.Pasteboard

-| 名称 | 值 | 说明                |
-| ---- |---|-------------------|
-| InApp | 0 | 表示仅允许同应用内粘贴。      |
-| LocalDevice | 1 | 表示允许在此设备中任何应用内粘贴。 |
-| CrossDevice | 2 | 表示允许跨设备在任何应用内粘贴。  |
+| 名称          | 值 | 说明                |
+|-------------|---|-------------------|
+| INAPP       | 0 | 表示仅允许同应用内粘贴。      |
+| LOCALDEVICE | 1 | 表示允许在此设备中任何应用内粘贴。 |
+| CROSSDEVICE | 2 | 表示允许跨设备在任何应用内粘贴。  |

 ## pasteboard.createHtmlData<sup>(deprecated)</sup>

@@ -374,14 +374,14 @@ let record = pasteboard.createUriRecord('dataability:///com.example.myapplicatio

 **系统能力：** SystemCapability.MiscServices.Pasteboard

-| 名称 | 类型 | 可读 | 可写 | 说明 |
-| -------- | -------- | -------- | -------- | -------- |
-| additions<sup>7+</sup> | {[key:string]:object} | 是 | 是 | 设置的其他附加属性数据。 |
-| mimeTypes<sup>7+</sup> | Array&lt;string&gt; | 是 | 否 | 剪贴板内容条目的数据类型，非重复的类型列表。 |
-| tag<sup>7+</sup> | string | 是 | 是 | 用户自定义标签。 |
-| timestamp<sup>7+</sup> | number | 是 | 否 | 剪贴板数据的写入时间戳（单位：ms）。 |
+| 名称 | 类型 | 可读 | 可写 | 说明                                                                                         |
+| -------- | -------- | -------- | -------- |--------------------------------------------------------------------------------------------|
+| additions<sup>7+</sup> | {[key:string]:object} | 是 | 是 | 设置的其他附加属性数据。                                                                               |
+| mimeTypes<sup>7+</sup> | Array&lt;string&gt; | 是 | 否 | 剪贴板内容条目的数据类型，非重复的类型列表。                                                                     |
+| tag<sup>7+</sup> | string | 是 | 是 | 用户自定义标签。                                                                                   |
+| timestamp<sup>7+</sup> | number | 是 | 否 | 剪贴板数据的写入时间戳（单位：ms）。                                                                        |
 | localOnly<sup>7+</sup> | boolean | 是 | 是 | 配置剪贴板内容是否为“仅在本地”。默认值为true。<br/>- 配置为true时，表示内容仅在本地，不会在设备之间传递。<br/>- 配置为false时，表示内容将在设备间传递。 |
-| shareOption<sup>9+</sup> | [ShareOption](#shareoption9) | 是 | 是 | 指示剪贴板数据可以粘贴到的范围，如果未设置或设置不正确，则默认值为CrossDevice。 |
+| shareOption<sup>9+</sup> | [ShareOption](#shareoption9) | 是 | 是 | 指示剪贴板数据可以粘贴到的范围，如果未设置或设置不正确，则默认值为CROSSDEVICE。                                              |

 ## PasteDataRecord<sup>7+</sup>

@@ -401,38 +401,11 @@ let record = pasteboard.createUriRecord('dataability:///com.example.myapplicatio
 | pixelMap<sup>9+</sup> | [image.PixelMap](js-apis-image.md#pixelmap7) | 是 | 否 | PixelMap内容。 |
 | data<sup>9+</sup> | {[mimeType:&nbsp;string]:&nbsp;ArrayBuffer} | 是 | 否 | 自定义数据内容。 |

-### convertToTextV9<sup>9+</sup>
+### toPlainText<sup>9+</sup>

-convertToTextV9(callback: AsyncCallback&lt;string&gt;): void
+toPlainText(): string

-将一个PasteData中的内容强制转换为文本内容，使用callback异步回调。
-
-**系统能力：** SystemCapability.MiscServices.Pasteboard
-
-**参数：**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| callback | AsyncCallback&lt;string&gt; | 是 | 回调函数，当转换成功，err为undefined，data为强制转换的文本内容；否则返回错误信息。 |
-
-**示例：**
-
-```js
-let record = pasteboard.createRecord(pasteboard.MIMETYPE_TEXT_URI, 'dataability:///com.example.myapplication1/user.txt');
-record.convertToTextV9((err, data) => {
-    if (err) {
-        console.error(`Failed to convert to text. Cause: ${err.message}`);
-        return;
-    }
-    console.info(`Succeeded in converting to text. Data: ${data}`);
-});
-```
-
-### convertToTextV9<sup>9+</sup>
-
-convertToTextV9(): Promise&lt;string&gt;
-
-将一个PasteData中的内容强制转换为文本内容，使用Promise异步回调。
+将一个PasteData中的内容强制转换为文本内容。

 **系统能力：** SystemCapability.MiscServices.Pasteboard

@@ -440,17 +413,14 @@ convertToTextV9(): Promise&lt;string&gt;

 | 类型 | 说明 |
 | -------- | -------- |
-| Promise&lt;string&gt; | Promise对象，返回强制转换的文本内容。 |
+| string | 纯文本内容。 |

 **示例：**

 ```js
 let record = pasteboard.createRecord(pasteboard.MIMETYPE_TEXT_URI, 'dataability:///com.example.myapplication1/user.txt');
-record.convertToTextV9().then((data) => {
-    console.info(`Succeeded in converting to text. Data: ${data}`);
-}).catch((err) => {
-    console.error(`Failed to convert to text. Cause: ${err.message}`);
-});
+let data = record.toPlainText();
+console.info(`Succeeded in converting to text. Data: ${data}`);
 ```

 ### convertToText<sup>(deprecated)</sup>
@@ -460,7 +430,7 @@ convertToText(callback: AsyncCallback&lt;string&gt;): void
 将一个PasteData中的内容强制转换为文本内容，使用callback异步回调。
 > **说明：**
 >
-> 从 API Version 7 开始支持，从 API Version 9 开始废弃，建议使用[convertToTextV9](#converttotextv99)替代。
+> 从 API Version 7 开始支持，从 API Version 9 开始废弃，建议使用[toPlainText](#toplaintext9)替代。

 **系统能力：** SystemCapability.MiscServices.Pasteboard

@@ -474,11 +444,11 @@ convertToText(callback: AsyncCallback&lt;string&gt;): void

 ```js
 let record = pasteboard.createUriRecord('dataability:///com.example.myapplication1/user.txt');
-record.convertToText((err, data) => {    
-    if (err) {        
+record.convertToText((err, data) => {
+    if (err) {
        console.error(`Failed to convert to text. Cause: ${err.message}`);
-        return;   
-      }
+        return;
+    }
    console.info(`Succeeded in converting to text. Data: ${data}`);
 });
 ```
@@ -490,7 +460,7 @@ convertToText(): Promise&lt;string&gt;
 将一个PasteData中的内容强制转换为文本内容，使用Promise异步回调。
 > **说明：**
 >
-> 从 API Version 7 开始支持，从 API Version 9 开始废弃，建议使用[convertToTextV9](#converttotextv99-1)替代。
+> 从 API Version 7 开始支持，从 API Version 9 开始废弃，建议使用[toPlainText](#toplaintext9)替代。

 **系统能力：** SystemCapability.MiscServices.Pasteboard

@@ -696,8 +666,8 @@ addRecord(mimeType: string, value: ValueType): void

  ```js
  let pasteData = pasteboard.createData(pasteboard.MIMETYPE_TEXT_URI, 'dataability:///com.example.myapplication1/user.txt');
-  let dataXml = new ArrayBuffer(256);
-  pasteData.addRecord('app/xml', dataXml);
+let dataXml = new ArrayBuffer(256);
+pasteData.addRecord('app/xml', dataXml);
  ```

 ### getMimeTypes<sup>7+</sup>
@@ -782,7 +752,7 @@ setProperty(property: PasteDataProperty): void
 ```js
 let pasteData = pasteboard.createData(pasteboard.MIMETYPE_TEXT_HTML, 'application/xml');
 let prop = pasteData.getProperty();
-prop.shareOption = pasteboard.ShareOption.InApp;
+prop.shareOption = pasteboard.ShareOption.INAPP;
 pasteData.setProperty(prop);
 ```

@@ -1722,4 +1692,4 @@ systemPasteboard.setPasteData(pasteData).then((data) => {
 }).catch((err) => {
    console.error('Failed to set PasteData. Cause: ' + err.message);
 });
-```
+```
\ No newline at end of file
--- a/zh-cn/release-notes/changelogs/OpenHarmony_4.0.2.3/changelogs-pasteboard.md
+++ b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.2.3/changelogs-pasteboard.md
+# 剪贴板子系统ChangeLog
+
+OpenHarmony 4.0.3.2 版本相较于OpenHarmony 之前的版本，剪贴板子系统的API变更如下。
+
+## cl.pasteboard.1 convertToTextV9接口变更
+
+接口convertToTextV9由于命名规范和接口返回方式问题，名称变更为toPlainText()，返回方式改为同步方式。
+
+**变更影响**
+
+4.0.3.3版本之前使用接口convertToTextV9开发的应用，在4.0.3.3版本及后续版本中无法继续正常使用。
+
+**关键的接口/组件变更**
+
+- 涉及接口
+
+  function convertToTextV9
+
+- 变更前：
+
+  ```ts
+  convertToTextV9(callback: AsyncCallback<string>): void;
+  convertToTextV9(): Promise<string>;
+  ```
+
+- 变更后：
+
+  ```ts
+  toPlainText(): string;
+  ```
+变更前：
+
+**适配指导**
+
+请使用toPlainText替换convertToTextV9，并注意接口返回方式。
+
+## cl.pasteboard.2 ShareOption属性名称变更，删除了未支持的属性
+
+ShareOption枚举命名从**大驼峰**改成了**全大写**。
+
+**变更影响**
+
+4.0.3.3版本之前使用InApp/LocalDevice/CrossDevice类型开发的应用，在4.0.3.3版本及后续版本中无法继续正常使用。
+
+**关键接口/组件变更**
+
+ShareOption<sup>9+</sup>
+
+变更前：
+| 名称 | 值 | 说明                |
+| ---- |---|-------------------|
+| InApp | 0 | 表示仅允许同应用内粘贴。      |
+| LocalDevice | 1 | 表示允许在此设备中任何应用内粘贴。 |
+| CrossDevice | 2 | 表示允许跨设备在任何应用内粘贴。  |
+
+
+变更后：
+| 名称 | 值 | 说明                |
+| ---- |---|-------------------|
+| INAPP | 0 | 表示仅允许同应用内粘贴。      |
+| LOCALDEVICE | 1 | 表示允许在此设备中任何应用内粘贴。 |
+| CROSSDEVICE | 2 | 表示允许跨设备在任何应用内粘贴。  |
+
+**适配指导**
+
+按新的语义进行适配。
\ No newline at end of file