分布式数据管理变更说明

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枚举类的定义：

拆分后改名为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、枚举值的字符串定义发生了变化。

适配指导

本次变更主要有以下几点需要开发人员适配：
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;
  }
}

cl.distributeddatamgr.2 data.DistributedObject.on参数变更

变更影响

无需应用适配变更。

关键接口/组件变更

共有2个on函数的参数发生变更

修改前的接口原型

on(type: 'change', callback: Callback<{ sessionId: string, fields: Array<string> }>): void;
on(
  type: 'status',
  callback: Callback<{ sessionId: string, networkId: string, status: 'online' | 'offline' }>
): void;

修改后的接口原型

on(type: 'change', callback: (sessionId: string, fields: Array<string>) => void): void;
on(
   type: 'status',
   callback: (sessionId: string, networkId: string, status: 'online' | 'offline' ) => void
): void;

适配指导

无需应用适配变更。

cl.distributeddatamgr.3 data.DistributedObject.off参数变更

变更影响

无需应用适配变更。

关键接口/组件变更

共有2个off函数的参数发生变更

修改前的接口原型

off(type: 'change', callback?: Callback<{ sessionId: string, fields: Array<string> }>): void;
off(
 type: 'status',
 callback?: Callback<{ sessionId: string, networkId: string, status: 'online' | 'offline' }>
): void;

修改后的接口原型

off(type: 'change', callback?: (sessionId: string, fields: Array<string>) => void): void;
off(
  type: 'status',
  callback?: (sessionId: string, networkId: string, status: 'online' | 'offline' ) => void
): void;

适配指导

无需应用适配变更。

cl.distributeddatamgr.4 data.DataObject.on参数变更

变更影响

无需应用适配变更。

关键接口/组件变更

共有2个on函数的参数发生变更

修改前的接口原型

on(type: 'change', callback: Callback<{ sessionId: string, fields: Array<string> }>): void;
on(
 type: 'status',
 callback: Callback<{ sessionId: string, networkId: string, status: 'online' | 'offline' }>
): void;

修改后的接口原型

on(type: 'change', callback: (sessionId: string, fields: Array<string>) => void): void;
on(
  type: 'status',
  callback: (sessionId: string, networkId: string, status: 'online' | 'offline' ) => void
): void;

适配指导

无需应用适配变更。

cl.distributeddatamgr.5 data.DataObject.off参数变更

变更影响

无需应用适配变更。

关键接口/组件变更

共有2个off函数的参数发生变更

修改前的接口原型

off(type: 'change', callback?: Callback<{ sessionId: string, fields: Array<string> }>): void;
off(
 type: 'status',
 callback?: Callback<{ sessionId: string, networkId: string, status: 'online' | 'offline' }>
): void;

修改后的接口原型

off(type: 'change', callback?: (sessionId: string, fields: Array<string>) => void): void;
off(
  type: 'status',
  callback?: (sessionId: string, networkId: string, status: 'online' | 'offline' ) => void
): void;

适配指导

无需应用适配变更。

cl.distributeddatamgr.6 data.preferences.on参数变更

变更影响

无需应用适配变更。

关键接口/组件变更

修改前的接口原型

on(type: 'multiProcessChange', callback: Callback<{ key : string }>): void
on(type: 'change', callback: Callback<{ key : string }>): void

修改后的接口原型

on(type: 'multiProcessChange', callback: ( key : string ) => void): void
on(type: 'change', callback: ( key : string ) => void): void

适配指导

无需应用适配变更。

cl.distributeddatamgr.7 data.preferences.off参数变更

变更影响

无需应用适配变更。

关键接口/组件变更

修改前的接口原型

off(type: 'multiProcessChange', callback?: Callback<{ key : string }>): void
off(type: 'change', callback?: Callback<{ key : string }>): void

修改后的接口原型

off(type: 'multiProcessChange', callback?: ( key : string ) => void): void
off(type: 'change', callback?: ( key : string ) => void): void

适配指导

无需应用适配变更。