Résoudre les problèmes d’installation avec le fichier Programme d’installation d’applicationTroubleshoot installation issues with the App Installer file

Si vous rencontrez des problèmes lors de l’installation d’une application à partir du fichier d’installation de l’application, cette rubrique fournit des conseils de dépannage qui peuvent vous aider.If you find any issues when installing an application from the App Installer file, this topic will provide some troubleshooting guidance that may help.

PrérequisPrerequisites

Pour pouvoir chargement des applications dans Windows 10, l’appareil de l’utilisateur doit remplir les conditions suivantes :To be able to sideload apps in Windows 10, the user device must satisfy the next requirements:

  • L’appareil doit être activé pour le mode développeur ou pour les applications chargement.The device must be enabled for Developer Mode or Sideloading apps. Pour en savoir plus, consultez activer votre appareil pour le développement .See Enable your device for development to learn more.
  • Le certificat utilisé pour signer le package doit être approuvé par l’appareil.The certificate used to sign the package must be trusted by the device. Pour plus d’informations, consultez la section certificats approuvés ci-dessous.See the Trusted certificates section below for more details.
  • La version Windows 10 doit prendre en charge le .appinstaller schéma de fichier et le protocole de distribution.The Windows 10 version must support the .appinstaller file schema and the distribution protocol.

Problèmes courantsCommon issues

Il existe des problèmes courants lors de la chargement d’une application pour la première fois sur l’ordinateur de l’utilisateur.There are some common issues when sideloading an application for first time in the user machine. Les sections suivantes décrivent les problèmes les plus fréquents et leurs solutions.The next few sections describe the most frequent issues and their solutions.

Version de WindowsWindows version

Chaque version de Windows 10 améliore l’expérience chargement, dans le tableau ci-dessous, vous trouverez les fonctionnalités disponibles dans chaque version majeure.Each Windows 10 release improves on the sideloading experience, in the table below you will find which features are available in each major release. Si vous essayez de chargement une application à l’aide d’une méthode non prise en charge dans votre version de Windows 10, vous obtiendrez une erreur de déploiement.If you try to sideload an app using a method not supported in your version of Windows 10, you will get a deployment error.

VersionVersion Chargement notesSideload Notes
Build 17134 (mise à jour d’avril 2018, version 1803)Build 17134 (April 2018 Update, version 1803) Le .appinstaller fichier est accessible par le biais de dossiers UNC/partage.The .appinstaller file can be accessed over UNC/Share folders. Des vérifications de mise à jour configurables sont également disponibles.Configurable update checks are also available.
Build 16299 (Mise à jour Créateurs en automne, version 1709)Build 16299 (Fall Creators Update, version 1709) A introduit le .appinstaller fichier pour fournir des mises à jour automatiques à votre application.Introduced the .appinstaller file to provide automatic updates to your app. Cette version ne prend en charge que les points de terminaison HTTP.This version only supports HTTP endpoints. Les vérifications de mise à jour ne sont pas configurables et se produit toutes les 24 heures.Update checks are not configurable and happens each 24 hours.
Build 15063 (Mise à jour Créateurs, version 1703)Build 15063 (Creators Update, version 1703) L’application du programme d’installation de l’application est en mesure de télécharger les dépendances des applications (uniquement en mode release) à partir du Store.The App Installer app is able to download app dependencies (only in release mode) from the Store.
Build 14393 (mise à jour anniversaire, version 1607)Build 14393 (Anniversary Update, version 1607) A introduit l’application d’installation d’application pour installer des fichiers. AppX et. appxbundle, le fichier. appinstaller n’est pas pris en charge.Introduced the App Installer app to install .appx and .appxbundle files, .appinstaller file is not supported.
Build 10586 (mise à jour de novembre, version 1511)Build 10586 (November Update, version 1511) Chargement est disponible uniquement par le biais de PowerShell à l’aide de la commande Add-AppxPackage .Sideload is only available through PowerShell using the Add-AppxPackage command.
Build 10240 (Windows 10, version 1507)Build 10240 (Windows 10, version 1507) Chargement est disponible uniquement par le biais de PowerShell à l’aide de la commande Add-AppxPackage .Sideload is only available through PowerShell using the Add-AppxPackage command.

Certificats approuvésTrusted certificates

Les packages d’application doivent être signés avec un certificat approuvé par l’appareil.App packages must be signed with a certificate that is trusted by the device. Les certificats fournis par les autorités de certification courantes sont approuvés par défaut dans le système d’exploitation Windows.Certificates provided by common Certificate Authorities are trusted by default in the Windows operating system.

Toutefois, si le certificat utilisé pour signer un package d’application n’est pas approuvé ou s’il s’agit d’un certificat généré localement/auto-signé utilisé pendant le développement, le programme d’installation de l’application peut signaler que le package n’est pas approuvé et l’empêchera d’être installé :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 signé avec un certificat manquant ou non approuvé

Pour résoudre ce problème, un utilisateur disposant de droits d’administrateur local sur l’appareil doit utiliser l’outil certificats de l' ordinateur pour importer le certificat dans l’un des conteneurs suivants :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. Ordinateur local : personnes autoriséesLocal Computer: Trusted People
  2. Ordinateur local : autorités racines de confiance (non recommandé)Local Computer: Trusted Root Authorities (not recommended)

Important

N’importez pas de certificats de signature de package dans le magasin de certificats utilisateur.Do not import package signing certificates into the User Certificate store. Le programme d’installation d’application ne recherche pas les certificats d’utilisateur lors de la vérification de l’identité du package.The App Installer does not search User Certificates when verifying package identity.

L’outil de gestion des certificats de l’ordinateur peut être trouvé facilement en effectuant une recherche dans le menu Démarrer :The Computer Certificates management tool can be easily found by searching from the Start Menu:

Rechercher l’outil certificats de l’ordinateur local via le menu Démarrer

Une fois le certificat de signature importé, si vous réexécutez le programme d’installation de l’application, vous verrez que le package est approuvé et peut être installé :Once the signing certificate is successfully imported, re-running the app installer will show that the package is trusted and can be installed:

MSIX signé avec un certificat approuvé

Dépendances non installéesDependencies not installed

Les applications Windows 10 peuvent avoir des dépendances de Framework basées sur la plateforme d’application utilisée pour générer l’application.Windows 10 applications can have framework dependencies based on the application platform used to generate the app. Si vous utilisez C# ou VB, l’application nécessitera le Runtime .NET et les packages .NET Framework.If you are using C# or VB, the app will require the .NET Runtime and .NET framework packages. Les applications C++ requièrent VCLibs.C++ applications require the VCLibs.

Important

Si le package d’application est généré en mode release, les dépendances du Framework sont obtenues à partir du Microsoft Store.If the app package is built in Release mode configuration, the framework dependencies will be obtained from the Microsoft Store. Toutefois, si l’application est générée en mode débogage, les dépendances sont obtenues à partir de l’emplacement spécifié dans le .appinstaller fichier.However, if the app is built in Debug mode configuration, the dependencies will be obtained from the location specified in the .appinstaller file.

Fichiers non accessiblesFiles not accessible

Lors de l’installation à partir d’un point de terminaison HTTP, il est important de vérifier que tous les fichiers sont accessibles avec le type MIME approprié.When installing from an HTTP endpoint, it is important to verify that all files are accessible with the correct MIME type. La méthode la plus simple pour vérifier ces fichiers consiste à suivre les liens fournis dans la page HTML générée par Visual Studio.The easiest method to verify these files is by following the links provided in the HTML page generated by Visual Studio. Vous devez vérifier ces fichiers :You must check these files:

  • .appinstaller fichier, disponible en tant que application/xml.appinstaller file, available as an application/xml
  • .appx``.appxbundlefichiers et, disponibles en tant queapplication/vns.ms-appx.appx and .appxbundle files, available as application/vns.ms-appx

Isoler les problèmes liés aux applications d’installation d’applicationIsolate App Installer app issues

Si le programme d’installation de l’application ne peut pas installer l’application, ces étapes vous aideront à identifier le problème d’installation.If the App Installer cannot install the app, these steps will help identify the installation issue.

Vérifier l’installation du fichier de package d’applicationVerify app package file installation

  • Téléchargez le fichier de package d’application dans un dossier local et essayez de l’installer à l’aide de la commande PowerShell Add-AppxPackage .Download the app package file to a local folder and try to install it using the Add-AppxPackage PowerShell command.

  • Téléchargez le .appinstaller fichier dans un dossier local et essayez de l’installer à l’aide de la Add-AppxPackage -Appinstaller commande PowerShell.Download the .appinstaller file to a local folder and try to install it using the Add-AppxPackage -Appinstaller PowerShell command.

Journaux des événements du programme d’installation d’applicationApp Installer event logs

L’infrastructure de déploiement d’applications émet des journaux qui sont souvent utiles pour déboguer les problèmes d’installation par le biais de Windows observateur d’événements : 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