应用程序管理 (wdapp.exe) 是一种命令行工具，用于安装和启动电脑 Microsoft Game Development Kit (GDK) 游戏。
wdapp 提供下表中所述的子命令和函数。
| 命令 | 说明 |
|---|---|
| wdapp launch | 通过指定应用程序的应用程序用户模型 ID (AUMID) 启动应用程序。 |
| wdapp terminate | 终止给定的程序包。 请注意，这仅适用于 MSIXVC 安装的程序包。 |
| wdapp list | 列出电脑上的所有旁加载应用程序。 |
| wdapp listdlc | 列出所有已安装和部署的可下载内容包 |
| wdapp gamefolder | 查询或设置驱动器的安装文件夹。 |
| wdapp update | 从网络共享或本地系统文件路径流式处理打包的版本更新。 |
| wdapp install | 通过启动使用 makepkg 创建的应用程序包的流式安装来部署应用程序。 |
| wdapp register | 在指定文件夹中注册应用程序。 |
| wdapp uninstall | 终止和取消注册包中的所有进程。 |
| wdapp unregister | 取消注册应用程序。 |
| wdapp 迁移 | 迁移到平面文件安装。 |
部署、安装、更新、列出和删除应用程序
wdapp launch
启动通过提供 AUMID 或可执行文件路径定义的应用程序。
| wdapp launchAUMID | Executable |
|
选项 |
说明 |
|---|---|
| AUMID | 指定正在启动的应用程序的 AUMID。 wdapp launch 将采用 AUMID 选项或 Executable 选项，但指定时不能同时使用这两项。 |
| Executable | 指定正在启动的应用程序的可执行文件路径。 wdapp launch 将采用 AUMID 选项或 Executable 选项，但指定时不能同时使用这两项。 |
| WaitToExit | 启动应用程序并阻止直到游戏退出。 当游戏退出时，wdapp 将退出并返回游戏的退出代码。 |
| log | 将 stdout 和 stdin 重定向到暂存驱动器上的文件。 如果未指定前缀，则文件将命名为 latest_stdout.txt 和 latest_stderr.txt。 如果超过 32 个字符，则前缀将被截断。 |
| 显示 all | launchResult | terminateResult | targetTerminateReason | exitCode |
all - 将显示所有结果。 launchResult - 游戏未能启动的原因。 如果显示 S_OK，则游戏已成功启动。 terminateResult - 达到终止状态的原因。 如果显示 S_OK，则通过适当的 PLM 流正常终止。 targetTerminateReason - 如果可用，说明终止有针对性的原因，否则为 S_FALSE exitCode - 游戏在进程退出时返回的退出代码。 使用 WaitToExit 参数确定游戏退出时显示的内容。 |
wdapp terminate
终止给定的程序包。 请注意，这仅适用于 MSIXVC 安装的程序包。
| wdapp terminateAUMID | PackageFullName |
|
选项 |
说明 |
|---|---|
| AUMID | 指定要终止的应用程序的 AUMID (AppUserModelId)。 wdapp terminate 将采用 AUMID 选项或 PackageFullName 选项，但在指定时不会同时使用这两个选项。 |
| PackageFullName | 指定要终止的 PackageFullName。 wdapp terminate 将采用 AUMID 选项或 PackageFullName 选项，但在指定时不会同时使用这两个选项。 |
wdapp list
| wdapp list |
|
选项 |
说明 |
|---|---|
| /d | 提供有关列出的应用程序的详细信息。 |
| /json | 以 JSON 格式设置响应的格式 |
wdapp listdlc
| wdapp listdlc |
|
选项 | 说明 |
|---|---|
| /d | 列出所有已安装和部署的可下载内容包 |
| /json | 以 JSON 格式设置响应的格式 |
wdapp gamefolder
| wdapp gamefolder <DriveLetter>: [/set <FolderPath>] |
|
选项 |
说明 |
|---|---|
| <DriveLetter>: | 指定流式安装将在其上发生的 targert 驱动器。 默认为根文件夹中名为 XboxGames 的 OS 驱动器。 |
| /设置 | 为 <DriveLetter> 中指定的驱动器设置流式安装文件夹。 默认为 XboxGames。 |
wdapp update
| wdapp updatepackagepath [/l|/AllChunks] [/b] [/a] [/m] [/ContentTypes=[semicolon-delimited specifier list] ] [/Languages=[semicolon-delimited specifier list] ] [/Devices=[semicolon-delimited specifier list] ] [/Tags=[semicolon-delimited specifier list] ] |
|
选项 |
说明 |
|---|---|
| packagepath | 指定用于更新的包文件的路径。 |
| /l | 指定在收到启动区块后更新停止。 |
| /AllChunks | 指定更新将强制安装所有区块，即使它们未更改。 |
| /b | 指定是否允许更新回退到以前的版本。 |
| /a | 将更新注册为可用。 |
| /m | 将更新注册为强制。 |
| /ContentTypes=[分号分隔的说明符列表] | 指定默认情况下要更新哪些 ContentTypes 说明符。 |
| /Languages=[分号分隔的说明符列表] | 指定默认情况下要更新哪些语言说明符。 |
| /Devices=[分号分隔的说明符列表] | 指定默认情况下要更新哪些设备说明符。 |
| /Tags=[分号分隔的说明符列表] | 指定默认情况下要更新哪些标记说明符。 指定“/Tags=”可清除所有标记。 |
wdapp install
通过启动使用 makepkg 创建的应用程序包的流式安装来部署应用程序。
install 命令反映当在零售版电脑上安装应用程序时将发生的流式安装过程。
有关测试流式安装包的更多信息，请参阅流式安装和智能交付：概述。
| wdapp install [/l|/AllChunks] [/bootstrapper] [/drive=[drive letter] ] [ /ContentTypes=[semicolon-delimited specifier list] ] [/Languages=[semicolon-delimited specifier list] ] [/Devices=[semicolon-delimited specifier list] ] [/Tags=[semicolon-delimited specifier list] ] [/Drive [Optional] ] [/tm] [/l] [/v] [/w] ] { packagepath | packageURI } |
| 选项 | 说明 |
|---|---|
| /bootstrapper | 在安装操作上使用 /bootstrapper 标志将在游戏启动时调用 电脑引导程序。 这将导致游戏像标准零售安装一样运行，在应用程序有机会运行任何代码之前调用电脑引导程序，应用程序将显示为电脑引导程序的子进程。 如果未设置此项，则在进行适用的运行时调用（例如 XUserAddAsync 进行登录验证）时，将调用任何必需的先决条件检查。 |
| /Features=[分号分隔的功能列表] | 指示默认情况下要安装哪些功能。 不能与 /Tags 一起使用。 |
| /Recipes=[分号分隔的过程列表] | 指示默认情况下要安装哪些脚本。 不能与 /Tags 一起使用。 |
| { packagepath | packageURI } | 通过提供包路径（它是开发计算机上的路径）或包 URI（它是 URI）来指定应用程序包的位置。 要从刻录光盘（DVD 或蓝光光盘）安装，可以为 xbapp install 提供 xo:\ 驱动器前缀（后跟文件名）：wdapp install /w xo:\packagepath |
| /Languages=[分号分隔的说明符列表] | 指定默认情况下要安装哪些语言说明符。 |
| /Devices=[分号分隔的说明符列表] | 指定默认情况下要安装哪些设备说明符。 |
| /Tags=[分号分隔的说明符列表] | 指定默认情况下要安装哪些标记说明符。 指定“/Tags=”可清除所有标记。 |
| /drive=[驱动器号] | 指定应用程序应安装到的目标驱动器（不使用默认值）。 |
| /tm | 在传输所有文件后打印一个传输性能指标摘要。 |
| /l | 指定在收到启动区块后安装停止。 |
| /AllChunks | 指定安装将强制安装所有区块。 |
| /v | 显示详细的消息。 |
wdapp register
在指定文件夹中注册应用程序。
| wdapp register folder_path |
|
选项 |
说明 |
|---|---|
| folder_path | 指定相对于包含 [MicrosoftGame.config] ( 的应用程序根目录的文件夹路径。/../../features/common/game-config/MicrosoftGameConfig-toc.md) 应从中注册游戏的文件。 |
wdapp uninstall
终止和取消注册包中的所有进程。
| wdapp uninstall package_full_name |
|
选项 |
说明 |
|---|---|
| 包完整名称 | 指定应用程序的完整包名称。 例如，mygame_1 .0. 0_neutral__r9wapr0zzdgy。 |
wdapp unregister
终止和取消注册包。
| wdapp unregister package_full_name |
|
选项 |
说明 |
|---|---|
| 包完整名称 | 指定应用程序的完整包名称。 例如，mygame_1 .0. 0_neutral__r9wapr0zzdgy。 |
wdapp 迁移
将现有 MSIXVC 安装迁移到平面文件安装格式。 在使用 2022 年 3 月 Microsoft 游戏开发工具包 (GDK) 时，此命令用于将已安装的现有游戏的安装格式迁移到 平面文件安装 格式。
| wdapp migrate <PackageFullName> |
|
选项 |
说明 |
|---|---|
| <PackageFullName> | 指定应用程序的完整包名称。 例如，mygame_1 .0. 0_neutral__r9wapr0zzdgy。 |
备注
更多有关安装和启动电脑 Microsoft 游戏开发工具包 (GDK) 游戏的信息，请参阅利用 Microsoft 游戏开发工具包工具安装和启动电脑游戏。