在群里看到WebDriverAgent这个东西,出于好奇,便开始百度+谷歌,最终对其有了简单的了解。也对自动化测试也有了一个初步的了解。接下来你看到的是对WebDriverAgent的一些介绍。

正文

WebDriverAgent简称WDA。它是由Facebook推出的一款移动端测试框架。它是在iOS客户端实现了一个WebDriver的Server,借助这个server,我们可以远程控制iOS设备进行测试。
它更多的是测试人员进行自动化测试用的,所以在 testerhome 上有一些文章对其进行了介绍。具体的文章链接可以参见文末的附录。

原理

据官方介绍,它是通过链接XCTest.framework和调用苹果的API直接在设备上执行命令。在网上看到一张图:
图片来源于网络
先忽略这张图,我们可以先看一个Xcode自带的软件:Accessibility Inspector。直接打开Xcode,然后点击菜单的Xcode–>Open Developer Tool即可找到该软件。这个软件按照名称来理解的话简单可以理解为可用性检查员。通过选择不同的设备(Mac、Simulator、iPhone),可以对其进行检查,例如我直接选择我的mac,然后选择微信那个进程,你会发现该软件的首页是Quicklook,也就是对微信的一个概览。你可以点击页面上的类似瞄准器的按钮,当你选中之后,颜色会变成蓝色,这个时候将鼠标移动到微信界面上,你会发现使用它可以检查微信mac版本的各个元素,并且可以查看各个元素的属性,如果该元素具有Actions,你还可以进行点击操作。也就是说你完全不用直接去操作微信,而直接使用Accessibility Inspector进行操作即可。基于此,我们可以利用查看的层级结构,进行UI自动化测试。更多的关于Accessibility可以参见iOS Accessibility Tutorial。对这个的理解我现在只停留在对工具的使用,后续会继续进行学习。
也就是基于Accessibility、XCTest.framework和UIAutomation.framework,才实现了对APP的各种操作,而WDA就是通过在被测设备上安装了WebDriverAgentRunner,然后通过WDA的一些API进行了服务器和客户端交互。基于API进行编写业务测试脚本,最后将脚本运行实现自动化测试的过程。

特性

在WDA的Github上也给出了WDA的特性:
1.支持真机 &&模拟器
在模拟器上运行还是比较方便的,在真机上需要进行证书配置、进行端口转发。这个下面会介绍到。
2.实现了大多数的WebDriver Spec
3.实现了部分Mobile JSON Wire Protocol Spec
如果想进一步了解Mobile JSON Wire Protocol Spec是什么,可以查看附录的1链接
4.支持USB连接设备
USB连接设备的时候,需要代理转发,这里用到了mobiledevice(或者使用usbmuxd)方法很简单直接进行端口代理即可(可参见本条特性的外链)。
5.提供了一个Inspector,可以很直观地查看当前设备的状态以及元素tree。
6.方便上手,它可以直接通过Xcode启动和调试
7.Unsupported yet,but works with tvOS & OS X

安装

WDA的安装很方便,只需要执行下面几个步骤就搞定(前提是你安装了各种环境支持,npm,node,carthage等):
第一步:下载工程,下载链接点这里
第二步:在解压后的工程根目录执行下面脚本:

1
./Scripts/bootstrap.h

该操作会通过Carthage安装所有的依赖、使用npm构建inspector包。
第三步:打开WebDriverAgent.xcodeproj,开启WebDriverAgentRunner test即可。

使用

选中要执行的设备,按照安装的第三步执行,即可启动WDA,执行UITestingUITests,当console输出如下信息则说明启动成功:

1
2
3
4
5
6
7
8
9
10
11
12
2018-06-27 15:56:14.352191+0800 WebDriverAgentRunner-Runner[9119:362446] +[CATransaction synchronize] called within transaction
2018-06-27 15:56:14.477644+0800 WebDriverAgentRunner-Runner[9119:362446] Running tests...
objc[9119]: Class VCWeakObjectHolder is implemented in both /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/Library/CoreSimulator/Profiles/Runtimes/iOS.simruntime/Contents/Resources/RuntimeRoot/System/Library/PrivateFrameworks/AVConference.framework/Frameworks/ViceroyTrace.framework/ViceroyTrace (0x12bfce4d0) and /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/Library/CoreSimulator/Profiles/Runtimes/iOS.simruntime/Contents/Resources/RuntimeRoot/System/Library/PrivateFrameworks/AVConference.framework/AVConference (0x12b0fae38). One of the two will be used. Which one is undefined.
2018-06-27 15:56:16.007610+0800 WebDriverAgentRunner-Runner[9119:362446] Continuing to run tests in the background with task ID 1
Test Suite 'Selected tests' started at 2018-06-27 15:56:16.612
Test Suite 'WebDriverAgentRunner.xctest' started at 2018-06-27 15:56:16.613
Test Suite 'UITestingUITests' started at 2018-06-27 15:56:16.613
Test Case '-[UITestingUITests testRunner]' started.
t = 0.00s Start Test at 2018-06-27 15:56:16.614
t = 0.00s Set Up
2018-06-27 15:56:16.617879+0800 WebDriverAgentRunner-Runner[9119:362446] Built at Jun 26 2018 18:43:04
2018-06-27 15:56:16.708704+0800 WebDriverAgentRunner-Runner[9119:362446] ServerURLHere->http://172.19.156.187:8100<-ServerURLHere

关键是最后一句话,显示了Server 的URL,直接将其拷贝,然后在浏览器打开即可。
地址后面添加/status可以查看当前设备(你使用的哪个设备运行,就是哪个设备的状态)的状态。
地址后添加/inspector即可打开inspector,查看元素,界面如下:

到这里,你就可以按照WDA提供的API进行脚本编写了,API地址为https://github.com/facebook/WebDriverAgent/wiki/Queries 。里面有很多命令,按照命令即可编写shell脚本进行自动化测试。例如从APP中回到主屏幕的操作(相当于点击了home button):

1
curl -X POST -H "Content-Type: application/json" -d "" http://localhost:8100/wda/homescreen

可以先看一下API提供的语句:

1
curl -X GET $JSON_HEADER $DEVICE_URL/status

其中:
$JSON_HEADER代表:’ -H “Content-Type: application/json” ‘
$DEVICE_URL代表刚才的ServerURL。
但是这种方式写起来比较麻烦,在网上又进行了查找,最终发现了facebook-wda非官方提供,但是很好用,安装方式也比较简单,直接执行命令(前提是安装了python以及pip):

1
pip install --pre facebook-wda

然后就可以使用python进行脚本编写:

1
2
3
4
5
6
7
#coding:utf-8
import wda
driver = wda.Client('http://172.13.156.187:8100')
# setting_session = driver.session('com.apple.Preferences')
# setting_session(text=u'通用',className='Cell').tap()
#点击home button
driver.home()

这样写起来看着就比较方便了。简单做一个对比:

WDA提供的API操作有很多,直接查看相关文档即可。另外,当时风靡一时的跳一跳python脚本执行,就是基于WDA进行的。想自己尝试的可以查看附录2链接。亲测可用。有一点需要注意的是在wechat_jump_game项目中,你要把对应的config.json文件拷贝到这个根目录,这样wecaht_jump_auto_iOS.py脚本才可以读到这个配置。

#结束语
WDA的使用还有很多方面,网易游戏团队ATX测试框架进行iOS测试就是使用的WDA,另外比较知名的appium也采用的WDA。有兴趣可以对其进行研究学习。
在学习的过程中发现了testerhome这个网站,应该是QA同学比较钟爱的网站,里面有各种文章以及问答,大多数都是关于测试技术相关,强烈推荐给QA同学。

附录

1.作为移动测试人员,你应该知道的移动自动化测试协议 Mobile JSON Wire Protocol Specification
2.基于python+WebDriverAgent的跳一跳小程序高分教程
3.iOS测试 WebDriverAgent简介
4.iOS自动化实践——WebDriverAgent(一)
5.iOS自动化实践——WebDriverAgent(二)

6.iOS自动化实践——WebDriverAgent(三)