포함된 앱 설치 관리자 파일을 사용하여 앱 업데이트

중요

포함된 앱 설치 관리자 파일의 사용은 Windows 버전 10.0.21300.0에서 사용할 수 있습니다. 이 기능을 사용하려면 MaxVersionTested가 이 버전 또는 최신 버전의 Windows 운영 체제를 참조하는지 확인합니다.

앱 설치 관리자 파일은 Windows 앱이 업데이트 검색 및 복구를 트래버스할 수 있는 업데이트 경로를 제공합니다.

Visual Studio 사용하여 포함된 앱 설치 관리자 파일을 사용하여 Windows 앱을 빌드하고 게시하는 경우 Windows 10 SDK 2104(이상)가 설치되어 있고 프로젝트 속성이 대상 버전(MaxVersionTested 및 MinVersion)으로 Windows 10 21H1 이상인지 확인해야 합니다. 구성되지 않은 경우 Windows 앱은 Windows 앱이 설치될 때 포함된 AppInstaller 구성을 디바이스로 설정하지 않습니다.

방법 - MSIX 패키징 도구

다음 단계에서는 MSIX 패키징 도구를 사용하여 포함된 앱 설치 관리자 앱을 포함하도록 기존 Windows 앱을 편집하는 방법을 안내합니다.

참고

다음 지침에서는 이전에 MSIX Toolkit 사용하거나 수동으로 앱 설치 관리자 파일 만들기를 자동화하기 위해 Visual Studio 사용하여 앱 설치 관리자 파일을 만들었다고 가정합니다. 앱 설치 관리자 파일을 만드는 지침은 다음 문서 중 하나를 방문하세요.

편집용 Windows 앱 열기

다음 단계에서는 Microsoft MSIX 패키징 도구 앱을 사용하여 Windows 앱 편집을 시작하는 방법을 안내합니다.

  1. Microsoft MSIX 패키징 도구를 시작합니다(Microsoft Store 사용 가능: MSIX 패키징 도구).
  2. 패키지 편집기 단추를 선택하여 기존 패키지를 편집합니다.
  3. 찾아보기 단추를 선택하고 프롬프트 창에서 Windows 앱을 찾아 열기 단추를 선택합니다.
  4. 패키지 열기 단추를 선택합니다.

Windows 앱으로 앱 설치 관리자 파일 가져오기

다음 단계에서는 Microsoft MSIX 패키징 도구 앱을 사용하여 기존 Windows 앱에 앱 설치 관리자 파일을 포함시키는 방법을 안내합니다. 이러한 단계에서는 Microsoft MSIX 패키징 도구 앱을 사용하여 편집하기 위해 Windows 앱을 이미 연 것으로 가정합니다.

  1. MSIX 패키징 도구의왼쪽에서 패키지 파일을선택합니다.
  2. 트리 뷰 내에서 패키지 항목을 확장합니다.
  3. 패키지를 마우스 오른쪽 단추로 클릭하고 드롭다운 메뉴에서 파일 추가를 선택합니다.
  4. 프롬프트 창 내에서 찾아보기 단추를 선택하고, 앱 설치 관리자 파일로 이동하여 선택하고, 열기 단추를 선택합니다.
  5. 저장 단추를 선택합니다.

AppxManifest 업데이트

다음 단계에서는 이전에 Windows 앱에 추가된 앱 설치 관리자 파일을 가리키도록 AppxManifest를 업데이트하는 방법을 안내합니다.

  1. MSIX 패키징 도구의왼쪽에서 패키지 정보를 선택합니다.
  2. 패키지 정보 섹션의 아래쪽으로 스크롤합니다.
  3. 파일 열기 단추를 선택하여 메모장 창에서 AppxManifest를 엽니다.
  4. <Package>속성에 다음 네임스페이스 및 무시 가능한 네임스페이스가 포함되어 있는지 확인합니다.
    <Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
        xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
        xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
        xmlns:uap13="http://schemas.microsoft.com/appx/manifest/uap/windows10/13" 
        xmlns:build="http://schemas.microsoft.com/developer/appx/2015/build"
        IgnorableNamespaces="uap mp uap13 build">
    
  5. 내부에는 <Properties> 다음과 같은 <uap13:AutoUpdate> 및 자식 매개 변수가 포함됩니다.
    <Properties>
        ...
        <uap13:AutoUpdate>
            <uap13:AppInstaller File="Update.appinstaller" />
        </uap13:AutoUpdate>
    </Properties>
    
  6. AppxManifest에 대한 변경 내용을 저장합니다.
  7. AppxManifest 메모장 창을 닫고 MSIX 패키징 도구로 돌아갑니다.

참고

위의 지침에서는 앱 설치 관리자 파일 이름이 "Update.appinstaller"라고 가정합니다.

Windows 앱 닫기 및 패키지

다음 단계에서는 Windows 앱을 최신 버전으로 패키징하는 단계를 안내합니다. 이러한 단계에서는 조직 또는 클라이언트 요구 사항을 충족하도록 서명 기본 설정을 구성한 것으로 가정합니다.

  1. MSIX 패키징 도구에서저장 단추를 선택합니다.
  2. 메시지가 표시되는 창에서 예, 증분 단추를 선택합니다.
  3. 새로 업데이트된 Windows 앱을 저장할 위치로 이동하고 저장 단추를 선택합니다.
  4. 닫기 단추를 선택하세요.
  5. MSIX 패키징 도구 창을 닫습니다.

방법 - Visual Studio

시작하기 전에 Windows 10 SDK 2104가 설치된 Windows 10 디바이스에서 작업하고 있는지 확인합니다. 이 SDK는 대상 버전 및 최소 버전 속성이 앱을 빌드할 때 적절한 값으로 설정되도록 하는 데 필요합니다.

앱 설치 관리자 파일 포함

다음 단계에서는 앱 설치 관리자 파일을 UWP(Windows 앱) Visual Studio 프로젝트에 포함시키는 단계를 안내합니다.

  1. Visual Studio 프로젝트에서솔루션 탐색기 Windows 앱 이름을 마우스 오른쪽 단추로 클릭합니다.
  2. 드롭다운 메뉴에서기존 항목 추가를 선택합니다.
  3. 앱 설치 관리자 파일로 이동하여 선택하고 추가 단추를 선택합니다.
  4. 솔루션 탐색기 Update.appinstaller를 두 번 클릭하여 검토할 파일을 엽니다.
  5. 앱 설치 관리자 파일이 올바른지 확인하고 파일을 닫습니다.

AppxManifest 업데이트

다음 단계에서는 새로 포함된 앱 설치 관리자 파일을 대상으로 Visual Studio 프로젝트에서 AppxManifest를 업데이트하는 방법에 대한 지침을 제공합니다.

이 가이드에서는 다음을 가정합니다.

  • Windows 10 SDK 2104 이상 설치
  • 프로젝트 속성은 대상 Windows 10 버전 2104 이상으로 설정됩니다.
  • 앱 설치 관리자 파일의 이름은 Update.appinstaller입니다.
  1. Visual Studio 프로젝트의위쪽 메뉴에서 빌드를 선택합니다.
  2. 드롭다운 메뉴에서 솔루션 빌드를 선택합니다. Windows 앱 빌드가 성공했는지 확인합니다.
  3. 리본에서 로컬 머신을 선택하여 Windows 앱의 기능을 테스트합니다.
  4. Windows 앱을 실행한 직후 닫고 디버깅을 중지합니다.
  5. 솔루션 탐색기 Package.appxmanifest를 마우스 오른쪽 단추로 클릭합니다.
  6. 드롭다운 메뉴에서 코드 보기를 선택합니다.
  7. <Package>속성에 다음 네임스페이스 및 무시 가능한 네임스페이스가 포함되어 있는지 확인합니다.
    <Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
        xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
        xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
        xmlns:uap13="http://schemas.microsoft.com/appx/manifest/uap/windows10/13" 
        xmlns:build="http://schemas.microsoft.com/developer/appx/2015/build"
        IgnorableNamespaces="uap mp uap13 build">
    
  8. 내부에는 <Properties> 다음과 같은 <uap13:AutoUpdate> 및 자식 매개 변수가 포함됩니다.
    <Properties>
        ...
        <uap13:AutoUpdate>
            <uap13:AppInstaller File="Update.appinstaller" />
        </uap13:AutoUpdate>
    </Properties>
    
  9. 변경 내용을 파일에 저장하고 닫습니다.

Windows 앱 빌드

다음 단계에서는 지원되는 운영 체제에 설치하기 위한 Windows 앱 패키지를 만드는 단계를 안내합니다.

  1. Visual Studio 프로젝트에서Windows 앱 이름을 마우스 오른쪽 단추로 클릭합니다.
  2. 드롭다운 메뉴에서앱 패키지 만들기 게시...를 선택합니다.
  3. 앱 패키지 만들기 대화 상자 창에서 사이드로드 라디오 단추를 선택합니다.
  4. 다음 단추를 선택합니다.
  5. 예, 현재 인증서 사용: 라디오 단추를 선택합니다.
  6. 기존 인증서를 가져오거나 인증서를 자동으로 생성하여 Windows 앱에 서명합니다.
  7. 다음 단추를 선택합니다.
  8. Windows 앱에 대한 Windows 앱 번들의 솔루션 구성, 버전 및 선택적 빌드를 지정합니다.
  9. 만들기 단추를 선택합니다.