如何从源码构建 PhotoCraft

PhotoCraft 是一个 Rust workspace，桌面应用、无界面 CLI 和 WebAssembly 应用都可以自己构建。如果你只是想使用 PhotoCraft，直接安装 官方构建 更简单。

1. 前置依赖

• Rust 稳定版 1.95 或更高。 workspace 设置了 rust-version = "1.95"，可通过 rustup 安装。
• Linux： 安装窗口系统、GL 和 GTK 开发包：

# Debian/Ubuntu
sudo apt install libxkbcommon-dev libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev
# Fedora/RHEL
sudo dnf install libxkbcommon-devel wayland-devel libX11-devel libXrandr-devel libXi-devel mesa-libGL-devel gtk3-devel
# Arch
sudo pacman -S libxkbcommon wayland libx11 libxrandr libxi mesa gtk3
# openSUSE
sudo zypper install libxkbcommon-devel wayland-devel libX11-devel libXrandr-devel libXi-devel Mesa-libGL-devel gtk3-devel

• Windows： 使用 Rust MSVC 工具链，并安装 Visual Studio 或 Microsoft C++ Build Tools，勾选 Desktop development with C++ 工作负载。在 Windows 11 上，Smart App Control（智能应用控制）可能会拦截 Cargo 或构建生成的可执行文件（错误 os error 4551），排查方法见开发指南。

2. 克隆并运行

git clone https://github.com/storytold/photocraft
cd photocraft
cargo run --release -p photocraft -- image.psd   # 桌面应用
cargo test --workspace                           # 测试套件

构建指南还列出了：

cargo build --workspace
cargo run -p photocraft-cli -- --help

3. 可选：日文字体

界面和文字工具使用的日文字体来自 craft-fonts。它是可选的构建输入，桌面正式构建总是包含它；不使用时，PhotoCraft 会使用系统自带的 CJK 字体。

git clone https://github.com/storytold/craft-fonts ../craft-fonts
CRAFT_FONTS_DIR="$PWD/../craft-fonts" cargo run --release -p photocraft

4. 可选：HEIC 与 Web 构建

• HEIC 支持是构建期特性：cargo build -p photocraft --features heif。官方构建已包含。
• Web 目标需要 rustup target add wasm32-unknown-unknown，项目用 cargo xtask wasm 检查。

Workspace 中的应用

• apps/photocraft：原生桌面应用
• apps/photocraft-cli：无界面 CLI、JSON-lines 服务器与 MCP 服务器
• apps/photocraft-web：用 Trunk 构建的 WebAssembly 应用