无障碍子系统Changelog

cl.accessibility.1 Accessibility扩展服务相关API废弃

访问级别

公开接口

变更原因

为提升系统安全性，无障碍不再开放扩展服务接口能力。

变更影响

1. 该变更为不兼容变更；

2. Accessibility模块扩展服务接口废弃；

3. 设置-辅助功能下，不再提供已安装的服务查询和管理功能。

变更发生版本

从OpenHarmony SDK 5.0.0.35开始。

变更的接口/组件

1. 以下接口废弃：

|所属包名 |方法声明 |起始API Level| |———–|————————-|————————-| |AccessibilityExtensionContext|setTargetBundleName(targetNames: Array<string>, callback: AsyncCallback<void>): void; |9 | |AccessibilityExtensionContext|setTargetBundleName(targetNames: Array<string>): Promise<void>; |9 | |AccessibilityExtensionContext|getFocusElement(isAccessibilityFocus: boolean, callback: AsyncCallback<AccessibilityElement>): void; |9 | |AccessibilityExtensionContext|getFocusElement(isAccessibilityFocus?: boolean): Promise<AccessibilityElement>; |9 | |AccessibilityExtensionContext|getFocusElement(callback: AsyncCallback<AccessibilityElement>): void; |9 | |AccessibilityExtensionContext|getWindowRootElement(windowId: number, callback: AsyncCallback<AccessibilityElement>): void;|9 | |AccessibilityExtensionContext|getWindowRootElement(windowId?: number): Promise<AccessibilityElement>;|9 | |AccessibilityExtensionContext| getWindowRootElement(callback: AsyncCallback<AccessibilityElement>): void;|9 | |AccessibilityExtensionContext| getWindows(displayId: number, callback: AsyncCallback<Array<AccessibilityElement>>): void;|9 | |AccessibilityExtensionContext| getWindows(displayId?: number): Promise<Array<AccessibilityElement>>;|9 | |AccessibilityExtensionContext| getWindows(callback: AsyncCallback<Array<AccessibilityElement>>): void;|9 | |AccessibilityExtensionContext| injectGestureSync(gesturePath: GesturePath): void;|10 | |AccessibilityExtensionContext| attributeNames<T extends keyof ElementAttributeValues>(callback: AsyncCallback<Array<T>>): void;|9 | |AccessibilityExtensionContext| attributeNames<T extends keyof ElementAttributeValues>(): Promise<Array<T>>;|9 | |AccessibilityExtensionContext| attributeValue<T extends keyof ElementAttributeValues>(attributeName: T, callback: AsyncCallback<ElementAttributeValues[T]>): void;|9 | |AccessibilityExtensionContext|attributeValue<T extends keyof ElementAttributeValues>(attributeName: T): Promise<ElementAttributeValues[T]>;|9 | |AccessibilityExtensionContext| actionNames(callback: AsyncCallback<Array<string>>): void;|9 | |AccessibilityExtensionContext| actionNames(): Promise<Array<string>>;|9 | |AccessibilityExtensionContext|performAction(actionName: string, parameters: object, callback: AsyncCallback<void>): void;|9 | |AccessibilityExtensionContext| performAction(actionName: string, parameters?: object): Promise<void>;|9 | |AccessibilityExtensionContext| performAction(actionName: string, callback: AsyncCallback<void>): void;|9 | |AccessibilityExtensionContext| findElement(type: ‘content’, condition: string, callback: AsyncCallback<Array<AccessibilityElement>>): void;|9 | |AccessibilityExtensionContext|findElement(type: ‘content’, condition: string): Promise<Array<AccessibilityElement>>;|9 | |AccessibilityExtensionContext|findElement(type: ‘focusType’, condition: FocusType, callback: AsyncCallback<AccessibilityElement>): void;|9 | |AccessibilityExtensionContext|findElement(type: ‘focusType’, condition: FocusType): Promise<AccessibilityElement>;|9 | |AccessibilityExtensionContext|findElement(type: ‘focusDirection’, condition: FocusDirection, callback: AsyncCallback<AccessibilityElement>): void;|9 | |AccessibilityExtensionContext| findElement(type: ‘focusDirection’, condition: FocusDirection): Promise<AccessibilityElement>;|9 | |ohos.accessibility|function on(type: ‘accessibilityStateChange’, callback: Callback<boolean>): void;|7 | |ohos.accessibility| function on(type: ‘touchGuideStateChange’, callback: Callback<boolean>): void;|7 | |ohos.accessibility|function off(type: ‘accessibilityStateChange’, callback?: Callback<boolean>): void;|7 | |ohos.accessibility|function off(type: ‘touchGuideStateChange’, callback?: Callback<boolean>): void;|7 | |ohos.accessibility| function getCaptionsManager(): CaptionsManager;|8 | |ohos.application.AccessibilityExtensionAbility| onConnect(): void;|9 | |ohos.application.AccessibilityExtensionAbility| onDisconnect(): void;|9 | |ohos.application.AccessibilityExtensionAbility| onAccessibilityEvent(event: AccessibilityEvent): void;|9 | |ohos.application.AccessibilityExtensionAbility| onKeyEvent(keyEvent: KeyEvent): boolean;|9 | |ohos.accessibility.GesturePath| constructor(durationTime: number);|9 | |ohos.accessibility.GesturePoint| constructor(positionX: number, positionY: number);|9 |

1. 以下接口删除：

|所属包名 |方法声明 |起始API Level| |———–|————————-|————————-| |AccessibilityExtensionContext|getCursorPosition(callback: AsyncCallback<number>): void; |12 | |AccessibilityExtensionContext|getCursorPosition(): Promise<number>; |12 | |AccessibilityExtensionContext|findElement(type: ‘textType’, condition: string): Promise<Array<AccessibilityElement>>; |12 | |AccessibilityExtensionContext|findElement(type: ‘elementId’, condition: number): Promise<AccessibilityElement>; |12 |

1. 设置-辅助功能下，不再提供已安装的服务查询和管理功能。

适配指导

此变更开发者无需适配。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkCompiler子系统Changelog

harmony 鸿蒙ArkTS子系统变更说明

harmony 鸿蒙cl.arkui.1 Menu组件箭头离宿主节点默认安全边距变更

harmony 鸿蒙包管理子系统变更说明

harmony 鸿蒙窗口子系统变更说明