> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 使用 GDK 工具安装并启动 PC 游戏

> 如何使用 Microsoft Game Development Kit (GDK) 工具安装、启动以及排查在 Microsoft Gaming Runtime 上运行的 PC 游戏问题。

本主题介绍用于安装和启动 PC 游戏的 Microsoft 游戏开发工具包 (GDK) 工具。它说明如何使用这些工具,并提供关于对 PC 安装和启动问题进行故障排除的见解。

## 用于在 PC 上安装和启动游戏的工具

<Note>有关应用启动以及使用游戏运行时启动的更多信息,请参阅 [启动 Win32 游戏](/build/core-features/common/game-config/MicrosoftGameConfig-Overview#MSGC-PCLaunch)。</Note>

Microsoft 游戏开发工具包 (GDK) 提供以下方法来安装你的游戏。

* [wdapp.exe install](/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_install):用于安装游戏的 .MSIXVC 包。有关打包 PC 游戏的更多信息,请参阅 [开始使用 MSIXVC 打包工具打包 PC 游戏](/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC)。如果你希望通过包启用完整的 [PC Bootstrapper](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/overviews/gr-pc-bootstrapper) 流程,可以通过 /bootstrapper 标志启用此功能。

* [wdapp.exe register](/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_register):用于注册一个松散文件文件夹以便能够启动。有关更多信息,请参阅 [PC 游戏注册](/tools/tools-pc/title-registration-pc)。自 2022 年 6 月版 GDK 起,只有当你希望启用桌面和开始菜单外壳图标时(例如,测试零售安装场景时),才需要注册游戏。

Microsoft 游戏开发工具包 (GDK) 提供以下方法来启动你的游戏:

* 在注册游戏之后,它会以可选形式出现在开始菜单中,并可在搜索框中搜索。

* [wdapp.exe launch](/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_launch) 用于通过应用程序用户模型 ID (AUMID) 或可执行文件路径来启动游戏。

* Windows 设备门户 (WDP):转到 **Installed Apps**,然后选择 **Start**。

### 在启用 PC Bootstrapper 的情况下启动

若要以零售用户所看到的方式使用完整的 [PC Bootstrapper](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/overviews/gr-pc-bootstrapper) 流程启动游戏,必须通过 wdapp install 旁加载一个包并使用 /bootstrapper 标志。对于松散构建或未使用该标志的安装,PC Bootstrapper 的功能将仅限于在调用 XUserAddAsync 时强制执行简化的用户模型。

### 使用或不使用游戏标识启动

自 2022 年 6 月版 GDK 起,只要你的 [MicrosoftGame.config](/build/core-features/common/game-config/MicrosoftGameConfig-Overview) 配置正确,无论使用何种方法启动游戏,运行时的功能都应完全一致。

### 使用命令行参数启动

自 2022 年 6 月版 GDK 起,你可以直接启动可执行文件并直接传入任何 \[launch args]。

此外,你可以使用以下方法之一,使用命令行参数启动游戏:

* 在 GDK 命令提示符中执行 `WdApp Launch [launch args]`。

* 在命令提示符中执行 `<ExecutionAlias> [launch args]`。

* 在 Visual Studio 项目属性中使用命令行参数。

有关使用 Execution Alias 的更多信息,请参阅 [ExecutionAlias](/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-executable#MicrosoftGameConfig-Alias)。

<a id="PC-Errors" />

## 对 PC 安装和启动问题进行故障排除

### 错误代码 0x80073CFF:Deployment of package failed because no valid license or sideloading policy could be applied. A developer license or enterprise sideloading configuration may be required.

#### 问题

在尝试安装、注册或启动游戏时遇到问题。

#### 解决方法

解决方法是使用以下步骤在 PC 上启用开发人员模式。

1. 打开 **设置**。

2. 在搜索字段中输入 *Developer*。

3. 在显示的选项列表中,选择 **使用开发人员功能**。

4. 选择 **开发人员模式**。将出现一个对话框,提示系统正在添加功能。请务必等待此过程完成。

### 错误代码 0x80073cfc:The application cannot be started. Try reinstalling the application to fix the problem.

#### 问题

在安装过程的初始步骤之一中遇到了问题。

#### 解决方法

你可以卸载并重新安装 Gaming Runtime Services (GRTS)。按照以下步骤进行操作。

1. 打开 PowerShell 管理员命令提示符。

2. 执行以下命令:`get-appxpackage *gamings*`

3. 执行以下命令:`remove-package <package fullname from step 2 for the gamingservices package>`

4. 打开 XBOX 应用,然后安装一个游戏。这会触发从 Microsoft Store 安装 gamingservices 包。

### 错误代码 0x87e00017:Install source was found but cannot be reached. Likely internet problem.

#### 问题

此错误代码对应于 `IM_E_UNREACHABLE_INSTALL_SOURCE`。如果部署系统无法访问你的文件,则会遇到此错误。但是,虽然可能是这种情况,它也可能意味着安装目录已损坏。这种情况最常见的原因是部署部分成功,但事后未正确清理。

#### 解决方法

若要解决这些问题:

1. 运行应用 `wdapp list`。

2. 在结果列表中查找已安装的任何游戏版本。

3. 使用 `wdapp uninstall <pfn>` 卸载所有游戏。

4. 尝试再次安装游戏。

### 错误代码 0x80080203:The specified package format is not valid: The file is not a valid app package because it is missing a required footprint file.

#### 问题

出现此问题的原因是你有一个 “嵌套的 MSIXVC”(这很容易发生)。假设你的桌面构建是 *C:\MyGame*。你决定使用 [makepkg.exe](/build/core-features/common/packaging/deployment/makepkg) 在 *C:\MyGame* 下的子文件夹中创建一个包(例如,在 *C:\MyGame\Package* 中)。第一次可以正常工作,因为尚未生成包,但当你尝试再次创建包时会遇到此问题。除了此失败(其原因是包中有两个 *AppxManifest.xml* 文件)之外,对 *C:\MyGame* 运行 *makepkg.exe* 会尝试将现有的 .msixvc 打包到新包中(除非你在 genmap 中将其排除)。

#### 解决方法

若要修复此问题,请确保包目录位于包含 *MicrosoftGame.config* 的目录之外。

### 错误代码 0x80070490:Element not found

#### 问题

如果尝试使用 `wdapp install` 安装 .XVC(XBOX 包的打包格式),则会出现此问题。

#### 解决方法

请确保仅将 `wdapp install` 用于 .MSIXVC 包(PC 包的打包格式)。

### 共享游戏文件夹时通过 wdapp 启动出错

#### 问题

如果你使用 Windows 文件共享共享一个之前已使用 [wdapp.exe register](/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_register) 注册过的文件夹,则会导致游戏运行时丢失共享权限,并随后遇到此错误。

```
    'WdApp.exe launch' must be called with an AUMID to activate an application.

    Use 'WdApp.exe list' to get a list of sideloaded packages including AUMID values.

    Alternatively, if your executable specifies an Alias in the *MicrosoftGame.config*,

    typing the alias name at the command prompt will do an application activation.

    Failed with 0x80070057.
```

#### 解决方法

此问题与访问控制列表 (ACL) 相关。共享文件夹会阻止对应用模型的访问。也就是说,共享时容器会失去读取文件的权限。要解决此问题,请按照以下步骤保存并还原 ACL 数据。

1. 在共享文件夹之前,运行 'icacls /save AclFile' 以保存包文件夹的 ACL。

2. 使用 Windows 文件共享共享文件夹。

3. 若要还原以前的 ACL,请运行 'icacls /restore AclFile'。

除此解决方法外,你还可以先运行 `wdapp.exe unregister`,然后再运行 `wdapp.exe register` 来重新注册。这样可以恢复权限,同时保留文件夹共享。

### 错误代码 0x80070005:Access is denied.

#### 问题

运行 wdapp install 命令时遇到 “0x8007005: Access is Denied” 错误。

#### 解决方法

请确保传递 .msixvc 文件的完整路径。例如:

正确:

<i>wdapp install "c:\MyGame\GDKBuildFolder\GdkGame\_1.0.0.0\_x64\_\_pmsdash4d.msixvc"</i>

错误(缺少 .msixvc 的完整路径):

<i>wdapp install "c:\MyGame\GDKBuildFolder"</i>

### 错误代码 0x000007b:STATUS\_INVALID\_IMAGE\_FORMAT

#### 问题

运行 wdapp launch 命令时遇到 “0x000007b” 错误。

#### 解决方法

问题在于要启动的可执行文件的平台架构与 MicrosoftGame.config 中指定的架构不同。MicrosoftGame.config 中的 DesktopRegistration 元素有一个可选的子元素 ProcessorArchitecture,可以将其值指定为 'x86' 或 'x64'。确保此规范与在 Executable 元素中定义的可执行文件的平台架构相匹配,将解决此问题。

### 错误代码 0x800701B1:A device which does not exist was specified.

#### 问题

运行 wdapp install /drive 命令时遇到 “0x800701B1” 错误。

#### 解决方法

问题在于 Windows 应用商店未检测到目标驱动器。请确保目标驱动器出现在本地 PC 上的 “设置 -> 存储设置 -> 更改我的新内容的保存位置” 中的 “新的应用将保存到:” 下拉列表中。如果驱动器不存在,请检查该驱动器的运行状况,并确保本地 PC 拥有最新的 Windows 更新。

### 错误代码 0x80072F78:WININET\_E\_INVALID\_SERVER\_RESPONSE

#### 问题

运行 wdapp install 命令时遇到 “0x80072F78” 错误。

#### 解决方法

此问题与防火墙代理配置设置阻止此地址 “settings-win.data.microsoft.com” 有关。安装 PC GDK 游戏时,需要该地址才能正确缓存安装设置。请确保在防火墙软件中允许此地址。

## 另请参阅

[开始使用 Microsoft 游戏开发工具包](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/get-started/get-started-home)

[开始为 PC 打包](/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC)

[PC Bootstrapper](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/overviews/gr-pc-bootstrapper)

[MicrosoftGame.config](/build/core-features/common/game-config/MicrosoftGameConfig-toc)

[应用程序管理 (wdapp.exe)](/tools/tools-pc/commandlinetools/gr-wdapp)

[PC 游戏注册](/tools/tools-pc/title-registration-pc)

[平面文件安装概述](/build/core-features/common/packaging/packaging-flatfileinstall)

[命令行工具(PC 版)](/tools/tools-pc/commandlinetools/gr-commandlinetools-toc)

[PC 游戏开发(环境和工具)](/tools/tools-pc/gc-tools-pc-toc)


## Related topics

- [使用 wdapp.exe 注册 PC 游戏](/zh-CN/tools/tools-pc/title-registration-pc.md)
- [使用 MSIXVC 工具打包 PC 游戏入门](/zh-CN/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC.md)
- [视频捕获 (wdcapturesession.exe)](/zh-CN/tools/tools-pc/commandlinetools/gr-wdcapturesession.md)
- [PC 游戏开发环境与工具](/zh-CN/tools/tools-pc/gc-tools-pc-toc.md)
- [在 Unreal Engine 中使用 GDK](/zh-CN/build/gdk-and-engines/unreal/unreal.md)