Windows 环境下 Aseprite 的编译方法

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

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

安装环境依赖#

软件或源码请选择对应架构的最新版本。

Visual Studio
需要选择安装的内容*：
- 使用 C++ 的桌面开发；
- Windows 10 SDK (10.0.18362.0).
CMake 安装时选择添加 CMake 到环境变量，或自行将 cmake.exe 的路径添加到 Path 环境变量中。
Ninja
下载 zip 文件，将 ninja.exe 解压到 CMake 安装目录中，使其与 cmake.exe 在同一目录。

准备源码和 Skia 库#

准备好一个位置，本文以 E:\Programs\aseprite_build\ 为例。在该位置新建两个文件夹，分别用于存放源码和 Skia 库。文件夹名称随意，只需要在同一目录下。本文以 \aseprite 和 \skia 为例。
下载源码，解压到 \aseprite 。
若安装了 Git，可直接在 \aseprite_build 文件夹下克隆仓库：
```
git clone --recursive https://github.com/aseprite/aseprite.git
```
源码会被保存在 \aseprite 文件夹下。
可以使用下列命令更新克隆的仓库：
```
git pull
git submodule update --init --recursive
```
在源码文件夹中新建一个 \build 文件夹。
下载 Skia 库，解压到 \skia 。

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

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

编译#

编译不支持 MinGW。若配置了 MinGW，则需要在 Path 环境变量中暂时移除 MinGW，或是使用命令：
```
cmake -DCMAKE_IGNORE_PATH = <\MinGW\bin 所在目录>
```
调用 Visual Studio 开发者命令提示符。这里需使用 cmd，PowerShell 可能无法使用 call 命令。
```
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。
改变目录到 build 文件夹下。
```
cd E:\Programs\aseprite_build\aseprite\build
```
如果 \build 文件夹的位置和当前命令提示符运行的路径盘符不一致，切换目录命令的路径之前需要增加盘符，如 cd /e E:\programs\... 。
执行编译
编译需要一定的时间，且会占用较多 CPU 资源。开始之前可以暂时关闭其他占用高的软件。
执行下列命令。
注意，命令中的 E:\Programs\aseprite_build\skia 是 skia 库解压的路径，请根据实际情况自行替换。
```
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: ... 的输出，表明项目文件生成完毕。
接下来执行：
```
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 获取其他语言。

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

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