Aseprite-Build-Script

Created by Chasnah

A customizable, automated Windows batch script for easily compiling Aseprite

Please refer to Aseprite's INSTALL.md to check for any updates to Aseprite installation procedure.

This script was tested on Windows 10 & 11 with Visual Studio 2022 Community and is targeted for x64 based systems.

As long as all dependencies are met and all paths are correct this script will automatically download and extract both the Aseprite source code and a pre-built package of Skia then run the build process.

Dependencies

• Tar (Bundled with recent releases of Windows 10 and newer)

• The latest version of Cmake (3.16 or greater)

• Curl (Bundled with recent releases of Windows 10 and newer)

• Ninja build system

• Visual Studio 2022 + Desktop Development with C++

• Windows SDK 10.0.20348.0 (Available via Visual Studio)

• Installing scoop is recommended to install several dependencies:

     scoop install ninja cmake
  

Explanation of Paths

The user customizable portion of this script consists of paths. Most of these paths can be changed to better fit your build environment. Below is a short description of each path in order of appearance.

1. DEPS

   • Change DEPS path to your main working directory. The working directory will be created for you if it does not already exist.

2. ASEPRITE

   • Path where Aseprite source code will be unzipped into, directory is created for you. DO NOT MODIFY!

3. SKIA

   • Path where Skia will be unzipped into, directory is created for you. DO NOT MODIFY!

4. ASEZIP

   • Determines what URL aseprite source code is downloaded from, modify if you are building a different version of aseprite.

5. SKIAZIP

   • Determines what URL Skia is downloaded from, modify if your version of INSTALL.MD recommends a different version of Skia.

6. VISUALSTUDIO

   • Path to Visual Studio 2022, modify if you have installed on a different drive and/or if using a different edition.

7. WINSDK

   • This path is to check if the correct version of the Windows SDK is installed, modify if INSTALL.MD recommends a newer SDK version.

8. TEMP

   • Path to temporary directory for curls.

Updating

• If you have previously run the script and have changed the URL for ASEZIP, please make sure to delete the previous aseprite directory in the working directory (DEPS).

• If you change the URL for SKIAZIP, please make sure to delete the skia directory in the working directory (DEPS).

Details

Aseprite recommends using Visual Studio 2022 and the latest version of the Windows 10 SDK (Currently 20348).

After adjusting paths to fit your build environment simply execute the script and it will run completely hands off, creating your specified working directory and all subdirectories.

Aseprite source code and a pre-built copy of Skia are curled into the temp directory and extracted into their respective subdirectories.

The script will then begin the build process based on instructions from INSTALL.md.

Upon completion the script will output a directory listing of the newly compiled aseprite.exe located in the %ASEPRITE%\build\bin directory. You can freely copy the executable and data folder located in the previously mentioned bin directory to a new location of your choosing.

Enjoy using Aseprite!