PicaComic 桌面端构建 · Windows macOS Linux 源码编译

环境准备

PicaComic 用 Flutter 构建，所以构建桌面端的核心依赖是 Flutter SDK。

Flutter 安装：

1. 访问 Flutter 官方文档下载对应平台的 SDK
2. 解压后配置环境变量（将 flutter/bin 加入 PATH）
3. 运行 flutter doctor 检查环境是否就绪

flutter doctor 会检查：Flutter SDK、Android toolchain（可选）、Chrome（可选）、VS Code / Android Studio（可选）、连接的设备。桌面构建需要额外安装桌面工具链。

克隆与依赖安装

git clone https://github.com/wgh136/PicaComic.git
cd PicaComic
flutter pub get

归档后的仓库变为只读，但代码仍然可以正常克隆和编译。

Windows 构建

Windows 构建需要 Visual Studio 2022（含 C++ 桌面开发工作负载）。安装 Visual Studio 时勾选 "Desktop development with C++" 即可。

flutter config --enable-windows-desktop
flutter build windows --release

构建产物在 build/windows/x64/release/ 目录下，包含可执行文件和完整依赖，可以直接分发。

macOS 构建

macOS 构建需要 Xcode。安装 Xcode 后还需要执行首次许可协议确认。

flutter config --enable-macos-desktop
flutter build macos --release

产物在 build/macos/Build/Products/Release/ 目录下。

Linux 构建

Linux 构建依赖较多，需要先安装 GTK 和其他开发库。

Ubuntu/Debian 系：

sudo apt-get install clang cmake ninja-build pkg-config libgtk-3-dev liblzma-dev
flutter config --enable-linux-desktop
flutter build linux --release

产物在 build/linux/x64/release/bundle/ 目录下。

常见构建错误

依赖版本冲突：Flutter SDK 版本与 pubspec.yaml 中要求的版本不匹配。查看 pubspec.yaml 中的 environment 字段，安装对应版本的 Flutter。

WebView 问题：桌面端使用 WebView 渲染某些页面，Windows 和 macOS 分别使用系统自带 WebView（Edge WebView2、WKWebView），Linux 依赖 WebKitGTK。如果遇到 WebView 相关错误，检查对应的系统依赖是否安装完整。

归档仓库的 API 变化：V4.0.2 引入了本地文件日志功能，如果构建时遇到日志模块相关的编译错误，检查是否在正确的分支上构建。