安卓自动化测试工具monkeyrunner的iQuery插件使用说明

刚刚上传了monkeyrunner的iQuery插件，完整下载和示例代码请在此下载：

https://github.com/downloads/vowei/iQuery/iquery%20monkeyrunner%20plugin%20sample.zip

示例代码是随便找的针对大众点评写的，因此请确保手机上已经安装了大众点评的应用。示例代码下载后，请设置一个变量：“ANDROID_HOME”，例如：

$ export ANDROID_HOME=~/android-sdks

接着运行

$ ./run.sh

该插件的原理是解析Android手机上的View Server输出的应用控件树结构，找到要操控的控件的坐标，然后执行操作，当前只支持点击操作，后续会添加新的API。

下面是示例代码的说明：

# encoding: utf-8
import time, httplib, string, ast
# Imports the monkeyrunner modules used by this program
from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice
from cc.iqa.iquery.mr import QueryableDevice, By

ACTIVITY_LAUNCH_TIME = 10
THINK_TIME = 3

runComponent = "com.dianping.v1/com.dianping.ui.activity.MainActivity"

# Connects to the current device, returning a MonkeyDevice object
device = MonkeyRunner.waitForConnection()

# Installs the Android package. Notice that this method returns a boolean, so you can test
# to see if the installation worked.
device.startActivity(component=runComponent)
time.sleep(ACTIVITY_LAUNCH_TIME)

# 从device变量里初始化支持iQuery查询的device对象，其源码位置是：
# https://github.com/vowei/iQuery/blob/master/java/iquery/iquery-mr/src/main/java/cc/iqa/iquery/mr/QueryableDevice.java
qdevice = QueryableDevice(device)

# 启动并链接到安卓设备上的View Server，“127.0.0.1”这个ip是针对模拟器的，
# 需要自己查询真机设备的ip
qdevice.connectViewServer("127.0.0.1", 4939)

# 获取待测应用的控件树结构，得到一个ControlHierarchy对象，其源码位置是：
# https://github.com/vowei/iQuery/blob/master/java/iquery/iquery-mr/src/main/java/cc/iqa/iquery/mr/ControlHierarchy.java

ch = qdevice.getLayout(qdevice.getActivityId(runComponent))
# mText是按钮、文本框等控件的文本属性，与android sdk里各控件里的变量一致。
# 下面touch函数里，第一个参数就是由By类创建的iquery查询，
# 第二个参数就是待测应用的控件树结构，可以调用 ch.getViewServerOutput() 函数来获取一个字符串数组形式的待测应用控件树结构。
# 第三个参数就是点击操作的具体行为。
qdevice.touch(By.iquery(u":first >> [mText='团购']"), ch, MonkeyDevice.DOWN_AND_UP)
time.sleep(THINK_TIME)

qdevice.touch(By.iquery(u":first >> [mText='签到']"), ch, MonkeyDevice.DOWN_AND_UP)
time.sleep(THINK_TIME)

qdevice.touch(By.iquery(u":first >> [mText='我的']"), ch, MonkeyDevice.DOWN_AND_UP)
time.sleep(THINK_TIME)

最后，如果你希望修改代码需要编译的话，请在此同步代码：

https://github.com/vowei/iQuery/

编译之前，因为iquery monkeyrunner插件使用了很多android sdk里面的jar文件，因此也要先设置ANDROID_HOME环境变量才能编译，如下：

$ export ANDROID_HOME=~/android-sdK
$ mvn package