给新手同学的入门指南¶
1. 前言¶
每天都有很多新的小伙伴开始学习使用我们的 Airtest 和 poco 框架来进行自动化测试；但是新手难免会提出很多疑问：
比如，使用这两个框架能不能满足我的测试工作需求；有没有什么教程可以学习；到哪里可以找到一些脚本demo看看；遇到问题不能解决可以怎么办...
因此我们特意编写了这篇新手指南大全，希望可以帮助大家可以更好地理解和学习这俩个自动化测试框架，轻松入门自动化测试。
1）Airtest¶
Airtest是一款基于 Python 的、跨平台的UI自动化测试框架。因为它基于 图像识别 的原理，所以适用于所有 Android、 iOS和 Windows 应用。因此，不论是手机上的app还是游戏，或者是Windows电脑上面的应用或者游戏等等，都可以用Airtest框架。
借助Airtest，我们可以通过各种截图在设备上实现模拟输入，完成自动化测试脚本：
2）Poco¶
Poco是一款基于 UI控件搜索 的自动化框架，它本质上也是 python 第三方库。
目前来说，除了安卓和iOS原生应用，poco可以直接使用，其它各种平台都需要通过对应的方法来接入pocoSDK，之后才能够使用poco框架。
我们现在支持的平台有：Android，iOS，Cocos-Creator，Cocos2dx-js, Cocos2dx-lua，UE4，Unity3D，Egret，WeChat Applet&webview，Netease；不支持Windows和MacOS。
对应的接入文档和注意事项可以在我们的官方文档网站上查看“poco支持的平台” 这部分内容。
3）AirtestIDE¶
AirtestIDE 是一个跨平台的UI自动化测试编辑器，它是专为Airtest和Poco这两个自动化测试框架量身打造的。所以我们非常建议新手可以从 AirtestIDE 开始学习 Airtest 和 poco 。
AirtestIDE的下载官网为：http://airtest.netease.com/ 。这款编辑器可以运行在以下平台上：
2. 如何开始使用¶
对于新手，我们非常建议使用 AirtestIDE 来帮助你编写自动化测试脚本。熟练上手 Airtest 和 poco 以后，如果有需要的话，则可以尝试脱离IDE来跑测试脚本，比如在本地命令行上运行，比如在其他Python编辑器，比如pycharm上运行等等。
所以首先，你需要在你的电脑上下载对应的 AirtestIDE ，详细的AirtestIDE安装与启动的方法可以参看官方文档。
成功打开IDE之后，你需要在IDE的设备窗口连接上你的测试设备，不论是安卓真机、安卓模拟器、iOS真机还是Windows窗口，在我们官方教程文档 https://airtest.doc.io.netease.com/ 上都可以找到对应的教程。
借助IDE界面左侧的Airtest辅助窗，我们可以对连接上的设备进行一些模拟操作，比如点击、滑动、截图、长按、输入文本等等。
而借助poco辅助窗，我们则可以看到设备的UI树，然后我们选中某个UI控件，就可以对这个选中的控件进行各种操作。
特别注意：因为 Airtest 和 poco 都是基于 python 语法的，所以我们编写的测试脚本都应该符合 python 语法。
我们建议不懂 python 的新手，可以在网上自行查找一些 python 教程来学习一下，基本上学会一些基本语法、变量、条件语句和循环语句，就可以满足初期的学习需求；更多关于python的高级语法可以等用到的时候再去学习。
3. 如何查找资料¶
1）查询官方教程文档¶
目前我们最新的官方文档 Airtest Project Docs 的地址为：https://airtest.doc.io.netease.com/ 。
在这里你可以看到关于Airtest、poco和AirtestIDE的详细教程；还可以查看到使用这两个自动化测试框架常遇到的问题和一些我们给出的脚本demo：
而在博客里面，我们会定期更新的一些高级教程和实际应用的例子，方便大家学习；博客原文来自于我们的官方公众号 “AirtestProject” 。
2） 查询框架的API文档¶
如果你想要查询某个方法详细的用法，或者是查看它的源码，可以在Airtest和poco的API文档中查询到：
- Airtest的API文档为：https://airtest.readthedocs.io/zh_CN/latest/index.html
- poco的API文档为：https://poco.readthedocs.io/zh_CN/latest/index.html
3）官方公众号“AirtestProject”¶
在公众号的往期教程里面，可以查看到一些高阶教程、实战例子和常见问题的教程，同学们可以通过号内搜索关键词来找到自己感兴趣的教程内容：
我们的官方公众号二维码：
4）B站UP主 “Airtest酱”¶
对于不喜欢看文档的同学，我们还提供了内容丰富的视频教程，更新到了我们的B站账号：Airtest酱。目前Airtest的小白系列课程已经全部更新完毕，喜欢看视频学习的同学可以直接移步B站学习：
后续我们也会更新更多教程视频，欢迎同学们点赞和关注。
4.遇到问题如何提问¶
1）查看相应教程¶
对于新手来说，难免会遇到各种各样的问题。设备连接不上？脚本运行报错？...
对于大部分的常见问题，我们已经收集起来放在了我们的官方文档上面：
① 安卓设备连接常见问题可以查看此文档
② 脚本运行常见问题可以官方文档对应的部分或者公众号的答疑系列教程
2）在官方交流Q群提问¶
另外，我们还专门设有开发者沟通交流群，供大家互相探讨自动化测试相关的问题：
目前1、2、3群已满，大家可以加入4群（QQ117973773）。
注意：提问时最好附上使用的设备详情和IDE版本等，然后贴出报错的log图片，可以方便群内管理员迅速定位问题。
3） 在官网的bug收集网站提单¶
我们在官网上挂了一个 AirtestProject的bug收集页面 ，希望同学们遇到问题时，可以把详细信息提供给我们，这样我们才能迅速帮助同学们定位问题。
4） 到GitHub上提issue¶
同学们也可以直接到我们项目的GitHub地址上给我们提一个issue：https://github.com/AirtestProject/AirtestIDE/issues 。这样bug被解决或者建议被采纳时，同学们就可以第一时间收到通知了。