Skip to content

Commit 85fd46c

Browse files
committed
docs(faq): document workaround for "Truncating shared memory file failed"
1 parent 18af8af commit 85fd46c

File tree

1 file changed

+12
-5
lines changed

1 file changed

+12
-5
lines changed

docs/faq/linux.md

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -12,34 +12,41 @@ Ubuntu `20.04` 需要额外安装 `libwebkit2gtk` 和 `libjavascriptcoregtk` 依
1212

1313
## 启动失败:Error 71 (Protocol error) dispatching to Wayland display.
1414

15-
这是一个已知的[上游问题](https://github.com/tauri-apps/tauri/issues/10702)。 暂时的解决方法是手动设置环境变量
15+
这是一个已知的[上游问题](https://github.com/tauri-apps/tauri/issues/10702),可能在 NVIDIA + Wayland 环境出现。可通过设置以下环境变量进行规避
1616
```
1717
WEBKIT_DISABLE_DMABUF_RENDERER=1
1818
```
1919

2020
## AcceleratedSurface was unable to construct a complete framebuffer
2121

22-
这是一个已知的[上游问题](https://github.com/tauri-apps/tauri/issues/9304)。暂时的解决方法是手动设置环境变量
22+
这是一个已知的[上游问题](https://github.com/tauri-apps/tauri/issues/9304),可能在 NVIDIA + Wayland 环境出现。可通过设置以下环境变量进行规避
2323
```
2424
WEBKIT_DISABLE_DMABUF_RENDERER=1
2525
```
2626

2727
## Failed to create GBM buffer of size xxx: Invalid argument
2828

29-
这是一个已知的[上游问题](https://github.com/tauri-apps/tauri/issues/13493)。暂时的解决方法是手动设置环境变量
29+
这是一个已知的[上游问题](https://github.com/tauri-apps/tauri/issues/13493),可能在 NVIDIA + Wayland 环境出现。可通过设置以下环境变量进行规避
3030
```
3131
WEBKIT_DISABLE_DMABUF_RENDERER=1
3232
```
3333
## UI 未响应 / UI 卡顿
3434

35-
尝试手动设置环境变量
35+
尝试设置以下环境变量
3636
```
3737
WEBKIT_DISABLE_DMABUF_RENDERER=0
3838
```
3939

4040
## BadWindow (invalid Window parameter)
4141

42-
部分发行版可能出现的 XWayland 兼容层问题(Wayland 下经由 XWayland 运行的 GTK / WebKitGTK 在窗口销毁 / 重建时仍访问了已失效的 X11 窗口句柄,触发 BadWindow 崩溃)。暂时的解决方法是手动设置环境变量:
42+
部分发行版可能出现的 XWayland 兼容层问题,可通过设置以下环境变量进行规避:
43+
```
44+
GDK_BACKEND=x11
45+
```
46+
47+
## Truncating shared memory file failed: Invalid argument
48+
49+
这是一个已知的[上游问题](https://gitlab.gnome.org/GNOME/gtk/-/issues/2504),可能在高分辨率或开启 HiDPI 缩放的 Wayland 环境下出现。可通过设置以下环境变量进行规避:
4350
```
4451
GDK_BACKEND=x11
4552
```

0 commit comments

Comments
 (0)