Problèmes connus et conseils de dépannage pour l’outil d’empaquetage MSIX

Cet article décrit les problèmes connus et fournit des conseils de dépannage à prendre en compte lors de la conversion de vos applications en MSIX à l’aide de MSIX Packaging Tool. Consultez nos autres documents si vous avez besoin d’acquérir l’outil ou le pilote MSIX Packaging Tool dans des environnements déconnectés.

Problèmes connus

Obtention de la dernière version Insider Preview de l’outil d’empaquetage MSIX

Si vous avez choisi notre programme Insider, vérifiez que vous disposez de la version correcte de MSIX Packaging Tool :

• Accédez à la section About de l’outil MSIX Packaging Tool pour afficher la version sur laquelle vous êtes activé.
• Accédez ici pour déterminer la dernière version Insider Preview et vérifiez que vous disposez de cette version de MSIX Packaging Tool.
• Assurez-vous que le MSA inscrit à la version d’évaluation est le compte connecté au Microsoft Store.
• Mettez à jour manuellement l’outil d’empaquetage MSIX via le Microsoft Store sur votre ordinateur. Si cette option est disponible, ouvrez le Windows Store, accédez aux téléchargements et mises à jour, puis cliquez sur Obtenir les mises à jour. Vous pouvez également rechercher l’outil d’empaquetage MSIX et, dans la page du produit, vous pouvez ensuite l’inviter à effectuer une mise à jour.
• Pour installer MSIX Packaging Tool pour une utilisation hors connexion, suivez ces instructions pour vous assurer que vous obtenez la dernière application via notre processus hors connexion.

Si vous souhaitez participer à notre programme Insider, accédez à Join MSIX Packaging Tool Insiders !.

Pilote MSIX Packaging Tool

Le pilote MSIX Packaging Tool est fourni en tant que package Feature on Demand (FOD) à partir de Windows Update. L’installation échouera si le service Windows Update est désactivé sur l’ordinateur ou si les paramètres de canal de distribution Windows Insider ne sont pas compatibles avec la build du système d’exploitation de l’ordinateur.

Si vous rencontrez des problèmes lors de l’acquisition du pilote ou que vous travaillez dans un environnement hors connexion, vous trouverez des liens pour télécharger le pilote ici.

Si vous avez téléchargé le pilote et que vous rencontrez des problèmes pendant la conversion de votre package, il peut s’agir de l’un des problèmes suivants.

Problèmes de connectivité réseau

Les codes d’erreur suivants peuvent indiquer que vous rencontrez des problèmes de connexion :

• -2145107924 (0x8024402c)
• -2145107945 (0x80244017)
• -2145123272 (0x80240438)

Windows Server Update Service (WSUS), Configuration Manager ou stratégies de groupe affectant la connectivité Windows Update

Le code d’erreur suivant peut indiquer que les stratégies sur votre ordinateur affectent la connectivité Windows Update : -2145124306 (0x8024002e).

Si vous recevez ce code d’erreur, vous devrez peut-être vérifier les paramètres et stratégies de votre environnement.

Le pilote a requis une réinstallation

Dans ce scénario, l’outil d’empaquetage MSIX vous avertit dans le message d’erreur et les journaux d’activité que votre pilote a besoin d’un redémarrage. Redémarrez votre ordinateur et redémarrez votre conversion pour résoudre ce problème.

Erreur lors du démarrage du pilote de l’outil d’empaquetage MSIX 0x80131500

Si vous obtenez cette erreur pendant la conversion, lorsque vous vérifiez le fichier journal, vous devez trouver une entrée comme celle-ci :

[Error] Error monitoring: Insufficient system resources exist to complete the requested service

Cette erreur se produit lorsque l’outil démarre une nouvelle session de suivi des événements système, mais que vous avez dépassé le nombre maximal de sessions que Windows peut créer à l’échelle du système. Si vous dépassez la limite par défaut (64), vous obtiendrez une erreur de ERROR_NO_SYSTEM_RESOURCES, ce qui entraîne l’échec du pilote.

La solution consiste à arrêter certaines des sessions de trace d’événements existantes en procédant comme suit :

1. Ouvrez le menu Démarrer et recherchez l’Analyseur de performances.
2. Cliquez avec le bouton droit sur celui-ci et choisissez Autres -> Exécuter en tant qu’administrateur.
3. Dans le menu arborescence, choisissez Ensembles de collecteurs de données -> Sessions de trace d’événements.
4. Cliquez avec le bouton droit sur certaines sessions existantes de la liste, puis choisissez Arrêter.

Vous pouvez maintenant réessayer d’effectuer la conversion avec MSIX Packaging Tool.

Version minimale

Il existe quelques fonctionnalités à prendre en compte pour modifier automatiquement la prise en charge de la version de minimun dans votre package MSIX.

Appliquer les exigences de contrôle de version du Microsoft Store

Si vous convertissez votre programme d’installation existant à l’aide d’une version de MSIX Packaging Tool antérieure à la version 1.2019.701.0, l’outil avait appliqué les exigences de contrôle de version du Microsoft Store ou utilisé un autre outil pour créer votre package qui n’a pas défini la version minimale sur 10.0.16299.0 (Windows 10, version 1709). Cela entraîne un message d’erreur lors du déploiement de votre application sur Windows 10, version 1709 ou ultérieure.

Pour résoudre ce problème, ouvrez MSIX Packaging Tool et modifiez votre application via l’Éditeur de package. Ouvrez votre manifeste et définissez l’attribut MinVersion de l’élément TargetDeviceFamily sur « 10.0.16299.0 ».

<Dependencies>
    <TargetDeviceFamily> Name="Windows.Desktop" MinVersion="10.0.16299.0" MaxVersionTested = "10.0.17763.0" />
</Dependencies>

MSIX avec des services

Dans la version 1.2019.1220.0 de MSIX Packaging Tool, nous avons ajouté la prise en charge de la création d’un package MSIX avec services. En raison des restrictions de système d’exploitation avec prise en charge des services, l’outil d’empaquetage MSIX modifie automatiquement la version minimale prise en charge dans un package MSIX avec des services à 10.0.19025.0. Cela signifie que vous ne pouvez pas installer MSIX avec des services sur un système d’exploitation inférieur à Windows 10 version 2004, mais vous pouvez créer cette MSIX à l’aide de l’outil d’empaquetage MSIX jusqu’à Windows 10 1809. Si vous devez installer cette application sur un système d’exploitation inférieur, mettez à jour la version minimale correctement, mais notez que la prise en charge des services ne fonctionnera pas.

Frameworks et facteurs

Si l’application nécessite une infrastructure, vérifiez que l’infrastructure est installée pendant la phase de supervision de la conversion. Passez en revue les journaux de bord pour vous assurer que cela se produit. Si votre application nécessite l’installation d’un pilote, vous devez évaluer s’il est nécessaire que votre application s’exécute correctement. MSIX ne prend actuellement pas en charge l’installation du pilote.

Ordinateur distant

Si vous rencontrez des problèmes avec l’utilisation d’une machine virtuelle distante pour vos conversions, consultez les instructions d’installation pour les conversions de machines distantes.

Problèmes lors de la conversion

• Certains programmes d’installation peuvent échouer à convertir avec le code de sortie 259. Cela indique que le programme d’installation a généré un thread et n’a pas attendu qu’il se termine. En d’autres termes, le thread principal a terminé l’installation, mais il a quitté avec l’erreur 259, car il a généré un thread qui est toujours en cours d’exécution. Nous vous recommandons d’utiliser l’option d’installation appropriée pour setup.exe.

Problèmes lors de la signature

Certificat PE invalide (0x800700C1)

Ce problème se produit lorsque le package contient un fichier binaire qui a un certificat endommagé. Pour résoudre ce problème, utilisez la dumpbin.exe /headers commande pour vider les en-têtes de fichier et inspecter les éléments incorrects. Réécrire manuellement les en-têtes pour résoudre le problème. En général, l’outil d’empaquetage MSIX détecte automatiquement les en-têtes incorrects. Si ce problème persiste, soumettez des commentaires. Des informations supplémentaires sont disponibles ici.

Signature de Device Guard

Veillez à suivre ces étapes et à attribuer les rôles appropriés dans le Microsoft Store pour Entreprises.

Expiration du certificat

• Utilisez un horodatage lorsque vous signez votre package.
• Vous pouvez resigner avec un certificat de signature ou d’horodatage valide.

Vous pouvez démissionner de votre application à l’aide du script de conversion par lots dans MSIX Toolkit - Scripts.

Résolution des problèmes

Fichiers de logs

Que votre conversion ait réussi ou non, des fichiers journaux sont générés pour chaque conversion. Ils sont disponibles ici :

%localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\

Les codes d’échec sont écrits et indiquent tout point de défaillance pendant le processus de conversion. Les codes d'erreur sont destinés à être faciles à utiliser.

Fichiers journaux depuis des machines virtuelles ou des appareils distants

Si la conversion est effectuée sur un appareil distant ou une machine virtuelle, nous vous recommandons de copier les fichiers journaux de cet appareil et de les joindre dans le cadre de l’élément de commentaires. Cela nous aidera à diagnostiquer et à résoudre les problèmes plus efficacement.

Vous trouverez les logs des conversions distantes ici : %localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\<Logs_#>\RemoteServer\Log.txt

Il serait encore plus utile si vous pouvez partager l’ensemble du dossier Journaux qui inclura les opérations qui se produisent sur le client local ainsi que le serveur distant.

Problèmes courants

Erreurs de traduction MakePri/Manifest

Cette erreur se produit lorsqu’il existe un problème avec le manifeste du package. Pour identifier le problème, accédez à l’Éditeur de package et ouvrez le manifeste. Lorsque vous ouvrez le manifeste, vous pouvez identifier le problème et fournir le correctif approprié.

Fichier introuvable

Le fichier peut être ouvert ou inexistant. Pour résoudre ce problème, ajoutez le fichier approprié ou fermez le fichier en cours d’utilisation. Notez que vous n’obtiendrez pas d’erreur File not Found s’il est ouvert. Au lieu de cela, vous obtiendrez une erreur Access Denied ou File in Use.

Associations de types de fichiers

Les problèmes liés aux associations de types de fichiers (FTA) varient d’un package à l’autre. MSIX Packaging Tool prend en charge les associations de fichiers pour les installations en double-clic. Par exemple, si votre application a un menu contextuel, elle n’est pas automatiquement ajoutée. Vous devez donc l’ajouter manuellement au manifeste. Consultez l’élément manifeste Desktop4 :FileExplorerContextMenus pour obtenir un exemple.

Raccourcis avec arguments

L’outil d’empaquetage MSIX capture tous les raccourcis au niveau de l’utilisateur, ainsi que les arguments. Si ces raccourcis ne sont pas détectés correctement, vous pouvez l’ajouter manuellement au manifeste. Pour plus d’informations, consultez desktop7:Shortcut.

Répertoire d’installation

Cela est plus courant pour ceux qui utilisent un lecteur secondaire pour effectuer des conversions d’application. Si vous choisissez de modifier l’emplacement d’installation, il modifie la racine de l’emplacement où tous les fichiers vont. Cela signifie que l’outil MSIX Packaging doit savoir où tous ces fichiers vont et seront capturés lors de la conversion.

Vous pouvez résoudre ce problème en utilisant l’écriture Package Support Framework pour installer le correctif d’annuaire. Nous avons ajouté cette fonctionnalité par défaut dans l’outil MSIX, ce qui permet de passer à 1809. Si votre application ne fonctionne pas en 1709 et est en 1809, il s’agit probablement du problème.

Envoi de commentaires

La meilleure façon d’envoyer vos commentaires est via le Hub de commentaires.

1. Ouvrez le Hub de commentaires ou tapez Windows + F.
2. Fournissez un titre et les étapes nécessaires pour reproduire le problème.
3. Sous Catégorie, sélectionnez Applications et sélectionnez l’outil d’empaquetage MSIX.
4. Joignez tout fichier journal associé à la conversion. Vous trouverez les logs dans le dossier fourni ci-dessus.
5. Attachez le package MSIX converti (si possible).
6. Cliquez sur Envoyer.

Vous pouvez également nous envoyer des commentaires directement à partir de l’outil d’empaquetage MSIX en accédant à l’onglet Commentaires sous Paramètres.