WebDriverAgent入门篇-安装和使用

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

前言

在群里看到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等):
第一步:下载工程,下载链接点这里
第二步:在解压后的工程根目录执行下面脚本:

./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,查看元素,界面如下:

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

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

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

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

相关文章
|
3月前
|
数据可视化 IDE 开发者
【Python篇】PyQt5 超详细教程——由入门到精通(终篇)
【Python篇】PyQt5 超详细教程——由入门到精通(终篇)
901 1
|
7月前
|
缓存 安全 中间件
Python小白必备!清华大牛整理的《Django零基础入门到精通》手册
Django 是 Python 社区的两大最受欢迎的 Web 框架之一(另一个是 Flask)。凭借功能强大的脚手架和诸多开箱即用的组件,可以使你能够以最小的代价构建和维护高质量的Web应用。 从好的方面来看,Web 开发激动人心且富于创造性;从另一面来看,它却是份繁琐而令人生厌的工作。 通过减少重复的代码,Django 使你能够专注于 Web 应用上有趣的关键性的东西。 为了达到这个目标,Django提供了通用Web开发模式的高度抽象,提供了频繁进行的编程作业的快速解决方法,以及为“如何解决问题”提供了清晰明了的约定。 同时,Django 尝试留下一些方法,来让你根据需要在framework
|
6月前
|
Java 数据处理 调度
Java多线程编程入门指南
Java多线程编程入门指南
|
C语言 C++
C++入门篇(二)
C++入门篇
88 0
|
C语言 C++
C++入门篇(一)
C++入门篇
77 0
|
存储 编译器 C++
C++入门篇(三)
C++入门篇
95 0
|
JSON 自然语言处理 JavaScript
TypeChat 入门指南
TypeChat 是一个革命性的库,它简化了使用 TypeScript 构建自然语言模型界面的过程。 它抹平了自然语言和结构化数据之间的差距,使开发人员更容易将自然语言界面集成到他们的应用程序中。
392 0
|
编译器 Linux 程序员
C++入门篇(一)
C++入门篇(一)
|
Java Linux 数据安全/隐私保护
通俗易懂的Python入门基础详细教程
通俗易懂的Python入门基础详细教程
289 0
通俗易懂的Python入门基础详细教程
|
小程序 JavaScript API
01-小程序:开发入门篇
01-小程序:开发入门篇
424 0
01-小程序:开发入门篇