Résoudre les problèmes d’installation avec le fichier Programme d’installation 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.

Prérequis

Pour pouvoir charger des applications côte à côte dans Windows 10, l’appareil utilisateur doit répondre 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 quelques problèmes courants lors du chargement indépendant d’une application pour la première fois sur l’ordinateur 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 chargement indépendant, dans le tableau ci-dessous, 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 Notes de chargement latéral
Build 17134 (Mise à jour d’avril 2018, version 1803) Le .appinstaller fichier est accessible sur les dossiers UNC/Share. Les vérifications de mise à jour configurables sont également disponibles.
Build 16299 (Mise à jour Créateurs en automne, 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 (Mise à jour Créateurs, version 1703) L’application Programme d’installation d’application peut télécharger les dépendances d’application (uniquement en mode mise en production) à partir du Store.
Build 14393 (mise à jour anniversaire, version 1607) Introduction de l’application Programme d’installation d’application pour installer les fichiers .appx et .appxbundle, le fichier .appinstaller n’est pas pris en charge.
Build 10586 (mise à jour de novembre, version 1511) Le chargement indépendant n’est disponible que via PowerShell à l’aide de la commande Add-AppxPackage .
Build 10240 (Windows 10, version 1507) Le chargement indépendant n’est disponible que via 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é lors du 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 signed with missing or untrusted Cert

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 approuvées (non recommandées)

Important

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

Vous trouverez facilement l’outil de gestion des certificats d’ordinateur en effectuant une recherche dans le menu Démarrer :

Find the local Computer Certificates tool via the Start Menu

Une fois le certificat de signature importé avec succès, le programme d’installation de l’application montre que le package est approuvé et peut être installé :

MSIX signed with a trusted Cert

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

Important

Si le package d’application est intégré en mode Mise en production, les dépendances d’infrastructure 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 sont accessibles avec le type MIME correct. 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. Vous devez vérifier ces fichiers :

  • .appinstaller fichier, disponible en tant que fichier application/xml
  • .appx et .appxbundle les fichiers, disponibles en tant que application/vns.ms-appx

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

Étant donné que les URL de vanité 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. Ce n’est pas important si vous redirigez vers un fichier se terminant par .appinstaller. Cela échouera également de la même façon. La seule façon de corriger cela consiste à vérifier que l’URL d’origine se termine par .appinstaller.

Isoler les problèmes d’application Du programme d’installation d’applications

Si le programme d’installation d’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 App Installer

L’infrastructure de déploiement d’applications émet des journaux qui sont souvent utiles pour le débogage des problèmes d’installation via l’Observateur d’événements Windows : Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server