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 |
|---|---|---|
Obligatoire. Élément du niveau le plus haut. |
manifestVersion |
|
Obligatoire. Identifie le manifeste d'application pour l'application ClickOnce. |
name version publicKeyToken processorArchitecture culture |
|
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 |
|
Facultatif. Identifie les attributs utilisés pour le déploiement de mises à jour et l'exposition au système. |
install minimumRequiredVersion mapFileExtensions disallowUrlActivation trustUrlParameters |
|
Obligatoire. Identifie les versions du .NET Framework dans lesquelles cette application peut être installée et exécutée. |
SupportUrl |
|
Obligatoire. Identifie la version de l'application à installer pour le déploiement et l'emplacement du manifeste d'application. |
preRequisite visible dependencyType codebase size |
|
Requis pour les manifestes signés. Contient les informations relatives à l'éditeur qui a signé ce manifeste de déploiement. |
Name issuerKeyHash |
|
Facultatif. Contient les informations nécessaires à la signature numérique de ce manifeste de déploiement. |
Aucun |
|
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>