https://github.com/appium/appium-uiautomator2-server

Appium UiAutomator/UiObject2-based server for Android UI automation. This module is used by appium-uiautomator2-driver component
https://github.com/appium/appium-uiautomator2-server

android appium appium-android java server uiautomator2

Last synced: 20 days ago
JSON representation

Appium UiAutomator/UiObject2-based server for Android UI automation. This module is used by appium-uiautomator2-driver component

• Host: GitHub
• URL: https://github.com/appium/appium-uiautomator2-server
• Owner: appium
• License: apache-2.0
• Created: 2016-03-07T05:18:34.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2025-05-31T19:35:28.000Z (29 days ago)
• Last Synced: 2025-05-31T21:36:34.376Z (29 days ago)
• Topics: android, appium, appium-android, java, server, uiautomator2
• Language: Java
• Homepage:
• Size: 3.22 MB
• Stars: 361
• Watchers: 37
• Forks: 248
• Open Issues: 68
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        

# appium-uiautomator2-server

[![NPM version](http://img.shields.io/npm/v/appium-uiautomator2-server.svg)](https://npmjs.org/package/appium-uiautomator2-server)

[![Downloads](http://img.shields.io/npm/dm/appium-uiautomator2-server.svg)](https://npmjs.org/package/appium-uiautomator2-server)

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

`./gradlew clean assembleServerDebug assembleServerDebugAndroidTest`

You can also build with specific version name and version code using this command.

`./gradlew -PversionName=8.0.0 -PversionCode=300 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

`./gradlew clean assembleE2ETestDebug assembleE2ETestDebugAndroidTest`

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

`./gradlew 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

* [WIKI](https://github.com/appium/appium-uiautomator2-server/wiki)

* [Version Release](https://github.com/appium/appium-uiautomator2-server/blob/master/doc/release.md)