此文章来源于项目官方公众号：“AirtestProject”
版权声明：允许转载，但转载必须保留原链接；请勿用作商业或者非法用途

前言

每天都有很多新的小伙伴开始学习使用我们的 Airtest 和 poco 框架来进行自动化测试；但是新手难免会提出很多疑问：

比如，使用这两个框架能不能满足我的测试工作需求；有没有什么教程可以学习；到哪里可以找到一些脚本 demo 看看；遇到问题不能解决可以怎么办...

因此我们特意编写了这篇新手指南大全，希望可以帮助大家可以更好地理解和学习这俩个自动化测试框架，轻松入门自动化测试。

Airtest

Airtest 是一款基于 Python 的、跨平台的 UI 自动化测试框架。因为它基于 图像识别 的原理，所以适用于所有 Android、
iOS 和 Windows 应用。因此，不论是手机上的 app 还是游戏，或者是 Windows 电脑上面的应用或者游戏等等，都可以用 Airtest 框架。

借助 Airtest，我们可以通过各种截图在设备上实现模拟输入，完成自动化测试脚本：

Poco

Poco 是一款基于 UI 控件搜索 的自动化框架，它本质上也是 python 第三方库。

目前来说，除了安卓原生应用，poco 可以直接使用，其它各种平台都需要通过对应的方法来接入 pocoSDK，之后才能够使用 poco 框架。

我们现在支持的平台有：Android，iOS，Cocos-Creator，Cocos2dx-js, Cocos2dx-lua，UE4，Unity3D，Egret，WeChat Applet&webview，Netease；不支持 Windows 和 MacOS。

对应的接入文档和注意事项可以在我们的官方文档网站上查看“poco 支持的平台” 这部分内容。

AirtestIDE

AirtestIDE 是一个跨平台的 UI 自动化测试编辑器，它是专为以上两个自动化测试框架量身打造的。所以我们非常建议新手可以从 AirtestIDE 开始学习 Airtest 和 poco 。

AirtestIDE 的下载官网为：http://airtest.netease.com/ 。这款编辑器可以运行在以下平台上：

如何开始使用

对于新手，我们非常建议使用 AirtestIDE 来帮助你编写自动化测试脚本。熟练上手 Airtest 和 poco 以后，如果有需要的话，则可以尝试脱离 IDE 来跑测试脚本，比如在本地命令行上运行，比如在 pycharm 上运行等等。

所以首先，你需要在你的电脑上下载对应的 AirtestIDE ，详细的AirtestIDE 安装与启动的方法可以参看官方文档：https://airtest.doc.io.netease.com/IDEdocs/getting_started/AirtestIDE_install/ 。

成功打开 IDE 之后，你需要在 IDE 的设备窗口连接上你的测试设备，不论是安卓真机、安卓模拟器、iOS 真机还是 Windows 窗口，在我们官方教程文档 https://airtest.doc.io.netease.com/ 上都可以找到对应的教程。

借助 IDE 界面左侧的 Airtest 辅助窗，我们可以对连接上的设备进行一些模拟操作，比如点击、滑动、截图、长按、输入文本等等。

而借助 poco 辅助窗，我们则可以看到设备的 UI 树，然后我们选中某个 UI 控件，就可以对这个选中的控件进行各种操作。

特别注意：因为 Airtest 和 poco 都是基于 python 语法的，所以我们编写的测试脚本都应该符合 python 语法。

我们建议不懂 python 的新手，可以在网上自行查找一些 python 教程来学习一下，基本上学会一些基本语法、变量、条件语句和循环语句，就可以满足初期的学习需求；更多关于 python 的高级语法可以等用到的时候再去学习。

如何查找资料

① 最新的官方文档

目前我们最新的官方文档 Airtest Project Docs 的地址为：https://airtest.doc.io.netease.com/ 。

在这里你可以看到关于 Airtest、poco 和 AirtestIDE 的详细教程；还可以查看到使用这两个自动化测试框架常遇到的问题和一些我们给出的脚本 demo：

而在博客里面，我们会定期更新的一些高级教程和实际应用的例子，方便大家学习；博客原文来自于我们的官方公众号 “AirtestProject”。

② 查询各种方法的 api

如果你想要查询某个方法详细的用法，或者是查看它的源码，可以在 Airtest 和 poco 的项目文档中查询到：

Airtest 的项目文档为：https://airtest.readthedocs.io/zh_CN/latest/index.html

poco 的项目文档为：https://poco.readthedocs.io/zh_CN/latest/index.html

③ 官方公众号 “AirtestProject”

在公众号菜单的往期教程里面，可以查看到一些高阶教程、实战例子和常见问题：

我们的官方公众号二维码：

遇到问题如何提问

查看相应教程

对于新手来说，难免会遇到各种各样的问题。设备连接不上？脚本运行报错？...

对于大部分的常见问题，我们已经收集起来放在了我们的官方文档上面：

① 安卓设备连接常见问题可以查看：https://airtest.doc.io.netease.com/IDEdocs/device_connection/2_android_faq/

② 脚本运行常见问题可以官方文档对应的部分或者公众号的答疑系列教程

在交流群提问

另外，我们还专门设有开发者沟通交流群，供大家互相探讨自动化测试相关的问题：

目前 1 群已满，大家可以加入 2 群（QQ1017250147）。

注意：提问时最好附上使用的设备详情和 IDE 版本等，然后贴出报错的 log 图片，可以方便群内管理员迅速定位问题。

提问规范：https://airtest.doc.io.netease.com/IDEdocs/getting_started/crash_abnormalProblem/#airtestide_1

在公众号留言

有些用户会在我们的官方公众号留言提问，当然也是可以的；工作日内我们都会有专门的人员回复，但是不保证时效。

所以我们更建议大家多查询我们整理好的问题文档，或者直接加群提问；群内不仅有项目管理员，还有很多热心的大佬会帮助你解决问题。

到 GitHub 上提 issue

如果你在使用过程中发现了 bug，或者有建议想提给我们，可以到我们项目的 GitHub 地址上给我们提一个 issue：https://github.com/AirtestProject/AirtestIDE/issues 。这样 bug 被解决或者建议被采纳时，你就可以收到通知了。

---

Airtest 官网：airtest.netease.com/
Airtest 教程官网：airtest.doc.io.netease.com/
搭建企业私有云服务：airlab.163.com/b2b

关注下方公众号，可以查看更多往期教程，回复 “交流群” 可以加入我们的官方开发者交流群