Manifeste de déploiement ClickOnce

Article
06/10/2015

Un manifeste de déploiement est un fichier XML qui décrit un déploiement de 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 pour l'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.	install minimumRequiredVersion mapFileExtensions disallowUrlActivation trustUrlParameters
<compatibleFrameworks>, élément (Déploiement ClickOnce)	Obligatoire. Identifie les versions du .NET Framework dans lesquelles cette application peut être installée et exécutée.	SupportUrl
<dependency>, élément	Obligatoire. Identifie la version de l'application à installer pour le déploiement et l'emplacement du manifeste d'application.	preRequisite visible dependencyType codebase size
<publisherIdentity>, élément (Déploiement ClickOnce)	Requis pour les manifestes signés. Contient les informations relatives à l'éditeur qui a signé ce manifeste de déploiement.	Name issuerKeyHash
<Signature>, élément	Facultatif. Contient les informations nécessaires à la signature numérique de ce manifeste de déploiement.	Aucun
<customErrorReporting>, élément (Déploiement ClickOnce)	Facultatif. Spécifie un URI à afficher lorsqu'une erreur se produit.	Uri

Notes

Le fichier de manifeste de déploiement identifie un déploiement de l'application ClickOnce, notamment la version actuelle et 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 Sécurité et déploiement ClickOnce.

Emplacement du fichier

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 fichier

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

Exemples

L'exemple de code suivant illustre un manifeste de déploiement.

<?xml version="1.0" encoding="utf-8"?>
<asmv1:assembly xsi:schemaLocation="urn:schemas-microsoft-com:asm.v1 assembly.adaptive.xsd"
  manifestVersion="1.0"
  xmlns:asmv3="urn:schemas-microsoft-com:asm.v3"
  xmlns:dsig=http://www.w3.org/2000/09/xmldsig#
  xmlns:co.v1="urn:schemas-microsoft-com:clickonce.v1"
  xmlns:co.v2="urn:schemas-microsoft-com:clickonce.v2"
  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="My Application Deployment.app"
    version="1.0.0.0"
    publicKeyToken="43cb1e8e7a352766"
    language="neutral"
    processorArchitecture="x86"
    xmlns="urn:schemas-microsoft-com:asm.v1" />
  <description
    asmv2:publisher="My Company Name"
    asmv2:product="My Application"
    xmlns="urn:schemas-microsoft-com:asm.v1" />
  <deployment install="true">
    <subscription>
      <update>
        <expiration maximumAge="0" unit="days" />
      </update>
    </subscription>
    <deploymentProvider codebase="\\myServer\sampleDeployment\MyApplicationDeployment.application" />
  </deployment>
  <compatibleFrameworks xmlns="urn:schemas-microsoft-com:clickonce.v2">
    <framework targetVersion="4.0" profile="Full" supportedRuntime="4.0.20506" />
    <framework targetVersion="4.0" profile="Client" supportedRuntime="4.0.20506" />
  </compatibleFrameworks>
  <dependency>
    <dependentAssembly
      dependencyType="install"
      codebase="1.0.0.0\My Application Deployment.exe.manifest"
      size="6756">
      <assemblyIdentity
        name="My Application Deployment.exe"
        version="1.0.0.0"
        publicKeyToken="43cb1e8e7a352766"
        language="neutral"
        processorArchitecture="x86"
        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>E506x9FwNauks7UjQywmzgtd3FE=</dsig:DigestValue>
      </hash>
    </dependentAssembly>
  </dependency>
<publisherIdentity name="CN=DOMAIN\MyUsername" issuerKeyHash="18312a18a21b215ecf4cdb20f5a0e0b0dd263c08" /><Signature Id="StrongNameSignature" xmlns="http://www.w3.org/2000/09/xmldsig#">
…
</Signature></asmv1:assembly>

Voir aussi

Concepts

Publication d'applications ClickOnce

Partager via