设置
初级
有许多可配置的选项会影响游戏的构建方式。本页介绍其中几个比较重要的选项。
如何更改属性
Visual Studio 拥有自己的发布系统,它以图形化方式管理构建设置。
在解决方案资源管理器面板中,右键单击你想要设置的平台包,然后选择 Publish(发布)。

这会打开一个新选项卡和一个设置向导。选择 Folder 选项,然后再次选择 Folder,接着可以指定构建结果的存放位置。

现在,点击 Show all settings 按钮即可更改设置。

| 设置 | 描述 |
|---|---|
| 配置(Configuration) | 发布时使用的配置。 |
| 目标框架(Target framework) | 游戏将使用的 .NET 框架。 |
| 部署模式(Deployment mode) | 决定运行游戏所需的框架是否嵌入到应用程序中,从而让用户无需安装 .NET 运行时。更多信息请查看自包含一节。 |
| 目标运行时(Target runtime) | 要发布到的平台和处理器架构。 |
| 目标位置(Target location) | 已发布构建的位置。更多信息请查看输出目录一节。 |
| 生成单个文件(Produce single file) | 为 true 时,所有非原生库都会嵌入到可执行文件中。更多信息请查看单文件与包含原生库一节。 |
| 启用 ReadyToRun 编译(Enable ReadyToRun compilation) | 以增大应用程序体积为代价提升启动性能。更多信息请阅读 Microsoft 文章。 |
对于某些选项,你可能需要更改平台包的属性,方法是右键单击该包并选择 Properties(属性)。

名称
要更改可执行文件的名称,你需要更改平台包的程序集名称(assembly name)。
在平台包的属性中,找到名为 Assembly name 的字段。

图标
应用程序图标文件位于 Resources/Icon.ico。要更改它,只需替换该文件即可。
如果你愿意,也可以更改图标的位置。
在平台包的属性中,找到名为 Icon 的字段。
![]()
Warning
更改图标后,你需要删除平台包目录中的 /bin,图标才会更新。
自包含
让应用程序成为**自包含(self contained)**的,可以免除用户机器上必须安装 .NET 运行时的要求。
由于 .NET 应用程序通常的工作方式,Stride 游戏需要运行时才能运行。如果它不存在,游戏会显示一个窗口,提示用户安装它。
Note
.NET 应用程序相当常见,尤其是在 Windows 上,因此用户很可能已经安装了它。
让游戏成为自包含的既有好处也有坏处:
- 好处: 即使用户没有安装运行时,游戏也能运行。
- 坏处: 游戏的体积会更大。
在配置文件设置中,将 Deployment mode 选项改为 Self-contained。

单文件与包含原生库
默认情况下,构建会为项目使用的每个包创建一个 .dll 文件。通过启用 Publish single file,这些文件可以嵌入到应用程序可执行文件中。
尽管名字如此,这个选项仍不会让游戏变成单个文件,因为它不会嵌入 Stride 使用的原生库。为此,你还需要启用 Include native libraries for self extract。
Note
即使启用了所有这些选项,Stride 仍会为其资产生成一个名为 data 的附加文件夹,该文件夹需要随游戏一起分发。
要启用 Include native libraries for self extract,请双击平台包并向 <Property Group> 添加 <IncludeNativeLibrariesForSelfExtract>true</IncludeNativeLibrariesForSelfExtract>。

接着,要启用 publish single file,请打开配置文件设置,在 File publish options 中勾选 Produce single file 复选框。

Native AOT
Stride 支持使用 Native AOT 构建游戏。更多信息请阅读 Native AOT。
要启用 Native AOT,请双击平台包并向 <Property Group> 添加 <NativeAot>true</NativeAot>。

输出目录
有两个路径可以配置:
- 输出路径(Output path) - 指向包含 Debug 和 Release 所有构建文件的目录的路径。
- 发布目录(Publish directory) - 指向发布项目时存放最终结果的目录的路径。
默认情况下,发布目录设置为 $(OutputPath)/publish。
要更改输出路径,请双击平台包并更改 <Property Group> 中 <OutputPath> 的值。

要更改发布目录,请打开配置文件设置并修改 Target location 的值。
