facebook-wda 是ATX项目下面的一个子库，专门提供 iOS 应用的自动化测试，可以通过 ATX 使用这个库，当然也可以单独拿来使用。
这篇文章介绍了如何用facebook-wda这个 python 库来完成一个普通 App 应用的测试，希望通过这个篇文章，能让 iOS 的测试或开发人员，更方便的回归测试自己的应用。开发出质量更高的应用。
选用 网易云音乐 作为被测应用，纯粹是因为我平常用网易云音乐听歌比较多，比较喜欢这款应用
facebook-wda 这个 Python 库，通过直接构造 HTTP 请求直接跟WebDriverAgent通信。它是一个非常短小精悍的一个库，并不像 appium、macaca 还有一个中间转发服务，支持这么多的语言。用它做测试，Python 你必须要会。
虽然代码比较精炼，但是能完成的功能却非常强大。你能在 appium 里面找到的功能，这个库有提供，找不到的功能，这个库也有提供。
在写代码之后，你需要把下面列的东西都准备好。
部署 WebDriverAgent https://testerhome.com/topics/7220
成功安装后，浏览器访问 http://localhost:8100/status会看到一个 json 字符串
安装 Python 库（目前这个版本的库支持 py2.7~3.5 之间的版本）
pip install --pre facebook-wda
手机上先安装上一个网易云音乐
通过ideviceinstaller -l 或者其他工具查找到网易云音乐的 bundleId com.netease.cloudmusic
网易帐号我先用两个静态变量代替 USERNAME, PASSWORD
先贴一段代码，看注释理解的比较快一些
首先是设备连接和弹窗处理
import wda
bundle_id = 'com.netease.cloudmusic'
c = wda.Client('http://localhost:8100') # DEVICE_URL
s = c.session(bundle_id) # 启动应用
# 处理不知何时就会突然弹出的警告框
def alert_callback(session):
btns = set([u'不再提醒', 'OK', u'知道了', 'Allow', u'允许']).intersection(session.alert.buttons())
if len(btns) == 0:
raise RuntimeError("Alert can not handled, buttons: " + ', '.join(session.alert.buttons()))
session.alert.click(list(btns)[0])
s.set_alert_callback(alert_callback)
变量s就代表 wda 的 Session 了，下面通过获取到的 Session 去完成登录
def netease_login(s):
# 已经登录直接跳过
# 开头有2s的广告，所以这里需要等待3s
if s(name=u'发现音乐', type='Button').wait(3, raise_error=False):
# Already logged in
return
# 点击邮箱登录，输入帐号密码，验证是否登录成功
s(name=u'网易邮箱').tap()
s(type='TextField').set_text(USERNAME+'\n')
s(type='SecureTextField').set_text(PASSWORD+'\n')
s(name=u'开启云音乐').click_exists(timeout=3.0)
assert s(name=u'发现音乐', type='Button').wait(5.0) # 等待5s
netease_login(s)
最近用了用 pytest，感觉比 python 自带的 unittest 好用的不少。安装方法 pip install pytest
直接上脚本 (为了节省篇幅，我就省略了比较常见的 import，包括上面的那个 alert_callback，实际写代码的时候你应该加上去）
def setup_function():
# 每次测试之前，保证帐号是登录的
s = c.session(bundle_id)
netease_login(s)
def teardown_function():
s.close() # 一次测试结束，关闭应用
def test_discover_music():
"""
测试 发现音乐->私人FM 中的播放功能
"""
s(name=u'发现音乐', type='Button').tap() # 默认会寻找10s，所以不用担心点不到
assert s(name=u'听歌识曲', visible=True).wait()
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() # 点击播放后，按钮会变成暂停，这里用正则匹配下
assert s(name=u'00:00', className='StaticText').wait_gone(10.0) # 等待音乐播放，进度条开始走了
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()
保存文件为 test_cloudmusic.py，然后命令行运行测试
$ py.test -vv
============================= test session starts =============================
platform win32 -- Python 2.7.13, pytest-3.2.1, py-1.4.34, pluggy-0.4.0 -- c:\python27\python.exe
cachedir: ..\.cache
rootdir: D:\Workdir\facebook-wda, inifile:
collected 2 items
com.netease.cloudmusic\test_discover_music.py::test_discover_music PASSED
com.netease.cloudmusic\test_discover_music.py::test_my_music PASSED
========================== 2 passed in 23.19 seconds ==========================
pytest 会保证调用函数test_discover_music之前把setup_function调用了，在测试结束后把teardown_function调用一次。
通过这种方式可以增加更多的测试。完整示例可以再该地址查看到https://github.com/openatx/facebook-wda/tree/master/examples/com.netease.cloudmusic
PS: 该项目自身的自测代码用的也是 pytest
通过访问 http://localhost:8100/inspector可以获取应用的 UI 图层结构，方便写脚本
比如我们访问到一个控件的属性
直接看着就可以写出代码 s(name=u'听歌识曲', className='Button').tap()
除了这些简单的定位方法还有茫茫多的定位方法。具体查看项目的主页 https://github.com/openatx/facebook-wda 想锻炼下手部肌肉的，还可以顺便点个 Star
这是一个功能完善且代码很鲁棒的库，不好好推广它，实在是对不起代码。有问题或者有使用心得，欢迎发帖讨论或者 QQ 群里讨论 497460177
