Manifesto di distribuzione ClickOnce

  • Articolo

Un manifesto di distribuzione è un file XML che descrive una distribuzione ClickOnce, inclusa l'identificazione della versione corrente dell'applicazione ClickOnce da distribuire.

I manifesti della distribuzione dispongono degli elementi e degli attributi riportati di seguito.

Elemento Descrizione Attributi
<Elemento assembly> Obbligatorio. Elemento di primo livello. manifestVersion
<Elemento assemblyIdentity> Obbligatorio. Identifica il manifesto dell'applicazione per l'applicazione ClickOnce. name

version

publicKeyToken

processorArchitecture

culture
<Elemento description> Obbligatorio. Identifica le informazioni sull'applicazione usate per creare una shell e l'elemento Installazione applicazioni nel Pannello di controllo. publisher

product

supportUrl
<Elemento deployment> Facoltativo. Identifica gli attributi usati per la distribuzione degli aggiornamenti e l'esposizione al sistema. install

minimumRequiredVersion

mapFileExtensions

disallowUrlActivation

trustUrlParameters
<Elemento compatibleFrameworks> Obbligatorio. Identifica le versioni di .NET Framework in cui è possibile installare ed eseguire questa applicazione. SupportUrl
<Elemento dependency> Obbligatorio. Identifica la versione dell'applicazione da installare per la distribuzione e il percorso del manifesto dell'applicazione. preRequisite

visible

dependencyType

codebase

size
<Elemento publisherIdentity> Obbligatorio per i manifesti firmati. Contiene informazioni sull'editore che ha firmato questo manifesto della distribuzione. Name

issuerKeyHash
<Elemento Signature> Facoltativo. Contiene le informazioni necessarie per apporre una firma digitale al manifesto della distribuzione. None
<Elemento customErrorReporting> Facoltativo. Specifica un URI da visualizzare quando si verifica un errore. URI

Osservazioni:

Il file manifesto della distribuzione identifica una distribuzione dell'applicazione ClickOnce, inclusa la versione corrente e altre impostazioni di distribuzione. Fa riferimento al manifesto dell'applicazione, che descrive la versione corrente dell'applicazione e tutti i file contenuti all'interno della distribuzione.

Per altre informazioni, vedere ClickOnce Security and Deployment.

Percorso del file

Il file manifesto della distribuzione fa riferimento al manifesto dell'applicazione corretto per la versione corrente dell'applicazione. Quando si rende disponibile una nuova versione di una distribuzione dell'applicazione, è necessario aggiornare il manifesto della distribuzione in modo che faccia riferimento al nuovo manifesto dell'applicazione.

Il file manifesto della distribuzione deve avere un nome sicuro e può anche contenere certificati per la convalida dell'editore.

Sintassi del nome file

Il nome di un file manifesto della distribuzione deve terminare con l'estensione application.

Esempi

L'esempio di codice seguente illustra un manifesto della distribuzione.

<?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>

Vedi anche