自 2022 年 3 月版 GDK 起,Run from PC 支援 Priority File Set,可控制資料快取要快取哪些檔案——搭配 DirectStorage 使用,可讓 Run-from-PC 的迭代行為更可預測。
部署類型
部署可依身分(已註冊與未註冊)及方法區分:Push 部署
當你希望部署的外觀與行為完全等同於零售安裝時,請使用 Push——套件會完整存放在開發套件的磁碟上。Run from PC
透過網路(XBTP)或舊式 SMB 共用串流檔案。有兩種方式:- 透過 XBTP 的 RfPC(建議)——需要設定防火牆,並在 PC 上啟用 XrfsSvc / XbtpLinkSvc 服務。
- 舊式以 SMB 共用為基礎的 RfPC。
設定透過 XBTP 的 RfPC
- 在專案的部署設定中啟用 RfPC。
- 設定防火牆(見下文)。
- 針對大型團隊或共用的建置電腦,可選擇性調整
XrfsSvc與XbtpLinkSvc的設定。
防火牆設定
在開發 PC 上,允許 XrfsSvc 與 XbtpLinkSvc 程序通過 Windows Defender 防火牆。XBTP 使用的連接埠請參閱設定開發網路存取。資料快取(XBOX Series X Dev Kit)
資料快取會鏡像 RfPC 提供的檔案,使 I/O 行為貼近 Push 部署——在迭代 DirectStorage 程式碼路徑時特別有用。- 透過 DevHome 或 XBOX Manager 啟用/管理快取。
- Priority File Set(2022 年 3 月版 GDK+)可讓你預先快取特定檔案,提高可預測性。規則以 Priority File Set 結構描述撰寫,可從命令列或 Visual Studio 套用。支援自動產生。
舊式 SMB 共用 RfPC
仍受支援。需要在開發 PC 上建立指向套件配置的 SMB 共用。支援使用符號連結重新導向套件的部分內容。Streaming Install
在遊戲執行時逐區塊安裝——可驗證你的遊戲在零售環境將使用的 Streaming Install 程式碼路徑。工具
XBOX Manager
- Default Deploy
- Deploy/Install Application 精靈
- 拖曳部署
- Folder Explorer 部署
- 啟動已部署的遊戲
- Games & Apps 清單會顯示部署類型(Push、RfPC、未註冊)。
命令提示字元(xbapp)
從指令碼部署與啟動:
Visual Studio
透過 GDK 整合的 MSBuild 目標進行部署與啟動。在專案屬性中選擇部署類型。其他啟動器
- XBOX Gaming Explorer——在 Visual Studio 內啟動已部署的遊戲。
- DevHome——從主機 UI 啟動遊戲。
覆疊資料夾
在已安裝的套件上覆疊個別檔案,以達成快速迭代——不需重新封裝,也不需重新部署。請參閱使用覆疊資料夾進行偵錯。提升迭代速度
透過 Debug NIC 部署
開發套件的第二個 NIC(10 GbE)在部署時遠比 1 GbE 連接埠快得多。 先決條件- 開發 PC 具備 10 GbE NIC,以及一台 10 GbE 交換器(或直接連線的纜線)。
- 在開發 PC 上設定 10 GbE 介面卡。
- 將你的工作區指向 Debug NIC 的 IP。
使用 XTD(XBOX Transfer Device)部署
XTD 可透過 Thunderbolt 分擔大量傳輸工作。- 並非每台開發套件都支援 XTD,請查閱 XBOX 零售與開發套件硬體規格中的相容性清單。
- 在開發 PC 上設定 XTD,並將 Thunderbolt 纜線連接到開發套件。
- 使用標準診斷工作流程進行疑難排解(見下文)。
- XTD 也能加速 PIX 擷取與分析。
- 將 XTD 與 Debug NIC 搭配使用,可達到最快的迭代速度。
GDK 帶來的變更
- 支援並存的封裝組建——可同時安裝同一遊戲的多個組建。
- XBOX One (ERA) 遊戲透過 GDK 路徑部署。
- AUMID 變更——如果你是從 XDK 移轉,請驗證啟動指令碼。
- Unified scratch 更新——
TitleScratch/SystemScratch行為已調整。
部署疑難排解
請從以下內容開始:- 分析與診斷錯誤
- 常見 GDK 問題疑難排解
- 部署平台問題(XTF 錯誤、未註冊安裝失敗、
xbtplink診斷)