Description
The desktop file (app.desktop) specifies Icon=app, but the AppDir contains appicon.png -> .DirIcon (symlink). The linuxdeploy appimage plugin validates the Icon= field and fails when it cannot find app.png, app.svg, or app.xpm in the AppDir root.
Configuration Chain:
- Taskfile (
build/linux/Taskfile.yml line 113): ICON: '{{.APP_NAME}}' → Desktop file gets Icon=app
- Taskfile (
build/linux/Taskfile.yml line 55): ICON: '../../appicon.png' → Path used for symlink
- Wails3 Code (
appimage.go line 101): filepath.Base("../../appicon.png") = "appicon.png" → Creates appicon.png -> .DirIcon
This mismatch causes linuxdeploy to fail when searching for the icon referenced in the desktop file.
To Reproduce
- Be on Linux/Ubuntu.
- Create a new app with
wails3 init -n app
- Run
wails task package
- Cry and weep about it
Expected behaviour
Package build should succeed.
Screenshots
No response
Attempted Fixes
The Fix: Aligns the icon variable in the Taskfile's generate:dotdesktop task to match the icon filename created by the create:appimage task, ensuring both use appicon as the base name.
System Details
Wails (v3.0.0-alpha.34) Wails Doctor
▀ Scanning system - Please wait (this ma
▀ Scanning system - Please wait (this ma ▄ Scanning system - Please wait (this ma▄ Scanning system - Please wait (this ma▀ Scanning system - Please wait (this ma ▀ Scanning system - Please wait (this ma ▄ Scanning system - Please wait (this ma▄ Scanning system - Please wait (this ma▀ Scanning system - Please wait (this ma ▀ Scanning system - Please wait (this ma ▄ Scanning system - Please wait (this ma▄ Scanning system - Please wait (this ma▀ Scanning system - Please wait (this ma ▀ Scanning system - Please wait (this ma ▄ Scanning system - Please wait (this ma▄ Scanning system - Please wait (this ma▀ Scanning system - Please wait (this ma ▀ Scanning system - Please wait (this ma ▄ Scanning system - Please wait (this ma▄ Scanning system - Please wait (this ma▀ Scanning system - Please wait (this ma ▀ Scanning system - Please wait (this ma ▄ Scanning system - Please wait (this ma▄ Scanning system - Please wait (this ma▀ Scanning system - Please wait (this ma SUCCESS Scanning system - Please wait ( # System
┌────────────────────────────────────────
───────────────────┐ | Name | Ubuntu
| | Version | 24.04
| | ID | ubuntu
| | Branding | 24.04.3 LTS (Noble Numba
t) | | Platform | linux
| | Architecture | amd64
| | CPU 1 | Intel(R) Core(TM) i7-108
75H CPU @ 2.30GHz | | CPU 2 | Intel(R) Core(TM) i7-108
75H CPU @ 2.30GHz | | GPU 1 | SVGA II Adapter (VMware)
- Driver: vmwgfx | | Memory | 6GB
| └────────────────────────────────────────
───────────────────┘
# Build Environment
┌────────────────────────────────────────
─────────────────────────────────────────────────────────────┐ | Wails CLI | v3.0.0-alpha.34
| | Go Version | go1.25.1
| | -buildmode | exe
| | -compiler | gc
| | -trimpath | true
| | CGO_ENABLED | 1
| | DefaultGODEBUG | containermaxprocs=0,de
coratemappings=0,tlssha1=1,updatemaxprocs=0,x509sha256skid=0 | | GOAMD64 | v1
| | GOARCH | amd64
| | GOOS | linux
| └────────────────────────────────────────
─────────────────────────────────────────────────────────────┘
# Dependencies
┌──────────────────────────────────────┐
| gcc | 12.10ubuntu1 |
| gtk3 | 3.24.41-4ubuntu1.3 |
| npm | 10.9.3 |
| pkg-config | 1.8.1-2build1 |
| webkit2gtk | 2.48.7-0ubuntu0.24.04.2 |
| |
└────── * - Optional Dependency ───────┘
# Checking for issues
SUCCESS No issues found
# Diagnosis
SUCCESS Your system is ready for Wails
development!
Need documentation? Run: wails3 docs
♥ If Wails is useful to you or your co
mpany, please consider sponsoring the project: wails3 sponsorAdditional context
Raised PR #4641 as fix.
Description
The desktop file (
app.desktop) specifiesIcon=app, but the AppDir containsappicon.png -> .DirIcon(symlink). The linuxdeploy appimage plugin validates theIcon=field and fails when it cannot findapp.png,app.svg, orapp.xpmin the AppDir root.Configuration Chain:
build/linux/Taskfile.ymlline 113):ICON: '{{.APP_NAME}}'→ Desktop file getsIcon=appbuild/linux/Taskfile.ymlline 55):ICON: '../../appicon.png'→ Path used for symlinkappimage.goline 101):filepath.Base("../../appicon.png")="appicon.png"→ Createsappicon.png -> .DirIconThis mismatch causes linuxdeploy to fail when searching for the icon referenced in the desktop file.
To Reproduce
wails3 init -n appwails task packageExpected behaviour
Package build should succeed.
Screenshots
No response
Attempted Fixes
The Fix: Aligns the icon variable in the Taskfile's
generate:dotdesktoptask to match the icon filename created by thecreate:appimagetask, ensuring both useappiconas the base name.System Details
Additional context
Raised PR #4641 as fix.