Electron应用打包Flatpak：图标与文件关联问题咨询

当前配置 #

1. package.json中的Flatpak配置 #

"flatpak": {
  "branch": "stable",
  "runtime": "org.freedesktop.Platform",
  "runtimeVersion": "23.08",
  "sdk": "org.freedesktop.Sdk",
  "base": "org.electronjs.Electron2.BaseApp",
  "baseVersion": "23.08",
  "finishArgs": [
    "--share=network",
    "--share=ipc",
    "--socket=x11",
    "--socket=wayland",
    "--socket=pulseaudio",
    "--device=dri",
    "--talk-name=org.freedesktop.Notifications",
    "--talk-name=org.freedesktop.secrets",
    "--filesystem=home"
  ],
  "desktop": {
    "Name": "Grist",
    "Comment": "Spreadsheet software to end data chaos",
    "Icon": "com.getgrist.desktop",
    "Categories": ["Office"],
    "MimeType": "application/x-grist;text/csv;text/tab-separated-values;text/plain;application/vnd.openxmlformats-officedocument.spreadsheetml.sheet;application/vnd.ms-excel.sheet.macroEnabled.12;"
  },
  "mimeTypes": [
    "application/x-grist",
    "text/csv",
    "text/tab-separated-values",
    "text/plain",
    "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
    "application/vnd.ms-excel.sheet.macroEnabled.12"
  ],
  "files": [
    ["dist/icons/16x16.png", "/app/share/icons/hicolor/16x16/apps/com.getgrist.desktop.png"],
    ["dist/icons/32x32.png", "/app/share/icons/hicolor/32x32/apps/com.getgrist.desktop.png"],
    ["dist/icons/48x48.png", "/app/share/icons/hicolor/48x48/apps/com.getgrist.desktop.png"],
    ["dist/icons/64x64.png", "/app/share/icons/hicolor/64x64/apps/com.getgrist.desktop.png"],
    ["dist/icons/128x128.png", "/app/share/icons/hicolor/128x128/apps/com.getgrist.desktop.png"],
    ["dist/icons/256x256.png", "/app/share/icons/hicolor/256x256/apps/com.getgrist.desktop.png"],
    ["dist/icons/512x512.png", "/app/share/icons/hicolor/512x512/apps/com.getgrist.desktop.png"],
    ["dist/icons/scalable.svg", "/app/share/icons/hicolor/scalable/apps/com.getgrist.desktop.svg"],
    ["flatpak/mime/com.getgrist.desktop.xml", "/app/share/mime/packages/com.getgrist.desktop.xml"],
    ["core/static/icons/gristdoc.svg", "/app/share/icons/hicolor/scalable/mimetypes/application-x-grist.svg"]
  ]
}

2. 生成的.desktop文件（路径：~/.local/share/flatpak/exports/share/applications/com.getgrist.desktop.desktop） #

[Desktop Entry]
Name=Grist
Exec=/usr/bin/flatpak run --branch=stable --arch=x86_64 --command=electron-wrapper --file-forwarding com.getgrist.desktop @@u %U @@
Terminal=false
Type=Application
Icon=com.getgrist.desktop
StartupWMClass=Grist Desktop
Comment=Grist Desktop
Categories=Development;
MimeType=application/x-grist;text/csv;text/tab-separated-values;text/plain;application/vnd.openxmlformats-officedocument.spreadsheetml.sheet;application/vnd.ms-excel.sheet.macroEnabled.12;application/x-grist;
X-Flatpak=com.getgrist.desktop

存在的问题 #

• 应用菜单中显示通用图标，而非Grist专属图标
• 双击.grist等关联文件无法启动应用

1. 修复应用图标显示问题 #

检查图标完整性与命名 #

• 确认dist/icons/目录下所有尺寸的图标文件都存在，文件名与配置中的路径完全匹配
• 确保图标命名和.desktop文件的Icon=com.getgrist.desktop一致，无拼写错误

添加图标缓存更新脚本 #

在package.json的flatpak配置中加入postInstall命令，强制更新Flatpak环境内的图标缓存：

"flatpak": {
  // ... 现有配置 ...
  "postInstall": [
    "gtk-update-icon-cache -f -t /app/share/icons/hicolor"
  ]
}

验证.desktop文件的Icon字段 #

确保生成的.desktop文件中Icon字段为com.getgrist.desktop，不要使用绝对路径，Flatpak会自动在/app/share/icons/路径下查找。

2. 修复文件关联问题 #

修正Exec命令格式 #

当前Exec命令的--file-forwarding参数格式有误，调整为以下两种正确格式之一：

Exec=/usr/bin/flatpak run --branch=stable --arch=x86_64 --command=electron-wrapper com.getgrist.desktop %U

或者：

Exec=/usr/bin/flatpak run --branch=stable --arch=x86_64 --command=electron-wrapper --file-forwarding com.getgrist.desktop %U @@

注：%U用于传递文件路径，需确保Electron应用代码中通过process.argv接收并处理这些路径。

清理重复的MIME类型 #

在package.json的desktop.MimeType中移除末尾分号和重复的application/x-grist：

"desktop": {
  // ... 现有配置 ...
  "MimeType": "application/x-grist;text/csv;text/tab-separated-values;text/plain;application/vnd.openxmlformats-officedocument.spreadsheetml.sheet;application/vnd.ms-excel.sheet.macroEnabled.12"
}

确保MIME类型定义合规 #

检查flatpak/mime/com.getgrist.desktop.xml文件，确保application/x-grist的定义符合Freedesktop规范，示例如下：

<?xml version="1.0" encoding="UTF-8"?>
<mime-info xmlns="http://www.freedesktop.org/standards/shared-mime-info">
  <mime-type type="application/x-grist">
    <comment>Grist Document</comment>
    <glob pattern="*.grist"/>
    <icon name="application-x-grist"/>
  </mime-type>
</mime-info>

更新MIME数据库 #

扩展postInstall命令，添加MIME数据库更新：

"postInstall": [
  "gtk-update-icon-cache -f -t /app/share/icons/hicolor",
  "update-mime-database /app/share/mime"
]

强制更新系统关联 #

安装Flatpak包后，运行以下命令刷新系统关联：

update-desktop-database ~/.local/share/flatpak/exports/share/applications/
flatpak update --appstream

内容的提问来源于stack exchange，提问作者Wiktor Pyk-Półtorak