Génération d'applications ClickOnce à partir de la ligne de commandeBuilding ClickOnce Applications from the Command Line

Dans Visual StudioVisual Studio, vous pouvez générer des projets à partir de la ligne de commande, même s’ils sont créés dans l’environnement de développement intégré (IDE).In Visual StudioVisual Studio, you can build projects from the command line, even if they are created in the integrated development environment (IDE). En fait, vous pouvez régénérer un projet créé avec Visual StudioVisual Studio sur un autre ordinateur qui a uniquement les .NET Framework.NET Framework installé.In fact, you can rebuild a project created with Visual StudioVisual Studio on another computer that has only the .NET Framework.NET Framework installed. Cela vous permet de reproduire une génération à l’aide d’un processus automatisé, par exemple, dans une build centrale lab ou à l’aide de techniques de script avancées dépasse le cadre de la génération du projet lui-même.This allows you to reproduce a build using an automated process, for example, in a central build lab or using advanced scripting techniques beyond the scope of building the project itself.

Utilisation de MSBuild pour reproduire des déploiements d’applications ClickOnceUsing MSBuild to Reproduce ClickOnce Application Deployments

Lorsque vous appelez/target : Publish de msbuild sur la ligne de commande, il indique le système MSBuild pour générer le projet et de créer un ClickOnceClickOnce application dans le dossier de publication.When you invoke msbuild /target:publish at the command line, it tells the MSBuild system to build the project and create a ClickOnceClickOnce application in the publish folder. Cela revient à sélectionner la publier dans l’IDE.This is equivalent to selecting the Publish command in the IDE.

Cette commande exécute msbuild.exe, qui se trouve sur le chemin d’accès dans l’environnement d’invite de commandes de Visual Studio.This command executes msbuild.exe, which is on the path in the Visual Studio command-prompt environment.

Une « cible » est un indicateur à MSBuild sur la façon de traiter la commande.A "target" is an indicator to MSBuild on how to process the command. Les principales cibles sont la cible « build » et la cible « publier ».The key targets are the "build" target and the "publish" target. La cible build est équivalente à la sélection de la Build command (ou en appuyant sur F5) dans l’IDE.The build target is the equivalent to selecting the Build command (or pressing F5) in the IDE. Si vous souhaitez uniquement générer votre projet, vous pouvez effectuer cette en tapant msbuild.If you only want to build your project, you can achieve that by typing msbuild. Cette commande fonctionne parce que la cible de génération est la cible par défaut pour tous les projets générés par Visual StudioVisual Studio.This command works because the build target is the default target for all projects generated by Visual StudioVisual Studio. Cela signifie que vous n’avez pas explicitement besoin spécifier la cible de génération.This means you do not explicitly need to specify the build target. Par conséquent, en tapant msbuild est la même opération en tapant msbuild /target:build.Therefore, typing msbuild is the same operation as typing msbuild /target:build.

Le /target:publish commande indique à MSBuild d’appeler la cible de publication.The /target:publish command tells MSBuild to invoke the publish target. La cible build dépend de la cible de publication.The publish target depends on the build target. Cela signifie que l’opération de publication est un sur-ensemble de l’opération de génération.This means that the publish operation is a superset of the build operation. Par exemple, si vous avez une modification d’un de vos fichiers sources Visual Basic ou c#, l’assembly correspondant est automatiquement régénéré par l’opération de publication.For example, if you made a change to one of your Visual Basic or C# source files, the corresponding assembly would automatically be rebuilt by the publish operation.

Pour plus d’informations sur la génération d’un intégral ClickOnceClickOnce déploiement à l’aide de l’outil de ligne de commande Mage.exe pour créer votre ClickOnceClickOnce de manifeste, consultez procédure pas à pas : déploiement manuel d’une Application ClickOnce.For information on generating a full ClickOnceClickOnce deployment using the Mage.exe command-line tool to create your ClickOnceClickOnce manifest, see Walkthrough: Manually Deploying a ClickOnce Application.

Création et la création d’une Application ClickOnce de base à l’aide de MSBuildCreating and Building a Basic ClickOnce Application Using MSBuild

Pour créer et publier un projet ClickOnceTo create and publish a ClickOnce project

  1. Cliquez sur nouveau projet à partir de la fichier menu.Click New Project from the File menu. La boîte de dialogue Nouveau projet s’affiche.The New Project dialog box appears.

  2. Sélectionnez Application Windows et nommez-le CmdLineDemo.Select Windows Application and name it CmdLineDemo.

  3. À partir de la générer menu, cliquez sur le publier commande.From the Build menu, click the Publish command.

    Cette étape permet de s’assurer que le projet est correctement configuré pour produire un ClickOnceClickOnce déploiement d’application.This step ensures that the project is properly configured to produce a ClickOnceClickOnce application deployment.

    L'Assistant Publication apparaît.The Publish Wizard appears.

  4. Dans l’Assistant Publication, cliquez sur Terminer.In the Publish Wizard, click Finish.

    Visual Studio génère et affiche la page Web par défaut, appelée Publish.htm.Visual Studio generates and displays the default Web page, called Publish.htm.

  5. Enregistrer votre projet et notez l’emplacement du dossier dans lequel il est stocké.Save your project, and make note of the folder location in which it is stored.

    La procédure ci-dessus crée un ClickOnceClickOnce projet qui a été publiée pour la première fois.The steps above create a ClickOnceClickOnce project which has been published for the first time. Maintenant, vous pouvez reproduire la génération en dehors de l’IDE.Now you can reproduce the build outside of the IDE.

Pour reproduire la génération à partir de la ligne de commandeTo reproduce the build from the command line

  1. Quittez Visual StudioVisual Studio.Exit Visual StudioVisual Studio.

  2. À partir des fenêtres Démarrer menu, cliquez sur tous les programmes, puis Microsoft Visual Studio, puis Visual Studio Tools, puis Invite de commandes visual Studio.From the Windows Start menu, click All Programs, then Microsoft Visual Studio, then Visual Studio Tools, then Visual Studio Command Prompt. Cela doit ouvrir une invite de commandes dans le dossier racine de l’utilisateur actuel.This should open a command prompt in the root folder of the current user.

  3. Dans le invite de commandes Visual Studio, modifiez le répertoire actuel à l’emplacement du projet que vous venez de créer ci-dessus.In the Visual Studio Command Prompt, change the current directory to the location of the project you just built above. Par exemple, tapez chdir My Documents\Visual Studio\Projects\CmdLineDemo.For example, type chdir My Documents\Visual Studio\Projects\CmdLineDemo.

  4. Pour supprimer les fichiers existants produits dans « pour créer et publier un ClickOnceClickOnce projet, « type rmdir /s publish.To remove the existing files produced in "To create and publish a ClickOnceClickOnce project," type rmdir /s publish.

    Cette étape est facultative, mais il garantit que les nouveaux fichiers ont été générés par la version de ligne de commande.This step is optional, but it ensures that the new files were all produced by the command-line build.

  5. Tapez msbuild /target:publish.Type msbuild /target:publish.

    Les étapes ci-dessus produiront un complet ClickOnceClickOnce déploiement d’application dans un sous-dossier de votre projet nommé Pblier.The above steps will produce a full ClickOnceClickOnce application deployment in a subfolder of your project named Publish. CmdLineDemo.application est le ClickOnceClickOnce manifeste de déploiement.CmdLineDemo.application is the ClickOnceClickOnce deployment manifest. Le dossier CmdLineDemo_1.0.0.0 contient les fichiers CmdLineDemo.exe et CmdLineDemo.exe.manifest, le ClickOnceClickOnce manifeste d’application.The folder CmdLineDemo_1.0.0.0 contains the files CmdLineDemo.exe and CmdLineDemo.exe.manifest, the ClickOnceClickOnce application manifest. Setup.exe est le programme d’amorçage, qui par défaut est configuré pour installer le .NET Framework.NET Framework.Setup.exe is the bootstrapper, which by default is configured to install the .NET Framework.NET Framework. Le dossier DotNetFX contient les redistribuables pour le .NET Framework.NET Framework.The DotNetFX folder contains the redistributables for the .NET Framework.NET Framework. Il s’agit de l’ensemble des fichiers que vous avez besoin pour déployer votre application via le Web ou UNC ou d’un CD/DVD.This is the entire set of files you need to deploy your application over the Web or via UNC or CD/DVD.

Propriétés de publicationPublishing Properties

Lorsque vous publiez l’application dans les procédures ci-dessus, les propriétés suivantes sont insérées dans votre fichier projet par l’Assistant Publication.When you publish the application in the above procedures, the following properties are inserted into your project file by the Publish Wizard. Ces propriétés influencent directement la ClickOnceClickOnce application est produite.These properties directly influence how the ClickOnceClickOnce application is produced.

Dans CmdLineDemo.vbproj / CmdLineDemo.csproj :In CmdLineDemo.vbproj / CmdLineDemo.csproj:

<AssemblyOriginatorKeyFile>WindowsApplication3.snk</AssemblyOriginatorKeyFile>  
<GenerateManifests>true</GenerateManifests>  
<TargetZone>LocalIntranet</TargetZone>  
<PublisherName>Microsoft</PublisherName>  
<ProductName>CmdLineDemo</ProductName>  
<PublishUrl>http://localhost/CmdLineDemo</PublishUrl>  
<Install>true</Install>  
<ApplicationVersion>1.0.0.*</ApplicationVersion>  
<ApplicationRevision>1</ApplicationRevision>  
<UpdateEnabled>true</UpdateEnabled>  
<UpdateRequired>false</UpdateRequired>  
<UpdateMode>Foreground</UpdateMode>  
<UpdateInterval>7</UpdateInterval>  
<UpdateIntervalUnits>Days</UpdateIntervalUnits>  
<UpdateUrlEnabled>false</UpdateUrlEnabled>  
<IsWebBootstrapper>true</IsWebBootstrapper>  
<BootstrapperEnabled>true</BootstrapperEnabled>  

Vous pouvez remplacer une de ces propriétés au niveau de la ligne de commande sans modifier le fichier projet.You can override any of these properties at the command line without altering the project file itself. Par exemple, ce qui suit va générer le ClickOnceClickOnce déploiement d’application sans le programme d’amorçage :For example, the following will build the ClickOnceClickOnce application deployment without the bootstrapper:

msbuild /target:publish /property:BootstrapperEnabled=false  

Propriétés de publication sont contrôlées dans Visual StudioVisual Studio à partir de la publier, sécurité, et signature pages de propriétés de la Concepteur de projets .Publishing properties are controlled in Visual StudioVisual Studio from the Publish, Security, and Signing property pages of the Project Designer. Vous trouverez ci-dessous une description des propriétés de publication, avec une indication de la façon dont chacun est définie dans les différentes pages de propriétés du Concepteur d’applications :Below is a description of the publishing properties, along with an indication of how each is set in the various property pages of the application designer:

  • AssemblyOriginatorKeyFile Détermine le fichier de clé utilisé pour signer votre ClickOnceClickOnce manifestes d’application.AssemblyOriginatorKeyFile determines the key file used to sign your ClickOnceClickOnce application manifests. Cette même clé peut également être utilisée pour attribuer un nom fort à vos assemblys.This same key may also be used to assign a strong name to your assemblies. Cette propriété est définie sur le signature page de la Concepteur de projet.This property is set on the Signing page of the Project Designer.

    Les propriétés suivantes sont définies sur le sécurité page :The following properties are set on the Security page:

  • Activer les paramètres de sécurité ClickOnce détermine si ClickOnceClickOnce manifestes ont été générés.Enable ClickOnce Security Settings determines whether ClickOnceClickOnce manifests are generated. Lorsqu’un projet est créé, ClickOnceClickOnce la génération du manifeste est désactivée par défaut.When a project is initially created, ClickOnceClickOnce manifest generation is off by default. L’Assistant active automatiquement cet indicateur sur lorsque vous publiez pour la première fois.The wizard will automatically turn this flag on when you publish for the first time.

  • TargetZone détermine le niveau de confiance à émettre dans votre ClickOnceClickOnce manifeste d’application.TargetZone determines the level of trust to be emitted into your ClickOnceClickOnce application manifest. Les valeurs possibles sont « Internet », « LocalIntranet » et « Custom ».Possible values are "Internet", "LocalIntranet", and "Custom". Internet et LocalIntranet entraînent une autorisation par défaut définie dans votre ClickOnceClickOnce manifeste d’application.Internet and LocalIntranet will cause a default permission set to be emitted into your ClickOnceClickOnce application manifest. LocalIntranet est la valeur par défaut, et il signifie une confiance totale.LocalIntranet is the default, and it basically means full trust. Custom Spécifie que seules les autorisations spécifiées explicitement dans le fichier App.manifest de base doivent être émis dans le ClickOnceClickOnce manifeste d’application.Custom specifies that only the permissions explicitly specified in the base app.manifest file are to be emitted into the ClickOnceClickOnce application manifest. Le fichier App.manifest est un fichier de manifeste partiel qui contient les définitions de plus d’informations d’approbation.The app.manifest file is a partial manifest file that contains just the trust information definitions. Il s’agit d’un fichier masqué, ajouté automatiquement à votre projet lorsque vous configurez les autorisations sur le sécurité page.It is a hidden file, automatically added to your project when you configure permissions on the Security page.

    Les propriétés suivantes sont définies sur le publier page :The following properties are set on the Publish page:

  • PublishUrl est l’emplacement où l’application sera publiée à dans l’IDE.PublishUrl is the location where the application will be published to in the IDE. Il est inséré dans le ClickOnceClickOnce manifeste d’application si ni le InstallUrl ou UpdateUrl propriété est spécifiée.It is inserted into the ClickOnceClickOnce application manifest if neither the InstallUrl or UpdateUrl property is specified.

  • ApplicationVersion Spécifie la version de la ClickOnceClickOnce application.ApplicationVersion specifies the version of the ClickOnceClickOnce application. Il s’agit d’un numéro de version de quatre chiffres.This is a four-digit version number. Si le dernier chiffre est un « * », puis le ApplicationRevision est remplacé par la valeur insérée dans le manifeste au moment de la génération.If the last digit is a "*", then the ApplicationRevision is substituted for the value inserted into the manifest at build time.

  • ApplicationRevision Spécifie la révision.ApplicationRevision specifies the revision. Il s’agit d’un entier qui incrémente chaque fois que vous publiez dans l’IDE.This is an integer which increments each time you publish in the IDE. Notez qu’il n’est pas automatiquement incrémenté pour les builds exécutées sur la ligne de commande.Notice that it is not automatically incremented for builds performed at the command-line.

  • Install Détermine si l’application est une application installée ou une application d’exécution à partir du Web.Install determines whether the application is an installed application or a run-from-Web application.

  • InstallUrl (non affichée) est l’emplacement où les utilisateurs installent l’application à partir de.InstallUrl (not shown) is the location where users will install the application from. Si spécifié, cette valeur est intégrée dans le programme d’amorçage setup.exe si le IsWebBootstrapper propriété est activée.If specified, this value is burned into the setup.exe bootstrapper if the IsWebBootstrapper property is enabled. Il est également inséré dans la manifeste d’application si le UpdateUrl n’est pas spécifié.It is also inserted into the application manifest if the UpdateUrl is not specified.

  • SupportUrl (non affichée) est l’emplacement lié dans le Ajout/Suppression de programmes boîte de dialogue pour une application installée.SupportUrl (not shown) is the location linked in the Add/Remove Programs dialog box for an installed application.

    Les propriétés suivantes sont définies le mises à jour de l’Application boîte de dialogue, accédé à partir de la publier page.The following properties are set in the Application Updates dialog box, accessed from the Publish page.

  • UpdateEnabled Indique si l’application doit vérifier les mises à jour.UpdateEnabled indicates whether the application should check for updates.

  • UpdateMode Spécifie les mises à jour de premier plan ou de mises à jour en arrière-plan.UpdateMode specifies either Foreground updates or Background updates.

  • UpdateInterval Spécifie la fréquence à laquelle l’application doit vérifier les mises à jour.UpdateInterval specifies how frequently the application should check for updates.

  • UpdateIntervalUnits Spécifie si le UpdateInterval valeur est exprimée en heures, jours ou semaines.UpdateIntervalUnits specifies whether the UpdateInterval value is in units of hours, days, or weeks.

  • UpdateUrl (non affichée) est l’emplacement à partir duquel l’application recevra les mises à jour.UpdateUrl (not shown) is the location from which the application will receive updates. Si spécifié, cette valeur est insérée dans le manifeste d’application.If specified, this value is inserted into the application manifest.

  • Les propriétés suivantes sont définies le Options de publication boîte de dialogue, accédé à partir de la publier page.The following properties are set in the Publish Options dialog box, accessed from the Publish page.

  • PublisherName Spécifie le nom du serveur de publication affiché dans l’invite qui s’affiché lors de l’installation ou l’exécution de l’application.PublisherName specifies the name of the publisher displayed in the prompt shown when installing or running the application. Dans le cas d’une application installée, il est également utilisé pour spécifier le nom du dossier sur le Démarrer menu.In the case of an installed application, it is also used to specify the folder name on the Start menu.

  • ProductName Spécifie le nom du produit indiqué dans l’invite qui s’affiché lors de l’installation ou l’exécution de l’application.ProductName specifies the name of the product displayed in the prompt shown when installing or running the application. Dans le cas d’une application installée, il est également utilisé pour spécifier le nom du raccourci sur le Démarrer menu.In the case of an installed application, it is also used to specify the shortcut name on the Start menu.

  • Les propriétés suivantes sont définies le conditions préalables boîte de dialogue, accédé à partir de la publier page.The following properties are set in the Prerequisites dialog box, accessed from the Publish page.

  • BootstrapperEnabled Détermine s’il faut générer le programme d’amorçage setup.exe.BootstrapperEnabled determines whether to generate the setup.exe bootstrapper.

  • IsWebBootstrapper Détermine si le programme d’amorçage setup.exe fonctionne sur le Web ou le mode basée sur disque.IsWebBootstrapper determines whether the setup.exe bootstrapper works over the Web or in disk-based mode.

InstallURL, SupportUrl, PublishURL et UpdateURLInstallURL, SupportUrl, PublishURL, and UpdateURL

Le tableau suivant montre les quatre options d’URL pour le déploiement ClickOnce.The following table shows the four URL options for ClickOnce deployment.

Option d’URLURL option DescriptionDescription
PublishURL Obligatoire si vous publiez votre application ClickOnce à un site Web.Required if you are publishing your ClickOnce application to a Web site.
InstallURL Facultatif.Optional. Définissez cette option si le site de l’installation est différent de celle du PublishURL.Set this URL option if the installation site is different than the PublishURL. Par exemple, vous pouvez définir le PublishURL à un chemin d’accès FTP et d’un jeu le InstallURL vers une URL Web.For example, you could set the PublishURL to an FTP path and set the InstallURL to a Web URL.
SupportURL Facultatif.Optional. Définissez cette option si le site de prise en charge est différent de celui du PublishURL.Set this URL option if the support site is different than the PublishURL. Par exemple, vous pouvez définir le SupportURL au site Web de votre société client prise en charge.For example, you could set the SupportURL to your company's customer support Web site.
UpdateURL Facultatif.Optional. Définissez cette option si l’emplacement de mise à jour est différent de celui du InstallURL.Set this URL option if the update location is different than the InstallURL. Par exemple, vous pouvez définir le PublishURL à un chemin d’accès FTP et d’un jeu le UpdateURL vers une URL Web.For example, you could set the PublishURL to an FTP path and set the UpdateURL to a Web URL.

Voir aussiSee Also

GenerateBootstrapper
GenerateApplicationManifest
GenerateDeploymentManifest
Sécurité et déploiement ClickOnce ClickOnce Security and Deployment
Procédure pas à pas : déploiement manuel d’une application ClickOnceWalkthrough: Manually Deploying a ClickOnce Application