[Bug Report] Chromium WebApps display generic fallback gear icon in Wayland due to StartupWMClass / app_id mismatch
还没有人认领这个 Issue。
评估
调研方向
Start by locating the Chromium-based browser launcher generation logic in webapp-manager and tracing how it sets StartupWMClass and installs icon assets. Check how Chromium’s Wayland app_id and desktop icon lookup behave for the supported browsers and profiles. Done means the launcher groups with the running window and displays its chosen icon without creating duplicate app entries; the issue names no source files or tests.
由索引模型根据 Issue 内容生成。
描述
[Bug Report] Chromium WebApps display generic fallback gear icon in Wayland due to StartupWMClass / app_id mismatch
Environment
- OS: Zorin OS 17/18 / Linux Mint (Wayland session)
- Desktop Environment: GNOME Shell / Zorin Desktop
- Application:
webapp-manager(Ice SSB) - Browser: Google Chrome / Chromium (Ozone platform: Wayland)
Steps to Reproduce
- Open WebApp Manager.
- Create a new WebApp using Google Chrome (or Chromium/Brave) pointing to
https://music.youtube.com/. - Select an icon (custom or preset) and save.
- Add the WebApp to Favorites / Dash.
- Launch the WebApp.
Expected Behavior
The running window should group under the pinned WebApp launcher on the dock/taskbar with its designated icon.
Actual Behavior
The running window fails to group with the launcher and appears as a separate taskbar entry displaying a generic gear ("carenagem") placeholder icon.
Root Cause Analysis
-
Wayland
app_idGeneration in Chromium:
When running under Wayland (--ozone-platform=wayland), Chromium ignores the command line switch--class=WebApp-<name><id>.
Instead, Chromium calculates the Wayland surfaceapp_idviashell_integration_linuxusing the pattern:
chrome-<host>__<path>-<profile>(e.g.chrome-music.youtube.com__-Default). -
Launcher Mismatch:
webapp-managerwrites:StartupWMClass=WebApp-MusicGoogle7059Because
StartupWMClassdoes not match the Waylandapp_id, the window manager (GNOME Shell / Mutter) cannot link the surface to the.desktopfile and falls back to a generic window icon.
Proposed Fix
In webapp-manager launcher generation logic for Chromium-based browsers:
- Parse the WebApp URL to compute the expected Wayland
app_id:from urllib.parse import urlparse parsed = urlparse(url) host = parsed.netloc or parsed.path wayland_app_id = f"chrome-{host}__-Default" - Set
StartupWMClassdirectly to the calculatedwayland_app_id(chrome-<host>__-Default) instead ofWebApp-<codename>.- Note on Best Practice: Do not create a secondary symlink like
<wayland_app_id>.desktopin~/.local/share/applications/, as doing so causes desktop environments (e.g. GNOME / Zorin Menu) to index and display duplicate application entries in the app launcher. SettingStartupWMClassalone is 100% sufficient for GNOME Shell / Mutter to map the surface window to the single existing.desktoplauncher.
- Note on Best Practice: Do not create a secondary symlink like
- Ensure the icon asset is copied to
~/.local/share/icons/hicolor/<size>/apps/under thewayland_app_idname so the window manager reliably resolves it.
- 主要语言
- Python
- 星标
- 1k
- 派生
- 132
- PR 合并指标
- 30 天内没有已合并 PR
环境准备
这个项目没有提供开发容器、Dockerfile 或贡献指南,环境需要你自己搭建:先看它的 README,通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
linuxmint/webapp-manager 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 63/100
linuxmint/webapp-manager#411 ·
-
难度 3/5 1-2 天 新手友好度 48/100
linuxmint/webapp-manager#409 · 1 条评论 ·
-
难度 4/5 1-2 天 新手友好度 35/100
linuxmint/webapp-manager#407 · 1 条评论 ·
-
难度 2/5 1-3 小时 新手友好度 55/100
linuxmint/webapp-manager#402 · 3 个 reaction ·
-
难度 3/5 1-2 天 新手友好度 52/100
linuxmint/webapp-manager#401 · 1 条评论 · 1 个 reaction ·
查看 linuxmint/webapp-manager 的全部 Issue
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 77/100
mozilla-ai/cq#601 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 68/100
维护者通常 1 天内回复
-
intcomma returns exponential notation for large floats可能已有人在做 @Omarinho12345 今天认领。 未关闭
难度 2/5 1-3 小时 新手友好度 72/100
python-humanize/humanize#521 ·
维护者通常 1 天内回复
-
LUCJ pass manager raises NoEdgeBetweenNodes when an edge is bad for two two-qubit gates可能已有人在做 @hat-im 今天认领。 未关闭
难度 2/5 1-3 小时 新手友好度 76/100
维护者通常 1 天内回复
-
opensubtitlescom: provider rejects pt-PT even though its own converter maps it可能已有人在做 @paulo-0308 今天认领。 未关闭
难度 1/5 1 小时以内 新手友好度 88/100
Diaoul/subliminal#1405 ·