> ## 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. # 開始使用適用於 PC 的 MSIXVC2 封裝 > 開始使用適用於 PC 的 MSIXVC2 封裝 使用下列步驟建立 MSIXVC2 套件，您可以在開發 PC 上側載該套件進行測試，然後上傳至 Partner Center 進行發佈。 如需此格式及其優點的背景資訊，請參閱 [MSIXVC2 封裝概觀](/zh-TW/build/core-features/common/packaging/overviews/packaging-msixvc2-overview)。 MSIXVC2 自 2026 年 10 月版 Microsoft Game Development Kit (GDK) 起正式推出。您可以側載 MSIXVC2 套件進行測試，並將其提交認證以公開發行。 部分 MSIXVC2 功能和改進是透過 Gaming Runtime Services 的更新提供，不需要更新 GDK。這些增強功能推出時，您會自動收到。 如果您要為 XBOX 主機進行封裝，請參閱[開始為 XBOX 主機進行封裝](/zh-TW/build/core-features/common/packaging/overviews/packaging-getting-started-for-console)。主機遊戲會繼續使用 XVC。`makepkg` 工具可處理這兩種格式。 ## 開始之前 * 開發 PC 上安裝 **Windows 10** 版本 18362 或更新版本。 * 已安裝 **2026 年 10 月版 GDK 或更新版本**。GDK 包含 `makepkg.exe`。 從 2026 年 10 月版 GDK 開始，受控封裝工具命名為 `makepkg.exe`。舊版 MakePkg.exe 和暫時性的 `makepkg2.exe` 名稱已移除。 * **Partner Center 產品** 您需要發行者身分識別、套件名稱和 Store ID。 * 在目標測試 PC 上啟用**開發人員模式**。 * 在任何要安裝或執行 MSIXVC2 套件的裝置上設定 **MSIXVC2 開發人員模式登錄機碼**。如需詳細資訊，請參閱[步驟 7](#step-7-test-your-package-locally)。 ## 步驟 1：準備您的內容 將遊戲的所有來源素材放在單一目錄中。移除封裝系統無法使用或不適合在零售套件中發行的任何檔案。 如果存在下列檔案，請將其移除： * PDB 檔案。 * 任何對其他 PC 遊戲商店的參照，例如資產、二進位檔等。 * 通用 Windows 平台 (UWP) 和 Appx「足跡」檔案，包括 AppxSignature.p7x 和 AppxBlockMap.xml。 ## 步驟 2：建立您的 MicrosoftGame.config 在遊戲內容的根目錄中建立 MicrosoftGame.config 檔案。此設定檔可搭配 MSIXVC 使用。您現有的 MicrosoftGame.config 無須變更即可搭配 MSIXVC2 使用。 您可以手動建立此檔案，或使用 [MicrosoftGame.config 編輯器](/zh-TW/build/core-features/common/game-config/MicrosoftGameConfig-Editor)建立，此編輯器會直接從您的 Partner Center 專案同步身分識別和 ID 值。 如需 MicrosoftGame.config 範例檔案，請參閱[開始使用適用於 PC 的 MSIXVC](/zh-TW/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC#sample-microsoftgameconfig)。 ## 步驟 3：識別 Visual C/C++ 執行階段相依性 請確定您的 MicrosoftGame.config 列出所有 Visual C/C++ 執行階段相依性，或明確將這些相依性複製到套件承載中。如需詳細資訊，請參閱[架構套件相依性](/zh-TW/build/core-features/common/packaging/packaging-framework-packages)。 ## 步驟 4：建立您的圖示 將圖示檔案放在遊戲內容的根資料夾 (或子目錄) 中，並縮放為 MicrosoftGame.config `ShellVisuals` 區段中指定的大小。[MicrosoftGame.config 編輯器](/zh-TW/build/core-features/common/game-config/MicrosoftGameConfig-Editor)可以從單一來源影像產生這些影像。 ## 步驟 5：產生配置對應檔 (選用) 此步驟為選用。根據預設，MSIXVC2 會將所有內容封裝到單一區塊中。只有在您想要將內容分割成多個區塊或新增 Intelligent Delivery 標籤時，才需要配置對應檔。 若要產生配置對應檔，請開啟 GDK 命令提示字元並執行下列命令： ```text theme={null} makepkg genmap /f layout.xml /d ``` 此命令會建立配置對應檔，定義如何將內容組織成區塊。產生的檔案包含單一區塊。您可以視需要編輯檔案，將內容分割成多個區塊或新增 Intelligent Delivery 標籤。 使用 MSIXVC2 時，重新排序區塊或在區塊之間移動檔案不會影響內容更新的大小。您可以自由組織配置，而不必擔心 MSIXVC 中存在的更新懲罰。 如需配置檔案的詳細資訊，請參閱[部署套件結構描述](/zh-TW/build/core-features/common/packaging/deployment/atoc-deployment-schema)。 ## 步驟 6：建立您的 MSIXVC2 套件 建立套件： ```text theme={null} makepkg pack /msixvc2 /f layout.xml /d /pc /pd ``` 主要選項： | 選項 | 描述 | | - | - | | `/msixvc2` | 產生 MSIXVC2 套件。若沒有此選項，命令會產生 MSIXVC 套件。從 2027 年 4 月版 GDK 開始，`makepkg` 預設會建立 MSIXVC2 套件。 | | `/f ` | 指定配置對應檔。如果省略，會產生預設的單一區塊配置。 | | `/d ` | 包含遊戲內容和 MicrosoftGame.config 的目錄。 | | `/pc` | 產生在 PC 上使用的套件。 | | `/pd ` | 放置所產生套件的目錄。 | | `/compress ` | 壓縮輸出。可用的方法：`Automatic` (預設)、`None`。`Automatic` 會對 MSIXVC2 套件使用 Brotli。 | ## 步驟 7：在本機測試您的套件 在目標 PC 上啟用開發人員模式。安裝 MSIXVC2 套件之前，請在目標裝置上設定下列登錄機碼： ```text theme={null} reg add HKLM\SOFTWARE\Microsoft\GamingServices /v Xvc2DeveloperMode /t REG_DWORD /d 1 /f ``` 或者，您也可以使用 `packageutil` 啟用 MSIXVC2 開發人員模式： ```text theme={null} packageutil set msixvc2 on ``` 若要停用 MSIXVC2 開發人員模式： ```text theme={null} packageutil set msixvc2 off ``` `packageutil set` 命令需要 2026 年 10 月版 GDK 或更新版本。 在未來的 GDK 版本推出之前，都需要此登錄機碼。若沒有它，MSIXVC2 套件將無法安裝。請從提高權限 (系統管理員) 的命令提示字元執行此命令。 接著安裝您的套件： ```text theme={null} wdapp install ``` MSIXVC2 套件會安裝到 `[drive]:\XboxGames` 資料夾。檔案會以其原始形式安裝，您可以直接存取。此安裝位置與使用 [Flat File Install](/zh-TW/build/core-features/common/packaging/packaging-flatfileinstall) 的 MSIXVC 套件所使用的位置相同。 您可以將在本機側載的同一個套件上傳至 Partner Center，不需要另外建立提交套件的步驟。 ## 步驟 8：上傳至 Partner Center 請將 MSIXVC2 套件發佈至 Partner Center 中的**新分支** (例如 `msixvc2`)。請勿將 MSIXVC2 套件上傳至與現有 MSIXVC 套件相同的分支。這兩種格式在分支內無法互換，而將分支從 MSIXVC2 還原回 MSIXVC 需要完整上傳和下載套件。如需詳細資訊，請參閱[套件分支最佳做法](/zh-TW/build/core-features/common/packaging/overviews/packaging-msixvc2-overview#package-branch-best-practices)。 上傳至 Partner Center 有兩個選項。 ### 選項 A：上傳預先建置的套件 如果您已在步驟 6 中建立套件，請直接上傳： ```text theme={null} makepkg upload /pd /branch msixvc2 ``` ### 選項 B：從鬆散檔案上傳 (單一命令工作流程) 您可以將封裝和上傳合併為單一命令。此命令會直接從組建輸出上傳，而不會建立本機套件檔案： ```text theme={null} makepkg upload /d /msixvc2 /pc /branch msixvc2 ``` ### 上傳選項 | 選項 | 描述 | | - | - | | `/branch ` | 要上傳到的分支。預設為 `main`。請使用專用的 MSIXVC2 分支。 | | `/flight ` | 要上傳到的測試版。不能與 `/branch` 一起使用。 | | `/market ` | 要上傳到的市場。預設為 `default`。 | | `/storeid ` | Store ID。如果未指定，會從套件中擷取。 | | `/auth ` | 驗證方法。預設為 `CacheableBrowser`。如需 CI/CD 選項，請參閱[驗證方法](#authentication-methods)。 | 如需上傳選項的完整清單，請參閱 [Make package (makepkg.exe)](/zh-TW/build/core-features/common/packaging/deployment/makepkg)。 ## 驗證方法 `upload` 命令支援適用於不同環境的多種驗證方法。 | 方法 | 使用案例 | | - | - | | `CacheableBrowser` | 預設。開啟瀏覽器進行互動式登入。快取認證以供後續上傳使用。 | | `Browser` | 開啟瀏覽器進行互動式登入，但不快取。 | | `AzureCli` | 使用 Azure CLI 認證。適用於已透過 `az login` 驗證的情況。 | | `AzurePipelines` | 使用 Azure Pipelines 服務連線。非常適合 Azure DevOps CI/CD 管線。 | | `ManagedIdentity` | 使用 Azure 受控識別。需要 `/clientid`。 | | `ManagedIdentityFederated` | 使用同盟受控識別。需要 `/clientid` 和 `/resourceid`。 | | `ClientSecret` | 使用用戶端識別碼和密碼。需要 `/clientid` 和 `/clientsecret`。 | | `ClientCertificate` | 使用用戶端憑證。需要 `/clientid` 和 `/certthumbprint`。 | | `Environment` | 使用環境變數中的認證。 | | `Default` | 依序嘗試多種方法。 | **範例：CI/CD 管線上傳** ```text theme={null} makepkg upload /pd /auth AzurePipelines /branch ``` **範例：服務主體上傳** ```text theme={null} makepkg upload /pd /auth ClientSecret /clientid /clientsecret /branch ``` ## 步驟 9：在 Partner Center 中驗證並發佈 上傳之後，請使用 Partner Center 驗證並發佈您的套件。提交流程與 MSIXVC 相同：選取您的套件、設定供應情況，然後提交。 您可以將 MSIXVC2 套件發佈至沙箱進行測試，並將其提交認證以公開發行。 請讓現有的 MSIXVC 管線繼續用於正式發行。使用另一個 Partner Center 分支來評估 MSIXVC2，以便並排比較結果，並在正式推出 (GA) 時移轉至 MSIXVC2，而不會中斷您的上線遊戲。 ## 比較更新大小 若要評估 MSIXVC2 對您遊戲的好處，請從兩個連續的組建建立套件並進行比較： ```text theme={null} makepkg pack /msixvc2 /f layout.xml /d /pc /pd makepkg pack /msixvc2 /f layout.xml /d /pc /pd /priorpackage ``` 將產生的更新大小與對等的 MSIXVC 組建進行比較，以查看差異。 ## 搭配 MSIXVC2 使用 Intelligent Delivery Intelligent Delivery 搭配 MSIXVC2 的運作方式與搭配 MSIXVC 相同。您可以在配置對應檔中定義區塊，並設定語言、裝置或標籤規範。主要差異在於重新組織區塊或在區塊之間移動檔案，不會影響內容更新的大小。 如需詳細資訊，請參閱[串流安裝與 Intelligent Delivery：概觀](/zh-TW/build/core-features/common/packaging/overviews/streaming_install-intelligent_delivery)。 ## 另請參閱 [MSIXVC2 封裝概觀](/zh-TW/build/core-features/common/packaging/overviews/packaging-msixvc2-overview) [Make package (makepkg.exe)](/zh-TW/build/core-features/common/packaging/deployment/makepkg) [開始使用適用於 PC 的 MSIXVC](/zh-TW/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC) [使用 MSIXVC2 進行內容更新](/zh-TW/build/core-features/common/packaging/packaging-updates-msixvc2) [MSIXVC2 加密模型](/zh-TW/build/core-features/common/packaging/packaging-encryption-msixvc2) [XBOX Game Package Manager](/zh-TW/build/core-features/common/packaging/xgpm) [自動化套件上傳](/zh-TW/build/core-features/common/packaging/package-uploader) [Flat File Install 概觀](/zh-TW/build/core-features/common/packaging/packaging-flatfileinstall) [部署套件結構描述](/zh-TW/build/core-features/common/packaging/deployment/atoc-deployment-schema) ## Related topics - [MSIXVC2 打包概述](/zh-CN/build/core-features/common/packaging/overviews/packaging-msixvc2-overview.md) - [针对 PC 的 MSIXVC2 打包入门](/zh-CN/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC-msixvc2.md) - [MSIXVC2 パッケージング概要](/ja-jp/build/core-features/common/packaging/overviews/packaging-msixvc2-overview.md) - [使用 MSIXVC 工具打包 PC 游戏入门](/zh-CN/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC.md) - [MSIXVC ツールを使用した PC タイトル パッケージングの概要](/ja-jp/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC.md)