如何使用Espresso/UI Automator测试谷歌地图标记信息窗口内容

核心失效原因 #

之前用Espresso、UI Automator校验失败的核心原因有三个：

• 谷歌地图的标记、信息窗口（InfoWindow）大部分是基于GL Surface自绘的，InfoWindow本质是提前把View转成位图贴在地图画布上，不存在于原生View层级树中，Espresso的普通onView()匹配逻辑根本无法识别到这个非真实存在的控件。
• 点击标记后信息窗口弹出有200-500ms的位移动画，原有代码点击标记后没有等待动画结束、窗口完全渲染就开始查找元素，很容易出现匹配超时。
• 信息窗口的可访问性节点属性不固定，部分版本的谷歌地图会把弹窗内容存在text字段而非contentDescription字段，原有代码用descriptionContains的匹配规则无法覆盖这种情况。

可行实现方案 #

方案1：自有App测试场景（最稳定，推荐） #

如果测试的是自己开发的App内集成的谷歌地图，完全不需要依赖UI层级匹配，直接通过地图实例做断言：

• 测试环境下通过ActivityScenario拿到页面内的GoogleMap实例，注册监听回调：

  // 测试代码中拿到GoogleMap实例后，直接监听信息窗口回调
  var currentShownMarker: Marker? = null
  googleMap.setOnInfoWindowClickListener { marker ->
      currentShownMarker = marker
  }
  

• 配套注册谷歌地图对应的IdlingResource，让Espresso等待地图渲染空闲，避免动画过程中断言失败：

  IdlingRegistry.getInstance().register(
      MapsIdlingResource(googleMap)
  )
  

• 执行点击标记操作后，直接断言当前弹出信息窗口绑定的标记数据即可：

  // 点击标记
  onView(withContentDescription(markerTitle)).perform(click())
  // 直接断言标记绑定的标题、摘要和预期一致，不需要找UI元素
  assertEquals(expectedTitle, currentShownMarker?.title)
  assertEquals(expectedSnippet, currentShownMarker?.snippet)
  

  这种方案完全绕开了地图自绘的UI识别问题，稳定性100%。

方案2：UI Automator优化方案（支持跨App测试） #

如果需要测试第三方App内的谷歌地图，或者不想改动测试钩子逻辑，可以优化现有的UI Automator代码：

• 点击标记后增加空闲等待，给弹窗动画留足渲染时间

• 不要固定用descriptionContains匹配，同时匹配text字段，必要时遍历全量可访问性节点定位

• 增加显式等待，避免节点加载延迟导致匹配失败

  优化后的代码示例：

  val device = UiDevice.getInstance(getInstrumentation())
  val marker = device.findObject(UiSelector().descriptionContains(markerTitle))
  if (marker.exists()) {
      marker.click()
  }
  // 等待地图动画、弹窗渲染完成，最长等5秒
  device.waitForIdle(5000)
  
  // 同时匹配文本、内容描述两个字段，等待3秒直到元素出现
  val infoWindow = device.findObject(
      UiSelector().textContains(expectedContent)
          .descriptionContains(expectedContent)
  )
  // 断言信息窗口存在且内容匹配
  assertTrue("信息窗口未展示预期内容", infoWindow.waitForExists(3000))
  

  如果还是匹配不到，可以在点击标记后调用调试方法打印全量可访问性节点，确认信息窗口内容实际存在的字段：

  // 调试用：打印当前页面所有可访问性节点属性
  private fun printAllNodes(node: AccessibilityNodeInfo = device.rootNode, depth: Int = 0) {
      val indent = "  ".repeat(depth)
      Log.d("MapTestDebug", "${indent}类名:${node.className} | 文本:${node.text} | 描述:${node.contentDescription}")
      repeat(node.childCount) { i ->
          node.getChild(i)?.let { printAllNodes(it, depth + 1) }
      }
  }
  

方案3：兜底方案（OCR截图校验） #

如果遇到部分版本谷歌地图完全不往可访问性树写入信息窗口内容的极端情况，可以用截图+OCR的方式做校验：

• 点击标记等待弹窗弹出后，截取当前屏幕
• 调用端侧OCR能力识别截图中的文字
• 断言识别结果中包含预期的信息窗口内容即可

这种方案适配所有自绘UI场景，缺点是执行速度稍慢，存在极低的识别误差。

内容的提问来源于stack exchange，提问作者Venkataramanan