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 제품 게시자 ID, 패키지 이름, Store ID가 필요합니다.
- 대상 테스트 PC에서 개발자 모드 활성화됨.
- MSIXVC2 패키지를 설치하거나 실행하는 모든 장치에서 MSIXVC2 개발자 모드 레지스트리 키 설정됨. 자세한 내용은 7단계를 참조하세요.
1단계: 콘텐츠 준비
타이틀의 모든 원본 자료를 하나의 디렉터리에 배치합니다. 패키징 시스템이 사용할 수 없거나 소매 패키지에 배송하기에 적합하지 않은 파일을 제거합니다. 다음 파일이 있는 경우 제거합니다.- PDB 파일.
- 자산, 바이너리 등 다른 PC 게임 스토어에 대한 참조.
- AppxSignature.p7x 및 AppxBlockMap.xml을 포함한 유니버설 Windows 플랫폼(UWP) 및 Appx “풋프린트” 파일.
2단계: MicrosoftGame.config 만들기
게임 콘텐츠의 루트 디렉터리에 MicrosoftGame.config 파일을 만듭니다. 이 구성 파일은 MSIXVC와 함께 작동합니다. 기존 MicrosoftGame.config는 변경 없이 MSIXVC2와 함께 작동합니다. 이 파일은 수동으로 만들거나 Partner Center 프로젝트에서 ID 및 ID 값을 직접 동기화하는 MicrosoftGame.config Editor를 사용하여 만들 수 있습니다. MicrosoftGame.config 파일 샘플은 PC용 MSIXVC 시작하기를 참조하세요.3단계: Visual C/C++ 런타임 종속성 식별
MicrosoftGame.config에 Visual C/C++ 런타임 종속성이 나열되어 있거나 이러한 종속성을 패키지 페이로드에 명시적으로 복사했는지 확인하세요. 자세한 내용은 프레임워크 패키지 종속성을 참조하세요.4단계: 아이콘 만들기
MicrosoftGame.config의ShellVisuals 섹션에 지정된 크기로 조정된 아이콘 파일을 게임 콘텐츠의 루트 폴더(또는 하위 디렉터리)에 배치합니다. MicrosoftGame.config Editor는 단일 원본 이미지에서 이러한 이미지를 생성할 수 있습니다.
5단계: 레이아웃 매핑 파일 생성(선택 사항)
이 단계는 선택 사항입니다. 기본적으로 MSIXVC2는 모든 콘텐츠를 단일 청크로 패키지합니다. 콘텐츠를 여러 청크로 나누거나 Intelligent Delivery 태그를 추가하려는 경우에만 레이아웃 매핑 파일이 필요합니다. 레이아웃 매핑 파일을 생성하려면 GDK 명령 프롬프트를 열고 다음 명령을 실행합니다.6단계: MSIXVC2 패키지 만들기
패키지를 만듭니다.7단계: 패키지 로컬 테스트
대상 PC에서 개발자 모드를 활성화합니다. MSIXVC2 패키지를 설치하기 전에 대상 장치에 다음 레지스트리 키를 설정합니다.packageutil을 사용하여 MSIXVC2 개발자 모드를 활성화할 수 있습니다.
packageutil set 명령에는 2026년 10월 GDK 이상이 필요합니다.이 레지스트리 키는 향후 GDK 릴리스까지 필수입니다. 이것이 없으면 MSIXVC2 패키지가 설치되지 않습니다. 관리자(admin) 명령 프롬프트에서 명령을 실행하세요.
[drive]:\XboxGames 폴더에 설치됩니다. 파일은 원본 형태로 설치되며 직접 액세스할 수 있습니다. 이 설치 위치는 MSIXVC 패키지가 Flat File Install과 함께 사용하는 위치와 동일합니다.
로컬에서 사이드로드하는 것과 동일한 패키지를 Partner Center에 업로드할 수 있습니다. 별도의 제출 패키지 단계가 없습니다.
8단계: Partner Center에 업로드
MSIXVC2 패키지를 Partner Center의 새 브랜치(예:
msixvc2)에 게시합니다. MSIXVC2 패키지를 기존 MSIXVC 패키지와 동일한 브랜치에 업로드하지 마세요. 두 형식은 브랜치 내에서 상호 교환할 수 없으며, 브랜치를 MSIXVC2에서 MSIXVC로 되돌리려면 패키지의 전체 업로드와 다운로드가 필요합니다. 자세한 내용은 패키지 브랜치 모범 사례를 참조하세요.옵션 A: 사전 빌드된 패키지 업로드
6단계에서 이미 패키지를 만들었다면 직접 업로드합니다.옵션 B: 느슨한 파일에서 업로드(단일 명령 워크플로)
패키징과 업로드를 하나의 명령으로 결합할 수 있습니다. 이 명령은 로컬 패키지 파일을 만들지 않고 빌드 출력에서 직접 업로드합니다.업로드 옵션
전체 업로드 옵션 목록은 Make package (makepkg.exe)를 참조하세요.
인증 방법
upload 명령은 다양한 환경에 대한 여러 인증 방법을 지원합니다.
예: CI/CD 파이프라인 업로드