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

1. 前言

本次更新为 Poco 框架更新，pocoui版本提升至 1.0.85 版本，同时更新了pocoservice.apk，更新详情如下。

2. 更新详情

1）pocoservice.apk 更新

① 修复了 1.0.84 版本可能带来的新问题：假如使用 poco(xx).click()时，当前页面不止一个节点会被筛选出来，并且正好第一个节点可能是不可见节点的话，会导致点击位置超出屏幕的报错，类似下面这样的报错：

raise InvalidOperationException('Click position out of screen. pos={}'.format(repr(pos)))
poco.exceptions.InvalidOperationException: Click position out of screen. pos=[0.315632761, 1000.93921]

② 部分 APP 的某些页面可能使用了 WebView 控件，以前的版本无法抓取，现在能够抓取（但并不能完全保证所有的 WebView 都可以拿到）。

③ UI 树的层级结构多了一层，因此能够抓取到一些之前无法抓取的控件了
例如部分手机的一些底部虚拟按钮、某些输入法的按键界面（如讯飞输入法）等。

④ 修复了一个筛选出列表后、再进行进一步条件筛选时可能会引发的报错
例如，poco(xx)[0].parent().exists()执行正常，但是poco(xx)[1].parent().exists()就会报错。

⑤ 修复了部分手机可能拿到的节点信息未能实时刷新，导致运行失败的问题：

例如：某个列表从上往下滚动时，某个节点一开始不存在，但是后来滚动到了画面中心，此时拿到的节点信息可能依然是不存在，导致脚本报错（主要在部分机型上可能出现、以及如果手机在设置 - 显示 - 大小，设置为 “大” 的话，也可能导致此问题）。

此问题在 1.0.84 版本已经修复，但是带来了比较严重的性能问题，我们在这个版本做了优化，尽可能在刷新节点的同时保证了运行时的速度。

⑥ 去掉了当部分特殊节点无法被抓取到时的一个报错。

2）其它更新

① 由于 Android poco 不能与 uiautomator 同时运行，之前的版本会在启动前强制做一些杀进程的操作，现在改为只有启动失败时，才尝试杀进程，加快启动速度。

② hrpc 提升至 1.0.9 版本，将一个在断开时可能出现的连接报错hrpc.exceptions.TransportDisconnected: HTTPConnectionPool(host='127.0.0.1', port=11385): Max retries exceeded with url: / 进行了简单处理。

3. 如何更新

1）使用了 AirtestIDE

因为本次更新只涉及框架更新，所以我们即使使用最新的 1.2.12 版本 IDE 自带的 Python 环境也是无法享受到的；

但是我们可以在 AirtestIDE 设置使用本地 Python 环境，然后在本地 Python 环境中将 pocoui 更新至 1.0.85 版本，这样在 IDE 运行 Poco 脚本时，就会使用最新的 Poco 框架，并且在手机上安装上最新的 pocoservice.apk 。

2）使用本地 Python 环境/其它编辑器

使用本地 Python 环境同学，可以直接在对应的 Python 环境中，使用下述命令更新 pocoui：

pip install -U pocoui

使用其它编辑器，比如 pycharm 的同学，可以直接找到当前项目使用的 Python 解释器，然后升级 pocoui 至 1.0.85 版本：

4. 更新的注意事项

1）注意 hrpc 库是否更新至 1.0.9 版本

更新pocoui至 1.0.85 版本的同学，可以顺便注意下hrpc库是否也同步更新到了 1.0.9 版本，查看安装的库详情可以使用pip list命令：

2）如何确保手机上已经安装了最新的 pocoservice.apk

使用最新的pocoservice.apk与旧版pocoservice.apk最大的差别是，拿到的树会多一层 Root 节点：

并且初次使用 1.0.85 版本跑 Poco 脚本时，会出现一条安装最新版本 pocoservice.apk 的 log，类似：

C:\Users\AppData\Local\Programs\Python\Python37\lib\site-packages\airtest\core\android\static\adb\windows\adb.exe -P 5037 -s 7c5ce4c9 shell dumpsys package com.netease.open.pocoservice
installed version is None, installer version is 45. force_reinstall=False

3）如需使用 AirtestIDE，请使用最新版 1.2.12

如我们需要在 AirtestIDE 中使用 1.0.85 的pocoui，请务必确保我们使用的是最新的 1.2.12 版本的 IDE。

另外为确保成功安装最新的pocoservice.apk，我们可以把设备里已经安装的旧版pocoservice.apk，手工卸载掉，并且杀掉手机的所有后台进程和关闭 AirtestIDE 的 poco 模式。

此时我们在 1.2.12 版本的 IDE（已设置使用本地 Python 环境并且环境里的 pocoui 已更新至 1.0.85 版本）运行类似这样的脚本：

# -*- encoding=utf8 -*-
__author__ = "AirtestProject"

from airtest.core.api import *
from airtest.report.report import simple_report,LogToHtml

auto_setup(__file__)

from poco.drivers.android.uiautomation import AndroidUiautomationPoco
poco = AndroidUiautomationPoco(use_airtest_input=True, screenshot_each_action=False)

就会自动帮我们在设备上安装最新版的pocoservice.apk了，此时打开辅助窗的 Android 模式，或者运行 Poco 脚本，都将使用最新的版本。

4）影响 pocoservice.apk 活跃的手机设置

尽管我们已经多次提出同学们需要关注自己手机设置对pocoservice.apk的后台活跃影响，但仍有部分同学会收到pocoservice.apk反复重启的困扰，这里我们仅仅列举了部分常见国产品牌手机的设置项，如果你的手机品牌不在这个列表中，请尽量按照下面提供的示例检查一下手机是否有类似设置：

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

5）对 pocoui 新版快速提单

如同学们在使用新版的pocoui时遇到了一些问题无法解决，可以通过此网站向我们的开发者快速提单：https://airtest.netease.com/issue_create 。

可以在标题中加入 “pocoui1.0.85” 之类的字眼，方便我们快速筛选和排查。

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

官方答疑 Q 群：654700783

呀~这么认真都看到这里啦，帮忙点击左下角的爱心，给我点个赞支持一下把，灰常感谢~