Saltar al contenido principal

Compilar Aseprite desde el código fuente

1. Introducción​

Aseprite es un editor de pixel art y animaciones 2D cuyo código fuente está disponible públicamente en GitHub.

Esta guía describe cómo preparar un entorno de desarrollo y compilar Aseprite para Windows a partir de su repositorio oficial.

Entorno utilizado​

ComponenteConfiguración
Sistema anfitriónCachyOS Linux
VirtualizaciónQEMU/KVM
Sistema invitadoWindows 10 x64
IDE y compiladorVisual Studio Community 2022
ToolchainMSVC v143
Windows SDK10.0.26100.7705
Build systemCMake + Ninja
Biblioteca gráficaSkia
Control de versionesGit

:::caution Compatibilidad La documentación oficial de Aseprite utiliza Windows 11 como plataforma de referencia. Nuestra máquina virtual utiliza Windows 10, por lo que esta configuración debe considerarse experimental hasta completar la compilación y las pruebas. :::


2. Requisitos​

2.1 Recursos recomendados​

Para la máquina virtual:

  • Arquitectura x64.
  • 4 vCPU o más.
  • 8 GB de RAM recomendados.
  • 25–40 GB de almacenamiento libre.
  • Conexión a Internet.

2.2 Herramientas​

HerramientaDescarga
Visual Studio Community 2022Instalador oficial
GitGit for Windows
CMakeCMake
NinjaNinja Releases
AsepriteRepositorio oficial

3. Instalar Visual Studio 2022​

Ejecutar el instalador de Visual Studio Community 2022.

3.1 Workloads​

Seleccionar:

  • Desktop development with C++

No es necesario instalar workloads de .NET, Python, Azure o Unity.

3.2 Componentes individuales​

Verificar que estén seleccionados:

  • MSVC v143 - VS 2022 C++ x64/x86 Build Tools.
  • C++ core desktop features.
  • C++ CMake tools for Windows.
  • Windows SDK 10.0.26100.7705.

C++ Build Insights puede mantenerse instalado, aunque no es imprescindible.

3.3 Componentes opcionales innecesarios​

Para esta compilación podemos omitir:

  • C++ ATL y MFC.
  • Just-In-Time Debugger.
  • C++ Profiling Tools.
  • Boost.Test Adapter.
  • Google Test Adapter.
  • IntelliCode.
  • AddressSanitizer.
  • vcpkg.
  • GitHub Copilot.

Una vez seleccionados los componentes, ejecutar la instalación.


4. Preparar la terminal de compilación​

Desde el menú Inicio, buscar y abrir:

x64 Native Tools Command Prompt for VS 2022

Esta terminal inicializa las variables de entorno del compilador MSVC.

Como alternativa, desde CMD:

call "C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\Tools\VsDevCmd.bat" -arch=x64

4.1 Verificar el compilador​

cl

El resultado debe identificar Microsoft C/C++ Optimizing Compiler para x64.

Es normal que aparezca un mensaje indicando que no se proporcionaron archivos fuente.

4.2 Verificar CMake​

cmake --version

4.3 Verificar Ninja​

ninja --version

4.4 Verificar Git​

git --version
consejo

Si alguno de estos comandos no se reconoce, revisar su instalación y las variables de entorno PATH antes de continuar.


5. Descargar el código fuente​

Abrir la terminal de desarrollo y situarse en la raíz de la unidad C:

cd /d C:\

Clonar el repositorio junto con sus submódulos:

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

Utilizamos v1.3.18.6 como versión de referencia del procedimiento. Antes de compilar, debemos confirmar que la etiqueta existe y que el script de compilación de esa versión admite las herramientas instaladas.

Acceder al proyecto:

cd /d C:\aseprite

5.1 Verificar el repositorio​

git status
git describe --tags --always

Comprobar los submódulos:

git submodule status

Si falta alguno, ejecutar:

git submodule update --init --recursive

6. Compilación automática​

Aseprite proporciona un script de compilación para Windows que facilita la configuración del entorno y las dependencias.

6.1 Verificar el script​

Desde la raíz del proyecto:

cd /d C:\aseprite
dir build.cmd

Si existe, podemos continuar con el procedimiento automático.

6.2 Ejecutar la compilación​

build.cmd

El script puede solicitar configuraciones adicionales y gestionar la descarga o preparación de dependencias, incluida Skia, dependiendo de la versión del repositorio.

Seguir las instrucciones que aparezcan en pantalla.

aviso

La primera compilación puede tardar considerablemente, especialmente dentro de una máquina virtual. No interrumpir el proceso mientras continúe trabajando.


7. Compilación manual (alternativa)​

Si el script automático no funciona, podemos utilizar CMake y Ninja directamente.

Este método requiere disponer previamente de una compilación compatible de Skia.

7.1 Preparar Skia​

Consultar las dependencias oficiales:

https://github.com/aseprite/skia

Para este ejemplo se supone que Skia está disponible en:

C:\deps\skia

La versión y la compilación de Skia deben corresponder a los requisitos de la versión de Aseprite seleccionada.

7.2 Crear el directorio de compilación​

cd /d C:\aseprite
mkdir build
cd build

7.3 Configurar CMake​

cmake ^
-DCMAKE_BUILD_TYPE=RelWithDebInfo ^
-DLAF_BACKEND=skia ^
-DSKIA_DIR=C:\deps\skia ^
-DSKIA_LIBRARY_DIR=C:\deps\skia\out\Release-x64 ^
-DSKIA_LIBRARY=C:\deps\skia\out\Release-x64\skia.lib ^
-G Ninja ^
..
información

Las rutas de Skia son ejemplos basados en la estructura utilizada por la documentación oficial. Deben ajustarse a la ubicación real de la biblioteca.

7.4 Compilar con Ninja​

ninja aseprite

Ninja procesará las instrucciones generadas por CMake y compilará el proyecto utilizando MSVC.


8. Ejecutar Aseprite​

Si la compilación termina correctamente, el ejecutable normalmente estará ubicado en:

C:\aseprite\build\bin\aseprite.exe

Ejecutarlo desde CMD:

cd /d C:\aseprite\build\bin
aseprite.exe

Validaciones​

  • El ejecutable existe.
  • La aplicación inicia sin errores.
  • Se puede crear un sprite.
  • Las herramientas de dibujo funcionan.
  • Se pueden crear animaciones.
  • Se puede guardar un archivo .aseprite.
  • Se puede exportar una imagen PNG.
  • Se puede exportar un spritesheet.

9. Solución de problemas​

9.1 cl no se reconoce​

Causa probable: la terminal no tiene inicializado el entorno MSVC.

Solución: abrir x64 Native Tools Command Prompt for VS 2022 y volver a ejecutar:

cl

9.2 cmake no se reconoce​

Causa probable: CMake no está instalado o no se encuentra en el PATH.

Solución: comprobar su instalación y agregar su directorio bin a las variables de entorno.

9.3 ninja no se reconoce​

Causa probable: Ninja no está instalado o su ubicación no está registrada en el PATH.

Solución: instalar Ninja y verificar:

where ninja

9.4 Errores relacionados con Skia​

Posibles causas:

  • Versión incompatible.
  • Biblioteca incompleta.
  • Arquitectura incorrecta.
  • Rutas mal configuradas.

Solución: comprobar la versión requerida por Aseprite y revisar las variables SKIA_DIR, SKIA_LIBRARY_DIR y SKIA_LIBRARY.

9.5 CMake detecta MinGW​

Aseprite no admite oficialmente MinGW para su compilación en Windows.

Comprobar el compilador:

where cl
where gcc

Utilizar MSVC y configurar nuevamente el directorio de compilación si CMake había seleccionado un compilador incorrecto.


10. Licencia y distribución​

Aseprite publica su código fuente bajo una licencia propia.

Se permite compilar el programa y utilizarlo para crear recursos gráficos, incluso para proyectos comerciales, conforme a sus términos.

Sin embargo, la disponibilidad pública del código fuente no autoriza la redistribución de compilaciones modificadas o no modificadas del editor.

Consultar siempre la licencia oficial antes de distribuir cualquier compilación.


11. Referencias​


12. Registro del procedimiento​

EtapaEstado
Preparación de VM Windows 10Completada
Selección de Visual Studio 2022Completada
Instalación de herramientasReportada como completada
Verificación de versionesPendiente de confirmar
Clonación de AsepritePendiente de confirmar
Preparación de SkiaPendiente
CompilaciónPendiente de confirmar
Pruebas del ejecutablePendiente

Documento: Guía de compilación de Aseprite
Versión: 1.0
Última revisión: 2026-10-31