Skip to content

[v3-alpha] New projects can't build AppImage on linux #4642

@jaideepheer

Description

@jaideepheer

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

  1. Be on Linux/Ubuntu.
  2. Create a new app with wails3 init -n app
  3. Run wails task package
  4. 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 sponsor

Additional context

Raised PR #4641 as fix.

Metadata

Metadata

Assignees

No one assigned

    Labels

    BugSomething isn't working

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions