Problèmes connus et conseils de dépannage pour MSIX Packaging ToolKnown issues and troubleshooting tips for the 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.This article describes known issues and provides troubleshooting tips to consider when converting your apps to MSIX using the 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.Check out our other docs if you need to acquire the MSIX Packaging Tool or driver in a disconnected environments.

Problèmes connusKnown issues

Obtention de la version préliminaire la plus récente de l’outil d’empaquetage MSIXGetting the latest Insider Preview build of the MSIX Packaging Tool

Si vous avez opté pour notre programme Insider, vérifiez que vous disposez de la version appropriée de l’outil d’empaquetage MSIX :If you have opted in to our Insider Program, make sure you have the correct version of the MSIX Packaging Tool:

  • Accédez à la section about de l’outil d’empaquetage MSIX pour afficher la version que vous utilisez.Go to the About section in the MSIX Packaging Tool to view which version you are on.
  • 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.Go here to determine the latest Insider Preview version, and confirm you have that version of the MSIX Packaging Tool installed.
  • Assurez-vous que le MSA qui est inscrit pour la mise en vol est le compte qui est connecté au Microsoft Store.Make sure the MSA that's signed up for flighting is the account that is signed into the Microsoft Store.
  • Mettez à jour manuellement l’outil d’empaquetage MSIX via le Microsoft Store sur votre ordinateur.Manually update the MSIX Packaging Tool through the Microsoft Store on your computer. 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.If this option if available to you, open the Store, go to Downloads and updates, and click Get updates. Vous pouvez également Rechercher l’outil d’empaquetage MSIX, puis, dans la page produit, vous pouvez le demander pour une mise à jour.Alternatively, search for the MSIX Packaging Tool, and on the product page you can then prompt it for an update.
  • 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.To install the MSIX Packaging Tool for offline use, follow these instructions to ensure you get the latest app through our offline process.

Si vous souhaitez rejoindre notre programme Insider, cliquez ici.If you are interested in joining our Insider Program, click here.

Pilote d’outil d’empaquetage MSIXMSIX Packaging Tool driver

Le pilote de l’outil d’empaquetage MSIX est fourni en tant que package de fonctionnalités à la demande (DOM) à partir de Windows Update.The MSIX Packaging Tool driver is delivered as a Feature on Demand (FOD) package from Windows Update. L’installation échoue si le service Windows Update est désactivé sur l’ordinateur ou si les paramètres de Windows Insider Ring Ring ne correspondent pas à la version du système d’exploitation de l’ordinateur.It will fail to install if the Windows Update service is disabled on the computer or if Windows Insider flight ring settings do not match the OS build of the computer.

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.If you are running into problems acquiring the driver, or you are working in an offline environment, you can find links to download the driver here.

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.If you have downloaded the driver and are running into issues during your package conversion, it may be one of the following issues.

Problèmes de connectivité réseauNetwork connectivity issues

Les codes d’erreur suivants peuvent indiquer que vous rencontrez des problèmes de connexion :The following error codes might indicate that you are encountering connection issues:

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

Windows Server Update Service (WSUS), Configuration Manager ou des stratégies de groupe affectant la connectivité Windows UpdateWindows Server Update Service (WSUS), Configuration Manager, or group policies affecting Windows Update connectivity

Le code d’erreur suivant peut indiquer que les stratégies sur votre ordinateur affectent la connectivité Windows Update :-2145124306 (0x8024002e).The following error code may indicate that policies on your computer are be affecting Windows Update connectivity: -2145124306 (0x8024002e).

Si vous recevez ce code d’erreur, vous devrez peut-être vérifier les paramètres et les stratégiesde votre environnement.If you receive this error code, you may need to check your environment settings and policies.

Le pilote a requis une réinstallationDriver required a reinstall

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é.In this scenario, the MSIX Packaging Tool will notify you in the error message and logs that your driver needs a restart. Redémarrez votre ordinateur et recommencez la conversion pour résoudre ce problème.Restart your computer and start your conversion again to fix this issue.

Version minimaleMinimum version

Il existe quelques fonctionnalités à connaître qui modifient automatiquement la prise en charge des versions minimale dans votre package MSIX.There are a few features to be aware of that automatically change the minimun version support in your MSIX Package.

Appliquer les exigences de version du Microsoft StoreEnforce Microsoft store versioning requirements

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 imposer des exigences 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).If you convert your existing installer using a version of the MSIX Packaging Tool earlier than 1.2019.701.0, the tool had Enforce Microsoft Store versioning requirements on, or used another tool to create your package that did not set the minimum version to 10.0.16299.0 (Windows 10, version 1709). Cela entraînera un message d’erreur lors du déploiement de votre application sur Windows 10, version 1709 ou version ultérieure.This will cause an error message when deploying your app to Windows 10, version 1709 or a later version.

Pour résoudre ce problème, ouvrez l' outil d’empaquetage MSIX et modifiez votre application via l' éditeur de package.To fix this issue, open the MSIX Packaging Tool and edit your app through Package Editor. Ouvrez votre manifeste et affectez MinVersion à l’attribut de l’élément la valeur TargetDeviceFamily « 10.0.16299.0 ».Open your manifest and set the MinVersion attribute of the TargetDeviceFamily element to "10.0.16299.0".

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

MSIX avec les servicesMSIX with 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.In version 1.2019.1220.0 of the MSIX Packaging Tool, we added support for creating an MSIX package with 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.Due to the OS restrictions with services support, the MSIX Packaging Tool automatically changes the min version supported in an MSIX package with services to 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 vers Windows 10 1809.This means that you cannot install an MSIX with services on an OS lower than the Windows 10 version 2004, but you can create that MSIX using the MSIX Packaging Tool down to 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.If you need to install this app on a lower OS, update the min version appropriately but note that support for services will not work.

Infrastructures et pilotesFrameworks and drivers

Si l’application nécessite une infrastructure, assurez-vous que l’infrastructure est installée pendant la phase de surveillance de la conversion.If the app requires a framework, make sure the framework is installed during the monitoring phase of the conversion. Parcourez les journaux pour vous assurer qu’ils se produisent.Go through the logs to ensure this is happening. 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.If your app requires a driver to install, you need to evaluate whether this is required for your app to run properly. MSIX ne prend pas en charge l’installation du pilote.MSIX currently does not support driver installation.

Ordinateur distantRemote Machine

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.If you are running into issues with using a remote VM for your conversions, see Setup instructions for remote machine conversions.

Problèmes lors de la conversionIssues during conversion

  • Certains programmes d’installation peuvent ne pas parvenir à effectuer la conversion et retourner le code de sortie 259.Some installers might fail to convert with exit code 259. Cela indique que le programme d’installation a généré un thread et n’a pas attendu qu’il se termine.This indicates that the installer spawned a thread and did not wait for it to complete. 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.In other words, the main thread finished installing but it exited with error 259 because it spawned a thread that is still running. Nous vous recommandons d’utiliser l’option d’installation appropriée pour setup.exe.We recommend that you use the appropriate install option for setup.exe.

Problèmes lors de la signatureIssues during signing

Certificat PE incorrect (0x800700C1)Bad PE certificate (0x800700C1)

Ce problème se produit lorsque le package contient un fichier binaire avec un certificat endommagé.This problem occurs when the package contains a binary file that has a corrupt certificate. 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.To resolve this issue, use the dumpbin.exe /headers command to dump the file headers and inspect for bad elements. Réécrivez manuellement les en-têtes pour résoudre le problème.Manually rewrite the headers to fix the issue. En général, l’outil d’empaquetage MSIX détecte automatiquement les en-têtes incorrects.In general, the MSIX Packaging tool automatically detects bad headers. Si ce problème persiste, envoyez un commentaire au fichier.If this issue persists, file feedback. Des informations supplémentaires sont disponibles ici.More information can be found here.

Signature Device GuardDevice Guard signing

Veillez à suivre ces étapes et à attribuer les rôles appropriés dans le Microsoft Store pour l’entreprise.Make sure to follow these steps and that you are assigning the appropriate roles in the Microsoft Store for Business.

Expiration du certificatExpired certificate

  • Utilisez un horodateur lorsque vous signez votre package.Use a timestamp when you sign your package.
  • Vous pouvez abandonner avec un certificat de signature ou d’horodatage valide.You can resign with a valid sign or timestamp certificate.

Vous pouvez abandonner votre application à l’aide du script de conversion par lot.You can resign your app using the batch conversion script.

Résolution des problèmesTroubleshooting

Fichiers journauxLog files

Que la conversion ait réussi ou non, des fichiers journaux sont générés pour chaque conversion.Whether or not your conversion was successful, log files are generated for every conversion. Vous les trouverez à cet emplacement :They can be found here:

%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.Failure codes are written and indicate any point of failure during the conversion process. Les codes d’erreurs sont censés être conviviaux.The error codes are meant to be user friendly.

Fichiers journaux à partir de machines virtuelles ou d’appareils distantsLog files from remote devices or VMs

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.If the conversion is performed on a remote device or a VM, we recommend that you copy the log files from that device and attach them as part of the feedback item. Cela nous aidera à diagnostiquer et à résoudre les problèmes plus efficacement.This will help us diagnose and resolve issues more efficiently.

Vous trouverez les journaux des conversions à distance à cet emplacement : %localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\<Logs_#>\RemoteServer\Log.txtYou will find the logs from the remote conversions here: %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.It would even more beneficial if you can share the whole Logs folder that will include the operations occurring on the local client as well the remote server.

Problèmes courantsCommon problems

Erreurs de traduction de MakePri/manifestMakePri/Manifest translation errors

Cette erreur se produit en cas de problème avec le manifeste du package.This error occurs when there is an issue with the package’s manifest. Pour identifier le problème, accédez à l’éditeur de package et ouvrez le manifeste.To identify the issue, go to Package Editor and open the manifest. Lorsque vous ouvrez le manifeste, vous pouvez identifier le problème et fournir le correctif approprié.When you open the manifest, you can identify the issue and provide the proper fix.

Fichier introuvableFile not found

Le fichier peut être ouvert ou inexistant.The file may either be open or non-existent. Pour résoudre ce problème, ajoutez le fichier approprié ou fermez le fichier en cours d’utilisation.To resolve this issue, add the appropriate file or close the file that is currently in use. Notez que vous n’obtiendrez pas d' File not Found erreur si elle est ouverte.Note that you will not get a File not Found error if it is open. Au lieu de cela, vous obtiendrez une Access Denied File in Use erreur ou.Instead, you’ll get an Access Denied or File in Use error.

Associations de types de fichierFile Type Associations

Les problèmes concernant les associations de types de fichier (Association) varient d’un package à l’autres.The issues regarding File Type Associations (FTA) vary from package to package. MSIX Packaging Tool prend en charge les associations de fichiers pour les installations de double-clic.MSIX Packaging Tool support file associations for double click installs. Par exemple, si votre application a un menu contextuel, elle n’est pas automatiquement ajoutée. vous devrez donc l’ajouter manuellement au manifeste.For example, if your app has context menu, it is not automatically added, so you will need to add it manually to the manifest. Pour obtenir un exemple, consultez l’élément de manifeste desktop4 : FileExplorerContextMenus .See the desktop4:FileExplorerContextMenus manifest element for an example.

Raccourcis avec argumentsShortcuts with arguments

Les raccourcis avec arguments ne sont actuellement pas pris en charge avec MSIX.Shortcuts with arguments are not currently supported with MSIX. Si nous détectons que le programme d’installation les comprend, MSIX crée une vignette sans arguments.If we detect that the installer includes these, MSIX will create a tile with no arguments.

Répertoire d’installationInstall directory

Cela est plus courant pour les personnes qui utilisent un lecteur secondaire pour effectuer des conversions d’applications.This is more common for those who use a secondary drive to perform app conversions. Si vous choisissez de modifier l’emplacement d’installation, il modifie la racine de l’emplacement où tous les fichiers sont placés.If you choose to change the installation location, it changes the root of where all of the files go. Cela signifie que l’outil d’empaquetage MSIX devra savoir où se trouvent tous ces fichiers et sera capturé au cours de la conversion.This means that the MSIX Packaging tool will need to know where all these files go and will be captured during 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.You can fix this by using the Package Support Framework write to install directory fix. Nous l’avons ajouté par défaut en tant que fonctionnalité dans l’outil MSIX, ce qui permet de le réduire à 1809.We have added this as a capability by default in the MSIX Tool, which allows this down to 1809. Si votre application ne fonctionne pas dans 1709 et est dans 1809, il s’agit probablement du problème.If your application isn't working in 1709 and is in 1809, this is likely the issue.

Envoi de commentairesSending feedback

La meilleure façon d’envoyer vos commentaires consiste à utiliser le Hub de commentaires.The best way to send your feedback is through the Feedback Hub.

  1. Ouvrez le Hub de commentaires ou appuyez sur Windows + F.Open Feedback Hub or type Windows + F.
  2. Spécifiez un titre et les étapes nécessaires pour reproduire le problème.Provide a title and necessary steps to reproduce the issue.
  3. Sous Catégorie, sélectionnez Applications puis MSIX Packaging Tool.Under Category, select Apps and select MSIX Packaging Tool.
  4. Joignez tous les fichiers journaux associés à la conversion.Attach any log files associated to the conversion. Vous trouverez les journaux dans le dossier mentionné plus haut.You can find the logs in the folder provided above.
  5. Joignez le package MSIX converti (si possible).Attach the converted MSIX package (if possible).
  6. Cliquez sur Envoyer.Click Submit.

Vous pouvez aussi nous envoyer vos commentaires directement à partir de MSIX Packaging Tool en accédant à l’onglet Feedback sous Settings.You can also send us feedback directly from the MSIX Packaging Tool by going to the Feedback tab under Settings.

Notes

Vos commentaires nous parviendrons dans les 24 heures.It may take 24 hours for your feedback to get to us. 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.Therefore if you are using a VM to convert your package, you may want to keep your VM on and in its current state for 24 hours after conversion. En outre, vous pouvez attacher manuellement les journaux de conversion aux commentaires.Also, you can manually attach conversion logs to the feedback.