[Bug Report] Chromium WebApps display generic fallback gear icon in Wayland due to StartupWMClass / app_id mismatch
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 4/5
- Thời gian dự kiến
- 3-5 ngày
- Mức phù hợp với người mới
- 54/100
Hướng nghiên cứu
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.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
[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.
- Ngôn ngữ chính
- Python
- Star
- 1k
- Fork
- 132
- Chỉ số merge pull request
- Không có pull request nào được merge trong 30 ngày
Chuẩn bị môi trường
Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của linuxmint/webapp-manager
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 63/100
linuxmint/webapp-manager#411 ·
-
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 48/100
linuxmint/webapp-manager#409 · 1 bình luận ·
-
Độ khó 4/5 1-2 ngày Mức phù hợp với người mới 35/100
linuxmint/webapp-manager#407 · 1 bình luận ·
-
Add Brave Origin supportĐang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 55/100
linuxmint/webapp-manager#402 · 3 reaction ·
-
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 52/100
linuxmint/webapp-manager#401 · 1 bình luận · 1 reaction ·
Tất cả issue của linuxmint/webapp-manager
Issue tương tự
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 77/100
mozilla-ai/cq#601 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Bump Python to 3.14 or 3.15Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
Maintainer thường phản hồi trong vòng 1 ngày
-
intcomma returns exponential notation for large floatsCó thể đã có người làm @Omarinho12345 đã nhận hôm nay. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
python-humanize/humanize#521 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
LUCJ pass manager raises NoEdgeBetweenNodes when an edge is bad for two two-qubit gatesCó thể đã có người làm @hat-im đã nhận hôm nay. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
Maintainer thường phản hồi trong vòng 1 ngày
-
opensubtitlescom: provider rejects pt-PT even though its own converter maps itCó thể đã có người làm @paulo-0308 đã nhận hôm nay. Đang mở
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 88/100
Diaoul/subliminal#1405 ·