1. 项目概述为什么要在Mac上搭建iOS自动化测试环境作为一名在移动端测试领域摸爬滚打了多年的老手我深知一个稳定、高效的自动化测试环境对于保障iOS应用质量的重要性。尤其是在Mac这个苹果生态的“官方主场”上搭建一套基于WebDriverAgentWDA和Airtest的iOS自动化测试框架几乎是所有中大型App测试团队的标配。这个环境的核心价值在于它打通了从脚本编写、设备控制到结果验证的完整链路让你能用Python这种简洁的语言像操作真实用户一样去驱动真机或模拟器完成UI交互、断言校验等重复性工作。你可能听过Appium它同样基于WDA但Airtest-Poco这套由网易开源的方案在我看来对于国内团队尤其友好。它的图像识别能力能很好地处理游戏、或是一些自定义控件复杂的场景而Poco基于UI树结构的定位又保证了稳定性。在Mac上搭建它意味着你可以直接对接Xcode、iOS模拟器以及通过USB连接的iPhone/iPad真机环境最纯净链路最短出问题时排查也最直接。无论是为了应对每日的冒烟测试、兼容性测试还是复杂的业务流回归自己动手搭好这个环境都是提升测试效率、解放双手的第一步。2. 环境整体设计与核心组件解析搭建这个环境本质上是在Mac上部署一个能够驱动iOS设备并执行自动化指令的“控制中心”。整个架构可以理解为三层驱动层、服务层和脚本层。理解每一层的角色和选型理由是后续顺利操作和排错的基础。2.1 核心组件选型与职责驱动层WebDriverAgent (WDA)是什么这是Facebook开源的一个iOS自动化测试框架实现了WebDriver协议。你可以把它理解为一个安装在iOS设备模拟器或真机上的“遥控器接收器”。它运行在设备上监听来自Mac上测试脚本的HTTP请求比如“点击某个坐标”、“获取当前页面XML”并将其转化为设备能执行的原生操作。为什么选它它是目前iOS自动化领域事实上的标准底层驱动。Appium在iOS端也依赖它。选择直接使用WDA而非完全通过Appium能让我们更底层地理解通信机制在遇到复杂问题时更有掌控力且减少了Appium这一中间层的潜在不稳定因素。服务层Airtest PocoAirtest这是一个基于图像识别和UI控件识别的自动化测试框架。它的核心优势在于“所见即所得”的图像识别对于游戏界面、无法直接获取控件信息的原生应用或混合应用部分场景非常有效。它通过截屏、特征匹配的方式来定位元素并操作。Poco这是Airtest项目中的一个UI控件定位框架。它通过访问应用的UI层级结构类似于Android的UIAutomator或iOS的XCUITest获取每个控件的属性如name、type、pos从而进行精准定位。这种方式比纯图像识别更稳定、执行更快。为什么选它们Airtest-Poco组合提供了“图像识别”和“控件定位”双保险适应性极强。其Python API设计得非常简洁学习成本低。而且它自带的AirtestIDE图形化工具对于录制脚本、查看UI树、调试有巨大帮助特别适合新手快速上手。脚本层Python是什么我们的自动化测试脚本将全部使用Python编写。为什么选它Python语法简洁生态丰富是自动化测试领域的主流语言。Airtest框架本身就是Python编写的天然契合。我们可以利用pip管理所有依赖用丰富的第三方库如pytest做测试组织allure生成报告来构建强大的测试工程。2.2 环境依赖关系梳理在Mac上这些组件通过以下方式协同工作你的Python脚本使用Airtest/Poco API运行在Mac上。脚本通过facebook-wda或airtest的iOS设备连接库向WDA服务发送HTTP请求。WDA服务运行在iOS设备通过USB连接的iPhone或模拟器上接收指令并驱动设备执行操作点击、滑动、输入等。操作结果或设备状态如截图、UI树再通过WDA返回给Mac上的脚本完成一次交互。因此搭建环境的关键就是在Mac上配置好Python及Airtest环境在iOS设备上成功编译、安装并启动WDA。3. 详细搭建步骤与实操要点接下来我们一步步拆解搭建过程。请准备好你的Mac电脑并确保有一台可用于测试的iPhone需要Apple ID和开发者账号或能使用Xcode模拟器。3.1 基础环境准备Xcode与Homebrew这是所有步骤的基石缺一不可。安装/更新Xcode从Mac App Store搜索并安装最新版本的Xcode。安装完成后务必打开一次Xcode完成命令行工具的安装会自动弹出提示。实操要点安装后在终端运行xcode-select --install以确保命令行工具就位。随后运行sudo xcode-select -s /Applications/Xcode.app/Contents/Developer来设置默认路径。验证xcodebuild -version应能输出版本号。安装HomebrewHomebrew是Mac的包管理器能让我们方便地安装后续需要的工具。访问brew.sh官网复制安装命令到终端执行。安装过程可能会要求你安装Xcode命令行工具如果上一步已做这里会跳过。注意事项安装脚本可能会因网络问题中断。如果遇到问题可以尝试更换中科大的镜像源。安装成功后运行brew --version验证。3.2 编译与部署WebDriverAgent (WDA)这是整个环境搭建中最容易踩坑的环节需要耐心和细心。获取WDA源码# 使用git克隆仓库 git clone https://github.com/facebookarchive/WebDriverAgent.git cd WebDriverAgent注意Facebook已将WDA归档此仓库是只读的。但这不影响我们使用因为它已经非常稳定。安装依赖# 使用脚本安装必要的Carthage依赖用于管理项目依赖 ./Scripts/bootstrap.sh这个脚本会通过Carthage下载和编译一些必要的框架。确保网络通畅第一次运行可能耗时较长。使用Xcode打开项目open WebDriverAgent.xcodeproj配置签名针对真机这是关键在Xcode左侧项目导航器中选中WebDriverAgentLibtarget然后进入Signing Capabilities标签页。在Team下拉框中选择你的Apple开发者账号个人免费账号也可但部分功能受限。Xcode会自动生成一个描述文件Provisioning Profile。重复此操作对WebDriverAgentRunner和IntegrationApp这两个target进行完全相同的签名设置。实操心得务必确保三个target的Bundle Identifier是唯一的通常Xcode会自动帮你添加后缀。如果遇到签名错误可以尝试点击Team选择框下的“”号让Xcode完全重新管理签名。连接真机并选择Target用USB线连接你的iPhone到Mac。在Xcode顶部工具栏的Scheme选择器中将目标设备从“Any iOS Device”更改为你连接的iPhone设备。同样在Scheme选择器旁边确保选中的是WebDriverAgentRunner这个scheme。编译与运行点击Xcode的运行按钮或按CmdR。这会将WebDriverAgentRunner这个测试包安装到你的iPhone上。首次安装时需要在iPhone上进入设置 - 通用 - VPN与设备管理信任你的开发者证书。重要运行成功后Xcode的控制台会输出大量日志。你需要从中找到类似“ServerURLHere-http://设备IP:端口”的一行信息。记下这个IP和端口通常是8100。这就是WDA服务在设备上的访问地址。验证WDA服务确保你的Mac和iPhone在同一个局域网Wi-Fi下。在Mac的浏览器中输入http://设备IP:8100/status。如果看到返回一个JSON数据其中包含“value”和“sessionId”等信息说明WDA服务运行成功。踩坑记录如果浏览器无法访问最常见的原因是防火墙或网络权限。在iPhone上首次运行可能需要允许“本地网络”访问。可以去设置 - 隐私与安全性 - 本地网络中找到以“WebDriverAgentRunner-”开头的应用并打开开关。3.3 安装Python与Airtest环境建议使用Python3并通过虚拟环境管理避免包冲突。安装Python3# 使用Homebrew安装Python brew install python安装后python3 --version和pip3 --version应有正确输出。创建并激活虚拟环境# 在你的工作目录下 python3 -m venv airtest_env source airtest_env/bin/activate激活后终端提示符前会出现(airtest_env)字样。安装Airtest及相关库# 安装Airtest核心库 pip3 install airtest # 安装iOS设备连接支持库这是连接WDA的关键 pip3 install facebook-wda # 安装Poco库如果需要控件识别 pip3 install pocoui # 可选但推荐安装用于生成测试报告的allure-pytest pip3 install pytest allure-pytest注意事项facebook-wda是一个Python客户端库它封装了与WDA服务通信的细节。airtest库本身也包含了iOS支持但其底层可能调用facebook-wda或类似机制。直接安装facebook-wda能让我们在脚本中更灵活地使用。3.4 编写第一个自动化测试脚本环境就绪我们来写一个简单的脚本验证整个链路。这个脚本将打开iPhone的“设置”应用并点击进入“无线局域网”页面。创建测试脚本first_test.py# -*- encodingutf8 -*- __author__ “YourName” import wda from airtest.core.api import * import time # 1. 连接iOS设备 # 替换成你之前从WDA日志中获取的IP和端口 client wda.Client(‘http://你的设备IP:8100’) # 或者使用USB连接需安装iproxy速度更快更稳定 # client wda.USBClient() # 需要先启动iproxy转发端口 # 2. 创建一个session这相当于启动了一个自动化会话 session client.session() # 3. 操作示例打开设置App # iOS的Bundle ID是应用的唯一标识 session.app_launch(‘com.apple.Preferences’) time.sleep(2) # 等待应用启动 # 4. 使用Airtest的图像识别功能可选 # 假设你有一张“无线局域网”图标的截图保存为’wifi.png‘ # touch(Template(r”wifi.png”)) # Airtest的图像点击 # 5. 使用Poco进行控件操作推荐更稳定 # 首先需要启动对应应用的Poco服务这里以原生iOS为例 # from poco.drivers.ios import iosPoco # poco iosPoco() # poco(“无线局域网”).click() # 6. 使用facebook-wda的定位方式本例使用 # 通过元素类型和名称定位。可以使用Xcode的Accessibility Inspector查看元素属性。 # 这里假设“无线局域网”是一个Cell表格单元格 session(name‘无线局域网’).click() # 7. 截图保存结果 session.screenshot(‘./screenshot_after_click.png’) print(“测试步骤执行完毕”) # 8. 结束session session.close()执行脚本 在终端确保虚拟环境已激活然后运行python3 first_test.py观察你的iPhone应该会自动打开“设置”应用并跳转到“无线局域网”页面。4. 核心技巧与深度优化配置基础环境跑通只是开始要让它在项目中真正可用、好用还需要一些技巧和优化。4.1 稳定设备连接的两种方式Wi-Fi连接方式如上例使用设备的局域网IP。优点无线连接方便。缺点依赖网络稳定性延迟稍高且设备IP可能变化。优化在路由器上为iPhone设置静态IP地址避免IP变化导致脚本失效。USB连接推荐方式通过iproxy工具将设备上的WDA服务端口8100映射到Mac本地的一个端口。优点速度极快延迟低稳定不依赖网络。操作# 首先安装usbmuxd它包含了iproxy brew install usbmuxd # 启动端口转发将设备的8100端口映射到本地的8100端口 iproxy 8100 8100 [你的设备UDID] 然后在Python脚本中连接地址改为http://localhost:8100即可。实操心得将iproxy命令写入一个脚本并在执行自动化测试前运行可以确保连接稳定。也可以使用facebook-wda的USBClient()它会自动处理端口转发。4.2 元素定位策略与最佳实践定位不到元素是自动化测试中最常见的问题。以下是优先级推荐Poco控件定位首选对于支持Poco的应用通常需要开发集成Poco SDK或使用原生、Unity3D、Cocos2dx等游戏引擎这是最稳定、最快的方式。使用AirtestIDE连接设备后可以实时查看和选取UI树自动生成定位代码。示例poco(“Settings”).click()WDA原生定位使用facebook-wda提供的定位方法如name,label,value,className,xpath等。可以使用Xcode的Accessibility Inspector工具来探查应用的元素属性。示例session(className“XCUIElementTypeCell”, name“Wi-Fi”).click()图像识别定位兜底当控件无法通过上述方法定位时如游戏中的精灵、自定义绘制控件使用Airtest的图像识别。技巧截图时尽量保持背景纯净特征点明显。适当调整threshold匹配阈值参数以平衡准确率和容错。示例touch(Template(r”wifi_icon.png”, threshold0.9))4.3 集成测试报告与持续集成单个脚本成功不算什么融入开发流程才能体现价值。使用pytest组织用例将测试脚本改写成pytest的测试函数或测试类格式。利用fixture管理设备连接、应用启动等前置后置操作。import pytest import wda pytest.fixture(scope“module”) def ios_setup(): client wda.USBClient() session client.session(‘com.apple.Preferences’) yield session session.close() def test_wifi_settings(ios_setup): session ios_setup session(name‘无线局域网’).click() assert session(name“Wi-Fi”).exists生成Allure可视化报告运行测试时添加参数生成Allure结果数据。pytest —alluredir./allure-results使用Allure命令行工具生成HTML报告。allure serve ./allure-results报告会包含用例执行情况、步骤详情、截图、错误日志等非常直观。接入CI/CD如Jenkins在Jenkins节点上配置好Mac环境包括开发者证书。将测试代码仓库、设备管理脚本、测试执行命令集成到Jenkins Pipeline中。可以设置为每晚定时执行或在开发合并代码后自动触发回归测试。5. 常见问题排查与实战避坑指南这里汇总了我踩过或见别人踩过最多的“坑”希望能帮你节省大量时间。5.1 WDA编译与安装失败问题Xcode编译WDA时报签名错误Code Signing Error。排查确认Apple ID已在Xcode的Accounts中登录。确认WebDriverAgentLib,WebDriverAgentRunner,IntegrationApp三个target的Signing Capabilities中Team都已正确选择且Bundle Identifier唯一。尝试点击Team下拉框下的“”让Xcode“Manage Certificates and Profiles Automatically”。前往钥匙串访问检查是否有过期或冲突的证书。根治使用免费的Apple ID时某些功能可能受限。对于公司项目建议使用每年99美元的开发者账号创建正式的开发证书和描述文件来签名最稳定。5.2 无法连接到WDA服务问题脚本报错Unable to connect to device或浏览器访问http://设备IP:8100/status失败。排查检查WDA是否运行查看Xcode控制台确认有“ServerURLHere”日志且无红色错误。检查IP和端口确认脚本中使用的IP和端口与控制台日志一致。检查网络确保Mac和iPhone在同一个Wi-Fi网络下。尝试关闭Mac和iPhone的防火墙。检查本地网络权限在iPhone的设置 - 隐私与安全性 - 本地网络中确保WebDriverAgentRunner-Runner的开关是打开的。尝试USB连接如果Wi-Fi不稳定优先使用iproxy进行USB连接。5.3 元素定位失败NoSuchElement问题脚本执行时提示找不到元素。排查等待时机在操作元素前添加显式等待time.sleep是下策。facebook-wda的session对象操作默认有隐式等待。可以使用session(name‘xxx’).wait(timeout10.0)等待元素出现。确认属性使用Xcode的Accessibility Inspector或AirtestIDE的Poco Inspector重新检查元素的准确属性name,label,className。注意label和name有时不同。层级变化页面是否弹出了模态框、键盘遮挡了目标元素此时需要先处理这些弹出层。使用更宽松的定位器如果name不稳定可以尝试结合className和xpath。例如session(xpath‘//XCUIElementTypeCell[contains(name, “Wi”)]’)。切换到图像识别作为最终兜底方案。5.4 脚本执行速度慢或不稳定问题测试用例执行时间长或偶尔失败。优化使用USB连接这是提升速度和稳定性的最有效手段。减少不必要的截图Airtest的每一步操作默认会截图可以在代码中通过auto_screenshotFalse关闭非必要的步骤截图。优化等待策略用显式等待等待特定条件替代固定的time.sleep。重用Session不要在每条用例中都重新启动App。通过session.app_launch(BundleId)和session.app_activate(BundleId)来管理应用状态。关闭后台应用定期清理设备后台减少内存和CPU竞争。5.5 真机与模拟器的选择考量模拟器优点启动快无需签名资源免费适合快速调试脚本逻辑。缺点无法模拟所有真机特性如陀螺仪、精确的多点触控、某些传感器性能表现也与真机有差异。使用在Xcode中启动模拟器WDA的编译目标选择对应的模拟器即可。连接地址通常是http://localhost:8100。真机优点真实用户环境测试结果可信度高。缺点需要签名、占用物理设备、执行速度受限于设备性能。建议日常脚本开发和调试可在模拟器上进行但最终的功能回归和兼容性测试必须在真机上进行。可以准备多台不同型号、系统的iPhone用于覆盖测试。搭建环境只是起点真正的挑战在于如何设计出稳定、可维护、高效的自动化测试用例集。这需要测试人员对业务有深刻理解对iOS UI结构有清晰认识并不断在实践中积累定位技巧和等待策略。当你的自动化脚本能在无人值守的情况下每晚为你跑完数百个用例并生成一份清晰的测试报告时你就会觉得前期所有的折腾都是值得的。
Mac搭建iOS自动化测试环境：基于WDA与Airtest的完整指南
1. 项目概述为什么要在Mac上搭建iOS自动化测试环境作为一名在移动端测试领域摸爬滚打了多年的老手我深知一个稳定、高效的自动化测试环境对于保障iOS应用质量的重要性。尤其是在Mac这个苹果生态的“官方主场”上搭建一套基于WebDriverAgentWDA和Airtest的iOS自动化测试框架几乎是所有中大型App测试团队的标配。这个环境的核心价值在于它打通了从脚本编写、设备控制到结果验证的完整链路让你能用Python这种简洁的语言像操作真实用户一样去驱动真机或模拟器完成UI交互、断言校验等重复性工作。你可能听过Appium它同样基于WDA但Airtest-Poco这套由网易开源的方案在我看来对于国内团队尤其友好。它的图像识别能力能很好地处理游戏、或是一些自定义控件复杂的场景而Poco基于UI树结构的定位又保证了稳定性。在Mac上搭建它意味着你可以直接对接Xcode、iOS模拟器以及通过USB连接的iPhone/iPad真机环境最纯净链路最短出问题时排查也最直接。无论是为了应对每日的冒烟测试、兼容性测试还是复杂的业务流回归自己动手搭好这个环境都是提升测试效率、解放双手的第一步。2. 环境整体设计与核心组件解析搭建这个环境本质上是在Mac上部署一个能够驱动iOS设备并执行自动化指令的“控制中心”。整个架构可以理解为三层驱动层、服务层和脚本层。理解每一层的角色和选型理由是后续顺利操作和排错的基础。2.1 核心组件选型与职责驱动层WebDriverAgent (WDA)是什么这是Facebook开源的一个iOS自动化测试框架实现了WebDriver协议。你可以把它理解为一个安装在iOS设备模拟器或真机上的“遥控器接收器”。它运行在设备上监听来自Mac上测试脚本的HTTP请求比如“点击某个坐标”、“获取当前页面XML”并将其转化为设备能执行的原生操作。为什么选它它是目前iOS自动化领域事实上的标准底层驱动。Appium在iOS端也依赖它。选择直接使用WDA而非完全通过Appium能让我们更底层地理解通信机制在遇到复杂问题时更有掌控力且减少了Appium这一中间层的潜在不稳定因素。服务层Airtest PocoAirtest这是一个基于图像识别和UI控件识别的自动化测试框架。它的核心优势在于“所见即所得”的图像识别对于游戏界面、无法直接获取控件信息的原生应用或混合应用部分场景非常有效。它通过截屏、特征匹配的方式来定位元素并操作。Poco这是Airtest项目中的一个UI控件定位框架。它通过访问应用的UI层级结构类似于Android的UIAutomator或iOS的XCUITest获取每个控件的属性如name、type、pos从而进行精准定位。这种方式比纯图像识别更稳定、执行更快。为什么选它们Airtest-Poco组合提供了“图像识别”和“控件定位”双保险适应性极强。其Python API设计得非常简洁学习成本低。而且它自带的AirtestIDE图形化工具对于录制脚本、查看UI树、调试有巨大帮助特别适合新手快速上手。脚本层Python是什么我们的自动化测试脚本将全部使用Python编写。为什么选它Python语法简洁生态丰富是自动化测试领域的主流语言。Airtest框架本身就是Python编写的天然契合。我们可以利用pip管理所有依赖用丰富的第三方库如pytest做测试组织allure生成报告来构建强大的测试工程。2.2 环境依赖关系梳理在Mac上这些组件通过以下方式协同工作你的Python脚本使用Airtest/Poco API运行在Mac上。脚本通过facebook-wda或airtest的iOS设备连接库向WDA服务发送HTTP请求。WDA服务运行在iOS设备通过USB连接的iPhone或模拟器上接收指令并驱动设备执行操作点击、滑动、输入等。操作结果或设备状态如截图、UI树再通过WDA返回给Mac上的脚本完成一次交互。因此搭建环境的关键就是在Mac上配置好Python及Airtest环境在iOS设备上成功编译、安装并启动WDA。3. 详细搭建步骤与实操要点接下来我们一步步拆解搭建过程。请准备好你的Mac电脑并确保有一台可用于测试的iPhone需要Apple ID和开发者账号或能使用Xcode模拟器。3.1 基础环境准备Xcode与Homebrew这是所有步骤的基石缺一不可。安装/更新Xcode从Mac App Store搜索并安装最新版本的Xcode。安装完成后务必打开一次Xcode完成命令行工具的安装会自动弹出提示。实操要点安装后在终端运行xcode-select --install以确保命令行工具就位。随后运行sudo xcode-select -s /Applications/Xcode.app/Contents/Developer来设置默认路径。验证xcodebuild -version应能输出版本号。安装HomebrewHomebrew是Mac的包管理器能让我们方便地安装后续需要的工具。访问brew.sh官网复制安装命令到终端执行。安装过程可能会要求你安装Xcode命令行工具如果上一步已做这里会跳过。注意事项安装脚本可能会因网络问题中断。如果遇到问题可以尝试更换中科大的镜像源。安装成功后运行brew --version验证。3.2 编译与部署WebDriverAgent (WDA)这是整个环境搭建中最容易踩坑的环节需要耐心和细心。获取WDA源码# 使用git克隆仓库 git clone https://github.com/facebookarchive/WebDriverAgent.git cd WebDriverAgent注意Facebook已将WDA归档此仓库是只读的。但这不影响我们使用因为它已经非常稳定。安装依赖# 使用脚本安装必要的Carthage依赖用于管理项目依赖 ./Scripts/bootstrap.sh这个脚本会通过Carthage下载和编译一些必要的框架。确保网络通畅第一次运行可能耗时较长。使用Xcode打开项目open WebDriverAgent.xcodeproj配置签名针对真机这是关键在Xcode左侧项目导航器中选中WebDriverAgentLibtarget然后进入Signing Capabilities标签页。在Team下拉框中选择你的Apple开发者账号个人免费账号也可但部分功能受限。Xcode会自动生成一个描述文件Provisioning Profile。重复此操作对WebDriverAgentRunner和IntegrationApp这两个target进行完全相同的签名设置。实操心得务必确保三个target的Bundle Identifier是唯一的通常Xcode会自动帮你添加后缀。如果遇到签名错误可以尝试点击Team选择框下的“”号让Xcode完全重新管理签名。连接真机并选择Target用USB线连接你的iPhone到Mac。在Xcode顶部工具栏的Scheme选择器中将目标设备从“Any iOS Device”更改为你连接的iPhone设备。同样在Scheme选择器旁边确保选中的是WebDriverAgentRunner这个scheme。编译与运行点击Xcode的运行按钮或按CmdR。这会将WebDriverAgentRunner这个测试包安装到你的iPhone上。首次安装时需要在iPhone上进入设置 - 通用 - VPN与设备管理信任你的开发者证书。重要运行成功后Xcode的控制台会输出大量日志。你需要从中找到类似“ServerURLHere-http://设备IP:端口”的一行信息。记下这个IP和端口通常是8100。这就是WDA服务在设备上的访问地址。验证WDA服务确保你的Mac和iPhone在同一个局域网Wi-Fi下。在Mac的浏览器中输入http://设备IP:8100/status。如果看到返回一个JSON数据其中包含“value”和“sessionId”等信息说明WDA服务运行成功。踩坑记录如果浏览器无法访问最常见的原因是防火墙或网络权限。在iPhone上首次运行可能需要允许“本地网络”访问。可以去设置 - 隐私与安全性 - 本地网络中找到以“WebDriverAgentRunner-”开头的应用并打开开关。3.3 安装Python与Airtest环境建议使用Python3并通过虚拟环境管理避免包冲突。安装Python3# 使用Homebrew安装Python brew install python安装后python3 --version和pip3 --version应有正确输出。创建并激活虚拟环境# 在你的工作目录下 python3 -m venv airtest_env source airtest_env/bin/activate激活后终端提示符前会出现(airtest_env)字样。安装Airtest及相关库# 安装Airtest核心库 pip3 install airtest # 安装iOS设备连接支持库这是连接WDA的关键 pip3 install facebook-wda # 安装Poco库如果需要控件识别 pip3 install pocoui # 可选但推荐安装用于生成测试报告的allure-pytest pip3 install pytest allure-pytest注意事项facebook-wda是一个Python客户端库它封装了与WDA服务通信的细节。airtest库本身也包含了iOS支持但其底层可能调用facebook-wda或类似机制。直接安装facebook-wda能让我们在脚本中更灵活地使用。3.4 编写第一个自动化测试脚本环境就绪我们来写一个简单的脚本验证整个链路。这个脚本将打开iPhone的“设置”应用并点击进入“无线局域网”页面。创建测试脚本first_test.py# -*- encodingutf8 -*- __author__ “YourName” import wda from airtest.core.api import * import time # 1. 连接iOS设备 # 替换成你之前从WDA日志中获取的IP和端口 client wda.Client(‘http://你的设备IP:8100’) # 或者使用USB连接需安装iproxy速度更快更稳定 # client wda.USBClient() # 需要先启动iproxy转发端口 # 2. 创建一个session这相当于启动了一个自动化会话 session client.session() # 3. 操作示例打开设置App # iOS的Bundle ID是应用的唯一标识 session.app_launch(‘com.apple.Preferences’) time.sleep(2) # 等待应用启动 # 4. 使用Airtest的图像识别功能可选 # 假设你有一张“无线局域网”图标的截图保存为’wifi.png‘ # touch(Template(r”wifi.png”)) # Airtest的图像点击 # 5. 使用Poco进行控件操作推荐更稳定 # 首先需要启动对应应用的Poco服务这里以原生iOS为例 # from poco.drivers.ios import iosPoco # poco iosPoco() # poco(“无线局域网”).click() # 6. 使用facebook-wda的定位方式本例使用 # 通过元素类型和名称定位。可以使用Xcode的Accessibility Inspector查看元素属性。 # 这里假设“无线局域网”是一个Cell表格单元格 session(name‘无线局域网’).click() # 7. 截图保存结果 session.screenshot(‘./screenshot_after_click.png’) print(“测试步骤执行完毕”) # 8. 结束session session.close()执行脚本 在终端确保虚拟环境已激活然后运行python3 first_test.py观察你的iPhone应该会自动打开“设置”应用并跳转到“无线局域网”页面。4. 核心技巧与深度优化配置基础环境跑通只是开始要让它在项目中真正可用、好用还需要一些技巧和优化。4.1 稳定设备连接的两种方式Wi-Fi连接方式如上例使用设备的局域网IP。优点无线连接方便。缺点依赖网络稳定性延迟稍高且设备IP可能变化。优化在路由器上为iPhone设置静态IP地址避免IP变化导致脚本失效。USB连接推荐方式通过iproxy工具将设备上的WDA服务端口8100映射到Mac本地的一个端口。优点速度极快延迟低稳定不依赖网络。操作# 首先安装usbmuxd它包含了iproxy brew install usbmuxd # 启动端口转发将设备的8100端口映射到本地的8100端口 iproxy 8100 8100 [你的设备UDID] 然后在Python脚本中连接地址改为http://localhost:8100即可。实操心得将iproxy命令写入一个脚本并在执行自动化测试前运行可以确保连接稳定。也可以使用facebook-wda的USBClient()它会自动处理端口转发。4.2 元素定位策略与最佳实践定位不到元素是自动化测试中最常见的问题。以下是优先级推荐Poco控件定位首选对于支持Poco的应用通常需要开发集成Poco SDK或使用原生、Unity3D、Cocos2dx等游戏引擎这是最稳定、最快的方式。使用AirtestIDE连接设备后可以实时查看和选取UI树自动生成定位代码。示例poco(“Settings”).click()WDA原生定位使用facebook-wda提供的定位方法如name,label,value,className,xpath等。可以使用Xcode的Accessibility Inspector工具来探查应用的元素属性。示例session(className“XCUIElementTypeCell”, name“Wi-Fi”).click()图像识别定位兜底当控件无法通过上述方法定位时如游戏中的精灵、自定义绘制控件使用Airtest的图像识别。技巧截图时尽量保持背景纯净特征点明显。适当调整threshold匹配阈值参数以平衡准确率和容错。示例touch(Template(r”wifi_icon.png”, threshold0.9))4.3 集成测试报告与持续集成单个脚本成功不算什么融入开发流程才能体现价值。使用pytest组织用例将测试脚本改写成pytest的测试函数或测试类格式。利用fixture管理设备连接、应用启动等前置后置操作。import pytest import wda pytest.fixture(scope“module”) def ios_setup(): client wda.USBClient() session client.session(‘com.apple.Preferences’) yield session session.close() def test_wifi_settings(ios_setup): session ios_setup session(name‘无线局域网’).click() assert session(name“Wi-Fi”).exists生成Allure可视化报告运行测试时添加参数生成Allure结果数据。pytest —alluredir./allure-results使用Allure命令行工具生成HTML报告。allure serve ./allure-results报告会包含用例执行情况、步骤详情、截图、错误日志等非常直观。接入CI/CD如Jenkins在Jenkins节点上配置好Mac环境包括开发者证书。将测试代码仓库、设备管理脚本、测试执行命令集成到Jenkins Pipeline中。可以设置为每晚定时执行或在开发合并代码后自动触发回归测试。5. 常见问题排查与实战避坑指南这里汇总了我踩过或见别人踩过最多的“坑”希望能帮你节省大量时间。5.1 WDA编译与安装失败问题Xcode编译WDA时报签名错误Code Signing Error。排查确认Apple ID已在Xcode的Accounts中登录。确认WebDriverAgentLib,WebDriverAgentRunner,IntegrationApp三个target的Signing Capabilities中Team都已正确选择且Bundle Identifier唯一。尝试点击Team下拉框下的“”让Xcode“Manage Certificates and Profiles Automatically”。前往钥匙串访问检查是否有过期或冲突的证书。根治使用免费的Apple ID时某些功能可能受限。对于公司项目建议使用每年99美元的开发者账号创建正式的开发证书和描述文件来签名最稳定。5.2 无法连接到WDA服务问题脚本报错Unable to connect to device或浏览器访问http://设备IP:8100/status失败。排查检查WDA是否运行查看Xcode控制台确认有“ServerURLHere”日志且无红色错误。检查IP和端口确认脚本中使用的IP和端口与控制台日志一致。检查网络确保Mac和iPhone在同一个Wi-Fi网络下。尝试关闭Mac和iPhone的防火墙。检查本地网络权限在iPhone的设置 - 隐私与安全性 - 本地网络中确保WebDriverAgentRunner-Runner的开关是打开的。尝试USB连接如果Wi-Fi不稳定优先使用iproxy进行USB连接。5.3 元素定位失败NoSuchElement问题脚本执行时提示找不到元素。排查等待时机在操作元素前添加显式等待time.sleep是下策。facebook-wda的session对象操作默认有隐式等待。可以使用session(name‘xxx’).wait(timeout10.0)等待元素出现。确认属性使用Xcode的Accessibility Inspector或AirtestIDE的Poco Inspector重新检查元素的准确属性name,label,className。注意label和name有时不同。层级变化页面是否弹出了模态框、键盘遮挡了目标元素此时需要先处理这些弹出层。使用更宽松的定位器如果name不稳定可以尝试结合className和xpath。例如session(xpath‘//XCUIElementTypeCell[contains(name, “Wi”)]’)。切换到图像识别作为最终兜底方案。5.4 脚本执行速度慢或不稳定问题测试用例执行时间长或偶尔失败。优化使用USB连接这是提升速度和稳定性的最有效手段。减少不必要的截图Airtest的每一步操作默认会截图可以在代码中通过auto_screenshotFalse关闭非必要的步骤截图。优化等待策略用显式等待等待特定条件替代固定的time.sleep。重用Session不要在每条用例中都重新启动App。通过session.app_launch(BundleId)和session.app_activate(BundleId)来管理应用状态。关闭后台应用定期清理设备后台减少内存和CPU竞争。5.5 真机与模拟器的选择考量模拟器优点启动快无需签名资源免费适合快速调试脚本逻辑。缺点无法模拟所有真机特性如陀螺仪、精确的多点触控、某些传感器性能表现也与真机有差异。使用在Xcode中启动模拟器WDA的编译目标选择对应的模拟器即可。连接地址通常是http://localhost:8100。真机优点真实用户环境测试结果可信度高。缺点需要签名、占用物理设备、执行速度受限于设备性能。建议日常脚本开发和调试可在模拟器上进行但最终的功能回归和兼容性测试必须在真机上进行。可以准备多台不同型号、系统的iPhone用于覆盖测试。搭建环境只是起点真正的挑战在于如何设计出稳定、可维护、高效的自动化测试用例集。这需要测试人员对业务有深刻理解对iOS UI结构有清晰认识并不断在实践中积累定位技巧和等待策略。当你的自动化脚本能在无人值守的情况下每晚为你跑完数百个用例并生成一份清晰的测试报告时你就会觉得前期所有的折腾都是值得的。
