Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: Add a warning about -android uiautomator deprecation #813

Merged
merged 1 commit into from
Aug 9, 2024
Merged

docs: Add a warning about -android uiautomator deprecation #813

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 8 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -236,6 +236,12 @@ className | This strategy is mapped to the native UiAutomator's `By.clazz` [loca
-android uiautomator | This strategy is mapped to the native UiAutomator's `UiSelector` [locator](https://developer.android.com/reference/androidx/test/uiautomator/UiSelector)). It is even possible to perform some advanced operations, like scrolling, with this locator type. Check [Guide on UiAutomator Locator Types](docs/uiautomator-uiselector.md) | `⭐⭐⭐⭐` | new UiScrollable(new UiSelector().resourceId(\"android:id/list\")).scrollIntoView(new UiSelector().text(\"Radio Group\"))
xpath | For elements lookup Xpath strategy the driver uses the same XML tree that is generated by page source API. Only Xpath 1.0 is supported for appium-uiatomator2-server versions below 4.25.0. All server versions starting from 4.25.0 support both Xpath 1.0 and 2.0 | `⭐⭐⭐` | By.xpath("//android.view.View[@text=\"Regular\" and @checkable=\"true\"]")

> [!WARNING]
> Google is going to [deprecate](https://developer.android.com/training/testing/other-components/ui-automator#ui-automator)
> and remove `UiCollection`, `UiObject`, `UiScrollable`, and `UiSelector` support from the UiAutomator framework.
> This will render all `-android uiautomator`-based locators invalid, so please keep it in mind while
> using them or plan to use them in the future.


## Parallel Tests

Expand Down Expand Up @@ -1840,8 +1846,8 @@ This exception happens due to a known bug in the [Eclipse's Psychopath](https://

The UiAutomator2 driver provides multiple options for touch gestures automation.
For simple gestures, like swipe, scroll, drag, double click, fling or pinch use the corresponding
[gesture shortcuts](#mobile-gesture-commands).
You may also use [UiScrollable-based UiAutomator locators](./docs/uiautomator-uiselector.md)
[gesture shortcuts](#mobile-gesture-commands).
You may also use [UiScrollable-based UiAutomator locators](./docs/uiautomator-uiselector.md)
to automate various scrolling behaviours.
For more sophisticated gestures
consider using [W3C actions](https://w3c.github.io/webdriver/#actions).
Expand Down