앱 설치 관리자 파일과 관련된 설치 문제 해결Troubleshoot installation issues with the App Installer file

앱 설치 관리자 파일에서 응용 프로그램을 설치할 때 문제가 발견 되 면이 항목에서 도움이 될 수 있는 몇 가지 문제 해결 지침을 제공 합니다.If you find any issues when installing an application from the App Installer file, this topic will provide some troubleshooting guidance that may help.

필수 조건Prerequisites

Windows 10에서 앱을 테스트용으로 로드 수 있으려면 사용자 장치가 다음 요구 사항을 충족 해야 합니다.To be able to sideload apps in Windows 10, the user device must satisfy the next requirements:

  • 개발자 모드 또는 테스트용 로드 앱에 대해 장치를 사용 하도록 설정 해야 합니다.The device must be enabled for Developer Mode or Sideloading apps. 자세한 내용은 장치를 개발에 사용 하도록 설정 을 참조 하세요.See Enable your device for development to learn more.
  • 패키지에 서명 하는 데 사용 되는 인증서는 장치에서 신뢰할 수 있어야 합니다.The certificate used to sign the package must be trusted by the device. 자세한 내용은 아래의 신뢰할 수 있는 인증서 섹션을 참조 하세요.See the Trusted certificates section below for more details.
  • Windows 10 버전은 .appinstaller 파일 스키마 및 배포 프로토콜을 지원 해야 합니다.The Windows 10 version must support the .appinstaller file schema and the distribution protocol.

일반적인 문제Common issues

사용자 컴퓨터에서 응용 프로그램을 처음 로드 하는 경우 몇 가지 일반적인 문제가 있습니다.There are some common issues when sideloading an application for first time in the user machine. 다음 섹션에서는 가장 자주 발생 하는 문제와 해결 방법에 대해 설명 합니다.The next few sections describe the most frequent issues and their solutions.

Windows 버전Windows version

각 Windows 10 릴리스는 테스트용 로드 환경을 개선 하 고, 아래 표에는 각 주요 릴리스에서 사용할 수 있는 기능을 확인할 수 있습니다.Each Windows 10 release improves on the sideloading experience, in the table below you will find which features are available in each major release. Windows 10 버전에서 지원 되지 않는 방법을 사용 하 여 앱을 테스트용으로 로드 하는 경우 배포 오류가 발생 합니다.If you try to sideload an app using a method not supported in your version of Windows 10, you will get a deployment error.

버전Version 테스트용으로 로드 참고 사항Sideload Notes
빌드 17134 (4 월 2018 업데이트, 버전 1803)Build 17134 (April 2018 Update, version 1803) .appinstaller파일은 UNC/공유 폴더를 통해 액세스할 수 있습니다.The .appinstaller file can be accessed over UNC/Share folders. 구성 가능한 업데이트 확인도 사용할 수 있습니다.Configurable update checks are also available.
빌드 16299(Fall Creators Update, 버전 1709)Build 16299 (Fall Creators Update, version 1709) 에는 .appinstaller 앱에 대 한 자동 업데이트를 제공 하는 파일이 도입 되었습니다.Introduced the .appinstaller file to provide automatic updates to your app. 이 버전은 HTTP 끝점만 지원 합니다.This version only supports HTTP endpoints. 업데이트 검사는 구성할 수 없으며 24 시간 마다 수행 됩니다.Update checks are not configurable and happens each 24 hours.
빌드 15063(크리에이터스 업데이트, 버전 1703)Build 15063 (Creators Update, version 1703) 앱 설치 관리자 앱은 스토어에서 앱 종속성 (릴리스 모드 에서만)을 다운로드할 수 있습니다.The App Installer app is able to download app dependencies (only in release mode) from the Store.
빌드 14393(1주년 업데이트, 버전 1607)Build 14393 (Anniversary Update, version 1607) 에는 응용 프로그램 설치 관리자 앱이 도입 되어 .appx 및 .appxbundle 파일 appinstaller 파일이 지원 되지 않습니다.Introduced the App Installer app to install .appx and .appxbundle files, .appinstaller file is not supported.
빌드 10586(11월 업데이트, 버전 1511)Build 10586 (November Update, version 1511) 테스트용으로 로드는 add-appxpackage 명령을 사용 하 여 PowerShell을 통해서만 사용할 수 있습니다.Sideload is only available through PowerShell using the Add-AppxPackage command.
빌드 10240(Windows 10, 버전 1507)Build 10240 (Windows 10, version 1507) 테스트용으로 로드는 add-appxpackage 명령을 사용 하 여 PowerShell을 통해서만 사용할 수 있습니다.Sideload is only available through PowerShell using the Add-AppxPackage command.

신뢰할 수 있는 인증서Trusted certificates

앱 패키지는 장치에서 신뢰 하는 인증서로 서명 해야 합니다.App packages must be signed with a certificate that is trusted by the device. 일반적인 인증 기관에서 제공 하는 인증서는 Windows 운영 체제에서 기본적으로 신뢰할 수 있습니다.Certificates provided by common Certificate Authorities are trusted by default in the Windows operating system.

그러나 앱 패키지에 서명 하는 데 사용 되는 인증서를 신뢰할 수 없거나 개발 중에 로컬로 생성 된 인증서 또는 자체 서명 된 인증서 인 경우 앱 설치 관리자는 패키지를 신뢰할 수 없어 설치 하지 못하도록 합니다.However, if the certificate used to sign an app package is not trusted, or is a locally-generated/self-signed certificate used during development, the app installer may report that the package is untrusted and will prevent it from being installed:

누락 되거나 신뢰할 수 없는 인증서로 서명 된 MSIX

이 문제를 해결 하려면 장치에 대 한 로컬 관리자 권한이 있는 사용자가 컴퓨터 인증서 도구를 사용 하 여 인증서를 다음 컨테이너 중 하나로 가져와야 합니다.To solve this issue, a user with local administrator rights to the device must use the Computer Certificates tool to import the certificate into one of the following containers:

  1. 로컬 컴퓨터: 신뢰할 수 있는 사용자Local Computer: Trusted People
  2. 로컬 컴퓨터: 신뢰할 수 있는 루트 인증 기관 (권장 하지 않음)Local Computer: Trusted Root Authorities (not recommended)

중요

패키지 서명 인증서를 사용자 인증서 저장소로 가져오지 않습니다.Do not import package signing certificates into the User Certificate store. 앱 설치 관리자는 패키지 id를 확인할 때 사용자 인증서를 검색 하지 않습니다.The App Installer does not search User Certificates when verifying package identity.

시작 메뉴에서 검색 하 여 컴퓨터 인증서 관리 도구를 쉽게 찾을 수 있습니다.The Computer Certificates management tool can be easily found by searching from the Start Menu:

시작 메뉴를 통해 로컬 컴퓨터 인증서 도구 찾기

서명 인증서를 성공적으로 가져오면 앱 설치 관리자를 다시 실행 하면 패키지를 신뢰할 수 있고 설치할 수 있음을 표시 합니다.Once the signing certificate is successfully imported, re-running the app installer will show that the package is trusted and can be installed:

신뢰할 수 있는 인증서로 서명 된 MSIX

종속성 설치 안 됨Dependencies not installed

Windows 10 응용 프로그램은 앱을 생성 하는 데 사용 되는 응용 프로그램 플랫폼을 기반으로 프레임 워크 종속성이 있을 수 있습니다.Windows 10 applications can have framework dependencies based on the application platform used to generate the app. C # 또는 VB를 사용 하는 경우 앱에 .NET 런타임과 .NET framework 패키지가 필요 합니다.If you are using C# or VB, the app will require the .NET Runtime and .NET framework packages. C + + 응용 프로그램에는 VCLibs가 필요 합니다.C++ applications require the VCLibs.

중요

앱 패키지가 릴리스 모드 구성에서 빌드된 경우 Microsoft Store에서 프레임 워크 종속성을 가져옵니다.If the app package is built in Release mode configuration, the framework dependencies will be obtained from the Microsoft Store. 그러나 앱이 디버그 모드 구성에서 빌드된 경우 파일에 지정 된 위치에서 종속성을 가져옵니다 .appinstaller .However, if the app is built in Debug mode configuration, the dependencies will be obtained from the location specified in the .appinstaller file.

파일에 액세스할 수 없음Files not accessible

HTTP 끝점에서 설치할 경우 올바른 MIME 형식으로 모든 파일에 액세스할 수 있는지 확인 하는 것이 중요 합니다.When installing from an HTTP endpoint, it is important to verify that all files are accessible with the correct MIME type. 이러한 파일을 확인 하는 가장 쉬운 방법은 Visual Studio에서 생성 된 HTML 페이지에 제공 된 링크를 따라 하는 것입니다.The easiest method to verify these files is by following the links provided in the HTML page generated by Visual Studio. 다음 파일을 확인 해야 합니다.You must check these files:

  • .appinstaller 파일 (로 사용 가능) application/xml.appinstaller file, available as an application/xml
  • .appx.appxbundle 파일은로 사용 가능 합니다. application/vns.ms-appx.appx and .appxbundle files, available as application/vns.ms-appx

앱 설치 관리자 앱 문제 격리Isolate App Installer app issues

앱 설치 관리자에서 앱을 설치할 수 없는 경우 다음 단계를 통해 설치 문제를 식별할 수 있습니다.If the App Installer cannot install the app, these steps will help identify the installation issue.

앱 패키지 파일 설치 확인Verify app package file installation

  • 앱 패키지 파일을 로컬 폴더에 다운로드 하 고 Add-appxpackage PowerShell 명령을 사용 하 여 설치 해 보세요.Download the app package file to a local folder and try to install it using the Add-AppxPackage PowerShell command.

  • .appinstaller로컬 폴더에 파일을 다운로드 하 고 PowerShell 명령을 사용 하 여 설치 합니다 Add-AppxPackage -Appinstaller .Download the .appinstaller file to a local folder and try to install it using the Add-AppxPackage -Appinstaller PowerShell command.

앱 설치 관리자 이벤트 로그App Installer event logs

앱 배포 인프라는 Windows 이벤트 뷰어를 통해 설치 문제를 디버깅 하는 데 유용한 로그를 내보냅니다. Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-ServerThe app deployment infrastructure emits logs that are often useful for debugging installation issues via the Windows Event Viewer: Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server