패키지(클래식 환경)

Microsoft Store에 게임을 게시할 때 Partner Center의 패키지 관리 환경을 사용하여 게임 패키지를 업로드, 검증, 인증, 테스트, 게시 및 롤백할 수 있습니다. Partner Center를 사용하면 다음과 같은 작업을 수행할 수 있습니다.

• XBOX 콘솔 및 PC용 패키지 업로드
• 패키지 검증 문제 검토
• 인증을 위한 패키지 제출
• 선택한 대상 그룹을 상대로 패키지 테스트(선택 사항)
• 모든 플레이어에게 패키지 게시
• 문제가 발생할 경우 즉시 롤백

​

게임 패키지 시작하기

게임 빌드는 지원하는 디바이스 제품군이 인식하고 사용할 수 있는 형식으로 패키징해야 합니다. 게임에 대해 지원되는 디바이스 제품군을 구성하려면 Game setup에서 이를 선택하세요. 디바이스 제품군마다 서로 다른 패키지 형식이 필요합니다.

​

패키지 버전 번호

패키지를 만들 때 MicrosoftGame.Config 파일의 Identity 요소 내 Version 특성에 버전 번호를 지정합니다. 지원하는 각 플랫폼에 대해 동일한 버전 번호를 사용할 수 있으며, 새 패키지를 만들 때마다 버전 번호를 증가시킵니다. 인증(Certification)에 대한 새 제출마다 반드시 버전 번호를 증가시켜야 합니다.

​

Submission Validator로 패키지 검증

Submission Validator는 XBOX 게임 개발 키트(GDK)의 구성 요소로, 게임 패키지에 대해 일련의 기본 품질 검사를 실행합니다. Submission Validator는 독립 실행형 도구로 사용되지 않습니다. 대신, makepkg pack 명령을 사용하여 게임 패키지를 빌드할 때 자동으로 실행됩니다. Submission Validator는 GDK에 포함되어 있습니다. 최신 버전은 Microsoft Game Dev - Game Development Resources에서 다운로드할 수 있습니다. Submission Validator는 게임 패키지가 생성된 후에 실행됩니다. 검증 중 발생한 실패 및 경고는 검증 로그에 기록되며, 이 로그는 makepkg 명령줄에서 지정한 출력 위치에 기록됩니다. 이 위치는 완성된 게임 패키지가 생성되는 출력 위치와 동일합니다. makepkg에서 /validationlanguage 매개 변수를 설정한 경우, 영어 출력 외에도 동일한 위치에 지역화된 출력도 제공됩니다. Submission Validator 테스트의 하위 집합은 makepkg validate 명령줄을 실행하여 타이틀 패키지 생성 전에 실행할 수 있습니다. 이를 실행하여 패키지 생성 전에 문제를 확인하세요. 검증 로그에 실패 또는 경고가 표시되는 경우, 인증에 패키지를 제출하기 전에 이러한 문제를 해결하세요. 자세한 내용은 Submission Validator - Understanding the results log를 참조하세요.

​

게임 제품에 필요한 패키지 파일

Partner Center에서 XBOX 콘솔 또는 PC 게임 패키지를 업로드할 때 일부 파일은 필수이며 그 외에는 선택 사항이지만 권장됩니다.

​

필수 파일

• XVC(XBOX 콘솔)/MSIXVC(PC): 준비된 게임 빌드가 포함된 기본 패키지 파일입니다.
• 암호화 키 번들(EKB): 이 파일은 플레이어 배포를 위한 올바른 암호화를 보장합니다. 유효한 EKB가 업로드되지 않으면 XVC 및 MSIXVC 업로드를 진행할 수 없습니다.
• Submission Validator 로그(.xml): Submission Validator는 게임 패키지에 대해 일련의 품질 검사를 실행하는 GDK 구성 요소입니다. 결과는 XML 로그 파일로 생성되며, 이를 Partner Center에 업로드해야 합니다. 인증 또는 RETAIL 게시용 패키지의 경우, 로그에 전체 통과 결과가 표시되어야 하거나, 로그 파일에서 _failure_로 태그된 각 문제에 대해 승인된 예외가 있어야 합니다. 또한 로그 파일에서 _warning_으로 태그된 문제가 있는지 확인하고 경고가 예상된 것인지 확인해야 합니다. Submission Validator의 최신 버전을 사용하세요. 버전이 만료된 경우 로그에 업데이트 지침과 함께 오류가 표시됩니다.

​

선택 파일(권장)

• 기호(.zip): 패키지 생성 중에 생성되는 이 .zip 폴더에는 포괄적인 크래시 덤프 보고에 필요한 기호 파일이 포함되어 있습니다.
• 디스크 레이아웃 파일(.xml): 이 파일은 디스크 기반 또는 다중 디스크 릴리스에서만 구조와 설치 순서를 정의하기 위해 필요합니다. 디지털 전용 게임에는 이 파일이 필요하지 않습니다.

​

패키지용 브랜치 시작하기

브랜치를 사용하면 여러 게임 빌드 버전을 동시에 작업할 수 있습니다. 각 브랜치는 라이브 빌드 준비, 내부 빌드 테스트 또는 핫픽스 생성과 같은 별도의 워크플로를 나타내며, 서로 간섭하지 않습니다.

​

브랜치가 중요한 이유

브랜치를 효과적으로 사용하면 다음이 가능합니다.

• 개발 또는 QA 샌드박스에서 다른 빌드를 업로드하고 테스트하는 동안 안정적인 빌드 인증을 진행할 수 있습니다.
• 라이브 빌드를 건드리지 않고 위험한 변경 사항을 테스트할 수 있습니다.
• 진행 중인 개발과 격리된 상태로 긴급 수정을 유지하여 안전하게 핫픽스를 적용할 수 있습니다.

​

게시에서의 브랜치 동작

브랜치는 게시 대상에 따라 서로 다른 제한 사항이 있습니다.

• 개발 샌드박스에 브랜치를 게시하거나 인증에 제출할 수 있습니다.
• Main Branch만 RETAIL 샌드박스에 게시할 수 있습니다.

RETAIL에 게시할 준비가 되면 다른 브랜치에서 Main Branch로 패키지를 가져올 수 있습니다.

​

새 브랜치 만들기

새 브랜치를 만들려면:

1. 브랜치 탐색에서 + New Branch 버튼을 선택합니다.
2. 브랜치 이름을 입력합니다. 브랜치의 목적(예: QA)이나 대상(예: ABCDEF.1)을 설명하는 이름을 사용하세요.
3. Continue를 선택합니다.

브랜치를 만든 후에는 Import 기능을 사용하여 언제든지 브랜치 간에 패키지를 복사할 수 있습니다.

​

브랜치 기록

각 브랜치의 오른쪽 상단 근처에 History 버튼이 있습니다. History를 선택하여 브랜치에서 수행된 작업의 사용자, 날짜, 시간 및 기타 세부 정보를 확인하세요.

​

패키지 업로드

패키지를 브랜치로 끌어다 놓거나, browse your files를 선택하여 파일 탐색기에서 패키지를 선택합니다. XVC/MSIXVC 패키지를 업로드한 후에 다른 필수 및 선택 파일도 업로드할 수 있습니다.

​

시장별 패키지 구성

게임이 서로 다른 출시 시장에 대해 별도의 패키지를 지원하는 경우, Add market-specific packages UI를 사용하여 이러한 할당을 수행합니다. UI는 시장 그룹의 생성 및 이름 지정 과정을 안내합니다. 그룹을 만든 후 각 시장 그룹에 대해 패키지를 업로드할 수 있습니다.

​

사용 가능 여부 및 사전 다운로드 날짜 지정

Base release는 게임의 첫 번째 게시된 패키지입니다. 게시된 후 즉시 샌드박스에서 다운로드할 수 있습니다. 패키지가 실행 가능한지 여부는 제품의 Pricing and availability 일정에 따라 달라집니다. 패치라고도 하는 **콘텐츠 업데이트(CU)**의 경우, 각 XVC/MSIXVC 패키지에 대해 두 가지 사용 가능 여부 옵션이 있습니다.

• 사용 가능 날짜(필수 날짜): 업데이트가 필수가 되는 시점을 정의합니다. 업데이트가 설치되지 않으면 XBOX 네트워크에 연결되어 있는 동안 게임을 플레이할 수 없습니다.
• 사전 다운로드 날짜: 이 기능이 활성화된 디바이스에서 백그라운드로 업데이트를 다운로드할 수 있는 시점을 정의합니다. 이 옵션을 통해 플레이어는 사용 가능 날짜에 즉시 게임에 진입할 수 있습니다.

출시일의 대기 시간을 줄이려면 사전 다운로드 날짜를 사용 가능 날짜보다 최소 48시간 이전으로 설정하세요. 두 날짜가 동일하면 사전 다운로드가 없습니다. CU는 사용 가능 날짜 이후에만 다운로드됩니다. 사용 가능 날짜를 구성하지 않으면 CU는 인증 후 즉시 게시됩니다. 시장별 패키지의 경우 각 시장 패키지마다 사용 가능 및 사전 다운로드 날짜를 설정하세요. 각 패키지는 자체 일정을 따릅니다.

​

패키지 인증

XBOX 인증(Certification)은 빌드가 플랫폼 요구 사항을 충족하는지 확인합니다. 빌드가 XBOX 인증을 통과하지 못하면 보고된 문제를 수정하고 새 빌드를 만들어 업로드한 다음 다시 인증에 제출하세요. 인증은 항상 개별 파일이 아닌 전체 빌드에 적용됩니다. 제출하려는 패키지가 포함된 브랜치 상단의 Certify 버튼을 선택하여 빌드를 인증에 보냅니다. 자세한 내용은 인증 제출을 참조하세요. Packages UI의 아무 브랜치에서나 Certify를 사용하여 패키지를 XBOX 인증 워크플로에 제출합니다. 패키지 인증 시 다음 옵션을 사용할 수 있으며, 제출 유형에 따라 적용될 수 있습니다.

​

플라이트 관리

패키지 플라이트를 사용하여 특정 대상 그룹에게 패키지를 제공합니다. 패키지 플라이트의 대상 그룹 유형은 타깃 플랫폼에 따라 다릅니다.

• XBOX 콘솔 패키지 플라이트는 Known Device Groups를 사용합니다.
• PC 패키지 플라이트는 Known User Groups를 사용합니다.

새 패키지 플라이트를 만들고 특정 대상 그룹에 대해 플라이트된 패키지를 관리하는 방법에 대한 자세한 내용은 게임 패키지의 패키지 플라이트 구성 방법을 참조하세요.

​

게시된 패키지 롤백

최근 게시된 패키지로 인해 문제가 발생하면 이전에 게시된 패키지로 롤백할 수 있습니다. Configure rollback을 선택한 다음, 열리는 Rollback package 창에서 패키지 정보를 선택하세요. 다시 업로드하거나 재인증할 필요 없이 이전 패키지가 다시 라이브 상태가 됩니다.

​

참고 항목

• 게임 패키지 만들기 및 업로드
• 패키징 개요