1# 分布式数据管理子系统JS API变更Changelog 2 3## cl.distributeddatamgr.1 接口变更 4distributeddatamgr子系统kv_store组件接口存在变更： 5 6由于执行时间固定且耗时短，不需要异步等待执行结果，createKVManager方法需要改为同步接口。因此旧的接口function createKVManager(config: KVManagerConfig): Promise\<KVManager\>; 与 function createKVManager(config: KVManagerConfig, callback: AsyncCallback<KVManager>): void; 改为 function createKVManager(config: KVManagerConfig): KVManager; 7 8开发者需要根据以下说明对应用进行适配。 9 10 **变更影响** 11 12影响API9版本的JS接口，应用需要进行适配才可以在新版本SDK环境正常实现功能。 13 14**关键的接口/组件变更** 15 16| 模块名 | 类名 | 方法/属性/枚举/常量 | 变更类型 | 17| ------------------------- | ------------------- | ------------------------------------------------------------ | -------- | 18| @ohos.distributedKVStore | distributedKVStore | function createKVManager(config: KVManagerConfig): Promise\<KVManager\>; | 删除 | 19| @ohos.distributedKVStore | distributedKVStore | function createKVManager(config: KVManagerConfig): KVManager; | 变更 | 20 21 22**适配指导** 23 24应用中调用createKVManager创建KVManager对象实例可参考下列代码 25 26Stage模型下的示例： 27 28```ts 29import AbilityStage from '@ohos.application.Ability' 30let kvManager; 31export default class MyAbilityStage extends AbilityStage { 32 onCreate() { 33 console.log("MyAbilityStage onCreate") 34 let context = this.context 35 const kvManagerConfig = { 36 context: context, 37 bundleName: 'com.example.datamanagertest', 38 } 39 try { 40 kvManager = distributedKVStore.createKVManager(kvManagerConfig); 41 } catch (e) { 42 console.error(`Failed to create KVManager.code is ${e.code},message is ${e.message}`); 43 } 44 } 45} 46``` 47 48FA模型下的示例： 49 50```ts 51import featureAbility from '@ohos.ability.featureAbility' 52let kvManager; 53let context = featureAbility.getContext() 54const kvManagerConfig = { 55 context: context, 56 bundleName: 'com.example.datamanagertest', 57} 58try { 59 kvManager = distributedKVStore.createKVManager(kvManagerConfig); 60} catch (e) { 61 console.error(`Failed to create KVManager.code is ${e.code},message is ${e.message}`); 62} 63``` 64 65## cl.distributeddatamgr.2 function getRdbStoreV9 从@ohos.data.rdb.d.ts 迁移至@ohos.data.relationalStore.d.ts 66**变更影响** 67应用需要进行适配，才可以在新版本SDK环境正常编译通过。 68 69**关键的接口/组件变更** 70如下接口： 71```ts 72function getRdbStoreV9(context: Context, config: StoreConfigV9, version: number, callback: AsyncCallback<RdbStoreV9>): void; 73function getRdbStoreV9(context: Context, config: StoreConfigV9, version: number): Promise<RdbStoreV9>; 74``` 75从@ohos.data.rdb.d.ts 迁移至@ohos.data.relationalStore.d.ts: 76``` 77function getRdbStore(context: Context, config: StoreConfig, callback: AsyncCallback<RdbStore>): void; 78function getRdbStore(context: Context, config: StoreConfig): Promise<RdbStore>; 79``` 80 81**适配指导** 82 * `import rdb from "@ohos.data.rdb"` 改为 `import rdb from "@ohos.data.relationalStore"`； 83 * 按上述接口变更对齐修改所调用的方法名称即可。 84 85## cl.distributeddatamgr.3 function deleteRdbStoreV9 从@ohos.data.rdb.d.ts 迁移至@ohos.data.relationalStore.d.ts 86**变更影响** 87应用需要进行适配，才可以在新版本SDK环境正常编译通过。 88 89**关键的接口/组件变更** 90如下接口： 91```ts 92function deleteRdbStoreV9(context: Context, name: string, callback: AsyncCallback<void>): void; 93function deleteRdbStoreV9(context: Context, name: string): Promise<void>; 94``` 95从@ohos.data.rdb.d.ts 迁移至@ohos.data.relationalStore.d.ts: 96``` 97function deleteRdbStoreV9(context: Context, name: string, callback: AsyncCallback<void>): void; 98function deleteRdbStoreV9(context: Context, name: string): Promise<void>; 99``` 100 101**适配指导** 102 * `import rdb from "@ohos.data.rdb"` 改为 `import rdb from "@ohos.data.relationalStore"`； 103 * 按上述接口变更对齐修改所调用的方法名称即可。 104 105## cl.distributeddatamgr.4 interface StoreConfigV9 从@ohos.data.rdb.d.ts 迁移至@ohos.data.relationalStore.d.ts 106**变更影响** 107应用需要进行适配，才可以在新版本SDK环境正常编译通过。 108 109**关键的接口/组件变更** 110interface StoreConfigV9 从@ohos.data.rdb.d.ts 迁移至@ohos.data.relationalStore.d.ts 改名为interface StoreConfig。 111 112**适配指导** 113 * `import rdb from "@ohos.data.rdb"` 改为 `import rdb from "@ohos.data.relationalStore"`； 114 * 按上述接口变更对齐修改所调用的接口名称即可。 115 116## cl.distributeddatamgr.5 enum SecurityLevel 从@ohos.data.rdb.d.ts 迁移至@ohos.data.relationalStore.d.ts 117**变更影响** 118应用需要进行适配，才可以在新版本SDK环境正常编译通过。 119 120**关键的接口/组件变更** 121enum SecurityLevel 从ohos.data.rdb.d.ts 迁移至@ohos.data.relationalStore.d.ts。 122 123**适配指导** 124 * `import rdb from "@ohos.data.rdb"` 改为 `import rdb from "@ohos.data.relationalStore"`； 125 * 按上述接口变更对齐修改所调用的接口名称即可。 126 127## cl.distributeddatamgr.6 interface RdbStoreV9 从@ohos.data.rdb.d.ts 迁移至@ohos.data.relationalStore.d.ts 128**变更影响** 129应用需要进行适配，才可以在新版本SDK环境正常编译通过。 130 131**关键的接口/组件变更** 132interface RdbStoreV9 从@ohos.data.rdb.d.ts 迁移至@ohos.data.relationalStore.d.ts 改名为interface RdbStore。 133 134**适配指导** 135 * `import rdb from "@ohos.data.rdb"` 改为 `import rdb from "@ohos.data.relationalStore"`； 136 * 按上述接口变更对齐修改所调用的接口名称即可。 137 138## cl.distributeddatamgr.7 class RdbPredicatesV9 从ohos.data.rdb.d.ts 迁移至@ohos.data.relationalStore.d.ts 139**变更影响** 140应用需要进行适配，才可以在新版本SDK环境正常编译通过。 141 142**关键的接口/组件变更** 143class RdbPredicatesV9 从ohos.data.rdb.d.ts 迁移至@ohos.data.relationalStore.d.ts 改名为interface RdbPredicates。 144 145**适配指导** 146 * `import rdb from "@ohos.data.rdb"` 改为 `import rdb from "@ohos.data.relationalStore"`； 147 * 按上述接口变更对齐修改所调用的接口名称即可。 148 149## cl.distributeddatamgr.8 interface ResultSetV9 从api/@ohos.data.relationalStore.d.ts 迁移至@ohos.data.relationalStore.d.ts 150**变更影响** 151应用需要进行适配，才可以在新版本SDK环境正常编译通过。 152 153**关键的接口/组件变更** 154interface ResultSetV9 从api/data/rdb/resultSet.d.ts 迁移至@ohos.data.relationalStore.d.ts 改名为interface ResultSet。 155 156**适配指导** 157 * `import rdb from "@ohos.data.rdb"` 改为 `import rdb from "@ohos.data.relationalStore"`； 158 * ResultSetV9实例仅通过getRdbStoreV9方法获取，参考cl.distributeddatamgr.2变更后，代码可自动适配ResultSet。 159