Update Linux install instructions for actual Continuumatrice CMake target and asset ID

This commit is contained in:
Christian Daniel Jensen 2026-11-02 03:12:51 -07:00
parent 3a96569a0f
commit 22b3f07db8

View file

@ -4,20 +4,20 @@ Continuumatrice is an independent application. You can keep normal upstream **Co
## Binary and build target
The CMake target remains `cockatrice` to avoid breaking its internal dependencies, resource generators, translations, and existing build commands, but on **Linux** the target's output filename is `continuumatrice`.
The CMake client target is now `continuumatrice` on every platform. A compatibility build target named `cockatrice` remains for older automation, but it creates **no executable** with the old name.
```bash
git pull --ff-only origin feature/continuumatrice-zone-bands
cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release -DWITH_CLIENT=ON -DWITH_SERVER=OFF -DWITH_ORACLE=OFF
cmake --build build --target cockatrice --parallel 16
cmake --build build --target continuumatrice --parallel 16
./build/cockatrice/continuumatrice
```
If you previously compiled the fork under the old name, `build/cockatrice/cockatrice` can remain as an **outdated, stale executable** in the build directory. Launch `build/cockatrice/continuumatrice` instead. Do not remove your system's normal `/usr/bin/cockatrice` application.
The renamed executable on Linux installs as `bin/continuumatrice`. The new `continuumatrice.desktop` launcher installs alongside the normal `cockatrice.desktop`. Its application name and desktop-file ID are also `continuumatrice`, so Wayland and desktop launchers distinguish the applications.
The standalone executable on Linux installs as `bin/continuumatrice`. The new `continuumatrice.desktop` launcher installs alongside the normal `cockatrice.desktop`. Its application name and desktop-file ID are also `continuumatrice`, so Wayland and desktop launchers distinguish the applications.
The fork installs its own `continuumatrice.svg` and `continuumatrice.png` **filenames** for icon lookup, currently reusing the existing Cockatrice artwork until a dedicated brand icon is designed. The launcher names are independent even when the graphics resemble one another.
The fork installs its own original `continuumatrice.svg` icon, separate from Cockatrice artwork. The independent desktop launcher and `continuumatrice://` URI scheme do not take ownership of upstream `cockatrice://` links or `.cod` deck associations.
This fork intentionally does **not** install Cockatrice's `cockatrice-cod.xml` MIME handler or register the `cockatrice://` URL scheme in the new Linux desktop file. The normal MTG client keeps its default deck file and URL associations.
@ -50,4 +50,4 @@ For immediate testing, skip installation and run the executable directly from th
## Cross-platform status
This Linux naming change is intentionally scoped to non-Apple Unix. Upstream packaging and installer flows for Windows/macOS still need separate renaming work before those platforms can claim fully isolated installations.
This migration also gives the Windows and macOS application package and URL registrations separate names. Those packaging flows have **not** been validated on Windows or macOS; installers must not be published until installation, upgrade, and uninstall testing demonstrates that neither platform affects upstream Cockatrice.