Compilation zh CN
编译是生成可执行文件的过程。 如果您希望对 ASF 作出自己的修改，或者出于某种原因不信任官方发布的可执行文件，编译就是您需要做的事。 如果您是用户而不是开发者，则很可能您希望使用已预编译的二进制文件，但如果您想使用自己的二进制文件或学习新内容，请继续阅读。
只要您拥有所有需要的工具，ASF 就可以在任何当前支持的平台上进行编译。
无论使用什么平台，您都需要完整的 .NET Core SDK（不仅仅是运行时环境）才能编译 ASF。 您可以在 .NET Core 安装页面找到安装指南。 您需要安装适合您操作系统的 .NET Core SDK 版本。 安装成功后，dotnet 命令应该已经可以使用并且正常运行。 您可以执行 dotnet --info 命令进行验证。 同样需要确认您的 .NET Core SDK 匹配 ASF 的运行时环境需求。
假设您已安装适当版本的 .NET Core SDK，现在只需要前往 ASF 源代码目录（Clone 或者下载并解压的 ASF 仓库）并执行：
dotnet publish ArchiSteamFarm -c "Release" -f "net5.0" -o "out/generic"如果您在使用 Linux/macOS，您也可以使用 cc.sh 脚本，以稍复杂的方式实现同样的效果。
如果编译成功完成，您可以在 out/generic 目录中找到您的 ASF source 包。 这与官方的 generic 构建相同，但因为这是您自己的构建，所以它强制 UpdateChannel 和 UpdatePeriod 为 0。
如果您需要，也可以生成特定操作系统的 .NET Core 包。 一般情况下，您不需要这样做，因为您刚刚编译了 generic 包，您可以使用已安装的用于编译的 .NET Core 运行时环境运行此包，但如果您确实需要操作系统包：
dotnet publish ArchiSteamFarm -c "Release" -f "net5.0" -o "out/linux-x64" -r "linux-x64"当然，您需要将 linux-x64 替换成您需要的目标操作系统架构，例如 win-x64。 这一构建也将禁用自动更新。
在罕见的情况下，您可能需要构建 generic-netf 包，您可以将目标框架从 net5.0 更改为 net48。 请注意，您需要合适的 .NET 框架开发者工具包和 .NET Core SDK 才能编译 netf 包，所以此命令仅适用于 Windows：
dotnet publish ArchiSteamFarm -c "Release" -f "net48" -o "out/generic-netf"在无法安装 .NET 框架甚至 .NET Core SDK 本身的情况下（例如在 linux-x86 平台用 mono 构建），可以直接调用 msbuild。 您还需要手动指定 ASFNetFramework，因为 ASF 默认禁止在非 Windows 平台上构建 netf：
msbuild /m /r /t:Publish /p:Configuration=Release /p:TargetFramework=net48 /p:PublishDir=out/generic-netf /p:ASFNetFramework=true ArchiSteamFarm如果您想要编辑 ASF 代码，您可以使用任何兼容 .NET Core 的 IDE，但这也是可选的，因为您甚至可以用记事本编辑代码并用上述 dotnet 命令编译。 不过，对于 Windows 系统，我们推荐使用最新版本的 Visual Studio（免费的社区版即可）。
如果您要在 Linux/macOS 上开发 ASF 代码，我们推荐使用最新版的 Visual Studio Code。 它没有经典的 Visual Studio 那么丰富的功能，但是应该足够了。
当然，以上的所有建议都仅仅是建议，您可以使用您想用的任何工具，最后您都要使用 dotnet build 命令进行构建。 我们使用 JetBrains Rider 进行 ASF 的开发，也使用了一部分第三方工具，您可以在仓库的 tools 目录中找到它们。
main 分支并不保证能够成功编译或者正常运行 ASF，正如我们在发布周期中所述，这是一个开发分支。 如果您希望从源代码编译或引用 ASF，就应该为此选择适当的标签，这样能够保证编译成功，甚至可以正常运行（如果您选择稳定版）。 In order to check the current "health" of the tree, you can use our continuous integrations - GitHub or AppVeyor.
官方 ASF 发布版本由 Windows 上的带有满足 ASF 运行时环境需求的最新版 .NET Core SDK 的 GitHub 编译。 经过测试后，所有的包都会作为 Release 被部署在 GitHub 上。 这也保证了透明度，因为 GitHub 总是为所有构建使用官方公共源，并且您可以检查 GitHub 的 Artifacts 与 GitHub Release 附件的 Checksum（校验和）。 除了私人的开发和调试过程外，ASF 开发人员不会自行编译或发布构建版本。
