Partager via


Gérer les mises à jour d’une application ClickOnce

Les applications ClickOnce peuvent rechercher les mises à jour automatiquement ou par programmation. En tant que développeur, vous disposez d’une grande flexibilité pour spécifier quand et comment les vérifications de mises à jour sont effectuées, si les mises à jour sont obligatoires et où l’application doit rechercher les mises à jour.

Vous pouvez configurer l’application pour rechercher automatiquement les mises à jour avant le démarrage de l’application ou à des intervalles définis après le démarrage de l’application. En outre, vous pouvez spécifier une version minimale requise ; autrement dit, une mise à jour est installée si la version de l’utilisateur est inférieure à la version requise.

Vous pouvez configurer l’application pour rechercher les mises à jour par programmation en fonction d’un événement comme une demande d’utilisateur. La procédure « Pour rechercher les mises à jour par programmation » dans cette rubrique montre comment écrire du code qui utilise la classe ApplicationDeployment pour rechercher les mises à jour en fonction d’un événement.

Notes

La classe ApplicationDeployment et les API de l’espace de noms System.Deployment.Application ne sont pas prises en charge dans .NET Core, .NET 5 et les versions ultérieures. Dans .NET 7, une nouvelle méthode d’accès aux propriétés de déploiement d’application est prise en charge. Pour plus d’informations, consultez Accéder aux propriétés de déploiement ClickOnce dans .NET. .NET 7 ne prend pas en charge l’équivalent des méthodes ApplicationDeployment.

Vous pouvez également déployer votre application à partir d’un emplacement et la mettre à jour à partir d’un autre. Consultez la procédure « Pour spécifier un autre emplacement de mise à jour ».

Pour plus d’informations, consultez Choix d’une stratégie de mise à jour ClickOnce.

Le comportement de mise à jour est géré dans la boîte de dialogue Mises à jour d’application, disponible à partir de la page Publier du Concepteur de projet.

Pour rechercher les mises à jour avant le démarrage de l’application

  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 Mises à jour pour ouvrir la boîte de dialogue Mises à jour d’application.

  4. Dans la boîte de dialogue Mises à jour d’application, vérifiez que la case L’application doit vérifier les mises à jour est cochée.

  5. Dans la section Choisir le moment auquel l’application doit rechercher les mises à jour, sélectionnez Avant le démarrage de l’application. Cela garantit que les utilisateurs connectés au réseau exécutent toujours l’application avec les dernières mises à jour.

Vérifier les mises à jour en arrière-plan, après le démarrage de l’application

  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 Mises à jour pour ouvrir la boîte de dialogue Mises à jour d’application.

  4. Dans la boîte de dialogue Mises à jour d’application, vérifiez que la case L’application doit vérifier les mises à jour est cochée.

  5. Dans la section Choisir le moment auquel l’application doit rechercher les mises à jour, sélectionnez Après le démarrage de l’application. L’application démarre plus rapidement de cette façon, puis recherche les mises à jour en arrière-plan et n’avertit l’utilisateur que lorsqu’une mise à jour est disponible. Une fois installées, les mises à jour ne prennent pas effet tant que l’application n’est pas redémarrée.

  6. Dans la section Spécifier la fréquence à laquelle l’application doit rechercher les mises à jour, sélectionnez Vérifier chaque fois que l’application s’exécute (valeur par défaut) ou Vérifier tou(te)s les et entrez un nombre et un intervalle de temps.

Notes

Dans ClickOnce pour .NET Core et .NET 5 ou version ultérieure, cette tâche n’est pas prise en charge. Pour plus d’informations, consultez ClickOnce pour .NET.

Pour spécifier une version minimale requise pour l’application

  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 Mises à jour pour ouvrir la boîte de dialogue Mises à jour d’application.

  4. Dans la boîte de dialogue Mises à jour d’application, vérifiez que la case L’application doit vérifier les mises à jour est cochée.

  5. Activez la case à cocher Spécifier une version minimale requise pour cette application, puis entrez les numéros de version Majeure, Mineur, Build et Révision pour l’application.

Pour spécifier un autre emplacement de mise à jour

  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 Mises à jour pour ouvrir la boîte de dialogue Mises à jour d’application.

  4. Dans la boîte de dialogue Mises à jour d’application, vérifiez que la case L’application doit vérifier les mises à jour est cochée.

  5. Dans le champ Emplacement des mises à jour, entrez l’emplacement des mises à jour avec une URL complète, au format http://Hostname/ApplicationName, ou un chemin UNC au format \\Server\ApplicationName, ou cliquez sur le bouton Parcourir pour rechercher l’emplacement des mises à jour.

Pour rechercher les mises à jour par programmation

  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 Mises à jour pour ouvrir la boîte de dialogue Mises à jour d’application.

  4. Dans la boîte de dialogue Mises à jour d’application, vérifiez que la case L’application doit vérifier les mises à jour est décochée. (Si vous le souhaitez, vous pouvez activer cette case à cocher pour rechercher les mises à jour par programmation et laisser le runtime ClickOnce rechercher automatiquement les mises à jour.)

  5. Dans le champ Emplacement des mises à jour, entrez l’emplacement des mises à jour avec une URL complète, au format http://Hostname/ApplicationName, ou un chemin UNC au format \\Server\ApplicationName, ou cliquez sur le bouton Parcourir pour rechercher l’emplacement des mises à jour. L’emplacement de mise à jour est l’endroit où l’application recherche une version mise à jour d’elle-même.

  6. Créez un bouton, un élément de menu ou un autre élément d’interface utilisateur sur une instance Windows Form que les utilisateurs choisiront pour vérifier les mises à jour. À partir du gestionnaire d’événements de cet élément, appelez une méthode pour rechercher et installer des mises à jour. Vous trouverez un exemple de code Visual Basic et Visual C# pour une telle méthode dans Guide pratique pour vérifier la disponibilité de mises à jour des applications par programmation à l’aide de l’API de déploiement ClickOnce.

  7. Générez votre application.