Skip to content

Commit ba38da1

Browse files
committed
docs: BadWindow to x11
1 parent 774b8bd commit ba38da1

File tree

1 file changed

+22
-6
lines changed

1 file changed

+22
-6
lines changed

docs/faq/linux.md

Lines changed: 22 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,18 +6,34 @@ Ubuntu `20.04` 需要额外安装 `libwebkit2gtk` 和 `libjavascriptcoregtk` 依
66

77
不能。Clash Verge Rev 是基于 `Webview` 的 GUI 程序,需要图形化界面支持。无图形化界面请下载 [MetaCubeX/Mihomo](https://github.com/MetaCubeX/mihomo/releases/latest) 内核二进制程序,通过命令行的方式使用(参数 `--help` 查看帮助)。
88

9+
## KDE 窗口标题栏按钮(最小化/最大化/关闭)失效
10+
11+
打开设置 -> 界面设置 -> 关闭「优先使用系统标题栏」。
12+
913
## 启动失败:Error 71 (Protocol error) dispatching to Wayland display.
1014

11-
这是一个已知的[上游问题](https://github.com/tauri-apps/tauri/issues/10702)。暂时的解决方法是手动设置环境变量 `WEBKIT_DISABLE_DMABUF_RENDERER=1`
15+
这是一个已知的[上游问题](https://github.com/tauri-apps/tauri/issues/10702)。 暂时的解决方法是手动设置环境变量:
16+
```
17+
WEBKIT_DISABLE_DMABUF_RENDERER=1
18+
```
1219

1320
## AcceleratedSurface was unable to construct a complete framebuffer
1421

15-
这是一个已知的[上游问题](https://github.com/tauri-apps/tauri/issues/9304)。暂时的解决方法是手动设置环境变量 `WEBKIT_DISABLE_DMABUF_RENDERER=1`
22+
这是一个已知的[上游问题](https://github.com/tauri-apps/tauri/issues/9304)。暂时的解决方法是手动设置环境变量:
23+
```
24+
WEBKIT_DISABLE_DMABUF_RENDERER=1
25+
```
1626

17-
## KDE 窗口标题栏按钮(最小化/最大化/关闭)失效
27+
## UI 未响应 / UI 卡顿
1828

19-
打开设置 -> 界面设置 -> 关闭「优先使用系统标题栏」。
29+
尝试手动设置环境变量:
30+
```
31+
WEBKIT_DISABLE_DMABUF_RENDERER=0
32+
```
2033

21-
## UI 未响应 / UI 卡顿
34+
## BadWindow (invalid Window parameter)
2235

23-
尝试手动设置环境变量 `WEBKIT_DISABLE_DMABUF_RENDERER=0`
36+
部分发行版可能出现的 XWayland 兼容层问题(Wayland 下经由 XWayland 运行的 GTK / WebKitGTK 在窗口销毁 / 重建时仍访问了已失效的 X11 窗口句柄,触发 BadWindow 崩溃)。暂时的解决方法是手动设置环境变量:
37+
```
38+
GDK_BACKEND=x11
39+
```

0 commit comments

Comments
 (0)