本文将指导你编译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生成单独的构建项目。

MacOS

在MacOS 10.15和11.5上测试。

环境搭建

• 安装Homebrew (下载链接)

在下一步，会使用xcode-select；注意，你不需要安装Xcode来运行该命令

• 在终端中，执行以下命令

xcode-select --install # 征求你的确认，安装编译器
sudo -H python -m pip install --upgrade pip # 如果你得到 "没有名为pip的模块"，尝试python3
sudo -H pip install --upgrade meson ninja
brew install pkg-config luajit fftw sdl2
cd [你保存代码仓库的路径]
git clone https://github.com/The-Powder-Toy/The-Powder-Toy

第一次构建

• cd到版本库根目录并执行以下命令

meson build-debug
cd build-debug
ninja

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

./powder

Linux

在Ubuntu 20.04和Raspbian 10上测试。

所需的环境设置

• 确保你的软件包列表是最新的（命令，sudo apt update）。
• 安装git (命令，sudo apt install git)
• 安装python（命令，sudo apt install python3）。
• 安装pip，如果不存在的话（参考他们的教程）。
• 升级pip (命令：sudo -H python3 -m pip install --upgrade pip)
• 安装Meson和Ninja，如果不存在的话（命令，sudo -H pip install --upgrade meson ninja）。
• 可以选择安装ccache（命令，sudo apt install ccache）。
• 安装一个库工具（命令，sudo apt install pkg-config)
• 安装所需的库（命令：sudo apt install libluajit-5.1-dev libcurl4-openssl-dev libfftw3-dev zlib1g-dev libsdl2-dev)
  • 你的软件包管理器可能会用完全不同的名字打包这些东西
• 下载源代码（命令，git clone https://github.com/The-Powder-Toy/The-Powder-Toy）。

初次构建

• cd到版本库根目录并执行以下命令

meson build-debug
cd build-debug
ninja

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

./powder

接下来的步骤（所有平台）

更新二进制文件

现在你已经成功地第一次构建了TPT，你可能会想改变代码中的一些东西。要更新二进制文件，请通过执行以下命令再次构建它

ninja

在你上次执行的相同提示下再次构建。每当你改变一些东西，并希望二进制文件反映这些改变时，你都必须这样做。

构建release版

到目前为止，你一直在构建 "调试 "二进制文件。这些二进制文件比 "发布 "版本的调试要容易得多，但它们的性能也较差。你可以建立一个 "release"版本二进制文件，它的性能要好得多，但很难调试。只有当你确定你没有更多的bug需要处理时才使用这些构建。如果以后确实出现了一个bug，再去构建debug二进制文件。

要构建release版二进制文件，请在提示符中导航回到版本库的根目录，用Meson创建一个新的构建站点，然后再次用Ninja构建

cd /d [你存放软件库的地方]
cd The-Powder-Toy
meson -Dbuildtype=release build-release
cd build-release
ninja

注意，build-debug和build-release目录是独立的 "构建项目"，当你把它们设置为你的当前目录时（通过使用cd，见上面的命令列表），你可以用Ninja更新它们。

构建static版

上面的debug和release配置都会产生 "动态 "二进制文件，这意味着它们依赖于你系统的某些组件（你用apt在linux上安装的库或用brew在macos上安装的库）或powder.exe以外的文件（在windows上与powder.exe在同一目录的DLLs）。如果你是一个MOD作者，请确保你不发送这样的二进制文件，因为你的用户已经习惯了TPT不依赖任何东西，因此不太可能有自己安装这些库的经验。

你可以通过建立一个 "static"(静态)二进制文件来摆脱这些依赖性。这样，二进制文件将依赖于你系统中很可能存在的非常基本的组件。它也会增加几兆字节，并且链接它需要更长的时间，这就是为什么你只有在即将向公众发布时才会这样做。

要构建静态二进制文件，请在提示符中导航到版本库的根目录，用Meson创建一个新的构建站点（见下面的注释！），然后再次用Ninja构建

meson -Dbuildtype=release -Dstatic=prebuilt build-release-static
cd build-release-static
ninja

注意：在Windows上，你还需要在上面的Meson调用中添加-Db_vscrt=static_from_buildtype选项，否则生成的二进制文件将与MSVC运行时（vcruntime.dll和类似的）动态链接。

meson -Dbuildtype=release -Dstatic=prebuilt -Db_vscrt=static_from_buildtype build-release-static
cd build-release-static
ninja

曾经有用的方法

每个平台都有自己的一套怪癖，需要加以解决（主要是看你，微软和苹果）。幸运的是，我们的构建系统已经解决了其中的大部分问题。不幸的是，这些解决方法是以升级构建系统的形式出现的，而这些系统并不是自动安装的，即使是自动安装，受影响的构建站点也可能需要手动重新配置。如果你曾在某个时候让TPT成功构建，但从那时起，你的构建站点不知怎么就坏了，你可以尝试以下方法来修复它们。

修复单个构建站点的最直接的方法是重新配置它。要检查这个方法是否有效，请尝试运行Ninja。

cd /d [你存放软件库的地方]
cd The-Powder-Toy
meson --reconfigure --wipe build-debug # 或者你给你的构建站点起的任何名字
ninja

你必须对每一个被破坏的构建站点进行这样的操作。

如果这没有帮助，你可以升级pip、Meson和Ninja。就像第一次设置它们时一样，在linux和macos上添加sudo -H，在windows上在高位命令提示符下运行这个。

python -m pip install --upgrade pip # 如果你得到 "没有名为pip的模块"，试试python3
pip install --upgrade meson ninja

一旦你完成了这些，重新配置你的构建站点（见上文）。

如果这都没有帮助，那就是你从头开始的提示，就像你第一次构建TPT一样，按照指南进行，只不过你已经有了版本库，所以你不需要再克隆了。事实上，这是你对TPT所做修改的地方，所以你不应该删除它。'删除你的本地克隆版本库永远不会解决任何问题，它只会导致代码的丢失。甚至不要考虑这样做。

作为最后的手段，你可以在论坛上问我们 。

构建选项

构建选项在你建立一个构建站点时被传递给Meson(见上面的例子)，或者在以后的任何时候，当这个构建站点已经被使用时被传递。在这两种情况下，它们都是以-D[name]=[value]的形式作为命令行参数传递。例如，要建立一个用Lua 5.1而不是LuaJIT编译TPT的构建站点，你可以发出以下命令

meson -Dlua=lua5.1 build-debug-lua5.1

但你也可以使用一个现有的构建站点，并改变相关的构建选项来做同样的事情

cd build-debug
meson configure -Dlua=lua5.1

下次你运行Ninja时，由于这个改变而需要重建的东西都会被重建。关于配置构建站点的更多信息，请参见the Meson quick guide。

下面是我们的Meson设置支持的构建选项列表