Procédure pas à pas : déployer manuellement une application ClickOnceWalkthrough: Manually deploy a ClickOnce application

Si vous ne pouvez pas utiliser Visual Studio pour déployer votre application ClickOnceClickOnce, ou si vous devez utiliser des fonctionnalités de déploiement avancées, telles que le déploiement d’applications approuvées, vous devez utiliser l’outil en ligne de commande Mage. exe pour créer vos manifestes de ClickOnceClickOnce.If you cannot use Visual Studio to deploy your ClickOnceClickOnce application, or you need to use advanced deployment features, such as Trusted Application Deployment, you should use the Mage.exe command-line tool to create your ClickOnceClickOnce manifests. Cette procédure pas à pas décrit comment créer un déploiement de ClickOnceClickOnce à l’aide de la version de ligne de commande (Mage. exe) ou de la version graphique (MageUI. exe) du outil Manifest Generation and Editing.This walkthrough describes how to create a ClickOnceClickOnce deployment by using either the command-line version (Mage.exe) or the graphical version (MageUI.exe) of the Manifest Generation and Editing Tool.

Configuration requisePrerequisites

Cette procédure pas à pas contient des conditions préalables et des options que vous devez choisir avant de créer un déploiement.This walkthrough has some prerequisites and options that you need to choose before building a deployment.

  • Installez Mage. exe et MageUI. exe.Install Mage.exe and MageUI.exe.

    Mage. exe et MageUI. exe font partie du Kit de développement logiciel WindowsWindows Software Development Kit (SDK).Mage.exe and MageUI.exe are part of the Kit de développement logiciel WindowsWindows Software Development Kit (SDK). Vous devez avoir le SDK WindowsWindows SDK installé ou la version du SDK WindowsWindows SDK inclus dans Visual Studio.You must either have the SDK WindowsWindows SDK installed or the version of the SDK WindowsWindows SDK included with Visual Studio. Pour plus d’informations, consultez SDK Windows sur MSDN.For more information, see Windows SDK on MSDN.

  • Fournissez une application à déployer.Provide an application to deploy.

    Cette procédure pas à pas suppose que vous disposez d’une application Windows que vous êtes prêt à déployer.This walkthrough assumes that you have a Windows application that you are ready to deploy. Cette application sera appelée AppToDeploy.This application will be referred to as AppToDeploy.

  • Déterminez la façon dont le déploiement sera distribué.Determine how the deployment will be distributed.

    Les options de distribution sont les suivantes : Web, partage de fichiers ou CD.The distribution options include: Web, file share, or CD. Pour plus d'informations, consultez ClickOnce Security and Deployment.For more information, see ClickOnce Security and Deployment.

  • Déterminez si l’application requiert un niveau élevé de confiance.Determine whether the application requires an elevated level of trust.

    Si votre application nécessite un niveau de confiance totale (par exemple, un accès complet au système de l’utilisateur), vous pouvez utiliser l’option -TrustLevel de Mage. exe pour la définir.If your application requires Full Trust—for example, full access to the user's system—you can use the -TrustLevel option of Mage.exe to set this. Si vous souhaitez définir un jeu d’autorisations personnalisé pour votre application, vous pouvez copier la section d’autorisation Internet ou intranet d’un autre manifeste, la modifier en fonction de vos besoins, puis l’ajouter au manifeste d’application à l’aide d’un éditeur de texte ou de MageUI. exe.If you want to define a custom permission set for your application, you can copy the Internet or intranet permission section from another manifest, modify it to suit your needs, and add it to the application manifest using either a text editor or MageUI.exe. Pour plus d’informations, consultez Vue d’ensemble du déploiement d’applications approuvées.For more information, see Trusted Application Deployment overview.

  • Obtenez un certificat Authenticode.Obtain an Authenticode certificate.

    Vous devez signer votre déploiement avec un certificat Authenticode.You should sign your deployment with an Authenticode certificate. Vous pouvez générer un certificat de test à l’aide des outils Visual Studio, MageUI. exeou Makecert. exe et Pvk2Pfx. exe , ou vous pouvez obtenir un certificat auprès d’une autorité de certification.You can generate a test certificate by using Visual Studio, MageUI.exe, or MakeCert.exe and Pvk2Pfx.exe tools, or you can obtain a certificate from a Certificate Authority (CA). Si vous choisissez d’utiliser le déploiement d’applications approuvées, vous devez également effectuer une installation unique du certificat sur tous les ordinateurs clients.If you choose to use Trusted Application Deployment, you must also perform a one-time installation of the certificate onto all client computers. Pour plus d'informations, consultez Trusted Application Deployment Overview.For more information, see Trusted Application Deployment Overview.

    Note

    Vous pouvez également signer votre déploiement avec un certificat CNG que vous pouvez obtenir auprès d’une autorité de certification.You can also sign your deployment with a CNG certificate that you can obtain from a Certificate Authority.

  • Assurez-vous que l’application n’a pas de manifeste avec les informations de contrôle de compte d’utilisateur.Make sure that the application does not have a manifest with UAC information.

    Vous devez déterminer si votre application contient un manifeste avec des informations de contrôle de compte d’utilisateur (UAC, User Account Control), telles qu’un élément <dependentAssembly>.You need to determine whether your application contains a manifest with User Account Control (UAC) information, such as an <dependentAssembly> element. Pour examiner un manifeste d’application, vous pouvez utiliser l’utilitaire sigcheck de Windows Sysinternals.To examine an application manifest, you can use the Windows Sysinternals Sigcheck utility.

    Si votre application contient un manifeste avec les détails du contrôle de compte d’utilisateur, vous devez la regénérer sans les informations de contrôle de compte d’utilisateur.If your application contains a manifest with UAC details, you must re-build it without the UAC information. Pour un C# projet dans Visual Studio, ouvrez les propriétés du projet, puis sélectionnez l’onglet application. Dans la liste déroulante manifeste , sélectionnez créer une application sans manifeste.For a C# project in Visual Studio, open the project properties and select the Application tab. In the Manifest drop-down list, select Create application without a manifest. Pour un projet de Visual Basic dans Visual Studio, ouvrez les propriétés du projet, sélectionnez l’onglet application, puis cliquez sur afficher les paramètres du contrôle de compte d’utilisateur.For a Visual Basic project in Visual Studio, open the project properties, select the Application tab, and click View UAC Settings. Dans le fichier manifeste ouvert, supprimez tous les éléments dans l’élément <asmv1:assembly> unique.In the opened manifest file, remove all elements within the single <asmv1:assembly> element.

  • Déterminez si l’application requiert des conditions préalables sur l’ordinateur client.Determine whether the application requires prerequisites on the client computer.

    ClickOnceClickOnce applications déployées à partir de Visual Studio peuvent inclure un programme d’amorçage d’installation de prérequis (Setup. exe) avec votre déploiement.applications deployed from Visual Studio can include a prerequisite installation bootstrapper (setup.exe) with your deployment. Cette procédure pas à pas crée les deux manifestes requis pour un déploiement de ClickOnceClickOnce.This walkthrough creates the two manifests required for a ClickOnceClickOnce deployment. Vous pouvez créer un programme d’amorçage requis à l’aide de la tâche GenerateBootstrapper,.You can create a prerequisite bootstrapper by using the GenerateBootstrapper task.

Pour déployer une application à l’aide de l’outil en ligne de commande Mage. exeTo deploy an application with the Mage.exe command-line tool

  1. Créez un répertoire dans lequel vous allez stocker vos fichiers de déploiement ClickOnceClickOnce.Create a directory where you will store your ClickOnceClickOnce deployment files.

  2. Dans le répertoire de déploiement que vous venez de créer, créez un sous-répertoire de version.In the deployment directory you just created, create a version subdirectory. S’il s’agit de la première fois que vous déployez l’application, nommez le sous-répertoire version 1.0.0.0.If this is the first time that you are deploying the application, name the version subdirectory 1.0.0.0.

    Note

    La version de votre déploiement peut être différente de la version de votre application.The version of your deployment can be distinct from the version of your application.

  3. Copiez tous les fichiers de votre application dans le sous-répertoire version, y compris les fichiers exécutables, les assemblys, les ressources et les fichiers de données.Copy all of your application files to the version subdirectory, including executable files, assemblies, resources, and data files. Si nécessaire, vous pouvez créer des sous-répertoires supplémentaires qui contiennent des fichiers supplémentaires.If necessary, you can create additional subdirectories that contain additional files.

  4. Ouvrez la SDK WindowsWindows SDK ou l’invite de commandes Visual Studio et accédez au sous-répertoire version.Open the SDK WindowsWindows SDK or Visual Studio command prompt and change to the version subdirectory.

  5. Créez le manifeste d’application avec un appel à Mage. exe.Create the application manifest with a call to Mage.exe. L’instruction suivante crée un manifeste d’application pour le code compilé pour s’exécuter sur le processeur Intel x86.The following statement creates an application manifest for code compiled to run on the Intel x86 processor.

    mage -New Application -Processor x86 -ToFile AppToDeploy.exe.manifest -name "My App" -Version 1.0.0.0 -FromDirectory .
    

    Note

    Veillez à inclure le point (.) après l’option -FromDirectory, qui indique le répertoire actif.Be sure to include the dot (.) after the -FromDirectory option, which indicates the current directory. Si vous n’incluez pas le point, vous devez spécifier le chemin d’accès à vos fichiers d’application.If you do not include the dot, you must specify the path to your application files.

  6. Signez le manifeste de l’application avec votre certificat Authenticode.Sign the application manifest with your Authenticode certificate. Remplacez myCert. pfx par le chemin d’accès à votre fichier de certificat.Replace mycert.pfx with the path to your certificate file. Remplacez passwd par le mot de passe de votre fichier de certificat.Replace passwd with the password for your certificate file.

    mage -Sign AppToDeploy.exe.manifest -CertFile mycert.pfx -Password passwd
    

    À partir du kit de développement logiciel (SDK) .NET Framework 4.6.2, qui est distribué avec Visual Studio et avec le SDK Windows, Mage. exe signe les manifestes avec CNG et les certificats Authenticode.Starting with the .NET Framework 4.6.2 SDK, which is distributed with Visual Studio and with the Windows SDK, mage.exe signs manifests with CNG as well as with Authenticode certificates. Utilisez les mêmes paramètres de ligne de commande que les certificats Authenticode.Use the same command line parameters as with Authenticode certificates.

  7. Accédez à la racine du répertoire de déploiement.Change to the root of the deployment directory.

  8. Générez le manifeste de déploiement à l’aide d’un appel à Mage. exe.Generate the deployment manifest with a call to Mage.exe. Par défaut, Mage. exe marque votre déploiement ClickOnceClickOnce comme une application installée, afin qu’il puisse être exécuté à la fois en ligne et hors connexion.By default, Mage.exe will mark your ClickOnceClickOnce deployment as an installed application, so that it can be run both online and offline. Pour rendre l’application disponible uniquement lorsque l’utilisateur est en ligne, utilisez l’option -Install avec la valeur false.To make the application available only when the user is online, use the -Install option with a value of false. Si vous utilisez la valeur par défaut et que les utilisateurs installent votre application à partir d’un site Web ou d’un partage de fichiers, assurez-vous que la valeur de l’option -ProviderUrl pointe vers l’emplacement du manifeste d’application sur le serveur Web ou le partage.If you use the default, and users will install your application from a Web site or file share, make sure that the value of the -ProviderUrl option points to the location of the application manifest on the Web server or share.

    mage -New Deployment -Processor x86 -Install true -Publisher "My Co." -ProviderUrl "\\myServer\myShare\AppToDeploy.application" -AppManifest 1.0.0.0\AppToDeploy.exe.manifest -ToFile AppToDeploy.application
    
  9. Signez le manifeste de déploiement avec votre certificat Authenticode ou CNG.Sign the deployment manifest with your Authenticode or CNG certificate.

    mage -Sign AppToDeploy.application -CertFile mycert.pfx -Password passwd
    
  10. Copiez tous les fichiers du répertoire de déploiement vers la destination ou le support de déploiement.Copy all of the files in the deployment directory to the deployment destination or media. Il peut s’agir d’un dossier sur un site Web ou FTP, d’un partage de fichiers ou d’un CD-ROM.This may be either a folder on a Web site or FTP site, a file share, or a CD-ROM.

  11. Fournissez à vos utilisateurs l’URL, le chemin UNC ou le support physique requis pour installer votre application.Provide your users with the URL, UNC, or physical media required to install your application. Si vous fournissez une URL ou un UNC, vous devez donner à vos utilisateurs le chemin d’accès complet au manifeste de déploiement.If you provide a URL or a UNC, you must give your users the full path to the deployment manifest. Par exemple, si AppToDeploy est déployée sur http://webserver01/ dans le répertoire AppToDeploy, le chemin d’accès complet à l’URL est http://webserver01/AppToDeploy/AppToDeploy.application.For example, if AppToDeploy is deployed to http://webserver01/ in the AppToDeploy directory, the full URL path would be http://webserver01/AppToDeploy/AppToDeploy.application.

Pour déployer une application avec l’outil graphique MageUI. exeTo deploy an application with the MageUI.exe graphical tool

  1. Créez un répertoire dans lequel vous allez stocker vos fichiers de déploiement ClickOnceClickOnce.Create a directory where you will store your ClickOnceClickOnce deployment files.

  2. Dans le répertoire de déploiement que vous venez de créer, créez un sous-répertoire de version.In the deployment directory you just created, create a version subdirectory. S’il s’agit de la première fois que vous déployez l’application, nommez le sous-répertoire version 1.0.0.0.If this is the first time that you are deploying the application, name the version subdirectory 1.0.0.0.

    Note

    La version de votre déploiement est probablement différente de la version de votre application.The version of your deployment is probably distinct from the version of your application.

  3. Copiez tous les fichiers de votre application dans le sous-répertoire version, y compris les fichiers exécutables, les assemblys, les ressources et les fichiers de données.Copy all of your application files to the version subdirectory, including executable files, assemblies, resources, and data files. Si nécessaire, vous pouvez créer des sous-répertoires supplémentaires qui contiennent des fichiers supplémentaires.If necessary, you can create additional subdirectories that contain additional files.

  4. Démarrez l’outil graphique MageUI. exe .Start the MageUI.exe graphical tool.

    MageUI.exe
    
  5. Créez un nouveau manifeste d’application en sélectionnant fichier, nouveau, manifeste d’application dans le menu.Create a new application manifest by selecting File, New, Application Manifest from the menu.

  6. Sous l’onglet nom par défaut, tapez le nom et le numéro de version de ce déploiement.On the default Name tab, type the name and version number of this deployment. Spécifiez également le processeur pour lequel votre application est générée, par exemple x86.Also specify the Processor that your application is built for, such as x86.

  7. Sélectionnez l’onglet fichiers , puis cliquez sur le bouton de sélection ( ... ) en regard de la zone de texte Répertoire de l' application .Select the Files tab and click the ellipsis (...) button next to the Application directory text box. La boîte de dialogue Rechercher un dossier s’affiche.A Browse For Folder dialog box appears.

  8. Sélectionnez le sous-répertoire version contenant les fichiers de votre application, puis cliquez sur OK.Select the version subdirectory containing your application files, and then click OK.

  9. Si vous déployez à partir de Internet Information Services (IIS), activez la case à cocher lors du remplissage de l’extension. deploy dans un fichier qui n’en possède pas .If you will deploy from Internet Information Services (IIS), select the When populating add the .deploy extension to any file that does not have it check box.

  10. Cliquez sur le bouton Populate pour ajouter tous les fichiers de votre application à la liste des fichiers.Click the Populate button to add all your application files to the file list. Si votre application contient plusieurs fichiers exécutables, marquez le fichier exécutable principal de ce déploiement en tant qu’application de démarrage en sélectionnant point d’entrée dans la liste déroulante type de fichier .If your application contains more than one executable file, mark the main executable file for this deployment as the startup application by selecting Entry Point from the File Type drop-down list. (Si votre application contient un seul fichier exécutable, MageUI. exe la marque pour vous.)(If your application contains only one executable file, MageUI.exe will mark it for you.)

  11. Sélectionnez l’onglet autorisations requises et sélectionnez le niveau de confiance que votre application doit déclarer.Select the Permissions Required tab and select the level of trust that you need your application to assert. La valeur par défaut est FullTrust, ce qui convient à la plupart des applications.The default is FullTrust, which will be suitable for most applications.

  12. Sélectionnez fichier, Enregistrer sous dans le menu.Select File, Save As from the menu. Une boîte de dialogue Options de signature s’affiche pour vous inviter à signer le manifeste de l’application.A Signing Options dialog box appears prompting you to sign the application manifest.

  13. Si vous avez un certificat stocké en tant que fichier sur votre système de fichiers, utilisez l’option signer avec le fichier de certificat , puis sélectionnez le certificat dans le système de fichiers à l’aide du bouton de sélection ( ... ).If you have a certificate stored as a file on your file system, use the Sign with certificate file option, and select the certificate from the file system by using the ellipsis (...) button. Tapez ensuite votre mot de passe de certificat.Then type your certificate password.

    ou-or-

    Si votre certificat est conservé dans un magasin de certificats accessible à partir de votre ordinateur, sélectionnez l’option signer avec le certificat stocké , puis sélectionnez le certificat dans la liste fournie.If your certificate is kept in a certificate store accessible from your computer, select the Sign with stored certificate option, and select the certificate from the provided list.

  14. Cliquez sur OK pour signer le manifeste de votre application.Click OK to sign your application manifest. La boîte de dialogue Enregistrer sous s’affiche.The Save As dialog box appears.

  15. Dans la boîte de dialogue Enregistrer sous , spécifiez le répertoire de la version, puis cliquez sur Enregistrer.In the Save As dialog box, specify the version directory, and then click Save.

  16. Sélectionnez fichier, nouveau, manifeste de déploiement dans le menu pour créer votre manifeste de déploiement.Select File, New, Deployment Manifest from the menu to create your deployment manifest.

  17. Sous l’onglet nom , spécifiez un nom et un numéro de version pour ce déploiement (1.0.0.0 dans cet exemple).On the Name tab, specify a name and version number for this deployment (1.0.0.0 in this example). Spécifiez également le processeur pour lequel votre application est générée, par exemple x86.Also specify the Processor that your application is built for, such as x86.

  18. Sélectionnez l’onglet Description , puis spécifiez des valeurs pour le serveur de publication et le produit.Select the Description tab, and specify values for Publisher and Product. (Product est le nom donné à votre application dans le menu Démarrer de Windows lorsque votre application s’installe sur un ordinateur client pour une utilisation hors connexion).(Product is the name given to your application on the Windows Start menu when your application installs on a client computer for offline use.)

  19. Sélectionnez l’onglet options de déploiement , puis dans la zone de texte emplacement de départ , spécifiez l’emplacement du manifeste d’application sur le serveur Web ou le partage.Select the Deployment Options tab, and in the Start Location text box, specify the location of the application manifest on the Web server or share. Par exemple, \\myServer\myShare\AppToDeploy.application.For example, \\myServer\myShare\AppToDeploy.application.

  20. Si vous avez ajouté l’extension . deploy à une étape précédente, sélectionnez également utiliser l’extension de nom de fichier. deploy ici.If you added the .deploy extension in a previous step, also select Use .deploy file name extension here.

  21. Sélectionnez l’onglet options de mise à jour , puis spécifiez la fréquence à laquelle vous souhaitez que cette application soit mise à jour.Select the Update Options tab, and specify how often you would like this application to update. Si votre application utilise UpdateCheckInfo pour rechercher des mises à jour, désactivez la case à cocher cette application doit vérifier les mises à jour .If your application uses UpdateCheckInfo to check for updates itself, clear the This application should check for updates check box.

  22. Sélectionnez l’onglet Référence de l' application , puis cliquez sur le bouton Sélectionner le manifeste .Select the Application Reference tab and then click the Select Manifest button. Une boîte de dialogue Ouvrir s’affiche.An open dialog box appears.

  23. Sélectionnez le manifeste d’application que vous avez créé précédemment, puis cliquez sur ouvrir.Select the application manifest that you created earlier and then click Open.

  24. Sélectionnez fichier, Enregistrer sous dans le menu.Select File, Save As from the menu. Une boîte de dialogue options de signature s’affiche pour vous inviter à signer le manifeste de déploiement.A Signing Options dialog box appears prompting you to sign the deployment manifest.

  25. Si vous avez un certificat stocké en tant que fichier sur votre système de fichiers, utilisez l’option signer avec le fichier de certificat , puis sélectionnez le certificat dans le système de fichiers à l’aide du bouton de sélection ( ... ).If you have a certificate stored as a file on your file system, use the Sign with certificate file option, and select the certificate from the file system by using the ellipsis (...) button. Tapez ensuite votre mot de passe de certificat.Then type your certificate password.

    ou-or-

    Si votre certificat est conservé dans un magasin de certificats accessible à partir de votre ordinateur, sélectionnez l’option signer avec le certificat stocké , puis sélectionnez le certificat dans la liste fournie.If your certificate is kept in a certificate store accessible from your computer, select the Sign with stored certificate option, and select the certificate from the provided list.

  26. Cliquez sur OK pour signer votre manifeste de déploiement.Click OK to sign your deployment manifest. La boîte de dialogue Enregistrer sous s’affiche.The Save As dialog box appears.

  27. Dans la boîte de dialogue Enregistrer sous , déplacez un répertoire vers la racine de votre déploiement, puis cliquez sur Enregistrer.In the Save As dialog box, move up one directory to the root of your deployment and then click Save.

  28. Copiez tous les fichiers du répertoire de déploiement vers la destination ou le support de déploiement.Copy all of the files in the deployment directory to the deployment destination or media. Il peut s’agir d’un dossier sur un site Web ou FTP, d’un partage de fichiers ou d’un CD-ROM.This may be either a folder on a Web site or FTP site, a file share, or a CD-ROM.

  29. Fournissez à vos utilisateurs l’URL, le chemin UNC ou le support physique requis pour installer votre application.Provide your users with the URL, UNC, or physical media required to install your application. Si vous fournissez une URL ou un UNC, vous devez donner à vos utilisateurs le chemin d’accès complet du manifeste de déploiement.If you provide a URL or a UNC, you must give your users the full path the deployment manifest. Par exemple, si AppToDeploy est déployée sur http://webserver01/ dans le répertoire AppToDeploy, le chemin d’accès complet à l’URL est http://webserver01/AppToDeploy/AppToDeploy.application.For example, if AppToDeploy is deployed to http://webserver01/ in the AppToDeploy directory, the full URL path would be http://webserver01/AppToDeploy/AppToDeploy.application.

Étapes suivantesNext steps

Lorsque vous devez déployer une nouvelle version de l’application, créez un répertoire nommé d’après la nouvelle version (par exemple, 1.0.0.1) et copiez les nouveaux fichiers d’application dans le nouveau répertoire.When you need to deploy a new version of the application, create a new directory named after the new version—for example, 1.0.0.1—and copy the new application files into the new directory. Ensuite, vous devez suivre les étapes précédentes pour créer et signer un nouveau manifeste d’application, et pour mettre à jour et signer le manifeste de déploiement.Next, you need to follow the previous steps to create and sign a new application manifest, and update and sign the deployment manifest. Veillez à spécifier la même version supérieure dans le -New Mage. exe et les appels de -Update, car ClickOnceClickOnce met à jour uniquement les versions plus récentes, avec l’entier le plus à gauche le plus significatif.Be careful to specify the same higher version in both the Mage.exe -New and -Update calls, as ClickOnceClickOnce only updates higher versions, with the left-most integer most significant. Si vous avez utilisé MageUI. exe, vous pouvez mettre à jour le manifeste de déploiement en l’ouvrant, en sélectionnant l’onglet Référence de l' application , en cliquant sur le bouton Sélectionner un manifeste , puis en sélectionnant le manifeste d’application mis à jour.If you used MageUI.exe, you can update the deployment manifest by opening it, selecting the Application Reference tab, clicking the Select Manifest button, and then selecting the updated application manifest.

Voir aussiSee also