Appium 3.x实战:批量定位元素新写法详解
Appium 3.x 实战笔记定位一组元素find_elements新版写法与示例适配Python Client 5.x前言本文为Appium移动端自动化学习笔记针对Appium 3.x Appium-Python-Client 5.x版本梳理如何一次性定位多个元素的标准写法。在自动化测试中经常需要获取某一类元素如列表项、同一ID的控件集合并批量操作。老版本客户端中driver.find_elements_by_id()等写法已被彻底移除新版统一使用driver.find_elements(By.XXX, 定位值)。本文以系统设置APP为例演示三种常用定位方式ID、CLASS、XPATH获取一组元素并打印其文字所有代码均基于雷电9安卓9环境实操验证适合新手快速掌握。本文为个人原创学习笔记发布于CSDN仅作技术交流Appium遵循Apache 2.0开源协议。一、定位一组元素的核心语法功能说明find_elements返回所有符合条件的元素列表类型为list。与find_element不同的是find_element找不到元素会直接抛出NoSuchElementException异常。find_elements找不到匹配元素时返回空列表不会报错程序可安全继续执行。新版正确写法fromappium.webdriver.common.appiumbyimportBy# 统一格式注意是 find_elements多了个 s元素列表driver.find_elements(By.XXX,定位值)常用定位方式速查定位方式By 常量示例通过ID批量定位By.IDdriver.find_elements(By.ID, com.android.settings:id/title)通过CLASS批量定位By.CLASS_NAMEdriver.find_elements(By.CLASS_NAME, android.widget.TextView)通过XPATH批量定位By.XPATHdriver.find_elements(By.XPATH, //*[contains(text,设)])二、完整示例代码批量获取文字以下代码打开系统设置分别使用ID、CLASS、XPATH三种方式定位一组元素并将每个元素的文字内容打印出来最后关闭APP。importtimefromappiumimportwebdriverfromappium.options.commonimportAppiumOptionsfromappium.webdriver.common.appiumbyimportBy# 配置参数caps{platformName:Android,appium:platformVersion:9,appium:deviceName:25102RKBEC,appium:automationName:UiAutomator2,appium:appPackage:com.android.settings,appium:appActivity:com.android.settings.Settings,appium:noReset:True,}# 创建驱动连接AppiumoptionsAppiumOptions()options.load_capabilities(caps)driverwebdriver.Remote(http://127.0.0.1:4723,optionsoptions)# ① 使用ID定位获取所有 resource-id 为 android:id/title 的元素并打印其文字forelemindriver.find_elements(By.ID,android:id/title):print(elem.text)print(_______*_______)# ② 使用CLASS定位获取所有 class 为 android.widget.TextView 的元素并打印其文字forelemindriver.find_elements(By.CLASS_NAME,android.widget.TextView):print(elem.text)print(_______*_______)# ③ 使用XPATH定位获取所有 text 包含 设 的元素并打印其文字forelemindriver.find_elements(By.XPATH,//*[contains(text,设)]):print(elem.text)print(_______*_______)# ④ 等待3秒关闭APPtime.sleep(3)driver.execute_script(mobile: terminateApp,{appId:com.android.settings})driver.quit()输出结果示例雷电9系统设置首页网络和互联网 已连接的设备 应用和通知 电池 显示 声音 存储 ... _______*_______ 设置 在设置中搜索 网络和互联网 WLAN、移动网络、流量使用 已连接的设备 蓝牙 应用和通知 权限、默认应用 电池 100% 显示 壁纸、休眠、字体大小 声音 音量、振动、勿扰 存储 已使用 27% - 还剩 23.32 GB _______*_______ 设置 在设置中搜索观察输出可知ID定位到的通常是主要菜单项标题CLASS定位出的范围更广包含所有TextViewXPATH定位出所有包含“设”字的元素如“设置”“在设置中搜索”。三、新旧API对照表复习速查老版本直接写法已失效新版标准写法备注driver.find_elements_by_id(xxx)driver.find_elements(By.ID, xxx)批量ID定位driver.find_elements_by_accessibility_id(xxx)driver.find_elements(By.ACCESSIBILITY_ID, xxx)批量无障碍描述定位driver.find_elements_by_class_name(xxx)driver.find_elements(By.CLASS_NAME, xxx)批量类名定位driver.find_elements_by_xpath(xxx)driver.find_elements(By.XPATH, xxx)批量XPath定位核心变化所有find_elements_by_前缀的方法已被移除必须改为find_elements(By.XXX, 值)注意find_elements后面的s不可省略。四、新手避坑总结区分 find_element 与 find_elements找单个元素用find_element返回单个元素对象找不到则直接报错。找一组元素用find_elements返回列表找不到返回空列表不会报错。千万不要把find_element当成返回多个元素用否则只会返回第一个。列表为空时的处理遍历前最好判断长度避免对空列表做无用操作elemsdriver.find_elements(By.ID,某个ID)ifelems:foreinelems:print(e.text)else:print(未找到任何元素)text属性可能为空某些元素虽然定位到了但若没有显示文字例如图片、容器text属性会返回空字符串。打印时不会报错但结果可能不是你想要的需在逻辑中加以区分。ID定位注意资源前缀安卓系统元素的ID通常以android:id/开头应用自身元素则带包名如com.android.settings:id/。使用find_elements(By.ID, android:id/title)可以跨应用抓取系统标题但要注意作用域。建议优先使用完整的resource-id以提升精确度。XPath contains 是批量匹配的利器当元素 text 并不完全固定时可以用contains(text, 关键字)模糊匹配这在多语言或动态文本场景中非常实用。五、练习与扩展掌握了单个元素与一组元素的定位后可以尝试以下练习获取当前页面所有可点击元素的 text并存到列表。批量点击某一类按钮如所有开关控件实现批量设置。结合WebDriverWait等待一组元素出现后再进行操作。版权与参考说明本文为个人原创学习笔记所有代码与案例均为实操整理发布于CSDN仅作技术交流Appium 为开源自动化测试框架遵循 Apache 2.0 开源协议引用其官方规范仅作学习说明参考资料Appium 官方文档。

相关新闻

latex行间距+列宽

latex行间距+列宽

2026/11/22 10:09:38 阅读更多 →
2026大庆GEO优化服务商盘点:10家优质机构优势与适配解析

2026大庆GEO优化服务商盘点:10家优质机构优势与适配解析

随着AI技术全面普及,生成式搜索彻底颠覆了传统网络营销逻辑。GEO(生成式引擎优化)凭借权威信源搭建、语义结构化优化、多AI模型适配等核心能力,成为企业解决品牌AI隐身、信息失真、曝光不足等痛点,提升品牌知名度、获取…

2026/11/22 10:09:37 阅读更多 →
Perforce IPLM 对比 Cliosoft:IP 生命周期管理工具选型指南与核心差异解析

Perforce IPLM 对比 Cliosoft:IP 生命周期管理工具选型指南与核心差异解析

随着半导体与 SoC 设计复杂度的指数级增长,传统的单服务器数据管理(DM)与 IP 生命周期工具在应对跨地域的大规模协同以及千万级文件的工作区构建时,逐渐暴露出性能瓶颈与 IP 资产合规盲区。 本文由龙智(Dragonsoft&…

2026/11/19 8:23:08 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/21 23:27:35 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/21 23:27:35 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/21 23:27:35 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/21 23:27:35 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/21 23:27:36 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/21 23:27:37 阅读更多 →

日新闻

周新闻

月新闻