Skip to main content
建立應用程式套件、將套件上傳至 Partner Center,並執行相關的封裝作業。makepkg 支援 XVC、MSIXVC 和 MSIXVC2 套件格式。使用 /msixvc2 選項以 MSIXVC2 格式產生套件。

全域選項

命令

  • pack - 從磁碟上的檔案建立新的應用程式套件。
  • upload - 將套件或檔案目錄上傳至 Partner Center。
  • genkey - 產生搭配 pack /lk 使用的加密金鑰。
  • genid - 在產品識別碼 GUID 與 Store ID 之間轉換。
  • genmap - 根據磁碟上的內容產生對應 XML 檔案。
  • validate - 執行驗證但不建立套件。
  • updatesubval - 更新 SubmissionValidator.dll,而不執行其他作業。
  • localize - 根據磁碟上的內容產生 Resources.pri 檔案。

pack

從磁碟上的檔案建立新的應用程式套件。
使用範例:

選項

備註

根據預設,makepkg pack 會使用所有開發套件都能識別的已知加密金鑰來加密 XVC 或 MSIXVC 套件,以供測試使用。這些套件並未受到加密保護。 為了提供額外的上傳保護,XVC 和 MSIXVC 套件可以使用 /l 或 /lk。使用 /l 的套件在上傳前無法安裝在開發套件或 PC 上。使用 /lk 的套件在上傳前可以安裝在開發套件上。無論上傳加密模式為何,XBOX 服務都會使用 Microsoft 管理的加密金鑰來加密要散發的套件。 MSIXVC2 套件不使用用戶端上傳加密。XBOX 服務會處理散發所需的加密。 如需對應檔案結構描述的相關資訊,請參閱部署套件結構描述。

upload

將套件上傳至 Partner Center。僅針對 MSIXVC2,指定 /d 時,upload 命令也可以在一次作業中封裝鬆散檔案並加以上傳。鬆散檔案上傳需要 /msixvc2 選項。 如果未指定分支或正式發行前小眾測試版本 (flight),套件會上傳至 main 分支。 EKB 檔案和 Submission Validator 記錄檔應與套件位於相同目錄中,並會自動上傳。如果存在符號套件組合,也會一併上傳。Store ID 會從套件中擷取,但如果產生套件時未包含 Store ID,則可以另外提供。
使用範例 (上傳預先建置的套件):
使用範例 (封裝並上傳鬆散檔案):

套件來源選項

目的地選項

驗證選項

驗證與符號選項

驗證方法

genkey

產生搭配 pack /lk 使用的本機託管金鑰 Blob (LEKB)。
將 LEKB 檔案提供給 makepkg pack /lk,以在建立套件期間使用穩定的加密金鑰。此金鑰:
  1. 讓 packageutil compare 能產生準確的更新大小估計值。
  2. 使用主機和 PC 下載內容更新時所用的相同演算法,啟用對 Partner Center 的安全差異上傳。
  3. 產生可安裝在開發套件上的套件。
  4. 使用只能在特定環境中解密的安全加密金鑰資料。
LEKB 檔案包含經過輕度模糊處理的加密金鑰資料。任何同時擁有 LEKB 檔案和套件的人都能解密套件,因此請保護對該檔案的存取。

genid

在產品識別碼 GUID 與 Store ID 之間轉換。

genmap

根據磁碟上的內容產生對應 XML 檔案。產生的檔案包含一個區塊,您可以編輯該檔案,將內容分割成多個區塊或新增 Intelligent Delivery 標記。

validate

執行套件驗證但不建立套件。使用此命令可在完整封裝作業之前驗證內容和設定。
validate 命令接受與 pack 相同的選項。

updatesubval

下載、驗證並安裝最新的 SubmissionValidator.dll,而不建立、驗證或上傳套件。

選項

備註

如果 SubmissionValidator.dll 已是最新版本,命令會回報其為最新版本,並在不下載的情況下成功結束。如果檔案遺失,命令會加以安裝。成功時,命令會顯示磁碟上 SubmissionValidator.dll 的版本。 與在封裝或驗證期間使用的 /updatesubval 選項不同,獨立的 updatesubval 命令在更新失敗時會傳回非零的結束代碼。當作為選項使用時,更新失敗並非嚴重錯誤,封裝或驗證作業會繼續使用已安裝版本的 SubmissionValidator.dll。

localize

根據磁碟上的內容產生 Resources.pri 檔案。
如需詳細資訊,請參閱 MicrosoftGame.config 當地語系化。

相關主題

MSIXVC2 封裝概觀 開始使用適用於 PC 的 MSIXVC2 部署套件結構描述 XBOX Game Package Manager 自動化套件上傳
Last modified on October 6, 2026