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

# 套件

> 使用 Partner Center 中全新的 Packages 體驗來上傳、驗證、認證及發佈 XBOX 與 PC 遊戲組建，或切換至傳統 UI。

本文提供使用 Partner Center 中最新 **Packages** 體驗來上傳、驗證、認證及發佈遊戲組建的指南。在轉換至新體驗期間，仍可參閱 [Packages (傳統體驗)](/zh-TW/publishing/game-publishing/concepts/packages-overview) 一文。Microsoft 將在未來的版本中停用傳統體驗。在預覽期間，於兩種體驗之間切換不會影響現有的套件或設定。

## 在預設體驗與傳統體驗之間切換

Partner Center 支援隨時在預設體驗與傳統體驗之間切換。

* 切換不會影響您的套件、認證狀態、發佈或歷程記錄。
* 兩種體驗都會顯示相同的套件與提交。
* 如果您遇到問題或需要參考傳統 UI，請使用切換開關。

請使用最新的體驗並分享意見反應。您的意見有助於 Microsoft 改善體驗。

## Packages 概觀

**Packages** 是管理遊戲套件的單一位置。

| 動作 | 描述 |
| - | - |
| 上傳您的遊戲組建 | 將您的套件上傳至 Partner Center：XBOX 主機使用 XVC 套件，PC 使用 MSIXVC 套件。 |
| 檢閱驗證錯誤 | 當您上傳套件時，驗證錯誤會自動顯示。您需要在提交組建以進行認證之前解決錯誤。 |
| 提交認證 | 提交您的組建以進行認證。 |
| 以有限對象進行測試 | 在廣泛發行之前，使用測試版發行 (flight) 與內部團隊或合作夥伴一起測試您的組建。 |
| 發佈給玩家 | 將您的組建發佈至開發人員沙箱，或在認證後發佈至 RETAIL 沙箱。 |
| 回復組建 | 在 RETAIL 沙箱中還原先前已認證的組建，不需要重新上傳或重新認證。 |

### Packages 術語與功能

使用下列術語來了解 Packages 中可用的功能。

* **分支庫 (Packages 頁面)：** **Packages** 頁面的主要檢視，依 **Draft** 與 **Live** 分別顯示產品的分支。
* **分支：** 套件檔案及其相關設定的容器。
* **分支功能表：** 選取任何特定分支的 **...** 後可用的選項。視分支而定 (Main 或其他)，功能表選項可能包括 **View and Edit**、**Create Flight**、**Promote to Main** 和 **Delete**。
* **歷程記錄：** 特定分支或測試版發行中所採取動作的記錄。
* **Certify：** 開始提交至 XBOX 認證的選項。
* **Review and Publish：** 開始發佈至開發沙箱或 RETAIL 的選項。

## 分支：同時處理多個組建

分支可讓您同時處理遊戲的多個版本，而不會互相干擾。您可以將每個分支視為用於特定目的的獨立工作區。

### 為什麼要使用分支？

* 在一個分支上認證穩定的組建，同時在其他地方上傳並測試不同的組建。
* 測試有風險的變更，而不影響您的上線組建。
* 建立 Hotfix 分支，將緊急修正與持續進行的開發隔離。
* 獨立準備當地語系化或區域變體。

## 分支庫：草稿與上線

當您開啟 **Packages** 頁面時，會看到兩個檢視：**Draft** 與 **Live**。這些檢視代表分支的不同狀態。

### Draft 檢視

**Draft** 檢視是您的作用中工作區域。**Draft** 支援套件上傳、認證狀態檢查，以及準備組建以進行測試或發佈。**Draft** 檢視會顯示兩個區段：

* **Main 分支：** 顯示連結至您目前公開發行的工作草稿。只有 Main 分支可以發佈至 RETAIL。
* **其他分支：** 顯示所有其他分支。

<img src="https://mintlify.s3.us-west-1.amazonaws.com/microsoft-4404708b/zh-TW/publishing/game-publishing/media/packages-draft-gallery-view.png" alt="顯示草稿檢視的分支庫" />

### Draft 檢視功能表選項

每個分支都有一個功能表 (選取 **...** 圖示)，其中包含分支專屬的動作。

| 分支類型 | 可用的動作 |
| - | - |
| Main 分支 | **View & Edit：** 開啟分支以上傳及管理套件。<br />**Create flight：** 直接從此分支建立測試版發行。 |
| 其他分支 (沙箱或測試版發行) | **View & Edit：** 開啟分支以上傳及管理套件。<br />**Create flight：** 直接從此分支建立測試版發行。<br />**Promote to main branch：** 以此分支的套件取代 Main 分支的全部內容。Main 中先前的套件會被永久刪除且無法復原。<br />**Delete：** 永久刪除此分支。 |

### Live 檢視

**Live** 檢視會顯示可供玩家使用的已發佈套件。此檢視包括在 Microsoft Store 中發佈為正式推出的套件、作用中的測試版發行分支，以及處於已發佈狀態的沙箱分支。

<img src="https://mintlify.s3.us-west-1.amazonaws.com/microsoft-4404708b/zh-TW/publishing/game-publishing/media/packages-live-gallery-view.png" alt="顯示上線檢視的分支庫" />

### Live 檢視功能表選項

每個分支都有一個功能表 (選取 **More options** (**…**) 圖示)，其中包含分支專屬的動作。

| 分支類型 | 可用的動作 |
| - | - |
| Main 分支 (RETAIL) | **Rollback：** 立即還原先前已認證的組建，不需要重新上傳或重新認證。Rollback 可在 Main 分支上使用。 |
| 測試版發行分支 | **Promote to main branch：** 以此分支的套件取代 Main 分支的全部內容。Main 中先前的套件會被永久刪除且無法復原。 |
| 沙箱分支 | **Promote to main branch：** 以此分支的套件取代 Main 分支的全部內容。Main 中先前的套件會被永久刪除且無法復原。 |

<Note>
  您在 **Draft** 中工作。玩家看到的是 **Live**。在兩個檢視之間切換，可以釐清進行中的組建與已發佈內容之間的差異。
</Note>

## 如何建立分支

1. 開啟 **Packages** 頁面。
2. 在 **Draft** 檢視中，選取 **Add branch**。
3. 輸入分支的 **Name** (例如 Testing、Hotfix、Localization 或 Experiment) 與 **Description**。
4. 建立分支後，它會出現在 **Additional branches** 下。

<img src="https://mintlify.s3.us-west-1.amazonaws.com/microsoft-4404708b/zh-TW/publishing/game-publishing/media/packages-create-branch.png" alt="顯示分支顯示名稱與描述欄位的建立分支 UI" />

## 檢視及編輯分支

當您使用 **View & Edit** 開啟分支時，系統會將您帶到 **Edit branch** 頁面。使用此頁面來管理分支的套件。

<img src="https://mintlify.s3.us-west-1.amazonaws.com/microsoft-4404708b/zh-TW/publishing/game-publishing/media/packages-main-branch-view-edit-option.png" alt="顯示 View and Edit 選項的分支功能表" />

### 頂端動作列

在 **Edit branch** 頁面頂端，可使用下列動作。

| 按鈕 | 描述 |
| - | - |
| **History** | 開啟此分支上所有活動的記錄，包括認證提交、發佈事件與回復，以及執行每個動作的人員與時間等詳細資料。 |
| **Certify** | 在套件完成且所有驗證錯誤都解決後，提交分支以進行 XBOX 認證。 |
| **Save as draft** | 儲存您的變更，而不提交分支以進行認證或發佈。 |
| **Review & publish** | 開啟 [Review and publish](/zh-TW/publishing/game-publishing/concepts/modular-submission) 頁面，您可以在其中檢閱分支，並將套件發佈至開發人員沙箱與 **RETAIL**。 |

### 分支詳細資料

您也可以編輯分支的 **Display name** 與 **Description** 欄位。

* **Branch display name：** 此分支在 Partner Center 中顯示的名稱。
* **Description：** 描述分支用途的簡短備註，例如 *To be released* 或 *April hotfix*。

<img src="https://mintlify.s3.us-west-1.amazonaws.com/microsoft-4404708b/zh-TW/publishing/game-publishing/media/packages-branch-top-action-bar.png" alt="頂端動作列與可編輯的分支詳細資料" />

## 必要的套件檔案：要上傳的內容

當您上傳遊戲組建時，有些檔案是必要的，有些則是選擇性的。**Edit branch** 頁面會清楚列出每個檔案位置，以指出您可以上傳哪些檔案。

### 套件格式

您的遊戲套件格式取決於目標裝置。您提交的套件類型必須與您選取的裝置系列可用性相符。

| 裝置 | 誰可以下載 | 必要格式 | 如何建立 |
| - | - | - | - |
| XBOX 主機 | XBOX 主機上的玩家 | XVC | [開始為 XBOX 主機封裝遊戲](/zh-TW/build/core-features/common/packaging/overviews/packaging-getting-started-for-console) |
| Windows PC | Windows 10 或 Windows 11 裝置 | MSIXVC | [開始為 PC 遊戲封裝](/zh-TW/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC) |

<Tip>
  請一律為每個新套件遞增版本號碼。使用 MicrosoftGame.Config 檔案中 `Identity` 元素的 `Version` 屬性。如果您願意，可以在不同平台的套件之間使用相同的版本號碼。如果您沒有為每次新提交遞增版本號碼，XBOX 認證可能會拒絕套件。
</Tip>

### 必要檔案

| 檔案 | 描述 |
| - | - |
| 已封裝的組建 (.xvc/.msixvc) | 包含已準備遊戲組建的主要套件檔案。 |
| 加密金鑰組合 (EKB) | MSIXVC 與 XVC 套件都需要此檔案。可確保針對玩家散發進行正確的加密。在您上傳此檔案之前，套件上傳不會繼續進行。 |

### 選擇性但建議使用的檔案

| 檔案 | 描述 | 何時需要 |
| - | - | - |
| 符號 (.zip) | 啟用完整的當機傾印報告以進行偵錯。 | 建議用於所有發行。 |
| 光碟配置檔案 (.xml) | 定義以光碟為基礎之發行的光碟結構與安裝順序。 | 僅以光碟為基礎或多光碟的遊戲需要。不適用於僅限數位的遊戲。 |
| Submission Validator 記錄 (.xml) | Submission Validator 是 XBOX Game Development Kit (GDK) 的元件，會對遊戲套件執行一系列基本品質檢查。輸出為包含套件驗證結果的 XML 記錄檔。對於要進行認證或 RETAIL 發佈的套件，您必須在 Partner Center 中上傳此檔案，且記錄必須顯示整體通過的結果，或者您必須針對每個標記為 **failure** 的問題取得核准的例外。您也應該檢查記錄檔中是否有任何標記為 **warning** 的問題，並確定這些警告是預期中的。請務必確保您使用的是[最新版本的 Submission Validator](https://aka.ms/currentsubvalzip) (注意：此連結會下載最新的 zip 資料夾)。如果您使用的版本已過期，記錄中會顯示錯誤及更新指示。如果記錄中有警告或錯誤，會顯示內嵌驗證結果。 | 提交認證或發佈至 RETAIL 的套件需要此檔案。 |
| 狀態物件資料庫 (SODB) | SODB 檔案包含從您的遊戲擷取的 D3D12 管線狀態物件 (PSO) 集合。當它與您的套件一起提交至 XBOX Partner Center 時，Microsoft 會將這些狀態物件離線編譯成針對每個 GPU/驅動程式組合最佳化的預先編譯著色器資料庫 (PSDB)。PSDB 會透過 Windows Update 或 Microsoft Store 自動傳遞給玩家。這可減少或消除執行階段著色器編譯，此類編譯可能會在 PC 上造成長時間載入與遊戲中卡頓。 | 建議用於所有您想要消除著色器編譯卡頓並縮短載入時間的 PC 套件。 |

<Warning>
  光碟配置檔案與 **makepkg** 工具所產生、用於指定套件區塊配置的 layout.xml 檔案不同。請勿將此 layout.xml 上傳至光碟配置。
</Warning>

## 套件驗證：在認證前找出問題

當您上傳套件時，Partner Center 會自動驗證套件。驗證會檢查您的套件是否完整，並已準備好進行認證或發佈。在此階段解決問題，可降低認證時遭拒與失敗的風險。

* 所有分支與套件驗證錯誤都會直接顯示在 UI 中。
* 必要檔案會自動驗證。EKB 與 Submission Validator 記錄檔必須存在。
* 如果 Submission Validator 記錄包含警告或錯誤，會清楚地以內嵌方式顯示以供您檢閱。
* 如果您設定了市場專屬套件，每個變體的設定都會在允許發佈之前經過驗證。

## 預設套件：上傳及管理檔案

預設套件區段支援為分支組合套件。預設套件可在所有市場中使用。個別國家或地區的[市場專屬套件](#market-specific-packages-and-regional-variants)會另行上傳及管理。

### 上傳選項

* **Import：** 將其他分支的套件複製到此分支，不需要重新上傳。**Import** 按鈕會出現在 **Default packages** 區段頂端，與 **Upload package** 並列。
* **Upload package：** 透過拖放一或多個檔案，或使用 **Browse files** 逐一選取來上傳遊戲檔案。系統會自動偵測檔案並將其分類至正確的位置。

<img src="https://mintlify.s3.us-west-1.amazonaws.com/microsoft-4404708b/zh-TW/publishing/game-publishing/media/packages-import-option.png" alt="已上傳 XVC 與 EKB 檔案的分支" />

### 套件狀態圖示

| 狀態 | 代表的意義 | 該怎麼做 |
| - | - | - |
| Passed | 套件已通過認證。 | 不需要採取任何動作，已可發佈。 |
| Certify | 套件尚未準備好進行認證，驗證未完成或缺少檔案。 | 請先解決所有驗證錯誤。 |
| Failed | 套件未通過認證。 | 修正問題並上傳新的組建。 |
| Passed with notes | 套件已通過，但有警告。 | 檢閱備註，在下次提交之前可能需要採取動作。 |
| 刪除圖示 | 從分支永久移除此套件檔案。 | 請謹慎使用，此動作無法復原。 |

## 市場專屬套件與區域變體

**Market-specific packages** 區段會顯示為所選市場設定的所有區域變體。當您需要不同的組建以符合國家/地區專屬或法規需求時，適用此區段。

### 可用的動作

* **Import**：將其他分支的套件複製到特定市場群組。
* **Add market-specific package：** 為市場群組建立新的區域變體。
* 每個市場群組 (例如德國) 都有一個包含 **Edit** 與 **Delete** 選項的三點 (**...**) 功能表。

<img src="https://mintlify.s3.us-west-1.amazonaws.com/microsoft-4404708b/zh-TW/publishing/game-publishing/media/packages-add-market-specific-package.png" alt="顯示市場群組的市場專屬套件區段" />

### 建立新的市場專屬群組

1. 確認您正在檢視目標分支的 **Edit branch** 頁面。
2. 選取 **Add market-specific package**。
3. 指定新名稱或選取現有名稱，以輸入 **Market group name** (例如德國)。
4. 為每個群組上傳套件。

## 進階選項：預購與排程套件更新

在 **Edit branch** 頁面底部，進階選項區段提供兩項功能：使用預留位置套件的預購設定，以及排程內容更新 (CU) 的可用日期。

### 用於預購的預留位置套件

如果您在 Pricing and availability 設定中設定了預購日期，請在 **Advanced options** 中選取 **Configure placeholder package(s) to enable pre-order**，並指定最終套件的 **Expected maximum file size**。此值會出現在您產品的 Microsoft Store 產品詳細資料頁面 (PDP) 上。它會引導預購的客戶將產品安裝在具有足夠磁碟空間可容納完整套件的磁碟機上。此流程可確保產品發行時有足夠的儲存空間。

請在產品發行日期至少一週前，發佈取代預留位置的更新套件，讓客戶裝置在發行前開始安裝完整套件。當您發佈更新的套件時，請清除 **Configure placeholder package(s) to enable pre-order** 核取方塊。

<Note>
  如果您計劃使用預留位置套件，請連絡您的 Microsoft 代表。
</Note>

<img src="https://mintlify.s3.us-west-1.amazonaws.com/microsoft-4404708b/zh-TW/publishing/game-publishing/media/packages-placeholder-package.png" alt="顯示預留位置套件設定的進階選項區段" />

### 排程套件更新

CU 支援自訂發行給玩家的可用日期。選取 **Configure availability date for my package(s)** 以啟用排程。啟用後，請為每個套件設定兩個日期。

| 日期類型 | 控制的內容 | 是否必要？ |
| - | - | - |
| 可用日期 | 定義 CU 何時成為必要更新。如果未安裝更新，在連線到 XBOX 網路時將無法遊玩遊戲。 | 排程的 CU 必須設定。 |
| 預先下載日期 | 定義在已啟用此功能的裝置上，何時可以在背景下載更新。此設定可讓玩家在可用日期立即使用更新。 | 選擇性，但建議設定。 |

<Tip>
  請將您的**預先下載日期**設定為可用日期之前至少 48 小時。這樣的時間安排可讓玩家有時間在背景下載更新，並在上市當天立即開始遊玩而不必等待。
</Tip>

### 不同日期設定的結果

* **預先下載日期與可用日期相同：** 不會提前下載，更新會在該日期套用。
* **未設定預先下載日期：** 更新只會在可用日期下載。
* **未設定可用日期：** 更新在發佈至 RETAIL 沙箱後立即可用。
* **市場專屬套件：** 針對每個市場獨立設定可用日期與預先下載日期。

<img src="https://mintlify.s3.us-west-1.amazonaws.com/microsoft-4404708b/zh-TW/publishing/game-publishing/media/packages-configure-availability-date.png" alt="顯示排程套件更新設定的進階選項區段" />

## 測試版發行：以有限對象進行測試

在廣泛發佈之前，使用測試版發行以有限的使用者群組測試分支。此測試方法適用於內部測試、合作夥伴預覽或搶先體驗群組。

### 如何建立測試版發行

1. 移至 **Packages** 頁面上的 **Flights** 索引標籤。
2. 選取 **Create new flight**。
3. 輸入測試版發行的**名稱**，並選取**對象** (裝置或使用者群組)。
4. 選取您要測試的 **Branch**。
5. (選擇性) 設定**開始**與**結束**日期。
6. 選取 **Save**。測試版發行會立即出現在您的測試版發行清單中。

<Tip>
  您也可以直接從**分支庫**建立測試版發行。選取分支，然後從功能表 (**...** 圖示) 中選擇 **Create Flight**。系統會預先選取該分支，且體驗完全相同。
</Tip>

<img src="https://mintlify.s3.us-west-1.amazonaws.com/microsoft-4404708b/zh-TW/publishing/game-publishing/media/packages-create-new-flight-button.png" alt="顯示 Flights 索引標籤的分支庫" />

<img src="https://mintlify.s3.us-west-1.amazonaws.com/microsoft-4404708b/zh-TW/publishing/game-publishing/media/packages-create-new-flight.png" alt="建立新測試版發行期間的分支選取" />

### 編輯測試版發行

建立測試版發行之後，您可以視需要新增或移除對象群組。Microsoft Store 會立即反映這些變更。您也可以在建立測試版發行之後編輯其排名。

<img src="https://mintlify.s3.us-west-1.amazonaws.com/microsoft-4404708b/zh-TW/publishing/game-publishing/media/packages-branch-errors.png" alt="從分支庫選取要編輯的測試版發行" />

<img src="https://mintlify.s3.us-west-1.amazonaws.com/microsoft-4404708b/zh-TW/publishing/game-publishing/media/packages-edit-flight.png" alt="顯示警告、錯誤與可編輯欄位的 Edit flight 頁面" />

## 認證：讓您的組建獲得核准

XBOX 認證會在您將組建發佈給玩家之前，確認組建符合所有平台需求。為分支選取 **Certify**，並依照提示提交您的組建以進行 XBOX 認證。如需詳細資訊，請參閱[認證遊戲](/zh-TW/publishing/game-publishing/tutorial-xbox-managed/how-to-certify-a-game)。

| 結果 | 描述 | 後續步驟 |
| - | - | - |
| Pass | 組建符合所有需求。 | 繼續進行發佈。 |
| Certified with notes | 組建通過但附有備註。標記了輕微問題。 | 檢閱備註，決定要直接發佈或先修正。 |
| Fail | 組建不符合需求。 | 修正問題、上傳新的組建，然後重新提交。 |
| Not certified | 套件尚未提交認證，仍為草稿。 | 完成所有必要欄位與檔案、解決驗證錯誤，然後選取 **Certify** 按鈕。 |
| Under review | 認證目前正在進行中。套件正在審查中。 | 等待結果。審查期間不允許對此分支進行任何變更。 |

<Note>
  在提交任何套件以進行認證之前，請從產品頁面的導覽中選取 **Certification**，為產品完成[認證問卷](/zh-TW/publishing/game-publishing/concepts/certification/certification-supplemental-info)。
</Note>

<img src="https://mintlify.s3.us-west-1.amazonaws.com/microsoft-4404708b/zh-TW/publishing/game-publishing/media/packages-certification-status.png" alt="分支庫中顯示的每個分支認證狀態" />

## 回復：從有問題的發行中復原

當已發行的組建對玩家造成問題時，您可以還原先前已認證的組建，不需要重新上傳或重新認證。在 **Packages** 中，您可以從兩個位置觸發回復。

### 如何回復

從 **Draft 檢視 (Main 分支)**，依照下列步驟回復套件。

1. 開啟 **Main Branch** 功能表 (**...** 圖示)。
2. 從功能表選項中選取 **Rollback**。此選項可讓您快速存取 **Rollback**，而不必切換檢視。

從 **Live 檢視 (Main 分支功能表)**，依照下列步驟回復套件。

1. 移至 **Packages** 頁面上的 **Live 檢視**。
2. 在 **In the Microsoft Store** 下找到 **Main Branch**。
3. 開啟分支功能表 (**...** 圖示)，然後選取 **Rollback**。當您想要先查看目前已發佈的狀態，再決定要還原哪個組建時，請使用此進入點。

<img src="https://mintlify.s3.us-west-1.amazonaws.com/microsoft-4404708b/zh-TW/publishing/game-publishing/media/packages-rollback-package-from-live.png" alt="上線檢視中顯示的回復選項" />

### 回復時會發生什麼事

當您選取 **Rollback** 時，會開啟一個引導式強制回應視窗，在進行任何變更之前帶您完成四個步驟。

**步驟 1 - 選取先前的發佈：** 您會看到先前已認證並發佈的組建清單。選取您要還原的組建。每個項目都會顯示組建版本、認證日期以及提交者，以協助您找出正確的組建。

**步驟 2 - 檢視詳細資料：** 會顯示所選組建的完整詳細資料，例如套件名稱、版本、裝置系列與認證狀態。在繼續之前，請仔細檢閱此資訊，以確認它是正確的組建。

**步驟 3 - 比較目前與目標套件：** 會並排比較目前上線的組建與您即將還原的組建。此步驟至關重要，可讓您確切了解回復完成後玩家會看到哪些變更。請檢查在此過程中不會遺失任何重要的組建或裝置系列。

**步驟 4 - 確認並提交** 在執行回復之前，您需明確確認您了解將會發生的變更。在您確認之後，回復就會提交，較舊的穩定組建會立即上線，不需要重新上傳或重新認證。

<Note>
  使用 **History** 找出您要還原的確切組建。**History** 會顯示所有分支中的所有活動 (上傳、認證提交、發佈事件、測試版發行與回復)，以及執行者與時間。
</Note>

## 另請參閱

* [建立並上傳遊戲套件](/zh-TW/publishing/game-publishing/tutorial-xbox-managed/how-to-create-a-package)
* [封裝概觀](/zh-TW/build/core-features/common/packaging/overviews/packaging)


## Related topics

- [仅开发套件 API 参考](/zh-CN/reference/devkit/atoc-devkit-reference.md)
- [为串流设置 XBOX 开发套件](/zh-CN/build/core-features/common/game-streaming/game-streaming-setup-xbox-developer-kit.md)
- [XR-037 內容套件的相依性](/zh-TW/publishing/certification/xr/xr-037.md)
- [XR037 對內容套件的相依性](/zh-TW/publishing/certification/fma/xr-037.md)
- [XBOX 开发套件上的 Developer Home (DevHome)](/zh-CN/tools/tools-console/devhome/index.md)