Manifesto dell'applicazione ClickOnce

Articolo
09/12/2008

Aggiornamento: novembre 2007

Un manifesto dell'applicazione è un file XML che descrive un'applicazione distribuita mediante ClickOnce.

I manifesti delle applicazioni dispongono degli elementi e degli attributi riportati di seguito.

Elemento	Descrizione	Attributi
Elemento <assembly> (applicazione ClickOnce)	Obbligatorio. Elemento di livello superiore.	manifestVersion
Elemento <assemblyIdentity> (applicazione ClickOnce)	Obbligatorio. Identifica l'assembly primario dell'applicazione ClickOnce.	name version publicKeyToken processorArchitecture language
Elemento <trustInfo> (applicazione ClickOnce)	Identifica i requisiti di protezione dell'applicazione.	Nessuno
Elemento <entryPoint> (applicazione ClickOnce)	Obbligatorio. Identifica il punto di ingresso del codice dell'applicazione per l'esecuzione.	Nessuno
Elemento <dependency> (applicazione ClickOnce)	Obbligatorio. Identifica ciascuna dipendenza richiesta per l'esecuzione dell'applicazione. Può anche identificare gli assembly che è necessario preinstallare.	Nessuno
Elemento <file> (applicazione ClickOnce)	Obbligatorio. Identifica ciascun file non assembly utilizzato dall'applicazione. Può includere i dati sull'isolamento COM (Component Object Model) associati al file.	name size
Elemento <fileAssociation> (applicazione ClickOnce)	Facoltativo. Identifica un'estensione di file da associare all'applicazione.	extension description progid defaultIcon

Note

Il file manifesto dell'applicazione identifica un'applicazione distribuita mediante ClickOnce. Per ulteriori informazioni su ClickOnce, vedere Cenni preliminari sulla distribuzione ClickOnce.

Percorso dei file

Un manifesto dell'applicazione è specifico per una singola versione di una distribuzione. Per questo motivo, i manifesti dell'applicazione devono essere memorizzati separatamente da quelli di distribuzione. Di solito vengono inseriti in una sottodirectory a cui viene assegnato un nome in base alla versione associata.

Il manifesto dell'applicazione deve essere sempre firmato prima della distribuzione. Per ulteriori informazioni, vedere Procedura dettagliata: distribuzione manuale di un'applicazione ClickOnce.

Sintassi del nome di file

Il nome di un file manifesto dell'applicazione deve essere composto dal nome completo e dall'estensione dell'applicazione identificati nell'elemento assemblyIdentity, seguiti dall'estensione manifest. Per un manifesto dell'applicazione che fa riferimento, ad esempio, all'applicazione Example.exe verrà utilizzata la sintassi del nome di file riportata di seguito.

example.exe.manifest

Esempio

Nell'esempio di codice riportato di seguito viene illustrato un manifesto per un'applicazione ClickOnce. È costituito da un unico file eseguibile (exe), un assembly dipendente e un file di configurazione contenente le impostazioni dell'applicazione.

<?xml version="1.0" encoding="utf-8"?>
<asmv1:assembly xmlns="urn:schemas-microsoft-com:asm.v2" manifestVersion="1.0" xmlns:asmv1="urn:schemas-microsoft-com:asm.v1" xmlns:asmv2="urn:schemas-microsoft-com:asm.v2" xmlns:dsig="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:schemas-microsoft-com:asm.v1 assembly.adaptive.xsd">
  <!--Application Manifest Generated by ClickOnce MG. SCHEMA VERSION 2.0.0.13-PRE.ADAPTIVE-->
  <asmv1:assemblyIdentity name="DatumCorpApp.exe" version="1.0.0.0" publicKeyToken="0000000000000000" processorArchitecture="msil" />
  <entryPoint>
    <assemblyIdentity name="DatumCorpApp" version="1.0.0.0" processorArchitecture="msil" language="neutral" />
    <commandLine file="DatumCorpApp.exe" parameters="" />
  </entryPoint>
  <trustInfo>
    <security>
      <applicationRequestMinimum>
        <PermissionSet ID="FullTrust" Unrestricted="true" />
        <defaultAssemblyRequest permissionSetReference="FullTrust" />
      </applicationRequestMinimum>
    </security>
  </trustInfo>
  <!--Application Files-->
  <file name="DatumCorpApp.exe.config" size="228">
    <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>e1diZjAqZT5NNRAxTqoWKSK4iPE=</dsig:DigestValue>
    </hash>
  </file>

  <!--Assemblies-->
  <dependency>
    <dependentAssembly codebase="DatumCorpApp.exe" size="32768">
      <assemblyIdentity name=" DatumCorpApp " version="1.0.0.0" processorArchitecture="msil" language="neutral" />
      <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>gybeo+fVPiXh8vsbatWFGx6mtgk=</dsig:DigestValue>
      </hash>
    </dependentAssembly>
  </dependency>
  <dependency>
    <dependentAssembly codebase="DatumCorpHelper.dll" size="33280">
      <assemblyIdentity name="DatumCorpHelper" version="4.0.0.0" publicKeyToken="e8ed396099c4b4e9" processorArchitecture="msil" language="Neutral" />
      <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>w+C0sOgi3IxbwoGK+IAsoa37z6Y=</dsig:DigestValue>
      </hash>
    </dependentAssembly>
  </dependency>

  <!--Microsoft Common Language Runtime Platform Version Required-->
  <dependency>
    <dependentAssembly preRequisite="true">
      <assemblyIdentity name="Microsoft-Windows-CLRCoreComp" version="2.0.31121.0" />
    </dependentAssembly>
  </dependency>

  <!--Microsoft Windows Operating System Platform Dependency-->
  <dependency>
    <dependentOS supportUrl="https://www.microsoft.com" description="Microsoft Windows Operating System">
      <osVersionInfo>
        <os majorVersion="4" minorVersion="10" />
      </osVersionInfo>
    </dependentOS>
  </dependency>
</asmv1:assembly>