Prerrequisitoseditar
Necesitas Nix con flakes y nix-command habilitados.
En NixOS, añade lo siguiente a tu configuration.nix:
nix.settings.experimental-features = [ "nix-command" "flakes" ];En otras distribuciones, agrega estas líneas a /etc/nix/nix.conf (o ~/.config/nix/nix.conf):
experimental-features = nix-command flakesReinicia el daemon de Nix si es necesario y verifica que los comandos de flake funcionen:
nix --version
nix flake show github:CubicLauncherDevs/CubicLauncherInstalar con Nix Flakes, sin configurar Cachixeditar
CubicLauncher publica paquetes para Linux x86_64 y ARM64. Nix descarga el binario de Cachix si está disponible; si no, lo compila localmente.
Estos comandos usan el flake directamente. Si no tienes una caché binaria configurada, Nix compilará el paquete en tu equipo.
Instala el canal que prefieras:
Última versión estableeditar
nix profile add github:CubicLauncherDevs/CubicLauncher/latest-releaseÚltima betaeditar
nix profile add github:CubicLauncherDevs/CubicLauncher/latest-betaEl binario quedará disponible como cubiclauncher en tu PATH.
Elegir una versión específicaeditar
Reemplaza TAG por el tag de una versión publicada en GitHub Releases:
nix profile add github:CubicLauncherDevs/CubicLauncher/TAGOpcional: descargar binarios precompilados con Cachixeditar
Configura la caché pública una vez:
nix run nixpkgs#cachix -- use cubiclauncherUna vez configurada, la caché permite descargar los binarios publicados si hay un build para tu revisión y arquitectura.
Usar CubicLauncher desde tu flake de NixOSeditar
Añade CubicLauncher como input del flake y pásalo a un módulo de NixOS. Para usar la beta, cambia latest-release por latest-beta.
{
inputs = {
nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
cubiclauncher.url = "github:CubicLauncherDevs/CubicLauncher/latest-release";
};
outputs = { nixpkgs, cubiclauncher, ... }: {
nixosConfigurations.mi-host = nixpkgs.lib.nixosSystem {
system = "x86_64-linux";
modules = [
./configuration.nix
({ pkgs, ... }: {
environment.systemPackages = [
cubiclauncher.packages.${pkgs.system}.default
];
})
];
};
};
}Activar Cachix en NixOSeditar
Añade la caché y su clave pública a tu configuración de NixOS:
nix.settings = {
extra-substituters = [ "https://cubiclauncher.cachix.org" ];
extra-trusted-public-keys = [
"cubiclauncher.cachix.org-1:tBeOuLW/CLlkYAH0AB+DNio4XNZOGVMHvQHVuQSqhcA="
];
};Aplica la configuración y luego instala CubicLauncher con uno de los comandos de perfil anteriores:
sudo nixos-rebuild switch
nix profile add github:CubicLauncherDevs/CubicLauncher/latest-releaseLa caché del proyecto ofrece builds para Linux x86_64 y ARM64. En otras plataformas Nix puede compilar el paquete localmente.
Ejecutar sin instalareditar
Puedes ejecutar CubicLauncher directamente desde el flake sin instalarlo:
nix run github:CubicLauncherDevs/CubicLauncher/latest-releaseBuild localeditar
También puedes construir el paquete manualmente:
nix build .
ls -la result/binEl binario compilado estará en result/bin/cubiclauncher.
Entorno de desarrolloeditar
Si quieres contribuir o desarrollar CubicLauncher, el flake incluye un devShell con todas las dependencias necesarias:
nix develop
bun install
bun run tauri devEl entorno incluye bun, rustc, cargo, cargo-tauri, GTK3, WebKitGTK, GStreamer, entre otras herramientas.
En Linux, el devShell fija Mesa, EGL, GBM y Wayland a la misma revisión de Nixpkgs que la glibc del compilador (fijada en flake.lock) y detecta automáticamente NVIDIA con Wayland. Puedes forzar o desactivar el renderizado por software de WebKitGTK con CUBICLAUNCHER_WEBKIT_SOFTWARE=1 o CUBICLAUNCHER_WEBKIT_SOFTWARE=0.
Con NVIDIA propietario, si los controladores del sistema requieren una glibc más nueva, usa el Nixpkgs del sistema en el entorno de desarrollo:
nix develop --override-input nixpkgs nixpkgs --no-write-lock-fileConsulta la guía de desarrollo para más detalles.
Actualizareditar
Si instalaste desde un canal, actualiza conservándolo. Consulta el nombre de la entrada y actualízala:
nix profile list
nix profile upgrade --refresh <nombre>También puedes reinstalar para reemplazar la versión actual:
nix profile add github:CubicLauncherDevs/CubicLauncher/latest-releaseDurante el empaquetado para Nix se desactivan los artefactos del auto-actualizador, ya que el launcher debe actualizarse a través de Nix.
Solución de problemaseditar
error: the group 'nixbld' specified in 'build-users-group' does not existeditar
Este error ocurre cuando Nix está instalado en modo multi-usuario pero el grupo nixbld que usa el daemon para los builds no existe. Para corregirlo, ejecuta como root el script incluido en el repositorio:
git clone https://github.com/CubicLauncherDevs/CubicLauncher.git
cd CubicLauncher
sudo ./dist/nix/setup-nix-build-users.shLuego reintenta:
nix run github:CubicLauncherDevs/CubicLauncher
# o
nix developEste problema no está relacionado con CubicLauncher; es un error de configuración de la instalación de Nix en tu sistema.
EGL_BAD_PARAMETER al iniciareditar
Este error aparece cuando EGL selecciona el Mesa de /run/opengl-driver, compilado con una glibc distinta a la del flake. El devShell y el paquete instalado fijan Mesa, EGL, GBM y Wayland a la misma revisión de Nixpkgs que la glibc del compilador. Vuelve a entrar al entorno o usa el Nixpkgs del sistema:
nix develop --override-input nixpkgs nixpkgs --no-write-lock-fileEmpaquetado y publicación (mantenedores)
El flake expone el paquete, el devShell, el formateador y un check básico. El empaquetado vive en dist/nix/ (flake.nix, flake.lock y package.nix).
Publicación en Cachix. El workflow .github/workflows/nix-cache.yml compila y publica el paquete para Linux x86_64 y ARM64. Se ejecuta al publicar releases, al terminar el workflow Publish Release y manualmente. Actualiza por separado los tags móviles latest-release y latest-beta.
cargoHash. Cubre el árbol de dependencias de Rust y depende de Cargo.lock y de la revisión de nixpkgs fijada en flake.lock. Al cambiar Cargo.lock, regenéralo así:
nix build --no-link \
".#packages.$(nix eval --raw --impure --expr builtins.currentSystem).default.cargoDeps"Copia el hash de la línea got: en cargoHash de dist/nix/package.nix. Genera siempre con nix build .#... para respetar el flake.lock commiteado.
Otras arquitecturas. Añade el sistema a supportedSystems en flake.nix y el hash de nodeModules correspondiente en dist/nix/package.nix.
Script de builds. Si el daemon multi-usuario no tiene el grupo nixbld, ejecuta sudo ./dist/nix/setup-nix-build-users.sh desde el repositorio.