1.安装 Android SDK
到如下网址下载 Android SDK
http://developer.android.com/sdk/index.html
2.创建 Android 虚拟设备
解包刚下载的 SDK 压缩包,进入 tools 目录,然后启动 AVD 管理器( Android Virtual Device Manager)
$ cd adt-bundle-mac-x86_64-20130917/sdk/tools
$ ./android avd
3.新建一个 Android 虚拟设备
在 AVD 管理器上单击 New 新建一个 Android 虚拟设备。新的 Android 虚拟设备创建成功后,就可以启动他了。具体步骤参考 Android 开发者官网
4.设置 Android 虚拟设备
两种方式运行 Android WebDriver ,一种基于 RemoteWebDriver Server,另一种基于 Android Test Framework,他们优缺点如下:
RemoteWebDriver Server | Android Test Framework |
可用任意Selenium 支持绑定的编程语言 | 只能使用 Java |
运行速度慢,因为每个命令都是基于 HTTP 的 RPC 方式 | 运行速度快,因为测试直接在模拟器或真实设备上 |
可移植性更强,同一套代码测试多种不同浏览器 | 已经在使用 Android Test Framework 且不打算用同一套代码测试其他浏览器 |
这里着重介绍RemoteWebDriver Server 方式,此方式包括服务器端和客户端2部分
1)客户端
一般指使用 JUnit 或 TestNG 组织的测试用例代码,运行的时候可选择直接在 IDE 中运行,也可通过命令行方式运行
2)服务器端
一般指运行在Android 设备上,且包含了 HTTP 服务器的应用程序
在运行测试用例时,客户端的每个 WebDriver 命令都会发送一个采用 JSON 协议的 RESTful HTTP 请求道服务器端。而远端的HTTP 服务器会将用户端发送过来的请求转发给 Android WebDriver, 并将请求结果发送回客户端。具体JSON 协议规范见:http://code.goole.com/p/selenium/wiki/JsonWireProtocol
5.安装并设置 Android WebDriver Server
1)无论 Android 模拟器还是 Android 真实设备,都有一个序列号 serial ID,通过如下命令先获取模拟器或设备的 serial ID,此例中序列号为 f14c451c
$ cd adt-bundle-mac-x86_64-20130917/sdk/platform-tools/
$ ./adb devices
List of devices attached
f14c451c device
2)下载 Android server 的 apk 文件,下载地址: https://code.google.com/p/selenium/downloads/list
3)在安装Android-server.apk 文件到 Android 模拟器或真实设备上之前,应确保 Android 系统允许安装非 Android 官方市场下载的应用程序,安装命令:
$ ./adb -s<serialId> -e install -r android-server.apk
结合本例具体序列号和 Android Server 的版本而言,命令执行记过如下:
$ ./adb -s f14c451c -e install -r android-server-2.32.0.apk
...
success
4)有2种方式启动 Android WebDriver 应用程序,一种是从 Android 模拟器或设备的 UI 上启动,还一种是从命令启动,如下:
$ ./adb -s<serialId> shell am start -a android.intent.action.MAIN -n org.openqa.selenium.android.app/.MainActivity
结合本例具体序列号而言,命令执行结果如下:
$ ./adb -sf14c451c shell am start -a android.intent.action.MAIN -n org.openqa.selenium.android.app/.MainActivity
Starting:Intent{act = android.intent.action.MAIN cmp = org.openqa.selenium.android.app/.MainActivity}
5)如果需要进入 debug 模式,可打开此选项,命令如下:
$ ./adb -s<serialId> shell am start -a android.intent.action.MAIN -n org.openqa.selenium.android.app/.MainActivity -e debug true
结合本例具体序列号而言,命令执行结果如下:
$ ./adb -s sf14c451c shell am start -a android.intent.action.MAIN -n org.openqa.selenium.android.app/.MainActivity -e debug true
Starting:Intent{act = android.intent.action.MAIN cmp = org.openqa.selenium.android.app/.MainActivity(has extras)}
6)设置端口转发规则
$ ./adb -s<serialId> forward tcp:8080 tcp:8080
结合本例具体序列号而言,设定本地端口为8888,命令执行结果如下:
$ ./adb -s sf14c451c forward tcp:8888 tcp:8080
这样就完成了 Android WebDriver Server 的安装和设置,接着就可以从本机的如下地址来查看测试代码 与 Android WebDriver Server 进行交互的状态:
http://localhost:8888/wd/hub/status
以下方式可检查确认 Android WebDriver Server安装并设置正确:
1)在浏览器中 http://localhost:8888/wd/hub/status 查看端口转发是否成功,正常会显示 {status:0}
2)使用 telnet 命令: $ telnet localhost 8888
3)使用 curl 命令: $ curl http://localhost:8888/wb/hub/status
4)使用 wget 命令: $ wget http://localhost:8888/wb/hub/status
接下来就可运行测试用例,有几个地方需要注意:
1)确保 Android 手机上 ”开发人员选项“ 中的 ”USB 调试“、”保持唤醒状态“ 和 ”允许模拟地点“ 处于打开状态
2)确保 Android 手机上 ”USB 数据存储“ 处于关闭状态,否则会导致执行测试用例时出现不可操作 sdcard 的错误提示。
测试用例示例:
import org.openqa.selenium.android.AndroidDriver;
...
//启动 Android WebDriver,并制定消息的转发地址为如下地址8888端口
WebDriver driver = new AndroidDriver("http://localhost:8888/wd/hub");
driver.get("www.1.com");
String url = driver.getCurrentUrl();
driver.close();