Partager via


Résoudre les problèmes d’installation avec le fichier Installateur d'application

Si vous rencontrez des problèmes lors de l’installation d’une application à partir du fichier Programme d’installation d’application, cette rubrique fournit des conseils de dépannage qui peuvent vous aider.

Conditions préalables

Pour pouvoir charger des applications dans Windows 10, l’appareil utilisateur doit satisfaire aux exigences suivantes :

Windows 10 :

  • Le certificat utilisé pour signer le package doit être approuvé par l’appareil. Pour plus d’informations, consultez la section Certificats approuvés ci-dessous.
  • La version de Windows 10 doit prendre en charge le .appinstaller schéma de fichier et le protocole de distribution.

Windows 10 1909 et versions antérieures :

Problèmes courants

Il existe des problèmes courants lors du chargement indépendant d’une application pour la première fois sur la machine de l’utilisateur. Les sections suivantes décrivent les problèmes les plus fréquents et leurs solutions.

Version de Windows

Chaque version de Windows 10 améliore l'expérience de sideloading. Dans le tableau ci-dessous, vous trouverez les fonctionnalités disponibles dans chaque version majeure. Si vous essayez de charger 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.

Version Remarques sur le chargement indépendant
Build 17134 (mise à jour d’avril 2018, version 1803) Le .appinstaller fichier est accessible sur les dossiers UNC/Share. Des vérifications de mise à jour configurables sont également disponibles.
Build 16299 (Fall Creators Update, version 1709) Introduit le .appinstaller fichier pour fournir des mises à jour automatiques à votre application. Cette version prend uniquement en charge les points de terminaison HTTP. Les vérifications de mise à jour ne sont pas configurables et se produisent toutes les 24 heures.
Build 15063 (Creators Update, version 1703) L'application d'installateur est en mesure de télécharger les dépendances d'application (uniquement en mode version finale) depuis le Windows Store.
Build 14393 (Mise à jour anniversaire, version 1607) Introduction de l'application App Installer pour installer des fichiers .appx et .appxbundle, les fichiers .appinstaller ne sont pas pris en charge.
Build 10586 (mise à jour de novembre, version 1511) Le chargement parallèle est disponible seulement par PowerShell à l’aide de la commande Add-AppxPackage.
Build 10240 (Windows 10, version 1507) Le chargement parallèle est disponible seulement par PowerShell à l’aide de la commande Add-AppxPackage.

Certificats approuvés

Les packages d’application doivent être signés avec un certificat approuvé par l’appareil. Les certificats fournis par les autorités de certification courantes sont approuvés par défaut dans le système d’exploitation Windows.

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é :

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 d’ordinateur pour importer le certificat dans l’un des conteneurs suivants :

  1. Ordinateur local : Personnes approuvées
  2. Ordinateur local : autorités racines de confiance (non recommandé)

Important

N’importez pas de certificats de signature de package dans le magasin de certificats utilisateur. Le programme d’installation de l’application ne recherche pas les certificats utilisateur lors de la vérification de l’identité du package.

L’outil de gestion des certificats d’ordinateur est facilement disponible en effectuant une recherche dans le menu Démarrer :

Rechercher l’outil Certificats d’ordinateur local via le menu Démarrer

Une fois que le certificat de signature est correctement importé, la réexécutation du programme d’installation de l’application indique que le package est approuvé et peut être installé :

MSIX signé avec un certificat approuvé

Dépendances non installées

Les applications Windows 10 peuvent avoir des dépendances d’infrastructure basées sur la plateforme d’application utilisée pour générer l’application. Si vous utilisez C# ou VB, l’application nécessite les packages .NET Runtime et .NET Framework. Les applications C++ nécessitent les VCLibs.

Important

Si le package d’application est intégré à la configuration en mode Mise en production, les dépendances du framework sont obtenues à partir du Microsoft Store. Toutefois, si l’application est intégrée en mode Débogage, les dépendances sont obtenues à partir de l’emplacement spécifié dans le .appinstaller fichier.

Fichiers non accessibles

Lors de l’installation à partir d’un point de terminaison HTTP, il est important de vérifier que tous les fichiers requis sont accessibles. La méthode la plus simple pour vérifier cela consiste à suivre les liens fournis dans la page HTML générée par Visual Studio. Vous devez vérifier ces fichiers :

  • un .appinstaller fichier, trouvé Additional Links > App Installer File sur la page générée par Visual Studio
  • un fichier .appx, .appxbundle, .misx ou msixbundle, trouvé à Additional Links > Package Bundle sur la page générée par Visual Studio

Remarque

Selon votre configuration, il peut y avoir plus d'un fichier .appx, .appxbundle, .misx ou msixbundle impliqué dans votre déploiement. Assurez-vous que tous sont accessibles.

Fichiers servis avec un type MIME incorrect

Lors de l’installation à partir d’un point de terminaison HTTP, tous les fichiers doivent être servis avec leur type MIME correct dans l’en-tête par le Content-Type serveur web.

Fichiers servis sans en-tête Content-Length

Lors de l’installation à partir d’un point de terminaison HTTP, toutes les réponses doivent inclure un en-tête correct Content-Length . Ceci inclut GET ainsi que les requêtes HEAD. Assurez-vous que tous spécifient correctement leur Content-Length. L’échec de cette opération peut entraîner des erreurs comme App installation failed with error message: Appinstaller operation failed with error code 0x80072F76. Detail: Unknown error (0x80072f76) ou d’autres.

Échec de l’installation de l’application avec message d’erreur : le paramètre est incorrect

Étant donné que les URL de vanity ne sont pas prises en charge pour l’instant, lors de l’utilisation du ms-appinstaller protocole, le paramètre source DOIT se terminer par .appinstaller. Cela n’a pas d’importance si vous redirigez vers un fichier se terminant par .appinstaller. Cela échouera également de la même façon. La seule façon de résoudre ce problème est de s’assurer que l’URL d’origine se termine par .appinstaller.

Isoler les problèmes liés à l’application Programme d’installation d’application

Si le programme d’installation de l’application ne peut pas installer l’application, ces étapes vous aideront à identifier le problème d’installation.

Vérifier l’installation du fichier de package d’application

  • 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 .

  • Téléchargez le .appinstaller fichier dans un dossier local et essayez de l’installer à l’aide de la Add-AppxPackage -Appinstaller commande PowerShell.

Journaux des événements de l'installateur d'applications

L’infrastructure de déploiement d’applications émet des journaux qui sont souvent utiles pour déboguer des problèmes d’installation via l’Observateur d’événements Windows : Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server. Des fichiers journaux supplémentaires sont créés dans ce dossier : %LocalAppData%\Packages\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\LocalState\DiagOutputDir