메인 콘텐츠로 건너뛰기
패키지는 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로 바뀝니다.
  • Partner Center가 패키지를 처리하는 동안 발견한 문제인 validationItems에 심각도가 Error인 항목이 없습니다.
  • isAvailableForPlaytest가 true입니다.
--output table에는 PACKAGE ID, VERSION, PLATFORM, STATE, PLAYTEST, CREATED 열이 있습니다. 유효성 검사 결과는 표시되지 않으므로 JSON에서 validationItems를 확인하세요.

패키지 업로드

CLI는 패키지를 업로드하지 않습니다. XBOX Game Development Kit(GDK)의 makepkg로 업로드하세요. makepkg 참조를 참조하고, CI(연속 통합)에서 업로드하는 경우 Package Uploader를 참조하세요. 그런 다음 package list를 실행하여 패키지가 준비되었는지 확인하세요.

오류

오류는 --output과 관계없이 상관 관계 ID와 함께 텍스트로 stderr에 출력됩니다. --verbose는 응답 본문을 추가합니다. 실패하면 1로 종료됩니다.

예제

마지막 수정일 2026년 11월 19일