AppFlowy 如何在 Windows 上配置 vcpkg 开发环境并执行依赖检查【免费下载链接】AppFlowyBring projects, wikis, and teams together with AI. AppFlowy is the AI collaborative workspace where you achieve more without losing control of your data. The leading open source Notion alternative.项目地址: https://gitcode.com/GitHub_Trending/ap/AppFlowy在 Windows 上从源码编译 AppFlowy 时Rust 侧构建依赖典型如 SQLite3需要通过 vcpkg 提供并且要在编译前完成一系列依赖检查。AppFlowy 仓库把这套流程封装为 Windows 安装脚本和 cargo-make 任务脚本负责一次性配好工具链并集成 vcpkgenv.toml中定义的任务负责逐项检查依赖是否就绪。完成本文后你可以按文档路径跑通整条检查链并在单项失败时知道该看哪条报错。运行检查链之前需要准备什么以下前置条件来自仓库内安装脚本与任务定义Rust脚本会执行rustc --version探测未安装时会提示并询问是否下载安装器rustup-init.exe安装完成后脚本会执行rustup toolchain install stable与rustup default stable。Flutter脚本会将 Flutter SDK 固定到3.27.4不匹配时通过git checkout 3.27.4切换。vcpkg 已在 PATH 中依赖检查任务check_vcpkg通过which vcpkg判断找不到时会输出Please install vcpkg on windows at first. Make sure to put it into PATH env var安装方式以 env.toml 中注释指引的 vcpkg Quick Start 为准本仓库文档只要求把vcpkg放进 PATH 环境变量。Visual Studioenv.toml中的check_visual_studio_installation任务用 PowerShell 查询MSFT_VSInstance版本要求不低于16.11.0否则报错Visual studio 2019 is not installed or version is lower than 16.11.0。duckscript部分检查脚本用duckscript作为 script_runner。未安装时任务会提示Please install duckscript at first: cargo install --force --locked duckscript_cli主路径运行 Windows 安装脚本在 AppFlowy 仓库根目录install_windows.sh位于scripts/install_dev_env/下打开 bash执行bash scripts/install_dev_env/install_windows.sh该脚本会按顺序完成以下动作见 install_windows.sh执行前请确认你接受这些副作用探测并按交互确认后安装 Rust。把 Flutter 固定到3.27.4。通过 PowerShell 把%LOCALAPPDATA%\Pub\Cache\Bin和%USERPROFILE%\.cargo\bin追加到用户级PATH。执行flutter config --enable-windows-desktop启用 Windows 桌面支持并运行flutter doctor供你处理其报告的问题。设置git config core.hooksPath .githooks并下载go-gitlint1.1.0 到.githooks/会向网络下载并写入仓库内的 hooks 目录。切换到frontend目录安装构建工具cargo install --force cargo-make cargo install --force --locked duckscript_cli集成 vcpkg脚本注释标注Requires admin即以管理员权限运行vcpkg integrate install执行前置检查这一步就是标题中的“依赖检查”PATH$PATH;$LOCALAPPDATA\Pub\Cache\bin bash -c $USERPROFILE/.cargo/bin/cargo make appflowy-flutter-deps-tools第 8 步的cargo make appflowy-flutter-deps-tools在 Windows 上展开为install_flutter_prerequests→install_windows_deps见 env.toml按依赖顺序执行四个子任务顺序任务动作失败提示1check_duckscript_installationduck -h探测 duckscript提示安装duckscript_cli2check_vcpkgwhich vcpkg探测 PATH提示安装 vcpkg 并加入 PATH3install_vcpkg_sqlitevcpkg install sqlite3:x64-windows-static-md—4install_rust_vcpkg_clicargo install vcpkg_cli随后vcpkg_cli probe sqlite3输出中包含Failed:时任务断言失败依赖检查如何判定通过检查链的最终验证发生在install_rust_vcpkg_cli任务里先cargo install vcpkg_cli再执行vcpkg_cli probe sqlite3并断言标准输出中不出现Failed:。也就是说vcpkg integrate install集成成功且sqlite3:x64-windows-static-md可用时probe才能通过若输出带Failed:任务会失败并打印 probe 的完整输出据此回到上一步检查 vcpkg 集成与 sqlite3 包安装。如果不想跑完整脚本也可以进入frontend目录后用 cargo-make 单独重跑某一项检查前提是本节工具已装好cargo make check_duckscript_installation cargo make check_vcpkg cargo make install_vcpkg_sqlite cargo make install_rust_vcpkg_cli这些任务名与定义均见 env.tomlappflowy-flutter-deps-tools任务入口在 Makefile.toml 中由scripts/makefile/env.toml扩展加载。检查失败时按提示处理duck -h失败duckscript 未安装执行cargo install --force --locked duckscript_cli。which vcpkg为空vcpkg 未安装或不在 PATH按 vcpkg 官方 Quick Start 安装后重启终端再检查。vcpkg_cli probe sqlite3输出含Failed:说明 vcpkg 工具链集成vcpkg integrate install未生效或 sqlite3 包未安装成功需以管理员身份重新执行集成并重装sqlite3:x64-windows-static-md。Visual Studio 版本检查不通过需安装不低于16.11.0的 Visual Studio 2019/2022 工作负载check_visual_studio_installation才会给出:ok。边界说明本文只覆盖 Windows 开发环境的 vcpkg 配置与依赖检查后续实际编译 AppFlowy-Core 由其他任务如appflowy-core-dev-windows负责不属于本场景。仓库文档支持 Windows 开发但贡献者文档更倾向 macOS/Linux 环境遇到 Windows 特有构建问题时以flutter doctor与各检查任务的报错输出为准。【免费下载链接】AppFlowyBring projects, wikis, and teams together with AI. AppFlowy is the AI collaborative workspace where you achieve more without losing control of your data. The leading open source Notion alternative.项目地址: https://gitcode.com/GitHub_Trending/ap/AppFlowy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考