Flatpak格式GTK4应用如何获取系统已安装外部应用的图标

Flatpak沙箱内直接调用Gtk.Icon.new_from_icon_name()加载外部应用图标失败，本质是沙箱默认隔离规则导致的：

• 沙箱默认无法读取主机侧.desktop文件数据库，拿不到外部应用和图标名的正确映射关系
• 沙箱内置图标资源池和主机不互通，就算传对了图标名，也找不到对应的图标文件

优先用Gio原生AppInfo接口配合XDG桌面门户实现，兼容所有当前支持的Freedesktop SDK运行时：

• 第一步：先在Flatpak打包清单（json/yaml格式的manifest文件）的finish-args字段中添加基础必要权限：

"finish-args": [
  "--share=ipc",
  "--socket=fallback-x11",
  "--socket=wayland",
  "--socket=session-bus",
  "--talk-name=org.freedesktop.portal.Desktop"
]

• 第二步：应用初始化阶段，把沙箱内挂载的主机图标目录加入Gtk图标主题搜索路径：

# Python 绑定示例
import os
import gi
gi.require_version("Gtk", "4.0")
gi.require_version("Gdk", "4.0")
from gi.repository import Gtk, Gdk

icon_theme = Gtk.IconTheme.get_for_display(Gdk.Display.get_default())
host_icon_dirs = [
    "/run/host/usr/share/icons",
    "/run/host/usr/share/pixmaps",
    "/run/host/var/lib/flatpak/exports/share/icons",
    os.path.expanduser("~/.local/share/flatpak/exports/share/icons")
]
for dir_path in host_icon_dirs:
    if os.path.isdir(dir_path):
        icon_theme.add_search_path(dir_path)

// C 语言示例
GtkIconTheme *theme = gtk_icon_theme_get_default();
const gchar *host_icon_dirs[] = {
    "/run/host/usr/share/icons",
    "/run/host/usr/share/pixmaps",
    "/run/host/var/lib/flatpak/exports/share/icons",
    NULL
};
gchar *local_flatpak_icon_dir = g_build_filename(g_get_home_dir(), ".local/share/flatpak/exports/share/icons", NULL);
for (gint i = 0; host_icon_dirs[i] != NULL; i++) {
    if (g_file_test(host_icon_dirs[i], G_FILE_TEST_IS_DIR)) {
        gtk_icon_theme_add_search_path(theme, host_icon_dirs[i]);
    }
}
if (g_file_test(local_flatpak_icon_dir, G_FILE_TEST_IS_DIR)) {
    gtk_icon_theme_add_search_path(theme, local_flatpak_icon_dir);
}
g_free(local_flatpak_icon_dir);

• 第三步：不要手动调用Gtk.Icon.new_from_icon_name()硬传图标名，先通过Gio.DesktopAppInfo拿到目标应用对应的GIcon对象，直接传给Gtk控件即可：

# 替换成目标应用的desktop文件ID，例如com.google.Chrome.desktop
app_info = Gio.DesktopAppInfo.new("com.google.Chrome.desktop")
if app_info:
    app_icon = app_info.get_icon()
    icon_widget = Gtk.Image.new_from_gicon(app_icon)
    # 按需求设置图标尺寸
    icon_widget.set_pixel_size(48)

如果需要适配22.08以前版本的Freedesktop SDK，XDG门户的图标接口存在兼容问题，可以在finish-args中追加只读权限，直接访问主机侧的应用和图标目录，不需要额外修改业务逻辑代码：

--filesystem=xdg-data/applications:ro
--filesystem=/usr/share/applications:ro
--filesystem=/usr/share/icons:ro
--filesystem=/usr/share/pixmaps:ro
--filesystem=/var/lib/flatpak/exports/share/applications:ro
--filesystem=~/.local/share/flatpak/exports/share/applications:ro

• 不要硬编码图标名或者手动拼接图标路径，不同发行版、不同图标主题下第三方应用的图标命名、存储路径存在差异，直接读取AppInfo返回的GIcon对象是兼容性最高的方式
• 不需要为了读取图标给沙箱开全量文件系统读写权限，只读访问对应目录即可满足需求，符合Flatpak的安全规范
• GTK3环境下只需要替换对应版本的API，核心实现逻辑完全一致

内容的提问来源于stack exchange，提问作者user14288464