Add libxkbcommon-x11-0 to the Linux quick start and record the window and rebuild checked (R5.7)

On a clean Ubuntu 24.04 under X11 the app stopped before its window:
"Library libxkbcommon-x11.so could not be loaded". With libxkbcommon-x11-0
installed it opened on its welcome screen. The README's snake-game rebuild
reached Ready with Claude Code. Also notes, as an open line, that the first
build check didn't find the program when Cargo's target-dir pointed elsewhere.
This commit is contained in:
Fadlalla-ai committed 2026-11-16 14:01:18 +04:00
1 parent a00aedbff1
commit 946f2522db
13 files changed
+33 -16

No files matched your search

+1 -1
View File
@@ -211,7 +211,7 @@ Requiere Rust **1.97 o posterior** (una dependencia lo necesita; `rustup update`
la app de escritorio también necesita:
```sh
sudo apt-get install build-essential libxkbcommon-dev libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev
sudo apt-get install build-essential libxkbcommon-dev libxkbcommon-x11-0 libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev
```
Después:
+1 -1
View File
@@ -194,7 +194,7 @@ Nécessite Rust **1.97 ou plus récent** (une dépendance l’exige ; `rustup up
l’application de bureau a également besoin de :
```sh
sudo apt-get install build-essential libxkbcommon-dev libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev
sudo apt-get install build-essential libxkbcommon-dev libxkbcommon-x11-0 libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev
```
Puis :
+1 -1
View File
@@ -169,7 +169,7 @@ craft-anything-cli rebuild https://example.com "Recreate this website"
Rust **1.97 以降**が必要です (依存関係が要求します。`rustup update`)。Debian か Ubuntu では、デスクトップアプリには次のものも必要です:
```sh
sudo apt-get install build-essential libxkbcommon-dev libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev
sudo apt-get install build-essential libxkbcommon-dev libxkbcommon-x11-0 libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev
```
続いて:
+1 -1
View File
@@ -167,7 +167,7 @@ craft-anything-cli rebuild https://example.com "Recreate this website"
**Rust 1.97 이상**이 필요합니다(하위 의존성에 필요하며, `rustup update`로 업데이트합니다). Debian 또는 Ubuntu에서는 데스크톱 앱에 다음 패키지도 필요합니다:
```sh
sudo apt-get install build-essential libxkbcommon-dev libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev
sudo apt-get install build-essential libxkbcommon-dev libxkbcommon-x11-0 libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev
```
그다음:
+1 -1
View File
@@ -200,7 +200,7 @@ Requires Rust **1.97 or newer** (a dependency needs it; `rustup update`). On Deb
the desktop app also needs:
```sh
sudo apt-get install build-essential libxkbcommon-dev libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev
sudo apt-get install build-essential libxkbcommon-dev libxkbcommon-x11-0 libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev
```
Then:
+1 -1
View File
@@ -207,7 +207,7 @@ A lista completa de ferramentas está em [docs/tools.md](docs/tools.md).
`rustup update`. No Debian e no Ubuntu, o aplicativo desktop também precisa destes pacotes:
```sh
sudo apt-get install build-essential libxkbcommon-dev libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev
sudo apt-get install build-essential libxkbcommon-dev libxkbcommon-x11-0 libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev
```
Depois:
+1 -1
View File
@@ -192,7 +192,7 @@ setup) รองรับโปรแกรมแบบเนทีฟ, .NET, Ja
แอปเดสก์ท็อปต้องติดตั้งแพ็กเกจเหล่านี้เพิ่มเติม:
```sh
sudo apt-get install build-essential libxkbcommon-dev libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev
sudo apt-get install build-essential libxkbcommon-dev libxkbcommon-x11-0 libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev
```
จากนั้น:
+1 -1
View File
@@ -200,7 +200,7 @@ Rust **1.97 veya üzeri** gerekir (bir bağımlılık bunu istiyor; `rustup upda
masaüstü uygulaması için ayrıca şunlar gerekir:
```sh
sudo apt-get install build-essential libxkbcommon-dev libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev
sudo apt-get install build-essential libxkbcommon-dev libxkbcommon-x11-0 libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev
```
Sonra:
+1 -1
View File
@@ -196,7 +196,7 @@ Yêu cầu Rust **1.97 trở lên** (một dependency cần nó; `rustup update`
ứng dụng desktop còn cần:
```sh
sudo apt-get install build-essential libxkbcommon-dev libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev
sudo apt-get install build-essential libxkbcommon-dev libxkbcommon-x11-0 libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev
```
Sau đó:
+1 -1
View File
@@ -193,7 +193,7 @@ craft-anything-cli rebuild https://example.com "Recreate this website"
桌面應用程式還需要:
```sh
sudo apt-get install build-essential libxkbcommon-dev libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev
sudo apt-get install build-essential libxkbcommon-dev libxkbcommon-x11-0 libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev
```
接著:
+1 -1
View File
@@ -172,7 +172,7 @@ craft-anything-cli rebuild https://example.com "Recreate this website"
需要 Rust **1.97 或更新**(有依赖要求它;`rustup update`)。在 Debian 或 Ubuntu 上,桌面应用还需要:
```sh
sudo apt-get install build-essential libxkbcommon-dev libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev
sudo apt-get install build-essential libxkbcommon-dev libxkbcommon-x11-0 libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev
```
然后:
+7 -2
View File
@@ -764,9 +764,14 @@ yet, and the quick start is how every new person begins.
needed `build-essential`, now in the README's package line; then the app and CLI built and
`doctor` was healthy (STATUS.md, "Linux quick start")
— claimed: Fadlalla-ai, branch test/r5.7-linux-quick-start
- [ ] README quick start on a clean machine (Linux), the rest: the desktop window on a clean
machine with a screen, and the README's `rebuild` commands with a signed-in coding agent
- [x] README quick start on a clean machine (Linux), the rest: the window opened on a clean Ubuntu
24.04 once `libxkbcommon-x11-0` was installed (now in the package line), and the snake-game
`rebuild` reached Ready with Claude Code (STATUS.md, "Linux quick start")
— claimed: Fadlalla-ai, branch test/r5.7-linux-window-and-rebuild
- [ ] A Rust build whose folder's Cargo settings move its output (`build.target-dir` or
`CARGO_TARGET_DIR`): the first build check didn't find the program in the project, and the
builder had to set `target-dir = "target"` itself. Find where the check looks, and read
Cargo's target directory there
- [ ] Build the new DMG on a Mac (release dry run) and look at the window once
- [ ] #490 on macOS: a real Deep build through Claude Code with the published 0.3.0 CLI, with
2.1.179 and a current version. Windows passed; the Mac CLI was only checked to contain the
+15 -3
View File
@@ -591,9 +591,21 @@ tools; every optional engine but `objdump` absent, as expected). In a container
screen, so `cargo run` stopped with winit's "neither WAYLAND_DISPLAY nor WAYLAND_SOCKET nor DISPLAY
is set." On a Debian 13 desktop (GNOME on X11, NVIDIA RTX 3060, driver 550.163.01; not a clean
machine) the release build opened its window, drawing with Vulkan on the NVIDIA card.
Not checked: the window on a clean machine (the containers have no screen; the machine that opened it
already had build tools), the README's `rebuild` commands (they need a signed-in coding agent), Fedora
or another distribution, Wayland, and the app beyond opening its window.
Then (2026-11-16, `main` at `090188d7`) the window on a clean machine: a fresh Ubuntu 24.04 container
with the README's packages (by then with `build-essential`) built the release app first time, and was
given a virtual screen (Xvfb, X11, software rendering; added only so the container has a screen). The
app stopped before its window with "Library libxkbcommon-x11.so could not be loaded": nothing in the
package line installs the X11 half of xkbcommon, which desktop systems usually already have. With
`libxkbcommon-x11-0` added (now in the package line) the window opened on its welcome screen, drawing
on llvmpipe. The README's `craft-anything-cli rebuild - "A snake game in Rust" --rounds 1` ran on the
Debian 13 desktop above with Claude Code 2.1.322 signed in, adding `--unattended`, `--backend "Claude
Code"` and `--projects-dir` so it could run without a terminal: Ready in 3 min 24 s, 3 of 4 checks
passing (build, a picture of the running game, the self-test playing move, eat and score); the
mechanics comparison stayed unverified, as there was no original to measure. That folder's own Cargo
settings sent builds elsewhere (`build.target-dir`), so the first check didn't find the program and
the builder set `target-dir = "target"` in the app's `.cargo/config.toml`.
Not checked: Wayland, a real screen on a clean machine, the website `rebuild` examples (they need a
browser), Fedora or another distribution, and the app beyond its first screen.
### Linux graphics card choice