Manifeste de déploiement ClickOnce

Article
08/21/2008

Mise à jour : novembre 2007

Un manifeste de déploiement est un fichier XML qui décrit un déploiement ClickOnce, et identifie notamment la version actuelle de l'application ClickOnce à déployer.

Les manifestes de déploiement possèdent les éléments et attributs suivants.

Élément	Description	Attributs
<assembly>, élément	Obligatoire. Élément du niveau le plus haut.	manifestVersion
<assemblyIdentity>, élément	Obligatoire. Identifie le manifeste d'application ClickOnce.	name version publicKeyToken processorArchitecture culture
<description>, élément	Obligatoire. Fournit les informations sur l'application utilisées pour créer la présence d'un shell et l'élément Ajouter ou supprimer des programmes dans le Panneau de configuration.	publisher product supportUrl
<deployment>, élément	Facultatif. Identifie les attributs utilisés pour le déploiement de mises à jour et l'exposition au système.	isRequiredUpdate
<dependency>, élément	Obligatoire. Identifie la version de l'application à installer pour le déploiement et l'emplacement du manifeste d'application.	Aucun
<Signature>, élément	Facultatif. Contient les informations nécessaires à la signature numérique de ce manifeste de déploiement.	aucun

Notes

Le fichier manifeste de déploiement identifie un déploiement d'une application ClickOnce, et notamment la version actuelle ainsi que d'autres paramètres de déploiement. Il référence le manifeste d'application qui décrit la version actuelle de l'application et tous les fichiers contenus dans le déploiement.

Pour plus d'informations, consultez Vue d'ensemble du déploiement ClickOnce.

Emplacement des fichiers

Le fichier manifeste de déploiement référence le manifeste d'application correct pour la version actuelle de l'application. Lorsque vous mettez une nouvelle version du déploiement d'une application à la disposition des utilisateurs, vous devez mettre à jour le manifeste de déploiement pour faire référence au nouveau manifeste d'application.

Le fichier manifeste de déploiement doit posséder un nom fort et peut contenir également des certificats servant à la validation de l'éditeur.

Syntaxe des noms de fichiers

Le nom d'un fichier manifeste de déploiement doit se terminer par l'extension .application.

Exemples

Les exemples de code suivants illustrent des manifestes de déploiement relatifs à deux types de déploiement classiques.

Le premier exemple illustre un manifeste de déploiement visant à lancer une application ClickOnce. Une application ClickOnce qui est lancée n'est pas ajoutée au menu Démarrer de Windows ni à la boîte de dialogue Ajouter ou supprimer des programmes et utilise toujours la version la plus récente.

<?xml version="1.0" encoding="utf-8"?>
<asmv1:assembly xsi:schemaLocation="urn:schemas-microsoft-com:asm.v1 assembly.adaptive.xsd" manifestVersion="1.0" xmlns:dsig="http://www.w3.org/2000/09/xmldsig#" xmlns="urn:schemas-microsoft-com:asm.v2" xmlns:asmv1="urn:schemas-microsoft-com:asm.v1" xmlns:asmv2="urn:schemas-microsoft-com:asm.v2" xmlns:xrml="urn:mpeg:mpeg21:2003:01-REL-R-NS" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <assemblyIdentity name="ValidateChildrenWithConstraints.app" version="1.0.0.0" publicKeyToken="6c3d632f25ac9964" language="neutral" processorArchitecture="msil" xmlns="urn:schemas-microsoft-com:asm.v1" />
  <description asmv2:publisher="MS" asmv2:product="Validate With Constraints" xmlns="urn:schemas-microsoft-com:asm.v1" />
  <deployment install="false" minimumRequiredVersion="1.0.0.0" trustURLParameters="true">
    <deploymentProvider codebase="https://localhost/ValidateChildrenWithConstraints.application" />
  </deployment>
  <dependency>
    <dependentAssembly dependencyType="install" allowDelayedBinding="true" codebase="Debug\ValidateChildrenWithConstraints.exe.manifest" size="5912">
      <assemblyIdentity name="ValidateChildrenWithConstraints.exe" version="1.0.0.0" publicKeyToken="6c3d632f25ac9964" language="neutral" processorArchitecture="msil" type="win32" />
      <hash>
        <dsig:Transforms>
          <dsig:Transform Algorithm="urn:schemas-microsoft-com:HashTransforms.Identity" />
        </dsig:Transforms>
        <dsig:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" />
        <dsig:DigestValue>RokPpIeGiPcO/+UUi5thetccDTc=</dsig:DigestValue>
      </hash>
    </dependentAssembly>
  </dependency>

  <Signature Id="StrongNameSignature" xmlns="http://www.w3.org/2000/09/xmldsig#">
    ...
  </Signature>
</asmv1:assembly>

Le deuxième exemple illustre un manifeste de déploiement pour une application ClickOnce installée, qui vérifie pour les mises à jour avant l'exécution de l'application. Une application ClickOnce installée est ajoutée au menu Démarrer de Windows et un élément Ajouter ou supprimer des programmes est ajouté au Panneau de configuration. Il spécifie également une balise <deploymentProvider>, laquelle décrit un autre emplacement à interroger pour les mises à jour d'application.

<?xml version="1.0" encoding="utf-8"?>
<asmv1:assembly xsi:schemaLocation="urn:schemas-microsoft-com:asm.v1 assembly.adaptive.xsd" manifestVersion="1.0" xmlns:dsig="http://www.w3.org/2000/09/xmldsig#" xmlns="urn:schemas-microsoft-com:asm.v2" xmlns:asmv1="urn:schemas-microsoft-com:asm.v1" xmlns:asmv2="urn:schemas-microsoft-com:asm.v2" xmlns:xrml="urn:mpeg:mpeg21:2003:01-REL-R-NS" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <assemblyIdentity name="ValidateChildrenWithConstraints.app" version="1.0.0.0" publicKeyToken="6c3d632f25ac9964" language="neutral" processorArchitecture="msil" xmlns="urn:schemas-microsoft-com:asm.v1" />
  <description asmv2:publisher="MS" asmv2:product="Validate With Constraints" xmlns="urn:schemas-microsoft-com:asm.v1" />
  <deployment install="true" minimumRequiredVersion="1.0.0.0" trustURLParameters="true">
    <subscription>
      <update>
        <expiration maximumAge="2" unit="days" />
      </update>
    </subscription>
    <deploymentProvider codebase="https://localhost/ValidateChildrenWithConstraints.application" />
  </deployment>
  <dependency>
    <dependentAssembly dependencyType="install" allowDelayedBinding="true" codebase="Debug\ValidateChildrenWithConstraints.exe.manifest" size="5912">
      <assemblyIdentity name="ValidateChildrenWithConstraints.exe" version="1.0.0.0" publicKeyToken="6c3d632f25ac9964" language="neutral" processorArchitecture="msil" type="win32" />
      <hash>
        <dsig:Transforms>
          <dsig:Transform Algorithm="urn:schemas-microsoft-com:HashTransforms.Identity" />
        </dsig:Transforms>
        <dsig:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" />
        <dsig:DigestValue>RokPpIeGiPcO/+UUi5thetccDTc=</dsig:DigestValue>
      </hash>
    </dependentAssembly>
  </dependency>
  
  <Signature Id="StrongNameSignature" xmlns="http://www.w3.org/2000/09/xmldsig#">
    ...
  </Signature>
</asmv1:assembly>