Ubuntu 17.10下Wayland显示服务器枚举顶级窗口及属性方案咨询

首先得明确：Wayland的设计和X11完全不同——X11允许任何程序全局枚举所有窗口，但Wayland基于沙箱化、隐私优先的理念，没有全局窗口列表这种“一刀切”的接口。你遇到的gedit、LibreOffice窗口无法被X11工具识别，正是因为它们是纯Wayland客户端（没有用XWayland兼容层），X11工具根本看不到它们。

下面是几种可行的方案，按通用性和未来适配性排序：

1. 跨桌面通用方案：AT-SPI2无障碍框架 #

这是Linux桌面的标准无障碍API，和macOS的NSAccessibility、Windows的UIAutomation定位一致，也是Wayland环境下获取窗口信息的未来可靠方案。几乎所有主流桌面环境（GNOME、KDE Plasma、Xfce等）的Wayland compositor都支持AT-SPI2，GTK/Qt应用也默认会暴露窗口标题、位置等属性。

实现步骤（以Python为例）： #

• 先安装依赖：

  sudo apt-get install python3-pyatspi2
  

• 示例代码：

  import pyatspi
  
  def list_all_windows():
      # 获取主桌面节点
      desktop = pyatspi.Registry.getDesktop(0)
      for app in desktop:
          if app.getRoleName() != 'application':
              continue
          print(f"📱 应用名称: {app.name or '未知'}")
          # 遍历应用下的顶级窗口
          for window in app:
              if window.getRoleName() == 'frame':
                  print(f"  🪟 窗口标题: {window.name or '无标题'}")
                  # 还能获取窗口位置、大小等属性
                  # rect = window.getExtents(pyatspi.DESKTOP_COORDS)
                  # print(f"  位置: ({rect.x}, {rect.y}), 大小: {rect.width}x{rect.height}")
  
  if __name__ == "__main__":
      pyatspi.Registry.start()
      list_all_windows()
  

注意事项： #

• 你的程序需要被授予无障碍权限：在GNOME设置的「辅助功能」中，确保“屏幕阅读器”或对应应用的访问权限已启用；KDE则在「系统设置-辅助功能-屏幕阅读器」中开启。这是Wayland安全模型的要求，防止恶意程序窥探窗口信息。

2. GNOME Wayland专属方案：GNOME Shell DBus接口 #

如果你的程序只需要适配GNOME桌面（Ubuntu 17.10默认用GNOME Shell），可以直接调用GNOME Shell暴露的DBus服务，获取窗口信息更直接。

示例代码（Python）： #

import dbus

def get_gnome_windows():
    session_bus = dbus.SessionBus()
    # 连接GNOME Shell的DBus对象
    shell_obj = session_bus.get_object('org.gnome.Shell', '/org/gnome/Shell')
    shell_iface = dbus.Interface(shell_obj, dbus_interface='org.gnome.Shell')
    # 调用ListWindows方法获取窗口列表
    windows = shell_iface.ListWindows()
    for win in windows:
        print(f"窗口标题: {win['title']}, 窗口ID: {win['id']}, 应用ID: {win['app_id']}")

if __name__ == "__main__":
    get_gnome_windows()

这个方案的缺点是只能在GNOME Shell下工作，换用KDE Plasma等其他Wayland compositor就失效了。

3. KDE Plasma Wayland专属方案：KWin DBus接口 #

如果需要适配KDE的Wayland环境，可以调用KWin的DBus接口：

# 先用命令行测试
qdbus org.kde.KWin /KWin getWindows

返回的结果包含每个窗口的标题、位置、应用名称等信息，用Python或C++调用DBus即可解析。

总结未来可靠方案 #

优先选择AT-SPI2无障碍框架：

• 它是Linux桌面的标准，跨所有主流Wayland compositor；
• 符合Wayland的安全模型，未来不会被废弃；
• 和你已有的macOS（NSAccessibility）、Windows（UIAutomation）方案的设计思路一致，便于统一跨平台代码逻辑。

而X11的X_QueryTree这类全局枚举方式，在Wayland下已经彻底退出历史舞台，不要再依赖XWayland兼容层——纯Wayland应用会越来越多，兼容层只能覆盖旧应用。

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