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.
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.
- The Windows 10 version must support the
.appinstallerfile schema and the distribution protocol.
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.
Each Windows 10 release improves on the sideloading experience, in the table below you will find which features are available in each major release. If you try to sideload an app using a method not supported in your version of Windows 10, you will get a deployment error.
|Build 17134 (April 2018 Update, version 1803)||The
|Build 16299 (Fall Creators Update, version 1709)||Introduced the
|Build 15063 (Creators Update, version 1703)||The App Installer app is able to download app dependencies (only in release mode) from the Store.|
|Build 14393 (Anniversary Update, version 1607)||Introduced the App Installer app to install .appx and .appxbundle files, .appinstaller file is not supported.|
|Build 10586 (November Update, version 1511)||Sideload is only available through PowerShell using the Add-AppxPackage command.|
|Build 10240 (Windows 10, version 1507)||Sideload is only available through PowerShell using the Add-AppxPackage command.|
The app package must be signed with a certificate that is trusted by the device. Certificates provided by common Certificate Authorities are trusted by default in the Windows operating system, however if the certificate is not trusted, it must be installed in the device before installing the app. To trust the certificate, the certificate must be present in one of the following local machine certificate stores on your device:
- Trusted Publishers
- Trusted People
- Trusted Root Authorities (not recommended)
Installing a certificate in the Local Machine store requires administrative access.
Dependencies not installed
Windows 10 applications can have framework dependencies based on the application platform used to generate the app. If you are using C# or VB, the app will require the .NET Runtime and .NET framework packages. C++ applications require the VCLibs.
If the app package is built in Release mode configuration, the framework dependencies will be obtained from the Microsoft Store. However, if the app is built in Debug mode configuration, the dependencies will be obtained from the location specified in the
Files not accessible
When installing from an HTTP endpoint, it is important to verify that all files are accessible with the correct MIME type. 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:
.appinstallerfile, available as an
.appxbundlefiles, available as
Isolate App Installer app issues
If the App Installer app cannot install the app, these steps will help identify the installation issue.
Verify app package file installation
Download the app package file to a local folder and try to install it using the Add-AppxPackage PowerShell command.
.appinstallerfile to a local folder and try to install it using the
Add-AppxPackage -AppinstallerPowerShell command.
The app deployment infrastructure provides logs for debugging in the Windows Event Viewer. These logs are found here:
Application and Services Logs->Microsoft->Windows->AppxDeployment-Server