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.

Remarque

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.

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.

Notes

Quand vous installez plusieurs versions d'une application via ClickOnce, l'installation déplace les versions antérieures de cette application dans un dossier nommé Archive, à l'emplacement de publication que vous avez spécifié. Cet archivage permet d’éviter la présence de dossiers de la version précédente dans le répertoire 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 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.

Notes

La propriété Installation URL peut également être définie à l’aide de l’Assistant Publication. Pour plus d’informations, consultez Comment : publier une application ClickOnce à l’aide de l’Assistant Publication.

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.

Notes

Le Install Mode peut également être défini à l’aide de l’Assistant Publication. Pour plus d’informations, consultez Comment : publier une application ClickOnce à l’aide de l’Assistant Publication.

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.

Remarque

Il existe une option de projet qui incrémentera automatiquement la propriété Publish Version chaque fois que l’application est publiée ; cette option est activée par défaut. Pour plus d’informations, consultez Incrémenter automatiquement la version de publication ClickOnce.

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.

Notes

Les boîtes de dialogue et les commandes de menu affichées peuvent différer de celles décrites dans l'Aide selon les paramètres actifs ou le mode d'édition. Pour modifier vos paramètres, choisissez Paramètres d'importation et d'exportation dans le menu Outils . Pour plus d’informations, consultez Réinitialiser les paramètres.

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.

Remarque

Les liens fournis dans la page peuvent varier en fonction de l’ordinateur sur lequel vous consultez la page et des prérequis que vous spécifiez.

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.

Notes

Les changements apportés à vos paramètres de publication n’affectent pas la page Publish.htm, à une exception près : si vous ajoutez ou supprimez des prérequis après la publication initiale, la liste des prérequis ne sera plus exacte. Vous devez alors modifier le texte pour que le lien des prérequis reflète les changements.

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.

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.

Remarque

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.

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.

Notes

Les boîtes de dialogue et les commandes de menu affichées peuvent différer de celles décrites dans l'Aide selon les paramètres actifs ou le mode d'édition. Pour modifier vos paramètres, choisissez Paramètres d'importation et d'exportation dans le menu Outils . Pour plus d’informations, consultez Réinitialiser les paramètres.

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.