Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

appium-uiautomator2-server

appium1.1mApache-2.07.1.11

A netty server with uiautomator2 handlers

appium, android, uiautomator2

readme

appium-uiautomator2-server

NPM version Downloads

A netty server that runs on the device listening for commands and executes using UiAutomator V2.

building project

build the android project using below commands

gradle clean assembleServerDebug assembleServerDebugAndroidTest

Starting server

push both src and test apks to the device and execute the instrumentation tests.

adb shell am instrument -w io.appium.uiautomator2.server.test/androidx.test.runner.AndroidJUnitRunner

run unitTest

build the unitTest flavor using the below commands

gradle clean assembleE2ETestDebug assembleE2ETestDebugAndroidTest

unitTest flavor contains tests for handlers and can be invoked by using following command

gradle clean connectedE2ETestDebugAndroidTest

the above command takes care about installing the AUT apk in to the testing device/emulator before running the tests.

you can also invoke the test using below command

adb shell am instrument -w io.appium.uiautomator2.e2etest.test/androidx.test.runner.AndroidJUnitRunner

Note: AUT apk should be installed before executing above command.

Other Sections:

changelog

7.1.11 (2025-01-07)

Miscellaneous Chores

7.1.10 (2025-01-07)

Miscellaneous Chores

  • deps: bump org.json:json from 20240303 to 20241224 in /app (#677) (2997064)

7.1.9 (2024-12-31)

Bug Fixes

  • stuck client when socket client never initializes (#676) (34161a3)

7.1.8 (2024-12-24)

Miscellaneous Chores

7.1.7 (2024-12-06)

Miscellaneous Chores

  • deps-dev: bump @appium/support from 5.1.8 to 6.0.0 (#674) (8939102)

7.1.6 (2024-12-03)

Miscellaneous Chores

  • deps: bump com.android.tools.build:gradle in /app (#673) (38530f4)

7.1.5 (2024-11-21)

Miscellaneous Chores

  • deps: bump org.robolectric:robolectric in /app (#672) (7f2208c)

7.1.4 (2024-11-18)

Miscellaneous Chores

  • deps: bump com.github.bjoernq:unmockplugin in /app (#670) (3b51bb7)
  • deps: bump net.gcardone.junidecode:junidecode in /app (#671) (b58e16f)

7.1.3 (2024-11-15)

Miscellaneous Chores

  • deps: bump org.robolectric:robolectric from 4.13 to 4.14 in /app (#669) (aeee62f)

7.1.2 (2024-11-02)

Miscellaneous Chores

  • deps: bump com.android.tools.build:gradle in /app (#668) (fda3fe0)

7.1.1 (2024-10-15)

Miscellaneous Chores

  • deps: bump com.android.tools.build:gradle in /app (#666) (5dd96da)

7.1.0 (2024-10-05)

Features

7.0.28 (2024-10-03)

Miscellaneous Chores

  • deps: bump com.android.tools.build:gradle in /app (#664) (51ea65a)

7.0.27 (2024-09-19)

Bug Fixes

  • Revert "fix: Always make sure we put valid utf8-encoded strings into attribut…" (#663) (07f7aec)

7.0.26 (2024-09-18)

Miscellaneous Chores

  • deps: bump com.android.tools.build:gradle in /app (#662) (3baa6b7)

7.0.25 (2024-09-03)

Miscellaneous Chores

  • deps: bump com.android.tools.build:gradle in /app (#660) (73782b2)

7.0.24 (2024-09-03)

Bug Fixes

  • Always make sure we put valid utf8-encoded strings into attribute values (#661) (1151461)

7.0.23 (2024-08-15)

Miscellaneous Chores

  • deps: bump androidx.test:runner from 1.6.1 to 1.6.2 in /app (#659) (81deed1)

7.0.22 (2024-08-09)

Miscellaneous Chores

  • deps: bump com.android.tools.build:gradle in /app (#658) (7fcb4e1)

7.0.21 (2024-08-02)

Miscellaneous Chores

  • Replace fancy-log dependency with appium logger (#657) (015c47a)

7.0.20 (2024-07-12)

Miscellaneous Chores

  • deps: bump com.android.tools.build:gradle in /app (#656) (e128df3)

7.0.19 (2024-07-09)

Miscellaneous Chores

  • deps: bump org.robolectric:robolectric in /app (#655) (8d4d3a3)

7.0.18 (2024-07-01)

Miscellaneous Chores

  • deps: bump com.github.bjoernq:unmockplugin in /app (#653) (81c79f8)

7.0.17 (2024-06-28)

Miscellaneous Chores

  • deps: bump androidx.test:runner from 1.5.2 to 1.6.1 in /app (#652) (cfcb2ce)

7.0.16 (2024-06-27)

Miscellaneous Chores

  • deps: bump androidx.test:core from 1.6.0 to 1.6.1 in /app (#651) (149680b)
  • deps: bump androidx.test.ext:junit from 1.2.0 to 1.2.1 in /app (#650) (5564ccd)

7.0.15 (2024-06-25)

Miscellaneous Chores

  • deps: bump androidx.test:core from 1.5.0 to 1.6.0 in /app (#648) (e04763f)
  • deps: bump androidx.test.ext:junit from 1.1.5 to 1.2.0 in /app (#647) (a202cbe)

7.0.14 (2024-06-18)

Miscellaneous Chores

  • Expose standard xml source attributes in the corresponding step (#646) (5facb14)

7.0.13 (2024-06-16)

Bug Fixes

  • The amount of runs to unschedule an action (#645) (0992f59)

7.0.12 (2024-06-15)

Miscellaneous Chores

7.0.11 (2024-06-14)

Miscellaneous Chores

  • deps: bump com.android.tools.build:gradle in /app (#643) (ad1a9a7)

7.0.10 (2024-06-04)

Miscellaneous Chores

  • deps-dev: bump semantic-release from 23.1.1 to 24.0.0 and conventional-changelog-conventionalcommits to 8.0.0 (#640) (fecffe9)

7.0.9 (2024-05-20)

Miscellaneous Chores

  • deps: bump com.google.code.gson:gson in /app (#637) (4ee9449)
  • deps: bump org.robolectric:robolectric in /app (#636) (6bdcd84)

7.0.8 (2024-05-16)

Miscellaneous Chores

  • Update dev dependencies (e0e7cad)

7.0.7 (2024-05-04)

Miscellaneous Chores

  • deps: bump com.android.tools.build:gradle in /app (#631) (5bc5108)

7.0.6 (2024-05-04)

Miscellaneous Chores

  • deps: bump net.gcardone.junidecode:junidecode in /app (#627) (6d29fc9)
  • deps: bump org.robolectric:robolectric in /app (#624) (84141da)

7.0.5 (2024-03-19)

Miscellaneous Chores

  • deps: bump com.android.tools.build:gradle in /app (#620) (007258c)

7.0.4 (2024-03-08)

Miscellaneous Chores

  • deps: bump org.json:json from 20240205 to 20240303 in /app (#618) (649e086)

7.0.3 (2024-03-04)

Miscellaneous Chores

  • deps: bump com.android.tools.build:gradle in /app (#616) (5ba5a1e)

7.0.2 (2024-03-04)

Miscellaneous Chores

7.0.1 (2024-02-23)

Miscellaneous Chores

  • deps: bump androidx.test.uiautomator:uiautomator in /app (#615) (77ecca6)

7.0.0 (2024-02-09)

⚠ BREAKING CHANGES

  • Removed the following obsolete endpoints in favour of W3C actions :
  • /session/:sessionId/appium/tap
  • /session/:sessionId/touch/perform
  • /session/:sessionId/touch/longclick
  • /session/:sessionId/touch/drag
  • /session/:sessionId/touch/flick
  • /session/:sessionId/touch/multi/perform
  • /session/:sessionId/touch/down
  • /session/:sessionId/touch/up
  • /session/:sessionId/touch/move
  • The /session/:sessionId/touch/scroll endpoint has been renamed to /session/:sessionId/gestures/scroll_to

Features

  • Remove obsolete endpoints that are part of JSONWP touch spec (#612) (08bf652)

6.0.9 (2024-02-09)

Miscellaneous Chores

  • deps: bump androidx.test.uiautomator:uiautomator in /app (#611) (497ddc6)

6.0.8 (2024-02-08)

Miscellaneous Chores

  • deps: bump org.json:json from 20231013 to 20240205 in /app (#610) (4755a29)

6.0.7 (2024-01-30)

Bug Fixes

6.0.6 (2024-01-26)

Miscellaneous Chores

  • deps-dev: bump appium-adb from 11.1.0 to 12.0.2 (#607) (175139e)

6.0.5 (2024-01-25)

Miscellaneous Chores

  • deps: bump com.android.tools.build:gradle in /app (#606) (34b7a77)

6.0.4 (2024-01-19)

Miscellaneous Chores

  • deps-dev: bump semantic-release from 22.0.12 to 23.0.0 (#599) (d3b11a4)

6.0.3 (2024-01-10)

Bug Fixes

  • Revert the clearCache change for API 33+ (#597) (719122f)

6.0.2 (2024-01-09)

Miscellaneous Chores

  • get AccessibilityNodeInfo via obtain for lower versions (#595) (0770985)

6.0.1 (2024-01-06)

Miscellaneous Chores

  • deps: bump com.android.tools.build:gradle in /app (#594) (0f4c454)

5.15.3 (2023-12-31)

Bug Fixes

  • add an empty AccessibilityNodeInfo creation for future androidx.test.uiautomator:uiautomator:2.3.0 update (#589) (182d338)

5.15.2 (2023-12-30)

Bug Fixes

  • use displayManager.getDisplay only for upcoming androidx.test.uiautomator:uiautomator:2.3.0-beta01 (#588) (61af265)

5.15.1 (2023-12-30)

Miscellaneous Chores

5.15.0 (2023-12-29)

Features

5.14.0 (2023-12-28)

Features

  • get default display via displaymanager (#585) (5c731ce)

5.13.0 (2023-12-26)

Features

  • bump targetSdkVersion from 30 to 31, and to 32 (#582) (1b0563a)

5.12.18 (2023-12-23)

Miscellaneous Chores

  • deps: bump com.github.vbmacher:java-cup-runtime in /app (#581) (49965bd)

5.12.17 (2023-12-02)

Miscellaneous Chores

  • deps: bump com.android.tools.build:gradle in /app (#576) (c6a06d5)

5.12.16 (2023-11-01)

Miscellaneous Chores

  • deps: bump org.robolectric:robolectric in /app (#571) (a0c0d71)

5.12.15 (2023-10-30)

Miscellaneous Chores

  • deps: bump org.robolectric:robolectric in /app (#570) (fa622c8)

5.12.14 (2023-10-23)

Miscellaneous Chores

  • deps-dev: bump eslint-config-prettier from 8.10.0 to 9.0.0 (#568) (b04c54e)
  • deps: bump com.github.vbmacher:java-cup-runtime in /app (#567) (e802176)

5.12.13 (2023-10-23)

Miscellaneous Chores

5.12.12 (2023-10-22)

Miscellaneous Chores

  • Remove espresso from dependencies list (#563) (6a2d44d)

5.12.11 (2023-10-21)

Miscellaneous Chores

  • Remove dependency to apache commons lib (#562) (6820bc8)

5.12.10 (2023-10-21)

Miscellaneous Chores

  • deps: bump xerces:xercesImpl from 2.12.1 to 2.12.2 in /app (#559) (b0b88d7)

5.12.9 (2023-10-21)

Miscellaneous Chores

  • deps: bump org.json:json from 20190722 to 20231013 in /app (#553) (f8a7edf)

5.12.8 (2023-10-21)

Miscellaneous Chores

5.12.7 (2023-10-19)

Miscellaneous Chores

  • deps-dev: bump appium-adb from 9.14.12 to 11.0.1 (#540) (f0df958)
  • deps-dev: bump semantic-release from 21.1.2 to 22.0.5 (#537) (a422db1)

5.12.6 (2023-09-22)

Bug Fixes

5.12.5 (2023-08-28)

Miscellaneous Chores

  • deps-dev: bump conventional-changelog-conventionalcommits (#529) (adf3ec8)

5.12.4 (2023-08-25)

Miscellaneous Chores

  • deps-dev: bump semantic-release from 20.1.3 to 21.1.0 (#528) (e1fd854)

5.12.3 (2023-08-18)

Miscellaneous Chores

  • remove "/wd/hub" prefix to improve compatibility (#526) (ac450c3)

5.12.2 (2023-07-03)

Miscellaneous Chores

  • Improve exception stacktraces on actions parsing (#522) (fae33d4)

5.12.1 (2023-06-29)

Bug Fixes

  • Ignore start coordinates for the very first move action (#518) (8b505f2)

5.12.0 (2023-06-20)

Features

  • add snapshotMaxDepth to be able to detect deep depth elements (#517) (9a40742)

5.11.1 (2023-06-07)

Miscellaneous Chores

  • deps-dev: bump conventional-changelog-conventionalcommits (#514) (bd43b55)

5.11.0 (2023-06-02)

Features

  • Add a possibility of scheduling and unscheduling actions (#510) (3d9f108)

5.10.0 (2023-05-31)

Features

  • settings API to get the topmost window from active package (#512) (60bded2)

5.9.1 (2023-05-28)

Bug Fixes

  • Revert "feat: settings API to get the topmost window from active package (#508)" (#509) (a43480b)

5.9.0 (2023-05-26)

Features

  • settings API to get the topmost window from active package (#508) (bf4c708)

5.8.2 (2023-04-28)

Bug Fixes

  • Tune the line break replacement logic (#506) (77fb1d2)

5.8.1 (2023-04-24)

Miscellaneous Chores

5.8.0 (2023-03-09)

Features

5.7.8 (2023-02-07)

Miscellaneous Chores

  • Tune parameter value in the error message (5ef9f65)

5.7.7 (2023-01-17)

Miscellaneous Chores

  • deps-dev: bump semantic-release from 19.0.5 to 20.0.2 (#499) (195066d)

5.7.6 (2022-12-14)

Bug Fixes

  • Use Build.VERSION.SDK_INT instead of API_LEVEL_ACTUAL (#493) (0111c09)

5.7.5 (2022-12-01)

Code Refactoring

  • Reset session-specific settings before a new session starts (#487) (091cb02)

Miscellaneous Chores

5.7.4 (2022-11-06)