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 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 échoue si le service Windows Update est désactivé sur l’ordinateur ou si les paramètres de l’anneau de version d’évaluation Windows Insider ne correspondent pas à 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 case activée vos paramètres et stratégies d’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 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 case activée le fichier journal, vous devez trouver une entrée comme celle suivante :

[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 Analyseur de performances.
2. Cliquez avec le bouton droit sur celui-ci et choisissez Autres -> Exécuter en tant que Administration istrateur.
3. Dans le menu arborescence, choisissez Jeux 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 pilotes

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 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 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 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, signalez les commentaires sur les fichiers. 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 horodatage lorsque vous signez votre package.
• Vous pouvez démissionner avec un certificat de signe ou d’horodatage valide.

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

Dépannage

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 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 ou File in Use une Access Denied erreur.

Associations de types de fichier

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 :Raccourci .

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 à l’aide de l’écriture de 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 consiste à passer par 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.

Remarque

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.