Compose测试：如何利用Google Maps组件自带tag字段定位元素？

问题原因 #

Google Maps Compose中的Polyline是地图SDK的Overlay元素，不属于Compose原生UI节点树。你通过构造函数设置的tag是Google Maps SDK内部使用的标识，并非Compose测试体系中的TestTag，因此composeTestRule.onNodeWithTag()无法识别这个tag。

解决方案 #

要验证Polyline是否存在，需要直接与Google Maps实例交互，检查其Overlay集合中的元素：

1. 在Compose代码中保留GoogleMap实例引用
   将地图初始化后的实例保存到可访问的状态中，方便测试代码获取：

   // 可用remember或ViewModel保存实例，测试时通过全局变量或测试容器获取
   var googleMap: GoogleMap? by remember { mutableStateOf(null) }
   
   GoogleMap(
       modifier = Modifier.testTag("map_container"), // 给地图容器加Compose测试标签，用于等待加载
       onMapReady = { map ->
           googleMap = map
       }
   ) {
       Polyline(
           points = it,
           color = Color.Blue,
           tag = MAP_ROUTE_TAG
       )
   }
   

2. 在测试代码中验证Polyline存在
   先等待地图加载完成，再获取GoogleMap实例，检查其Polyline集合中是否包含目标tag的元素：

   // 等待地图容器加载完成
   composeTestRule.onNodeWithTag("map_container").assertExists()
   
   // 获取GoogleMap实例（根据你保存实例的方式调整）
   val googleMap = composeTestRule.runOnIdle {
       // 示例：假设googleMap是remember保存的变量，通过测试用的状态容器获取
       yourComposeState.googleMap
   }
   
   // 验证目标Polyline是否存在
   val targetPolylineExists = googleMap?.polylines?.any { it.tag == MAP_ROUTE_TAG } ?: false
   assertTrue(targetPolylineExists)
   

补充说明 #

如果需要验证Polyline是否在可视区域内，可以结合GoogleMap的投影属性检查：

val projection = googleMap?.projection
val polylineBounds = googleMap?.polylines?.find { it.tag == MAP_ROUTE_TAG }?.bounds
val isVisible = projection?.visibleRegion?.latLngBounds?.intersects(polylineBounds) ?: false
assertTrue(isVisible)

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