Saltar al contenido principal

Compilación de Aseprite en CachyOS Linux

1. Requisitos​

Sistema operativo: CachyOS (Arch Linux)
Arquitectura: x86_64
Compilador: GCC o Clang
Sistema de compilación: CMake + Ninja
Backend gráfico: Skia

2. Instalar dependencias​

Actualizar el sistema:

sudo pacman -Syu

Instalar herramientas y bibliotecas:

sudo pacman -S --needed \
base-devel \
git \
cmake \
ninja \
clang \
python \
curl \
unzip \
libx11 \
libxcursor \
libxi \
libxrandr \
mesa \
fontconfig \
freetype2 \
harfbuzz

Verificar las herramientas:

clang++ --version
cmake --version
ninja --version
git --version

3. Descargar el código fuente​

Crear un directorio de trabajo:

mkdir -p ~/Projects
cd ~/Projects

Clonar Aseprite con sus submódulos:

git clone --recursive \
--branch v1.3.18.6 \
https://github.com/aseprite/aseprite.git

cd aseprite

Verificar el repositorio:

git describe --tags --always
git submodule status

Si faltan submódulos:

git submodule update --init --recursive

4. Preparar Skia​

Aseprite utiliza una versión específica de Skia para su backend gráfico.

El repositorio oficial proporciona información sobre las versiones y compilaciones compatibles:

https://github.com/aseprite/skia

Consultar también las instrucciones de la versión seleccionada de Aseprite:

https://github.com/aseprite/aseprite/blob/main/INSTALL.md

Crear el directorio de dependencias:

mkdir -p ~/Projects/aseprite/deps
cd ~/Projects/aseprite/deps

Descargar y extraer la versión de Skia para Linux x64 indicada por las instrucciones oficiales.

curl -fL \
-o skia-linux.zip \
"https://github.com/aseprite/skia/releases/download/m124-08a5439a6b/Skia-Linux-Release-x64.zip"

Descomprimir skia:

unzip skia-linux.zip -d ./skia

Comprobar que se haya extraído correctamente:

ls -lh ./skia/out/Release-x64/libskia.a

Importante: no utilizar arbitrariamente la última versión de Skia. Debe ser compatible con la versión de Aseprite que vamos a compilar.

5. Configurar CMake​

Crear el directorio de compilación:

cd ~/Projects/aseprite
mkdir -p build
cd build

Configurar las rutas:

export SKIA_DIR="$HOME/Projects/aseprite/deps/skia"
export SKIA_LIBRARY_DIR="$SKIA_DIR/out/Release-x64"

Generar la configuración de compilación:

cmake \
-DCMAKE_BUILD_TYPE=RelWithDebInfo \
-DCMAKE_C_COMPILER=clang \
-DCMAKE_CXX_COMPILER=clang++ \
-DLAF_BACKEND=skia \
-DSKIA_DIR="$SKIA_DIR" \
-DSKIA_LIBRARY_DIR="$SKIA_LIBRARY_DIR" \
-DSKIA_LIBRARY="$SKIA_LIBRARY_DIR/libskia.a" \
-G Ninja \
..

Si CMake finaliza correctamente, generará los archivos necesarios para Ninja.

6. Compilar Aseprite​

Desde el directorio build:

ninja aseprite

También se puede utilizar:

cmake --build . --target aseprite --parallel 4

El valor 4 controla el número de trabajos simultáneos. Puede ajustarse según la memoria y los núcleos disponibles.

7. Ejecutar Aseprite​

Si la compilación termina correctamente:

cd ~/Projects/aseprite/build/bin
./aseprite

Comprobar que el ejecutable existe:

file ./aseprite

El resultado debería identificar un ejecutable ELF para Linux x86_64.

8. Crear un lanzador en KDE Plasma​

Para integrar Aseprite en el menú de aplicaciones de CachyOS, crear un archivo .desktop:

Primero creamos un directorio en /opt para Aseprite en donde copiaremos el directorio build:

sudo mkdir -p /opt/aseprite
sudo cp -rv ~/Projects/aseprite/build /opt/aseprite/
nvim ~/.local/share/applications/aseprite.desktop

Agregar el siguiente contenido, sustituyendo USUARIO por el nombre real de tu usuario:

[Desktop Entry]
Type=Application
Name=Aseprite
Comment=Pixel art and sprite animation editor
Exec=/opt/aseprite/build/bin/aseprite
Icon=aseprite
Terminal=false
Categories=Graphics;2DGraphics;RasterGraphics;
StartupNotify=true

Para el icono:

cp -v ~/Projects/aseprite/data/icons/ase256.png ~/.local/share/icons/hicolor/256x256/apps/aseprite.png

Actualizar la caché de aplicaciones de KDE:

kbuildsycoca6

Aseprite debería aparecer en el lanzador de aplicaciones de Plasma.

9. Verificaciones​

  • CMake configura el proyecto sin errores.
  • Ninja completa la compilación.
  • El ejecutable inicia correctamente.
  • Se puede crear un sprite.
  • Las herramientas de dibujo funcionan.
  • Se pueden crear animaciones.
  • Se puede guardar un archivo .aseprite.
  • Se pueden exportar imágenes PNG.
  • El lanzador aparece en KDE Plasma.

10. Solución de problemas​

Error: libskia.a no existe​

Comprobar la ruta:

ls -lh "$SKIA_LIBRARY_DIR/libskia.a"

Si el archivo no existe, revisar la extracción y versión de Skia.

Error: CMakeCache.txt incompatible​

Si se modificaron compiladores o rutas importantes, limpiar la configuración anterior:

cd ~/Projects/aseprite
rm -rf build
mkdir build
cd build

Volver a ejecutar la configuración de CMake.

No eliminar build si contiene archivos propios que deban conservarse.

Error: dependencias faltantes​

Revisar los mensajes de CMake para identificar bibliotecas ausentes y comprobar su disponibilidad:

pacman -Ss nombre-paquete

Error: bibliotecas compartidas faltantes​

Inspeccionar las dependencias dinámicas del ejecutable:

ldd ~/Projects/aseprite/build/bin/aseprite

Buscar entradas marcadas como not found.

11. Referencias​

Estado: Procedimiento pendiente de validación en CachyOS.