harmony 鸿蒙分布式数据管理子系统ChangeLog

2023-10-30
浏览 (305)

分布式数据管理子系统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;
  }
}