软总线子系统Changelog

IPC&RPC API支持异常处理方式和支持传入布尔值与数值选择同步或异步方式发送信息变更

1. 软总线IPC&RPC部分接口使用业务逻辑返回值表示错误信息，不符合OpenHarmony接口错误规范；
2. 支持传入布尔值选择同步或异步方式发送信息。

变更影响

此版本兼容之前的应用开发，不需要适配，后续可调用新增接口支持以下两个变更：

1. 支持异常处理并返回错误码；
2. 提供通过布尔值或通过0与非0数字选择同步或异步发消息。

关键接口/组件变更

为适配统一的API异常处理方式，对IPC&RPC相关接口进行废弃，并新增对应接口和方法。新增接口支持统一的错误码异常处理规范，功能上与原接口保持一致。

类名	废弃接口	新增替换类名	新增替代接口
MessageParcel	static create(): MessageParcel	MessageSequence	static create(): MessageSequence
MessageParcel	reclaim(): void	MessageSequence	reclaim(): void
MessageParcel	writeRemoteObject(object: IRemoteObject): boolean	MessageSequence	writeRemoteObject(object: IRemoteObject): void
MessageParcel	readRemoteObject(): IRemoteObject	MessageSequence	readRemoteObject(): IRemoteObject
MessageParcel	writeInterfaceToken(token: string): boolean	MessageSequence	writeInterfaceToken(token: string): void
MessageParcel	readInterfaceToken(): string	MessageSequence	readInterfaceToken(): string
MessageParcel	getSize(): number	MessageSequence	getSize(): number
MessageParcel	getCapacity(): number	MessageSequence	getCapacity(): number
MessageParcel	setSize(size: number): boolean	MessageSequence	setCapacity(size: number): void
MessageParcel	getReadableBytes(): number	MessageSequence	getReadableBytes(): number
MessageParcel	getReadPosition(): number	MessageSequence	getReadPosition(): number
MessageParcel	getWritePosition(): number	MessageSequence	getWritePosition(): number
MessageParcel	rewindRead(pos: number): boolean	MessageSequence	rewindRead(pos: number): void
MessageParcel	rewindWrite(pos: number): boolean	MessageSequence	rewindWrite(pos: number): void
MessageParcel	writeNoException(): void	MessageSequence	writeNoException(): void
MessageParcel	readException(): void	MessageSequence	readException(): void
MessageParcel	writeByte(val: number): boolean	MessageSequence	writeByte(val: number): void
MessageParcel	writeShort(val: number): boolean	MessageSequence	writeShort(val: number): void
MessageParcel	writeInt(val: number): boolean	MessageSequence	writeInt(val: number): void
MessageParcel	writeLong(val: number): boolean	MessageSequence	writeLong(val: number): void
MessageParcel	writeFloat(val: number): boolean	MessageSequence	writeFloat(val: number): void
MessageParcel	writeDouble(val: number): boolean	MessageSequence	writeDouble(val: number): void
MessageParcel	writeBoolean(val: boolean): boolean	MessageSequence	writeBoolean(val: boolean): void
MessageParcel	writeChar(val: number): boolean	MessageSequence	writeChar(val: number): void
MessageParcel	writeString(val: string): boolean	MessageSequence	writeString(val: string): void
MessageParcel	writeSequenceable(val: Sequenceable): boolean	MessageSequence	writeParcelable(val: Parcelable): void
MessageParcel	writeByteArray(byteArray: number[]): boolean	MessageSequence	writeByteArray(byteArray: number[]): void
MessageParcel	writeShortArray(shortArray: number[]): boolean	MessageSequence	writeShortArray(shortArray: number[]): void
MessageParcel	writeIntArray(intArray: number[]): boolean	MessageSequence	writeIntArray(intArray: number[]): void
MessageParcel	writeLongArray(longArray: number[]): boolean	MessageSequence	writeLongArray(longArray: number[]): void
MessageParcel	writeFloatArray(floatArray: number[]): boolean	MessageSequence	writeFloatArray(floatArray: number[]): void
MessageParcel	writeDoubleArray(doubleArray: number[]): boolean	MessageSequence	writeDoubleArray(doubleArray: number[]): void
MessageParcel	writeBooleanArray(booleanArray: boolean[]): boolean	MessageSequence	writeBooleanArray(booleanArray: boolean[]): void
MessageParcel	writeCharArray(charArray: number[]): boolean	MessageSequence	writeCharArray(charArray: number[]): void
MessageParcel	writeStringArray(stringArray: string[]): boolean	MessageSequence	writeStringArray(stringArray: string[]): void
MessageParcel	writeSequenceableArray(sequenceableArray: Sequenceable[]): boolean	MessageSequence	writeParcelableArray(sequenceableArray: Parcelable[]): void
MessageParcel	writeRemoteObjectArray(objectArray: IRemoteObject[]): boolean	MessageSequence	writeRemoteObjectArray(objectArray: IRemoteObject[]): void
MessageParcel	readByte(): number	MessageSequence	readByte(): number
MessageParcel	readShort(): number	MessageSequence	readShort(): number
MessageParcel	readLong(): number	MessageSequence	readLong(): number
MessageParcel	readFloat(): number	MessageSequence	readFloat(): number
MessageParcel	readDouble(): number	MessageSequence	readDouble(): number
MessageParcel	readBoolean(): boolean	MessageSequence	readBoolean(): boolean
MessageParcel	readChar(): number	MessageSequence	readChar(): number
MessageParcel	readString(): string	MessageSequence	readString(): string
MessageParcel	readSequenceable(dataIn: Sequenceable) : boolean	MessageSequence	readSequenceable(dataIn: Parcelable) : void
MessageParcel	readByteArray(dataIn: number[]) : void	MessageSequence	readByteArray(dataIn: number[]) : void
MessageParcel	readByteArray(): number[]	MessageSequence	readByteArray(): number[]
MessageParcel	readShortArray(dataIn: number[]) : void	MessageSequence	readShortArray(dataIn: number[]) : void
MessageParcel	readShortArray(): number[]	MessageSequence	readShortArray(): number[]
MessageParcel	readIntArray(dataIn: number[]) : void	MessageSequence	readIntArray(dataIn: number[]) : void
MessageParcel	readIntArray() : number[]	MessageSequence	readIntArray() : number[]
MessageParcel	readLongArray(dataIn: number[]) : void	MessageSequence	readLongArray(dataIn: number[]) : void
MessageParcel	readLongArray(): number[]	MessageSequence	readLongArray(): number[]
MessageParcel	readFloatArray(dataIn: number[]) : void	MessageSequence	readFloatArray(dataIn: number[]) : void
MessageParcel	readFloatArray(): number[]	MessageSequence	readFloatArray(): number[]
MessageParcel	readDoubleArray(dataIn: number[]) : void	MessageSequence	readDoubleArray(dataIn: number[]) : void
MessageParcel	readDoubleArray(): number[]	MessageSequence	readDoubleArray(): number[]
MessageParcel	readBooleanArray(dataIn: boolean[]) : void	MessageSequence	readBooleanArray(dataIn: boolean[]) : void
MessageParcel	readBooleanArray(): boolean[]	MessageSequence	readBooleanArray(): boolean[]
MessageParcel	readCharArray(dataIn: number[]) : void	MessageSequence	readCharArray(dataIn: number[]) : void
MessageParcel	readCharArray(): number[]	MessageSequence	readCharArray(): number[]
MessageParcel	readStringArray(dataIn: string[]) : void	MessageSequence	readStringArray(dataIn: string[]) : void
MessageParcel	readStringArray(): string[]	MessageSequence	readStringArray(): string[]
MessageParcel	readSequenceableArray(sequenceableArray: Sequenceable[]): void	MessageSequence	readSequenceableArray(sequenceableArray: Parcelable[]): void
MessageParcel	readRemoteObjectArray(objects: IRemoteObject[]): void	MessageSequence	readRemoteObjectArray(objects: IRemoteObject[]): void
MessageParcel	readRemoteObjectArray(): IRemoteObject[]	MessageSequence	readRemoteObjectArray(): IRemoteObject[]
MessageParcel	static closeFileDescriptor(fd: number): void	MessageSequence	static closeFileDescriptor(fd: number): void
MessageParcel	static dupFileDescriptor(fd: number) :number	MessageSequence	static dupFileDescriptor(fd: number) :number
MessageParcel	containFileDescriptors(): boolean	MessageSequence	containFileDescriptors(): boolean
MessageParcel	writeFileDescriptor(fd: number): boolean	MessageSequence	writeFileDescriptor(fd: number): void
MessageParcel	readFileDescriptor(): number	MessageSequence	readFileDescriptor(): number
MessageParcel	writeAshmem(ashmem: Ashmem): boolean	MessageSequence	writeAshmem(ashmem: Ashmem): void
MessageParcel	readAshmem(): Ashmem	MessageSequence	readAshmem(): Ashmem
MessageParcel	writeRawData(rawData: number[], size: number): boolean	MessageSequence	writeRawData(rawData: number[], size: number): void
MessageParcel	readRawData(size: number): number[]	MessageSequence	readRawData(size: number): number[]
Sequenceable	marshalling(dataOut: MessageParcel): boolean	Parcelable	marshalling(dataOut: MessageSequence): boolean
Sequenceable	unmarshalling(dataIn: MessageParcel) : boolean	Parcelable	unmarshalling(dataIn: MessageSequence) : boolean
SendRequestResult	errCode: number	RequestResult	errCode: number
SendRequestResult	code: number	RequestResult	code: number
SendRequestResult	data: MessageParcel	RequestResult	data: MessageSequence
SendRequestResult	reply: MessageParcel	RequestResult	reply: MessageSequence
IRemoteObject	queryLocalInterface(descriptor: string): IRemoteBroker	NA	getLocalInterface(descriptor: string): IRemoteBroker
IRemoteObject	getInterfaceDescriptor(): string	NA	getDescriptor(): string
IRemoteObject	addDeathRecipient(recipient: DeathRecipient, flags: number): boolean	NA	registerDeathRecipient(recipient: DeathRecipient, flags: number): void
IRemoteObject	removeDeathRecipient(recipient: DeathRecipient, flags: number): boolean	NA	unregisterDeathRecipient(recipient: DeathRecipient, flags: number): void
IRemoteObject	NA	NA	sendMessageRequest(code: number, data: MessageSequence, reply: MessageSequence, options: MessageOption): Promise
IRemoteObject	sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: MessageOption, callback: AsyncCallback): void	NA	sendMessageRequest(code: number, data: MessageSequence, reply: MessageSequence, options: MessageOption,callback: AsyncCallback): void
MessageOption	NA	NA	isAsync(): boolean
MessageOption	NA	NA	setAsync(async: boolean): void
MessageOption	NA	NA	constructor(async?: boolean)
RemoteObject	queryLocalInterface(descriptor: string): IRemoteBroker	NA	getLocalInterface(descriptor: string): IRemoteBroker
RemoteObject	attachLocalInterface(localInterface: IRemoteBroker, descriptor: string): void	NA	modifyLocalInterface(localInterface: IRemoteBroker, descriptor: string): void
RemoteObject	getInterfaceDescriptor(): string	NA	getDescriptor(): string
RemoteObject	onRemoteRequestEx(code : number, data : MessageParcel, reply: MessageParcel, options : MessageOption): boolean | Promise	NA	onRemoteMessageRequest(code: number, data: MessageSequence, reply: MessageSequence, options: MessageOption): boolean | Promise
RemoteObject	sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: MessageOption): Promise	NA	sendMessageRequest(code: number, data: MessageSequence, reply: MessageSequence, options: MessageOption): Promise
RemoteObject	sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: MessageOption, callback: AsyncCallback): void	NA	sendMessageRequest(code: number, data: MessageSequence, reply: MessageSequence, options: MessageOption, callback: AsyncCallback): void
RemoteProxy	queryLocalInterface(interface: string): IRemoteBroker	NA	getLocalInterface(descriptor: string): IRemoteBroker
RemoteProxy	getInterfaceDescriptor(): string	NA	getDescriptor(): string
RemoteProxy	addDeathRecipient(recipient: DeathRecipient, flags: number): boolean	NA	registerDeathRecipient(recipient: DeathRecipient, flags: number): void
RemoteProxy	removeDeathRecipient(recipient: DeathRecipient, flags: number): boolean	NA	unregisterDeathRecipient(recipient: DeathRecipient, flags: number): void
RemoteProxy	NA	NA	sendMessageRequest(code: number, data: MessageSequence, reply: MessageSequence, options: MessageOption): Promise
RemoteProxy	sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: MessageOption, callback: AsyncCallback): void	NA	sendMessageRequest(code: number, data: MessageSequence, reply: MessageSequence, options: MessageOption, callback: AsyncCallback): void
IPCSkeleton	static flushCommands(object: IRemoteObject): number	NA	static flushCmdBuffer(object: IRemoteObject): void
IPCSkeleton	static setCallingIdentity(identity: string): boolean	NA	static restoreCallingIdentity(identity: string): void
Ashmem	static createAshmem(name: string, size: number): Ashmem	NA	static create(name: string, size: number): Ashmem
Ashmem	static createAshmemFromExisting(ashmem: Ashmem): Ashmem	NA	static create(ashmem: Ashmem): Ashmem
Ashmem	mapAshmem(mapType: number): boolean	NA	mapTypedAshmem(mapType: number): void
Ashmem	mapReadAndWriteAshmem(): boolean	NA	mapReadWriteAshmem(): void
Ashmem	mapReadOnlyAshmem(): boolean	NA	mapReadonlyAshmem(): void
Ashmem	setProtection(protectionType: number): boolean	NA	setProtectionType(protectionType: number): void
Ashmem	writeToAshmem(buf: number[], size: number, offset: number): boolean	NA	writeAshmem(buf: number[], size: number, offset: number): void
Ashmem	readFromAshmem(size: number, offset: number): number[]	NA	readAshmem(size: number, offset: number): number[]

适配指导

新增的接口以抛异常的方式返回错误码及对应的错误信息，以MessageParcel中的create接口为例，使用示例代码如下：

import rpc from '@ohos.rpc'

try {
    var data = rpc.MessageParcel.create();
    data.reclaim();
} catch (error) {
    console.info("create meassageParcel failed, errorCode = " + error.errCode);
    console.info("create meassageParcel failed, errorMessage = " + error.errorMessage);
}

更多接口的示例代码可参考RPC通信API文档。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙帐号子系统changeLog

harmony 鸿蒙媒体子系统JS API变更Changelog

harmony 鸿蒙设备管理changeLog

harmony 鸿蒙USB管理 changeLog

harmony 鸿蒙文件管理子系统ChangeLog

harmony 鸿蒙全球化子系统ChangeLog

harmony 鸿蒙输入法框架changeLog

harmony 鸿蒙多模输入changeLog

harmony 鸿蒙电源子系统ChangeLog

harmony 鸿蒙上传下载子系统ChangeLog