Partager via


Manifeste de déploiement ClickOnce

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