Instalación en Arch Linux | CubicLauncher
Arch Linux
Instalación
En Arch Linux se recomienda compilar CubicLauncher localmente utilizando el PKGBUILD oficial. No es necesario clonar el repositorio completo ni instalar dependencias manualmente: el propio PKGBUILD descarga el código fuente y makepkg se encarga de resolver e instalar las dependencias necesarias.
Arch Linux es una distribución rolling release, por lo que las versiones de bibliotecas y dependencias cambian con frecuencia.
Los binarios generados por GitHub Actions (Ubuntu) pueden presentar incompatibilidades o fallar al ejecutarse en sistemas Arch actualizados.
Compilar el programa en tu propio sistema garantiza la compatibilidad con las bibliotecas instaladas y permite obtener un paquete adaptado a tu entorno.
mkdir cubiclauncher-build
cd cubiclauncher-build
wget https://raw.githubusercontent.com/CubicLauncherDevs/CubicLauncher/main/dist/arch/PKGBUILD
makepkg -si
Actualizar a una nueva versión
Cuando se publique una nueva versión de CubicLauncher, puedes actualizar el paquete compilado localmente sin necesidad de volver a descargar el PKGBUILD desde cero.
Accede al directorio donde descargaste el PKGBUILD, edita el archivo y cambia el valor de pkgver por la nueva versión:
cd cubiclauncher-build
nano PKGBUILD
Busca la línea pkgver= y actualízala. Luego actualiza los checksums automáticamente con updpkgsums:
updpkgsums
Finalmente, recompila e instala el paquete actualizado:
makepkg -si
updpkgsums pertenece al paquete pacman-contrib. Si no lo tienes instalado, puedes obtenerlo con sudo pacman -S pacman-contrib.
La auto-actualización no funciona en Arch
CubicLauncher incluye un mecanismo de auto-actualización integrado que descarga el binario más reciente desde GitHub Releases y reemplaza el ejecutable actual. En Arch Linux este mecanismo no funciona y no se puede solucionar, por las siguientes razones:
Permisos del sistema: Al instalar mediante
makepkg -si, el binario se copia a/usr/bin/cubiclaunchercon permisos de root (root:root). El usuario normal no tiene permisos de escritura sobre/usr/bin, por lo que el auto-updater no puede sobrescribir el archivo.Incompatibilidad de binarios: Aunque se ejecutara el auto-updater como root, los binarios precompilados de GitHub Actions están vinculados contra las bibliotecas de Ubuntu, lo que puede generar fallos en Arch.
Filosofía de Arch: En Arch Linux la forma correcta de actualizar cualquier programa es a través de
pacman. Usar auto-actualizadores externos bypassa el gestor de paquetes, dejando el sistema en un estado inconsistente (pacman no sabrá que el binario fue reemplazado).
Problemas comunes
Error al descargar dependencias (404)
Si durante la instalación aparecen errores similares a los siguientes:
error: failed retrieving file 'gst-plugins-good-*.pkg.tar.zst'
error: failed retrieving file 'gst-plugins-bad-*.pkg.tar.zst'
error: failed to commit transaction (failed to retrieve some files)
Es probable que alguno de los mirrors configurados en tu sistema esté desactualizado. Antes de volver a ejecutar makepkg, actualiza la base de datos de paquetes y sincroniza el sistema:
sudo pacman -Syu
Si el problema persiste, actualiza tu lista de mirrors o prueba con otros mirrors más recientes:
sudo pacman -S reflector
sudo reflector --latest 20 --sort rate --save /etc/pacman.d/mirrorlist
sudo pacman -Syyu
Una vez actualizado el sistema, vuelve a ejecutar:
makepkg -si