如何解决Ubuntu 24.04任务栏图标不显示的问题

发布于 2025-01-01 分类: Linux

有几次发现Ubuntu 24.04任务栏图标不显示，显示一个齿轮图标，折腾了半天找到了解决方案，这里已charles应用为例。问题通常不在于文件本身，而在于 Ubuntu 的 Dock（任务栏，在 GNOME 桌面环境下通常是 Ubuntu Dock 或 Dash to Dock）如何识别一个运行中的应用程序并将其与一个 .desktop 文件关联起来，尤其是在程序运行时显示一个正确的图标，或者当你右键点击 Dock 上的图标选择“添加到收藏夹”时，能正确地固定它。

最常见的原因是 .desktop 文件缺少或不匹配 StartupWMClass 字段。GNOME Shell 使用这个字段来识别应用程序的窗口类，并将其与对应的 .desktop 文件关联起来。

以下是解决步骤：

步骤 1: 确保应用程序可以正常启动并在应用程序菜单中显示

  1. 更新桌面数据库：
    打开终端，运行以下命令来刷新应用程序缓存：

    update-desktop-database ~/.local/share/applications/

    或者，你也可以运行更全面的命令：

    sudo update-desktop-database

  2. 检查应用程序菜单：
    按下 Super 键 (Windows 键)，搜索 "charles"。你应该能看到 Charles Proxy 的图标并能从这里启动它。如果这里都看不到图标，说明 Icon 路径可能有问题，或者数据库未更新。

  3. 检查权限：
    确保你的 charles 可执行文件有执行权限，以及图标文件可读。

    chmod +x /data/charles/bin/charles
chmod +r /data/charles/icon/128x128/apps/charles-proxy.png

步骤 2: 查找并添加 StartupWMClass

这是关键步骤，用于让 Dock 正确识别运行中的 Charles Proxy。

  1. 启动 Charles Proxy：
    从应用程序菜单启动 Charles Proxy，或者直接运行 /data/charles/bin/charles。确保它正在运行并且窗口是打开的。

  2. 查找 WM_CLASS：
    打开终端，运行 xprop WM_CLASS。
    你的鼠标光标会变成一个十字形状。点击 Charles Proxy 的任意一个窗口。
    终端会输出类似这样的信息：

    WM_CLASS(STRING) = "sun-awt-X11-WM-CLASS", "jetbrains-idea"

    或者

    WM_CLASS(STRING) = "charles", "Charles"

    你需要的是第二个字符串（通常是更具体的应用程序名称），例如 "Charles" 或 "charles"。有时它们是相同的，有时不同。记住这个字符串（不带引号）。

    注意： 如果你的 Charles 是 Java 应用程序，WM_CLASS 可能会更通用，例如 java 或 sun-awt-X11-WM-CLASS。你需要找到最能代表 Charles 的那个。如果只有一个，就用那一个。

  3. 修改 charles.desktop 文件：
    用文本编辑器打开 ~/.local/share/applications/charles.desktop 文件：

    nano ~/.local/share/applications/charles.desktop

    在 [Desktop Entry] 部分添加 StartupWMClass 字段，使用你刚才找到的字符串。

    例如，如果 WM_CLASS 是 "Charles"，那么添加：

    [Desktop Entry]
Name=charles
Exec=/data/charles/bin/charles
Icon=/data/charles/icon/128x128/apps/charles-proxy.png
Type=Application
Terminal=false
NoDisplay=false
StartupWMClass=Charles # <-- 添加这一行，确保大小写匹配
Categories=Development;Network;Utility; # <-- 可选，但推荐添加

    如果你在 xprop 中看到的是 "sun-awt-X11-WM-CLASS", "jetbrains-idea" 这种，那么可能是 StartupWMClass=jetbrains-idea。对于 Charles，它可能直接就是 StartupWMClass=Charles 或 StartupWMClass=charles。

  4. 保存文件并关闭编辑器。

步骤 3: 重新应用和测试

  1. 再次更新桌面数据库：

    update-desktop-database ~/.local/share/applications/

  2. 重启 Charles Proxy：
    完全关闭所有 Charles Proxy 实例，然后从应用程序菜单重新启动它。

  3. 检查 Dock：
    现在，当 Charles Proxy 运行时，Dock 上应该显示正确的 Charles Proxy 图标。你可以右键点击它，选择“添加到收藏夹” (Add to Favorites)，这样它就会固定在 Dock 上了。

完整的 charles.desktop 示例 (假设 WM_CLASS 是 "Charles")

[Desktop Entry]
Name=Charles Proxy
Comment=Web Debugging Proxy
Exec=/data/charles/bin/charles
Icon=/data/charles/icon/128x128/apps/charles-proxy.png
Type=Application
Terminal=false
StartupNotify=true
StartupWMClass=Charles
Categories=Development;Network;Utility;
  • Name: 我修改为 Charles Proxy，这样在应用程序菜单中显示更友好。
  • Comment: 添加一个简短的描述。
  • StartupNotify=true: 这可以告诉桌面环境应用程序正在启动，有时有助于显示启动动画。
  • Categories: 为应用程序分类，使其在应用程序菜单的不同类别下可见。

按照这些步骤，你的 Charles Proxy 应该能在 Ubuntu 24.04 的任务栏中正确显示图标并被识别了。

-- 感谢阅读 --