Airtest

站点名称：Airtest 自动化测试平台

站点 URL：https://refraction.dev/

Title

Keywords

Description

站点简介

1. 跨平台兼容性：支持 Android、iOS、Windows、Unity3D、Cocos2dx 等多平台，2025 年新增对 Appium WebDriverAgent 的支持，可灵活选择底层驱动工具；
2. 图像识别技术：基于自研图像识别框架，通过截图点击即可生成测试脚本，无需依赖界面元素 ID，特别适合游戏 UI 复杂场景；
3. 无码化操作：AirtestIDE 支持录制回放功能，非技术人员也能快速上手，同时兼容 Python 脚本编写，满足高阶定制需求。

核心功能

1. 跨平台自动化测试

2. 图像识别与 Poco UI 双驱动

• 图像识别：通过截图匹配技术定位界面元素，适用于游戏场景中动态变化的 UI（如技能按钮、角色位置），支持跨分辨率自适应；
• Poco UI：基于 UI 树结构的控件定位，可精准获取元素属性（如 text、name），适合原生 App 的深度交互测试。例如，在知乎 App 爬虫开发中，通过 Poco 接口可批量抓取搜索结果标题和讨论数，实现数据采集自动化。

3. 多设备集群控制

4. 数据标注与爬虫开发

特点优势

1. 技术成熟度高：经过网易内部项目验证，2025 年累计迭代超百个版本，稳定性与性能表现优于同类工具。例如，针对 iPad、iPhone 6P 等大屏设备，优化了横屏操作的响应速度，提升测试效率 30%。
2. 社区生态完善：拥有百万级开发者用户，提供中文文档、视频教程及 GitHub 开源项目，可快速解决技术问题。例如，通过 Airtest 社区可获取 Poco 库二次开发案例，实现自定义测试逻辑。
3. 成本效益显著：相比 Testin XAgnet 等 AI 驱动工具，Airtest 无需订阅付费，且对硬件要求低，中小型团队可零成本部署。
4. 多场景适配：不仅适用于功能测试，还可扩展至性能测试、安全测试等领域。例如，通过结合 Jenkins 持续集成平台，可实现自动化测试流程全闭环。

适用人群

1. 游戏开发者：
   
   
   • 场景：游戏上线前的功能测试、版本更新后的回归测试。
   • 价值：通过图像识别自动检测角色动作、道具交互等场景，减少人工测试的时间成本。
   
   
2. 移动应用测试工程师：
   
   
   • 场景：App 多设备兼容性测试、用户行为模拟。
   • 价值：支持同时控制多台手机，快速发现不同系统版本下的 UI 显示异常。
   
   
3. 数据采集与分析团队：
   
   
   • 场景：App 内容抓取、用户行为数据收集。
   • 价值：通过 Airtest+Poco 组合，可批量获取界面文本、图片等信息，替代传统手动截图标注。
   
   
4. 企业级测试团队：
   
   
   • 场景：大型项目的自动化测试流程管理。
   • 价值：支持与 ONES 测试管理平台集成，实现测试用例与需求、缺陷的关联，形成质量闭环。
   
   

使用指南

1. 环境搭建

• 下载 AirtestIDE（支持 Windows、Mac、Linux），安装时自动配置 Python 环境及依赖库。
• 连接设备：通过 USB 或 WiFi 连接手机，开启开发者模式及 ADB 调试权限。对于 iOS 设备，需根据系统版本选择 WebDriverAgent 或 iOS-Tagent 驱动工具。

2. 脚本编写

• 录制模式：在 AirtestIDE 中点击 “录制” 按钮，手动操作设备生成测试脚本，自动包含 touch、swipe 等基础命令。
• 代码模式：支持 Python 语法，可自定义逻辑（如循环、条件判断）。例如，使用 Template 类设置图像识别阈值：
  python

  from airtest.core.api import *  
  touch(Template(r"tpl1.png", threshold=0.9))  # 仅当匹配度≥90%时触发点击  
  
  
  
• 多设备控制：通过 set_current 接口切换设备，实现并行测试：
  python

  device1 = connect_device("Android:///device_id1")  
  device2 = connect_device("Android:///device_id2")  
  set_current(device1)  
  touch(Template("button.png"))  
  set_current(device2)  
  touch(Template("button.png"))  
  
  
  

3. 执行与调试

• 运行脚本：在 AirtestIDE 中点击 “运行” 按钮，或通过命令行指定设备参数：
  bash

  airtest run script.air --device Android:///device_id --log log/  
  
  
  
• 调试工具：通过 “元素树” 面板查看设备界面结构，使用 “截图对比” 功能验证图像识别结果。

4. 报告生成

常见问题及解决方案

1. 图像识别失败
   
   
   • 原因：界面元素变化、分辨率差异或光照影响。
   • 解决方案：
     • 使用 Poco UI 定位替代图像识别，通过元素属性（如 name、text）精准定位；
     • 调整 Template 参数，降低 threshold 值（如 0.7）以提高匹配容错率。
     
     
   
   
2. iOS 设备连接失败
   
   
   • 原因：驱动工具未正确安装或证书问题。
   • 解决方案：
     • 对于 iOS 11 以下设备，使用 Airtest 自带的 iOS-Tagent 工具；iOS 12 及以上建议安装 Appium 的 WebDriverAgent，并配置开发者证书；
     • 检查设备是否信任电脑，重启 AirtestIDE 及手机。
     
     
   
   
3. 脚本执行卡顿
   
   
   • 原因：设备性能不足或脚本逻辑复杂。
   • 解决方案：
     • 关闭设备后台应用，减少资源占用；
     • 优化脚本逻辑，避免重复截图，使用 sleep (0.5) 控制操作间隔。
     
     
   
   
4. 中文日志乱码
   
   
   • 原因：AirtestIDE 默认编码问题。
   • 解决方案：在脚本开头添加编码声明：
     python

     # -*- encoding: utf-8 -*-  
     
     
     或在 PyCharm 中运行脚本，避免 IDE 环境干扰。
   
   

相关产品推荐

1. Appium
   
   
   • 特点：基于 WebDriver 协议的移动测试框架，支持原生 App、混合应用及移动 Web 测试。
   • 对比：与 Airtest 相比，Appium 更依赖界面元素 ID，适合标准化 UI 场景；Airtest 的图像识别技术更适合游戏等非结构化界面。
   
   
2. Testin XAgnet
   
   
   • 特点：AI 驱动的无码化测试工具，支持自然语言生成测试脚本，适合快速验证需求。
   • 对比：Testin 在 AI 生成能力上领先，但 Airtest 在复杂场景（如游戏、多设备集群）的稳定性更优，且成本更低。
   
   
3. LambdaTest (KaneAI)
   
   
   • 特点：云端测试平台，结合 GenAI Agent 实现测试流程自主规划，适合大规模浏览器 / 设备矩阵测试。
   • 对比：LambdaTest 代表前沿技术方向，但 Airtest 在本地化部署、社区支持方面更具优势，适合对数据安全要求高的企业。
   
   
4. ONES 测试管理
   
   
   • 特点：覆盖测试全生命周期的管理平台，支持用例设计、缺陷跟踪及与 Airtest 集成。
   • 价值：通过 ONES 可将 Airtest 测试结果与需求、迭代关联，形成质量闭环，提升团队协作效率。