4. 元素定位策略（二）：利用 UIAutomatorViewer / WDA Inspector 获取权限弹窗属性与动态内容处理

权限弹窗通常由操作系统（Android/iOS）原生控件生成，具有瞬时性、动态性和平台差异性。直接使用常规 find_element_by_* 方法往往失败，因为弹窗的 resource-id、content-desc 或 accessibility-id 可能随版本、语言、屏幕密度变化。本章深入讲解如何使用 UIAutomatorViewer（Android）和 WDA Inspector（iOS）获取真实的运行时属性，并针对动态内容（如倒计时文本、可变按钮文案）设计稳定的定位策略。

4.1 原理：原生控件树的瞬时探测

权限弹窗是操作系统级对话框，不隶属于目标 App 的 Activity/ViewController。UIAutomatorViewer 和 WDA Inspector 均通过解析当前窗口的控件树（View Hierarchy / Accessibility Tree）来获取属性。关键区别：

4.2 实现流程：从探测到定位

1. 环境准备：确保 ADB 连接正常（Android）或 WDA 服务已启动（iOS）。
2. 触发权限弹窗：在测试脚本中执行触发操作（如点击“获取位置”按钮），保持弹窗可见。
3. 运行探测器：
   • Android：uiautomatorviewer 或 ADB dump 命令。
   • iOS：使用 iproxy 转发端口后，通过浏览器访问 WDA Inspector。
4. 手工点击/选取权限弹窗：在探测器界面中选中弹窗容器，记录属性。
5. 分类属性：将属性分为“静态稳定属性”和“动态变化属性”。
6. 编写定位表达式：优先使用稳定属性；对动态内容使用部分匹配策略。
7. 验证定位稳定性：在不同设备/语言/分辨率下重复步骤 1-6。

4.3 探测命令与属性获取

4.3.1 Android – UIAutomatorViewer 手动操作

启动 UIAutomatorViewer（位于 SDK tools/ 目录），点击 Device Screenshot 按钮。在左侧层级树中展开到 com.android.packageinstaller 或 system 容器，右键弹窗节点即可查看属性。

# 命令行快捷 dump（配合脚本）
adb shell uiautomator dump /sdcard/tmp.xml
adb pull /sdcard/tmp.xml
# 然后使用 Python 解析 XML，提取节点属性

4.3.2 iOS – WDA Inspector 配置与使用

首先启动 WebDriverAgent：

xcodebuild -project WebDriverAgent.xcodeproj -scheme WebDriverAgentRunner -destination 'id=YOUR_DEVICE_UDID' test
iproxy 8100 8100  # 转发本地 8100 到设备

在浏览器访问 http://localhost:8100/inspector，点击“获取权限弹窗”对应的按钮后，在右侧 Inspector 面板中查看元素的 label、name（accessibilityIdentifier）、value、type 等属性。

4.3.3 典型属性输出对比

4.4 动态内容处理策略

权限弹窗常包含倒计时按钮（如“确认 (5s)”）、滚动状态提示（“正在请求权限…”）、以及根据权限等级变化的按钮文案（“仅在使用中”→“始终”→“拒绝”）。处理原则：

• 避免全文本匹配：使用部分匹配函数 contains() 或 startswith()。
• 优先使用 resource-id / accessibility-id：这两个属性在内容变化时通常不变。
• 等待状态稳定：动态内容（如倒计时）到达目标值前不可点击，需设置显式等待。
• 正则提取条件：对于“确认 (N秒)”中的数字，可写正则 确认\s*\(\d+秒\) 来定位。

4.5 代码示例：Appium 中动态定位权限弹窗

# Android 示例：等待并点击“允许”按钮（含倒计时）
from appium.webdriver.common.appiumby import AppiumBy
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
import re

def click_permission_allow(driver, timeout=15):
    # 先定位弹窗容器（稳定 resource-id）
    try:
        # 等待弹窗出现，container 属性不变
        WebDriverWait(driver, timeout).until(
            EC.presence_of_element_located((AppiumBy.ID, "com.android.permissioncontroller:id/grant_dialog"))
        )
        # 查找按钮：使用 uiautomator 的 textContains
        btn = driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR,
                                  'new UiSelector().textContains("允许")')
        # 检查是否可点击（倒计时结束）
        WebDriverWait(driver, 5).until(
            lambda d: btn.get_attribute("enabled") == "true"
        )
        btn.click()
    except Exception:
        # 兜底：使用 resource-id
        driver.find_element(AppiumBy.ID, "com.android.permissioncontroller:id/permission_allow_button").click()

# iOS 示例：使用 predicate 匹配
def click_allow_ios(driver, timeout=15):
    # 等待弹窗出现（accessibility container）
    WebDriverWait(driver, timeout).until(
        EC.presence_of_element_located((AppiumBy.ACCESSIBILITY_ID, "Location Permission"))
    )
    # 使用 predicate 匹配 label 以 "Allow" 开头
    btn = driver.find_element(AppiumBy.IOS_PREDICATE, "label BEGINSWITH 'Allow'")
    btn.click()

4.6 常见错误与调试

4.7 性能与稳定性优化建议

• 缓存控件树：避免每次交互都 dump XML，可在第一次定位后缓存稳定的 resource-id/name。
• 减少探测器调用：只在测试初始化或弹窗类型判断时使用探测器，运行时使用稳定属性。
• 使用显式等待替代 sleep：动态内容变化时，优先使用 WebDriverWait 轮询属性，而非固定等待。
• 平台抽象层：封装 PermissionManager 类，针对 Android/iOS 不同属性特征提供统一 API。
• 版本回归矩阵：建立测试设备 + OS 版本组合的 dump 属性库，每次发布前对比属性漂移。

4.8 部署与持续集成集成

在 CI 流水线（如 Jenkins/GitLab CI）中，将探测器结果作为测试前置条件：

# GitLab CI 片段：Android 弹窗属性采集
before_script:
  - adb shell uiautomator dump /sdcard/ui.xml
  - adb pull /sdcard/ui.xml artifacts/ui_${CI_JOB_ID}.xml
  - python tools/parse_ui.py artifacts/ui_${CI_JOB_ID}.xml --output properties.json

生成的 properties.json 可被后续测试脚本动态加载，若发现预期属性缺失则主动告警，避免因系统更新导致全部定位失效。