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

# 將你的遊戲部署到開發套件

> 部署類型(Push、Run from PC、Streaming Install)、工具(XBOX Manager、xbapp、Visual Studio)以及提升迭代速度的技巧(Debug NIC、XTD、資料快取)。

<Note>
  自 2022 年 3 月版 GDK 起,**Run from PC** 支援 **Priority File Set**,可控制資料快取要快取哪些檔案——搭配 [DirectStorage](/build/console-features/console-features-overview) 使用,可讓 Run-from-PC 的迭代行為更可預測。
</Note>

## 部署類型

部署可依身分(已註冊與未註冊)及方法區分:

| 類型 | 說明 |
| - | - |
| **Push** | 將完整套件複製到開發套件的本機儲存空間。部署最慢,執行最快。 |
| **Run from PC (RfPC)** | 依需求從你的 PC 串流檔案。迭代快速;支援資料快取,可呈現貼近零售版的 I/O 行為。 |
| **Streaming Install** | 模擬零售版的 Streaming Install 體驗(逐區塊依需求安裝)。 |
| **已註冊 / 未註冊的資料夾或網路** | 用於測試鬆散檔案配置與網路情境的變化版本。 |

### Push 部署

當你希望部署的外觀與行為完全等同於零售安裝時,請使用 Push——套件會完整存放在開發套件的磁碟上。

### Run from PC

透過網路(**XBTP**)或舊式 SMB 共用串流檔案。有兩種方式:

* **透過 XBTP 的 RfPC**(建議)——需要設定防火牆,並在 PC 上啟用 XrfsSvc / XbtpLinkSvc 服務。
* **舊式以 SMB 共用為基礎的 RfPC**。

#### 設定透過 XBTP 的 RfPC

1. 在專案的部署設定中啟用 RfPC。
2. 設定防火牆(見下文)。
3. 針對大型團隊或共用的建置電腦,可選擇性調整 `XrfsSvc` 與 `XbtpLinkSvc` 的設定。

#### 防火牆設定

在開發 PC 上,允許 XrfsSvc 與 XbtpLinkSvc 程序通過 Windows Defender 防火牆。XBTP 使用的連接埠請參閱[設定開發網路存取](/zh-TW/home/setup-install/devkits/settings/configure-dev-network)。

#### 資料快取(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`)

從指令碼部署與啟動:

```text theme={null}
xbapp deploy <package>
xbapp launch <aumid>
xbapp launch /d <aumid>        REM defer execution (attach a debugger first)
```

### Visual Studio

透過 GDK 整合的 MSBuild 目標進行部署與啟動。在專案屬性中選擇部署類型。

### 其他啟動器

* **XBOX Gaming Explorer**——在 Visual Studio 內啟動已部署的遊戲。
* **DevHome**——從主機 UI 啟動遊戲。

### 覆疊資料夾

在已安裝的套件上覆疊個別檔案,以達成快速迭代——不需重新封裝,也不需重新部署。請參閱[使用覆疊資料夾進行偵錯](/build/console-features/debugging-diagnostics/debugging-with-overlay-folders)。

## 提升迭代速度

### 透過 Debug NIC 部署

開發套件的第二個 NIC(10 GbE)在部署時遠比 1 GbE 連接埠快得多。

**先決條件**

* 開發 PC 具備 10 GbE NIC,以及一台 10 GbE 交換器(或直接連線的纜線)。
* 在開發 PC 上設定 10 GbE 介面卡。
* 將你的工作區指向 Debug NIC 的 IP。

請參閱[使用開發套件的第二個 NIC](/build/console-features/debugging-diagnostics/devkit-second-nic)。

### 使用 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` 行為已調整。

## 部署疑難排解

請從以下內容開始:

* [分析與診斷錯誤](/build/console-features/debugging-diagnostics/inspecting-errors)
* [常見 GDK 問題疑難排解](/build/console-features/debugging-diagnostics/troubleshooting-common-issues)
* [部署平台問題](/build/console-features/debugging-diagnostics/troubleshooting-common-issues)(XTF 錯誤、未註冊安裝失敗、`xbtplink` 診斷)


## Related topics

- [使用 GDKX 建置並執行你的第一個主機遊戲](/zh-TW/home/build-first-title/first-console-title-walkthrough.md)
- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
- [開發新的 GDK 遊戲](/zh-TW/home/build-first-title/developing-new-titles.md)
- [XBOX 合作夥伴加入流程:取得存取權限與發行](/zh-TW/home/onboarding.md)
- [XBOX 主機遊戲的認證測試 XBOX 需求](/zh-TW/publishing/certification/console-cert-tested-requirements.md)