跳轉到主要內容
套件是 Partner Center 已接收並處理的遊戲組建。package 命令可列出及取得遊戲的套件,讓您檢查套件是否已準備好用於試玩測試。若要上傳套件,請參閱上傳套件。 這些命令為實驗性功能:其選項和輸出可能會變更。請參閱實驗性命令。它們需要具備遊戲的 Partner Center 套件讀取權限,開發人員角色已包含此權限。

命令

引數和選項

賣方來自 --seller-id 或您已儲存的賣方;請參閱內容。若兩者皆無,命令會使用您唯一的賣方,而當您屬於多個賣方時,會要求提供 --seller-id。--xbox-title-id 一律需要賣方。

列出套件

package list 會寫入遊戲 Main 分支的 ID,以及包含服務所傳回之每個欄位的 packages 陣列。package get 會以相同的形式寫入一個套件。摘錄如下:
當下列所有條件都成立時,套件即已準備好用於試玩測試:
  • processingState 為 Processed。它會從 PendingUpload 經過 Uploaded 和 Processing 變為 Processed,或變為 ProcessFailed。
  • validationItems (Partner Center 在處理套件時發現的問題) 中沒有嚴重性為 Error 的項目。
  • isAvailableForPlaytest 為 true。
--output table 包含 PACKAGE ID、VERSION、PLATFORM、STATE、PLAYTEST 和 CREATED 欄。它不會顯示驗證結果,因此請在 JSON 中檢查 validationItems。

上傳套件

CLI 不會上傳套件。請使用 XBOX 遊戲開發套件 (GDK) 中的 makepkg 上傳套件;請參閱 makepkg 參考,若是從持續整合 (CI) 上傳,請參閱 Package Uploader。然後執行 package list 以檢查套件是否已準備就緒。

錯誤

無論 --output 為何,錯誤都會以文字形式傳送到 stderr,並附上相互關聯識別碼。--verbose 會加入回應本文。失敗時會以 1 結束。

範例

最後修改於 2026年11月19日