增加flatpak build

[antonio0831]

增加一个flatpak build可以在更多distro上运行，也解决了 #651

如果不发布到flathub上面的话，其实我们可以直接用编译好.tar.gz来打包就行

我尝试构建出了一个可以使用的版本（目前没有发现问题）

[antonio0831]

这是manifest:

app-id: top.imsyy.splayer
runtime: org.freedesktop.Platform
runtime-version: '25.08'
sdk: org.freedesktop.Sdk
command: run-splayer-flatpak.sh

finish-args:
  - --share=network
  - --share=ipc
  - --socket=wayland
  - --socket=fallback-x11
  - --socket=pulseaudio
  - --device=dri
  - --filesystem=xdg-run/app/com.discordapp.Discord:create
  - --talk-name=org.kde.StatusNotifierWatcher
  - --talk-name=org.freedesktop.Notifications
  - --own-name=org.mpris.MediaPlayer2.splayer.*

# we need to change TMPDIR because we need to correctly display notifications (with the icons).
modules:
  - name: splayer-binary
    buildsystem: simple
    build-commands:
      - mkdir -p /app/bin
      - mkdir -p /app/share/top.imsyy.splayer
      - cp -r * /app/share/top.imsyy.splayer
      - chmod -R a+rX /app/share/top.imsyy.splayer
      - install -Dm644 top.imsyy.splayer.metainfo.xml /app/share/metainfo/top.imsyy.splayer.metainfo.xml
      - install -Dm644 top.imsyy.splayer.desktop /app/share/applications/top.imsyy.splayer.desktop
      - mkdir /app/share/icons/
      - cp -pRT icons-dir/hicolor /app/share/icons/hicolor
      - chmod -R a+rX /app/share/icons/hicolor
      - ln -s /app/share/top.imsyy.splayer/SPlayer /app/bin/SPlayer
      - |
        echo '#!/bin/sh
        mkdir $XDG_RUNTIME_DIR/app/$FLATPAK_ID/tmp
        export TMPDIR="$XDG_RUNTIME_DIR/app/$FLATPAK_ID/tmp"
        exec /app/share/top.imsyy.splayer/SPlayer --no-sandbox "$@"' > /app/bin/run-splayer-flatpak.sh
      - chmod +x /app/bin/run-splayer-flatpak.sh
    sources:
      - type: archive
        url: https://github.com/imsyy/SPlayer/releases/download/v3.0.0/splayer-3.0.0-x64.tar.gz
        sha256: 6f22b7c5f320f12d798b4fb51c36d1d01ad0f020b65447d7073afd3f774332a8
      - type: file
        path: top.imsyy.splayer.metainfo.xml
      - type: file
        path: top.imsyy.splayer.desktop
      - type: dir
        path: ./icons
        dest: icons-dir

[antonio0831]

主要有两个变化：

1. disable chromium sandbox因为flatpak sandbox会和chromium sandbox冲突
2. 将储存临时文件的位置改到 $XDG_RUNTIME_DIR/app/$FLATPAK_ID/tmp，不然的话因为sandbox的原因歌的图标就没有办法显示

[antonio0831]

声明了以下权限：

• --share=network 访问网络
• --share=ipc electron需要这个
• --socket=wayland 在wayland下运行
• --socket=fallback-x11 如果无法在wayland下运行，则在X11下运行
• --socket=pulseaudio 允许访问pulseaudio socket
• --device=dri GPU加速
• --filesystem=xdg-run/app/com.discordapp.Discord:create splayer有discord显示，所以需要和discord socket沟通
• --talk-name=org.kde.StatusNotifierWatcher 系统托盘
• --talk-name=org.freedesktop.Notifications 显示消息
• --own-name=org.mpris.MediaPlayer2.splayer.* 和媒体控制器沟通

[antonio0831]

这是metainfo:

<?xml version="1.0" encoding="UTF-8"?>
<component type="desktop-application">
  <id>top.imsyy.splayer</id>
  
  <name>SPlayer</name>
  <summary>一个简约的音乐播放器</summary>
  
  <metadata_license>CC-BY-SA-4.0</metadata_license>
  <project_license>AGPL-3.0-only</project_license>
  <url type="homepage">https://splayer.imsyy.top/</url>
  <url type="bugtracker">https://github.com/imsyy/SPlayer/issues</url>
  <url type="contribute">https://github.com/imsyy/SPlayer?tab=contributing-ov-file#contributing-ov-file</url>
  <url type="vcs-browser">https://github.com/imsyy/SPlayer/</url>


  <supports>
    <control>pointing</control>
    <control>keyboard</control>
    <control>touch</control>
  </supports>
  
  <description>
    <p>
      <em>
      </em>This is a community package of SPlayer and not officially supported by imsyy or the SPlayer developers.<em>
    </em>
  </p>
  <p>
    <em>
    </em>This app is only available in Chinese.<em>
  </em>
</p>
<p>
  🎵 A cross-platform music player with Jellyfin / Navidrome / Emby media server support, word-by-word lyrics, desktop &amp; taskbar lyrics, cloud music drive, local library management, audio spectrum visualization and mobile-friendly UI. 简约的跨平台音乐播放器，支持逐字歌词、桌面歌词、任务栏歌词、云盘音乐、本地音乐管理及流媒体播放
</p>
</description>

  <content_rating type="oars-1.1">
    <content_attribute id="social-chat">moderate</content_attribute>
  </content_rating>
<releases>
  <release version="3.0.0" date="2026-02-06">
    <url type="details">https://github.com/imsyy/SPlayer/releases/tag/v3.0.0</url>
    <description>
      <p>此为近期最后一个稳定版本，后续仅会在遭遇重大问题时进行修复
由于历史遗留问题以及 vibe coding 留下的屎山过多，正在尝试对软件进行一次底层重构，敬请期待</p>
    </description>
  </release>
</releases>

<developer id="top.imsyy.splayer">
  <name>imsyy</name>
</developer>
<launchable type="desktop-id">top.imsyy.splayer.desktop</launchable>
<screenshots>
  <screenshot type="default">
    <image>https://github.com/imsyy/SPlayer/blob/dev/screenshots/SPlayer%20-%20%E4%B8%BB%E9%A1%B5%E9%9D%A2.jpg?raw=true</image>
  </screenshot>
  <screenshot>
    <image>https://github.com/imsyy/SPlayer/blob/dev/screenshots/SPlayer%20-%20%E6%92%AD%E6%94%BE%E9%A1%B5%E9%9D%A2.jpg?raw=true</image>
  </screenshot>
  <screenshot>
    <image>https://github.com/imsyy/SPlayer/blob/dev/screenshots/SPlayer%20-%20%E5%8F%91%E7%8E%B0%E9%A1%B5%E9%9D%A2.jpg?raw=true</image>
  </screenshot>
</screenshots>
</component>

[antonio0831]

(不清楚写的对不对，如有不对欢迎指出）

[antonio0831]

这是修改后的.desktop文件：

[Desktop Entry]
Name=SPlayer
Exec=/app/bin/run-splayer-flatpak.sh %U
Terminal=false
Type=Application
Icon=top.imsyy.splayer
StartupWMClass=SPlayer
MimeType=x-scheme-handler/orpheus;
Comment=A minimalist music player
Categories=Audio;Music;AudioVideo;

[antonio0831]

总体来说就是，如果只加一个.flatpak的构建的话，还是相对比较容易的 (我已经用上述文件构建出来了)

[antonio0831]

但是如果要发布到flathub的话，flathub要求从source编译。那就比直接打包编译好的文件麻烦的多了

(我没试着编译因为我太懒了QwQ)

[MoYingJi]

之前确实想搞的，但我是不太了解 flatpak 和 flathub 的（我也很少用），就鸽了很久。现在项目基本算是消极维护了吧，作者也在筹备重构

这个 disscussion 可以留给需要 flatpak 包的人一些帮助吧。或者在自己的 fork 里打包后发布给别人，打包测试成功的话也可以提 PR 看看的，虽然没多少可能合并

不过据我所知，electron-builder 应该也是支持打包 flatpak 的吧。要求从源码编译而且编译过程离线的话可能有点难，要涉及 pnpm 和 cargo 的依赖下载，之前也有 nixos 的人反馈过这个问题（nixos 好像也要求编译过程离线）