yaml 接口java_使用 Yaml 来做自动化测试 (Beta)

背景

测试版本警告，目前功能这个功能刚写出来没多久，并不保证稳定。

ATX 中的python-uiautomator2目前来说还是以纯 Python 为主, 基本上都是过程式的写法，判断逻辑也都比较简单。

前段时间学习了思寒 @seveniruby 大佬的 appcrawler，发现用 yaml 写测试脚本获取是个很好的方法。

不了解 yaml 的看这里 YAML 教程

实践和使用说明

本地的 uiautomator2 库先升级到最新。

要实现的功能：打开网易云音乐，搜索周杰伦，播放布拉格广场，验证播放按钮存在

原生 Python 写法

import uiautomator2 as u2

d = u2.connect()

d.set_fastinput_ime(True)

d = d.session("com.netease.cloudmusic")

if d(text="跳过").exists(timeout=5):

d.click(text="跳过")

d(description="搜索").click()

d.send_keys("周杰伦")

d.press("enter")

d(textContains="布拉格广场").click()

assert d(description="播放暂停").exists(timeout=5)

保存成文件test.py 然后 python test.py 运行测试

Yaml 格式写法

---

title: 网易云音乐测试

packageName: com.netease.cloudmusic

steps:

- q: //*[@content-desc="搜索"]

- text: 周杰伦

- q: 布拉格广场

- q: 播放暂停

action: assertExists

watchers:

- q: 跳过

保存成文件test.yml，然后python -m uiautomator2.cli runyaml test.yml 运行

Yaml 文件的好处

脚本更简单和直观

使用非常少的接口dump_hierarchy, click。稳定性更好。

先通过dump_hierarchy接口获取界面 xml，然后通过 lxml 库分析所有组件的位置，调用 click 完成操作。

脚本运行的时候顺便输出日志，方便调试

性能数据、执行截图可以顺便一起做了(当前现在还没实现)

Yaml 用例运行时的日志输出

[I 180904 16:38:57 runyaml:119] Test begins: 网易云音乐测试

[I 180904 16:38:57 runyaml:120] launch app: com.netease.cloudmusic

[I 180904 16:39:02 runyaml:128] ==> {'query': '//*[@content-desc="搜索"]'}

[I 180904 16:39:02 runyaml:87] click: (940, 1602)

[I 180904 16:39:02 runyaml:56] trigger watcher: {'timeout': 0, 'query': '跳过'}

[I 180904 16:39:04 runyaml:87] click: (1008, 156)

[I 180904 16:39:04 runyaml:128] ==> {'text': '周杰伦'}

[I 180904 16:39:05 runyaml:45] input text: 周杰伦

[I 180904 16:39:07 runyaml:128] ==> {'q': '布拉格广场'}

[I 180904 16:39:08 runyaml:87] click: (123, 1194)

[I 180904 16:39:09 runyaml:128] ==> {'q': '//*[@content-desc="播放暂停"]'}

[I 180904 16:39:10 runyaml:87] click: (540, 1773)

[I 180904 16:39:11 runyaml:130] Finished

yaml 具体配置

title 随便写

packageName 写了之后会调用session函数启动应用

steps 包含每一个操作步骤

点击操作的完整的写法如下

- action: click

query: //*[@resource-id="tvb"]

timeout: 10

因为 action 默认就是 click，timeout 默认 10s，query 可以简写成q, 所以可以简写成

- q: //*[@resource-id="tvb"]

如果 q 以/开头代表代表 xpath, 如果是字符串，则会按照正则匹配没有元素的 text 字段

实现输入的写法

- text: 要输入的内容

运行 Python 代码的写法

- action: python

code: |-

print("Hello world")

断言的写法

- action: assertExists

q: 天气

watchers 这个字段的存在是为了方便点击弹窗，写法跟 steps 类似，区别就是 query 字段在这里是必须的，timeout 默认 0s

在每次操作 step 之前，都会先将 hierarchy 经过 watchers 处理。

后话

目前还只是 Beta 版，可以会有 Bug，可能功能还不完善，欢迎大家提意见，我们来一起把它完善了。