Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 6e921575 authored by Hyung Tae Kim's avatar Hyung Tae Kim
Browse files

Unhide AccessibilityWindowInfo#refresh for window state checks 

Make AccessibilityWindowInfo#refresh public. This allows
accessibility clients to check and refresh the cached window
state to avoid accessing stale windows.

See go/android-a11y-api-proposal-unhide-accessibilitywindowinfo-refresh

Flag: android.view.accessibility.enable_refresh_window_info
Bug: 405371739 (FR)
Bug: 415818857
Test: atest AccessibilityWindowReportingTest#testRefreshWindowInfo
Change-Id: Ie63bbeb35cf678a797a9a94f824486cc32014a46
parent 3ce9dab9

core/api/current.txt

+1 −0
Original line number Diff line number Diff line
@@ -56992,6 +56992,7 @@ package android.view.accessibility { 
    method public static android.view.accessibility.AccessibilityWindowInfo obtain();

    method public static android.view.accessibility.AccessibilityWindowInfo obtain(android.view.accessibility.AccessibilityWindowInfo);

    method public void recycle();

    method @FlaggedApi("android.view.accessibility.enable_refresh_window_info") public boolean refresh();

    method public void writeToParcel(android.os.Parcel, int);

    field @NonNull public static final android.os.Parcelable.Creator<android.view.accessibility.AccessibilityWindowInfo> CREATOR;

    field public static final int TYPE_ACCESSIBILITY_OVERLAY = 4; // 0x4

core/java/android/view/accessibility/AccessibilityWindowInfo.java

+3 −2
Original line number Diff line number Diff line
@@ -659,10 +659,11 @@ public final class AccessibilityWindowInfo implements Parcelable { 
     * <p>

     * <strong>Note:</strong> If this method returns false this info is obsolete

     * since it represents a window that is no longer exist.

     * </p>

     *

     * @hide

     * @return {@code true} if the refresh succeeded. {@code false} if this window is

     * no longer in the window tree (and thus it has become stale).

     */

    @FlaggedApi(Flags.FLAG_ENABLE_REFRESH_WINDOW_INFO)

    public boolean refresh() {

        if (mConnectionId == UNDEFINED_CONNECTION_ID || mId == UNDEFINED_WINDOW_ID) {

            return false;

core/java/android/view/accessibility/flags/accessibility_flags.aconfig

+8 −0
Original line number Diff line number Diff line
@@ -117,6 +117,14 @@ flag { 
    is_exported: true

}



flag {

    name: "enable_refresh_window_info"

    namespace: "accessibility"

    is_exported: true

    description: "Makes AccessibilityWindowInfo#refresh public for window state checks"

    bug: "405371739"

}



flag {

    name: "enable_system_pinch_zoom_gesture"

    namespace: "accessibility"