Manifeste de déploiement ClickOnce

Article
03/10/2023

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

Publier des applications ClickOnce

Partager via