Compilation zh CN
编译是生成可执行文件的过程。 如果您希望对 ASF 作出自己的修改，或者出于某种原因不信任官方发布的可执行文件，编译就是您需要做的事。 如果您是用户而不是开发者，则很可能您希望使用已预编译的二进制文件，但如果您想使用自己的二进制文件或学习新内容，请继续阅读。
只要您拥有所有需要的工具，ASF 就可以在任何当前支持的平台上进行编译。
无论使用什么平台，您都需要完整的 .NET SDK（不仅仅是运行时环境）才能编译 ASF。 您可以在 .NET 下载页面找到安装指南。 您需要安装适合您操作系统的 .NET SDK 版本。 安装成功后，dotnet 命令应该已经可以使用并且正常运行。 您可以执行 dotnet --info 命令进行验证。 同样需要确认您的 .NET SDK 匹配 ASF 的运行时环境需求。
假设您已安装适当版本的 .NET SDK，现在只需要前往 ASF 源代码目录（Clone 或者下载并解压的 ASF 仓库）并执行：
dotnet publish ArchiSteamFarm -c "Release" -o "out/generic"如果您在使用 Linux/macOS，您也可以使用 cc.sh 脚本，以稍复杂的方式实现同样的效果。
如果编译成功完成，您可以在 out/generic 目录中找到您的 ASF source 包。 这与官方的 generic 构建相同，但因为这是您自己的构建，所以它强制 UpdateChannel 和 UpdatePeriod 为 0。
如果您需要，也可以生成特定操作系统的 .NET 包。 一般情况下，您不需要这样做，因为您刚刚编译了 generic 包，您可以使用已安装的用于编译的 .NET 运行时环境运行此包，但如果您确实需要操作系统包：
dotnet publish ArchiSteamFarm -c "Release" -o "out/linux-x64" -r "linux-x64" --self-contained当然，您需要将 linux-x64 替换成您需要的目标操作系统架构，例如 win-x64。 这一构建也将禁用自动更新。 当以 --self-contained 参数构建时，您还可以选择声明另外两个开关：-p:PublishTrimmed=true 将会产生裁剪过的构建，-p:PublishSingleFile=true 将会产生单文件。 二者都添加则会使用与我们自己的构建相同的设置。
上文是构建可用 ASF 的所有必须步骤，您可能也有兴趣了解如何构建我们的图形化 Web 界面 ASF-ui。 从 ASF 的角度看，您只需要将 ASF 的构建输出放入标准的 ASF-ui/dist 路径，然后（如果需要），带上它构建 ASF。
ASF-ui 以 Git Submodule 形式作为 ASF 源码树的一部分，您需要确保在克隆仓库时使用 git clone --recursive，否则您会缺少必须的文件。 您还必须拥有可用的 NPM，Node.js 默认已经包含它了。 如果您使用的是 Linux/macOS，我们建议您使用 cc.sh 脚本，如果可能（也就是说如果您已经满足上述的所有要求），它将自动处理 ASF-ui 的构建和装载。
除了 cc.sh 脚本，我们也在下文附上了简要的构建说明，您可以查阅 ASF-ui 仓库获得更详细的文档。 同上，在 ASF 源码树根目录下，执行下列命令：
rm -rf "ASF-ui/dist" # ASF-ui 不会自动清理旧版构建
npm ci --prefix ASF-ui
npm run-script deploy --prefix ASF-ui
rm -rf "out/generic/www" # 确保我们的构建输出不包含旧文件
dotnet publish ArchiSteamFarm -c "Release" -o "out/generic" # 或者根据上文选择您需要的命令您现在应该可以在 out/generic/www 目录下看到 ASF-ui 的文件了。 ASF 将能够向浏览器展示这些文件。
或者，您可以直接构建 ASF-ui，无论是手动还是通过我们仓库的帮助来实现，然后手动复制构建输出到 ${OUT}/www 目录，其中 ${OUT} 是您通过 -o 参数指定的 ASF 输出目录。 这正是 ASF 在构建过程中做的事，如果 ASF-ui/dist 存在，它就将其复制到 ${OUT}/www，没有任何花式操作。
如果您想要编辑 ASF 代码，您可以使用任何兼容 .NET 的 IDE，但这也是可选的，因为您甚至可以用记事本编辑代码并用上述 dotnet 命令编译。
对于 Windows 系统，我们推荐使用最新版本的 Visual Studio（免费的社区版即可）。 或者也可以使用最新版本的 Visual Studio Code。
如果您要在 Linux/macOS 上开发 ASF 代码，我们推荐使用最新版的 Visual Studio Code。 它没有经典的 Visual Studio 那么丰富的功能，但是应该足够了。
当然，以上的所有建议都仅仅是建议，您可以使用您想用的任何工具，最后您都要使用 dotnet build 命令进行构建。 我们使用 JetBrains Rider 进行 ASF 的开发，尽管这个解决方案并不是免费的。
main 分支并不保证能够成功编译或者正常运行 ASF，正如我们在发布周期中所述，这是一个开发分支。 如果您希望从源代码编译或引用 ASF，就应该为此选择适当的标签，这样能够保证编译成功，甚至可以正常运行（如果您选择稳定版）。 要检查代码库的“健康状态”，您可以检查我们的 CI——GitHub。
官方 ASF 发布版本由带有满足 ASF 运行时环境需求的最新版 .NET SDK 的 GitHub 编译。 经过测试后，所有的包都会作为 Release 被部署在 GitHub 上。 这也保证了透明度，因为 GitHub 总是为所有构建使用官方公共源，并且您可以检查 GitHub 的 Artifacts 与 GitHub Release 附件的 Checksum（校验和）。 除了私人的开发和调试过程外，ASF 开发人员不会自行编译或发布构建版本。
除此之外，ASF 维护者还会在独立于 GitHub 的远程 ASF 服务器手动验证并发布构建校验和，作为一项额外安全措施。 这个步骤是强制性的，ASF 在自动更新时必须检查通过才认为对应发布版本是有效的。
