Manifesto di distribuzione ClickOnce

Aggiornamento: novembre 2007

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 di 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 ClickOnce.	name version publicKeyToken processorArchitecture culture
Elemento <description>	Obbligatorio. Identifica le informazioni sull'applicazione utilizzate per creare una shell e l'elemento Installazione applicazioni nel Pannello di controllo.	publisher product supportUrl
Elemento <deployment>	Facoltativo. Identifica gli attributi utilizzati per la distribuzione degli aggiornamenti e l'esposizione al sistema.	isRequiredUpdate
Elemento <dependency>	Obbligatorio. Identifica la versione dell'applicazione da installare per la distribuzione e il percorso del manifesto dell'applicazione.	Nessuno
Elemento <Signature>	Facoltativo. Contiene le informazioni necessarie per apporre una firma digitale al manifesto di distribuzione.	none

Note

Il file manifesto di distribuzione identifica una distribuzione dell'applicazione ClickOnce, comprese 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 ulteriori informazioni, vedere Cenni preliminari sulla distribuzione ClickOnce.

Percorso dei file

Il file manifesto di 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 di distribuzione in modo che faccia riferimento al nuovo manifesto dell'applicazione.

Il file manifesto di 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 di distribuzione deve terminare con l'estensione application.

Esempi

Nell'esempio di codice riportato di seguito vengono illustrati i manifesti per due tipi comuni di distribuzione.

Nel primo esempio viene illustrato un manifesto di distribuzione per l'avvio di un'applicazione ClickOnce. Un'applicazione ClickOnce avviata non viene aggiunta al menu di avvio di Windows né all'elenco Installazione applicazioni e utilizza sempre la versione più recente.

<?xml version="1.0" encoding="utf-8"?>
<asmv1:assembly xsi:schemaLocation="urn:schemas-microsoft-com:asm.v1 assembly.adaptive.xsd" manifestVersion="1.0" xmlns:dsig="http://www.w3.org/2000/09/xmldsig#" 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="ValidateChildrenWithConstraints.app" version="1.0.0.0" publicKeyToken="6c3d632f25ac9964" language="neutral" processorArchitecture="msil" xmlns="urn:schemas-microsoft-com:asm.v1" />
  <description asmv2:publisher="MS" asmv2:product="Validate With Constraints" xmlns="urn:schemas-microsoft-com:asm.v1" />
  <deployment install="false" minimumRequiredVersion="1.0.0.0" trustURLParameters="true">
    <deploymentProvider codebase="https://localhost/ValidateChildrenWithConstraints.application" />
  </deployment>
  <dependency>
    <dependentAssembly dependencyType="install" allowDelayedBinding="true" codebase="Debug\ValidateChildrenWithConstraints.exe.manifest" size="5912">
      <assemblyIdentity name="ValidateChildrenWithConstraints.exe" version="1.0.0.0" publicKeyToken="6c3d632f25ac9964" language="neutral" processorArchitecture="msil" 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>RokPpIeGiPcO/+UUi5thetccDTc=</dsig:DigestValue>
      </hash>
    </dependentAssembly>
  </dependency>

  <Signature Id="StrongNameSignature" xmlns="http://www.w3.org/2000/09/xmldsig#">
    ...
  </Signature>
</asmv1:assembly>

Nel secondo esempio viene illustrato un manifesto di distribuzione per un'applicazione ClickOnce installata che verifica la disponibilità di aggiornamenti prima dell'esecuzione dell'applicazione. Un'applicazione ClickOnce installata viene aggiunta al menu di avvio di Windows e una voce appropriata viene aggiunta all'elenco Installazione applicazioni nel Pannello di controllo. Viene inoltre specificato un tag <deploymentProvider>, che descrive un percorso alternativo per effettuare il polling degli aggiornamenti dell'applicazione.

<?xml version="1.0" encoding="utf-8"?>
<asmv1:assembly xsi:schemaLocation="urn:schemas-microsoft-com:asm.v1 assembly.adaptive.xsd" manifestVersion="1.0" xmlns:dsig="http://www.w3.org/2000/09/xmldsig#" 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="ValidateChildrenWithConstraints.app" version="1.0.0.0" publicKeyToken="6c3d632f25ac9964" language="neutral" processorArchitecture="msil" xmlns="urn:schemas-microsoft-com:asm.v1" />
  <description asmv2:publisher="MS" asmv2:product="Validate With Constraints" xmlns="urn:schemas-microsoft-com:asm.v1" />
  <deployment install="true" minimumRequiredVersion="1.0.0.0" trustURLParameters="true">
    <subscription>
      <update>
        <expiration maximumAge="2" unit="days" />
      </update>
    </subscription>
    <deploymentProvider codebase="https://localhost/ValidateChildrenWithConstraints.application" />
  </deployment>
  <dependency>
    <dependentAssembly dependencyType="install" allowDelayedBinding="true" codebase="Debug\ValidateChildrenWithConstraints.exe.manifest" size="5912">
      <assemblyIdentity name="ValidateChildrenWithConstraints.exe" version="1.0.0.0" publicKeyToken="6c3d632f25ac9964" language="neutral" processorArchitecture="msil" 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>RokPpIeGiPcO/+UUi5thetccDTc=</dsig:DigestValue>
      </hash>
    </dependentAssembly>
  </dependency>
  
  <Signature Id="StrongNameSignature" xmlns="http://www.w3.org/2000/09/xmldsig#">
    ...
  </Signature>
</asmv1:assembly>

Vedere anche

Riferimenti

Elemento <assembly> (distribuzione ClickOnce)

Elemento <assemblyIdentity> (distribuzione ClickOnce)

Elemento <description> (distribuzione ClickOnce)

Elemento <deployment> (distribuzione ClickOnce)

Elemento <dependency> (distribuzione ClickOnce)

Elemento <Signature> (distribuzione ClickOnce)

Last updated on 2008-09-12

Condividi tramite