élément <de déploiement> (déploiement ClickOnce)

  • Article

Identifie les attributs utilisés pour le déploiement de mises à jour et l'exposition au système.

Syntaxe


      <deployment
   install
   minimumRequiredVersion
   mapFileExtensions
   disallowUrlActivation
   trustUrlParameters
>
   <subscription>
         <update>
            <beforeApplicationStartup/>
            <expiration
               maximumAge
               unit
            />
         </update>
   </subscription>
   <deploymentProvider
      codebase
   />
</deployment>

Éléments et attributs

L’élément deployment est obligatoire et se trouve dans l’espace de noms urn:schemas-microsoft-com:asm.v2 . L’élément a les attributs suivants.

Attribut Description
install Obligatoire. Spécifie si cette application définit une présence dans le menu Démarrer de Windows et dans l’application Ajout/Suppression de programmes du Panneau de configuration. Les valeurs valides sont true et false. Si false, ClickOnce exécutera toujours la dernière version de cette application à partir du réseau et ne reconnaîtra pas l’élément subscription.
minimumRequiredVersion facultatif. Spécifie la version minimale de cette application qui peut s’exécuter sur le client. Si le numéro de version de l’application est inférieur au numéro de version fourni dans le manifeste de déploiement, l’application ne s’exécute pas. Les numéros de version doivent être spécifiés au format N.N.N.N, où N est un entier non signé. Si l’attribut install est false, minimumRequiredVersion ne doit pas être défini.
mapFileExtensions facultatif. La valeur par défaut est false. Si true, tous les fichiers du déploiement doivent avoir une extension .deploy. ClickOnce supprimera cette extension dès qu’elle les téléchargera à partir du serveur web. Si vous publiez votre application à l’aide de Visual Studio, elle ajoute automatiquement cette extension à tous les fichiers. Ce paramètre permet à tous les fichiers d’un déploiement ClickOnce d’être téléchargés à partir d’un serveur web qui bloque la transmission de fichiers se terminant par des extensions « non sécurisées » telles que .exe.
disallowUrlActivation facultatif. La valeur par défaut est false. Si true, empêche un démarrage d’une application installée en cliquant sur l’URL ou en entrant l’URL dans un navigateur. Si l’attribut install n’est pas présent, cet attribut est ignoré.
trustURLParameters facultatif. La valeur par défaut est false. Si true, permet à l’URL de contenir des paramètres de chaîne de requête passés dans l’application, tout comme les arguments de ligne de commande sont passés à une application de ligne de commande. Pour en savoir plus, consultez Guide pratique pour récupérer les informations de chaîne de requête dans une application ClickOnce en ligne.

Si l’attribut disallowUrlActivation est true, trustUrlParameters doit être exclu du manifeste ou défini explicitement sur false.

L’élément deployment contient également les éléments enfants suivants.

abonnement

facultatif. Contient l’élément update. L’élément subscription ne comporte pas d’attributs. Si l’élément subscription n’existe pas, l’application ClickOnce n’analysera jamais les mises à jour. Si l’attribut install de l’élément deployment est false, l’élément subscription est ignoré, car une application ClickOnce lancée à partir du réseau utilise toujours la dernière version.

update

Obligatoire. Cet élément est un enfant de l’élément subscription et contient l’élément beforeApplicationStartup ou l’élément expiration. beforeApplicationStartup et expiration ne peut pas être spécifié dans le même manifeste de déploiement.

L’élément update ne comporte pas d’attributs.

beforeApplicationStartup

facultatif. Cet élément est un enfant de l’élément update et n’a aucun attribut. Lorsque l’élément beforeApplicationStartup existe, l’application sera bloquée lorsque ClickOnce vérifiera les mises à jour, si le client est en ligne. Si cet élément n’existe pas, ClickOnce recherchera d’abord les mises à jour en fonction des valeurs spécifiées pour l’élément expiration. beforeApplicationStartup et expiration ne peut pas être spécifié dans le même manifeste de déploiement.

expiration

facultatif. Cet élément est un enfant de l’élément update et n’a pas d’enfants. beforeApplicationStartup et expiration ne peut pas être spécifié dans le même manifeste de déploiement. Lorsque la vérification de la mise à jour se produit et qu’une version mise à jour est détectée, la nouvelle version est mise en cache pendant l’exécution de la version existante. La nouvelle version s’installe ensuite lors du prochain lancement de l’application ClickOnce.

L’élément expiration prend en charge les attributs suivants.

Attribut Description
maximumAge Obligatoire. Identifie l’ancienneté de la mise à jour actuelle avant que l’application n’effectue une vérification de mise à jour. L’unité de temps est déterminée par l’attribut unit.
unit Obligatoire. Identifie l’unité de temps pour maximumAge. Les unités valides sont hours, dayset weeks.

deploymentProvider

Pour .NET Framework 2.0, cet élément est requis si le manifeste de déploiement contient une section subscription. Pour .NET Framework 3.5 et les versions ultérieures, cet élément est facultatif. Par défaut, il s’agit du serveur et du chemin de fichier dans lesquels le manifeste de déploiement a été découvert.

Cet élément est un enfant de l’élément deployment et contient l’attribut suivant.

Attribut Description
codebase Obligatoire. Identifie l’emplacement, en tant qu’URI (Uniform Resource Identifier), du manifeste de déploiement utilisé pour mettre à jour l’application ClickOnce. Cet élément permet également de transférer des emplacements de mise à jour pour les installations basées sur CD. Doit être un URI valide.

Notes

Vous pouvez configurer votre application ClickOnce pour analyser les mises à jour au démarrage, analyser les mises à jour après le démarrage ou ne jamais vérifier les mises à jour. Pour analyser les mises à jour au démarrage, vérifiez que l’élément beforeApplicationStartup existe sous l’élément update. Pour analyser les mises à jour après le démarrage, vérifiez que l’élément expiration existe sous l’élément update et que les intervalles de mise à jour sont fournis.

Pour désactiver la vérification des mises à jour, supprimez l’élément subscription. Lorsque vous spécifiez dans le manifeste de déploiement de ne jamais analyser les mises à jour, vous pouvez toujours rechercher manuellement les mises à jour à l’aide de la méthode CheckForUpdate.

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.

Pour plus d’informations sur la façon dont deploymentProvider est lié aux mises à jour, consultez Choisir une stratégie de mise à jour ClickOnce.

Exemples

L’exemple de code suivant illustre un élément deployment dans un manifeste de déploiement ClickOnce. L’exemple utilise un élément deploymentProvider pour indiquer l’emplacement de mise à jour par défaut.

<deployment install="true" minimumRequiredVersion="2.0.0.0" mapFileExtension="true" trustUrlParameters="true">
    <subscription>
      <update>
        <expiration maximumAge="6" unit="hours" />
      </update>
    </subscription>
    <deploymentProvider codebase="http://www.adatum.com/MyApplication.application" />
  </deployment>

Voir aussi