Manifeste de déploiement ClickOnce

  • Article

Un manifeste de déploiement est un fichier XML qui décrit un déploiement ClickOnce, y compris l’identification de 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 de niveau supérieur. manifestVersion
<assemblyIdentity> Élément Obligatoire. Identifie le manifeste de l’application ClickOnce. name

version

publicKeyToken

processorArchitecture

culture
<description> Élément Obligatoire. Identifie les informations de l’application utilisées pour créer la présence d’un shell et l’élément Ajout/Suppression de 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 Obligatoire. Identifie les versions du .NET Framework pour lesquelles cette application peut s'installer et s'exécuter. 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 Requis pour les manifestes signés. Contient des informations sur l'éditeur qui a signé ce manifeste de déploiement. Name

issuerKeyHash
<Signature> Élément facultatif. Contient les informations nécessaires pour signer numériquement ce manifeste de déploiement. None
<customErrorReporting> Élément facultatif. Spécifie un URI à afficher en cas d'erreur. Uri

Notes

Le fichier manifeste de déploiement identifie un déploiement d’application ClickOnce, y compris la version actuelle et d’autres paramètres de déploiement. Il fait référence au 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 ClickOnce Security and Deployment.

Emplacement du fichier

Le fichier manifeste de déploiement fait référence au manifeste d'application correct pour la version actuelle de l'application. Quand vous mettez à disposition une nouvelle version d'un déploiement d'application, 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 avoir un nom fort et peut également contenir des certificats pour la validation de l'éditeur.

Syntaxe du nom 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