앱 패키지 업로드

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

Important

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

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

제출에 패키지 업로드

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

Important

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

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

패키지를 유효성 검사하는 동안 패키지에서 오류를 검색하면 무엇이 잘못되었는지 알려주는 메시지를 표시합니다. 패키지를 제거하고 문제를 수정한 다음 다시 업로드해야 합니다. 문제가 발생할 수 있지만 제출을 계속하는 것을 차단하지 않는 문제에 대해 알려주는 경고가 표시될 수도 있습니다.

디바이스 패밀리 가용성

패키지가 성공적으로 업로드되면 디바이스 패밀리 가용성 섹션에 특정 Windows 10 또는 Windows 11 디바이스 패밀리(및 해당하는 경우 이전 OS 버전)에 제공될 패키지를 순위가 지정된 순서로 나타내는 테이블이 표시됩니다. 또한 이 섹션에서는 특정 Windows 10 또는 Windows 11 디바이스 패밀리에서 고객에게 제출을 제공할지 여부를 선택할 수 있습니다.

자세한 내용은 디바이스 패밀리 가용성을 참조 하세요.

패키지 세부 정보

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

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

중복 패키지 제거

하나 이상의 패키지가 중복되는 것을 감지하면 이 제출에서 중복 패키지를 제거한다는 경고가 표시됩니다. 이전에 패키지를 업로드했으며 이제 동일한 고객 집합을 지원하는 더 높은 버전의 패키지를 제공하는 경우가 종종 있습니다. 이 경우 이러한 고객을 지원하기 위한 더 나은(더 높은 버전) 패키지가 있으므로 어떤 고객도 중복 패키지를 얻지 못할 것입니다.

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

점진적 패키지 출시

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

자세한 내용은 점진적 패키지 출시를 참조 하세요.

필수 업데이트

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

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

앱 제출 프로세스의 패키지 페이지에서는 제출 중인 앱에 대한 패키지(MSI/EXE) 및 관련 정보를 제공합니다. 고객이 앱을 다운로드하면 스토어는 각 고객에게 디바이스에 가장 적합한 패키지를 자동으로 제공합니다.

하나 이상의 패키지에 대한 패키지 페이지를 완료해야 합니다. 패키지를 추가하려면 패키지 페이지에서 패키지 추가를 클릭합니다.

패키지 정보 추가 및 편집

패키지 정보를 편집하려면 패키지 페이지에서 패키지를 선택합니다. 각 패키지를 개별적으로 편집해야 합니다.

패키지 URL
Required

CDN에서 호스트형 앱 패키지(MSI/EXE)를 가리키는 버전이 지정된 보안 URL을 하나 이상 입력해야 합니다. 버전이 지정된 보안 URL의 예는https://www.contoso.com/downloads/1.1/setup.exe입니다. 고객이 스토어에서 앱을 설치하면 스토어는 이 URL에서 패키지를 다운로드합니다. 우수한 CDN 사례를 따르고 이 URL이 지역/국가 선택 영역에 따라 성능이 좋고 안정적이며 사용 가능한지 확인해야 합니다.

패키지 URL을 업데이트해야 하는 경우 파트너 센터에서 제출 업데이트 옵션을 사용하여 새 패키지 URL을 지정할 수 있습니다.

사용자가 인증된 이진만 설치되도록 제출한 후에는 패키지 URL의 이진을 변경하면 안 됩니다. 스토어는 CDN(콘텐츠 배달 네트워크)과 같은 별도의 호스팅 서비스에서 호스트하는 앱 설치 관리자가 파트너 센터 또는 API를 통해 제출하지 않고 새 앱 설치 관리자 패키지와 교환되는 경우 배포할 최신 앱 패키지의 복사본을 유지합니다. 또한 스토어는 새 앱 패키지를 다운로드하고 인증 프로세스를 시작합니다. 업데이트가 인증 테스트를 통과하면 스토어에서 최종 사용자가 업데이트를 사용할 수 있도록 합니다. 업데이트가 인증 테스트에 실패하면 스토어에서 파트너 센터 또는 API를 통해 업데이트를 제출하도록 알 수 있습니다.

호출 시 2진을 다운로드하는 다운로더가 아니라 독립 실행형/오프라인 설치 관리자를 제출해야 합니다. 이는 설치된 이진 및 인증 프로세스를 통과한 이진을 인증하는 데 필요합니다.

아키텍처
Required

다음 값 중 하나에서 패키지에 포함된 코드의 아키텍처를 선택해야 합니다.

• x86
• X64
• 중립
• arm
• arm64

1개 이상의 아키텍처에서 컴파일된 패키지가 있는 경우 제출에 추가해야 합니다.

언어
Required

100개 이상의 언어로 Microsoft Store에 앱을 제출할 수 있습니다. 앱은 다음 언어 중 하나 이상을 지원해야 합니다.

참고 항목

여기에 나열되지 않은 언어 코드는 스토어에서 지원 되지 않습니다.

언어 이름	지원되는 언어 코드
아프리칸스어	af, af-za
알바니아어	sq, sq-al
암하라어	am, am-et
아르메니아	hy, hy-am
아삼어	as, as-in
아제르바이잔어	az-arab, az-arab-az, az-cyrl, az-cyrl-az, az-latn, az-latn-az
바스크어(바스크)	eu, eu-es
벨로루시어	be, be-by
벵골어	bn, bn-bd, bn-in
보스니아 헤르체고비나어	bs, bs-cyrl, bs-cyrl-ba, bs-latn, bs-latn-ba
불가리아어	bg, bg-bg
카탈로니아어	ca, ca-es, ca-es-valencia
체로키어	chr-cher, chr-cher-us, chr-latn
중국어(간체)	zh-Hans, zh-cn, zh-hans-cn, zh-sg, zh-hans-sg
중국어(번체)	zh-Hant, zh-hk, zh-mo, zh-tw, zh-hant-hk, zh-hant-mo, zh-hant-tw, zh-mo, zh-tw, zh-hant-hk, zh-hant-mo, zh-hant-tw
크로아티아어	hr, hr-hr, hr-ba
체코어	cs, cs-cz
덴마크어	da, da-dk
다리어	prs, prs-af, prs-arab
네덜란드어	nl, nl-nl, nl-be
영어	en, en-au, en-ca, en-gb, en-ie, en-in, en-nz, en-sg, en-us, en-za, en-bz, en-hk, en-id, en-jm, en-kz, en-mt, en-my, en-ph, en-pk, en-tt, en-vn, en-zw
에스토니아어	et, et-ee
필리핀어	fil, fil-latn, fil-ph
핀란드어	fi, fi-fi
프랑스어/French	fr, fr-be , fr-ca , fr-ch , fr-fr , fr-lu, fr-cd, fr-ci, fr-cm, fr-ht, fr-ma, fr-mc, fr-ml, fr-re, frc-latn, frp-latn
갈리시아어	gl, gl-es
그루지야어	ka, ka-ge
독일어	de, de-at, de-ch, de-de, de-lu, de-li
그리스어	el, el-gr
구자라트어	gu, gu-in
하우사어	ha, ha-latn, ha-latn-ng
히브리어	그, 허일
힌디어	hi, hi-in
헝가리어	hu, hu-hu
아이슬란드어	is, is-is
이그보어	ig-latn, ig-ng
인도네시아어	id, id-id
이누크티투트어 (라틴어)	iu-cans, iu-latn, iu-latn-ca
아일랜드어	ga, ga-ie
코사어	xh, xh-za
줄루어	zu, zu-za
이탈리아어	it, it-it, it-ch
일본어	ja, ja-jp
칸나다어	kn, kn-in
카자흐어	kk, kk-kz
크메르어	km, km-kh
키체어	quc-latn, qut-gt, qut-latn
키냐르완다어	rw, rw-rw
KiSwahili	sw, sw-ke
코카니어	kok, kok-in
한국어	ko, ko-kr
쿠르드어	ku-arab, ku-arab-iq
키르기스어	ky-kg, ky-cyrl
라오스어	lo, lo-la
라트비아어	lv, lv-lv
리투아니아어	lt, lt-lt
룩셈부르크어	lb, lb-lu
마케도니아어	mk, mk-mk
말레이어	ms, ms-bn, ms-my
말라얄람어	ml, ml-in
몰타어	mt, mt-mt
마오리어	mi, mi-latn, mi-nz
마라티어	mr, mr-in
몽골어(키릴 자모)	mn-cyrl, mn-mong, mn-mn, mn-phag
네팔어	ne, ne-np
노르웨이어	nb, nb-no, nn, nn-no, no, no-no
오디아어	또는, 또는-in
페르시아어	fa, fa-ir
폴란드어	pl, pl-pl
포르투갈어(브라질)	pt-br
포르투갈어(포르투갈)	pt, pt-pt
펀잡어	pa, pa-arab, pa-arab-pk, pa-deva, pa-in
케추아어	quz, quz-bo, quz-ec, quz-pe
루마니아어	ro, ro-ro
러시아어	ru , ru-ru
스코틀랜드 게일어	gd-gb, gd-latn
세르비아어(라틴 문자)	sr-Latn, sr-latn-cs, sr, sr-latn-ba, sr-latn-me, sr-latn-rs
세르비아어(키릴 자모)	sr-cyrl, sr-cyrl-ba, sr-cyrl-cs, sr-cyrl-me, sr-cyrl-rs
Sesotho sa Leboa	nso, nso-za
세츠와나어	tn, tn-bw, tn-za
신디어	sd-arab, sd-arab-pk, sd-deva
싱할라어	si, si-lk
슬로바키아어	sk, sk-sk
슬로베니아어	sl, sl-si
스페인어	es, es-cl, es-co, es-es, es-mx, es-ar, es-bo, es-cr, es-do, es-ec, es-gt, es-hn, es-ni, es-pa, es-pe, es-pr, es-py, es-sv, es-us, es-uy, es-ve
스웨덴어	sv, sv-se, sv-fi
타지크어(키릴 자모)	tg-arab, tg-cyrl, tg-cyrl-tj, tg-latn
타밀어	ta, ta-in
타타르어	tt-arab, tt-cyrl, tt-latn, tt-ru
텔루구어	te, te-in
태국어	th, th-th
티그리냐어	ti, ti-et
터키어	tr, tr-tr
투르크멘어	tk-cyrl, tk-latn, tk-tm, tk-latn-tr, tk-cyrl-tr
우크라이나어	uk, uk-ua
우르두어	your, your-pk
위구르어	ug-arab, ug-cn, ug-cyrl, ug-latn
우즈베크어(라틴 문자)	uz, uz-cyrl, uz-latn, uz-latn-uz
베트남어	vi, vi-vn
웨일스어	cy, cy-gb
월라프어	wo, wo-sn
요루바어	yo-latn, yo-ng

앱 유형
Required

앱 유형(EXE/MSI)을 선택합니다. EXE를 선택하는 경우 설치 관리자 매개 변수 및 설치 관리자 처리에 대한 세부 정보를 제공해야 합니다.

설치 관리자 매개 변수
Required

스토어는 설치 관리자를 자동 모드로 실행해야 합니다. 이를 지원하려면 EXE 앱의 설치 관리자와 관련된 필수 스위치(예: /s)를 제공해야 합니다. 설치 관리자가 기본적으로 스위치 없이 자동 모드로 실행되는 경우에는 이 작업이 필요하지 않습니다.

MSI 앱의 경우 스토어는 기본 자동 스위치 '/qn'을 사용하여 자동 모드에서 설치 관리자를 실행합니다.

EXE 앱에 대한 설치 관리자 처리
Required

EXE 앱에는 일반적으로 설치 중에 사용자 지정 코드를 반환하는 설치 관리자가 있습니다. 스토어는 사용자가 제공한 사용자 지정 반환 코드에 적합한 고객 연결 메시지 및 작업을 지원합니다.

스토어에서 지원하는 표준 설치 시나리오는 다음과 같습니다.

시나리오	설명
사용자가 설치를 취소했습니다.	사용자가 설치 작업을 취소했습니다.
애플리케이션이 이미 있음	애플리케이션이 이미 디바이스에 있습니다.
설치가 이미 진행 중입니다.	다른 설치가 이미 진행 중입니다. 이 설치를 계속하기 전에 사용자가 설치를 완료해야 합니다.
디스크 공간이 꽉 찼습니다.	디스크 공간이 가득 찼습니다.
다시 부팅 필요	설치를 완료하려면 다시 시작해야 합니다.
네트워크 오류	다양한 네트워크 관련 오류에 대한 사용자 지정 반환 코드 값을 제공합니다.
설치 중에 패키지가 거부됨	디바이스에서 사용하도록 설정된 보안 정책으로 인해 설치 중에 패키지가 거부되었습니다.
설치 성공	설치에 성공했습니다.

설치 관리자 동작에 따라 위의 각 시나리오에 대해 1개 이상의 반환 코드를 추가할 수 있습니다.

위의 표준 시나리오 목록을 초과하는 시나리오의 경우 고객은 설치 관리자 반환 코드 설명서로 이동합니다. 기타 설치 실패 시나리오의 경우 Store에서 고객을 가리킬 수 있는 반환 코드 관련 설명서 URL과 함께 사용자 지정 반환 코드를 추가할 수 있습니다.

스토어에서 고객에게 맞춤형 환경을 제공할 수 있도록 EXE 앱에 이 정보를 제공하는 것이 좋습니다. 이렇게 하면 스토어에서 EXE 앱에 대한 앱 설치를 처리하고 보고하는 데도 도움이 됩니다.

패키지를 추가한 후 초안 저장을 클릭합니다. 패키지 관리 페이지로 돌아갑니다. 패키지 목록에서 패키지가 추가된 것을 볼 수 있습니다. 패키지 목록에 패키지가 추가되었는지 확인한 후 모두 저장을 클릭합니다. 패키지가 업로드 중이라는 메시지가 표시되고 업로드가 성공하면 저장됨으로 메시지가 표시됩니다.

Important

앱 패키지는 현재 추가 기능에 대해 지원되지 않습니다.