fix(linux): AppImage blank window — stop bundling stale libwayland-client (#106) - #109
Merged
Merged
Conversation
tauri-bundler's pinned linuxdeploy (built 2024-07-29) predates the excludelist entry for libwayland-client.so.0 (added 2024-11-03), so the AppImage shipped noble's wayland 1.22. Host Mesa >= 24.2 needs wl_display_create_queue_with_name (wayland 1.23); ld.so SONAME dedup binds libEGL_mesa to the stale bundled copy, the EGL vendor fails to load and WebKit's WebProcess aborts with "Could not create default EGL display: EGL_BAD_PARAMETER", leaving a blank window. Pre-seed tauri's tools cache with a pinned linuxdeploy that carries the fixed excludelist, assert the artifact after build, and add a PR smoke workflow building the AppImage. Reproduced and verified in a Fedora 44 container: vanilla v0.5.4 aborts; the same AppImage with libwayland-client removed runs. The WEBKIT_DISABLE_* overrides from #107 cannot gate this abort: since WebKitGTK 2.46 the WebProcess initializes EGL before the preference store is applied. Closes #106
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Root cause
The AppImage ships
libwayland-client.so.01.22 (from the ubuntu-24.04 build runner). tauri-bundler downloadslinuxdeployfromtauri-apps/binary-releases— a binary built 2024-07-29, whose compiled-in excludelist predates thelibwayland-client.so.0entry added upstream on 2024-11-03 (pkg2appimage#559) for exactly this failure.At runtime: host Mesa ≥ 24.2 (
libEGL_mesa.so.0) requireswl_display_create_queue_with_name(wayland 1.23+). The bundled WebKit loads the stale 1.22 copy first (DT_NEEDED+RUNPATH=$ORIGIN); ld.so SONAME dedup then binds the host EGL vendor to that copy → fatal symbol lookup (Fedora/openSUSE link withBIND_NOW) → glvnd has zero EGL vendors →eglGetDisplay()=EGL_BAD_PARAMETER→ WebKitCRASH()in the WebProcess:Pure dynamic-linking failure, GPU-independent — hence identical on both reporter machines.
.deb/.rpmunaffected (system webkit + system wayland). Same failure class previously hit rpi-imager, normcap, Cura, RPCS3.Why #107 didn't help
The
WEBKIT_DISABLE_DMABUF_RENDERER/WEBKIT_DISABLE_COMPOSITING_MODEoverrides are set correctly, but since WebKitGTK 2.46 (WebPage.cpp:drawingArea->updatePreferences(store)runs beforeupdatePreferences(store)) the WebProcess initializes its EGL display before the preference store is applied — the abort is structurally unreachable by env vars. Verified against webkitgtk-2.52.3 sources (the version bundled in v0.5.4).Reproduced + fix verified (Fedora 44 container, same distro as reporter)
Could not create default EGL display: EGL_BAD_PARAMETER. Aborting...libwayland-client.so.0removedContainer: Fedora 44, mesa-libEGL 26.0.8, libwayland-client 1.24.
Fix
release.yml: pre-seed~/.cache/tauri/linuxdeploy-x86_64.AppImagewith pinned upstream1-alpha-20251107-1(compiled-in excludelist contains thelibwayland-client.so.0entry — verified by extracting the binary). tauri-bundler skips its own download when the file exists (verified in tauri-cli 2.9.6prepare_tools). Signing/updater pipeline untouched.release.yml: post-build assert — release job fails loudly if the AppImage ever bundleslibwayland-clientagain (with extraction sanity check so it can't false-pass).appimage-smoke.yml(new): PRs touchingsrc-tauri/**or the workflows build the AppImage and run the same assert + print the bundled lib inventory for diffing.lib.rs: comment corrected — the fix(linux): WebKitGTK EGL/DMA-BUF blank window on Linux (#106) #107 env vars help on fragile-but-working EGL stacks, but cannot prevent this abort.Regression risk
Removing the bundled copy means hosts must provide wayland ≥ 1.22 symbols — every host with glibc 2.39 (already required by a noble-built AppImage) qualifies. Currently-working users already resolve identical symbols from their system copy. Remaining bundled
libwayland-egl/cursor/serverwere analysed at symbol level and are not implicated (Mesa's import surface there is ≤ 1.6-era). The smoke workflow guards the bundle composition going forward.Closes #106
🤖 Generated with Claude Code