Spécifier les propriétés de publication ClickOnce

Vous pouvez configurer les propriétés de publication ClickOnce dans la page Publier du Concepteur de projet ou en utilisant l’Assistant Publication. Dans cet article, vous allez apprendre à spécifier des propriétés telles que l’emplacement et la version de publication, l’URL d’installation, ainsi que le mode d’installation en ligne ou hors connexion.

Spécifier un emplacement de publication

Quand vous publiez une application à l'aide de ClickOnce, la propriété Publish Location indique l'emplacement de destination des fichiers d'application et du manifeste. Il peut s'agir d'un chemin d'accès de fichier ou du chemin d'accès à un serveur FTP.

Vous pouvez spécifier la propriété Publish Location dans la page Publier du Concepteur de projets ou en utilisant l’Assistant Publication. Pour plus d’informations, consultez Comment : publier une application ClickOnce à l’aide de l’Assistant Publication.

1. Après avoir sélectionné un projet dans l’ Explorateur de solutions, dans le menu Projet , cliquez sur Propriétés.

2. Cliquez sur l'onglet Publier.

3. Dans le champ Emplacement de publication, entrez l’emplacement de publication dans l’un des formats suivants :

   • Pour publier vers un partage de fichiers ou un chemin de disque, entrez le chemin sous forme de chemin UNC (\Serveur\Nom_application) ou de chemin de fichier (C:\Déploiement\Nom_application).

   • Pour publier vers un serveur FTP, entrez le chemin d’accès dans le format suivant : ftp://ftp.microsoft.com/<Nom_application>.

     Notez que du texte doit figurer dans la zone Emplacement de publication pour que le bouton Parcourir (...) fonctionne.

Spécifier l’emplacement à partir duquel les utilisateurs finaux effectuent l’installation

Lors de la publication d’une application ClickOnce, l’emplacement où les utilisateurs se rendent pour télécharger et installer l’application n’est pas nécessairement l’emplacement où vous publiez initialement l’application. Par exemple, dans certaines organisations, un développeur peut publier une application sur un serveur intermédiaire, puis un administrateur déplace l’application vers un serveur web.

Dans ce cas, vous pouvez utiliser la propriété Installation URL pour spécifier le serveur web sur lequel les utilisateurs vont télécharger l’application. Cela est nécessaire pour que le manifeste de l’application sache où rechercher les mises à jour.

La propriété Installation URL peut être définie sur la page Publier du Concepteur de projet.

Spécifier une URL d’installation

1. Après avoir sélectionné un projet dans l’ Explorateur de solutions, dans le menu Projet , cliquez sur Propriétés.

2. Cliquez sur l'onglet Publier.

3. Dans le champ URL d’installation, entrez l’emplacement d’installation à l’aide d’une URL complète au format https://www.contoso.com/ApplicationName, ou d’un chemin UNC utilisant le format \Server\ApplicationName.

Spécifier le mode d’installation en ligne ou hors connexion de ClickOnce

Le Install Mode pour une application ClickOnce détermine si l’application sera disponible hors connexion ou en ligne. Lorsque vous choisissez L’application est disponible en ligne uniquement, l’utilisateur doit avoir accès à l’emplacement de publication ClickOnce (une page Web ou un partage de fichiers) pour exécuter l’application. Lorsque vous choisissez L’application est également disponible hors connexion, l’application ajoute des entrées au menu Démarrer et à la boîte de dialogue Ajouter ou supprimer des programmes ; l’utilisateur peut exécuter l’application lorsqu’il n’est pas connecté.

La Install Mode peut être définie sur la page Publier du Concepteur de projet.

Rendre une application ClickOnce disponible en ligne uniquement

1. Après avoir sélectionné un projet dans l’ Explorateur de solutions, dans le menu Projet , cliquez sur Propriétés.

2. Cliquez sur l'onglet Publier.

3. Dans la zone Mode d’installation et paramètres, cliquez sur le bouton d’option L’application est disponible en ligne uniquement.

Rendre une application ClickOnce disponible en ligne ou hors connexion

1. Après avoir sélectionné un projet dans l’ Explorateur de solutions, dans le menu Projet , cliquez sur Propriétés.

2. Cliquez sur l'onglet Publier.

3. Dans la zone Mode d’installation et paramètres, cliquez sur le bouton d’option L’application est également disponible hors connexion.

   Une fois installée, l’application ajoute des entrées au menu Démarrer et à Ajouter ou supprimer des programmes dans le Panneau de configuration.

Définir la version de publication ClickOnce

La propriété ClickOnce Publish Version détermine si l’application que vous publiez sera traitée comme une mise à jour. Chaque fois que la version est incrémentée, l’application sera publiée comme une mise à jour.

La propriété Publish Version peut être définie sur la page Publier du Concepteur de projet.

Modifier la version de publication

1. Après avoir sélectionné un projet dans l’ Explorateur de solutions, dans le menu Projet , cliquez sur Propriétés.

2. Cliquez sur l'onglet Publier.

3. Dans le champ Version de publication, incrémentez les numéros de version Majeure, Mineure, Buildou Révision .

   Remarque

   Vous ne devriez jamais décrémenter un numéro de version ; cela pourrait entraîner un comportement de mise à jour imprévisible.

Incrémenter automatiquement la version de publication ClickOnce

Quand vous publiez une application ClickOnce, la modification de la propriété Publish Version entraîne la publication de l’application en tant que mise à jour. Par défaut, Visual Studio incrémente automatiquement le nombre Revision de Publish Version chaque fois que vous publiez l’application.

Vous pouvez désactiver ce comportement dans la page Publier du Concepteur de projet.

Désactiver l’incrémentation automatique de la version de publication

1. Après avoir sélectionné un projet dans l’ Explorateur de solutions, dans le menu Projet , cliquez sur Propriétés.

2. Cliquez sur l'onglet Publier.

3. Dans la section Version de publication, décochez la case Incrémenter automatiquement la révision avec chaque mise en production.

Spécifier une page de publication pour une application ClickOnce

Lors de la publication d’une application ClickOnce, une page Web par défaut (publish.htm) est générée et publiée avec l’application. Cette page contient le nom de l’application, un lien pour installer l’application et/ou les conditions préalables, ainsi qu’un lien vers une rubrique d’aide décrivant ClickOnce. La propriété Publier la page pour votre projet vous permet de spécifier un nom pour la page web pour votre application ClickOnce.

Une fois que la page de publication a été spécifiée, la prochaine fois que vous publierez, elle sera copiée dans l’emplacement de publication ; elle ne sera pas remplacée si vous publiez à nouveau. Si vous souhaitez personnaliser l’apparence de la page, vous pouvez le faire sans vous soucier de perdre vos modifications. Pour plus d’informations, consultez Personnaliser la page Web par défaut ClickOnce.

La propriété Publier la page peut être définie dans la boîte de dialogue Options de publication, accessible à partir du volet Publier du Concepteur de projets.

Pour spécifier une page de publication pour une application ClickOnce :

1. Après avoir sélectionné un projet dans l’ Explorateur de solutions, dans le menu Projet , cliquez sur Propriétés.

2. Sélectionnez le volet Publier.

3. Cliquez sur le bouton Options pour ouvrir la boîte de dialogue Options de publication.

4. Cliquez sur Déploiement.

5. Dans la boîte de dialogue Options de publication, vérifiez que l’option Ouvrir la page web de déploiement après la publication est cochée (elle doit être sélectionnée par défaut).

6. Dans la zone Page web de déploiement , entrez le nom de votre page web, puis cliquez sur OK.

Pour empêcher le lancement de la page de publication chaque fois que vous publiez :

1. Après avoir sélectionné un projet dans l’ Explorateur de solutions, dans le menu Projet , cliquez sur Propriétés.

2. Sélectionnez le volet Publier.

3. Cliquez sur le bouton Options pour ouvrir la boîte de dialogue Options de publication.

4. Cliquez sur Déploiement.

5. Dans la boîte de dialogue Options de publication, décochez l’option Ouvrir la page web de déploiement après la publication.

Personnaliser la page web par défaut d’une application ClickOnce

Lors de la publication d’une application ClickOnce sur le Web, une page web est automatiquement générée et publiée avec l’application. La page par défaut contient le nom de l’application ainsi que des liens pour installer l’application, installer les éléments prérequis ou accéder à l’aide sur MSDN.

Le nom par défaut de la page web est Publish.htm ; vous pouvez le changer dans le Concepteur de projet. Pour plus d’informations, consultez Spécifier une page de publication pour une application ClickOnce.

La page web Publish.htm est publiée uniquement si une version plus récente est détectée.

Pour personnaliser la page web de publication :

1. Publiez votre application ClickOnce sur un emplacement web. Pour plus d’informations, consultez Guide pratique pour publier une application ClickOnce à l’aide de l’Assistant Publication.

2. Sur le serveur web, ouvrez le fichier Publish.htm dans Visual Web Designer ou un autre éditeur HTML.

3. Personnalisez la page comme vous le souhaitez et enregistrez-la.

4. facultatif. Pour empêcher Visual Studio de remplacer votre page web de publication personnalisée, décochez Générer automatiquement la page web de déploiement après chaque publication dans la boîte de dialogue Options de publication.

Spécifier un lien pour le support technique

Lors de la publication d’une application ClickOnce, la propriété URL de support identifie la page web ou le partage de fichiers où les utilisateurs peuvent se rendre pour obtenir des informations sur l’application. Cette propriété est facultative. Si elle est renseignée, l’URL s’affiche dans l’entrée de l’application dans la boîte de dialogue Ajouter ou supprimer des programmes.

La propriété URL de support peut être définie dans la page Publication du Concepteur de projet.

Pour spécifier une URL de support :

1. Après avoir sélectionné un projet dans l’ Explorateur de solutions, dans le menu Projet , cliquez sur Propriétés.

2. Cliquez sur l'onglet Publier.

3. Cliquez sur le bouton Options pour ouvrir la boîte de dialogue Options de publication.

4. Cliquez sur Description.

5. Dans le champ URL de support, entrez le chemin complet d’un site web, d’une page web ou d’un partage UNC.

Spécifier une URL du support technique pour chaque prérequis lors d’un déploiement ClickOnce

Un déploiement ClickOnce peut tester un certain nombre de prérequis qui doivent être disponibles sur l’ordinateur client pour que l’application ClickOnce s’exécute. Ces dépendances incluent la version minimale requise du .NET Framework, la version du système d’exploitation et tous les assemblys qui doivent être préinstallés dans le Global Assembly Cache (GAC). Toutefois, ClickOnce ne peut pas installer l’un de ces prérequis lui-même ; si aucun prérequis n’est trouvé, il interrompt simplement l’installation et affiche une boîte de dialogue expliquant pourquoi l’installation a échoué.

Il existe deux méthodes pour installer les prérequis. Vous pouvez les installer à l’aide d’une application de programme d’amorçage. Vous pouvez également spécifier une URL d’assistance pour chaque prérequis, qui s’affiche aux utilisateurs de la boîte de dialogue si la configuration requise est introuvable. La page référencée par cette URL peut contenir des liens vers des instructions pour installer la configuration requise. Si une application ne spécifie pas d’URL d’assistance pour un prérequis individuel, ClickOnce affiche l’URL d’assistance spécifiée dans le manifeste de déploiement de l’application dans son ensemble, si elle est définie.

Bien que Visual Studio, Mage.exeet MageUI.exe puissent tous être utilisés pour générer des déploiements ClickOnce, aucun de ces outils ne prend directement en charge la spécification d’une URL d’assistance pour chaque prérequis. Ce document explique comment modifier le manifeste d’application et le manifeste de déploiement de votre déploiement pour inclure ces URL d’assistance.

Spécifier une URL d’assistance pour chaque prérequis

1. Ouvrez le manifeste de l’application (fichier .manifest) pour l’application ClickOnce dans un éditeur de texte.

2. Pour un prérequis du système d’exploitation, ajoutez l’attribut supportUrl à l’élément dependentOS :

    <dependency>
       <dependentOS supportUrl="http://www.adatum.com/MyApplication/wrongOSFound.htm">
         <osVersionInfo>
           <os majorVersion="5" minorVersion="1" buildNumber="2600" servicePackMajor="0" servicePackMinor="0" />
         </osVersionInfo>
       </dependentOS>
     </dependency>
   

3. Pour un prérequis d’une certaine version du Common Language Runtime, ajoutez l’attribut supportUrl à l’entrée dependentAssembly qui spécifie la dépendance Common Language Runtime :

     <dependency>
       <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/wrongClrVersionFound.htm">
         <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="4.0.30319.0" />
       </dependentAssembly>
     </dependency>
   

4. Pour un prérequis d’un assembly qui doit être préinstallé dans le Global Assembly Cache, définissez supportUrl pour l’élément dependentAssembly qui spécifie l’assembly requis :

     <dependency>
       <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/missingSampleGACAssembly.htm">
         <assemblyIdentity name="SampleGACAssembly" version="5.0.0.0" publicKeyToken="04529dfb5da245c5" processorArchitecture="msil" language="neutral" />
       </dependentAssembly>
     </dependency>
   

5. facultatif. Pour les applications qui ciblent .NET Framework 4, ouvrez le manifeste de déploiement (fichier .application) pour l’application ClickOnce dans un éditeur de texte.

6. Pour un prérequis .NET Framework 4, ajoutez l’attribut supportUrl à l’élément compatibleFrameworks :

   <compatibleFrameworks  xmlns="urn:schemas-microsoft-com:clickonce.v2" supportUrl="http://adatum.com/MyApplication/CompatibleFrameworks.htm">
     <framework targetVersion="4.0" profile="Client" supportedRuntime="4.0.30319" />
     <framework targetVersion="4.0" profile="Full" supportedRuntime="4.0.30319" />
   </compatibleFrameworks>
   

7. Une fois que vous avez modifié manuellement le manifeste de l’application, vous devez signer à nouveau le manifeste de l’application à l’aide de votre certificat numérique, puis mettre à jour et signer à nouveau le manifeste de déploiement. Utilisez les outils SDK Mage.exe ou MageUI.exe pour accomplir cette tâche, car la régénération de ces fichiers à l’aide de Visual Studio efface vos modifications manuelles. Pour plus d’informations sur l’utilisation de Mage.exe pour signer à nouveau des manifestes, consultez Guide pratique pour signer à nouveau des manifestes d’application et de déploiement.

sécurité du .NET Framework

L’URL d’assistance n’est pas affichée dans la boîte de dialogue si l’application est marquée pour s’exécuter dans une approbation partielle.

Changer la langue de publication d’une application ClickOnce

Lors de la publication d’une application ClickOnce, l’interface utilisateur affichée pendant l’installation est définie par défaut sur la langue et la culture de votre ordinateur de développement. Si vous publiez une application localisée, vous devrez spécifier une langue et une culture qui correspondent à la version localisée. Cette propriété est déterminée par la propriété Publish language de votre projet.

La propriété Publish language peut être définie dans la boîte de dialogue Options de publication, accessible à partir de la page Publier du Concepteur de projets.

Pour modifier la langue de publication :

1. Après avoir sélectionné un projet dans l’ Explorateur de solutions, dans le menu Projet , cliquez sur Propriétés.

2. Cliquez sur l'onglet Publier.

   Notes

   Dans ClickOnce pour .NET Core 3.1 et .NET 5 ou version ultérieure, vous définissez les propriétés de déploiement à l’aide de l’outil Publication au lieu de l’Assistant Publication et de la page Publication du Concepteur de projet. Pour plus d’informations, consultez Déployer une application Windows .NET avec ClickOnce et ClickOnce pour .NET.

3. Cliquez sur le bouton Options pour ouvrir la boîte de dialogue Options de publication.

4. Cliquez sur Description.

5. Dans la boîte de dialogue Options de publication, sélectionnez une langue et une culture dans la liste déroulante Langue de publication, puis cliquez sur OK.

spécifier un nom de menu Démarrer pour une application ClickOnce

Lorsqu’une application ClickOnce est installée pour une utilisation en ligne et hors connexion, une entrée est ajoutée au menu Démarrer et à la liste Ajouter ou supprimer des programmes. Par défaut, le nom d’affichage est identique au nom de l’assembly d’application, mais vous pouvez modifier le nom d’affichage en définissant le Nom du produit dans la boîte de dialogue Options de publication.

Le nom du produit s’affiche sur la page publish.htm ; pour une application hors connexion installée, il s’agit du nom de l’entrée dans le menu Démarrer et il s’agit également du nom qui s’affiche dans Ajouter ou supprimer des programmes.

Le nom de l’éditeur s’affiche sur la page publish.htm au-dessus du Nom du produit, et pour une application hors connexion installée, il s’agit également du nom du dossier qui contient l’icône de l’application dans le menu Démarrer.

Le raccourci du menu Démarrer ou la référence d’application est créé dans %appdata%\Microsoft\Windows\Menu Démarrer\Programmes\<nom de l’éditeur>. Le raccourci ou la référence d’application a le même nom que le nom du produit.

Vous pouvez définir les propriétés Nom du produit et Nom de l’éditeur dans la boîte de dialogue Options de publication, disponible dans la page Publier du Concepteur de projets.

Pour spécifier un nom de menu Démarrer :

1. Après avoir sélectionné un projet dans l’ Explorateur de solutions, dans le menu Projet , cliquez sur Propriétés.

2. Cliquez sur l'onglet Publier.

3. Cliquez sur le bouton Options pour ouvrir la boîte de dialogue Options de publication.

4. Cliquez sur Description.

5. Dans la boîte de dialogue Options de publication, tapez le nom à afficher dans Nom du produit.

6. Si vous le souhaitez, vous pouvez entrer un nom d’éditeur dans Nom de l’éditeur.

activer le démarrage automatique pour les installations depuis un CD-ROM

Lors du déploiement d’une application ClickOnce à l’aide d’un support amovible comme un CD-ROM ou un DVD-ROM, vous pouvez activer AutoStart afin que l’application ClickOnce soit automatiquement lancée lors de l’insertion du support.

AutoStart peut être activé sur la page Publier du Concepteur de projet.

Pour activer le démarrage automatique :

1. Après avoir sélectionné un projet dans l’ Explorateur de solutions, dans le menu Projet , cliquez sur Propriétés.

2. Cliquez sur l'onglet Publier.

3. Cliquez sur le bouton Options .

   La boîte de dialogue Options de publication s’affiche.

4. Cliquez sur Déploiement.

5. Cochez la case Pour les installations depuis un CD, démarrer automatiquement le programme d’installation lorsque le CD est inséré.

   Un fichier Autorun.inf est copié vers l’emplacement de publication lors de la publication de l’application.

Contenu connexe

• Publication d’applications ClickOnce
• Guide pratique pour publier une application ClickOnce à l’aide de l’Assistant Publication