一、Poco介绍

注解

本文档为Poco框架的补充文档，将详细介绍Poco脚本与其编写技巧，在脚本编写过程中请同学们参照 Poco项目文档 获取更多API的详细信息。

1. Poco简介

Poco是一款跨平台的自动化测试框架，基于UI控件搜索原理 ，适用于Android、iOS原生和各种主流的游戏引擎应用。与基于图像识别的Airtest不同的是，Poco可以使用类似 poco("OK").click() 的方式来获取并操作节点。

以下是Poco相关文档的地址：

• Poco源码地址
• 给Poco项目提交bug/建议
• Poco API查询文档

2. Poco的本质

与Airtest框架一样，Poco实际上也是Python的一个第三方库。我们在AirtestIDE中可以录制、编写和运行Poco脚本，是因为AirtestIDE自带的Python环境已经装好了pocoui。

如需脱离AirtestIDE编写/运行Poco脚本，我们只需要准备一个本地Python环境，然后在该环境里安装上pocoui即可：

pip install pocoui

注意

在本地Python环境安装Poco框架的时候，我们需要注意框架的库名是pocoui，请勿同时安装poco和pocoui，可能会产生冲突；另外，如Python环境未安装airtest框架就直接安装poco框架，则会把airtest框架一并安装上。

3. Poco的支持情况

Poco在大多数平台中，需要 事先接入Poco-SDK才可正常使用 ，在少数平台（如Android原生APP、iOS原生APP）可直接使用Poco，目前支持平台如下：

更多平台支持正在陆续添加中，若有平台支持的需求，可以到 Poco-github 上提交issue，或联系我们。

4. Poco试用demo

鉴于SDK的接入步骤比较繁琐，我们提供了不同平台上的几个简单Demo范例，供大家下载之后体验和熟悉Poco，请前往 Poco Examples and Tutorials 页面了解更多详情：

• unity游戏demo-Android
• unity游戏demo-Windows
• cocos2dx-lua游戏demo-Android
• cocos2dx-js游戏demo-Android

5. Poco如何获取各平台应用的控件信息

1）Android

需要获取Android平台的原生控件信息，我们的安卓设备上必须安装上pocoservice.apk（若pocoui版本＜1.0.84，则需要安装2个pocoservice的apk）。这个应用可以在AirtestIDE的该目录下找到：

并且设备需要给pocoservice.apk足够的后台活跃权限，此处只列举了部分常见国产品牌手机的设置项，如果你的手机品牌不在这个列表中，请尽量按照下面提供的示例检查一下手机是否有类似设置：

• 小米：启用手机管家-应用管理-权限-自启动管理-PocoService，允许PocoService自启动
• 华为：手机管家（大于8.0版本）-应用启动管理-PocoService允许自启动和后台活动
• OPPO：设置-电池-应用耗电管理-pocoservice-允许应用自启动，允许完全后台行为
• VIVO：电池-后台高耗电-> PocoService 开启
• Realme：设置-电池-应用耗电管理-pocoservice-允许应用自启动，允许完全后台行为
• 一加：设置-电池-电池优化-PocoService-不优化

2）iOS

获取iOS的原生控件信息，需要依赖于 WebDriverAgent，iOS的控件操作远远慢于Android的控件操作，这也是因为受限于 WebDriverAgent 的信息传输时间和操作响应时间，目前没有很好的优化方案。

3）各种游戏引擎

Poco能获取各种游戏应用的控件信息，是因为我们在游戏项目中嵌入了Poco-SDK，当我们启动游戏的时候，即开启了游戏内的Poco通讯服务，从游戏内部传输控件信息供框架使用。

所以未接入Poco-SDK的游戏应用无法获取控件，就是因为没有在游戏内部嵌入对应的Poco通讯服务。我们也经常在Poco-SDK的接入教程中强调，poco服务必须挂载在1个永不被销毁的节点上，这是因为一旦挂载Poco服务的节点被销毁了，则意味着Poco通讯结束了，我们就无法正常获取游戏应用的控件信息。

6. Poco能做些什么

Poco能帮助我们获取控件的属性信息、操作控件、设置控件的text属性等等，但是连接设备、断言等操作，还需要依赖于Airtest的API，所以我们大多数情况下，都需要混合使用Airtest和Poco框架来编写我们的自动化脚本。