Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
libs
nanohttpd @ 559a327
src/com/github/uiautomatorstub
.gitignore
.gitmodules
LICENSE
README.md
ant.properties
build.xml
custom_rules.xml
local.properties
project.properties

README.md

It's moved to android-uiautomator-server, which is based on android suppot library.

Purpose

UIAutomator is a great tool to perform Android UI testing, but to do it, you have to write java code, compile it, install the jar, and run. It's a complex steps for all testers...

This project is to build a light weight jsonrpc server in Android device, so that we can just write PC side script to write UIAutomator tests.

Build

  • Update local.properties file with your android sdk path.

  • Set ANDROID_HOME env variable (.bashrc or .bash_profile).

  • Install Ant if you have not.

  • Run command:

      $ git submodule init
      $ git submodule update
      $ ant build # compile
      $ ant install # install jar file to device via adb
    

Run the jsonrcp server on Android device

$ adb shell uiautomator runtest  uiautomator-stub.jar bundle.jar -c com.github.uiautomatorstub.Stub
$ adb forward tcp:9008 tcp:9008 # tcp forward

How to use

Next is a python example using jsonrpclib. Before you run it, make sure install jsonrpclib via pip install jsonrpclib.

import jsonrpclib
server = jsonrpclib.Server('http://localhost:9008/jsonrpc/0')

server.wakeUp()
server.pressKey("home")
server.pressKey("back")

For convenicence, you can intall its python wrapper library uiautomator.

Notes

The jsonrpc API is still under discussion, so currently only some demo APIs have been implemented. If you have any idea, please email xiaocong@gmail.com or submit tickets.

Dependencies

You can’t perform that action at this time.