패키지 버전 번호 매기기

제공하는 각 패키지에는 버전 번호가 있어야 합니다(앱 매니페스트에 있는 Package/Identity 요소의 Version 특성에 값으로 제공됨). Microsoft Store에서는 버전 번호와 관련 특정 규칙을 적용하며, 이는 OS 버전마다 약간 다르게 작동합니다.

참고 항목

이 항목에서는 "패키지"를 참조하지만 별도로 언급되지 않은 한 .msix/.appx 파일과 .msixbundle/.appxbundle 파일 모두에 동일한 버전 번호 규칙이 적용됩니다.

Windows 10 및 11 패키지의 버전 번호 매기기

Important

Windows 10 또는 Windows 11(UWP) 패키지의 경우 버전 번호의 마지막(네 번째) 섹션은 스토어 사용을 위해 예약되어 있으며 패키지를 빌드할 때 0으로 남아 있어야 합니다(스토어에서 이 섹션의 값을 변경할 수 있음). 다른 섹션은 0에서 65535 사이의 정수로 설정해야 합니다(0일 수 없는 첫 번째 섹션 제외).

게시된 제출에서 UWP 패키지를 선택할 때 Microsoft Store는 항상 고객의 Windows 10 또는 Windows 11 디바이스에 적용할 수 있는 가장 높은 버전의 패키지를 사용합니다. 이렇게 하면 유연성이 향상되고 특정 디바이스 유형에서 고객에게 어떤 패키지가 제공될지 제어할 수 있습니다. 중요한 것은 이러한 패키지를 순서대로 제출할 수 있습니다. 후속 제출마다 상위 버전 패키지를 제공하는 것으로 제한되지 않습니다.

동일한 버전 번호로 여러 UWP 패키지를 제공할 수 있습니다. 그러나 버전 번호를 공유하는 패키지도 동일한 아키텍처를 가질 수 없습니다. 스토어에서 각 패키지에 사용하는 전체 ID는 고유해야 하기 때문입니다. 자세한 내용은 ID를 참조 하세요.

동일한 버전 번호를 사용하는 여러 UWP 패키지를 제공하는 경우 아키텍처(x64, x86, Arm, 중립 순서)를 사용하여 순위가 높은 패키지를 결정합니다(스토어에서 고객의 디바이스에 제공할 패키지를 결정하는 경우). 동일한 버전 번호를 사용하는 앱 번들의 순위를 지정하는 경우 번들 내에서 가장 높은 아키텍처 순위가 고려됩니다. x64 패키지가 포함된 앱 번들은 x86 패키지만 포함된 앱 번들보다 순위가 높습니다.

이렇게 하면 시간이 지남에 따라 앱을 발전할 수 있는 많은 유연성이 있습니다. 더 낮은 버전 번호를 사용하는 새 패키지를 업로드하고 제출하여 이전에 지원하지 않았던 Windows 10 또는 Windows 11 디바이스에 대한 지원을 추가하거나, 하드웨어 또는 OS 기능을 활용하기 위해 더 엄격한 종속성이 있는 상위 버전 패키지를 추가하거나, 기존 고객 기반의 일부 또는 전부에 대한 업데이트 역할을 하는 상위 버전 패키지를 추가할 수 있습니다.

다음 예제에서는 버전 번호 매기기를 관리하여 여러 제출을 통해 고객에게 의도한 패키지를 배달하는 방법을 보여 줍니다.

예: 여러 제출을 통해 단일 패키지로 이동

Windows 10을 사용하면 어디서나 실행되는 단일 코드베이스를 작성할 수 있습니다. 이렇게 하면 새 플랫폼 간 프로젝트를 훨씬 쉽게 시작할 수 있습니다. 그러나 여러 가지 이유로 기존 코드베이스를 병합하여 단일 프로젝트를 즉시 만들지 않을 수 있습니다.

패키지 버전 관리 규칙을 사용하여 고객을 유니버설 디바이스 패밀리용 단일 패키지로 점진적으로 이동하는 동시에 특정 디바이스 패밀리에 대한 여러 중간 업데이트(Windows 10 API를 활용하는 업데이트 포함)를 배송할 수 있습니다. 아래 예제에서는 동일한 앱에 대한 일련의 제출에 대해 동일한 규칙이 일관되게 적용되는 방법을 보여 줍니다.

제출	콘텐츠	고객 환경
1	- 패키지 버전: 1.1.10.0 - 디바이스 패밀리: Windows.Desktop, minVersion 10.0.10240.0	- Windows 10 및 11 Desktop 빌드 10.0.10240.0 이상의 디바이스는 1.1.10.0을 가져옵니다. - 다른 디바이스 패밀리는 앱을 구매하고 설치할 수 없습니다.
2	- 패키지 버전: 1.1.10.0 - 디바이스 패밀리: Windows.Desktop, minVersion 10.0.10240.0 - 패키지 버전: 1.0.0.0 - 디바이스 패밀리: Windows.Universal, minVersion 10.0.10240.0	- Windows 10 및 11 Desktop 빌드 10.0.10240.0 이상의 디바이스는 1.1.10.0을 가져옵니다. - 다른(데스크톱이 아닌) 디바이스 패밀리가 도입되면 1.0.0.0을 받습니다. - 앱이 이미 설치된 데스크톱 디바이스에는 업데이트가 표시되지 않습니다(사용 가능한 최상의 버전 1.1.10.0이 있고 1.0.0.0보다 높기 때문).
3	- 패키지 버전: 1.1.10.0 - 디바이스 패밀리: Windows.Desktop, minVersion 10.0.10240.0 - 패키지 버전: 1.1.5.0 - 디바이스 패밀리: Windows.Universal, minVersion 10.0.10250.0 - 패키지 버전: 1.0.0.0 - 디바이스 패밀리: Windows.Universal, minVersion 10.0.10240.0	- Windows 10 및 11 Desktop 빌드 10.0.10240.0 이상의 디바이스는 1.1.10.0을 가져옵니다. - 빌드 10.0.10250.0 이상에서 도입된 기타(데스크톱이 아닌) 디바이스 패밀리는 1.1.5.0을 받습니다. - 빌드 >=10.0.10240.0 및 10.010250.0과 < 함께 도입된 기타(데스크톱이 아닌) 디바이스 familes는 1.1.0.0을 가져옵니다. - 앱이 이미 설치된 데스크톱 디바이스에는 업데이트가 표시되지 않습니다(이미 사용 가능한 버전 1.1.10.0이 1.1.5.0 및 1.0.0.0보다 높기 때문).
4	- 패키지 버전: 2.0.0.0 - 디바이스 패밀리: Windows.Universal, minVersion 10.0.10240.0	- Windows 10 및 11 빌드 v10.0.10240.0 이상의 모든 디바이스 패밀리에 있는 모든 고객은 패키지 2.0.0.0을 받습니다.

참고 항목

 모든 경우에 고객 디바이스는 가능한 가장 높은 적격 버전 번호의 패키지를 받게 됩니다. 예를 들어 위의 세 번째 제출에서 모든 데스크톱 디바이스는 OS 버전 10.0.10250.0 이상이 있어 v1.1.5.0을 수락할 수 있더라도 v1.1.10.0을 가져옵니다. 1.1.10.0은 사용할 수 있는 가장 높은 버전 번호이므로, 이것이 바로 패키지입니다.

버전 번호 매기기를 사용하여 새 구입을 위해 이전에 제공된 패키지로 롤백

패키지의 복사본을 보관하는 경우 릴리스에 문제가 있으면 스토어의 앱 패키지를 이전 Windows 10 패키지로 롤백할 수 있습니다. 이는 문제를 해결하는 동안 고객의 혼란을 최소화할 수 있는 임시 방편입니다.

이렇게 하려면 새 제출을 만듭니다. 문제가 있는 패키지를 제거하고 스토어에서 제공하려는 이전 패키지를 업로드합니다. 롤백하려는 패키지를 이미 받은 고객에게는 문제가 있는 패키지가 계속 있습니다(이전 패키지에 이전 버전 번호가 있기 때문에). 그러나 이렇게 하면 다른 사람이 문제가 있는 패키지를 획득하는 것을 막을 수 있지만 스토어에서 앱을 계속 사용할 수 있습니다.

문제가 있는 패키지를 이미 받은 고객에 대한 문제를 해결하려면 최대한 빨리 잘못된 패키지보다 버전 번호가 더 높은 새 Windows 10 패키지를 제출하면 됩니다. 해당 제출이 인증 프로세스를 거치면 버전 번호가 더 높기 때문에 모든 고객이 새 패키지로 업데이트됩니다.

설치 관리자를 통해 패키지 버전 번호 매기기를 관리할 수 있습니다. Win32에 대한 패키지 버전 번호 매기기는 스토어를 통해 지원되지 않습니다.

Important

패키지 버전 번호 매기기는 앱 추가 기능에 대해 지원되지 않습니다.