微信小程序中弹出框-原生元素定位问题

Question

微信小程序中的弹出框曲儿确定是原生的，但是在写定位脚本时，已经把上下文切换到‘NATIVE_APP’了，然后使用的定位方法有以下几种均无法定位：
1、driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR, 'new UiSelector().text("确定")')
2、confirm_btn = driver.find_element(AppiumBy.XPATH, '//*[@text="确定"]')
3、confirm_btn = driver.find_element(AppiumBy.ACCESSIBILITY_ID, '确定')
4、driver.save_screenshot('/tmp/screenshot_before_buttons.png')
目前问题有两个：
1、微信小程序中原生的弹出框在appium Inspector或chrome://inspect/#devices为什么均不显示
2、如果正确的定位到微信小程序中原生的弹出框

Answer 1

上午好☀️☀️☀️️
本答案参考通义千问

在使用 Appium 自动化测试微信小程序时，遇到原生弹出框无法定位的问题，这是一个常见的痛点。以下是详细分析和解决方案：

---

一、问题原因分析

1. 微信小程序的弹出框并非原生组件

• 微信小程序中的弹出框（如 wx.showModal）是通过 WebView 渲染的，而不是原生的 Android UI 组件。
• 因此，即使你切换到 NATIVE_APP 上下文，也无法通过原生元素定位器（如 UiSelector, XPath）找到这些元素。

2. Appium Inspector 和 chrome://inspect 不显示原生弹出框

• Appium Inspector 只能识别原生控件，而 WebView 中的元素不会被识别。
• chrome://inspect 仅适用于 Chrome 浏览器或 Webview 的调试，但微信小程序的 WebView 并不支持直接通过该方式访问。

---

二、解决方案

✅ 正确定位微信小程序中原生弹出框的方法

1. 切换上下文为 WEBVIEW

• 微信小程序的页面是运行在 WebView 中的，因此需要将 Appium 的上下文切换为 WEBVIEW 才能定位到其中的元素。

# 切换到 webview 上下文（具体名称可能因环境不同而变化）
driver.switch_to.context('WEBVIEW_com.tencent.mm')

⚠️ 注意：确保你的设备已经开启 USB 调试模式，并且在微信中启用了 开发者工具。

---

2. 使用 XPath 或 CSS 选择器定位元素

由于弹出框是通过 WebView 渲染的，你可以使用标准的 Web 定位方法来定位元素。

示例代码（Python + Appium）：

from appium import webdriver
from appium.webdriver.common.appiumby import AppiumBy

# 初始化 driver...
driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)

# 切换到 webview 上下文
webviews = driver.contexts
print(webviews)  # 查看可用的上下文
driver.switch_to.context('WEBVIEW_com.tencent.mm')  # 根据实际上下文名称修改

# 使用 XPath 定位确定按钮
confirm_btn = driver.find_element(AppiumBy.XPATH, '//android.widget.Button[@text="确定"]')

# 点击确认按钮
confirm_btn.click()

注意： 如果弹出框是通过 JS 动态生成的，可能需要等待一段时间后再进行定位。

---

3. 使用 JavaScript 注入定位

如果 XPath 定位失败，可以尝试通过 JavaScript 注入的方式来定位元素。

# 使用 JavaScript 获取元素
js_code = """
document.querySelector("button").click();
"""
driver.execute_script(js_code)

---

4. 使用 Appium 的 find_element_by_accessibility_id（需配合辅助功能）

如果弹出框有 accessibilityId 属性，也可以尝试使用以下方式：

confirm_btn = driver.find_element(AppiumBy.ACCESSIBILITY_ID, '确定')

⚠️ 需要确保微信小程序的 WebView 启用了辅助功能（Accessibility），这在某些系统上可能需要额外配置。

---

三、完整流程总结（推荐）

1. 启动 Appium 并连接设备
2. 进入微信小程序页面
3. 获取所有上下文（context）
4. 切换到 WEBVIEW_com.tencent.mm
5. 使用 XPath 或 CSS 定位弹出框元素
6. 执行点击或输入操作

---

四、常见错误排查

| 问题 | 原因 | 解决方案 | |------|------|----------| | 无法定位弹出框 | 未切换到 WEBVIEW 上下文 | 使用 driver.switch_to.context() 切换上下文 | | Appium Inspector 不显示元素 | 弹出框是 WebView 内容 | 使用 chrome://inspect 或 adb shell dumpsys window 检查 | | 元素找不到 | 页面加载未完成 | 添加显式/隐式等待 | | 权限不足 | 未启用 USB 调试 | 在设备设置中开启开发者选项和 USB 调试 |

---

五、附加建议

• 使用 adb shell dumpsys window 查看当前窗口信息：

  adb shell dumpsys window | grep -i "mCurrentFocus"
  

  这可以帮助你判断是否已正确切换到 WebView 环境。

• 使用 uiautomatorviewer 工具查看原生控件：

  • 用于检查非 WebView 的原生控件是否存在。

• 开启微信小程序的调试模式：

  • 在微信开发者工具中开启“调试”模式，便于调试 WebView 内部结构。

---

六、参考资源

• Appium 官方文档
• 微信小程序自动化测试指南
• ADB 命令大全

---

如果你提供具体的错误日志或代码片段，我可以进一步帮你定位问题。希望以上内容对你有所帮助！