mirror of https://github.com/farion1231/cc-switch.git synced 2026-01-24 14:33:08 +08:00

Files

Jason b7fd70075c fix(flatpak): remove --enable-tests=no to fix HAVE_VALGRIND error

libdbusmenu's configure.ac has a bug where AM_CONDITIONAL([HAVE_VALGRIND])
is only defined when tests are enabled. Removing --enable-tests=no allows
the conditional to be properly defined.

Ref: https://bugs.launchpad.net/ubuntu/+source/libdbusmenu/+bug/1708938

2026-01-09 21:47:59 +08:00

com.ccswitch.desktop.desktop

feat(release): add RPM and Flatpak packaging support for Linux

2026-01-05 16:35:36 +08:00

com.ccswitch.desktop.metainfo.xml

feat(release): add RPM and Flatpak packaging support for Linux

2026-01-05 16:35:36 +08:00

com.ccswitch.desktop.yml

fix(flatpak): remove --enable-tests=no to fix HAVE_VALGRIND error

2026-01-09 21:47:59 +08:00

README.md

feat(release): add RPM and Flatpak packaging support for Linux

2026-01-05 16:35:36 +08:00

README.md

Flatpak Build Guide

This directory contains the Flatpak manifest (com.ccswitch.desktop) for CC Switch, used to convert the generated .deb artifact into an installable .flatpak package via CI or local builds.

Dependencies

flatpak
flatpak-builder
Flathub remote (for installing org.gnome.Platform//46 runtime)

For Ubuntu/Debian:

sudo apt install flatpak flatpak-builder
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak install -y --user flathub org.gnome.Platform//46 org.gnome.Sdk//46

Local Build (Generate .flatpak from .deb)

Build the deb on Linux first:

pnpm tauri build -- --bundles deb

Copy the generated deb to this directory:

cp "$(find src-tauri/target/release/bundle -name '*.deb' | head -n 1)" flatpak/cc-switch.deb

Build the local Flatpak repository and export the .flatpak:

flatpak-builder --force-clean --user --disable-cache --repo flatpak-repo flatpak-build flatpak/com.ccswitch.desktop.yml
flatpak build-bundle --runtime-repo=https://flathub.org/repo/flathub.flatpakrepo flatpak-repo CC-Switch-Linux.flatpak com.ccswitch.desktop

Install and run:

flatpak install --user ./CC-Switch-Linux.flatpak
flatpak run com.ccswitch.desktop

Permissions Note

The current manifest uses --filesystem=home by default for "download and run" convenience, allowing the app to directly read/write CLI configuration files and app data on the host (and supporting the "directory override" feature).

If you prefer minimal permissions (e.g., for Flathub submission or security concerns), you can replace --filesystem=home in flatpak/com.ccswitch.desktop.yml with more precise grants:

  - --filesystem=~/.cc-switch:create
  - --filesystem=~/.claude:create
  - --filesystem=~/.claude.json
  - --filesystem=~/.codex:create
  - --filesystem=~/.gemini:create

Note: Flatpak's :create modifier only works with directories, not files. Therefore, ~/.claude.json cannot use :create. If this file doesn't exist on the user's machine, the app may not be able to create it with restricted permissions. Users should either run Claude Code once to generate it, or manually create an empty JSON file (content: {}).

If you plan to publish on Flathub or want stricter permission control, adjust the finish-args in flatpak/com.ccswitch.desktop.yml accordingly.