diff --git a/zh-cn/release-notes/OpenHarmony-v3.1-release.md b/zh-cn/release-notes/OpenHarmony-v3.1-release.md index 6e567dd47cb646925bc053f54e35fc4f12562096..c4cc28cf262b7347229ed88afeb8b5ff7cf7cf16 100755 --- a/zh-cn/release-notes/OpenHarmony-v3.1-release.md +++ b/zh-cn/release-notes/OpenHarmony-v3.1-release.md @@ -192,9 +192,6 @@ _[JS API 差异报告](api-change/v3.1-Release/js-apidiff-v3.1-release.md)_ _[Native API差异报告](api-change/v3.1-Release/native-apidiff-v3.1-release.md)_ -_[Changelog](api-change/v3.1-Release/changelog-v3.1-release.md)_ - - ### 芯片及开发板适配 芯片及开发板适配状态请参考[SIG-Devboard](https://gitee.com/openharmony/community/blob/master/sig/sig-devboard/sig_devboard_cn.md)信息。 diff --git a/zh-cn/release-notes/api-change/v3.1-Release/changelog-v3.1-release.md b/zh-cn/release-notes/api-change/v3.1-Release/changelog-v3.1-release.md deleted file mode 100644 index 2b896dc81cba282ac72c42a229e233570f43074f..0000000000000000000000000000000000000000 --- a/zh-cn/release-notes/api-change/v3.1-Release/changelog-v3.1-release.md +++ /dev/null @@ -1,303 +0,0 @@ -# ChangeLog -**关键的接口/组件变更** -## 包管理子系统 - -### 结构体BundleInfo - -#### 变更前： - -BundleInfo结构体中包含了abilityInfo和hapModuleInfo这两个属性。 - -#### 变更后 - -BundleInfo结构体中将abilityInfo和hapModuleInfo这两个属性修改为abilityInfos和hapModuleInfos。 - -#### 变更影响 - -无 - -#### 关键的接口/组件变更 - -无 - -#### 适配指导 - -如果代码中有使用到上述已删除的属性，需要适配新的结构体。 - -### 结构体AbilityInfo - -#### 变更前： - -AbilityInfo结构体中包含了formEntity、minFormHeight、defaultFormHeight、minFormWidth、defaultFormWidth和customizeData属性。 - -#### 变更后 - -AbilityInfo结构体中删除了formEntity、minFormHeight、defaultFormHeight、minFormWidth、defaultFormWidth和customizeData属性，其中customizeData修改为metaData。 - -#### 变更影响 - -无 - -#### 关键的接口/组件变更 - -无 - -#### 适配指导 - -如果代码中有使用到上述已删除的属性，需要适配新的结构体。 - -### 结构体ApplicationInfo - -#### 变更前： - -ApplicationInfo结构体中包含了customizeData这个属性。 - -#### 变更后 - -AbilityInfo结构体中删除了customizeData，修改为metaData。 - -#### 变更影响 - -无 - -#### 关键的接口/组件变更 - -无 - -#### 适配指导 - -如果代码中有使用到上述已删除的属性，需要适配新的结构体。 - -### 接口getAllShortcutInfo - -#### 变更前： - -该接口查询快捷信息。 - -#### 变更后 - -该接口已废弃，改为系统API，不支持三方应用。 - -#### 变更影响 - -使用该接口的代码需要删除。 - -#### 关键的接口/组件变更 - -无 - -#### 适配指导 - -无 - -### 接口checkPermission - -#### 变更前： - -该接口查询权限的授权状态。 - -#### 变更后 - -该接口已废弃，包管理子系统不提供该接口。 - -#### 变更影响 - -使用该接口的代码需要删除。 - -#### 关键的接口/组件变更 - -无 - -#### 适配指导 - -调用Context提供的权限查询接口。 - -```C++ -import featureAbility from '@ohos.ability.featureAbility' -import bundle from '@ohos.bundle' -var context = featureAbility.getContext(); -bundle.getBundleInfo('com.context.test', 1, (datainfo) =>{ - context.verifyPermission("com.example.permission", datainfo.uid); -}); -``` - - - -## 软总线子系统 - -### 结构体MessageOption - -#### 变更前： - -MessageOption结构体中`TF_WAIT_TIME == 4`。 - -#### 变更后 - -MessageOption结构体中`TF_WAIT_TIME == 8`。 - -#### 变更影响 - -RPC 同步调用默认等待时间从4秒变为8秒。 - -#### 关键的接口/组件变更 - -无 - -#### 适配指导 - -涉及RPC通信的代码，可以根据业务情况设置等待时间: `setWaitTime(waitTime: number): void`。 - - - -### 接口queryLocalInterface - -#### 变更前： - -接口返回值为`IRemoteBroker`。 - -#### 变更后 - -接口返回值为`IRemoteObject`。 - -#### 变更影响 - -使用该接口的代码，接口返回值类型为`IRemoteObject`。 - -#### 关键的接口/组件变更 - -无 - -#### 适配指导 - -``` -import FA from "@ohos.ability.featureAbility"; -let proxy; -let connect = { - onConnect: function(elementName, remoteProxy) { - console.log("RpcClient: js onConnect called."); - proxy = remoteProxy; - }, - onDisconnect: function (elementName) { - console.log("RpcClient: onDisconnect"); - }, - onFailed: function() { - console.log("RpcClient: onFailed"); - } -}; -let want = { - "bundleName":"com.ohos.server", - "abilityName":"com.ohos.server.MainAbility", -}; -FA.connectAbility(want, connect); -let broker = proxy.queryLocalInterface("testObject"); -console.log("RpcClient: queryLocalInterface is " + broker); -``` - - - -### 接口readCharArray - -#### 变更前： - -`readCharArray(dataIn: boolean[]) : void`: 入参类型为bool数组。 - -`readCharArray(): boolean[]`: 返回值为bool数组。 - -#### 变更后 - -`readCharArray(dataIn: boolean[]) : void`: 入参类型为number数组。 - -`readCharArray(): boolean[]`: 返回值为number数组。 - -#### 变更影响 - -使用该接口的代码入参、返回值类型从`boolean[]`转为`number[]`。 - -#### 关键的接口/组件变更 - -无 - -#### 适配指导 - -``` -let data = rpc.MessageParcel.create(); -let result = data.writeCharArray(['a', 'b', 'c']); -console.log("RpcClient: writeCharArray is " + result); -let array = new Array(3); -data.readCharArray(array); -``` - -``` -let data = rpc.MessageParcel.create(); -let result = data.writeCharArray(['a', 'b', 'c']); -console.log("RpcClient: writeCharArray is " + result); -let array = data.readCharArray(); -console.log("RpcClient: readCharArray is " + array); -``` - - - -### 接口sendRequest - -#### 变更前： - -该接口返回值为`boolean`。 - -#### 变更后 - -该接口返回值为`Promise`。 - -#### 变更影响 - -使用该接口的代码返回值类型为期约`Promise`。 - -#### 关键的接口/组件变更 - -无 - -#### 适配指导 - -``` -import FA from "@ohos.ability.featureAbility"; -let proxy; -let connect = { - onConnect: function(elementName, remoteProxy) { - console.log("RpcClient: js onConnect called."); - proxy = remoteProxy; - }, - onDisconnect: function(elementName) { - console.log("RpcClient: onDisconnect"); - }, - onFailed: function() { - console.log("RpcClient: onFailed"); - } -}; -let want = { - "bundleName": "com.ohos.server", - "abilityName": "com.ohos.server.MainAbility", -}; -FA.connectAbility(want, connect); -let option = new rpc.MessageOption(); -let data = rpc.MessageParcel.create(); -let reply = rpc.MessageParcel.create(); -data.writeInt(1); -data.writeString("hello"); -proxy.sendRequest(1, data, reply, option) - .then(function(result) { - if (result.errCode === 0) { - console.log("sendRequest got result"); - result.reply.readException(); - let msg = result.reply.readString(); - console.log("RPCTest: reply msg: " + msg); - } else { - console.log("RPCTest: sendRequest failed, errCode: " + result.errCode); - } - }).catch(function(e) { - console.log("RPCTest: sendRequest got exception: " + e.message); - }).finally (() => { - console.log("RPCTest: sendRequest ends, reclaim parcel"); - data.reclaim(); - reply.reclaim(); - }); -``` -