iOS自动化测试入门：除了Appium，用WDA + Python也能玩转手机操控（真机演示）-平芜编程栈

iOS自动化测试实战：用WDA+Python构建轻量级手机操控方案

从Appium到WDA的进阶之路

很多iOS自动化测试工程师的起点都是从Appium开始的——这个跨平台的测试框架确实降低了入门门槛。但当你逐渐深入，会发现Appium有时显得过于"厚重"：它封装了大量底层细节，虽然简化了操作，却也让我们与设备之间的真实交互变得模糊。

这就是为什么越来越多的技术探索者开始关注WebDriverAgent（WDA）。作为Appium在iOS端的底层引擎，WDA直接实现了WebDriver协议，让我们能够以更轻量、更直接的方式控制iOS设备。想象一下，当你不再需要Appium这个"中间商"，而是直接与设备对话时，能获得怎样的灵活性和控制力？

我最初接触WDA时也走过弯路——试图用Objective-C直接调用它的接口。后来发现，通过Python的facebook-wda库，我们既能保持Python的简洁语法，又能享受直接操控设备的快感。这种组合特别适合那些：

追求极致执行效率的自动化测试工程师
需要高度定制化控制方案的技术团队
希望深入理解iOS自动化底层原理的学习者

1. 环境准备与基础配置

1.1 WDA服务端启动

假设你已经按照官方文档完成了WDA的安装和签名配置（这是最复杂的部分，但幸运的是现在Appium维护的WDA版本简化了这个过程）。要让WDA服务正常运行，你需要：

# 在Mac终端中启动WDA服务 xcodebuild -project WebDriverAgent.xcodeproj \ -scheme WebDriverAgentRunner \ -destination 'id=<你的设备UDID>' \ test

启动成功后，你会看到类似这样的输出：

Test Suite 'All tests' started at 2023-07-20 15:30:45.312 Test Suite 'WebDriverAgentRunner.xctest' started at 2023-07-20 15:30:45.314 Test Suite 'UITestingUITests' started at 2023-07-20 15:30:45.315 Test Case '-[UITestingUITests testRunner]' started.

提示：建议使用iproxy进行端口转发，避免iOS设备与电脑的网络隔离问题：iproxy 8100 8100

1.2 Python客户端库选择

目前主流的Python WDA客户端有两个选择：

库名称	优点	缺点
facebook-wda	专为WDA设计，API简洁	文档较少，社区支持有限
appium-python-client	功能全面，文档丰富	包含大量Appium特有功能

对于追求轻量化的场景，我推荐facebook-wda。安装非常简单：

pip install facebook-wda

2. 基础操作：从连接到简单交互

2.1 建立WDA连接

让我们从最基础的连接开始。创建一个Python脚本，初始化WDA客户端：

import wda # 连接到本地WDA服务 c = wda.Client('http://localhost:8100') # 获取设备信息 print(c.status())

运行这段代码，你应该能看到设备的基本信息输出，类似：

{ "value": { "message": "WebDriverAgent is ready to accept commands", "state": "success", "os": { "name": "iOS", "version": "16.5" }, "ios": { "ip": "192.168.1.100" }, "ready": true } }

2.2 核心操作API详解

WDA的核心功能可以归纳为几类基础操作，下面是用facebook-wda实现的示例：

应用生命周期控制：

# 启动应用（以Safari为例） c.session().app_activate('com.apple.mobilesafari') # 终止应用 c.session().app_terminate('com.apple.mobilesafari') # 返回主屏幕 c.home()

界面元素交互：

# 点击操作（通过元素定位） c(name='搜索栏').click() # 输入文本 c(name='搜索栏').set_text('自动化测试') # 滑动屏幕 c.swipe_left() # 向左滑动 c.swipe_up() # 向上滑动

设备控制：

# 锁屏/解锁 c.lock() # 锁屏 c.unlock() # 解锁 # 旋转设备方向 c.orientation = 'LANDSCAPE' # 横屏

3. 元素定位策略进阶

3.1 多种定位方式对比

WDA支持多种元素定位策略，每种都有其适用场景：

Accessibility ID（推荐首选）：
```
c(accessibilityId='设置').click()
```
元素类型+属性组合：
```
c(type='Button', name='确定').click()
```

XPath定位（复杂结构时使用）：

c(xpath='//Button[@name="确定"]').click()

类名定位：

c(className='XCUIElementTypeButton').click()

注意：在iOS自动化中，Accessibility ID通常对应开发设置的accessibilityIdentifier属性，是最稳定可靠的定位方式。

3.2 等待策略优化

自动化脚本的稳定性很大程度上取决于等待策略。facebook-wda提供了灵活的等待机制：

# 显式等待元素出现（最多等待10秒） element = c(accessibilityId='登录按钮').wait(timeout=10.0) # 自定义等待条件 def button_enabled(): btn = c(accessibilityId='提交') return btn.exists and btn.enabled c.wait_for(button_enabled, timeout=15)

4. 实战案例：短视频自动浏览机器人

让我们把这些知识整合到一个实际案例中——创建一个自动浏览短视频的脚本。以某主流短视频平台为例：

import time import wda c = wda.Client('http://localhost:8100') c.session().app_activate('com.zhiliaoapp.musically') # 启动短视频APP def watch_short_videos(count=10): for i in range(count): print(f'正在观看第{i+1}个视频...') # 上滑切换到下一个视频 c.swipe_up() # 随机观看时长（3-8秒） watch_time = 3 + random.random() * 5 time.sleep(watch_time) # 随机点赞（30%概率） if random.random() < 0.3: c.tap(x=300, y=500) # 点赞按钮位置 # 每5个视频随机评论一次 if i % 5 == 0 and random.random() < 0.5: c.tap(x=200, y=600) # 评论按钮 time.sleep(1) c(type='TextView').set_text('自动评论测试') c(name='发送').click() watch_short_videos(20)

这个脚本展示了几个关键技巧：

基于坐标的点击（当元素难以定位时）
随机行为模拟（使自动化更接近真人操作）
复合操作组合（观看+点赞+评论）

5. 性能优化与异常处理

5.1 提升执行效率的技巧

批量操作优化：

# 不推荐：多次单独操作 for element in elements: element.click() # 推荐：使用链式调用 c.batch().click(elements[0]).click(elements[1]).perform()

截图优化：

# 常规截图（全屏） c.screenshot('screen.png') # 只截取特定区域 element = c(accessibilityId='登录框') element.screenshot('login_box.png')

5.2 常见异常及处理方案

在长期运行中，你可能会遇到这些典型问题：

元素定位失败：

try: c(accessibilityId='不存在的元素').click() except wda.exceptions.WDAElementNotFoundError: print("元素未找到，执行备用方案") c.swipe_up() # 例如尝试滑动刷新

会话超时：

try: c.status() except requests.exceptions.ConnectionError: print("WDA连接丢失，尝试重新连接") c = wda.Client('http://localhost:8100')

应用卡死处理：

if c(accessibilityId='加载中').exists(timeout=10): print("检测到长时间加载，尝试恢复") c.app_terminate('com.example.app') c.app_launch('com.example.app')

6. 扩展应用场景

WDA+Python的组合不仅适用于自动化测试，还能实现许多有趣的自动化场景：

UI自动化巡检：

def ui_inspection(): elements_to_check = [ ('首页按钮', 'XCUIElementTypeButton'), ('搜索框', 'XCUIElementTypeTextField'), ('个人中心', 'XCUIElementTypeStaticText') ] for name, type in elements_to_check: if not c(type=type, name=name).exists: print(f'UI异常：{name}缺失') send_alert_notification(f'UI异常：{name}缺失')

数据采集工具：

def collect_news_titles(): titles = [] c.swipe_down() # 下拉刷新 while len(titles) < 50: current_titles = [e.text for e in c.find_elements(type='XCUIElementTypeStaticText') if e.text and len(e.text) > 10] titles.extend(current_titles) c.swipe_up() # 加载更多 return list(set(titles)) # 去重

自动化压力测试：

def stress_test_app(): for i in range(100): try: c.session().app_launch('com.example.app') time.sleep(random.uniform(0.5, 2)) c.session().app_terminate('com.example.app') except Exception as e: log_error(f'第{i}次循环失败: {str(e)}')

7. 与Appium方案的对比决策

最后，让我们系统性地比较WDA直接调用与Appium方案的优劣，帮助你在实际项目中做出技术选型：

考量维度	WDA+Python直接调用	Appium方案
执行速度	⭐⭐⭐⭐⭐（直接通信无中间层）	⭐⭐⭐（需经过Appium Server）
功能完整性	⭐⭐⭐（基础功能完善）	⭐⭐⭐⭐⭐（支持所有平台功能）
调试便捷性	⭐⭐⭐⭐（直接看到原始协议）	⭐⭐（多层抽象增加调试难度）
跨平台支持	⭐（仅iOS）	⭐⭐⭐⭐⭐（全平台支持）
社区支持	⭐⭐（相对小众）	⭐⭐⭐⭐⭐（庞大社区）
适合场景	iOS专属、高性能要求的自动化	跨平台、需要快速上手的项目