fix(patrol): make Android UiAutomation accessibility flags configurable

[Kendru98]

Make two Android UiAutomation accessibility flags configurable. Both opt-in, default = today's behavior.

Problem

• Android: UiAutomation is acquired with flags=0, suppressing all third-party AccessibilityServices for the whole session #3201: Patrol acquires UiAutomation with flags=0, so the platform suppresses every third-party AccessibilityService for the whole session.
• Android: native selectors can't find WebView content since 4.0 — root-caused to uiautomator 2.3.0 force-enabling FLAG_RETRIEVE_INTERACTIVE_WINDOWS #3178: uiautomator 2.3.0 force-enables FLAG_RETRIEVE_INTERACTIVE_WINDOWS, which stops some WebViews (e.g. Plaid Link) from populating their a11y tree, breaking $.native selectors.

Change

• AndroidAutomatorConfig.dontSuppressAccessibilityServices (dart-define PATROL_ANDROID_DONT_SUPPRESS_ACCESSIBILITY_SERVICES) → sets FLAG_DONT_SUPPRESS_ACCESSIBILITY_SERVICES via Configurator.
• AndroidAutomatorConfig.retrieveInteractiveWindows (dart-define PATROL_ANDROID_RETRIEVE_INTERACTIVE_WINDOWS) → false clears the flag.
• Flags flow config → ConfigureRequest contract → Automator.configure(); iOS ignores them.

Watch out

• uiautomator re-adds the flag when serviceInfo.flags != mCachedServiceFlags or every SERVICE_FLAGS_TIMEOUT (2s), so a plain setServiceInfo() won't stick — mCachedServiceFlags/mLastServiceFlagsTime are pinned via reflection (guarded, degrades to default on failure).
• FLAG_INCLUDE_NOT_IMPORTANT_VIEWS is preserved so normal selectors keep working.

Result

• 14 Dart tests pass (4 new, covering config defaults + ConfigureRequest threading).
• Native flag effect needs on-device verification (couldn't run an emulator here).

Closes #3201
Closes #3178

[Copilot]

Pull request overview

Adds configurable Android UiAutomation accessibility flags, addressing third-party accessibility-service suppression and WebView selector failures.

Changes:

• Adds Android configuration fields and Dart defines.
• Threads flags through cross-platform contracts.
• Applies and pins native Android accessibility flags.

Reviewed changes

Copilot reviewed 14 out of 16 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
schema.dart	Extends the configure contract.
packages/patrol/test/android_automator_config_test.dart	Tests defaults and request forwarding.
packages/patrol/lib/src/platform/platform_automator.dart	Exposes platform-level options.
packages/patrol/lib/src/platform/mobile/mobile_automator_native.dart	Adds extensible configure requests.
packages/patrol/lib/src/platform/contracts/contracts.g.dart	Serializes new fields.
packages/patrol/lib/src/platform/contracts/contracts.dart	Defines new contract fields.
packages/patrol/lib/src/platform/android/android_automator_native.dart	Forwards Android configuration.
packages/patrol/lib/src/platform/android/android_automator_config.dart	Defines flags and Dart defaults.
packages/patrol/darwin/patrol/Sources/PatrolImpl/AutomatorServer/Contracts.swift	Keeps Darwin contract compatible.
packages/patrol/CHANGELOG.md	Documents the options.
packages/patrol/android/src/main/kotlin/pl/leancode/patrol/contracts/Contracts.kt	Extends Android contracts.
packages/patrol/android/src/main/kotlin/pl/leancode/patrol/AutomatorServer.kt	Passes flags to the automator.
packages/patrol/android/src/main/kotlin/pl/leancode/patrol/Automator.kt	Applies Android accessibility flags.
packages/patrol_devtools_extension/lib/api/contracts.g.dart	Updates DevTools serialization.
packages/patrol_devtools_extension/lib/api/contracts.dart	Updates DevTools contracts.

Files not reviewed (2)

• packages/patrol/lib/src/platform/contracts/contracts.g.dart: Generated file
• packages/patrol_devtools_extension/lib/api/contracts.g.dart: Generated file

Suppressed comments (1)

packages/patrol/android/src/main/kotlin/pl/leancode/patrol/Automator.kt:128

• This option is also one-way: once a test sets it to false, clearRetrieveInteractiveWindowsFlag() removes the bit and pins mLastServiceFlagsTime to Long.MAX_VALUE; a later test requesting true skips this block, so uiautomator never restores its default flag. Handle the true transition by restoring the service flag and unpinning/synchronizing the UiDevice cache.

        if (!retrieveInteractiveWindows) {
            clearRetrieveInteractiveWindowsFlag()
        }

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[jBorkowska]

Is this method used anywhere else than in the method above? Seems redundant

[jBorkowska]

No default value?