summaryrefslogtreecommitdiff
path: root/archived/projt-launcher/docs/handbook/linux-packaging.md
diff options
context:
space:
mode:
Diffstat (limited to 'archived/projt-launcher/docs/handbook/linux-packaging.md')
-rw-r--r--archived/projt-launcher/docs/handbook/linux-packaging.md121
1 files changed, 121 insertions, 0 deletions
diff --git a/archived/projt-launcher/docs/handbook/linux-packaging.md b/archived/projt-launcher/docs/handbook/linux-packaging.md
new file mode 100644
index 0000000000..728034683f
--- /dev/null
+++ b/archived/projt-launcher/docs/handbook/linux-packaging.md
@@ -0,0 +1,121 @@
+# Linux Packaging
+
+> **Location**: `docs/packaging/os-specific/linux/`
+> **Platforms**: Nix, Flatpak, distribution packages
+> **Latest Version**: 0.0.5-1
+
+---
+
+## Overview
+
+ProjT Launcher supports multiple Linux packaging formats to reach different user bases and distribution requirements.
+
+---
+
+## Packaging Formats
+
+### Nix / NixOS
+
+The recommended method for reproducible builds.
+
+**Location**: `nix/`, `flake.nix`
+
+```sh
+# Build
+nix build .#projtlauncher
+
+# Run without installing
+nix run .#projtlauncher
+
+# Development shell
+nix develop
+```
+
+See [nix.md](./nix.md) for detailed instructions.
+
+### Flatpak
+
+Sandboxed application format.
+
+**Location**: `docs/packaging/os-specific/linux/flathub/`
+
+The Flatpak manifest is maintained separately for Flathub submission.
+
+### Distribution Packages
+
+ProjT Launcher is packaged for various distributions:
+
+| Distribution | Package | Status |
+|--------------|---------|--------|
+| Arch Linux (AUR) | `projtlauncher` | Community |
+| Fedora COPR | `projtlauncher` | Community |
+| openSUSE OBS | `projtlauncher` | Community |
+
+Check [Repology](https://repology.org/project/projtlauncher/versions) for current availability.
+
+---
+
+## Building for Distribution
+
+### Requirements
+
+- CMake 3.22+
+- Qt 6.x
+- C++20 compiler
+- Ninja (recommended)
+
+### Build Commands
+
+```sh
+cmake -B build \
+ -DCMAKE_BUILD_TYPE=Release \
+ -DCMAKE_INSTALL_PREFIX=/usr \
+ -DLauncher_BUILD_PLATFORM=linux
+cmake --build build
+DESTDIR="$pkgdir" cmake --install build
+```
+
+### Platform Identifier
+
+Set `Launcher_BUILD_PLATFORM` to identify your distribution:
+
+```cmake
+-DLauncher_BUILD_PLATFORM=archlinux
+-DLauncher_BUILD_PLATFORM=fedora
+-DLauncher_BUILD_PLATFORM=flatpak
+```
+
+---
+
+## Desktop Integration
+
+### Desktop File
+
+Installed to `/usr/share/applications/`:
+
+```
+org.projecttick.ProjTLauncher.desktop
+```
+
+### Icon
+
+Installed to `/usr/share/icons/hicolor/`:
+
+```
+org.projecttick.ProjTLauncher.svg
+```
+
+### AppStream Metadata
+
+Installed to `/usr/share/metainfo/`:
+
+```
+org.projecttick.ProjTLauncher.metainfo.xml
+```
+
+---
+
+## Related Documentation
+
+- [Nix Packaging](./nix.md)
+- [Program Info](./program_info.md) - Branding configuration