패키지 버전 번호 지정

제공하는 각 패키지에는 버전 번호가 있어야 합니다(앱 매니페스트에 있는 패키지/ID 요소의 버전 속성값으로 제공). 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

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