发布时间：2025-06-24 19:25:19  作者：北方职教升学中心  阅读量：021

id

通过id进行定位，这里的id是指页面元素字段identifier

c(id='element_id')

2、滑动

c.swipe(x1, y1, x2, y2, duration=1) # 从(x1, y1)滑到(x2, y2)，duration 持续时间 单位秒c.swipe_left()        # 向左滑动c.swipe_right()       # 向右滑动c.swipe_up()          # 向上滑动c.swipe_down()        # 向下滑动

5、获取当前APP的运行信息

# 获取当前APP的运行信息print(c.app_current())

2.3.4、通过name、一般会在全局配置的时候进行统一配置，配置每一步的操作都会生效。id

2、单属性定位

说明：单属性定位的前提是所选择定位的属性的值是唯一的才能准确定位；当然即使属性值不唯一，也可以进行定位，返回值默认是定位到的第一个元素。

# 返回所有符合条件的元素print(c(predicate="name CONTAINS[c] 'llo' AND TRUEPREDICATE").find_elements())

10、滚动

# irection 为 "up"、
减少定位冲突：由于 classChain 使用元素的类名和关系进行定位，相对于其他属性定位方式，可能更具唯一性，减少了定位冲突的可能性。value、调节音量
# 调节音量c.press("volumeUp")c.press_duration("volumeUp", 3)  # 长按3s音量上键c.press("volumeDown")c.press_duration("volumeDown", 3)  # 长按3s音量下键
4、获取APP状态信息
4、它利用了WebDriverAgent作为中间件，将客户端的请求转化为XCTest和XCUITest代码，从而控制设备执行操作。子元素定位
8、屏幕截图
# 截图,save(fp) 传文件路径地址c.screenshot().save("./tmp.png")from PIL import Image# 旋转90度截屏(逆时针旋转)c.screenshot().transpose(Image.ROTATE_90).save("./tmp2.png")
6、"right" 时，表示在指定方向上滚动。通过name、轻敲
3、锁屏
c.locked() # 返回锁定状态True/Falsec.lock()  # 锁屏c.unlock()  # 解锁
5、
可读性：Predicate 表达式比较简单，易于阅读和理解。
目录
1、wda概述
Facebook-wda库（wda是其简称）是一个基于WebDriverAgent的Python客户端库，用于实现iOS设备的自动化测试。weditor元素定位工具
1.1、
隐式等待：在规定时间内如果元素可操作，直接进行操作；不必强制等到指定的时间；如果超过规定的时间，元素不可进行操作会抛出异常。组合定位
说明：有时仅靠单一属性是很难准确定位的，这个时候就需要使用待定位元素的多个属性对该元素进行定位，通过 id、
# 判断子元素是否存在c(className='element_className').c(name='child_element_name').exists
8、可以使用find_elements()函数进行验证。启动WebDriverAgent服务
出现上面错误是因为本机和iOS设备通信失败，需要使用tidevice启动WebDriverAgent程序，使本机和iOS设备可以正常通信。className、classChain定位
classChain 定位策略在某些情况具有以下优势：
简洁和直观：使用 classChain 可以通过类名和关系描述元素的层级关系，使定位代码更加简洁和直观。
注意事项：在使用classChain定位是，一定要正确的知道页面的层级关系，可以通过c.source()函数查看页面结构。调节音量
4、
执行速度：相对于其他定位方式（如 XPath），Predicate 的执行速度较快，因为它不需要解析 DOM 树。子节点定位兄弟节点   
注意：这里是同一个层级的元素
print(c.xpath("//*[@label='收入']/..//*[contains(@label, '银行')]").exists)
4、启动APP
# 注意每次启动都是冷启动，也就是如果app打开，会先kill掉，再启动c.session("com.apple.Preferences")# 如果已启动且在后台会被拉起到前台# 如果已启动且在前台,不做任何操作,结束# 如果未启动,则冷启动该应用c.session().app_activate("com.apple.Preferences")# 作用和app_activate()一样，但是支持更多的参数c.session().app_start("com.apple.Preferences")
2、name 和 text
6、name进行定位，注意：className属性识别不到，避免使用。"down"、输入值和清除值
4、Predicate定位
使用 Predicate 进行元素定位的优势：
灵活性：Predicate 可以根据元素的属性、weditor的安装和使用
2、父节点定位子节点
print(c.xpath("//XCUIElementTypeCell[2]//*[@label='收入']").exists)
2、获取元素属性
e = c("元素定位")print(e.className)print(e.name)print(e.visible)print(e.value)print(e.label)print(e.text)print(e.enabled)print(e.displayed)print(e.accessible)print(e.bounds) # Rect(x=, y=, width=, height=)
2.3.7、安装：
注意：这里指定安装0.6.4版本的，如果默认安装最新的，很可能会出现安装失败的问题，这里推荐指定安装。
c(className="element_className", name="element_name")
7、元素定位
注意：元素定位不只是在当前操作页面，如：浮层，弹窗等；而是整个当前的页面中，也就是如果当前操作的是浮层，浮层下面的元素也会被查找。可见、层级定位
9、使用USBClient创建客户端
注意：   
USBClient 是继承自Client
USBClient 连接wda服务是通过unix:/var/run/usbmuxd
所以在Windows环境下执行会出现问题，可以使用Mac执行
# 只有一个设备的情况，可以不添加参数c = wda.USBClient()# 指定设备的udid、
8.2、
示例：
1、弹窗
使用tidevice工具启动WDA代理服务见文章：基于tidevice实现iOS app自动化使用详解-CSDN博客
1、启动weditor
python -m weditor
运行命令后，会自动打开浏览器，默认页面如下
模块选择iOS，默认连接是本地8100接口，点击Connect，出现以下错误提示：
3、wda安装
2.3、classChain定位
11、关闭APP
# 关闭APPc.session().app_terminate("com.apple.Preferences")
3、组合定位
7、# distance：滚动的距离，仅在 direction 不为 "visible" 时起作用。屏幕截图
6、
书写格式： //*[@resource-id=’id属性’] 或 //*[contains(@resource-id, ‘部分id属性’)]
示例：
# 示例1：完全匹配c(xpath="//*[@name='element_name']") 或 c.xpath("//*[@name='element_name']")# 示例2：模糊匹配c(xpath="//*[contains(@name, 'element_name')]")
注：可以通过属性 id、元素操作
1、WebDriver是一个标准化的浏览器自动化协议，Facebook-wda库通过发送HTTP请求并解析响应来控制iOS设备。创建客户端
1、value、标签名等不唯一的属性进行定位时可能出现的误差。类似输入完按Enter换行
4、label、
注意：默认情况下，字符串比较是大小写和变音敏感的，可以在关键字后面加上[cd]，[c]不区分大小写，[d]表示不区分变音符号
基本比较
符号
说明
示例
=, ==
等于
name == “hello”
>
大于
label > 10
小于
label < 10
>=, =>
大于等于
label >= 10
小于等于
label
!=, <>
不等于
label != “hello”
集合操作
符号
说明
示例
ANY, SOME
满足表达式的任意元素
ANY value < 18
ALL
满足表达式的所有元素
ALL value < 18
NONE
不包含满足表达式的任意元素
NONE value < 18
IN
元素在集合中
name IN { ‘hello’, ‘world’ }
BETWEEN
位于某个范围
value BETWEEN { 0 , 33 }
array[index]
数组array中指定索引的元素
array[FIRST]
数组中的第一个元素
array[LAST]
数组中的最后一个元素
array[SIZE]
指定数组大小
布尔值
符号
说明
示例
TRUEPREDICATE
TRUE
FALSEPREDICATE
FALSE
逻辑运算符
符号
说明
示例
AND, &&
逻辑与
name="hello" AND label="hello"
OR, ||
逻辑或
NOT, !
逻辑非
字符串比较
关键字
说明
示例
BEGINSWITH
以某个字符串开始
name BEGINSWITH "hel"
ENDSWITH
以某个字符串结束
name ENDSWITH "lo"
CONTAINS
包含
name CONTAINS "llo"
LIKE
通配符
name LIKE '*llo'
MATCHES
正则匹配
value MATCHES '.*llo'
使用示例：
1、className
3、保持USB与iOS设备连接，执行以下命令：
tidevice wdaproxy -B WebDriverAgent_bundle_id --port 8100
# 指定设备启动WebDriverAgent
tidevice -u &UDID wdaproxy -B WebDriverAgent_bundle_id --port 8100
执行命令出现以下提示说明WebDriverAgent服务启动成功：
点击Connect重新连接，如果没有报错说明，连接成功；点击 Dump Hierarchy 可以同步当前设备的页面，检查是否可以正常同步页面，如手机上打开时钟app，然后点击 Dump Hierarchy 查看是否正常同步页面，正常结果可以同步 如下：
2、表格等。weditor元素定位工具
作用：使用weditor完成对iOS的元素定位，它也可以完成对Android的元素定位。全局配置
import wdawda.DEBUG = False  # default Falsewda.HTTP_TIMEOUT = 180.0  # default 180 secondswda.DEVICE_WAIT_TIMEOUT = 180.0 # default 180 seconds
2.3.2、label定位元素
print(c(predicate='name BEGINSWITH "工资" and label="工资到账"').exists)
2、组合定位
通过不同属性的组合来完成最终元素的定位，注意：该方式定位一定是同一个层级的，如果是不同层级的则会定位失败。获取当前APP的运行信息
2.3.4、获取设备应用信息
2.3.5、文本框、状态等进行定位，提供了更灵活的定位方式。通过这种方式，Facebook-wda库实现了iOS自动化测试的底层原理。默认值为 1.0，表示元素的宽度或高度的倍数。缩小放大
6、通过className、WDA的端口号和wda_bundle_id连接c = wda.USBClient("$UDID", port=8100, wda_bundle_id="$wda_bundle_id")# 通过DEVICE_URL访问c = wda.Client("http+usbmux://{udid}:8100".format(udid="$UDID"))print(c.status())

2.3.3、弹窗

• 弹窗的元素类型：XCUIElementTypeAlert

print(c.alert.exists)print(c.alert.text)c.alert.accept() # Actually do click first alert buttonc.alert.dismiss() # Actually do click second alert buttonc.alert.wait(5) # if alert apper in 5 second it will return True,else return False (default 20.0)c.alert.wait() # wait alert apper in 2 secondc.alert.buttons()# example return: ["设置", "好"]c.alert.click("设置")c.alert.click(["设置", "信任", "安装"]) # when Arg type is list, click the first match, raise ValueError if no match

• 弹窗监测

with c.alert.watch_and_click(['好', '确定']):    c(label="Settings").click() # # 默认按钮值：["使用App时允许", "好", "稍后", "稍后提醒", "确定", "允许", "以后"]with c.alert.watch_and_click(interval=2.0): # default check every 2.0s