本文将指导你编译The Powder Toy. 如果你有任何疑问，请在TPT论坛中的开发协助板块提问。

编辑注记：请勿在未经咨询TPT开发者的情况下修改本指南。否则你的修改有可能在没有事先通知的情况下被无情地退回。

Windows

在Windows 10上测试。

环境搭建

• 安装Git (下载链接)
  • 安装时不要改动选项
• 安装Python 下载链接)
  • 建议允许安装程序将Python添加到PATH中，并禁用路径长度限制（该选项在安装过程结束时出现）
• 打开一个管理员命令提示符（在开始菜单中搜索 "cmd"，右击它，点击 "以管理员身份运行"）并执行以下命令

python -m pip install --upgrade pip
pip install --upgrade meson ninja

• 安装Visual Studio (下载链接)
  • 选择桌面开发的安装组件
  • 你只需要 "MSVC "和 "Windows 10 SDK"，所以你可以在右边的列表中取消勾选其他选项
• 在开始菜单中找到 "x64 Native Tools Command Prompt for VS"（或类似的应用，以下简称 "VS提示符"）并执行以下命令
  • 建议将生成的窗口固定到你的任务栏上；你将经常使用它来构建TPT

cd /d [你保存源码仓库的路径]
git clone https://github.com/The-Powder-Toy/The-Powder-Toy

第一次构建

• 打开VS提示符（见上文）并执行以下命令

cd /d [你保存源码仓库的路径]
cd The-Powder-Toy
meson build-debug
cd build-debug
ninja

• 你可能会在所有这些过程中看到一些警告，但应该没有错误（如果你在任何阶段看到警告，不要跳过它；而是记录下来，在论坛向我们询问）
  • 如果你不确定是否成功，再次运行ninja；如果显示 "no work to do"，说明一切正常。
• 现在，可以从提示符下运行TPT

powder.exe

使用Visual Studio IDE

上面的方法不能让你使用Visual Studio的 "Visual "部分，即IDE。尽管Meson对这种使用情况的支持有限，但如果由于某种原因你希望使用IDE，你可以要求Meson生成一个使用Visual Studio而不是Ninja的构建项目。

• 打开VS提示符（见上文），执行以下命令

cd /d [你保存源码仓库的路径]
cd The-Powder-Toy
meson --backend=vs -Dbackend_startup_project=powder build-debug-vs

• 在这之后，你不再需要使用VS提示符。

这将生成一个包含Visual Studio解决方案的构建项目（the-powder-toy.sln）。你可以像其他解决方案一样使用它，但有几个关键的区别。

• 集成开发环境只能用于更舒适的编辑和调试，而不能用于其他方面，包括改变项目结构；你必须熟悉Meson并使用meson.build文件才能做到这一点。
• 一旦你真正改变了meson.build文件，Meson就会在你下次试图构建它时自动重新生成解决方案；Visual Studio会给你一个关于解决方案被改变的可怕的弹出窗口，这是很正常的，只要点击 "重新加载解决方案 "即可。
• 你目前看到的配置（很可能是debug|x64，如果你完全按照这个指南来做的话）是解决方案的唯一配置，不建议添加其他配置，因为Meson在下次重新生成解决方案时只会覆盖它们；相反，你必须用Meson生成单独的构建项目。