1. 环境准备5分钟搞定AirtestIDE安装第一次接触自动化测试的朋友可能会被各种环境配置劝退但AirtestIDE的设计理念就是开箱即用。我去年带团队新人时实测从零安装到运行第一个脚本平均只需8分钟。下面把最顺滑的安装路径分享给你Windows系统安装就像解压QQ官网提供的绿色版压缩包目前最新版本1.2.12解压后直接运行AirtestIDE.exe即可。不需要管理员权限甚至能放在U盘里随身携带。有次我在客户现场演示直接把整个文件夹拷贝到桌面运行完全跳过IT部门的软件安装审批流程。Mac用户注意权限问题首次启动时需要右击选择打开并在系统偏好设置-安全性与隐私中手动放行。遇到过最典型的问题是Python环境冲突建议先用which python3检查默认解释器路径如果遇到模块导入错误可以在IDE的选项-设置里指定Python解释器位置。Linux环境下的小技巧通过chmod x AirtestIDE给执行权限后建议用./AirtestIDE --no-sandbox命令启动。我在Ubuntu 20.04上测试时发现不加这个参数可能会导致Web自动化时Chromium崩溃。注意所有平台都建议关闭杀毒软件实时防护特别是360安全卫士等工具它们可能误拦截ADB通信。去年有个案例某金融APP的自动化测试总是随机失败最后发现是公司统一安装的终端安全软件在后台过滤USB流量。2. 设备连接真机与模拟器避坑指南2.1 安卓真机连接实战连接手机绝不是插上USB线那么简单。上周帮同事调试红米K60时明明开了开发者模式ADB却始终检测不到设备。后来发现MIUI 14需要额外开启USB调试安全设置。各品牌手机的隐藏设置各有不同OPPO/一加需要在开发者选项里关闭权限监控华为EMUI必须先在仅充电模式下信任电脑三星连接后要在手机弹窗点确认ADB重启大法好当设备列表不更新时别急着拔线。先点击IDE右上角的重启ADB按钮如果还不行试试命令行执行adb kill-server adb start-server2.2 模拟器连接的特殊处理雷电模拟器直接连接就能识别但网易MuMu需要手动adb connect。我在公司测试机上验证过的连接命令如下adb connect 127.0.0.1:7555 # MuMu默认端口 adb connect 127.0.0.1:5555 # 雷电/夜神默认端口遇到模拟器黑屏却需要操作的情况可以尝试用adb shell input keyevent 26发送电源键唤醒。去年双十一压测时这个命令帮我们挽救了几十台卡死的测试机。3. 第一个Web自动化项目实战3.1 浏览器自动化配置新手最容易卡在第一步——浏览器路径配置。Chrome的默认安装位置随着版本变化Windows 10C:\Program Files\Google\Chrome\Application\chrome.exeMacOS/Applications/Google Chrome.app/Contents/MacOS/Google Chrome跨浏览器支持方案除了Chrome也可以通过修改capabilities支持Edge/Firefoxfrom selenium import webdriver options webdriver.ChromeOptions() options.binary_location 你的浏览器路径3.2 元素操作黄金六式精准点击touch(Template(百度logo.png))图片识别点击比XPath更抗页面改版智能输入text(搜索关键词, enterTrue)带回车操作的输入滑动验证swipe((300,800), (300,200))处理滑块验证码的利器多窗口切换switch_to_new_tab()电商网站比价场景必备断言优化assert_exists(Template(支付成功.png), 支付状态验证)视觉验证比文本断言更直观异常处理try-except包裹关键步骤配合snapshot()保存现场截图去年做跨境电商项目时我们通过组合swipeassert_exists实现了商品列表的滚动加载检测成功率比传统方法提升40%。4. 移动端自动化专项突破4.1 APP启动的三种姿势图标点击法新手友好但脆弱页面布局变化就失效包名启动法start_app(com.taobao.taobao)最稳定的启动方式Activity直连法shell am start -n com.taobao/.taobao.TaoMainActivity适合特殊场景获取包名的秘笈连接设备后在IDE点击Android助手-刷新按钮所有安装包一目了然。上周排查问题时发现某些华为手机会对包名做混淆这时可以用adb shell pm list packages | grep taobao过滤。4.2 Poco框架的进阶用法动态元素定位策略poco(textMatches.*登录.*).click() # 模糊匹配 poco(descuser_name).set_text(test) # 替代appium的content-desc列表处理技巧items poco(android.widget.ListView).child(android.widget.LinearLayout) for i in range(items.len()): if items[i].child(text特价商品).exists(): items[i].click()去年优化社交APP测试脚本时我们通过poco.wait_for_all()解决了90%的异步加载问题配合poco.freeze()生成稳定的UI树使脚本稳定性从60%提升到98%。5. 测试报告与持续集成Airtest的报告系统自带对比视图功能但很多人不知道可以二次开发。这是我们团队改造后的报告模板增强点添加了性能数据监控折线图整合了FPS/CPU/Memory数据错误步骤自动关联JIRA工单支持导出为PDF格式归档命令行集成方案# 运行脚本并生成报告 airtest run test.air --device Android:/// --log logs/ airtest report test.air --log_root logs/ --export report/在Jenkins中建议这样配置pipeline { agent any stages { stage(Test) { steps { bat airtest run %WORKSPACE%\\test.air } } stage(Report) { steps { bat airtest report %WORKSPACE%\\test.air --export %WORKSPACE%\\report publishHTML target: [ allowMissing: false, alwaysLinkToLastBuild: false, keepAll: true, reportDir: report, reportFiles: log.html, reportName: Airtest Report ] } } } }6. 常见问题排查手册设备连接类现象ADB devices列表为空检查adb usb查看USB授权状态解决换原装数据线不同USB口交替测试元素识别类现象Poco无法识别某些元素检查adb shell dumpsys window windows确认Activity名称解决在目标页面执行poco.agent.hierarchy.dump()检查UI树性能优化类现象截图操作特别慢检查adb shell getprop ro.sf.lcd_density查看屏幕密度解决在IDE设置中调整截图质量为70%有个记忆深刻的案例某次大版本更新后所有测试脚本突然集体失效。最后发现是开发引入了新的主题框架导致所有控件路径变化。我们通过引入poco.wait_for_any()和动态选择器策略用3天时间完成了200脚本的适配升级。
【AirtestIDE】从零到一：手把手搭建你的首个跨平台自动化测试项目
1. 环境准备5分钟搞定AirtestIDE安装第一次接触自动化测试的朋友可能会被各种环境配置劝退但AirtestIDE的设计理念就是开箱即用。我去年带团队新人时实测从零安装到运行第一个脚本平均只需8分钟。下面把最顺滑的安装路径分享给你Windows系统安装就像解压QQ官网提供的绿色版压缩包目前最新版本1.2.12解压后直接运行AirtestIDE.exe即可。不需要管理员权限甚至能放在U盘里随身携带。有次我在客户现场演示直接把整个文件夹拷贝到桌面运行完全跳过IT部门的软件安装审批流程。Mac用户注意权限问题首次启动时需要右击选择打开并在系统偏好设置-安全性与隐私中手动放行。遇到过最典型的问题是Python环境冲突建议先用which python3检查默认解释器路径如果遇到模块导入错误可以在IDE的选项-设置里指定Python解释器位置。Linux环境下的小技巧通过chmod x AirtestIDE给执行权限后建议用./AirtestIDE --no-sandbox命令启动。我在Ubuntu 20.04上测试时发现不加这个参数可能会导致Web自动化时Chromium崩溃。注意所有平台都建议关闭杀毒软件实时防护特别是360安全卫士等工具它们可能误拦截ADB通信。去年有个案例某金融APP的自动化测试总是随机失败最后发现是公司统一安装的终端安全软件在后台过滤USB流量。2. 设备连接真机与模拟器避坑指南2.1 安卓真机连接实战连接手机绝不是插上USB线那么简单。上周帮同事调试红米K60时明明开了开发者模式ADB却始终检测不到设备。后来发现MIUI 14需要额外开启USB调试安全设置。各品牌手机的隐藏设置各有不同OPPO/一加需要在开发者选项里关闭权限监控华为EMUI必须先在仅充电模式下信任电脑三星连接后要在手机弹窗点确认ADB重启大法好当设备列表不更新时别急着拔线。先点击IDE右上角的重启ADB按钮如果还不行试试命令行执行adb kill-server adb start-server2.2 模拟器连接的特殊处理雷电模拟器直接连接就能识别但网易MuMu需要手动adb connect。我在公司测试机上验证过的连接命令如下adb connect 127.0.0.1:7555 # MuMu默认端口 adb connect 127.0.0.1:5555 # 雷电/夜神默认端口遇到模拟器黑屏却需要操作的情况可以尝试用adb shell input keyevent 26发送电源键唤醒。去年双十一压测时这个命令帮我们挽救了几十台卡死的测试机。3. 第一个Web自动化项目实战3.1 浏览器自动化配置新手最容易卡在第一步——浏览器路径配置。Chrome的默认安装位置随着版本变化Windows 10C:\Program Files\Google\Chrome\Application\chrome.exeMacOS/Applications/Google Chrome.app/Contents/MacOS/Google Chrome跨浏览器支持方案除了Chrome也可以通过修改capabilities支持Edge/Firefoxfrom selenium import webdriver options webdriver.ChromeOptions() options.binary_location 你的浏览器路径3.2 元素操作黄金六式精准点击touch(Template(百度logo.png))图片识别点击比XPath更抗页面改版智能输入text(搜索关键词, enterTrue)带回车操作的输入滑动验证swipe((300,800), (300,200))处理滑块验证码的利器多窗口切换switch_to_new_tab()电商网站比价场景必备断言优化assert_exists(Template(支付成功.png), 支付状态验证)视觉验证比文本断言更直观异常处理try-except包裹关键步骤配合snapshot()保存现场截图去年做跨境电商项目时我们通过组合swipeassert_exists实现了商品列表的滚动加载检测成功率比传统方法提升40%。4. 移动端自动化专项突破4.1 APP启动的三种姿势图标点击法新手友好但脆弱页面布局变化就失效包名启动法start_app(com.taobao.taobao)最稳定的启动方式Activity直连法shell am start -n com.taobao/.taobao.TaoMainActivity适合特殊场景获取包名的秘笈连接设备后在IDE点击Android助手-刷新按钮所有安装包一目了然。上周排查问题时发现某些华为手机会对包名做混淆这时可以用adb shell pm list packages | grep taobao过滤。4.2 Poco框架的进阶用法动态元素定位策略poco(textMatches.*登录.*).click() # 模糊匹配 poco(descuser_name).set_text(test) # 替代appium的content-desc列表处理技巧items poco(android.widget.ListView).child(android.widget.LinearLayout) for i in range(items.len()): if items[i].child(text特价商品).exists(): items[i].click()去年优化社交APP测试脚本时我们通过poco.wait_for_all()解决了90%的异步加载问题配合poco.freeze()生成稳定的UI树使脚本稳定性从60%提升到98%。5. 测试报告与持续集成Airtest的报告系统自带对比视图功能但很多人不知道可以二次开发。这是我们团队改造后的报告模板增强点添加了性能数据监控折线图整合了FPS/CPU/Memory数据错误步骤自动关联JIRA工单支持导出为PDF格式归档命令行集成方案# 运行脚本并生成报告 airtest run test.air --device Android:/// --log logs/ airtest report test.air --log_root logs/ --export report/在Jenkins中建议这样配置pipeline { agent any stages { stage(Test) { steps { bat airtest run %WORKSPACE%\\test.air } } stage(Report) { steps { bat airtest report %WORKSPACE%\\test.air --export %WORKSPACE%\\report publishHTML target: [ allowMissing: false, alwaysLinkToLastBuild: false, keepAll: true, reportDir: report, reportFiles: log.html, reportName: Airtest Report ] } } } }6. 常见问题排查手册设备连接类现象ADB devices列表为空检查adb usb查看USB授权状态解决换原装数据线不同USB口交替测试元素识别类现象Poco无法识别某些元素检查adb shell dumpsys window windows确认Activity名称解决在目标页面执行poco.agent.hierarchy.dump()检查UI树性能优化类现象截图操作特别慢检查adb shell getprop ro.sf.lcd_density查看屏幕密度解决在IDE设置中调整截图质量为70%有个记忆深刻的案例某次大版本更新后所有测试脚本突然集体失效。最后发现是开发引入了新的主题框架导致所有控件路径变化。我们通过引入poco.wait_for_any()和动态选择器策略用3天时间完成了200脚本的适配升级。
