MSIXVC2 自 2026 年 10 月版 Microsoft Game Development Kit (GDK) 起正式推出。您可以側載 MSIXVC2 套件進行測試,並將其提交認證以公開發行。
部分 MSIXVC2 功能和改進是透過 Gaming Runtime Services 的更新提供,不需要更新 GDK。這些增強功能推出時,您會自動收到。
如果您要為 XBOX 主機進行封裝,請參閱開始為 XBOX 主機進行封裝。主機遊戲會繼續使用 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。
步驟 1:準備您的內容
將遊戲的所有來源素材放在單一目錄中。移除封裝系統無法使用或不適合在零售套件中發行的任何檔案。 如果存在下列檔案,請將其移除:- PDB 檔案。
- 任何對其他 PC 遊戲商店的參照,例如資產、二進位檔等。
- 通用 Windows 平台 (UWP) 和 Appx「足跡」檔案,包括 AppxSignature.p7x 和 AppxBlockMap.xml。
步驟 2:建立您的 MicrosoftGame.config
在遊戲內容的根目錄中建立 MicrosoftGame.config 檔案。此設定檔可搭配 MSIXVC 使用。您現有的 MicrosoftGame.config 無須變更即可搭配 MSIXVC2 使用。 您可以手動建立此檔案,或使用 MicrosoftGame.config 編輯器建立,此編輯器會直接從您的 Partner Center 專案同步身分識別和 ID 值。 如需 MicrosoftGame.config 範例檔案,請參閱開始使用適用於 PC 的 MSIXVC。步驟 3:識別 Visual C/C++ 執行階段相依性
請確定您的 MicrosoftGame.config 列出所有 Visual C/C++ 執行階段相依性,或明確將這些相依性複製到套件承載中。如需詳細資訊,請參閱架構套件相依性。步驟 4:建立您的圖示
將圖示檔案放在遊戲內容的根資料夾 (或子目錄) 中,並縮放為 MicrosoftGame.configShellVisuals 區段中指定的大小。MicrosoftGame.config 編輯器可以從單一來源影像產生這些影像。
步驟 5:產生配置對應檔 (選用)
此步驟為選用。根據預設,MSIXVC2 會將所有內容封裝到單一區塊中。只有在您想要將內容分割成多個區塊或新增 Intelligent Delivery 標籤時,才需要配置對應檔。 若要產生配置對應檔,請開啟 GDK 命令提示字元並執行下列命令:步驟 6:建立您的 MSIXVC2 套件
建立套件:步驟 7:在本機測試您的套件
在目標 PC 上啟用開發人員模式。安裝 MSIXVC2 套件之前,請在目標裝置上設定下列登錄機碼:packageutil 啟用 MSIXVC2 開發人員模式:
packageutil set 命令需要 2026 年 10 月版 GDK 或更新版本。在未來的 GDK 版本推出之前,都需要此登錄機碼。若沒有它,MSIXVC2 套件將無法安裝。請從提高權限 (系統管理員) 的命令提示字元執行此命令。
[drive]:\XboxGames 資料夾。檔案會以其原始形式安裝,您可以直接存取。此安裝位置與使用 Flat File Install 的 MSIXVC 套件所使用的位置相同。
您可以將在本機側載的同一個套件上傳至 Partner Center,不需要另外建立提交套件的步驟。
步驟 8:上傳至 Partner Center
請將 MSIXVC2 套件發佈至 Partner Center 中的新分支 (例如
msixvc2)。請勿將 MSIXVC2 套件上傳至與現有 MSIXVC 套件相同的分支。這兩種格式在分支內無法互換,而將分支從 MSIXVC2 還原回 MSIXVC 需要完整上傳和下載套件。如需詳細資訊,請參閱套件分支最佳做法。選項 A:上傳預先建置的套件
如果您已在步驟 6 中建立套件,請直接上傳:選項 B:從鬆散檔案上傳 (單一命令工作流程)
您可以將封裝和上傳合併為單一命令。此命令會直接從組建輸出上傳,而不會建立本機套件檔案:上傳選項
如需上傳選項的完整清單,請參閱 Make package (makepkg.exe)。
驗證方法
upload 命令支援適用於不同環境的多種驗證方法。
範例:CI/CD 管線上傳
