Cargando

Cargando...

Saltar al contenido
CubicLauncherDocs

Instalación en Arch Linux

CubicLauncher está disponible en el AUR (Arch User Repository). Puedes instalarlo con tu asistente de AUR preferido.

Instalacióneditar

CubicLauncher está disponible en el AUR (Arch User Repository). Podés instalarlo con tu asistente de AUR preferido o compilar el paquete oficial desde el PKGBUILD.

Desde el AUReditar

bash
yay -S cubiclauncher
bash
paru -S cubiclauncher

Si no tienes yay o paru instalados, consulta su documentación:

También puedes consultar el paquete en: https://aur.archlinux.org/packages/cubiclauncher

El paquete del AUR no recibe actualizaciones

El paquete cubiclauncher sigue publicado en el AUR, pero por ahora no podemos actualizarlo, así que no recibirá las versiones nuevas de CubicLauncher. Instalar o actualizar con yay -S cubiclauncher o paru -S cubiclauncher te dará la última versión publicada en el AUR, pero no las más recientes.

Para mantenerte al día, recompilá el PKGBUILD oficial: editá la línea pkgver=, corré updpkgsums y luego makepkg -si. Ver Actualizar CubicLauncher.

Compilando el PKGBUILDeditar

Si prefieres compilar manualmente, puedes utilizar 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.

La compilación local es opcional.

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.

bash
mkdir cubiclauncher-build
cd cubiclauncher-build

wget https://raw.githubusercontent.com/CubicLauncherDevs/CubicLauncher/main/dist/arch/PKGBUILD
makepkg -si

Actualizar CubicLaunchereditar

El paquete del AUR no se actualiza, así que para pasar a una versión nueva hay que recompilar el PKGBUILD. Si ya lo descargaste, no hace falta volver a bajarlo desde cero.

Accede al directorio donde descargaste el PKGBUILD, edita el archivo y cambia el valor de pkgver por la nueva versión:

bash
cd cubiclauncher-build
nano PKGBUILD

Busca la línea pkgver= y actualízala. Luego actualiza los checksums automáticamente con updpkgsums:

bash
updpkgsums

Finalmente, recompila e instala el paquete actualizado:

bash
makepkg -si
NOTA

El comando 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 Archeditar

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:

  1. Permisos del sistema: Al instalar mediante makepkg -si, el binario se copia a /usr/bin/cubiclauncher con 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.

  2. 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.

  3. 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 comuneseditar

NVIDIA y Wayland: problemas gráficoseditar

Si CubicLauncher abre una ventana vacía, parpadea o se cierra al redimensionar, consultá Problemas gráficos en Linux: NVIDIA y Wayland. Incluye el ajuste WEBKIT_DISABLE_COMPOSITING_MODE=1 cubiclauncher, alternativas menos restrictivas y la comprobación de KMS. Compilar localmente no garantiza resolver estos fallos de renderizado.

Error al descargar dependencias (404)editar

Si durante la instalación aparecen errores similares a los siguientes:

text
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:

bash
sudo pacman -Syu

Si el problema persiste, actualiza tu lista de mirrors o prueba con otros mirrors más recientes:

bash
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:

bash
makepkg -si
AVISO

Este error no está relacionado con CubicLauncher ni con el PKGBUILD; ocurre cuando un mirror de Arch Linux todavía no ha sincronizado los paquetes más recientes.