Windows 环境下 Aseprite 的编译方法

发表于 分类于 Waline：

Aseprite 是一款轻量级的像素艺术创作软件，售价 $19.99 (2023.7)。但它在 Github 上开源，可自行编译。
Aseprite 是收费软件，请尊重版权。有能力还请购买软件支持开发团队。

官方的编译说明： https://github.com/aseprite/aseprite/blob/main/INSTALL.md
这里简单记录一下 Windows 10 / 11 环境下的编译流程，其他平台请参照官方说明。

安装环境依赖

  • 软件或源码请选择对应架构的最新版本。
  1. Visual Studio
    需要选择安装的内容*：
    • 使用 C++ 的桌面开发；
    • Windows 10 SDK (10.0.18362.0).
  2. CMake
    安装时选择添加 CMake 到环境变量，或自行将 cmake.exe 的路径添加到 Path 环境变量中。
  3. Ninja
    下载 zip 文件，将 ninja.exe 解压到 CMake 安装目录中，使其与 cmake.exe 在同一目录。

准备源码和 Skia 库

  1. 准备好一个位置，本文以 E:\Programs\aseprite_build\ 为例。在该位置新建两个文件夹，分别用于存放源码和 Skia 库。文件夹名称随意，只需要在同一目录下。本文以 \aseprite 和 \skia 为例。

  2. 下载源码，解压到 \aseprite 。

    若安装了 Git，可直接在 \aseprite_build 文件夹下克隆仓库：

    1
    git clone --recursive https://github.com/aseprite/aseprite.git

    源码会被保存在 \aseprite 文件夹下。
    可以使用下列命令更新克隆的仓库：

    1
    2
    git pull
    git submodule update --init --recursive

  3. 在源码文件夹中新建一个 \build 文件夹。

  4. 下载 Skia 库，解压到 \skia 。

这时，文件目录应该像这样：

/aseprite_build
├ /aseprite
│ ├ /.github
│ ├ /build <= 自行创建的文件夹
│ └ … (其他源码中的文件)
└ /skia
├ /include
└ … (其他 skia 库中的文件)

编译

  1. 编译不支持 MinGW。若配置了 MinGW，则需要在 Path 环境变量中暂时移除 MinGW，或是使用命令：

    1
    cmake -DCMAKE_IGNORE_PATH = <\MinGW\bin 所在目录>

  2. 调用 Visual Studio 开发者命令提示符。这里需使用 cmd，PowerShell 可能无法使用 call 命令。

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

    这里使用的是 Visual Studio 2022 Community 的默认路径。若不同，请查找并使用 VsDevCmd.bat 的位置替换。

    也可以在开始菜单所有应用中，找到 Visual Studio 的文件夹，打开 Developer Command Prompt。

  3. 改变目录到 build 文件夹下。

    1
    cd E:\Programs\aseprite_build\aseprite\build

    如果 \build 文件夹的位置和当前命令提示符运行的路径盘符不一致，切换目录命令的路径之前需要增加盘符，如 cd /e E:\programs\... 。

  4. 执行编译

    编译需要一定的时间，且会占用较多 CPU 资源。开始之前可以暂时关闭其他占用高的软件。

    执行下列命令。
    注意，命令中的 E:\Programs\aseprite_build\skia 是 skia 库解压的路径，请根据实际情况自行替换。

    1
    cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo -DLAF_BACKEND=skia -DSKIA_DIR=E:\Programs\aseprite_build\skia -DSKIA_LIBRARY_DIR=E:\Programs\aseprite_build\skia\out\Release-x64 -DSKIA_LIBRARY=E:\Programs\aseprite_build\skia\out\Release-x64\skia.lib -G Ninja ..

    出现 Build files have been written to: ... 的输出，表明项目文件生成完毕。
    接下来执行：

    1
    ninja aseprite

    出现 Linking CXX executable bin\aseprite.exe 的输出，表明编译成功。

至此，编译全部完成， \build\bin 目录下即为编译好的程序文件，可以重命名或移动到其他位置。打开 aseprite.exe 就能看到软件可爱的界面了。

配置和更新

打开软件后，选择菜单栏的 Edit -> Preferences… 或是使用快捷键 Ctrl + K 可以打开首选项。可在 Theme Mode 选择深色模式；调整 UI Elements Scaling 和 Screen Scaling 使界面大小适合屏幕分辨率；点击 Download Translations 获取其他语言。

更新需要重新进行编译，这也是在此记录下编译流程的意义之一。重新编译后，配置、安装的扩展 (如语言) 和主题不会丢失。

购买软件后可更方便地更新。仍然，如果有能力请购买软件支持开发团队。