编译指南

先决条件

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

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

2. CMake

   你也可以使用 Visual Studio 内置的 CMake，它位于 %ProgramFiles%\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\CMake\CMake\bin。

3. Python 3.11+

4. Conan

   pip install conan

   确保上述依赖均已被添加入系统路径，使用以下命令检查：

   cmake --version
   python --version
   conan --version

编译

1. 克隆存储库

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

2. 打开根目录的 Magpie.sln 然后生成解决方案。

启用触控支持

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

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

python publish.py x64 unpackaged <pfx 路径> <pfx 密码>

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