Table of Contents

设置

初级

有许多可配置的选项会影响游戏的构建方式。本页介绍其中几个比较重要的选项。

如何更改属性

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 的值。

另请参阅