dogtail 1.0.1

dogtail 1.0

经过超过五年的持续实验和开发，我们非常高兴终于发布了 Dogtail 1.0——Dogtail 的一个支持 Wayland 的版本！我们是如何实现这一点的？这得益于由 Olivier Fourdan 创造的 gnome-ponytail-daemon。这个工具使我们能够在 Wayland GNOME 会话中执行类似 X 函数的操作。

dogtail 1.0.1 - 与我们在开发 Wayland 的同时提交到 master 分支的一些贡献进行了重新提交，但我们不小心没有包括在 1.0 中。请参阅https://gitlab.com/dogtail/dogtail/-/issues/31

还返回了几个我们认为没有用的模块（tc，wrapped），但后来证明它们是有用的，以保持 1.0 与 0.x 完全兼容。

它是如何简短工作的？

核心功能依赖于屏幕捕获和远程桌面 API，使我们能够“连接”到特定的窗口或整个屏幕，以模拟用户输入操作，如按键、输入和——最重要的是——在特定坐标上的鼠标操作。Ponytail 使用 org.gnome.Shell.Introspect 的窗口列表来识别窗口。然后 Dogtail 通过远程桌面 API 确保连接到正确的窗口，从而允许在窗口内精确执行输入操作。

在 AT-SPI 树和可访问性的“内省”方面，没有太多变化——输入是 Wayland 上的主要挑战。主要区别在于，UI 项只知“本地”窗口坐标。为了解决这个问题，我们始终连接到我们正在处理的特定窗口，Ponytail 的 connectWindow 确保这些本地坐标在内部转换为全局坐标。

这对用户意味着什么？

Dogtail 无缝处理所有这些逻辑，因此在实际使用中，用户无需担心坐标类型或窗口连接。事实上，我们的大多数测试在 X 和 Wayland 会话中使用 Dogtail API 时工作方式完全相同。在 X 会话中运行时，Dogtail 将使用传统的 X 函数来处理输入并像以前一样操作。

通往 1.0 的漫长旅程

我们开始开发支持 Wayland 的版本已有五年多时间（最初可在 devel/wayland 分支中找到）。我们花了所有这些时间来确保解决方案足够健壮和可靠，值得发布 1.0 版本。此版本包括所有与 Wayland 相关的开发以及其他更改（如下面提到的 GTK4 支持调整）并经过广泛测试。重要的是，它与迄今为止可用的整个 Dogtail API 兼容。此版本包括 0.9.x 系列的所有模块，最重要的是“过程”模块，我们计划在 Dogtail 2.0 中使用完全基于“树”的方法来弃用它。

该版本将涉及重大清理、主要代码重构，并从 pyatspi 过渡到直接检查的 atspi。它还将包含更新的代码示例，并且 Dogtail 的单元测试应该在 GitLab 管道重新启用后通过。

有关即将发生的更改的更多详细信息，请参阅问题 #29。

1.0+ 重要：在 Dogtail 中处理 GTK4 应用程序窗口

对于 GTK4 应用程序，禁用窗口阴影对于确保 Dogtail 准确定位至关重要。禁用阴影后，我们会遇到一致的坐标偏移，我们将其预配置为 dogtail.config.gtk4Offset。在处理全屏窗口的情况下，偏移量为 0，我们能够在 X11 和 Wayland 会话中即时检测到这一点。然而，这个过程需要 python-xlib，即使在 Wayland 会话中也是如此，我们利用 Xwayland 确定分辨率信息，因为我们尚未找到适用于 Wayland 的其他直接方法。

当窗口阴影处于活动状态时，感知到的偏移量可能会显著变化，受特定应用程序、窗口大小和缩放设置等因素的影响。为了确保应用程序之间的行为一致，建议禁用阴影。

在 GTK4 中禁用阴影

要禁用窗口阴影，请将以下 CSS 添加到您的 GTK4 配置文件中（~/.config/gtk-4.0/gtk.css）

window, .popover, .tooltip {
    box-shadow: none;
}