다음을 통해 공유

앱 패키지 요구 사항

  • 아티클

Microsoft Store에 제출할 앱 패키지를 준비하려면 다음 지침을 따르세요.

Microsoft Store용으로 앱 패키지를 빌드하기 전에

Windows 앱 인증 키트를 사용해 앱을 테스트해야 합니다. 또한 다양한 유형의 하드웨어에서 앱을 테스트하는 것이 좋습니다. 앱을 인증하고 Microsoft Store에서 사용할 수 있도록 할 때까지 개발자 라이선스가 있는 컴퓨터에서만 앱을 설치하고 실행할 수 있습니다.

Microsoft Visual Studio를 사용해 앱 패키지 빌드

Microsoft Visual Studio를 개발 환경으로 사용한다면, 앱 패키지를 빠르고 쉽게 만들 수 있는 기본 제공 도구가 이미 포함되어 있습니다. 자세한 내용은 패키징 앱을 참조하세요.

참고 항목

모든 파일 이름에는 ANSI를 사용해야 합니다.

Visual Studio에서 패키지를 만들 때, 개발자 계정과 연결된 동일한 계정으로 로그인했는지 확인합니다. 패키지 매니페스트의 일부에는 계정과 관련된 특정 세부 정보가 있습니다. 이 정보는 자동으로 검색되고 추가됩니다. 매니페스트에 정보를 추가하지 않으면 패키지 업로드 오류가 발생할 수 있습니다.

앱의 UWP 패키지를 빌드할 때 Visual Studio는 .msix 또는 appx 파일이나 .msixupload 또는 .appxupload 파일을 만들 수 있습니다. UWP 앱의 경우 항상 패키지 페이지에서 .msixupload 또는 .appxupload 파일을 업로드하는 것이 좋습니다. Microsoft Store용 UWP 앱 패키징에 대한 자세한 내용은 Visual Studio를 사용하여 UWP 앱 패키징을 참조하세요.

앱의 패키지는 신뢰할 수 있는 인증 기관에 기반을 둔 인증서로 서명할 필요가 없습니다.

앱 번들

UWP 앱의 경우 Visual Studio는 앱 번들(.msixbundle 또는 .appxbundle)을 생성하여 사용자가 다운로드하는 앱의 크기를 줄일 수 있습니다. 이는 특정 버전의 Microsoft DirectX에 적용되는 언어별 자산, 다양한 이미지 크기 조정 자산 또는 리소스를 정의한 경우 유용합니다.

참고 항목

 하나의 앱 번들에는 모든 아키텍처에 대한 패키지가 포함될 수 있습니다.

앱 번들을 사용하면 사용자는 가능한 모든 리소스 대신 관련 파일만 다운로드합니다. 앱 번들에 대한 자세한 내용은 앱 패키징 및 Visual Studio를 사용하여 UWP 앱 패키징을 참조하세요.

수동으로 앱 패키지 빌드

Visual Studio를 사용해 패키지를 생성하지 않는 경우, 패키지 매니페스트를 수동으로 생성해야 합니다.

전체 매니페스트 세부 정보 및 요구 사항은 앱 패키지 매니페스트 문서를 검토해야 합니다. 인증을 통과하기 위해 매니페스트는 패키지 매니페스트 스키마를 따라야 합니다.

매니페스트에는 계정과 앱에 대한 몇 가지 특정한 정보가 포함되어야 합니다. 대시보드에서 앱 개요 페이지의 제품 관리 섹션에서 앱 ID 세부 정보 보기를 확인하여 이 정보를 찾을 수 있습니다.

참고 항목

 매니페스트의 값은 대/소문자를 구분합니다. 공백과 기타 문장 부호도 일치해야 합니다. 값을 신중하게 입력한 후 올바른지 검토해야 합니다.

앱 번들(.msixbundle 또는 .appxbundle)은 다른 매니페스트를 사용합니다. 앱 번들 매니페스트에 대한 세부 정보 및 요구 사항에 대한 번들 매니페스트 문서를 검토합니다. .msixbundle 또는 .appxbundle에서 포함된 각 패키지의 매니페스트는 Identity 요소의 ProcessorArchitecture 특성을 제외하고 동일한 요소와 특성을 사용해야 합니다.

팁

 패키지를 제출하기 전에 반드시 Windows 앱 인증 키트를 실행합니다. 이렇게 하면 인증이나 제출 실패를 일으킬 수 있는 문제가 매니페스트에 있는지 확인할 수 있습니다.

패키지 형식 요구 사항

앱의 패키지는 이러한 요구 사항을 준수해야 합니다.

앱 패키지 속성 요건
패키지 크기 .msixbundle 또는 .appxbundle: 번들당 최대 25GB
Windows 10 또는 Windows 11을 대상으로 하는 .msix 또는 .appx 패키지: 패키지당 최대 25GB
블록 맵 해시 SHA2-256 알고리즘

Important

Windows Phone 8.x SDK를 사용하여 빌드된 새 XAP 패키지를 더 이상 업로드할 수 없습니다. XAP 패키지와 함께 이미 Store에 있는 앱은 Windows 10 Mobile 디바이스에서 계속 작동합니다. 자세한 내용은 이 블로그 게시물을 참조하세요.

지원되는 버전

UWP 앱의 경우 모든 패키지는 스토어에서 지원하는 Windows 10 또는 Windows 11 버전을 대상으로 해야 합니다. 패키지에서 지원되는 버전은 앱 매니페스트의 TargetDeviceFamily 요소의 MinVersion 및 MaxVersionTested 특성에 나타나야 합니다.

현재 지원되는 버전 범위는 다음과 같습니다.

  • 최소: 10.0.10240.0
  • 최대: 10.0.22621.0

StoreManifest XML 파일

StoreManifest.xml은 앱 패키지에 포함될 수 있는 선택적 구성 파일입니다. 이 구성 파일은 앱을 Microsoft Store 디바이스 앱으로 선언하거나 패키지를 디바이스에 적용하려면 필요한 요구 사항을 선언하는 등과 같이 패키지 매니페스트에서 다루지 않는 기능을 사용하도록 설정하기 위한 것입니다. 사용하는 경우 StoreManifest.xml은 앱 패키지와 함께 제출되며 앱 기본 프로젝트의 루트 폴더에 있어야 합니다. 자세한 내용은 StoreManifest 스키마를 참조하세요.

제품의 설치 프로그램 이진 파일에 HTTPS 지원 다운로드 URL(직접 링크)을 제출합니다. 이러한 방식으로 제출된 제품은 다음과 같은 요구 사항이 적용됩니다.

  • 설치 관리자 이진 파일은 .msi 또는 .exe일 수 있습니다.

  • 이진 파일과 모든 PE(이식 가능한 실행 파일) 파일은 Microsoft 신뢰할 수 있는 루트 프로그램의 일부인 CA(인증 기관)에서 발급한 인증서에 연결된 코드 서명 인증서로 디지털 서명되어야 합니다.

  • 파트너 센터에서 버전이 지정된 다운로드 URL을 제출해야 합니다. 해당 URL과 연결된 이진 파일은 제출 후 변경할 수 없습니다.

  • 업데이트된 이진 파일을 배포할 때마다 업데이트된 이진 파일과 연결된 파트너 센터에서 업데이트된 버전이 지정된 다운로드 URL을 제공해야 합니다. 다운로드 URL을 유지하고 업데이트하는 것은 귀하의 책임입니다.

  • 설치를 시작해도 설치 사용자 인터페이스(즉, 자동 설치가 필요함)가 표시되지 않아야 하지만 UAC(사용자 계정 컨트롤) 대화 상자가 허용됩니다.

  • 설치 프로그램은 독립 실행형 설치 프로그램이며 실행 시 비트를 다운로드하는 다운로더 스텁/웹 설치 프로그램이 아닙니다.

Important

앱 패키지 요구 사항은 앱 추가 기능에 대해 지원되지 않습니다.