Problem: dpkg -i missing dependencies: libwebkit2gtk etc. (Linux install/launch fails) —— Trove problem library

What you will run into

sudo dpkg -i cc-switch.deb reports dependency errors and the package won't configure: cc-switch depends on libwebkit2gtk-4.1-0; however: Package ... not installed. Or the install "succeeds" but double-clicking does nothing.

The reason is simple: the deb is a Tauri desktop app that needs GUI libraries, and dpkg -i does not resolve dependencies for you.

Why this happens

The deb's Depends declares: libayatana-appindicator3-1, libwebkit2gtk-4.1-0, libgtk-3-0 - the Tauri desktop app needs these GUI libraries at runtime.

dpkg -i only installs the package without pulling dependencies, so one missing library fails the whole configuration.

Server/container environments without GUI libraries always hit this.

A deb package's core metadata is its Depends declaration: it states which other packages this package needs at runtime — but declaring a dependency ≠ installing it.

dpkg -i only unpacks, registers and configures the deb; it does not install the dependencies named in Depends (that's apt's job).

When dependencies are missing, dpkg's default policy is fail as a whole: rather than install a package that is "registered but can't run", it errors at the config stage and leaves the half-installed state for you to handle.

That's the fundamental difference between "dpkg reports dependency errors" and "apt install succeeds": apt resolves Depends and installs the dependencies before installing the package.

Tauri desktop apps especially depend on GUI libraries (webkit/gtk), which servers/containers don't ship by default, so you always hit it.

Three deterministic conclusions: self-check before installing (dpkg-deb -I to read Depends; install what's missing first); in a GUI-less environment use AppImage (self-contained, doesn't touch system libraries);

a half-install isn't scary (dpkg -r cleans the half-installed state with zero leftovers).

Step by step

1. Install the dependencies — Required

sudo apt install -f

Or let apt handle it directly: sudo apt install ./cc-switch.deb (apt pulls dependencies automatically - recommended).

2. No root / don't want GUI dependencies — Required

Use the official AppImage asset: no install, self-contained, doesn't touch system libraries.

3. Self-check before installing — Required

dpkg-deb -I cc-switch.deb | grep Depends

Look at the Depends line, install the missing libraries first, then dpkg -i.

How to confirm it works

cc-switch --version && cc-switch

The command works and the GUI starts = success. Measured: config succeeded after installing dependencies; without GUI libraries the dependency error reproduced (exit=1), and dpkg -r cleaned the half-installed state with zero leftovers.

Other environments

Symptom

sudo dpkg -i cc-switch.deb reports dependency errors and the package cannot be configured:

dpkg: dependency problems prevent configuration of cc-switch:
 cc-switch depends on libayatana-appindicator3-1; however: Package ... not installed.
 cc-switch depends on libwebkit2gtk-4.1-0; however: Package ... not installed.
dpkg: error processing package cc-switch (--install): dependency problems - leaving unconfigured

Or the install succeeds but double-clicking does nothing (missing runtime libraries).

Cause

The deb's Depends: libayatana-appindicator3-1, libwebkit2gtk-4.1-0, libgtk-3-0 (a Tauri desktop app needs GUI libraries); dpkg -i does not resolve dependencies, so one missing library fails the whole configuration.

Solution

1. Install dependencies: sudo apt install -f (or sudo apt install ./cc-switch.deb, apt pulls dependencies automatically).
2. Don't want GUI dependencies / no root: use the official AppImage asset (no install, self-contained).
3. Self-check before installing: dpkg-deb -I cc-switch.deb to see the Depends line and pre-install missing libraries.