Skip to main content
앱 패키지를 생성하고, 패키지를 Partner Center에 업로드하며, 관련된 패키징 작업을 수행합니다. makepkg는 XVC, MSIXVC, MSIXVC2 패키지 형식을 지원합니다. MSIXVC2 형식으로 패키지를 생성하려면 /msixvc2 옵션을 사용합니다.

전역 옵션

명령

  • pack - 디스크의 파일에서 새 앱 패키지를 생성합니다.
  • upload - 패키지 또는 파일 디렉터리를 Partner Center에 업로드합니다.
  • genkey - pack /lk에서 사용할 암호화 키를 생성합니다.
  • genid - Product ID 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에만 해당하는데, upload 명령은 /d가 지정된 경우 느슨한 파일을 패키징하여 하나의 작업으로 업로드할 수도 있습니다. 느슨한 파일 업로드에는 /msixvc2 옵션이 필요합니다. 브랜치 또는 플라이트를 지정하지 않으면 패키지가 main 브랜치에 업로드됩니다. EKB 파일과 Submission Validator 로그 파일은 패키지와 동일한 디렉터리에 있어야 하며 자동으로 업로드됩니다. 심볼 번들이 있는 경우에도 업로드됩니다. Store ID는 패키지에서 추출되지만, 패키지가 Store ID 없이 생성된 경우에는 제공할 수 있습니다.
샘플 사용법(사전 빌드된 패키지 업로드):
샘플 사용법(느슨한 파일 패키징 및 업로드):

패키지 원본 옵션

대상 옵션

인증 옵션

유효성 검사 및 심볼 옵션

인증 방법

genkey

pack /lk에서 사용할 로컬 에스크로 키 blob(LEKB)을 생성합니다.
패키지 생성 중에 안정적인 암호화 키를 사용하려면 makepkg pack /lk에 LEKB 파일을 제공합니다. 이 키는:
  1. packageutil compare가 정확한 업데이트 크기 추정치를 생성할 수 있게 합니다.
  2. 콘솔과 PC가 콘텐츠 업데이트를 다운로드할 때 사용하는 것과 동일한 알고리즘을 사용하여 Partner Center에 안전한 델타 업로드를 가능하게 합니다.
  3. 개발 키트에 설치할 수 있는 패키지를 생성합니다.
  4. 특정 환경에서만 복호화될 수 있는 안전한 암호화 키 자료를 사용합니다.
LEKB 파일에는 가볍게 난독화된 암호화 키 자료가 포함되어 있습니다. LEKB 파일과 패키지를 모두 가진 사람은 패키지를 복호화할 수 있으므로 파일에 대한 안전한 액세스를 유지하세요.

genid

Product ID GUID와 Store ID 간에 변환합니다.

genmap

디스크의 콘텐츠를 기반으로 매핑 XML 파일을 생성합니다. 생성된 파일에는 하나의 청크가 포함되어 있으며, 콘텐츠를 여러 청크로 나누거나 Intelligent Delivery 태그를 추가하도록 편집할 수 있습니다.

validate

패키지를 생성하지 않고 패키지 유효성 검사를 실행합니다. 이 명령을 사용하여 전체 pack 작업 전에 콘텐츠와 구성을 확인하세요.
validate 명령은 pack과 동일한 옵션을 허용합니다.

updatesubval

패키지를 생성, 유효성 검사 또는 업로드하지 않고 최신 SubmissionValidator.dll을 다운로드, 확인, 설치합니다.

옵션

비고

SubmissionValidator.dll이 이미 최신 버전이면 명령은 최신 상태임을 보고하고 다운로드하지 않고 성공적으로 종료합니다. 파일이 없으면 명령이 설치합니다. 성공하면 명령은 디스크의 SubmissionValidator.dll 버전을 표시합니다. 패키징 또는 유효성 검사 중에 사용되는 /updatesubval 옵션과 달리, 독립 실행형 updatesubval 명령은 업데이트가 실패하면 0이 아닌 종료 코드를 반환합니다. 옵션으로 사용되는 경우, 업데이트 실패는 치명적이지 않으며 패키징 또는 유효성 검사 작업은 설치된 SubmissionValidator.dll 버전으로 계속됩니다.

localize

디스크의 콘텐츠를 기반으로 Resources.pri 파일을 생성합니다.
자세한 내용은 MicrosoftGame.config 지역화를 참조하세요.

관련 항목

MSIXVC2 패키징 개요 PC용 MSIXVC2 시작하기 배포 패키지 스키마 XBOX Game Package Manager 패키지 업로드 자동화
마지막 수정일 2026년 8월 24일