Procédure pas à pas : déploiement manuel d'une application ClickOnceWalkthrough: Manually Deploying a ClickOnce Application

Si vous ne pouvez pas utiliser Visual Studio pour déployer votre ClickOnceClickOnce application, ou vous devez utiliser les fonctionnalités de déploiement avancées, comme le déploiement d’applications approuvées, vous devez utiliser l’outil de ligne de commande Mage.exe pour créer votre ClickOnceClickOnce manifestes.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 explique comment créer un ClickOnceClickOnce déploiement à l’aide de la version de ligne de commande (Mage.exe) ou graphique (MageUI.exe) de le Manifest Generation and Editing Tool.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.

PrérequisPrerequisites

Cette procédure pas à pas a certaines conditions préalables et les options que vous devez choisir avant de générer 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 de la 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 soit utiliser le Kit de développement logiciel WindowsWindows SDK installé ou la version de le Kit de développement logiciel WindowsWindows SDK fourni avec Visual Studio.You must either have the Kit de développement logiciel WindowsWindows SDK installed or the version of the Kit de développement logiciel WindowsWindows SDK included with Visual Studio. Pour plus d’informations, consultez Kit de développement logiciel 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 comment le déploiement sera distribué.Determine how the deployment will be distributed.

    Les options de distribution incluent : 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 de confiance élevé.Determine whether the application requires an elevated level of trust.

    Si votre application requiert une confiance totale, par exemple, un accès complet au système de l’utilisateur, vous pouvez utiliser la -TrustLevel option de Mage.exe pour définir cette.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 une autorisation personnalisée pour votre application, vous pouvez copier la section de l’accès Internet ou intranet à partir d’un autre manifeste, modifiez-le selon vos besoins et ajoutez-la au manifeste d’application à l’aide d’un éditeur de texte ou 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 Trusted Application Deployment Overview.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 de Visual Studio, MageUI.exe, ou MakeCert.exe et Pvk2Pfx.exe, ou vous pouvez obtenir un certificat à partir d’une autorité de certificat (CA).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 à partir 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 ne dispose pas d’un manifeste avec des informations 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), comme un <dependentAssembly> élément.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 le Windows Sysinternals Sigcheck utilitaire.To examine an application manifest, you can use the Windows Sysinternals Sigcheck utility.

    Si votre application contient un manifeste avec des détails du compte d’utilisateur, vous devez ré-le générer sans les informations de compte d’utilisateur.If your application contains a manifest with UAC details, you must re-build it without the UAC information. Pour un projet c# dans Visual Studio, ouvrez les propriétés du projet et sélectionnez l’onglet Application. Dans le manifeste la liste déroulante, sélectionnez créer l’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 Visual Basic dans Visual Studio, ouvrez les propriétés du projet, sélectionnez l’onglet Application, puis cliquez sur afficher les paramètres UAC.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 le seul <asmv1:assembly> élément.In the opened manifest file, remove all elements within the single <asmv1:assembly> element.

  • Déterminez si l’application requiert les composants requis sur l’ordinateur client.Determine whether the application requires prerequisites on the client computer.

    ClickOnceClickOnce les applications déployées à partir de Visual Studio peuvent inclure un programme d’amorçage de conditions préalables d’installation (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 deux manifestes requis pour un ClickOnceClickOnce déploiement.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 GenerateBootstrapper, tâche.You can create a prerequisite bootstrapper by using the GenerateBootstrapper Task.

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

  1. Créez un répertoire dans lequel vous stockerez vos ClickOnceClickOnce des fichiers de déploiement.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 ce sous-répertoire 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 de 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 Kit de développement logiciel WindowsWindows SDK ou une commande de Visual Studio invite de commandes et accédez au sous-répertoire de version.Open the Kit de développement logiciel WindowsWindows SDK or Visual Studio command prompt and change to the version subdirectory.

  5. Créer 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 le -FromDirectory option, 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. Signer le manifeste d’application avec votre certificat Authenticode.Sign the application manifest with your Authenticode certificate. Remplacez mycert.pfx avec le chemin d’accès à votre fichier de certificat.Replace mycert.pfx with the path to your certificate file. Remplacez mot_de_passe avec le mot de passe pour votre fichier de certificat.Replace passwd with the password for your certificate file.

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

    Pour signer le manifeste d’application avec un certificat CNG, utilisez la syntaxe suivante.To sign the application manifest with a CNG certificate, use the following. Remplacez cngCert.pfx avec le chemin d’accès à votre fichier de certificat.Replace cngCert.pfx with the path to your certificate file.

    mage -Sign AppToDeploy.exe.manifest -CertFile cngCert.pfx  
    
  7. Passer à la racine du répertoire de déploiement.Change to the root of the deployment directory.

  8. Générer le manifeste de déploiement avec un appel à Mage.exe.Generate the deployment manifest with a call to Mage.exe. Par défaut, Mage.exe marquera votre ClickOnceClickOnce déploiement sous la forme d’une application installée, afin qu’elle peut être exécutée à 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 le -Install option 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, les utilisateurs installent votre application à partir d’un site Web ou un partage de fichiers, assurez-vous que la valeur de la -ProviderUrl manifeste des points d’option à l’emplacement de l’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  
    

    ouor

    mage -Sign AppToDeploy.exe.manifest -CertFile cngCert.pfx  
    
  10. Copiez tous les fichiers dans le répertoire de déploiement à la destination du déploiement ou le média.Copy all of the files in the deployment directory to the deployment destination or media. Cela peut être un dossier sur un site Web ou FTP site, un partage de fichiers ou un CD-ROM.This may be either a folder on a Web site or FTP site, a file share, or a CD-ROM.

  11. Fournir à vos utilisateurs avec l’URL, 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 chemin UNC, vous devez communiquer aux 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é sur http://webserver01/ dans le répertoire AppToDeploy, le chemin d’accès URL complet serait 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 stockerez vos ClickOnceClickOnce des fichiers de déploiement.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 ce sous-répertoire 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 de 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éer un nouveau manifeste d’application en sélectionnant fichier, nouveau, manifeste d’Application à partir du menu.Create a new application manifest by selecting File, New, Application Manifest from the menu.

  6. Sur la valeur par défaut nom , tapez le nom et 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 que 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 le fichiers onglet et cliquez sur le bouton de sélection (... ) situé en regard du répertoire de l’Application zone de texte.Select the Files tab and click the ellipsis (...) button next to the Application directory text box. Une boîte de dialogue Rechercher un dossier s’affiche.A Browse For Folder dialog box appears.

  8. Sélectionnez la version qui contient vos fichiers d’application, puis cliquez sur OK.Select the version subdirectory containing your application files, and then click OK.

  9. Si vous allez déployer à partir de Internet Information Services (IIS), sélectionnez le lors du peuplement, ajouter l’extension .deploy à n’importe quel fichier qui ne l’a pas case à cocher.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 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 comme application de démarrage en sélectionnant Point d’entrée à partir de la Type de fichier liste déroulante.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 le marque pour vous.)(If your application contains only one executable file, MageUI.exe will mark it for you.)

  11. Sélectionnez le autorisations requises onglet 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 à partir du menu.Select File, Save As from the menu. Une boîte de dialogue Options de signature s’affiche vous invitant à signer le manifeste d’application.A Signing Options dialog box appears prompting you to sign the application manifest.

  13. Si vous possédez un certificat stocké en tant que fichier sur votre système de fichiers, utilisez le signer avec le fichier de certificat option et sélectionnez le certificat du système de fichiers en utilisant les points de suspension (... ) bouton.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. Puis tapez votre mot de passe du 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 le signer avec le certificat stockée option et 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 votre manifeste d’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, indiquez le répertoire de 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. Sur le nom onglet, spécifiez un nom et 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 que 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 le Description onglet et spécifier des valeurs pour Publisher et Produc *** t.Select the Description tab, and specify values for Publisher and Product. (Produit est le nom donné à votre application dans le menu Démarrer de Windows lorsque votre application est installée 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 le Options de déploiement onglet et dans le Start Location texte, 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 à l’étape précédente, vous devez également sélectionner 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 le mettre à jour les Options onglet et spécifier la fréquence à laquelle vous souhaitez que cette application pour mettre à jour.Select the Update Options tab, and specify how often you would like this application to update. Si votre application utilise UpdateCheckInfo pour vérifier les mises à jour lui-même, désactivez le cette application doit rechercher des mises à jour case à cocher.If your application uses UpdateCheckInfo to check for updates itself, clear the This application should check for updates check box.

  22. Sélectionnez le Application référence onglet, puis cliquez sur le sélectionner un manifeste bouton.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 ouvrir.Select the application manifest that you created earlier and then click Open.

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

  25. Si vous possédez un certificat stocké en tant que fichier sur votre système de fichiers, utilisez le signer avec le fichier de certificat option et sélectionnez le certificat du système de fichiers en utilisant les points de suspension (... ) bouton.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. Puis tapez votre mot de passe du 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 le signer avec le certificat stockée option et 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 le enregistrer en tant que boîte de dialogue, déplacement d’un répertoire à 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 dans le répertoire de déploiement à la destination du déploiement ou le média.Copy all of the files in the deployment directory to the deployment destination or media. Cela peut être un dossier sur un site Web ou FTP site, un partage de fichiers ou un CD-ROM.This may be either a folder on a Web site or FTP site, a file share, or a CD-ROM.

  29. Fournir à vos utilisateurs avec l’URL, 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 chemin UNC, vous devez donner le chemin d’accès complet du manifeste de déploiement à vos utilisateurs.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é sur http://webserver01/ dans le répertoire AppToDeploy, le chemin d’accès URL complet serait 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 avez besoin 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 copier les 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 manifeste d’application et 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 de supérieure dans les deux Mage.exe -New et -Update des appels, en tant que ClickOnceClickOnce met à jour uniquement les versions ultérieures, avec l’entier le plus à gauche 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 le Application référence onglet, en cliquant sur le sélectionner un manifeste bouton, puis en sélectionnant la mise à jour manifeste d’application.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

Mage.exe (outil Manifest Generation and Editing) Mage.exe (Manifest Generation and Editing Tool)
MageUI.exe (outil Manifest Generation and Editing, client graphique) MageUI.exe (Manifest Generation and Editing Tool, Graphical Client)
Publication d’applications ClickOnce Publishing ClickOnce Applications
Manifeste de déploiement ClickOnce ClickOnce Deployment Manifest
Manifeste d’application ClickOnceClickOnce Application Manifest