Android Uiautomator2 Python Wrapper元素属性获取：文本、坐标与尺寸全解析
项目地址: https://gitcode.com/gh_mirrors/ui/uiautomator2 引言：UI自动化测试中的元素属性痛点
在Android UI自动化测试（Android UI Automation Testing）中，准确获取元素属性是构建稳定测试脚本的核心基础。开发者常面临三大痛点：文本信息获取不稳定、坐标计算偏差导致点击失效、尺寸参数错误引发区域判定失败。Android Uiautomator2 Python Wrapper通过封装原生Uiautomator2框架，提供了一套完整的元素属性解决方案。本文将从实用角度出发，系统解析文本内容、坐标位置与尺寸参数的获取方法，帮助测试工程师构建更健壮的自动化脚本。
读完本文你将掌握：
- 3种文本属性（text/content-desc/resource-id）的精准提取技巧
- 绝对坐标与相对坐标的转换计算
- 元素尺寸与屏幕比例的换算方法
- 复杂场景下的属性获取异常处理策略
核心概念与技术架构
Uiautomator2元素属性体系
Uiautomator2框架将Android界面元素抽象为包含丰富属性的对象，核心属性可分为三类：
| 属性类型 | 关键参数 | 应用场景 |
|---|---|---|
| 文本信息 | text、content-desc、resource-id | 元素识别、文本验证 |
| 空间位置 | bounds、center | 点击操作、区域判定 |
| 尺寸信息 | width、height、percent | 适配多分辨率设备 |
技术架构流程图
文本属性获取：从基础到进阶
1. 基础文本获取（text属性）
文本是UI元素最直观的标识，Uiautomator2提供了两种主要选择器实现文本定位与提取：
1.1 UiSelector方式
import uiautomator2 as u2
d = u2.connect() # 连接设备
element = d(text="设置") # 通过文本定位元素
print(element.get_text()) # 获取文本内容
# 输出: "设置"
1.2 XPath选择器方式
# 使用XPath语法定位并获取文本
text = d.xpath('//*[@text="设置"]').get_text()
print(text) # 输出: "设置"
2. 扩展文本属性（content-desc与resource-id）
除了可见文本，元素还包含描述性文本（content-desc）和资源ID（resource-id）：
# 获取contentDescription属性
desc = d(resourceId="com.android.settings:id/title").info.get("contentDescription")
# 获取resourceId属性
resource_id = d(text="设置").info.get("resourceName")
print(f"资源ID: {resource_id}") # 输出: "com.android.settings:id/title"
3. 高级文本匹配技巧
针对动态文本或部分匹配场景，可使用特殊语法：
# 模糊匹配（包含"设置"的文本）
elements = d.xpath('//*[contains(@text, "设置")]').all()
for elem in elements:
print(elem.text) # 输出所有包含"设置"的文本
# 正则匹配（以"设置"开头的文本）
element = d.xpath('//*[re:match(@text, "^设置.*")]').get()
坐标属性获取：精确控制元素交互
1. 元素边界坐标（bounds）
每个元素都有一个边界矩形，通过bounds属性可获取其在屏幕上的绝对坐标：
# 获取元素边界
bounds = d(text="设置").bounds()
print(bounds) # 输出: (100, 200, 300, 280)
# 解析为左上角和右下角坐标
left, top, right, bottom = bounds
2. 中心点坐标计算
大多数交互操作需要元素中心点坐标，Uiautomator2提供了便捷方法：
# 方法1: 通过center()直接获取
x, y = d(text="设置").center()
print(f"中心点坐标: ({x}, {y})")
# 方法2: 手动计算中心点
bounds = d(text="设置").bounds()
center_x = (bounds[0] + bounds[2]) // 2
center_y = (bounds[1] + bounds[3]) // 2
3. 相对坐标与绝对坐标转换
在不同分辨率设备间迁移时，相对坐标更具适应性：
# 获取元素相对坐标（占屏幕比例）
x_percent, y_percent = d(text="设置").percent_bounds()[:2]
# 转换为绝对坐标（基于当前屏幕尺寸）
width, height = d.window_size()
abs_x = int(width * x_percent)
abs_y = int(height * y_percent)
尺寸属性获取：适配多分辨率设备
1. 基础尺寸计算
元素尺寸可通过边界坐标差值计算得出：
# 获取元素边界
left, top, right, bottom = d(text="设置").bounds()
width = right - left # 宽度计算
height = bottom - top # 高度计算
print(f"元素尺寸: {width}x{height}") # 输出: "元素尺寸: 200x80"
2. 屏幕比例计算
在多设备适配场景中，元素占屏幕比例比绝对尺寸更有价值：
# 获取元素占屏幕的比例
w_percent, h_percent = d(text="设置").percent_size()
print(f"宽度比例: {w_percent:.2f}, 高度比例: {h_percent:.2f}")
# 输出: "宽度比例: 0.25, 高度比例: 0.10"
3. 尺寸相关的实用方法
# 获取元素截图（基于尺寸信息）
element = d(text="设置")
screenshot = element.screenshot()
screenshot.save("element_screenshot.png")
# 判断元素是否在屏幕可见区域内
def is_visible(element):
l, t, r, b = element.bounds()
w, h = d.window_size()
return 0 <= l < w and 0 <= t < h
实战案例：综合属性应用
案例1：动态元素定位与验证
def verify_element_properties():
# 1. 定位目标元素
element = d.xpath('//*[@resource-id="com.android.systemui:id/clock"]').get()
# 2. 验证文本属性
assert "09:30" in element.text, "时间显示不正确"
# 3. 验证位置属性
l, t, r, b = element.bounds()
assert l > 0 and t > 0, "元素位置异常"
# 4. 输出综合信息
print(f"元素文本: {element.text}")
print(f"元素位置: ({l}, {t}, {r}, {b})")
print(f"元素中心点: {element.center()}")
verify_element_properties()
案例2：多分辨率设备适配
def adapt_multi_resolution():
# 获取元素相对坐标
x_percent, y_percent = d(text="确定").percent_bounds()[:2]
# 在不同分辨率设备上计算绝对坐标
devices = [
(1080, 2340), # 设备1分辨率
(720, 1560), # 设备2分辨率
(1440, 3200) # 设备3分辨率
]
for w, h in devices:
abs_x = int(w * x_percent)
abs_y = int(h * y_percent)
print(f"在{w}x{h}分辨率下的坐标: ({abs_x}, {abs_y})")
adapt_multi_resolution()
常见问题与解决方案
问题1：元素存在但获取属性返回None
解决方案：使用显式等待确保元素加载完成
# 等待元素出现并获取属性
element = d(text="设置").wait(timeout=10) # 最多等待10秒
if element:
print(element.get_text())
else:
print("元素未找到")
问题2：坐标点击偏差
解决方案：结合元素可见区域与屏幕尺寸计算
def safe_click(element):
# 获取可见区域坐标
info = element.info
visible_bounds = info.get('visibleBounds', info.get('bounds'))
lx, ly, rx, ry = visible_bounds['left'], visible_bounds['top'], visible_bounds['right'], visible_bounds['bottom']
# 计算可见区域中心点
x = (lx + rx) // 2
y = (ly + ry) // 2
# 执行点击
d.click(x, y)
问题3：不同设备上尺寸适配问题
解决方案：使用百分比坐标系统
# 基于百分比的点击
def percent_click(x_percent, y_percent):
w, h = d.window_size()
x = int(w * x_percent)
y = int(h * y_percent)
d.click(x, y)
# 点击屏幕中心
percent_click(0.5, 0.5)
总结与展望
元素属性获取是Android自动化测试的基础，本文详细介绍了Uiautomator2 Python Wrapper中文本、坐标和尺寸属性的获取方法。通过掌握这些技术，测试工程师可以构建更稳定、更具适应性的自动化脚本。
未来发展方向：
- 结合AI技术实现更智能的元素识别
- 三维空间坐标支持（针对折叠屏设备）
- 属性变化实时监控与预警
掌握元素属性获取技巧，将为你的自动化测试工作打下坚实基础。建议结合实际项目需求，灵活运用本文介绍的方法，不断优化测试脚本的稳定性和效率。
收藏本文，下次遇到UI自动化元素属性问题时即可快速查阅解决方案！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
