Problèmes connus et conseils de dépannage pour MSIX Packaging Tool

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

Problèmes connus

Obtention de la version préliminaire la plus récente de l’outil d’empaquetage MSIX

Si vous avez opté pour notre programme Insider, vérifiez que vous disposez de la version appropriée de l’outil d’empaquetage MSIX :

  • Accédez à la section about de l’outil d’empaquetage MSIX pour afficher la version que vous utilisez.
  • Cliquez ici pour déterminer la dernière version d’Insider Preview et vérifiez que cette version de l’outil d’empaquetage MSIX est installée.
  • Assurez-vous que le MSA qui est inscrit pour la mise en vol est le compte qui est connecté au Microsoft Store.
  • mettez à jour manuellement l’outil d’empaquetage MSIX via le Microsoft Store sur votre ordinateur. Si vous disposez de cette option, ouvrez le Store, accédez à téléchargements et mises à jour, puis cliquez sur récupérer les mises à jour. Vous pouvez également Rechercher l’outil d’empaquetage MSIX, puis, dans la page produit, vous pouvez le demander pour une mise à jour.
  • Pour installer l’outil d’empaquetage MSIX pour une utilisation hors connexion, suivez ces instructions pour vous assurer d’obtenir la dernière application via notre processus hors connexion.

Si vous souhaitez rejoindre notre programme Insider, cliquez ici.

Pilote d’outil d’empaquetage MSIX

le pilote de l’outil d’empaquetage MSIX est fourni en tant que package de fonctionnalités à la demande (dom) à partir de Windows Update. il ne pourra pas être installé si le service Windows Update est désactivé sur l’ordinateur ou si Windows paramètres de l’anneau de vol insider ne correspondent pas à la version du système d’exploitation de l’ordinateur.

Si vous rencontrez des problèmes lors de l’acquisition du pilote ou si 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 lors de 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 services de mise à jour serveur (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 les stratégiesde votre environnement.

Le pilote a requis une réinstallation

Dans ce scénario, l’outil d’empaquetage MSIX vous avertit que le message d’erreur s’affiche et vous informe que votre pilote doit être redémarré. Redémarrez votre ordinateur et recommencez la 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 lors de la conversion, lorsque vous consultez le fichier journal, vous devez trouver une entrée semblable à 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 pouvez créer à l’ensemble du système. Si vous dépassez la limite par défaut (64), vous obtiendrez une erreur de ERROR_NO_SYSTEM_RESOURCES, ce qui provoque l’échec du pilote.

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

  1. ouvrez la menu Démarrer et recherchez analyseur de performances.
  2. Cliquez avec le bouton droit sur celui-ci, puis choisissez plus d' > exécuter en tant qu’administrateur.
  3. Dans le menu de l’arborescence, choisissez ensembles de collecteurs de données-> sessions de suivi 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 l’outil d’empaquetage MSIX.

Version minimale

Il existe quelques fonctionnalités à connaître qui modifient automatiquement la prise en charge des versions minimale dans votre package MSIX.

Appliquer les exigences de version du Microsoft Store

si vous convertissez votre programme d’installation existant à l’aide d’une version de l' outil d’empaquetage MSIX antérieur à 1.2019.701.0, l’outil devait appliquer les exigences en matière de gestion des versions Microsoft Store ou utiliser 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 l' outil d’empaquetage MSIX et modifiez votre application via l' éditeur de package. Ouvrez votre manifeste et affectez MinVersion à l’attribut de l’élément la valeur TargetDeviceFamily « 10.0.16299.0 ».

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

MSIX avec les services

Dans la version 1.2019.1220.0 de l’outil d’empaquetage MSIX, nous avons ajouté la prise en charge de la création d’un package MSIX avec les services. En raison des restrictions du système d’exploitation avec la prise en charge des services, l’outil d’empaquetage MSIX modifie automatiquement la version minimale prise en charge dans un package MSIX avec les services en 10.0.19025.0. cela signifie que vous ne pouvez pas installer un MSIX avec des services sur un système d’exploitation inférieur à la version 2004 de Windows 10, mais vous pouvez créer ce MSIX à l’aide de l’outil d’empaquetage MSIX pour 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.

Infrastructures et pilotes

Si l’application nécessite une infrastructure, assurez-vous que l’infrastructure est installée pendant la phase de surveillance de la conversion. Parcourez les journaux pour vous assurer qu’ils se produisent. Si votre application nécessite l’installation d’un pilote, vous devez déterminer si cela est nécessaire pour que votre application s’exécute correctement. MSIX ne prend pas en charge l’installation du pilote.

Ordinateur distant

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

Problèmes lors de la conversion

  • Certains programmes d’installation peuvent ne pas parvenir à effectuer la conversion et retourner 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. Autrement dit, le thread principal a terminé l’installation, mais il s’est arrêté avec l’erreur 259 car il a généré un thread qui est encore 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 incorrect (0x800700C1)

Ce problème se produit lorsque le package contient un fichier binaire avec 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éécrivez 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, envoyez un commentaire au fichier. Des informations supplémentaires sont disponibles ici.

Signature Device Guard

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

Expiration du certificat

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

Vous pouvez abandonner votre application à l’aide du script de conversion par lot.

Résolution des problèmes

Fichiers journaux

Que la conversion ait réussi ou non, des fichiers journaux sont générés pour chaque conversion. Vous les trouverez à cet emplacement :

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

Des codes d’erreurs sont écrits et indiquent les éventuels points de défaillance pendant le processus de conversion. Les codes d’erreurs sont censés être conviviaux.

Fichiers journaux à partir de machines virtuelles ou d’appareils distants

Si la conversion est effectuée sur une machine virtuelle ou un appareil distant, nous vous recommandons de copier les fichiers journaux à partir 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 journaux des conversions à distance à cet emplacement : %localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\<Logs_#>\RemoteServer\Log.txt

Il serait encore plus avantageux si vous pouvez partager le dossier de journaux entier qui inclura les opérations qui se produisent sur le client local et le serveur distant.

Problèmes courants

Erreurs de traduction de MakePri/manifest

Cette erreur se produit en cas de 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' File not Found erreur si elle est ouverte. Au lieu de cela, vous obtiendrez une Access Denied File in Use erreur ou.

Associations de types de fichier

Les problèmes concernant les associations de types de fichier (Association) varient d’un package à l’autres. MSIX Packaging Tool prend en charge les associations de fichiers pour les installations de double-clic. Par exemple, si votre application a un menu contextuel, elle n’est pas automatiquement ajoutée. vous devrez donc l’ajouter manuellement au manifeste. Pour obtenir un exemple, consultez l’élément de manifeste desktop4 : FileExplorerContextMenus .

Raccourcis avec arguments

Les raccourcis avec arguments ne sont actuellement pas pris en charge avec MSIX. Si nous détectons que le programme d’installation les comprend, MSIX crée une vignette sans arguments.

Répertoire d’installation

Cela est plus courant pour les personnes qui utilisent un lecteur secondaire pour effectuer des conversions d’applications. Si vous choisissez de modifier l’emplacement d’installation, il modifie la racine de l’emplacement où tous les fichiers sont placés. Cela signifie que l’outil d’empaquetage MSIX devra savoir où se trouvent tous ces fichiers et sera capturé au cours de la conversion.

Vous pouvez résoudre ce problème à l’aide de l’infrastructure de prise en charge des packages écrire pour installer le correctif de répertoire. Nous l’avons ajouté par défaut en tant que fonctionnalité dans l’outil MSIX, ce qui permet de le réduire à 1809. Si votre application ne fonctionne pas dans 1709 et est dans 1809, il s’agit probablement du problème.

Envoi de commentaires

La meilleure façon d’envoyer vos commentaires consiste à utiliser le Hub de commentaires.

  1. Ouvrez le Hub de commentaires ou appuyez sur Windows + F.
  2. Spécifiez un titre et les étapes nécessaires pour reproduire le problème.
  3. Sous Catégorie, sélectionnez Applications puis MSIX Packaging Tool.
  4. Joignez tous les fichiers journaux associés à la conversion. Vous trouverez les journaux dans le dossier mentionné plus haut.
  5. Joignez le package MSIX converti (si possible).
  6. Cliquez sur Envoyer.

Vous pouvez aussi nous envoyer vos commentaires directement à partir de MSIX Packaging Tool en accédant à l’onglet Feedback sous Settings.

Notes

Vos commentaires nous parviendrons dans les 24 heures. Par conséquent, si vous utilisez une machine virtuelle pour convertir votre package, il est préférable de la maintenir allumée et dans son état actuel pendant 24 heures après la conversion. En outre, vous pouvez attacher manuellement les journaux de conversion aux commentaires.