移动端自动化测试中,Appium + iOS 测试算是门槛稍高但超级关键的一环。许多测试同学面对 XCUITest + 真机操作时,总觉得“设备连不上”、“控件找不到”、“滑动失败”。

先看效果⬇️

自动化测试
今天我用一段可直接运行的完整代码,手把手教你如何:
• 正确配置 iOS 真机参数
• 启动并操作目标 App
• 实现输入、点击、滑动等常用操作
• 最后优雅退出
适用场景:自动化测试工程师 / Python 测试开发 / Appium 学习者
所需工具:Python、Appium、Xcode、iOS 真机(或模拟器)
实战目标
我们将使用 Appium 脚本,实现以下完整流程:
- 启动 iOS 真机上的目标 App
- 连续点击控件
- 向选择器中输入指定内容
- 向左滑动页面 4 次
- 程序暂停 5 秒后退出
完整可运行代码
#!/usr/bin/env python
# -*- coding: UTF-8 -*-
"""
@Project :BangcleAutoTest
@File :test.py
@Date :2025/4/16
@Author : malijie
"""
import time
from appium import webdriver
from appium.options.common import AppiumOptions
from appium.webdriver.common.appiumby import AppiumBy
# 1️、设置启动参数(根据你自己的设备调整)
desired_caps = {
"platformName": "iOS",
"platformVersion": "18.0", # iOS 系统版本
"deviceName": "iPhone 15 Pro", # 模拟器名或真机名
"automationName": "XCUITest", # iOS 必须用 XCUITest
"udid": "16B21950-EF61-4465-9566-CD02D7D13069", # 用 idevice_id -l 获取
"bundleId": "com.example.demo", # 要测试的 App 标识符
"noReset": False, # 是否重置 App 状态
"showXcodeLog": True # 是否显示 Xcode 日志
}
# 2️、加载能力并连接 Appium Server
options = AppiumOptions().load_capabilities(desired_caps)
driver = webdriver.Remote("http://localhost:4723", options=options)
# 3️、连续点击控件(根据实际控件 ID 调整)
for i in range(5):
driver.find_element(AppiumBy.ACCESSIBILITY_ID, ".").click()
# 4️、 输入内容到选择器控件(PickerWheel)
element = driver.find_element(AppiumBy.CLASS_NAME, "XCUIElementTypePickerWheel")
element.send_keys("ctp_auto_001_001-2-2")
# 5、向左滑动 4 次
for i in range(4):
driver.execute_script("mobile: swipe", {
"direction": "left",
"element": None # 整个页面滑动
})
time.sleep(0.5)
# 6、停留 5 秒后退出
time.sleep(5)
driver.quit()

重点解析
|
参数/方法 |
说明 |
|
platformVersion |
iOS 系统版本,需和设备实际一致 |
|
udid |
真机唯一 ID,macOS 上使用 idevice_id -l 获取 |
|
bundleId |
可通过打包日志或 Xcode 查看 |
|
AppiumBy.ACCESSIBILITY_ID |
是 iOS 控件最稳定的定位方式 |
|
XCUIElementTypePickerWheel |
代表 iOS 的滚轮控件 |
|
driver.execute_script(“mobile: swipe”) |
iOS 滑动的推荐方法 |
设备连接小贴士
• 使用 USB 连接 iPhone 到 mac,确保信任设备
• 安装 libimobiledevice 工具,运行 idevice_id -l 确认设备连接
• 确保 Appium Server 监听在 http://localhost:4723
运行前准备
• 安装 Appium:npm install -g appium
• 启动 Appium:命令行运行 appium 或用 Appium Desktop 启动
• 使用 PyCharm 或 VSCode 运行上述 Python 脚本
• 若设备未签名,请在 Xcode 中为项目绑定开发者账号
✅运行效果展示
程序将自动完成以下动作:
• 启动你指定的 App
• 自动点击指定控件多次
• 在滚轮中输入选项值
• 点击按钮完成确认
• 向左滑动页面查看不同内容

总结一下
这段代码帮你实现了:
• Appium 真机连接全流程
• iOS 控件操作的关键方法
• 多场景测试的能力组合(点击、输入、滑动)
你在使用 Appium 测试 iOS 时遇到过哪些问题?
关注不迷路!后续更新更多 Appium + 自动化测试实战经验!
点击头像查看更多 Python / 测试开发干货文章!




运行效果看起来很炫,希望能深入学习。