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 décrit 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 dont vous avez besoin pour 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 disposer du SDK WindowsWindows SDK installé ou la version de la SDK WindowsWindows SDK inclus avec 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 Windows SDK sur MSDN.For more information, see Windows SDK on MSDN.

  • Fournir 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éterminer si l’application requiert un niveau élevé de confiance.Determine whether the application requires an elevated level of trust.

    Si votre application exige 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 autorisation Internet ou intranet à partir d’un autre manifeste, modifiez-le selon vos besoins et ajoutez-le 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 certification (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 n’a 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 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 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 de l’UAC, vous devez ré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 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 même <asmv1:assembly> élément.In the opened manifest file, remove all elements within the single <asmv1:assembly> element.

  • Déterminer 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 installation des composants 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 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 où 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 le sous-répertoire de 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 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 le SDK WindowsWindows SDK ou commande de Visual Studio invite et accédez au sous-répertoire de version.Open the SDK 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 passwd 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  
    

    En commençant par le Kit de développement logiciel .NET Framework 4.6.2, qui est distribué avec Visual Studio et avec le SDK Windows, mage.exe signes manifestes avec CNG ainsi qu’avec des 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 à l’instar de certificats Authenticode.Use the same command line parameters as with Authenticode certificates.

  7. Accéder à 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’il peut ê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 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, et les utilisateurs installent votre application à partir d’un site Web ou un partage de fichiers, assurez-vous que la valeur de la -ProviderUrl pointe d’option à l’emplacement de l’application manifeste 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. Signer 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 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 soit 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, une UNC ou un 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 complète 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 où 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 le sous-répertoire de 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érent 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, New, manifeste d’Application dans le 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 le sous-répertoire de version contenant 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 lorsque le remplissage d’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 vous avez besoin de 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, qui convient pour 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 et vous invite à signer le manifeste d’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 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 un certificat stocké 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, New, du 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 produit.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 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 le Options de déploiement onglet, puis, 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 les 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 Open.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 et vous invite à 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 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 un certificat stocké 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 soit 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, une UNC ou un 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 à 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é sur http://webserver01/ dans le répertoire AppToDeploy, le chemin d’accès URL complète 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 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 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 plus élevée dans les deux Mage.exe -New et -Update 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