Magpie/docs/编译指南.md at dev

mirror of https://github.com/Blinue/Magpie.git synced 2026-06-24 02:04:10 +00:00

Xu 6fc3594d9d

* chore: 支持 VS2026

* docs: 更新文档以及排除 pdb

* chore: 修复 pdb 生成

* chore: 禁止 Magpie.Core 生成 pdb

* chore: 清理

2025-11-27 21:57:38 +08:00

先决条件

为了编译 Magpie，你首先需要安装：

Visual Studio 2022 或 2026 的最新版本，需要安装“使用 C++ 的桌面开发”和“通用 Windows 平台开发”两个工作负荷以及 Windows SDK build 26100 或更高版本。
CMake

你也可以使用 Visual Studio 内置的 CMake，它位于 %ProgramFiles%\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\CMake\CMake\bin。
Python 3.11+
Conan
```
pip install conan
```
确保上述依赖均已被添加入系统路径，使用以下命令检查：
```
cmake --version
python --version
conan --version
```

克隆存储库

git clone https://github.com/Blinue/Magpie

为了支持触控输入，TouchHelper.exe 应签名。签名是在 CI 中自动进行的，但你也可以手动签名，请执行以下步骤：

创建自签名证书，将其导出为 pfx。
将 src/Magpie/TouchHelper.cpp 中的 CERT_FINGERPRINT 常量替换为你的证书的 SHA-1 哈希值（也即该证书的指纹）。
在存储库根目录下执行以下命令：

python scripts/publish.py --pfx-path=<pfx 路径> --pfx-password=<pfx 密码>

这将编译 Magpie 并为 TouchHelper.exe 签名。编译出的程序位于 publish\x64。