Créer un package d'application à l’aide de Desktop App Converter (Pont du bureau)Package an app using the Desktop App Converter (Desktop Bridge)

Obtenir Desktop App ConverterGet the Desktop App Converter

Vous pouvez utiliser l’outil Desktop App Converter (DAC) pour mettre vos applications de bureau sur la plateforme Windows universelle (UWP).You can use the Desktop App Converter (DAC) to bring your desktop apps to the Universal Windows Platform (UWP). Cela inclut les applications Win32 et celles que vous avez créées à l’aide de .NET 4.6.1.This includes Win32 apps and apps that you've created by using .NET 4.6.1.

Icône DAC

Bien que le terme «Converter» apparaisse dans son nom, cet outil ne convertit pas réellement votre application.While the term "Converter" appears in the name of this tool, it doesn't actually convert your app. Votre application reste inchangée.Your app remains unchanged. Toutefois, cet outil génère un package d’application Windows avec une identité de package et la possibilité d’appeler une gamme étendue d’API WinRT.However, this tool generates a Windows app package with a package identity and the ability to call a vast range of WinRT APIs.

Vous pouvez installer ce package sur votre ordinateur de développement à l’aide de l’applet de commande PowerShell Add-AppxPackage.You can install that package by using the Add-AppxPackage PowerShell cmdlet on your development machine.

Le convertisseur exécute le programme d’installation de bureau dans un environnement Windows isolé à l’aide d’une nouvelle image de base, fournie dans le cadre du téléchargement du convertisseur.The converter runs the desktop installer in an isolated Windows environment by using a clean base image provided as part of the converter download. Il capture toutes les E/S du Registre et du système de fichiers effectuées par le programme d’installation du bureau et les intègre sous forme de package comme partie intégrante de la sortie.It captures any registry and file system I/O made by the desktop installer and packages it as part of the output.

Important

Le Pont du bureau a été introduit dans Windows10, version1607 et peut être utilisé uniquement dans les projets qui ciblent la Mise à jour anniversaire Windows10 (version10.0; build 14393) ou une version ultérieure dans Visual Studio.The Desktop Bridge was introduced in Windows 10, version 1607, and it can only be used in projects that target Windows 10 Anniversary Update (10.0; Build 14393) or a later release in Visual Studio.

Note

Obtenez cette série de courtes vidéos publiées par MicrosoftVirtual Academy.Checkout this series of short videos published by the Microsoft Virtual Academy. Ces vidéos vous expliquent certaines méthodes courantes d’utilisation de Desktop App Converter.These videos walk you through some common ways to use the Desktop App Converter.

DAC fait davantage pour vous que simplement générer un packageThe DAC does more than just generate a package for you

Voici quelques actions supplémentaires, qu’il peut accomplir pour vous.Here's a few extra things it can do for you.

Windows10 Creators UpdateWindows 10 Creators Update

✔️ Enregistrer automatiquement vos gestionnaires d’aperçus, de miniatures et de propriétés, les règles du pare-feu, les indicateurs d’URL.✔️ Automatically register your preview handlers, thumbnail handlers, property handlers, firewall rules, URL flags.

✔️ Enregistrer automatiquement les mappages des types de fichiers qui permettent aux utilisateurs de grouper des fichiers à l’aide de la colonne Type de l’explorateur de fichiers.✔️ Automatically register file type mappings that enable users to group files by using the Kind column in File Explorer.

✔️ Enregistrer vos serveurs COM publics.✔️ Register your public COM servers.

Mise à jour anniversaire Windows10 ou ultérieureWindows 10 Anniversary Update or later

✔️ Signer automatiquement votre package pour vous permettre de tester votre application.✔️ Automatically sign your package so that you can test your app.

✔️ Valider votre application en fonction des exigences du Pont du bureau et du MicrosoftStore.✔️ Validate your app against Desktop Bridge and Microsoft Store requirements.

Vous trouverez une liste complète des options dans la section Paramètres de ce guide.To find a complete list of options, see the Parameters section of this guide.

Si vous êtes prêt à créer votre package, mettons-nous au travail.If you're ready to create your package, let's start.

Tout d'abord, préparez votre applicationFirst, prepare your application

Passez ce guide en revue avant de commencer à créer un package pour votre application: Préparer le package d’une application (Pont du bureau).Review this guide before you begin creating a package for your application: Prepare to package an app (Desktop Bridge).

Assurez-vous que le convertisseur peut fonctionner sur votre systèmeMake sure that your system can run the converter

Assurez-vous que votre système répond aux exigences suivantes:Make sure that your system meets the following requirements:

Démarrez Desktop App ConverterStart the Desktop App Converter

  1. Téléchargez et installez Desktop App Converter.Download and install the Desktop App Converter.

  2. Exécutez Desktop App Converter en tant qu’administrateur.Run the Desktop App Converter as an administrator.

    exécutez DAC en tant qu’administrateur

    Une fenêtre de console apparaît.A console window appears. Cette fenêtre de console vous permettra d’exécuter des commandes.You'll use that console window to run commands.

Définir quelques éléments (applications avec programmes d’installation uniquement)Set a few things up (apps with installers only)

Vous pouvez passer à la section suivante si votre application ne contient pas de programme d’installation.You can skip ahead to the next section if your app doesn't have an installer.

  1. Identifiez le numéro de version de votre système d’exploitation.Identify the version number of your operating system.

    Pour ce faire, tapez winver dans la zone de boîte de dialogue Exécuter, puis choisissez le bouton OK.To do that, type winver in the Run dialog box, and then choose the OK button.

    winver

    Vous trouverez la version de votre build de Windows dans la boîte de dialogue À propos de Windows.You'll find the version of your Windows build in the About Windows dialog box.

    Version de Windows10

  2. Téléchargez l’image de base Desktop app Converter appropriée.Download the appropriate Desktop app Converter base image.

    Assurez-vous que le numéro de version qui s’affiche dans le nom du fichier correspond à celui de votre version de Windows.Make sure that the version number that appears in the name of the file matches the version number of your Windows build.

    Important

    Si vous utilisez le numéro de build15063 et que la version mineure de ce build est supérieure ou égale à .483 (par exemple: 15063.540), veillez à télécharger le fichier BaseImage-15063-UPDATE.wim.If you're using build number 15063, and the minor version of that build is equal to or greater than .483 (For example: 15063.540), make sure to download the BaseImage-15063-UPDATE.wim file. Si la version mineure de ce build est inférieure à .483, téléchargez le fichier BaseImage-15063.wim.If the minor version of that build is less than .483, download the BaseImage-15063.wim file. Si vous avez déjà installé une version incompatible de ce fichier de base, vous pouvez y remédier.If you've already setup an incompatible version of this base file, you can fix it. Cela billet de blog explique la procédure à suivre.This blog post explains how to do that.

  3. Placez le fichier téléchargé dans un emplacement de votre ordinateur où vous pourrez le retrouver ultérieurement.Place the downloaded file anywhere on your computer where you'll be able to find it later.

  4. Dans la fenêtre de console affichée lors du démarrage de Desktop App Converter, exécutez la commande suivante: Set-ExecutionPolicy bypass.In the console window that appeared when you started the Desktop App Converter, run this command: Set-ExecutionPolicy bypass.

  5. Paramétrez le convertisseur à l’aide de la commande suivante: DesktopAppConverter.exe -Setup -BaseImage .\BaseImage-1XXXX.wim -Verbose.Set up the converter by running this command: DesktopAppConverter.exe -Setup -BaseImage .\BaseImage-1XXXX.wim -Verbose.
  6. Redémarrez votre ordinateur si vous êtes invité à le faire.Restart your computer if you're prompted to do so.

    Les messages d’état s’affichent dans la fenêtre de la console au fur et à mesure que le convertisseur développe l’image de base.Status messages appear in the console window as the converter expands the base image. Si vous ne voyez pas les messages d’état, appuyez sur une touche.If you don't see any status messages, press any key. Cela peut provoquer l’actualisation du contenu de la fenêtre de console.This can cause the contents of the console window to refresh.

    messages d’état de la fenêtre de console

    Lorsque l’image de base est totalement développée, passez à la section suivante.When the base image is fully expanded, move to the next section.

Créer un package d’applicationPackage an app

Pour créer votre package d'application, exécutez la commande DesktopAppConverter.exe dans la fenêtre de console qui s’est ouverte lorsque vous avez démarré Desktop App Converter.To Package your app, run the DesktopAppConverter.exe command in the console window that opened when you started the Desktop App Converter.

Vous allez spécifier le nom de package, l’éditeur et la version de l’application à l’aide des paramètres.You'll specify the package name, publisher and version number of the app by using parameters.

Note

Si vous avez réservé votre nom d’application dans le Store, vous pouvez obtenir le nom et l’éditeur du package à l’aide du tableau de bord du centre de développement de Windows.If you've reserved your app name in the Windows store, you can obtain the package and publisher names by using the Windows Dev Center dashboard. Si vous prévoyez de charger votre application de manière indépendante sur d’autres systèmes, vous pouvez fournir vos propres noms tant que le nom d’éditeur que vous choisissez correspond au nom indiqué sur le certificat utilisé pour signer votre application.If you plan to sideload your app onto other systems, you can provide your own names for these as long as the publisher name that you choose matches the name on the certificate you use to sign your app.

Aperçu des paramètres de commandeA quick look at command parameters

Voici les paramètres requis.Here are the required parameters.

DesktopAppConverter.exe
-Installer <String>
-Destination <String>
-PackageName <String>
-Publisher <String>
-Version <Version>

Vous pouvez en savoir plus sur chacun d’entre eux ici.You can read about each one here.

ExemplesExamples

Voici quelques méthodes courantes pour créer votre package d'application.Here's a few common ways to package your app.

Créer un package pour une application munie d’un programme d’installation (.msi)Package an app that has an installer (.msi) file

Pointez vers le fichier d’installation à l’aide du paramètre Installer.Point to the installer file by using the Installer parameter.

DesktopAppConverter.exe -Installer C:\Installer\MyAppSetup.msi -Destination C:\Output\MyApp -PackageName "MyApp" -Publisher "CN=MyPublisher" -Version 0.0.0.1

Important

Voici deux éléments important à prendre en considération ici.There are two important things to keep in mind here. Assurez-vous en premier lieu que votre programme d’installation se trouve dans un dossier indépendant et que seuls les fichiers associés à ce programme d’installation se trouvent dans le même dossier.First, make sure that your installer is located in an independent folder and that only files related to that installer are in the same folder. Le convertisseur copie l’intégralité du contenu de ce dossier vers l’environnement Windows isolé.The converter copies all of the contents of that folder to the isolated Windows environment.
Ensuite si le centre de développement attribue une identité commençant par un chiffre à votre package, veillez à également transmettre le paramètre -AppId et à utiliser uniquement le suffixe de la chaîne (après le point de séparation à en tant que valeur pour ce paramètre.Secondly, if the dev center assigns an identity to your package that begins with a number, make sure that you also pass in the -AppId parameter, and use only the string suffix (after the period separator) as the value of that parameter.

VidéoVideo

Si votre programme d'installation comprend des programmes d'installation pour les librairies ou infrastructures indépendantes, vous devrez vous organiser différemment.If your installer includes installers for dependent libraries or frameworks, you might have to organize things a bit a differently. Consultez Chaînage de plusieurs programmes d'installation avec le pont du bureau.See Chaining multiple installers with the Desktop Bridge.

Créer un package pour une application disposant d’un fichier d’installation exécutablePackage an app that has a setup executable file

Pointez vers l’exécutable d’installation à l’aide du paramètre Installer.Point to the setup executable by using the Installer parameter.

DesktopAppConverter.exe -Installer C:\Installer\MyAppSetup.exe -InstallerArguments "/S" -Destination C:\Output\MyApp -PackageName "MyApp" -Publisher "CN=MyPublisher" -Version 0.0.0.1

Important

Si le centre de développement attribue une identité commençant par un chiffre à votre package, veillez à également transmettre le paramètre -AppId et à utiliser uniquement le suffixe de la chaîne (après le point de séparation à en tant que valeur pour ce paramètre.If the dev center assigns an identity to your package that begins with a number, make sure that you also pass in the -AppId parameter, and use only the string suffix (after the period separator) as the value of that parameter.

Le paramètre InstallerArguments est facultatif.The InstallerArguments parameter is an optional parameter. Toutefois, étant donné que Desktop App Converter a besoin de votre programme d’installation pour s’exécuter en mode sans assistance, vous devrez peut-être l’utiliser si votre application a besoin d’indicateurs spécifiques pour s’exécuter en mode silencieux.However, because the Desktop App Converter needs your installer to run in unattended mode, you might have to use it if your app needs silent flags to run silently. L’indicateur /S est un indicateur de mode silencieux très courant, mais celui que vous utilisez peut être différent selon les technologies utilisées pour créer le fichier d’installation.The /S flag is a very common silent flag, but the flag that you use might be different depending on which installer technology you used to create the setup file.

VidéoVideo

Créer un package pour une application sans programme d’installationPackage an app that doesn't have an installer

Dans cet exemple, utilisez le paramètre Installer pour pointer vers le dossier racine des fichiers de votre application.In this example, use the Installer parameter to point to the root folder of your app files.

Utilisez le paramètre AppExecutable pour pointer vers le fichier exécutable de votre application.Use the AppExecutable parameter to point to your apps executable file.

DesktopAppConverter.exe -Installer C:\Installer\MyApp\ -AppExecutable MyApp.exe -Destination C:\Output\MyApp -PackageName "MyApp" -Publisher "CN=MyPublisher" -Version 0.0.0.1

Important

Si le centre de développement attribue une identité commençant par un chiffre à votre package, veillez à également transmettre le paramètre -AppId et à utiliser uniquement le suffixe de la chaîne (après le point de séparation à en tant que valeur pour ce paramètre.If the dev center assigns an identity to your package that begins with a number, make sure that you also pass in the -AppId parameter, and use only the string suffix (after the period separator) as the value of that parameter.

VidéoVideo

Créer un package d'application, signer l’application puis exécuter les vérifications de validation sur le packagePackage an app, sign the app, and run validation checks on the package

Cet exemple est similaire au premier, à ceci près qu’il montre comment signer votre application pour le test local, puis valider votre application en fonction des exigences du Pont du bureau et du MicrosoftStore.This example is similar to first one except it shows how you can sign your app for local testing, and then validate your app against Desktop Bridge and Microsoft Store requirements.

DesktopAppConverter.exe -Installer C:\Installer\MyAppSetup.exe -InstallerArguments "/S" -Destination C:\Output\MyApp -PackageName "MyApp" -Publisher "CN=MyPublisher" -Version 0.0.0.1 -MakeAppx -Sign -Verbose -Verify

Important

Si le centre de développement attribue une identité commençant par un chiffre à votre package, veillez à également transmettre le paramètre -AppId et à utiliser uniquement le suffixe de la chaîne (après le point de séparation à en tant que valeur pour ce paramètre.If the dev center assigns an identity to your package that begins with a number, make sure that you also pass in the -AppId parameter, and use only the string suffix (after the period separator) as the value of that parameter.

Le paramètre Sign génère un certificat dont il se sert ensuite pour signer votre application.The Sign parameter generates a certificate and then signs your app with it. Vous devrez installer ce certificat généré pour exécuter votre application.To run your app, you'll have to install that generated certificate. Pour savoir comment procéder, consultez la section Exécuter l’application empaquetée de ce guide.To learn how, see the Run the packaged app section of this guide.

Vous pouvez valider application à l’aide du paramètre Verify.You can validate you app by using the Verify parameter.

Aperçu des paramètres facultatifsA quick look at optional parameters

Les paramètres Sign et Verify sont facultatifs.The Sign and Verify parameters are optional. Il existe bien d’autres paramètres facultatifs.There are many more optional parameters. En voici quelques-uns parmi les plus couramment utilisés.Here are some of the more commonly used optional parameters.

[-ExpandedBaseImage <String>]
[-AppExecutable <String>]
[-AppFileTypes <String>]
[-AppId <String>]
[-AppDisplayName <String>]
[-AppDescription <String>]
[-PackageDisplayName <String>]
[-PackagePublisherDisplayName <String>]
[-MakeAppx]
[-LogFile <String>]
[<CommonParameters>]

Vous trouverez davantage de renseignements sur chacun d’eux dans la section suivante.You can read about all of them in the next section.

Références des paramètresParameter Reference

Voici la liste complète des paramètres (organisés par catégorie) que vous pouvez utiliser lorsque vous exécutez Desktop App Converter.Here's the complete list of parameters (organized by category) that you can use when you run the Desktop App Converter.

Vous pouvez également afficher la liste entière en exécutant la commande Get-Help dans la fenêtre de la console de l’application.You can also view the entire list by running the Get-Help command in the app console window.

Paramètres d’installationSetup parameters
-Setup [<SwitchParameter>]-Setup [<SwitchParameter>] RequisRequired Exécute DesktopAppConverter en mode installation.Runs DesktopAppConverter in setup mode. Le mode d’installation prend en charge le développement d’une image de base fournie.Setup mode supports expanding a provided base image.
-BaseImage <chaîne>-BaseImage <String> RequisRequired Chemin d’accès complet vers une image de base non développée.Full path to an unexpanded base image. Ce paramètre est obligatoire si -Setup est spécifié.This parameter is required if -Setup is specified.
-LogFile <chaîne>-LogFile <String> FacultatifOptional Spécifie un fichier journal.Specifies a log file. S’il est omis, un emplacement temporaire du fichier journal est créé.If omitted, a log file temporary location will be created.
-NatSubnetPrefix <chaîne>-NatSubnetPrefix <String> FacultatifOptional La valeur de préfixe à utiliser pour l’instance NAT.Prefix value to be used for the Nat instance. En règle générale, vous souhaiterez changer cela uniquement si votre ordinateur hôte est attaché à la même plage de sous-réseau que le NetNat du convertisseur.Typically, you would want to change this only if your host machine is attached to the same subnet range as the converter's NetNat. Vous pouvez interroger la configuration actuelle du convertisseur NetNat à l’aide de l’applet de commande Get-NetNat.You can query the current converter NetNat config by using the Get-NetNat cmdlet.
-NoRestart [<SwitchParameter>]-NoRestart [<SwitchParameter>] RequisRequired N’exécutez pas de commande de redémarrage lors de l’exécution du programme d’installation (le redémarrage est nécessaire pour activer la fonctionnalité de conteneur).Don't prompt for reboot when running setup (reboot is required to enable the container feature).
Paramètres de conversionConversion parameters
-AppInstallPath <chaîne>-AppInstallPath <String> FacultatifOptional Chemin d’accès complet au dossier racine de votre application pour les fichiers installés en cas d’installation (par exemple, «C:\Program Files (x86)\MyApp»).The full path to your application's root folder for the installed files if it were installed (e.g., "C:\Program Files (x86)\MyApp").
-Destination <chaîne>-Destination <String> RequisRequired La destination souhaitée pour la sortie d’appx du convertisseur: DesktopAppConverter peut créer cet emplacement s’il n’existe pas déjà.The desired destination for the converter's appx output - DesktopAppConverter can create this location if it doesn't already exist.
-Installer <chaîne>-Installer <String> RequisRequired Le chemin d’accès du programme d’installation de votre application doit être en mesure de s’exécuter sans assistance/silencieusement.The path to the installer for your application - must be able to run unattended/silently. Lors d’une conversion sans programme d’installation, il s’agit du chemin d’accès aux répertoires racine de vos fichiers d’application.No-installer conversion, this is the path to the root directory of your app files.
-InstallerArguments <chaîne>-InstallerArguments <String> FacultatifOptional Une liste séparée par des virgules ou une chaîne d’arguments pour forcer votre programme d’installation à s’exécuter sans assistance/silencieusement.A comma-separated list or string of arguments to force your installer to run unattended/silently. Ce paramètre est facultatif si votre programme d’installation est un fichier msi.This parameter is optional if your installer is an msi. Pour obtenir un fichier journal à partir de votre programme d’installation, indiquez ici l’argument de la journalisation pour le programme d’installation, et utilisez le chemin d’accès <log_folder>, qui est un jeton que le convertisseur remplace par le chemin d’accès approprié.To get a log from your installer, supply the logging argument for the installer here and use the path <log_folder>, which is a token that the converter replaces with the appropriate path.

REMARQUE: les indicateurs de mode sans assistance/silencieux et les arguments de journalisation varient selon les technologies d’installation.NOTE: The unattended/silent flags and log arguments will vary between installer technologies.

Exemple d’utilisation de ce paramètre: -InstallerArguments "/silent /log <log_folder>\install.log". Un autre exemple qui ne crée pas de fichier journal peut ressembler à ceci: -InstallerArguments "/quiet", "/norestart" là encore, vous devez littéralement diriger tous les journaux sur le chemin d’accès du jeton <log_folder> si vous voulez que le convertisseur les capture et les place dans un dossier des journaux finaux.An example usage for this parameter: -InstallerArguments "/silent /log <log_folder>\install.log" Another example that doesn't produce a log file may look like: -InstallerArguments "/quiet", "/norestart" Again, you must literally direct any logs to the token path <log_folder> if you want the converter to capture it and put it in the final log folder.
-InstallerValidExitCodes <Int32>-InstallerValidExitCodes <Int32> FacultatifOptional Une liste séparée par des virgules des codes de sortie qui indiquent que votre programme d’installation a été exécuté correctement (par exemple: 0, 1234, 5678).A comma-separated list of exit codes that indicate your installer ran successfully (for example: 0, 1234, 5678). Par défaut, le code est 0 pour les éléments non msi et 0, 1641, 3010 pour les éléments msi.By default this is 0 for non-msi, and 0, 1641, 3010 for msi.
Paramètres d’identité de packagePackage identity parameters
-PackageName <chaîne>-PackageName <String> RequisRequired Le nom de votre package d’application Windows universelle.The name of your Universal Windows App package. Si le centre de développement attribue une identité commençant par un chiffre à votre package, veillez à également transmettre le paramètre -AppId et à utiliser uniquement le suffixe de la chaîne (après le point de séparation à en tant que valeur pour ce paramètre.If the dev center assigns an identity to your package that begins with a number, make sure that you also pass in the -AppId parameter, and use only the string suffix (after the period separator) as the value of that parameter.
-Éditeur <chaîne>-Publisher <String> RequisRequired L’éditeur de votre package d’application Windows universelleThe publisher of your Universal Windows App package
-Version <Version>-Version <Version> RequisRequired Le numéro de version de votre package d’application Windows universelleThe version number for your Universal Windows App package
Paramètres de manifeste de packagePackage manifest parameters
-AppExecutable <chaîne>-AppExecutable <String> FacultatifOptional Nom de l’exécutable principal de votre application (par exemple, «MonApp.exe»).The name of your application's main executable (eg "MyApp.exe"). Ce paramètre est requis avec les conversions sans programme d’installation.This parameter is required for a no-installer conversion.
-AppFileTypes <chaîne>-AppFileTypes <String> FacultatifOptional Une liste séparée par des virgules des types de fichiers auxquels l’application sera associéeA comma-separated list of file types which the application will be associated with. Exemple d’utilisation: -AppFileTypes "'.md', '.markdown'".Example usage: -AppFileTypes "'.md', '.markdown'".
-AppId <chaîne>-AppId <String> FacultatifOptional Spécifie une valeur à partir de laquelle est définie l’ID d’application dans le manifeste du package d’application Windows.Specifies a value to set Application Id to in the Windows app package manifest. Si elle n’est pas spécifiée, elle sera définie en fonction de la valeur transmise pour PackageName.If it is not specified, it will be set to the value passed in for PackageName. Dans de nombreux cas, l'utilisation de PackageName convient.In many cases, using the PackageName is fine. Toutefois, si le centre de développement attribue une identité commençant par un chiffre à votre package, veillez à également transmettre le paramètre -AppId et à utiliser uniquement le suffixe de la chaîne (après le point de séparation à en tant que valeur pour ce paramètre.However, if the dev center assigns an identity to your package that begins with a number, make sure that you also pass in the -AppId parameter, and use only the string suffix (after the period separator) as the value of that parameter.
-AppDisplayName <chaîne>-AppDisplayName <String> FacultatifOptional Spécifie une valeur à partir de laquelle est défini le nom complet de l’application dans le manifeste du package d’application Windows.Specifies a value to set Application Display Name to in the Windows app package manifest. Si elle n’est pas spécifiée, elle sera définie en fonction de la valeur transmise pour PackageName.If it is not specified, it will be set to the value passed in for PackageName.
-AppDescription <chaîne>-AppDescription <String> FacultatifOptional Spécifie une valeur à partir de laquelle est définie la description d’application dans le manifeste du package d’application Windows.Specifies a value to set Application Description to in the Windows app package manifest. Si elle n’est pas spécifiée, elle sera définie en fonction de la valeur transmise pour PackageName.If it is not specified, it will be set to the value passed in for PackageName.
-PackageDisplayName <chaîne>-PackageDisplayName <String> FacultatifOptional Spécifie une valeur à partir de laquelle est défini le nom complet du package dans le manifeste du package d’application Windows.Specifies a value to set Package Display Name to in the Windows app package manifest. Si elle n’est pas spécifiée, elle sera définie en fonction de la valeur transmise pour PackageName.If it is not specified, it will be set to the value passed in for PackageName.
-PackagePublisherDisplayName <chaîne>-PackagePublisherDisplayName <String> FacultatifOptional Spécifie une valeur à partir de laquelle est défini le nom complet de l’éditeur du package dans le manifeste du package d’application Windows.Specifies a value to set Package Publisher Display Name to in the Windows app package manifest. Si elle n’est pas spécifiée, elle sera définie en fonction de la valeur transmise pour Publisher.If it is not specified, it will be set to the value passed in for Publisher.
Paramètres de nettoyageCleanup parameters
-Cleanup [<Option>]-Cleanup [<Option>] RequisRequired Exécute le nettoyage pour les artefacts DesktopAppConverter.Runs cleanup for the DesktopAppConverter artifacts. Trois options sont valides pour le mode de nettoyage.There are 3 valid options for the Cleanup mode.
-Cleanup All (nettoyer tout)-Cleanup All Supprime toutes les images de base développées, supprime les fichiers de conversion temporaires, supprime le réseau de conteneurs et désactive la fonctionnalité Windows facultative, conteneurs.Deletes all expanded base images, removes any temporary converter files, removes the container network, and disables the optional Windows feature, Containers.
-Cleanup WorkDirectory (nettoyer le répertoire de travail)-Cleanup WorkDirectory RequisRequired Supprime tous les fichiers de conversion temporaires.Removes all the temporary converter files.
-Cleanup ExpandedImage (nettoyage images développées)-Cleanup ExpandedImage RequisRequired Supprime toutes les images développées de base installées sur votre ordinateur hôte.Deletes all the expanded base images installed on your host machine.
Paramètres d’architecture de packagePackage architecture parameters
-PackageArch <chaîne>-PackageArch <String> RequisRequired Génère un package selon l’architecture spécifiée.Generates a package with the specified architecture. Les options valides sont «x86» ou «x64»; par exemple, -PackageArch x86.Valid options are 'x86' or 'x64'; for example, -PackageArch x86. Ce paramètre est facultatif.This parameter is optional. Si ce paramètre n’est pas spécifié, le Convertisseur d’applications de bureau essaie de détecter automatiquement l’architecture du package.If unspecified, the DesktopAppConverter will try to auto-detect package architecture. Si la détection automatique échoue, le convertisseur choisit par défaut l’architecturex64.If auto-detection fails, it will default to x64 package.
Paramètres diversMiscellaneous parameters
-ExpandedBaseImage <chaîne>-ExpandedBaseImage <String> FacultatifOptional Chemin d’accès complet vers une image de base déjà développée.Full path to an already expanded base image.
-MakeAppx [<SwitchParameter>]-MakeAppx [<SwitchParameter>] FacultatifOptional Un commutateur qui, lorsqu’il est présent, indique à ce script d’appeler MakeAppx sur la sortie.A switch that, when present, tells this script to call MakeAppx on the output.
-LogFile <chaîne>-LogFile <String> FacultatifOptional Spécifie un fichier journal.Specifies a log file. S’il est omis, un emplacement temporaire du fichier journal est créé.If omitted, a log file temporary location will be created.
-Sign [<SwitchParameter>]-Sign [<SwitchParameter>] FacultatifOptional Indique à ce script qu’il doit signer le package d’application Windows produit à l’aide d’un certificat généré à des fins de test.Tells this script to sign the output Windows app package by using a generated certificate for testing purposes. Ce commutateur doit être présent en même temps que le commutateur -MakeAppx.This switch should be present alongside the switch -MakeAppx.
<Paramètres communs><Common parameters> RequisRequired Cette applet de commande prend en charge les paramètres courants: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable et OutVariable.This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. Pour plus d’informations, consultez about_CommonParameters.For more info, see about_CommonParameters.
-Verify [<SwitchParameter>]-Verify [<SwitchParameter>] FacultatifOptional Un commutateur qui, lorsqu’il est présent, indique à l’outil DAC de vérifier que le package d’application satisfait les exigences du Pont du bureau et du MicrosoftStore.A switch that, when present, tells the DAC to validate the app package against Desktop Bridge and Microsoft Store requirements. Le résultat obtenu est un rapport de validation «VerifyReport.xml», qui s’affiche de manière plus efficace dans un navigateur.The result is a validation report "VerifyReport.xml", which is best visualized in a browser. Ce commutateur doit être présent en même temps que le commutateur -MakeAppx.This switch should be present alongside the switch -MakeAppx.
-PublishComRegistrations-PublishComRegistrations FacultatifOptional Analyse toutes les inscriptions COM publiques effectuées par votre programme d’installation et publie celles qui sont valides dans votre manifeste.Scans all public COM registrations made by your installer and publishes the valid ones in your manifest. Utilisez cet indicateur seulement si vous souhaitez rendre ces enregistrements accessibles à d’autres applications.Use this flag only if you want to make these registrations available to other applications. Il n’est pas nécessaire d’employer cet indicateur si ces enregistrements ne doivent être utilisés que par votre application.You don't need to use this flag if these registrations will be used only by your application.

Consultez cet article pour vous assurer que vos inscriptions COM fonctionnent comme prévu après la création du package de votre application.Review this article to make sure that your COM registrations behave as you expect after you package your app.

Exécuter l’application empaquetéeRun the packaged app

Il existe deux façons d’exécuter votre application.There's two ways to run your app.

L’une d’elles consiste à ouvrir une invite de commandes PowerShell pour saisir la commande suivante: Add-AppxPackage –Register AppxManifest.xml.One way is to open a PowerShell command prompt, and then type this command: Add-AppxPackage –Register AppxManifest.xml. Il s’agit probablement du moyen le plus simple d’exécuter votre application, car vous n’êtes pas obligé de la signer.It's probably the easiest way to run your app because you don't have to sign it.

L’autre méthode consiste à signer votre application avec un certificat.Another way is to sign your app with a certificate. Si vous utilisez le paramètre sign, Desktop App Converter en génère un pour vous et signe votre application avec ce certificat.If you use the sign parameter, the Desktop App Converter will generate one for you, and then sign your app with it. Ce fichier est nommé auto-generated.cer, et vous pouvez le trouver dans le dossier racine de votre application empaquetée.That file is named auto-generated.cer, and you can find it in the root folder of your packaged app.

Suivez ces étapes pour installer le certificat généré, puis exécutez votre application.Follow these steps to install the generated certificate, and then run your app.

  1. Double-cliquez sur le fichier auto-generated.cer pour installer le certificat.Double-click the auto-generated.cer file to install the certificate.

    fichier de certificat généré

    Note

    Si vous êtes invité à saisir un mot de passe, utilisez le mot de passe par défaut «123456».If you're prompted for a password, use the default password "123456".

  2. Dans la boîte de dialogue Certificat, choisissez le bouton Installer un certificat.In the Certificate dialog box, choose the Install Certificate button.

  3. Dans l’Assistant Importation du certificat, installez ce dernier sur la Machine locale et placez-le dans le magasin de certificats Personnes autorisées.In the Certificate Import Wizard, install the certificate onto the Local Machine, and place the certificate into the Trusted People certificate store.

    Magasin Personnes autorisées

  4. Dans le dossier racine de votre application empaquetée, double-cliquez sur le fichier de package d’application Windows.In root folder of your packaged app, double click the Windows app package file.

    Fichier de package d’application Windows

  5. Installez l’application en sélectionnant le bouton Installer.Install the app, by choosing the Install button.

    Bouton Installer

Modifier l’application empaquetéeModify the packaged app

Vous allez probablement apporter des modifications à votre application empaquetée pour corriger des bogues, ajouter les ressources visuelles ou améliorer votre application avec des expériences modernes telles que les vignettes dynamiques.You'll likely make changes to your packaged app to address bugs, add visual assets, or enhance your app with modern experiences such as live tiles.

Une fois vos modifications accomplies, il n’est pas nécessaire d’effectuer une nouvelle conversion.After you make your changes, you don't need to run the converter again. Dans la plupart des cas, vous pouvez simplement repackager votre application à l’aide de l’outil MakeAppx et du fichier appxmanifest.xml généré par DAC pour votre application.In most cases, you can just repackage your app by using the MakeAppx tool and the appxmanifest.xml file the DAC generates for your app. Voir Générer un package d’application Windows.See Generate a Windows app package.

Note

Si vous modifiez les paramètres de registre inscrits par votre programme d’installation, vous devrez exécuter une nouvelle fois Desktop App Converter afin de récupérer ces modifications.If you make changes to registry settings that your installer makes, you will have to run the Desktop App Converter again to pick up those changes.

VidéosVideos

Modifier et générer un nouveau packageModify and repackage output Démo: modifier et générer un nouveau packageDemo: Modify and repackage output

Les deux sections suivantes décrivent quelques corrections facultatives que vous pouvez envisager pour l’application empaquetée.The following two sections describe a couple of optional fix-ups to the packaged app that you might consider.

Supprimez les fichiers et les clés de registre inutilesDelete unnecessary files and registry keys

Desktop App Converter utilise une approche très classique pour le filtrage des fichiers et du bruit système dans le conteneur.The desktop App Converter takes a very conservative approach to filtering out files and system noise in the container.

Si vous le souhaitez, vous pouvez inspecter le dossier VFS et supprimer les fichiers dont votre programme d’installation n’a pas besoin.If you want, you can review the VFS folder and delete any files that your installer doesn't need. Vous pouvez également examiner le contenu de Reg.dat et supprimer les clés qui ne sont pas installées/utilisées par l’application.You can also review the contents of Reg.dat and delete any keys that are not installed/needed by the app.

Réparer les en-têtes PE endommagésFix corrupted PE headers

Au cours du processus de conversion, DesktopAppConverter exécute automatiquement l’outil PEHeaderCertFixTool pour corriger tous les en-têtes PE endommagés.During the conversion process, the DesktopAppConverter automatically runs the PEHeaderCertFixTool to fixup any corrupted PE headers. Toutefois, vous pouvez également exécuter PEHeaderCertFixTool sur un package d’application Windows UWP, des fichiers libres ou un fichier binaire spécifique.However, you can also run the PEHeaderCertFixTool on a UWP Windows app package, loose files, or a specific binary. En voici un exemple.Here's an example.

PEHeaderCertFixTool.exe <binary file>|<.appx package>|<folder> [/c] [/v]
 /c   -- check for corrupted certificate but do not fix (optional)
 /v   -- verbose (optional)
example1: PEHeaderCertFixTool app.exe
example2: PEHeaderCertFixTool c:\package.appx /c
example3: PEHeaderCertFixTool c:\myapp /c /v

Télémétrie de Desktop App ConverterTelemetry from Desktop App Converter

Le Convertisseur d’applications de bureau peut collecter des informations sur vous et votre utilisation du logiciel et les envoyer à Microsoft.Desktop App Converter may collect information about you and your use of the software and send this info to Microsoft. Vous pouvez en savoir plus sur la collecte et l’utilisation de données de Microsoft dans la documentation des produits et dans la Déclaration de confidentialité Microsoft.You can learn more about Microsoft's data collection and use in the product documentation and in the Microsoft Privacy Statement. Vous acceptez de respecter toutes les dispositions applicables de la Déclaration de confidentialité de Microsoft.You agree to comply with all applicable provisions of the Microsoft Privacy Statement.

Par défaut, la télémétrie est activée pour le Convertisseur d’applications de bureau.By default, telemetry will be enabled for the Desktop App Converter. Ajoutez la clé de Registre suivante pour configurer la télémétrie selon un paramètre de votre choix:Add the following registry key to configure telemetry to a desired setting:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\DesktopAppConverter
  • Ajoutez ou modifiez la valeur DisableTelemetry à l’aide d’une valeur DWORD définie sur1.Add or edit the DisableTelemetry value by using a DWORD set to 1.
  • Pour activer la télémétrie, supprimez la clé ou définissez la valeur sur 0.To enable telemetry, remove the key or set the value to 0.

Prise en charge linguistiqueLanguage support

Desktop App Converter ne prend pas en charge Unicode. Par conséquent, aucun caractère chinois ou caractère nonASCII ne peut être utilisé avec l’outil.The Desktop App Converter does not support Unicode; thus, no Chinese characters or non-ASCII characters can be used with the tool.

Étapes suivantesNext steps

Trouvez des réponses à vos questionsFind answers to your questions

Des questions?Have questions? Contactez-nous sur Stack Overflow.Ask us on Stack Overflow. Notre équipe contrôle ces balises.Our team monitors these tags. Vous pouvez également nous poser vos questions ici.You can also ask us here.

Vous pouvez également vous référer à cette liste des problèmes connus.You can also refer to this list of known issues.

Transmettre des commentaires ou suggérer des fonctionnalitésGive feedback or make feature suggestions

Consultez UserVoice.See UserVoice.

Exécutez votre application/recherchez et réparez les problèmesRun your app / find and fix issues

Voir Exécuter, déboguer et tester une application de bureau empaquetée (Pont du bureau)See Run, debug, and test a packaged desktop app (Desktop Bridge)

Distribuer votre applicationDistribute your app

Consultez Distribuer une application de bureau empaquetée (Pont du bureau)See Distribute a packaged desktop app (Desktop Bridge)