macOS安装Android SDK后uiautomatorviewer缺少截图工具栏如何恢复

问题核心逻辑 #

这个问题基本和安装错误、操作不当没有关系，是Android SDK 26.0及以上版本自带的uiautomatorviewer，在macOS的Java Swing运行环境下存在的原生渲染bug：整个应用框架能正常打开，但顶部工具栏的组件根本没被正常绘制出来，别找什么“显示工具栏”的菜单开关，这个工具本身就没设计这个切换功能。

具体排查解决步骤 #

• 更换启动入口
  不要通过Android Studio侧边的快捷按钮启动uiautomatorviewer，直接定位到本地SDK路径下的tools/bin/uiautomatorviewer可执行脚本，双击或者在终端运行该脚本启动。很多时候IDE启动时会携带错误的环境参数，直接导致UI组件卡加载失败。
• 关闭Java的Metal渲染加速
  这是触发该bug最高发的原因：macOS上Java从9版本开始默认开启的Metal图形渲染接口，和uiautomatorviewer依赖的老旧Swing组件存在兼容问题。打开终端，先执行一行环境变量设置，再启动工具即可绕开该问题：

  export _JAVA_OPTIONS='-Dsun.java2d.metal=false'
  

  执行完正常启动uiautomatorviewer，绝大多数场景下工具栏会完整加载出来。
• 排查屏幕可视区域裁剪问题
  如果外接了高分辨率显示器，检查系统显示器设置里的缩放比例，避免因为过度的HiDPI放大，把工具栏顶到屏幕可视范围外。这种场景下把显示器缩放切回默认比例，重启工具就能看到完整界面。
• 兜底解决方案
  如果以上操作都无效，直接下载Android SDK 25.0.3版本的独立工具包替换现有版本，该版本的uiautomatorviewer不存在macOS下的Swing渲染兼容问题，不会出现工具栏丢失的情况。

踩坑提醒：别在菜单栏反复找“显示工具栏”的选项，这个工具的顶部栏是主界面的固定组成部分，压根没做隐藏/显示的切换逻辑，看不到就是渲染异常，不是操作设置不对。

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