前言

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

正文

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

原理

据官方介绍，它是通过链接XCTest.framework和调用苹果的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等)：
第一步：下载工程，下载链接点这里。
第二步：在解压后的工程根目录执行下面脚本：

./Scripts/bootstrap.h

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

使用

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

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，查看元素，界面如下：

inspector

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

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

curl -X GET $JSON_HEADER $DEVICE_URL/status

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

pip install --pre facebook-wda

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

#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()

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

image

结束语

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(三)