Aseprite 源码编译教程（Windows/Mac/Linux）

一、声明

Aseprite 是开源软件，源代码在 GitHub 上公开，可以自行编译免费使用。但官方编译版需要购买（$19.99），购买是支持开发者 David Capello 持续更新的最好方式。如果你经济条件允许，请购买正版。购买方式见下载安装与中文设置。

二、Windows 编译

1. 安装依赖

• Visual Studio 2022（Community 免费版即可），安装时勾选"使用 C++ 的桌面开发"
• CMake（cmake.org，安装时勾选 Add to PATH）
• Git（git-scm.com）

2. 克隆代码和依赖

git clone --recursive https://github.com/aseprite/aseprite.git
cd aseprite
mkdir build
cd build

3. 编译 Skia 依赖

Aseprite 依赖 Skia 图形库，需要下载预编译版本：

• 从 GitHub Aseprite skia releases 下载对应版本的 Skia 包
• 解压到 C:/deps/skia 或任意目录

4. 生成项目并编译

cmake .. -G "Visual Studio 17 2022" -DLAF_BACKEND=skia ^
  -DSKIA_DIR=C:/deps/skia ^
  -DSKIA_LIBRARY_DIR=C:/deps/skia/out/Release-x64 ^
  -DSKIA_OPENGL_LIBRARY=
cmake --build . --config Release

编译完成后，可执行文件在 build/bin/ 目录下。

三、macOS 编译

1. 安装依赖

brew install cmake ninja

安装 Xcode 命令行工具：xcode-select --install

2. 编译

git clone --recursive https://github.com/aseprite/aseprite.git
cd aseprite
mkdir build && cd build
cmake .. -G Ninja -DCMAKE_BUILD_TYPE=Release -DLAF_BACKEND=skia \
  -DSKIA_DIR=$HOME/deps/skia \
  -DSKIA_LIBRARY_DIR=$HOME/deps/skia/out/Release-x64
ninja aseprite

四、Linux 编译

1. 安装依赖（Ubuntu/Debian）

sudo apt install -y g++ cmake ninja-build libx11-dev libxcursor-dev \
  libxi-dev libgl1-mesa-dev libfontconfig1-dev

2. 编译

git clone --recursive https://github.com/aseprite/aseprite.git
cd aseprite
mkdir build && cd build
cmake .. -G Ninja -DCMAKE_BUILD_TYPE=Release
ninja aseprite

五、常见问题

git clone 没有 --recursive？ 进入目录执行 git submodule update --init --recursive。

CMake 找不到 Skia？ 确认 SKIA_DIR 路径正确，且下载的 Skia 版本与 Aseprite 版本对应。

编译报错 C++ 版本？ 更新 Visual Studio 或 GCC 到支持 C++17 的版本。

编译后没有中文？ 自行编译版同样支持语言包下载，按中文设置教程操作即可。