在 PC 上安裝與啟動遊戲的工具
如需應用程式啟動以及使用 Gaming Runtime 啟動的詳細資訊，請參閱啟動 Win32 遊戲。
- wdapp.exe install：用於安裝遊戲的 .MSIXVC 套件。如需封裝 PC 遊戲的詳細資訊，請參閱使用 MSIXVC 封裝工具開始為 PC 封裝遊戲。如果您想為套件啟用完整的 PC 啟動載入器流程，可以透過 /bootstrapper 旗標啟用。
- wdapp.exe register：用於註冊鬆散檔案資料夾，使其能夠啟動。如需詳細資訊，請參閱 PC 遊戲註冊。從 2022 年 6 月 GDK 開始，只有在您想要啟用桌面與開始功能表殼層圖示時 (例如測試零售安裝情境時)，才需要註冊您的遊戲。
- 註冊遊戲後，它會出現在開始功能表中供選取，並可在搜尋方塊中搜尋。
- wdapp.exe launch 用於使用應用程式使用者模型識別碼 (AUMID) 或可執行檔路徑啟動遊戲。
- Windows Device Portal (WDP)：前往 Installed Apps，然後選取 Start。
在啟用 PC 啟動載入器的情況下啟動
若要以零售使用者所見的完整 PC 啟動載入器流程啟動，您必須透過 wdapp install 側載套件並使用 /bootstrapper 旗標。對於鬆散組建或未使用此旗標的安裝，PC 啟動載入器功能將僅限於在呼叫 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.
問題
您在嘗試安裝、註冊或啟動遊戲時遇到問題。修正方式
修正方式是使用下列步驟在您的電腦上啟用開發人員模式。- 開啟 設定。
- 在搜尋欄位中輸入 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 App，然後安裝一個遊戲。這會觸發從 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。您決定在 C:\MyGame 底下的子資料夾 (例如 C:\MyGame\Package) 中使用 makepkg.exe 建立套件。第一次可以成功，因為尚未產生套件，但之後再次嘗試建立套件時就會遇到此問題。除了此失敗 (由套件中有兩個 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 註冊的資料夾，會導致 Gaming Runtime 失去共用權限，之後您就會遇到此錯誤。因應措施
此問題與存取控制清單 (ACL) 有關。共用資料夾會阻止對應用程式模型的存取。也就是說，共用時容器會失去讀取檔案的權限。因應措施是依照下列步驟儲存與還原 ACL 資料。- 共用資料夾之前，執行 ‘icacls /save AclFile’ 以儲存套件資料夾的 ACL。
- 使用 Windows 檔案共用來共用資料夾。
- 若要還原先前的 ACL，請執行 ‘icacls /restore AclFile’。
wdapp.exe unregister，再執行 wdapp.exe register 來重新註冊。這會還原權限，同時保留資料夾共用。