MSIX 앱 패키지 업로드

앱 패키지 업로드

제출하는 앱에 대한 모든 패키지 파일(.msix, .msixupload, .msixbundle, .appx, .appxupload 및/또는 .appxbundle)을 앱 제출 프로세스의 패키지 페이지에서 업로드합니다. 이 페이지에서 동일한 앱에 대한 모든 패키지를 업로드할 수 있으며, 고객이 앱을 다운로드하면 스토어에서 각 고객의 디바이스에 가장 적합한 패키지를 자동으로 제공합니다. 패키지를 업로드하면 특정 Windows 10 또는 Windows 11 장치 제품군(및 해당하는 경우 이전 OS 버전)에 제공되는 패키지를 순위대로 나타내는 표가 표시됩니다.

패키지에 포함된 항목과 구성 방법에 대한 자세한 내용은 앱 패키지 요구 사항을 참조하세요. 또한 버전 번호가 특정 고객에게 제공되는 패키지에 미치는 영향 및 다양한 시나리오에 대한 패키지 관리 방법에 대해서도 알아봅니다.

제출에 패키지 업로드

패키지를 업로드하려면 패키지를 업로드 필드로 끌어다 놓거나 클릭해 파일을 찾습니다. 패키지 페이지에서 .msix, .msixupload, .msixbundle, .appx, .appxupload 및/또는 .appxbundle 파일을 업로드할 수 있습니다.

Important

Windows 10 이상의 경우 .msix, .appx, .msixbundle 또는 .appxbundle 대신 .msixupload 또는 .appxupload 파일을 여기에 업로드하는 것이 좋습니다. 스토어에서의 UWP 앱 패키징에 대한 자세한 내용은 Visual Studio를 사용하여 UWP 앱 패키징을 참조하세요.

앱에 대한 패키지 플라이트를 만든 경우, 패키지 플라이트 중 하나에서 패키지를 복사하는 옵션이 포함된 드롭다운이 표시됩니다. 끌어오려는 패키지가 있는 패키지 플라이트를 선택합니다. 그런 다음, 패키지 중 일부 또는 전부를 이 제출에 포함하도록 선택할 수 있습니다.

패키지를 유효성 검사하는 동안 패키지에서 오류를 검색하면 무엇이 잘못되었는지 알려주는 메시지를 표시합니다. 패키지를 제거하고 문제를 수정한 다음 다시 업로드해야 합니다. 문제를 일으킬 수 있는 이슈를 알려주는 경고가 표시될 수도 있지만 제출 진행을 막지는 않습니다.

패키지 세부 정보

업로드한 패키지가 대상 운영 체제별로 그룹화되어 여기에 나열됩니다. 패키지의 이름, 버전 및 아키텍처가 표시됩니다. 각 패키지에 대해 지원되는 언어, 앱 기능 및 파일 크기와 같은 자세한 내용을 확인하려면 세부 정보 표시를 클릭합니다.

제출에서 패키지를 제거해야 하는 경우, 각 패키지의 세부 정보 섹션 아래쪽에 있는 제거 링크를 클릭합니다.

중복 패키지 제거

하나 이상의 패키지가 중복된 것을 감지하면 이 제출에서 중복 패키지를 제거하도록 하는 경고가 표시됩니다. 이런 경우는 이전에 패키지를 업로드한 상태에서 이제 동일한 고객 집합을 지원하는 더 높은 버전의 패키지를 제공하는 경우에 종종 발생합니다. 이 경우 이런 고객을 지원하기 위한 더 나은(더 높은 버전) 패키지가 있으므로 어떤 고객도 중복 패키지를 받지는 못합니다.

중복 패키지가 있다는 사실이 감지되면, 해당 제출에서 모든 중복 패키지를 자동으로 제거하는 옵션이 제공됩니다. 원하는 경우 해당 제출에서 패키지를 개별적으로 제거할 수도 있습니다.

점진적 패키지 출시

제출이 이전에 게시된 앱에 대한 업데이트인 경우, 이 제출이 게시된 후 점진적으로 업데이트 롤아웃(Windows 10 또는 Windows 11 고객만 해당)이라는 확인란이 표시됩니다. 이 항목은 제출에서 해당 패키지를 가져올 고객의 비율을 선택할 수 있게 하며, 이렇게 함으로써 이들로부터 피드백과 분석 데이터를 모니터링해 보다 광범위하게 업데이트를 배포하기 전에 업데이트에 대한 확신을 가질 수 있습니다. 새 제출을 생성하지 않고도 언제든지 비율을 늘리거나 업데이트를 중지할 수 있습니다.

자세한 내용은 점진적 패키지 롤아웃을 참조하세요.

필수 업데이트

제출이 이전에 게시된 앱에 대한 업데이트인 경우, 이 업데이트를 필수로 설정하세요라는 확인란이 표시됩니다. 이 항목은 Windows.Services.Store API를 사용해 앱이 패키지 업데이트를 프로그래밍 방식으로 체크하고 업데이트된 패키지를 다운로드 및 설치할 수 있도록 했다고 가정함으로써 필수 업데이트의 날짜와 시간을 설정할 수 있게 합니다. 이 옵션을 사용하려면 앱이 Windows 10, 버전 1607 이상을 대상으로 해야 합니다.

자세한 내용은 앱에 대한 패키지 업데이트 다운로드 및 설치를 참조하세요.

장치 제품군 가용성

패키지가 패키지 페이지에 성공적으로 업로드되면 장치 제품군 가용성 섹션에 특정 Windows 10 또는 Windows 11 장치 제품군(및 해당하는 경우 이전 OS 버전)에 제공될 패키지를 순위대로 보여주는 표가 나타납니다. 또한 이 섹션에서는 특정 Windows 10 또는 Windows 11 장치 제품군의 고객에게 해당 제출을 제공할지 여부를 선택할 수 있습니다.

참고 항목

패키지를 아직 업로드하지 않은 경우, 장치 제품군 가용성 섹션에는 Windows 10 또는 Windows 11 장치 제품군이 표시되며, 여기에는 해당 장치 제품군의 고객에게 해당 제출을 제공할지 여부를 나타내는 확인란이 있습니다. 표는 하나 이상의 패키지를 업로드할 때까지 표시되지 않습니다.

이 섹션에는 Microsoft가 향후 Windows 10 또는 Windows 11 장치 제품군에 앱을 사용할 수 있도록 허용할지 여부를 나타내는 확인란도 포함되어 있습니다. 새 장치 제품군이 소개되면서 더 많은 잠재 고객이 앱을 사용할 수 있도록 하기 위해 이 확인란을 선택하는 것이 좋습니다.

지원할 장치 제품군 선택

개별 디바이스 패밀리를 대상으로 하는 패키지를 업로드하는 경우 해당 유형의 디바이스를 사용하는 신규 고객이 해당 패키지를 사용할 수 있도록 확인란을 선택합니다. 예를 들어 패키지가 Windows.Desktop 을 대상으로 하는 경우 해당 패키지에 대해 Windows 10/11 데스크톱 상자가 선택됩니다(다른 장치 패밀리에 대한 확인란을 선택할 수 없습니다).

Windows.Universal 장치 제품군을 대상으로 한 패키지는 모든 Windows 10 또는 Windows 11 장치(Xbox One 포함)에서 실행될 수 있습니다. 기본적으로 새로운 고객이 Xbox를 제외한 모든 디바이스 유형에서 패키지를 사용할 수 있게 합니다.

해당 유형의 장치를 사용하는 고객에게 제출을 제공하지 않고 싶다면 Windows 10 또는 Windows 11 장치 제품군에 대한 확인란의 선택을 취소하면 됩니다. 장치 제품군의 확인란이 선택되지 않은 경우, 해당 유형의 장치를 사용하는 새 고객은 앱을 구매할 수 없습니다(단, 이미 해당 앱을 보유한 고객은 계속 사용할 수 있으며 제출된 모든 업데이트를 받을 수 있습니다).

앱에서 이들을 지원하는 경우, 앱을 구매할 수 있는 Windows 10 또는 Windows 11 장치 유형을 제한해야 하는 특별한 이유가 없다면 모든 확인란을 선택된 상태로 유지하는 것이 좋습니다. 예를 들어 앱이 Surface Hub 및/또는 Microsoft HoloLens에 대해 적절한 환경을 제공하지 않는 경우 Windows 10 Team 및/또는 Windows 10 Holographic 확인란을 선택 해제할 수 있습니다. 이렇게 하면 새로운 고객이 해당 디바이스에서 앱을 다운로드할 수 없습니다. 나중에 이러한 고객에게 제공할 준비가 되면 이 확인란을 선택하여 새 제출을 생성할 수 있습니다.

Xbox 디바이스

Windows.Universal 패키지에 대해 기본값으로 선택되지 않은 유일한 Windows 10 또는 Windows 11 장치 제품군은 Windows 10 Xbox입니다. 앱이 게임이 아니거나 또는 게임인데 Xbox Live 크리에이터스 프로그램을 활성화했거나 개념 승인 프로세스를 마쳤고 제출에 Windows 10 SDK 버전 14393 이상을 사용하여 컴파일된 중립 및/또는 x64 UWP 패키지가 포함된 경우 Windows 10 Xbox 확인란을 선택하여 Xbox One 고객에게 앱을 제공할 수 있습니다.

Important

Xbox 장치에 앱을 시작하려면 Windows SDK 버전 14393 이상으로 컴파일된 중립 또는 x64 패키지를 포함해야 합니다. 그러나 Windows 10 Xbox를 선택한 경우, 이전 버전의 SDK를 사용하여 컴파일된 경우에도 항상 Xbox에서 적용할 수 있는 가장 높은 버전의 패키지(즉, Xbox 또는 유니버설 디바이스 패밀리를 대상으로 하는 중립 또는 x64 패키지)가 Xbox 고객에게 제공됩니다. 이 때문에 Xbox에 적용할 수 있는 가장 높은 버전 패키지를 Windows SDK 버전 14393 이상으로 컴파일하는 것이 중요합니다. 그렇지 않은 경우, Xbox 고객은 앱을 시작할 수 없음을 나타내는 오류 메시지가 표시됩니다.

이 오류를 해결하려면 다음 작업 중 하나를 수행하십시오.

• 해당 패키지를 Windows SDK 버전 14393 이상을 사용해 컴파일한 새 패키지로 바꿉니다.
• 이미 Xbox를 지원하는 패키지가 있고 Windows SDK 버전 14393 이상으로 컴파일한 경우, 제출 상에서 가장 버전 번호가 높은 패키지가 되도록 버전 번호를 높여야 합니다.
• Windows 10 Xbox용 확인란의 선택을 해제합니다.

그래도 문제를 해결할 수 없는 경우, 지원팀에 문의합니다.

Windows 10 IoT Core에 대한 UWP 앱을 제출하는 경우, 패키지를 업로드한 후 기본 선택을 변경해서는 안 되기 때문에 Windows 10 IoT을 위한 별도의 확인란이 없습니다. IoT Core UWP 앱 게시에 대한 자세한 내용은 IoT Core UWP앱에 대한 Microsoft Store 지원을 참조하세요.

Important

특정 Windows 10 또는 Windows 11 디바이스 패밀리가 제출을 받지 못하도록 하려면 기본적으로 Microsoft Visual Studio가 매니페스트에 포함하는 Windows.Universal 값(유니버설 디바이스 패밀리용)으로 두지 않고 지원하려는 디바이스 패밀리(예: Windows.Desktop)만 대상으로 지정하도록 매니페스트의 TargetDeviceFamily 요소를 업데이트합니다.

디바이스 패밀리 가용성 섹션에서 선택한 내용은 새 구입에만 적용되는 점을 기억하세요. 앱을 이미 소유하고 있는 사용자는 이를 계속 사용할 수 있으며, 여기에서 해당 디바이스 패밀리를 제거한 경우에도 제출한 업데이트를 받게 됩니다. 이는 Windows 10 또는 Windows 11로 업그레이드하기 전에 앱을 구입한 고객에게도 적용됩니다.

디바이스 제품군에 대한 자세한 내용은 확장 SDK를 사용한 프로그래밍을 참조하세요.

순위 이해

제출을 다운로드할 수 있는 Windows 10 또는 Windows 11 장치 제품군을 표시할 수 있게 하는 것 외에도, 장치 제품군 가용성 섹션에는 다양한 장치 제품군에서 가용한 특정 패키지가 표시됩니다. 특정 장치 제품군에서 실행 가능한 패키지가 두 개 이상인 경우, 해당 테이블은 패키지의 버전 번호에 따라 패키지가 제공되는 순서를 나타냅니다. 버전 번호에 기반해 스토어에서 패키지 순위를 지정하는 방법에 대한 자세한 내용은 패키지 버전 번호 지정을 참조하세요.

예를 들어, Package_A.appxupload 및 Package_B.appxupload라는 두 개의 패키지가 있다고 가정해 보겠습니다. 장치 제품군에서 Package_A.appxupload가 1등이고 Package_B.appxupload가 2등인 경우, 해당 유형의 장치를 사용하는 있는 고객이 앱을 구입하면 스토어는 먼저 Package_A.appxupload를 제공하려고 시도합니다. 고객의 장치가 Package_A.appxupload를 실행할 수 없는 경우, 스토어는 Package_B.appxupload를 제공합니다. 고객의 디바이스에서 해당 디바이스 패밀리에 대한 패키지를 모두 실행할 수 없는 경우 예를 들어, 앱에서 지원하는 MinVersion이 고객 디바이스의 버전보다 높으면 고객이 해당 디바이스에 앱을 다운로드할 수 없습니다.

참고 항목

.xap 패키지(이전에 게시된 앱용)의 버전 번호는 특정 고객에게 제공할 패키지를 결정할 때 고려되지 않습니다. 이 때문에 동일한 순위의 .xap 패키지가 두 개 이상 있는 경우, 숫자가 아닌 별표로 표시되며 고객은 두 패키지 중 하나를 받을 수 있습니다. 하나의 .xap 패키지에서 최신 패키지로 고객을 업데이트하려면, 새 제출에서 이전 .xap를 제거해야 합니다.