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

# 使用 Microsoft Game Development Kit (GDK) 工具安裝與啟動 PC 遊戲

> 如何使用 Microsoft Game Development Kit (GDK) 工具安裝、啟動在 Microsoft Gaming Runtime 上執行的 PC 遊戲，並進行疑難排解。

本主題說明用於安裝與啟動 PC 遊戲的 Microsoft Game Development Kit (GDK) 工具。內容說明如何使用這些工具，並提供 PC 安裝與啟動問題疑難排解的深入資訊。

## 在 PC 上安裝與啟動遊戲的工具

> [!NOTE]
>
> 如需應用程式啟動以及使用 Gaming Runtime 啟動的詳細資訊，請參閱[啟動 Win32 遊戲](https://docs.xbox.com/zh-TW/build/core-features/common/game-config/MicrosoftGameConfig-Overview.md#MSGC-PCLaunch)。

Microsoft Game Development Kit (GDK) 提供下列安裝遊戲的方法。

* [wdapp.exe install](https://docs.xbox.com/zh-TW/tools/tools-pc/commandlinetools/gr-wdapp.md#wdapp_install)：用於安裝遊戲的 .MSIXVC 套件。如需封裝 PC 遊戲的詳細資訊，請參閱[使用 MSIXVC 封裝工具開始為 PC 封裝遊戲](https://docs.xbox.com/zh-TW/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC.md)。如果您想為套件啟用完整的 [PC 啟動載入器](https://docs.xbox.com/zh-TW/build/gdk-and-engines/guides/pc-bootstrapper.md)流程，可以透過 /bootstrapper 旗標啟用。

* [wdapp.exe register](https://docs.xbox.com/zh-TW/tools/tools-pc/commandlinetools/gr-wdapp.md#wdapp_register)：用於註冊鬆散檔案資料夾，使其能夠啟動。如需詳細資訊，請參閱 [PC 遊戲註冊](https://docs.xbox.com/zh-TW/tools/tools-pc/title-registration-pc.md)。從 2022 年 6 月 GDK 開始，只有在您想要啟用桌面與開始功能表殼層圖示時 (例如測試零售安裝情境時)，才需要註冊您的遊戲。

Microsoft Game Development Kit (GDK) 提供下列啟動遊戲的方法：

* 註冊遊戲後，它會出現在開始功能表中供選取，並可在搜尋方塊中搜尋。

* [wdapp.exe launch](https://docs.xbox.com/zh-TW/tools/tools-pc/commandlinetools/gr-wdapp.md#wdapp_launch) 用於使用應用程式使用者模型識別碼 (AUMID) 或可執行檔路徑啟動遊戲。

* Windows Device Portal (WDP)：前往 **Installed Apps**，然後選取 **Start**。

### 在啟用 PC 啟動載入器的情況下啟動

若要以零售使用者所見的完整 [PC 啟動載入器](https://docs.xbox.com/zh-TW/build/gdk-and-engines/guides/pc-bootstrapper.md)流程啟動，您必須透過 wdapp install 側載套件並使用 /bootstrapper 旗標。對於鬆散組建或未使用此旗標的安裝，PC 啟動載入器功能將僅限於在呼叫 XUserAddAsync 時強制執行簡化的使用者模型。

### 使用與不使用遊戲身分識別啟動

自 2022 年 6 月 GDK 起，只要您的 [MicrosoftGame.config](https://docs.xbox.com/zh-TW/build/core-features/common/game-config/MicrosoftGameConfig-Overview.md) 設定正確，無論使用哪種方法啟動遊戲，執行階段的運作方式都應相同。

### 使用命令列引數啟動

自 2022 年 6 月 GDK 起，您只需直接啟動可執行檔並直接傳入任何 \[launch args] 即可。

此外，您也可以使用下列其中一種方法，以命令列引數啟動遊戲：

* 從 GDK 命令提示字元執行 `WdApp Launch [launch args]`。

* 在命令提示字元中執行 `<ExecutionAlias> [launch args]`。

* Visual Studio 專案屬性中的命令列引數。

如需使用 Execution Alias 的詳細資訊，請參閱 [ExecutionAlias](https://docs.xbox.com/zh-TW/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-executable.md#MicrosoftGameConfig-Alias)。

## 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.

#### 問題

您在嘗試安裝、註冊或啟動遊戲時遇到問題。

#### 修正方式

修正方式是使用下列步驟在您的電腦上啟用開發人員模式。

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 App，然後安裝一個遊戲。這會觸發從 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*。您決定在 *C:\MyGame* 底下的子資料夾 (例如 *C:\MyGame\Package*) 中使用 [makepkg.exe](https://docs.xbox.com/zh-TW/build/core-features/common/packaging/deployment/makepkg.md) 建立套件。第一次可以成功，因為尚未產生套件，但之後再次嘗試建立套件時就會遇到此問題。除了此失敗 (由套件中有兩個 *AppxManifest.xml* 檔案所造成) 之外，在 *C:\MyGame* 上執行 *makepkg.exe* 也會嘗試將現有的 .msixvc 封裝到新套件中 (除非您已將其從 genmap 中排除)。

#### 修正方式

若要修正此問題，請確定您的套件目錄位於包含 *MicrosoftGame.config* 的目錄之外。

### 錯誤碼 0x80070490：Element not found

#### 問題

如果嘗試使用 `wdapp install` 安裝 .XVC (XBOX 套件的封裝格式)，就會發生此問題。

#### 因應措施

請確定僅對 .MSIXVC 套件 (PC 套件的封裝格式) 使用 `wdapp install`。

### 遊戲資料夾共用時透過 wdapp 啟動發生錯誤

#### 問題

如果您使用 Windows 檔案共用來共用先前已使用 [wdapp.exe register](https://docs.xbox.com/zh-TW/tools/tools-pc/commandlinetools/gr-wdapp.md#wdapp_register) 註冊的資料夾，會導致 Gaming Runtime 失去共用權限，之後您就會遇到此錯誤。

```
    '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 檔案的完整路徑。例如：

正確：

*wdapp install "c:\MyGame\GDKBuildFolder\GdkGame\_1.0.0.0\_x64\_\_pmsdash4d.msixvc"*

不正確 (缺少 .msixvc 的完整路徑)：

*wdapp install "c:\MyGame\GDKBuildFolder"*

### 錯誤碼 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 Store 未偵測到目標磁碟機。請確定目標磁碟機出現在本機電腦上「設定 -> 儲存體設定 -> 變更新內容的儲存位置」中的「新的應用程式將儲存至：」下拉式清單中。如果磁碟機未出現，請檢查磁碟機的健康狀態，並確定本機電腦已安裝最新的 Windows 更新。

### 錯誤碼 0x80072F78：WININET\_E\_INVALID\_SERVER\_RESPONSE

#### 問題

執行 wdapp install 命令時遇到 "0x80072F78" 錯誤。

#### 修正方式

此問題與防火牆 Proxy 設定封鎖 "settings-win.data.microsoft.com" 這個位址有關。安裝 PC GDK 遊戲時，需要此位址才能正確快取安裝設定。請確定您的防火牆軟體允許此位址。

## 另請參閱

[開始使用 Microsoft Game Development Kit](https://docs.xbox.com/zh-TW/home/setup-install/get-started.md)

[開始為 PC 進行封裝](https://docs.xbox.com/zh-TW/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC.md)

[PC 啟動載入器](https://docs.xbox.com/zh-TW/build/gdk-and-engines/guides/pc-bootstrapper.md)

[MicrosoftGame.config](https://docs.xbox.com/zh-TW/build/core-features/common/game-config/MicrosoftGameConfig-toc.md)

[應用程式管理 (wdapp.exe)](https://docs.xbox.com/zh-TW/tools/tools-pc/commandlinetools/gr-wdapp.md)

[PC 遊戲註冊](https://docs.xbox.com/zh-TW/tools/tools-pc/title-registration-pc.md)

[一般檔案安裝概觀](https://docs.xbox.com/zh-TW/build/core-features/common/packaging/packaging-flatfileinstall.md)

[命令列工具 (適用於 PC)](https://docs.xbox.com/zh-TW/tools/tools-pc/commandlinetools/gr-commandlinetools-toc.md)

[PC 遊戲開發 (環境與工具)](https://docs.xbox.com/zh-TW/tools/tools-pc/gc-tools-pc-toc.md)


## Related topics

- [PC 遊戲註冊](https://docs.xbox.com/zh-TW/tools/tools-pc/title-registration-pc.md)
- [PC 遊戲開發環境與工具](https://docs.xbox.com/zh-TW/tools/tools-pc/gc-tools-pc-toc.md)
- [螢幕擷取 (wdcapture.exe)](https://docs.xbox.com/zh-TW/tools/tools-pc/commandlinetools/gr-wdCapture.md)
- [影片擷取 (wdcapturesession.exe)](https://docs.xbox.com/zh-TW/tools/tools-pc/commandlinetools/gr-wdcapturesession.md)
- [PC 開發的命令列工具](https://docs.xbox.com/zh-TW/tools/tools-pc/commandlinetools/gr-commandlinetools-toc.md)