引言

Airtest 是网易出品的一款基于图像识别的自动化测试工具，主要应用在手机 APP 和游戏的测试。一旦使用了这个工具进行 APP 的自动化，你就会发现自动化测试原来是如此简单！！

连接手机

要进行 APP 的自动化测试，首先要将手机连上 airtest。连接手机有几种方法都可以实现：

第一种：USB 线连接，当然要注意一下几个步骤：

1. 请先安装手机对应品牌的官方驱动，确保能使用电脑对手机进行 USB 调试；
2. 确保已经打开手机的“开发者选项”（如何打开，每个手机不一样，可以根据自己的手机型号百度），并且打开“开发者选项”内的“允许 USB 调试”开关。

注意：部分手机还需要打开“允许模拟位置”、“允许未知来源安装应用”，所以如果不成功可以把这两个选项也勾选！‘

3. 关闭电脑上的手机助手软件和进程，使用 USB 线连接手机，手机上出现的“允许 USB 调试”的弹窗，点击确认；
4. 点击 airtest 链接面板中的“refresh ADB”按钮，设备列表将会刷新，并显示出该手机；
5. 点击列表内对应设备的“connect”按钮，即可完成连接。

图片.png 图片.png 图片.png 图片.png

第二种：IP+ 端口的连接。具体步骤如下：

1. 已知 IP 和端口的远程设备 ip:port，AirtestIDE 可以直接连接，
2. 点开设备窗内的 远程设备连接 按钮
3. 将 adb connect ip:port 字段填入填充框内，点击 连接 按钮，
4. 远程设备将出现在设备列表中，点击 connect 按钮。

图片.png

第三种：无线连接。

当手机与电脑处在同一个 wifi 下，即可尝试无线连接手机了，其实也就是通过 adb 无线连接手机。但是这种方式受限于网络连接的稳定性，可能会出现连接不够稳定的情况。具体连接操作步骤如下：

1. 确保手机开启了 USB 调试选项，并先用 USB 线将手机和电脑连接起来
2. 在电脑端执行命令 adb tcpip 5555 ，其中 5555 是端口号，可以根据自己的需求来指定，5555 是默认值
3. 获取手机的 IP 地址，可以在 手机设置-关于手机-状态信息-IP 地址 里找到，也可以执行 adb ifconfig 来查看
4. 随后可以拔掉 USB 线，在 AirtestIDE 的 远程设备连接 处输入 adb connect 手机ip:刚才填入的端口号5555 ，点击连接，刷新 ADB 后就能在设备列表中看到连上的设备了
5. 如果因为网络波动、重启 ADB 等原因导致连接断开，重新执行一次 adb connect ip:port 即可。

常用 API

1、touch ：点击操作 包含的参数：

图片.png

v：点击的图片或者坐标
times：点击次数，默认 1 次
duration：按住时间，默认 0.01s
right_click: windows 有效 ，手机端无效

2、text ：输入文本

图片.png

包含的参数：
text：输入的文本
enter：完成输入后自动执行 enter 操作，默认为 True
search：完成输入后强行执行 search 操作，默认为 false

3、wait：等待元素出现，如果找到该这个 图片就返回图片中心点的坐标，如果不出现就抛出错误：TargetNotFoundError

图片.png

包含的参数：
v：点击的图片或者坐标
timeout：等到超时时间，默认 20s
interval：每次寻找的时间间隔，默认 0.5s
intervalfunc：图片没有找到就执行后面的函数，默认为 None

---

4、sleep ：暂停等待

图片.png

包含的参数：
secs：延迟时间，默认 1.0s

5、assert_exist ： 判断图片是否存在，如果存在就返回图片的中心坐标，不存在就 raise AssertionError

图片.png

包含的参数：
v：图片
msg：描述测试点，它将被记录在报告中
return: 存在就返回图片的中心坐标，不存在就 raise AssertionError

6、assert_not_exist ：判断图片是否不存在，如果存在就 raise AssertionError

图片.png

包含的参数：
v：图片
msg：描述测试点，测试 报告中显示

7、assert_equal ： 判断第一个值和第二个值是否相等

图片.png

包含的参数：
first：第一个对比条目
second：第二个对比条目
msg：描述测试点，在测试报告中显示

8、assert_not_equal ： 判断第一个值和第二个值是否不相等

图片.png

包含的参数：
first：第一个对比条目
second：第二个对比条目
msg：描述测试点，在测试报告中显示

实战练习

我们现在用以上这写 API 来实现一个具体的需求用例：

需求： 登录柠檬班 app，并判断是否登录成功；

步骤如下：

1. 新建一个 air 脚本，默认导入的文件如下：

图片.png

2. 连接上手机设备，就可以再 airtest 界面看到手机的镜像界面：

图片.png

3. 点击 touch ，截图“柠檬班”APP 图标，启动这个 APP，生成的脚本如下：

图片.png

4. 点击“我的柠檬”，点击“点击头像进行登录”，来到登录页面：

图片.png

5. 在用户名输入框中输入手机号码，在密码输入框中输入密码，点击登录按钮。

注意：为了确保万无一失，最好在输入文本之前，先点击输入框，确认输入的焦点。

所以先调用 touch API，再调用 text API。点击 text API 就会弹出如下图所示的文本输入框，输入你的手机号码即可。同样的步骤，输入密码；最后，点击“登录”按钮。

图片.png 图片.png

6. 判断是否登录成功。

用 assert_exists API 来断言是否登录的用户名和头像是正确的，脚本如下：

图片.png

7. 运行后，查看测试报告检查测试结果

可以打开测试报告，查看运行结果和断言的图片如下图所示：

图片.png