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

• nanohttpd
• jsonrpc4j