You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
[v3]wails3 generate appimage looks for GTK3 runtime files on the new GTK4 default (alpha.93) #5475
Since alpha.93, the default CGO build target on Linux is GTK4 / WebKitGTK 6 (the GTK3 path is retained behind -tags gtk3, per the alpha.93 changelog). But wails3 generate appimage still hard-codes the WebKit2GTK 4.x runtime filenames when packaging, so on a runner that only has the GTK4 toolchain installed, AppImage generation aborts:
Processing GTK files. [3/5] 60% | 1m13s
ERROR Unable to locate all required files: libwebkit2gtkinjectedbundle.so
task: Failed to run task "linux:create:appimage": exit status 1
When the binary is built against GTK4 / WebKitGTK 6, the AppImage bundler should pick the matching WebKitGTK 6 runtime files instead of the WebKit2GTK 4.x set — either by checking the build tag, ldd'ing the input binary, or taking a CLI flag.
Attempted Fixes
Workaround that works today: pin the app build to -tags gtk3 and put libgtk-3-dev libwebkit2gtk-4.1-dev back on the runner. The changelog calls this the "legacy" path, but pre-alpha.93 it was just "the path", so the takeaway from a downstream perspective is "GTK4 AppImage isn't wired up yet" rather than "GTK3 was deprecated and you missed it".
Additional context
Hit this when bumping a downstream project from alpha.90 → alpha.93. Same Taskfile.yml worked at alpha.90 with libgtk-3-dev libwebkit2gtk-4.1-dev installed; failed at alpha.93 with the GTK4 packages; recovered at alpha.93 with -tags gtk3 + GTK3 packages. Happy to attach wails doctor output from a matching Linux env if useful.
changed the title [-]`wails3 generate appimage` looks for GTK3 runtime files on the new GTK4 default (alpha.93)[/-][+][v3]`wails3 generate appimage` looks for GTK3 runtime files on the new GTK4 default (alpha.93)[/+]on May 18, 2026
Activity
[-]`wails3 generate appimage` looks for GTK3 runtime files on the new GTK4 default (alpha.93)[/-][+][v3]`wails3 generate appimage` looks for GTK3 runtime files on the new GTK4 default (alpha.93)[/+]leaanthony commentedon May 18, 2026
Ah nice catch! I knew the switcharoo wouldn't be seamless 😬
fix(v3/appimage): absolute input paths and forced output filename
fix(v3/appimage): quote shell args and surface ldd output on detect f…
fix(v3/appimage): GTK4 default + relative builddir + output filename (#…