基于WebDriverAgent的自动化测试（demo）

WebDriverAgent是什么

WebDriverAgent is a WebDriver server implementation for iOS that can be used to remote control iOS devices. It allows you to launch & kill applications, tap & scroll views or confirm view presence on a screen. This makes it a perfect tool for application end-to-end testing or general purpose device automation. It works by linking XCTest.framework and calling Apple's API to execute commands directly on a device. WebDriverAgent was developed and used at Facebook for end-to-end testing and is successfully adopted by Appium.

为了方便起见，统一称为wda

facebook-wda是什么

facebook-wda这个Python库，通过直接构造HTTP请求直接跟WebDriverAgent通信

安装准备

在写代码之后，你需要把下面列的东西都准备好。

部署WebDriverAgent https://testerhome.com/topics/7220
成功安装后，浏览器访问 http://localhost:8100/status会看到一个json字符串

浏览器访问 http://localhost:8100/inspector会看到一个图形化界面，inspector是用来查看UI的图层，方便写测试脚本用的。

inspector

通过上面的部署，可以配置一个脚本文件，方便启动。具体步骤在部署链接中有详细步骤。

安装Python库
```
pip install --pre facebook-wda
```

控件定位

上面提到了inspector是用来查看UI的图层，方便写测试脚本用的
举例一个具体例子：

通过inspector就可以得到控件的具体定位，相应的可以写出代码 s(name=u'每日推荐', className='Button').tap()

初步测试

这边选取网易云音乐作为测试样例，为什么选取它，平时用它听歌比较多，不过最近准备弃坑转向QQ音乐——题外话

通过ideviceinstaller -l 或者其他工具查找到网易云音乐的bundleId com.netease.cloudmusic

如果执行命令ideviceinstaller -l报错Could not connect to lockdownd. Exiting.可以查看下面的链接来解决问题，亲测可行https://github.com/appium/appium/issues/9364

#!/usr/bin/env python
# -*- coding: utf-8 -*-

import unittest
import wda


wda.DEBUG = False # default False
wda.HTTP_TIMEOUT = 10.0 # default 60.0 seconds

bundle_id = "com.netease.cloudmusic"
c = wda.Client('http://localhost:8100')

# 启动应用
s = c.session(bundle_id)


def netease_day_recommend(s):
    s(name=u'每日推荐', type='Button').tap() # 等待5s

netease_day_recommend(s)

执行上述脚本，可以观察到网易云音乐启动，然后自动点击了每日推荐栏，进入列表页，是不是很神奇。其中name='每日推荐',className='Button'这些元素都是通过Inspector得到的

基于python单测框架pytest

pytest之前没接触过，了解的也不多，在查有关wda自动化测试脚本的时候看到的，就不深入了，后续如果工作用得到再学习吧。这边就简单列举一个例子来了解pytest，如何使用pytest来写测试脚本

#!/usr/bin/env python
# -*- coding: utf-8 -*-

import pytest
import wda


wda.DEBUG = False # default False
wda.HTTP_TIMEOUT = 10.0 # default 60.0 seconds

bundle_id = "com.netease.cloudmusic"
c = wda.Client('http://localhost:8100')

def setup_function():
    global s
    s = c.session(bundle_id) # 启动应用

def teardown_function():
    s.close() # 一次测试结束，关闭应用

def test_discover_music():
    """
    测试 我的->私人FM 中的播放功能
    """
    s(name=u'我的', type='Button').tap() # 默认会寻找10s，所以不用担心点不到
    s(name=u'私人FM').tap()
    assert s(name=u'不再播放').exists
    assert s(name=u'添加到我喜欢的音乐').exists
    assert s(name=u'00:00', className='StaticText').exists
    s(nameMatches=u'(暂停|播放)').tap() # 点击播放后，按钮会变成暂停，这里用正则匹配下

def test_my_music():
    """
    测试 我的->本地音乐
    """
    s(name=u'我的', type='Button').tap()
    assert s(name=u'最近播放').wait(2.0)
    s(name=u'本地音乐').tap()
    assert s(name=u'管理').wait()
    s(name=u'播放全部').tap()

pytest -v test_cloudmusic.py

目前对于wda自动化测试还只是初步入手阶段，后面工作有需求的话可以展开下。不过wda官方Facebook已经停止维护了，转到了idb，后面有兴趣看看就当补充课外知识了

下面是原话

We are archiving WebDriverAgent. Thanks to the community who have used it! The code will remain here for your future use, but will no longer be actively supported by Facebook.

In May 2019, we open sourced IDB, “iOS Development Bridge”, a command line interface for automating iOS Simulators and Devices. We are currently migrating our own internal projects from WDA to IDB, and suggest checking it out as an alternative.

More information on IDB:

Project on GitHub
Talk from 2019 F8

参考资料

https://www.cnblogs.com/Owen-ET/p/9792146.html
https://www.cnblogs.com/Owen-ET/p/9792146.html
https://github.com/openatx/facebook-wda
https://github.com/facebookarchive/WebDriverAgent
https://www.jianshu.com/p/a754e3d47671