华为MapKit MapView启动时已禁用的缩放按钮为何闪烁后消失？

问题场景说明 #

在布局XML中通过map:uiZoomControls="false"配置禁用地图缩放按钮，预期实现缩放按钮完全隐藏的效果，但集成MapView的应用启动时，缩放按钮会先显示约0.5秒后才变为不可见，需要消除该视觉异常。

问题根因 #

该现象的本质是MapView的内部绘制时序问题：MapView初始化时会先执行基础地图视图的默认渲染流程（此时缩放按钮采用默认的显示状态），后续才会读取布局XML中传入的自定义配置调整UI控件状态，两个流程的时间差就造成了控件的短暂闪现。

具体解决方法 #

• 在地图就绪回调中强制配置控件状态，补全时序缺口
  不要仅依赖XML配置的自动生效，在获取MapView实例后，通过getMapAsync注册地图就绪回调，在回调触发时直接调用代码逻辑强制关闭缩放控件，抢在初始渲染的展示节点前完成控件状态调整：

  // 地图实例获取回调内的核心逻辑
  mapView.getMapAsync(huaweiMap -> {
      // 强制关闭缩放控件显示
      huaweiMap.getUiSettings().setZoomControlsEnabled(false);
      // 可同步配置其他需禁用的地图UI控件，避免同类闪现问题
  });
  

• 调整MapView初始可见性，屏蔽初始化阶段的渲染透出
  在XML布局中将MapView的初始可见性设置为invisible，等完成所有UI控件的状态配置后，再手动将MapView切换为可见状态，从根源上让用户无法观测到初始化阶段的默认控件绘制过程：
  对应XML配置片段：

  <com.huawei.hms.maps.MapView
      android:id="@+id/mapView"
      android:layout_width="match_parent"
      android:layout_height="match_parent"
      android:visibility="invisible"
      map:uiZoomControls="false"
      />
  

  回调内补充可见性切换逻辑：

  mapView.getMapAsync(huaweiMap -> {
      huaweiMap.getUiSettings().setZoomControlsEnabled(false);
      // 完成所有UI配置后再展示地图视图
      mapView.setVisibility(View.VISIBLE);
  });
  

• 升级适配稳定版本的MapKit SDK
  旧版本MapKit SDK存在布局自定义属性读取时序滞后的已知缺陷，将集成的SDK版本升级到6.11.0.300及以上的正式稳定版，该版本优化了XML布局属性的解析时机，会在MapView首次执行绘制流程前完成所有自定义配置的读取，从SDK层面消除默认缩放按钮的初始渲染。

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