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

  • Article

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 de base 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.

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.

    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. 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.

    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. 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.

    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. 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.

    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. 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.

    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. Dans la section Version de publication, décochez la case Incrémenter automatiquement la révision avec chaque mise en production.

Contenu connexe