Visual Studio에서 데스크톱 또는 UWP 앱 패키징

앱을 배포하려면 먼저 해당 앱을 패키지해야 합니다. 이 문서에서는 Visual Studio를 사용하여 MSIX 패키지를 구성하고, 만들고, 테스트하는 프로세스에 대해 설명합니다.

앱 패키지 유형

• 앱 패키지(.msix 또는 .appx)
  단일 디바이스 아키텍처를 대상으로 하는 애플리케이션 및 해당 리소스가 포함된 단일 패키지입니다. 예를 들어 x64 또는 x86 애플리케이션 패키지가 있습니다. 앱 번들을 사용하는 여러 아키텍처를 대상으로 하려면 각 아키텍처마다 하나씩 생성해야 합니다.

• 앱 번들(.msixbundle 또는 .appxbundle)
  앱 번들은 여러 앱 패키지를 포함할 수 있는 패키지 유형이며 각각 특정 디바이스 아키텍처를 지원하도록 빌드됩니다. 예를 들어 앱 번들에는 x86, x64 및 ARM 구성에 대해 세 개의 개별 앱 패키지가 포함될 수 있습니다. 앱 번들은 가능한 한 가장 광범위한 디바이스에서 앱을 사용할 수 있도록 허용하므로 가능한 경우 언제든지 생성해야 합니다.

• 앱 패키지 업로드 파일(.msixupload 또는 .appxupload) - 스토어 제출 전용
  여러 앱 패키지 또는 앱 번들을 포함하여 다양한 프로세서 아키텍처를 지원할 수 있는 단일 파일입니다. 또한 앱 패키지 업로드 파일에는 앱이 Microsoft Store에 게시되면 앱 성능을 분석하기 위한 기호 파일도 포함됩니다. 앱을 파트너 센터에 제출하여 Microsoft Store에 게시하기 위해 Visual Studio에서 앱을 패키지하는 경우 이 파일이 자동으로 만들어집니다.

앱 패키지를 준비하고 만드는 단계에 대한 개요는 다음과 같습니다.

1. 앱을 패키징하기 전에. 앱을 패키지할 준비가 되었는지 확인하려면 이러한 단계를 수행합니다.

2. 프로젝트를 구성합니다. Visual Studio 매니페스트 디자이너를 사용하여 패키지를 구성합니다. 예를 들어 타일 이미지를 추가하고 앱에서 지원하는 방향을 선택합니다.

3. 앱 패키지를 생성합니다. Visual Studio 패키징 마법사를 사용하여 앱 패키지를 만듭니다.

4. 패키지된 애플리케이션을 실행, 디버그 및 테스트합니다. Visual Studio를 사용하거나 패키지를 직접 설치하여 앱 패키지를 실행하고 디버그합니다.

앱을 패키징하기 전에

1. 앱 테스트 애플리케이션을 패키지하기 전에 지원하려는 모든 디바이스 제품군에서 예상대로 작동하는지 확인합니다. 이러한 디바이스 제품군에는 데스크톱, 모바일, Surface Hub, Xbox, IoT 디바이스 등이 포함될 수 있습니다. Visual Studio를 사용하여 앱을 배포하고 테스트하는 방법에 대한 자세한 내용은 UWP 앱 배포 및 디버그를 참조하세요(패키지된 데스크톱 앱에도 적용됨).

2. 앱을 최적화합니다. Visual Studio의 프로파일링 및 디버깅 도구를 사용하여 패키지된 애플리케이션의 성능을 최적화할 수 있습니다. 예를 들어 UI 응답성용 타임라인 도구, 메모리 사용량 도구, CPU 사용량 도구 등이 있습니다. 이러한 도구에 대한 자세한 내용은 프로파일링 기능 둘러보기 항목을 참조하세요.

3. .NET 네이티브 호환성을 확인합니다(VB 및 C# 앱의 경우). 유니버설 Windows 플랫폼에는 앱의 런타임 성능을 향상시키는 네이티브 컴파일러가 있습니다. 이처럼 변경된 기능을 사용하는 컴파일 환경에서 앱을 테스트해야 합니다. 기본적으로 릴리스 빌드 구성은 .NET 네이티브 도구 체인을 사용하도록 설정하므로 이 릴리스 구성으로 앱을 테스트하고 앱이 예상대로 동작하도록 검사 것이 중요합니다.

프로젝트 구성

앱 매니페스트 파일(Package.appxmanifest)은 앱 패키지를 만드는 데 필요한 속성과 설정이 포함된 XML 파일입니다. 예를 들어 앱 매니페스트 파일의 속성에서는 앱의 타일로 사용할 이미지 및 사용자가 디바이스를 회전할 때 앱에서 지원하는 방향을 설명합니다.

Visual Studio 매니페스트 디자이너를 사용하면 파일의 원시 XML을 편집하지 않고도 매니페스트 파일을 업데이트할 수 있습니다.

매니페스트 디자이너를 사용하여 패키지 구성

1. 솔루션 탐색기에서 애플리케이션 프로젝트의 노드를 펼칩니다.

2. Package.appxmanifest 파일을 두 번 클릭합니다. 매니페스트 파일이 XML 코드 뷰에 이미 열린 경우 Visual Studio에서 파일을 닫으라는 메시지를 표시합니다.

3. 이제 앱을 구성하는 방법을 결정할 수 있습니다. 각 탭에는 앱에 대해 구성할 수 있는 정보와 필요한 경우 추가 정보에 대한 링크가 포함되어 있습니다.

   

   Visual Assets 탭에서 앱에 필요한 모든 이미지가 있는지 확인합니다 . 앱 아이콘과 로고를 제공하는 위치입니다.

   패키징 탭에서 게시 데이터를 입력할 수 있습니다. 여기서 앱에 서명하는 데 사용할 인증서를 선택할 수 있습니다. 모든 MSIX 앱은 인증서를 사용하여 서명되어야 합니다.

   참고 항목

   Visual Studio 2019부터 임시 인증서는 패키지된 데스크톱 또는 UWP 프로젝트에서 더 이상 생성되지 않습니다. 인증서를 만들거나 내보내려면 이 문서에 설명된 PowerShell cmdlet을 사용하세요. 최신 버전의 Visual Studio에서는 개발 및 테스트 시나리오를 위해 Azure Key Vault에 저장된 인증서로 앱에 서명할 수도 있습니다.

   Important

   Microsoft Store에서 앱을 게시하는 경우 앱은 신뢰할 수 있는 인증서로 서명됩니다. 이를 통해 사용자는 관련 앱 서명 인증서를 설치하지 않고도 앱을 설치하고 실행할 수 있습니다.

   앱 패키지를 디바이스에 설치하는 경우 먼저 패키지를 신뢰해야 합니다. 패키지를 신뢰하려면 인증서를 사용자의 디바이스에 설치해야 합니다.

4. 앱에 필요한 대로 편집되었으면 Package.appxmanifest 파일을 저장합니다.

Microsoft Store를 통해 앱을 배포하는 경우 Visual Studio에서 패키지를 Microsoft Store에 연결할 수 있습니다. 이렇게 하려면 솔루션 탐색기 프로젝트 이름을 마우스 오른쪽 단추로 클릭하고 스토어에 게시->연결 앱을 선택합니다(Visual Studio 2019 버전 16.3 이전에는 게시 메뉴의 이름이 Store임). 또한 이 작업은 다음 섹션에서 설명하는 앱 패키지 만들기 마법사에서도 수행할 수 있습니다. 앱을 연결하면 매니페스트 디자이너의 [패키징] 탭에 있는 일부 필드가 자동으로 업데이트됩니다.

앱 패키지 생성

Microsoft Intune 및 Configuration Manager 등의 애플리케이션 관리 도구를 사용하여 웹 사이트에 게시하여 스토어에 게시하지 않고도 앱을 설치할 수 있습니다. 로컬 또는 원격 머신에서 테스트하기 위해 MSIX 패키지를 직접 설치할 수도 있습니다.

패키징 마법사를 사용하여 앱 패키지 만들기

참고 항목

다음 지침과 스크린샷에서는 Visual Studio 2019 버전 16.3의 프로세스를 설명합니다. 이전 버전을 사용하는 경우 일부 UI가 다르게 보일 수 있습니다. 데스크톱 애플리케이션을 패키지하는 경우 마우스 오른쪽 단추로 Windows 애플리케이션 패키징 프로젝트 노드를 클릭합니다.

1. 솔루션 탐색기에서 애플리케이션 프로젝트에 대한 솔루션을 엽니다.

2. 프로젝트를 마우스 오른쪽 단추로 클릭하고 앱 패키지 게시->만들기를 선택합니다(Visual Studio 2019 버전 16.3 이전의 게시 메뉴 이름은 Store).

   

3. 마법사의 첫 번째 페이지에서 사이드로드 중을 선택하고, 다음을 클릭합니다.

   

4. 서명 방법 선택 페이지에서 패키지 서명을 건너뛸지, 아니면 서명할 인증서를 선택할지 여부를 선택합니다. 로컬 인증서 저장소에서 인증서를 선택하거나, 인증서 파일을 선택하거나, 새 인증서를 만들 수 있습니다. MSIX 패키지를 최종 사용자의 머신에 설치하려면 머신에서 신뢰할 수 있는 인증서로 서명해야 합니다.

   

5. Visual Studio를 사용하여 앱 패키지 업로드 파일 만들기 섹션에서 설명한 대로 패키지 선택 및 구성 페이지를 완료합니다.

두 번 클릭하여 앱 패키지 설치

앱 패키지는 앱 패키지 파일을 두 번 클릭하여 간단히 설치할 수 있습니다. 이렇게 하려면 앱 패키지 또는 앱 번들 파일로 이동하여 두 번 클릭합니다. 앱 설치 관리자가 시작되어 기본 앱 정보와 함께 설치 단추, 설치 진행률 표시줄 및 관련 오류 메시지가 제공됩니다.

참고 항목

앱 설치 관리자는 패키지가 디바이스에서 신뢰할 수 있는 인증서로 서명되었다고 가정합니다. 그렇지 않으면 서명 인증서를 디바이스의 신뢰할 수 있는 사용자 또는 신뢰할 수 있는 게시자 인증 기관 저장소에 설치해야 합니다. 이 작업을 수행하는 방법을 잘 모르는 경우 테스트 인증서 설치를 참조하세요.

설치 스크립트를 사용하여 앱 패키지 설치

1. *_Test 폴더를 엽니다.

2. 마우스 오른쪽 단추로 AppDevPackage.ps1 파일을 클릭합니다. PowerShell에서 실행을 선택한 다음, 화면의 지시에 따릅니다.
   

   앱 패키지가 설치되면 PowerShell 창에 앱이 성공적으로 설치되었다는 메시지가 표시됩니다.

3. [시작] 단추를 클릭하여 이름을 기준으로 앱을 검색한 다음, 시작합니다.

다음 단계: 앱 패키지 디버그 및 테스트

Visual Studio 또는 Windows 디버깅 도구를 사용하여 애플리케이션을 디버그하는 방법은 앱 패키지 실행, 디버그 및 테스트를 참조하세요.

스토어 제출용 앱 패키지 업로드 파일 생성

앱을 Microsoft Store에 배포하려면 앱 패키지 업로드 파일(.msixupload 또는 .appxupload)을 생성하고 이 파일을 파트너 센터에 제출하는 것이 좋습니다. 앱 패키지 또는 앱 번들을 파트너 센터에만 제출할 수 있지만, 앱 패키지 업로드 파일을 대신 제출하는 것이 좋습니다.

Visual Studio에서 앱 패키지 만들기 마법사를 사용하여 앱 패키지 업로드 파일을 만들거나, 기존 앱 패키지 또는 앱 번들에서 수동으로 만들 수 있습니다.

참고 항목

앱 패키지(.msix 또는 .appx) 또는 앱 번들(.msixbundle 또는 .appxbundle)을 수동으로 만들려면 MakeAppx.exe 도구를 사용하여 앱 패키지 만들기를 참조하세요.

Visual Studio를 사용하여 앱 패키지 업로드 파일 만들기

참고 항목

다음 지침과 스크린샷에서는 Visual Studio 2019 버전 16.3의 프로세스를 설명합니다. 이전 버전을 사용하는 경우 일부 UI가 다르게 보일 수 있습니다.

1. 솔루션 탐색기 UWP 앱 프로젝트에 대한 솔루션을 엽니다.

2. 프로젝트를 마우스 오른쪽 단추로 클릭하고 앱 패키지 게시->만들기를 선택합니다(Visual Studio 2019 버전 16.3 이전의 게시 메뉴 이름은 Store). 이 옵션을 사용하지 않도록 설정되었거나 전혀 표시하지 않는 경우 프로젝트가 유니버설 Windows 프로젝트인지 확인합니다.

   

   앱 패키지 만들기 마법사가 나타납니다.

3. 첫 번째 대화 상자에서 새 앱 이름을 사용하는 Microsoft Store를 선택하고, 다음을 클릭합니다.

   

   프로젝트가 이미 스토어의 앱에 연결된 경우 연결된 스토어 앱에 대한 패키지를 만들 수 있는 옵션도 있습니다. 사이드로드 중을 선택하는 경우 Visual Studio에서 파트너 센터 제출용 앱 패키지 업로드 파일(.msixupload 또는 .appxupload)을 생성하지 않습니다. 스토어 이외의 배포용 MSIX 패키지 또는 번들만 만들려는 경우 이 옵션을 선택할 수 있습니다.

4. 다음 페이지에서 개발자 계정을 사용하여 파트너 센터에 로그인합니다. 개발자 계정이 아직 없는 경우 마법사에서 이 계정을 만들 수 있습니다.

   

5. 현재 계정에 등록된 앱의 목록에서 패키지에 대한 앱 이름을 선택하거나, 파트너 센터에서 아직 예약하지 않은 경우 새 앱 이름을 예약합니다.

6. 앱을 가장 광범위한 디바이스에 배포할 수 있도록 패키지 선택 및 구성 대화 상자에서 세 가지 아키텍처 구성(x86, x64, ARM)을 모두 선택했는지 확인합니다. 앱 번들 목록 생성 상자에서 항상을 선택합니다. 앱 번들(.appxbundle 또는 .msixbundle)은 각 유형의 프로세서 아키텍처에 대해 구성된 앱 패키지 컬렉션을 포함하므로 단일 앱 패키지 파일보다 우선적으로 사용할 수 있습니다. 앱 번들을 생성하도록 선택하는 경우 앱 번들은 디버깅 및 충돌 분석 정보와 함께 최종 앱 패키지 업로드 파일(.appxupload 또는 .msixupload)에 포함됩니다. 선택할 아키텍처를 잘 모르거나 다양한 디바이스에서 사용하는 아키텍처에 대해 자세히 알아보려면 앱 패키지 아키텍처를 참조하세요.

   

7. 앱이 게시되면 파트너 센터에서 앱 성능을 분석할 수 있는 퍼블릭 기호 파일을 포함시킵니다. 추가 세부 정보(예: 버전 번호 매기기 또는 패키지 출력 위치)를 구성합니다.

8. 만들기를 클릭하여 앱 패키지를 생성합니다. 3단계에서 Microsoft Store에 업로드할 패키지를 만들고 싶습니다. 옵션 중 하나를 선택하고, 파트너 센터 제출용 패키지를 만드는 경우 마법사가 패키지 업로드 파일(.appxupload 또는 .msixupload)을 만듭니다. 3단계에서 사이드로드할 패키지를 만들고 싶습니다.를 선택한 경우 마법사에서 6단계의 선택 항목에 따라 단일 앱 패키지 또는 앱 번들을 만듭니다.

9. 앱이 성공적으로 패키지되면 다음 대화 상자가 표시되며 지정된 출력 위치에서 앱 패키지 업로드 파일을 검색할 수 있습니다. 이제 로컬 머신 또는 원격 머신에서 앱 패키지의 유효성을 검사하고 스토어 제출을 자동화할 수 있습니다.

   

수동으로 앱 패키지 업로드 파일 만들기

1. 다음 파일을 폴더에 배치합니다.

   • 하나 이상의 앱 패키지(.msix 또는 .appx) 또는 하나의 앱 번들(.msixbundle 또는 .appxbundle)
   • .appxsym 파일. 이 파일은 파트너 센터의 충돌 분석에 사용되는 앱의 퍼블릭 기호가 포함된 .pdb 압축 파일입니다. 이 파일은 생략할 수 있지만, 이 경우 충돌 분석 또는 디버깅 정보를 앱에 사용할 수 없습니다.

2. 폴더 내의 모든 파일을 선택하고 파일을 마우스 오른쪽 단추로 클릭한 다음 압축>된 폴더로 보내기(압축)를 선택합니다.

3. 새 zip 파일의 확장명을 .zip에서 .msixupload 또는 .appxupload로 변경합니다.

앱 패키지 유효성 검사

인증을 위해 파트너 센터에 제출하려면 먼저 로컬 또는 원격 머신에서 앱의 유효성을 검사합니다. 디버그 빌드가 아니라 앱 패키지의 릴리스 빌드에 대해서만 유효성을 검사할 수 있습니다. 앱을 파트너 센터에 제출하는 방법에 대한 자세한 내용은 앱 제출을 참조하세요.

로컬로 앱 패키지 유효성 검사

1. 앱 패키지 만들기 마법사의 마지막 패키지 만들기 완료 페이지에서 로컬 머신 옵션을 선택한 상태로 두고, Windows 앱 인증 키트 시작을 클릭합니다. Windows 앱 인증 키트를 사용하여 앱을 테스트하는 방법에 대한 자세한 내용은 Windows 앱 인증 키트를 참조하세요.

   WACK(Windows 앱 인증 키트)는 다양한 테스트를 수행하고 결과를 반환합니다. 자세한 내용은 Windows 앱 인증 키트 테스트를 참조하세요.

   테스트하는 데 사용하려는 원격 Windows 10 디바이스가 있는 경우 Windows 앱 인증 키트를 해당 디바이스에 수동으로 설치해야 합니다. 다음 섹션에서는 이러한 단계를 안내합니다. 이 작업을 수행한 후 원격 머신을 선택하고 Windows 앱 인증 키트 시작을 클릭하여 원격 디바이스에 연결하고 유효성 검사 테스트를 실행할 수 있습니다.

2. WACK가 완료되고 앱에서 인증을 통과하면 해당 앱을 파트너 센터에 제출할 수 있습니다. 올바른 파일을 업로드해야 합니다. 파일의 기본 위치는 솔루션의 루트 폴더(\[AppName]\AppPackages)에서 찾을 수 있으며, 파일의 이름은 .appxupload 또는 .msixupload 파일 확장명으로 끝납니다. 모든 패키지 아키텍처가 선택된 앱 번들을 선택하는 경우 이름의 형식은 [AppName]_[AppVersion]_x86_x64_arm_bundle.appxupload 또는 [AppName]_[AppVersion]_x86_x64_arm_bundle.msixupload입니다.

원격 Windows 10 디바이스에서 앱 패키지 유효성 검사

1. 디바이스를 개발에 사용하도록 설정 지침에 따라 Windows 10 디바이스를 개발에 사용하도록 설정합니다.

   Important

   Windows 10용 원격 ARM 디바이스에서는 앱 패키지의 유효성을 검사할 수 없습니다.

2. Visual Studio용 원격 도구를 다운로드하여 설치합니다. 이러한 도구는 Windows 앱 인증 키트를 원격으로 실행하는 데 사용됩니다. 원격 컴퓨터에서 MSIX 애플리케이션 실행을 방문하여 다운로드할 위치를 포함하여 이러한 도구에 대한 자세한 정보를 얻을 수 있습니다.

3. 필요한 Windows 앱 인증 키트를 다운로드하여 원격 Windows 10 디바이스에 설치합니다.

4. 마법사의 패키지 만들기 완료 페이지에서 원격 컴퓨터 옵션 단추를 선택한 다음 테스트 커넥트ion 단추 옆에 있는 줄임표 단추를 선택합니다.

   참고 항목

   원격 머신 옵션 단추는 유효성 검사를 지원하는 솔루션 구성을 하나 이상 선택한 경우에만 사용할 수 있습니다. WACK를 사용하여 앱을 테스트하는 방법에 대한 자세한 내용은 Windows 앱 인증 키트를 참조하세요.

5. 서브넷 내에 디바이스 양식을 지정하거나 서브넷 외부에 있는 디바이스의 DNS(Do기본 이름 서버) 이름 또는 IP 주소를 제공합니다.

6. 인증 모드 목록에서 디바이스에서 Windows 자격 증명을 사용하여 로그온할 필요가 없는 경우 없음을 선택합니다.

7. 선택 단추를 선택한 다음 Windows 앱 인증 키트 시작 단추를 선택합니다. 원격 도구가 해당 디바이스에서 실행되는 경우 Visual Studio에서 디바이스에 연결한 다음, 유효성 검사 테스트를 수행합니다. Windows 앱 인증 키트 테스트를 참조 하세요.

스토어 제출 자동화

Visual Studio 2019부터 앱 패키지 만들기 마법사의 끝 단계에서 Windows 앱 인증 키트 유효성 검사 후 자동으로 Microsoft Store에 제출합니다. 옵션을 선택하여 생성된 .appxupload 파일을 IDE에서 Microsoft Store로 직접 제출할 수 있습니다. 이 기능은 Azure Active Directory를 활용하여 앱을 게시하는 데 필요한 파트너 센터 계정 정보에 액세스합니다. 이 기능을 사용하려면 Azure Active Directory를 파트너 센터 계정에 연결하고 제출에 필요한 몇 가지 자격 증명을 검색해야 합니다.

파트너 센터 계정에 Azure Active Directory 연결

자동 스토어 제출에 필요한 자격 증명을 검색하려면 먼저 파트너 센터 대시보드에서 다음 단계를 수행해야 합니다(아직 수행하지 않은 경우).

1. 파트너 센터 계정을 조직의 Azure Active Directory에 연결합니다. 조직에서 이미 Office 365 또는 Microsoft의 다른 비즈니스 서비스를 사용하는 경우 Azure AD가 이미 있는 것입니다. 그렇지 않으면 추가 요금 없이 파트너 센터 내에서 새 Azure AD 테넌트를 만들 수 있습니다.

2. Azure AD 애플리케이션을 파트너 센터 계정에 추가합니다. 이 Azure AD 애플리케이션은 개발자 센터 계정에 대한 제출에 액세스하는 데 사용할 앱 또는 서비스를 나타냅니다. 이 애플리케이션은 관리자 역할에 할당해야 합니다. 이 애플리케이션이 Azure AD 디렉터리에 이미 있는 경우 Azure AD 애플리케이션 추가 페이지에서 선택하여 개발자 센터 계정에 추가할 수 있습니다. 그렇지 않으면 Azure AD 애플리케이션 추가 페이지에서 새 Azure AD 애플리케이션을 만들 수 있습니다 .

제출에 필요한 자격 증명 검색

다음으로, 제출에 필요한 파트너 센터 자격 증명(Azure 테넌트 ID, 클라이언트 ID 및 클라이언트 키)을 검색할 수 있습니다.

1. 파트너 센터 대시보드로 이동하여 Azure AD 자격 증명으로 로그인합니다.

2. 파트너 센터 대시보드에서 기어 아이콘(대시보드의 오른쪽 위 모서리 근처에 있음)을 선택한 다음, 개발자 설정을 선택합니다.

3. 왼쪽 창의 설정 메뉴에서 사용자를 클릭합니다.

4. Azure AD 애플리케이션의 이름을 클릭하여 해당 애플리케이션의 설정으로 이동합니다. 이 페이지에서 테넌트 ID 및 클라이언트 ID 값을 복사합니다.

5. 키 섹션에서 새 키 추가를 클릭합니다. 다음 화면에서 클라이언트 암호에 해당하는 키 값을 복사합니다. 이 페이지에서 나가면 이 정보에 다시 액세스할 수 없으므로 이 정보를 잃지 않도록 합니다. 자세한 내용은 Azure AD 애플리케이션에 대한 키 관리를 참조하세요.

Visual Studio에서 자동 스토어 제출 구성

이전 단계가 완료되면 Visual Studio 2019에서 자동 스토어 제출을 구성할 수 있습니다.

1. 앱 패키지 만들기 마법사의 끝 단계에서 Windows 앱 인증 키트 유효성 검사 후 자동으로 Microsoft Store에 제출합니다.를 선택하고, 다시 구성을 클릭합니다.

2. Microsoft Store 제출 설정 구성 대화 상자에서 Azure 테넌트 ID, 클라이언트 ID 및 클라이언트 키를 입력합니다.

   

   Important

   자격 증명은 나중에 제출하는 데 사용할 수 있도록 프로필에 저장할 수 있습니다.

3. 확인을 클릭합니다.

WACK 테스트가 완료되면 제출이 시작됩니다. 확인 및 게시 창에서 제출 진행 상황을 추적할 수 있습니다.