面向电脑的操作入门

项目
05/09/2023

本主题概述了使用 GDK 开发电脑游戏所涉及的步骤，以及指向其他主题的链接，其中详细介绍了各个步骤。
请注意，如果使用的是中间件引擎，则“电脑”部分的结束处提供端到端指南，其中包含本主题中包含其他引擎特定信息的相同信息。

设置开发环境
创建新的 GDK 项目或将 GDK 集成到现有桌面项目
检查更新
为你的电脑游戏请求额外权限
准备进行 Xbox 服务开发
创建合作伙伴中心项目并将游戏配置为使用它
测试 Xbox 服务功能
打包游戏
发布游戏

设置开发环境

使用 GDK 设置你的电脑以准备开发，按照“设置你的开发电脑以进行游戏运行时游戏开发”中的步骤进行操作。

创建新的 GDK 项目或将 GDK 集成到现有桌面项目

下一步是创建新的 GDK 项目（如果从头开始创建）或将 GDK 集成到现有桌面项目中。

若要创建新项目，请按照使用 GDK 项目模板开始开发新游戏中的说明进行操作
若要将 GDK 集成到现有项目中，请按照将 GDK 添加到现有桌面项目中的说明进行操作

检查更新

注意

从 2022 年 6 月 GDK 开始，在电脑上启动游戏不再需要检查强制更新。电脑引导程序为基于 2022 年 6 月 GDK 和未来版本构建的 MSIXVC 打包游戏管理此功能。

你可以选择性地在电脑上检查和应用更新（如果使游戏保持最新状态至关重要）。有关详细信息，请参阅检查更新主题。

为你的电脑游戏请求额外权限

某些由你的 MicrosoftGame.config 文件配置的功能将需要更多权限才能正常工作。如果你要使用以下任何功能，请与你的客户经理联系以获取必要的权限。

有关此主题的详细信息，请参阅面向电脑的打包入门。

注意

从 2022 年 3 月游戏服务版本开始，默认情况下会启用非虚拟化 Filesystem 和 Registry 写入、文件写入安装位置以及模组。有关详细信息，请参阅 Flat 文件安装概述和模组支持。

准备进行 Xbox 服务开发

若要利用成就和云保存等功能，需要将 Xbox 服务功能集成到游戏中。

有关 Xbox 服务开发的详细信息，请参阅 Xbox 服务入门。

我们建议安装 Xbox 应用，以帮助管理电脑上的 Xbox 服务登录。

如果你的游戏支持 Xbox 服务多人功能，则必须安装 Xbox Game Bar（从 Microsoft Store 安装）。

注意

Xbox 游戏栏将自动包含在大多数 Windows 10 版本中。对于测试，Xbox Game Bar 应始终更新到最新版本。

创建合作伙伴中心项目并将游戏配置为使用它

在为游戏创建合作伙伴中心项目并将游戏配置为使用合作伙伴中心项目中的值之前，你将无法测试 Xbox 服务功能

在合作伙伴中心创建产品

需要先在合作伙伴中心创建启用 Xbox 服务的产品，然后才能测试 Xbox 服务功能或将游戏发布到 Microsoft Store。有关合作伙伴中心的更多信息，请参阅在合作伙伴中心设置应用或游戏，用于托管合作伙伴。

正在更新 MicrosoftGame.config

你在创建新的 GDK 项目或将 GDK 集成到现有桌面项目部分中创建项目时创建的 MicrosoftGame.config 文件具有默认值，允许在电脑和 Xbox 上进行早期开发，而无需进一步配置，直到开始使用游戏运行时、Microsoft Store和游戏标识中的功能。若要使用 Xbox 服务功能，需要使用合作伙伴中心项目标识详细信息更新项目的 MicrosoftGame.config。

转到合作伙伴中心仪表板。
从产品列表中选择自己的游戏。
选择游戏设置选项卡，然后选择标识详细信息。
选择显示详细信息以展开标识详细信息部分。
使用标识详细信息部分的表中的以下值，然后将这些值从合作伙伴中心复制到 MicrosoftGame.config 中的相应元素和字段中。

合作伙伴中心中的名称	MicrosoftGame.config
Xbox 游戏 ID	TitleId
包/标识/名称	标识 ->名称
包/标识/发布者	标识 ->发布者
Xbox 服务 -> Xbox 设置 ->MSAAppId	MSAAppId

例如，合作伙伴中心中的以下标识详细信息将导致你的 MicrosoftGame.config 看起来类似下面的示例：

合作伙伴中心中的名称	示例值
Xbox 游戏 ID	64353034
包/标识/名称	41336MicrosoftATG.Achievements2017Redux
包/标识/发布者	CN=A4954634-DF4B-47C7-AB70-D3215D246AF1
Xbox 服务 -> Xbox 设置 ->MSAAppId	0000000000000000

<?xml version="1.0" encoding="utf-8"?>
<Game configVersion="1">

  <Identity Name='41336MicrosoftATG.Achievements2017Redux' Version="1.1.0.0" Publisher='CN=A4954634-DF4B-47C7-AB70-D3215D246AF1' />


  <TitleId>64353034</TitleId>
  <MSAAppId>0000000000000000</MSAAppId>
  
  <ExecutableList>
    <Executable Name="Achievements2017_desktop.exe"
                TargetDeviceFamily="PC"
                Id="Game"/>
  </ExecutableList>
  
  <ShellVisuals DefaultDisplayName="Achievements2017 Desktop Sample"
                PublisherDisplayName="Xbox Advanced Technology Group"
                StoreLogo="Assets\StoreLogo.png"
                Square150x150Logo="Assets\Logo.png"
                Square44x44Logo="Assets\SmallLogo.png"
                Square480x480Logo="Assets\LargeLogo.png"
                Description="Achievements2017"
                ForegroundText="dark"
                BackgroundColor="#000000"
                SplashScreenImage="Assets\SplashScreen.png"/>
</Game>

有关 MicrosoftGame.config 中的值的其他信息，请参阅MicrosoftGame.config。

测试 Xbox 服务功能

若要测试游戏使用的 Xbox 服务功能，需要创建一个或多个测试帐户并切换到开发沙盒。

创建测试帐户

你需要创建一个可访问开发沙盒的测试帐户，以便能够测试 Xbox 服务功能。有关创建测试帐户详细信息，请参阅创建测试帐户。

切换开发沙盒

创建测试帐户后，请使用该帐户通过以下步骤访问开发沙盒。

若要查找沙盒的 ID，请转到“合作伙伴中心”。
导航到游戏。
在左侧导航窗格中选择 Xbox 服务>游戏设置。

注意

沙盒 ID 位于“游戏设置”页左上角的第一个选项卡上。它的名称类似于“ABCDEF.0”。

打开开始菜单。
输入Microsoft GDK 命令提示符，然后在键盘上选择 Enter。
打开第一个命令提示符。
在命令提示符处，输入 XblPCSandbox.exe[你的沙盒 ID]。
命令提示符启动多个应用后，使用测试帐户登录到 Xbox 应用。

如果能够成功登录，则已创建测试帐户并更改为沙盒以开始测试。如果在登录时遇到问题，请参阅疑难解答登录和沙盒文章以获取帮助。

远程测试

你还可能会发现，对设置远程测试电脑和配置远程调试进行测试很有帮助。有关详细信息，请参阅 Visual Studio 主题中的设置远程测试电脑和远程调试 C++ 项目。

打包游戏

若要发布游戏，需要先将游戏打包。 MSIXVC 是 Microsoft Store 所需的打包格式。打包游戏需要一个 MicrosoftGame.config 文件，该文件可实现 Microsoft Store 中的游戏身份和特定于游戏的 Shell 视觉对象。有关更多信息，请参阅 MicrosoftGame.config 概述。

要开始对现有的电脑游戏打包，请参阅面向电脑的打包入门。

注意

从 2022 年 3 月游戏服务版本开始，由于安装了 MSIXVC 包，文件在光盘上的布局方式已得到改进。这些改进使游戏文件更易于发现，并简化了对已安装 MSIXVC 游戏的管理。有关详细信息，请参阅 Flat 文件安装概述。

发布

准备好发布后，需要在合作伙伴中心中提交游戏。转到“合作伙伴中心”并按照 UI 中的说明提交游戏。

另请参阅

电脑游戏开发入门

利用 Microsoft 游戏开发工具包工具安装和启动电脑游戏

通过