未验证 提交 c0b1e42a 编写于 作者: O openharmony_ci 提交者: Gitee

!22620 【UDMF】接口拆分changelog(8_15)

Merge pull request !22620 from Wangkai/cherry-pick-1692616927
# 分布式数据管理子系统ChangeLog
## cl.distributeddatamgr.1 @ohos.data.UDMF.d.ts拆分为@ohos.data.unifiedDataChannel.d.ts和@ohos.data.uniformTypeDescriptor.d.ts
**变更影响**
该变更为不兼容变更,原@ohos.data.UDMF.d.ts拆分为@ohos.data.unifiedDataChannel.d.ts和@ohos.data.uniformTypeDescriptor.d.ts。
将原@ohos.data.UDMF.d.ts中定义的枚举类UnifiedDataType移动到@ohos.data.uniformTypeDescriptor.d.ts中并改名为UniformDataType,
剩余接口定义移动到@ohos.data.unifiedDataChannel.d.ts中不做变化。
**关键接口/组件变更**
拆分前UnifiedDataType枚举类的定义:
| 名称 | 值 | 说明 |
|----------------------------|------------------------------|-----------|
| TEXT | 'Text' | 文本类型。 |
| PLAIN_TEXT | 'Text.PlainText' | 纯文本类型。 |
| HYPERLINK | 'Text.Hyperlink' | 超链接类型。 |
| HTML | 'Text.HTML' | 富文本类型。 |
| FILE | 'File' | 文件类型。 |
| IMAGE | 'File.Media.Image' | 图片类型。 |
| VIDEO | 'File.Media.Video' | 视频类型。 |
| AUDIO | 'File.Media.Audio' | 音频类型。 |
| FOLDER | 'File.Folder' | 文件夹类型。 |
| SYSTEM_DEFINED_RECORD | 'SystemDefinedType' | 系统服务数据类型。 |
| SYSTEM_DEFINED_FORM | 'SystemDefinedType.Form' | 卡片类型。 |
| SYSTEM_DEFINED_APP_ITEM | 'SystemDefinedType.AppItem' | 图标类型。 |
| SYSTEM_DEFINED_PIXEL_MAP | 'SystemDefinedType.PixelMap' | 二进制图片类型。 |
| APPLICATION_DEFINED_RECORD | 'ApplicationDefinedType' | 应用自定义类型。 |
拆分后改名为UniformDataType枚举类的定义:
1、删除了枚举值定义SYSTEM_DEFINED_RECORD和APPLICATION_DEFINED_RECORD。
2、枚举值SYSTEM_DEFINED_FORM改名为OPENHARMONY_FORM,枚举值SYSTEM_DEFINED_APP_ITEM改名为OPENHARMONY_APP_ITEM,枚举值SYSTEM_DEFINED_PIXEL_MAP改名为OPENHARMONY_PIXEL_MAP。
3、枚举值的字符串定义发生了变化。
| 名称 | 值 | 说明 |
|----------------------------|------------------------------|-----------|
| TEXT | 'general.text' | 文本类型。 |
| PLAIN_TEXT | 'general.plain-text' | 纯文本类型。 |
| HYPERLINK | 'general.hyperlink' | 超链接类型。 |
| HTML | 'general.html' | 富文本类型。 |
| FILE | 'general.file' | 文件类型。 |
| IMAGE | 'general.image' | 图片类型。 |
| VIDEO | 'general.video' | 视频类型。 |
| AUDIO | 'general.audio' | 音频类型。 |
| FOLDER | 'general.folder' | 文件夹类型。 |
| OPENHARMONY_FORM | 'openharmony.form' | 卡片类型。 |
| OPENHARMONY_APP_ITEM | 'openharmony.app-item' | 图标类型。 |
| OPENHARMONY_PIXEL_MAP | 'openharmony.pixel-map' | 二进制图片类型。 |
**适配指导**
本次变更主要有以下几点需要开发人员适配:
1、将前文中的枚举值变化进行相应适配。
2、将导入模块由修改前的@ohos.data.UDMF模块更改为@ohos.data.unifiedDataChannel和@ohos.data.uniformTypeDescriptor两个模块。
3、根据导入模块的变化,将命名空间UDMF替换成对应的导入模块名,UnifiedDataType替换为UniformDataType。
变更前代码示例:
```
// 导入@ohos.data.UDMF模块
import UDMF from '@ohos.data.UDMF';
// 创建一个统一数据对象实例
let unifiedData = new UDMF.UnifiedData(image);
// 创建纯文本数据类型记录,将其添加到刚才创建的UnifiedData对象
let plainText = new UDMF.PlainText();
plainText.textContent = 'this is textContent of plainText';
unifiedData.addRecord(plainText);
// 遍历每条记录,判断该记录的数据类型,转换为子类对象,得到原数据记录
let records = unifiedData.getRecords();
for (let i = 0; i < records.length; i ++) {
// 读取该数据记录的类型
let type = records[i].getType();
switch (type) {
case UDMF.UnifiedDataType.IMAGE:
// 转换得到原图片数据记录
let image = <UDMF.Image>(records[i]);
break;
case UDMF.UnifiedDataType.PLAIN_TEXT:
// 转换得到原文本数据记录
let plainText = <UDMF.PlainText>(records[i]);
break;
default:
break;
}
}
```
变更后代码示例:
```
// 导入@ohos.data.unifiedDataChannel和@ohos.data.uniformTypeDescriptor模块
import UDC from '@ohos.data.unifiedDataChannel';
import UTD from '@ohos.data.uniformTypeDescriptor';
// 创建一个统一数据对象实例
let unifiedData = new UDC.UnifiedData(image);
// 创建纯文本数据类型记录,将其添加到刚才创建的UnifiedData对象
let plainText = new UDC.PlainText();
plainText.textContent = 'this is textContent of plainText';
unifiedData.addRecord(plainText);
// 遍历每条记录,判断该记录的数据类型,转换为子类对象,得到原数据记录
let records = unifiedData.getRecords();
for (let i = 0; i < records.length; i ++) {
// 读取该数据记录的类型
let type = records[i].getType();
switch (type) {
case UTD.UniformDataType.IMAGE:
// 转换得到原图片数据记录
let image = <UDC.Image>(records[i]);
break;
case UTD.UniformDataType.PLAIN_TEXT:
// 转换得到原文本数据记录
let plainText = <UDC.PlainText>(records[i]);
break;
default:
break;
}
}
```
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册