Comment : gérer des mises à jour pour une application ClickOnce

Les applications ClickOnce peuvent vérifier automatiquement ou par programme l'existence de mises à jour.En tant que développeur, vous disposez d'une grande souplesse pour spécifier quand et comment exécuter les vérifications de mises à jour, si les mises à jour sont obligatoires ou non, ainsi que l'emplacement dans lequel l'application doit rechercher des mises à jour.

Vous pouvez configurer l'application pour qu'elle vérifie automatiquement l'existence de mises à jour avant qu'elle ne démarre ou aux intervalles spécifiés après son démarrage.De plus, 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 qu'elle vérifie par programme les mises à jour à partir d'un événement, comme une demande utilisateur.Dans cette rubrique, la procédure « Pour vérifier par programme l'existence de mises à jour » montre comment écrire le code qui utilise la classe ApplicationDeployment pour vérifier l'existence de mises à jour en fonction d'un événement.

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

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 des applications, disponible dans la page Publier du Concepteur de projets.

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

  1. Un projet étant sélectionné dans l'Explorateur de solutions, cliquez dans le menu Projet 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 des applications.

  4. Dans la boîte de dialogue Mises à jour des applications, assurez-vous que la case à cocher L'application doit vérifier la disponibilité de mises à jour est activée.

  5. Dans la section Choisissez à quel moment l'application doit vérifier la disponibilité de 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 mises à jour les plus récentes.

Pour rechercher les mises à jour en arrière-plan après le démarrage de l'application

  1. Un projet étant sélectionné dans l'Explorateur de solutions, cliquez dans le menu Projet 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 des applications.

  4. Dans la boîte de dialogue Mises à jour des applications, assurez-vous que la case à cocher L'application doit vérifier la disponibilité de mises à jour est activée.

  5. Dans la section Choisissez à quel moment l'application doit vérifier la disponibilité de mises à jour, sélectionnez Après le démarrage de l'application.L'application démarrera plus rapidement de cette manière, puis recherchera les mises à jour en arrière-plan, et n'avertira l'utilisateur que si une mise à jour est disponible.Une fois installées, les mises à jour n'entrent pas en vigueur aussi longtemps que vous n'avez pas redémarré l'application.

  6. Dans la section Spécifiez à quelle fréquence l'application doit vérifier la disponibilité de mises à jour, sélectionnez ou Vérifier à chaque exécution de l'application (valeur par défaut) ou Vérifier toutes les : et entrez un nombre, ainsi qu'un intervalle de temps.

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

  1. Un projet étant sélectionné dans l'Explorateur de solutions, cliquez dans le menu Projet 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 des applications.

  4. Dans la boîte de dialogue Mises à jour des applications, assurez-vous que la case à cocher L'application doit vérifier la disponibilité de mises à jour est activée.

  5. Activez la case à cocher Spécifiez la version minimale requise pour cette application, puis entrez les numéros Principal, Secondaire, de Version et de Révision de l'application.

Pour spécifier un autre emplacement de mise à jour

  1. Un projet étant sélectionné dans l'Explorateur de solutions, cliquez dans le menu Projet 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 des applications.

  4. Dans la boîte de dialogue Mises à jour des applications, assurez-vous que la case à cocher L'application doit vérifier la disponibilité de mises à jour est activée.

  5. Dans le champ Emplacement de mise à jour, entrez l'emplacement de mise à jour avec une URL qualifiée complète au format http://NomHôte/NomApplication, ou encore un chemin UNC au format \\Serveur\NomApplication, ou cliquez sur le bouton Parcourir pour rechercher l'emplacement de mise à jour.

Pour vérifier par programme l'existence de mises à jour

  1. Un projet étant sélectionné dans l'Explorateur de solutions, cliquez dans le menu Projet 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 des applications.

  4. Dans la boîte de dialogue Mises à jour des applications, assurez-vous que la case à cocher L'application doit vérifier la disponibilité de mises à jour est désactivée.(Le cas échéant, vous pouvez activer cette case à cocher pour vérifier par programme l'existence de mises à jour et laisser également le runtime ClickOnce vérifier automatiquement leur disponibilité.)

  5. Dans le champ Emplacement de mise à jour, entrez l'emplacement de mise à jour avec une URL qualifiée complète au format http://NomHôte/NomApplication, ou encore un chemin UNC au format \\Serveur\NomApplication, ou cliquez sur le bouton Parcourir pour rechercher l'emplacement de mise à jour.L'emplacement de mise à jour désigne celui où l'application recherche une version d'elle-même mise à jour.

  6. Créez un bouton, un élément de menu ou un autre élément d'interface utilisateur sur un Windows Form que les utilisateurs sélectionneront pour vérifier l'existence de mises à jour.À partir du gestionnaire d'événements de cet élément, appelez une méthode pour vérifier l'existence de mises à jour et les installer.Vous pouvez trouver un exemple en Visual Basic et Visual C# de cette méthode dans Comment : vérifier la disponibilité de mises à jour des applications par programme à l'aide de l'API du déploiement ClickOnce.

  7. Générez votre application.

Voir aussi

Tâches

Comment : publier une application ClickOnce à l'aide de l'Assistant Publication

Comment : vérifier la disponibilité de mises à jour des applications par programme à l'aide de l'API du déploiement ClickOnce

Référence

ApplicationDeployment

Concepts

Choix d'une stratégie de mise à jour ClickOnce

Publication d'applications ClickOnce

Autres ressources

Application Updates Dialog Box