harmony 鸿蒙Device Management Changelog

2023-10-30
浏览 (269)

Device Management Changelog

cl.device_manager.1 API Permission Change

Added permission verification for some APIs.

Change Impact

The apps developed using OpenHarmony 4.0.8.2 or later must have the corresponding permissions. Otherwise, the related APIs cannot be called.

Key API/Component Changes

Module	Class	Method/Attribute/Enum/Constant	Added Permission
@ohos.distributedHardware.deviceManager	deviceManager	function release(): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function getTrustedDeviceListSync(): Array<DeviceInfo>	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function getTrustedDeviceListSync(isRefresh: boolean): Array<DeviceInfo>;	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function getTrustedDeviceList(callback:AsyncCallback<Array<DeviceInfo>>): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function getTrustedDeviceList(): Promise<Array<DeviceInfo>>	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function getLocalDeviceInfoSync(): DeviceInfo	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function getLocalDeviceInfo(callback:AsyncCallback<DeviceInfo>): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function getLocalDeviceInfo(): Promise<DeviceInfo>	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function getDeviceInfo(networkId: string, callback:AsyncCallback<DeviceInfo>): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function getDeviceInfo(networkId: string): Promise<DeviceInfo>	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function startDeviceDiscovery(subscribeInfo: SubscribeInfo): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function startDeviceDiscovery(subscribeInfo: SubscribeInfo, filterOptions?: string): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function stopDeviceDiscovery(subscribeId: number): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function publishDeviceDiscovery(publishInfo: PublishInfo): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function unPublishDeviceDiscovery(publishId: number): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function authenticateDevice(deviceInfo: DeviceInfo, authParam: AuthParam, callback: AsyncCallback<{deviceId: string, pinToken ?: number}>): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function unAuthenticateDevice(deviceInfo: DeviceInfo): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function verifyAuthInfo(authInfo: AuthInfo, callback: AsyncCallback<{deviceId: string, level: number}>): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function setUserOperation(operateAction: number, params: string): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function requestCredentialRegisterInfo(requestInfo: string, callback: AsyncCallback<{registerInfo: string}>): void;	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function importCredential(credentialInfo: string, callback: AsyncCallback<{resultInfo: string}>): void;	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function deleteCredential(queryInfo: string, callback: AsyncCallback<{resultInfo: string}>): void;	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function on(type: ‘uiStateChange’, callback: Callback<{ param: string}>): void;	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function off(type: ‘uiStateChange’, callback?: Callback<{ param: string}>): void;	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function on(type: ‘deviceStateChange’, callback: Callback<{ action: DeviceStateChangeAction, device: DeviceInfo }>): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function off(type: ‘deviceStateChange’, callback?: Callback<{ action: DeviceStateChangeAction, device: DeviceInfo }>): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function on(type: ‘deviceFound’, callback: Callback<{ subscribeId: number, device: DeviceInfo }>): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function off(type: ‘deviceFound’, callback?: Callback<{ subscribeId: number, device: DeviceInfo }>): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function on(type: ‘discoverFail’, callback: Callback<{ subscribeId: number, reason: number }>): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function off(type: ‘discoverFail’, callback?: Callback<{ subscribeId: number, reason: number }>): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function on(type: ‘publishSuccess’, callback: Callback<{ publishId: number }>): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function off(type: ‘publishSuccess’, callback?: Callback<{ publishId: number }>): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function on(type: ‘publishFail’, callback: Callback<{ publishId: number, reason: number }>): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function off(type: ‘publishFail’, callback?: Callback<{ publishId: number, reason: number }>): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function on(type: ‘serviceDie’, callback: () => void): void	ohos.permission.ACCESS_SERVICE_DM
@ohos.distributedHardware.deviceManager	deviceManager	function off(type: ‘serviceDie’, callback?: () => void): void	ohos.permission.ACCESS_SERVICE_DM

Adaptation Guide

Apply for the corresponding permissions for your application before these APIs are called.

cl.device_manager.2 Permission Verification for All System APIs

Added permission verification for all system APIs.

Change Impact

Non-system applications and applications without system API permission cannot call system APIs.

Key API/Component Changes

System API permission verification is performed on all APIs. The table below describes the APIs.

API/Enum/Variable	Type	System API
createDeviceManager(bundleName: string, callback: AsyncCallback<DeviceManager>): void;	interface	Yes
release(): void	interface	Yes
getTrustedDeviceListSync(): Array<DeviceInfo>	interface	Yes
getTrustedDeviceListSync(isRefresh: boolean): Array<DeviceInfo>;	interface	Yes
getTrustedDeviceList(callback:AsyncCallback<Array<DeviceInfo>>): void	interface	Yes
getTrustedDeviceList(): Promise<Array<DeviceInfo>>	interface	Yes
getLocalDeviceInfoSync(): DeviceInfo	interface	Yes
getLocalDeviceInfo(callback:AsyncCallback<DeviceInfo>): void	interface	Yes
getLocalDeviceInfo(): Promise<DeviceInfo>	interface	Yes
getDeviceInfo(networkId: string, callback:AsyncCallback<DeviceInfo>): void	interface	Yes
getDeviceInfo(networkId: string): Promise<DeviceInfo>	interface	Yes
startDeviceDiscovery(subscribeInfo: SubscribeInfo): void	interface	Yes
startDeviceDiscovery(subscribeInfo: SubscribeInfo, filterOptions?: string): void	interface	Yes
stopDeviceDiscovery(subscribeId: number): void	interface	Yes
publishDeviceDiscovery(publishInfo: PublishInfo): void	interface	Yes
unPublishDeviceDiscovery(publishId: number): void	interface	Yes
authenticateDevice(deviceInfo: DeviceInfo, authParam: AuthParam, callback: AsyncCallback<{deviceId: string, pinToken ?: number}>): void	interface	Yes
unAuthenticateDevice(deviceInfo: DeviceInfo): void	interface	Yes
verifyAuthInfo(authInfo: AuthInfo, callback: AsyncCallback<{deviceId: string, level: number}>): void	interface	Yes
setUserOperation(operateAction: number, params: string): void	interface	Yes
requestCredentialRegisterInfo(requestInfo: string, callback: AsyncCallback<{registerInfo: string}>): void;	interface	Yes
importCredential(credentialInfo: string, callback: AsyncCallback<{resultInfo: string}>): void;	interface	Yes
deleteCredential(queryInfo: string, callback: AsyncCallback<{resultInfo: string}>): void;	interface	Yes
on(type: ‘uiStateChange’, callback: Callback<{ param: string}>): void;	interface	Yes
off(type: ‘uiStateChange’, callback?: Callback<{ param: string}>): void;	interface	Yes
on(type: ‘deviceStateChange’, callback: Callback<{ action: DeviceStateChangeAction, device: DeviceInfo }>): void	interface	Yes
off(type: ‘deviceStateChange’, callback?: Callback<{ action: DeviceStateChangeAction, device: DeviceInfo }>): void	interface	Yes
on(type: ‘deviceFound’, callback: Callback<{ subscribeId: number, device: DeviceInfo }>): void	interface	Yes
off(type: ‘deviceFound’, callback?: Callback<{ subscribeId: number, device: DeviceInfo }>): void	interface	Yes
on(type: ‘discoverFail’, callback: Callback<{ subscribeId: number, reason: number }>): void	interface	Yes
off(type: ‘discoverFail’, callback?: Callback<{ subscribeId: number, reason: number }>): void	interface	Yes
on(type: ‘publishSuccess’, callback: Callback<{ publishId: number }>): void	interface	Yes
off(type: ‘publishSuccess’, callback?: Callback<{ publishId: number }>): void	interface	Yes
on(type: ‘publishFail’, callback: Callback<{ publishId: number, reason: number }>): void	interface	Yes
off(type: ‘publishFail’, callback?: Callback<{ publishId: number, reason: number }>): void	interface	Yes
on(type: ‘serviceDie’, callback: () => void): void	interface	Yes
off(type: ‘serviceDie’, callback?: () => void): void	interface	Yes