用于在 PC 上安装和启动游戏的工具
有关应用启动以及使用游戏运行时启动的更多信息,请参阅 启动 Win32 游戏。
- wdapp.exe install:用于安装游戏的 .MSIXVC 包。有关打包 PC 游戏的更多信息,请参阅 开始使用 MSIXVC 打包工具打包 PC 游戏。如果你希望通过包启用完整的 PC Bootstrapper 流程,可以通过 /bootstrapper 标志启用此功能。
- wdapp.exe register:用于注册一个松散文件文件夹以便能够启动。有关更多信息,请参阅 PC 游戏注册。自 2022 年 6 月版 GDK 起,只有当你希望启用桌面和开始菜单外壳图标时(例如,测试零售安装场景时),才需要注册游戏。
- 在注册游戏之后,它会以可选形式出现在开始菜单中,并可在搜索框中搜索。
- wdapp.exe launch 用于通过应用程序用户模型 ID (AUMID) 或可执行文件路径来启动游戏。
- Windows 设备门户 (WDP):转到 Installed Apps,然后选择 Start。
在启用 PC Bootstrapper 的情况下启动
若要以零售用户所看到的方式使用完整的 PC Bootstrapper 流程启动游戏,必须通过 wdapp install 旁加载一个包并使用 /bootstrapper 标志。对于松散构建或未使用该标志的安装,PC Bootstrapper 的功能将仅限于在调用 XUserAddAsync 时强制执行简化的用户模型。使用或不使用游戏标识启动
自 2022 年 6 月版 GDK 起,只要你的 MicrosoftGame.config 配置正确,无论使用何种方法启动游戏,运行时的功能都应完全一致。使用命令行参数启动
自 2022 年 6 月版 GDK 起,你可以直接启动可执行文件并直接传入任何 [launch args]。 此外,你可以使用以下方法之一,使用命令行参数启动游戏:-
在 GDK 命令提示符中执行
WdApp Launch [launch args]。 -
在命令提示符中执行
<ExecutionAlias> [launch args]。 - 在 Visual Studio 项目属性中使用命令行参数。
对 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 上启用开发人员模式。- 打开 设置。
- 在搜索字段中输入 Developer。
- 在显示的选项列表中,选择 使用开发人员功能。
- 选择 开发人员模式。将出现一个对话框,提示系统正在添加功能。请务必等待此过程完成。
错误代码 0x80073cfc:The application cannot be started. Try reinstalling the application to fix the problem.
问题
在安装过程的初始步骤之一中遇到了问题。解决方法
你可以卸载并重新安装 Gaming Runtime Services (GRTS)。按照以下步骤进行操作。- 打开 PowerShell 管理员命令提示符。
-
执行以下命令:
get-appxpackage *gamings* -
执行以下命令:
remove-package <package fullname from step 2 for the gamingservices package> - 打开 XBOX 应用,然后安装一个游戏。这会触发从 Microsoft Store 安装 gamingservices 包。
错误代码 0x87e00017:Install source was found but cannot be reached. Likely internet problem.
问题
此错误代码对应于IM_E_UNREACHABLE_INSTALL_SOURCE。如果部署系统无法访问你的文件,则会遇到此错误。但是,虽然可能是这种情况,它也可能意味着安装目录已损坏。这种情况最常见的原因是部署部分成功,但事后未正确清理。
解决方法
若要解决这些问题:-
运行应用
wdapp list。 - 在结果列表中查找已安装的任何游戏版本。
-
使用
wdapp uninstall <pfn>卸载所有游戏。 - 尝试再次安装游戏。
错误代码 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 在 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 注册过的文件夹,则会导致游戏运行时丢失共享权限,并随后遇到此错误。解决方法
此问题与访问控制列表 (ACL) 相关。共享文件夹会阻止对应用模型的访问。也就是说,共享时容器会失去读取文件的权限。要解决此问题,请按照以下步骤保存并还原 ACL 数据。- 在共享文件夹之前,运行 ‘icacls /save AclFile’ 以保存包文件夹的 ACL。
- 使用 Windows 文件共享共享文件夹。
- 若要还原以前的 ACL,请运行 ‘icacls /restore AclFile’。
wdapp.exe unregister,然后再运行 wdapp.exe register 来重新注册。这样可以恢复权限,同时保留文件夹共享。