https://github.com/xiaocong/android-uiautomator-jsonrpcserver

https://github.com/xiaocong/android-uiautomator-jsonrpcserver

Last synced: 4 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/xiaocong/android-uiautomator-jsonrpcserver
• Owner: xiaocong
• License: mit
• Created: 2013-08-09T03:07:19.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2018-03-02T17:50:35.000Z (over 6 years ago)
• Last Synced: 2024-10-31T19:42:20.590Z (11 days ago)
• Language: Java
• Size: 3.35 MB
• Stars: 72
• Watchers: 18
• Forks: 55
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# It's moved to [android-uiautomator-server](https://github.com/xiaocong/android-uiautomator-server), which is based on android suppot library.

# Purpose

[UIAutomator](http://developer.android.com/tools/testing/testing_ui.html) 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`.

```python

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](https://github.com/xiaocong/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 [email protected] or [submit tickets](https://github.com/xiaocong/uiautomator/issues/new).

# Dependencies

- [nanohttpd](https://github.com/NanoHttpd/nanohttpd)

- [jsonrpc4j](https://code.google.com/p/jsonrpc4j/)