Airtest Poco实战：5分钟搞定微信小程序自动化测试环境搭建与元素抓取

Airtest Poco实战：5分钟搞定微信小程序自动化测试环境搭建与元素抓取

微信小程序作为轻量级应用的代表，已经渗透到电商、社交、工具等各个领域。随着小程序功能的日益复杂，自动化测试成为保障产品质量的重要手段。本文将带你快速搭建微信小程序的Airtest+Poco自动化测试环境，并深入解析小程序特有的元素抓取技巧。

1. 环境搭建：专为小程序优化的配置方案

与原生Android应用不同，微信小程序运行在微信的沙盒环境中，这给自动化测试带来了一些特殊挑战。我们需要针对小程序的特点进行环境配置。

1.1 基础工具安装

首先确保你的开发环境已经准备好以下工具：

• Airtest IDE：推荐使用1.2.7及以上版本
• Python 3.7+：Airtest的核心依赖环境
• 微信开发者工具：用于调试小程序
• Android手机/模拟器：建议Android 8.0以上版本

注意：微信开发者工具需要开启"USB调试"和"小程序调试"模式，这是后续连接的关键。

1.2 Poco-SDK的特殊配置

由于小程序运行在WebView环境中，我们需要使用专门适配的Poco-SDK：

# 安装小程序专用Poco驱动 pip install pocoui --upgrade

然后在代码中初始化Poco对象：

from airtest.core.api import * from poco.drivers.wechat import WeChatPoco # 初始化连接 auto_setup(__file__) poco = WeChatPoco()

与原生Android应用不同，小程序Poco驱动需要额外处理WebView上下文切换。以下是关键参数对比：

2. 小程序元素抓取实战技巧

小程序采用Web技术栈开发，其UI结构与原生应用有显著差异。掌握正确的元素定位方法是自动化测试成功的关键。

2.1 使用Poco Inspector定位元素

启动Airtest IDE后，按以下步骤操作：

1. 连接手机并打开目标小程序
2. 在Airtest IDE中选择"Poco辅助窗"
3. 点击"刷新"按钮获取当前页面元素树

小程序元素的典型特征包括：

• 以webview开头的节点名称
• 大量使用class和id属性
• 文本内容通常存储在text或value属性中

2.2 常用元素定位策略

针对小程序的特点，推荐以下几种定位方式：

# 1. 通过文本内容定位 poco(text="立即购买").click() # 2. 通过class名称定位 poco("webview").child("div.buy-btn").click() # 3. 通过层级关系定位 poco("webview").offspring("div.price")[0].get_text() # 4. 组合条件定位 poco("webview").child(div(type="button", name="submit"))

对于动态生成的元素，可以使用wait方法：

# 等待最多10秒直到元素出现 price = poco("div.price").wait(10).get_text()

3. 小程序特有操作与常见问题解决

微信小程序的环境特性导致一些常规操作需要特殊处理，以下是几个典型场景的解决方案。

3.1 滚动操作的特殊处理

小程序的滚动容器通常需要明确指定：

# 垂直滚动列表 item_list = poco("div.scroll-view").child("div.item") item_list.scroll_to("bottom") # 滚动到底部 # 水平滚动选项卡 poco("div.tab-container").scroll_to("right") # 滚动到最右侧

如果遇到滚动失效的情况，可以尝试：

1. 检查是否定位到了正确的滚动容器
2. 增加滚动持续时间参数：scroll_to(duration=2.0)
3. 改用基于坐标的滑动：poco.swipe([0.5, 0.8], [0.5, 0.2])

3.2 输入框处理的注意事项

小程序输入框的操作与原生应用有所不同：

# 常规文本输入 poco("input.search-box").set_text("关键词") # 需要先点击激活输入框的情况 poco("input.search-box").click() text("关键词") # 使用Airtest的text输入 # 处理键盘遮挡问题 poco("input.comment").click() wait(Template("keyboard.png")) # 等待键盘弹出 touch(Template("send-button.png")) # 点击发送按钮

3.3 小程序页面切换的监控

小程序页面跳转时需要注意上下文切换：

# 监听页面跳转 def page_changed(): return poco("webview").attr("url") != current_url poco.wait_for_event(page_changed, timeout=20) # 或者使用更直观的方式 poco.wait_for_any( [poco(text="新页面标题"), poco("div.page-loading")], timeout=15 )

4. 实战案例：电商小程序测试脚本编写

让我们通过一个完整的电商小程序测试案例，将前面学到的知识串联起来。

4.1 测试场景设计

假设我们要测试以下流程：

1. 进入小程序首页
2. 搜索商品
3. 浏览商品列表
4. 进入商品详情
5. 加入购物车
6. 结算流程

4.2 核心代码实现

def test_shopping_flow(): # 1. 进入首页 poco(text="首页").click() assert poco("div.banner").exists() # 2. 搜索商品 poco("input.search").click() text("智能手机") poco(text="搜索").click() # 3. 浏览列表 product_list = poco("div.product-list").children() product_list[0].click() # 4. 商品详情操作 assert poco(text="商品详情").exists() poco(text="加入购物车").click() poco(text="确定").click() # 5. 进入购物车 poco(text="购物车").click() assert poco(text="智能手机").exists() # 6. 结算流程 poco(text="去结算").click() poco(text="提交订单").click() assert poco(text="支付成功").wait(10).exists()

4.3 常见问题排查表

在实际项目中，建议将通用操作封装成函数，例如：

def safe_click(element, timeout=10): target = element.wait(timeout) target.focus() # 确保元素可见 target.click()

5. 性能优化与最佳实践

小程序自动化测试对执行效率要求较高，以下是一些提升脚本质量的建议。

5.1 元素定位优化策略

避免使用过于宽泛的选择器：

# 不推荐 - 性能差 all_divs = poco("div") # 推荐 - 精确限定范围 specific_div = poco("div.main-container").child("div.product")

合理使用缓存机制：

# 首次查找并缓存元素 search_input = poco("input.search") # 后续直接使用缓存对象 search_input.set_text("新品")

5.2 脚本健壮性增强

添加完善的错误处理和重试机制：

from retrying import retry @retry(stop_max_attempt_number=3, wait_fixed=2000) def reliable_click(element): if not element.exists(): raise Exception("元素不存在") element.click() # 使用示例 reliable_click(poco(text="确定"))

5.3 测试数据管理

建议将测试数据与脚本分离：

import json with open("test_data.json") as f: test_data = json.load(f) def test_search(keyword): poco("input.search").set_text(keyword) poco(text="搜索").click() assert poco(text=keyword).exists() # 使用数据驱动测试 for data in test_data["search_keywords"]: test_search(data["keyword"])

对于需要登录的场景，可以预先处理登录状态：

def login(username, password): poco(text="我的").click() if poco(text="登录").exists(): poco(text="登录").click() poco("input.username").set_text(username) poco("input.password").set_text(password) poco(text="确认登录").click() # 在setup中调用 login("test_user", "password123")

微信小程序自动化测试虽然有其特殊性，但通过合理的工具配置和技巧运用，完全可以实现高效稳定的测试覆盖。在实际项目中，建议从小功能模块开始逐步扩展，同时建立完善的元素定位策略和异常处理机制，确保测试脚本的长期可维护性。