Manifesti di distribuzione per le soluzioni Office (System 2003)
Aggiornamento: novembre 2007
Nota |
Si applica a |
---|---|
Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazione. |
Tipo di progetto
Versione Microsoft Office
|
Un manifesto di distribuzione è un file XML in cui sono illustrate le impostazioni di distribuzione di una soluzione Visual Studio Tools per Office> e in cui viene identificata la versione corrente dell'applicazione da distribuire.
In Visual Studio Tools per Office viene utilizzato un sottoinsieme dello schema di manifesto di distribuzione definito per ClickOnce. Solo gli elementi e gli attributi elencati in questa tabella sono supportati per le soluzioni Visual Studio Tools per Office. Gli elementi e gli attributi che fanno parte dello schema ClickOnce, ma che non sono elencati nella tabella, vengono ignorati senza che questo comporti la generazione di un errore.
I manifesti di distribuzione Visual Studio Tools per Office dispongono degli elementi e degli attributi seguenti.
Elemento |
Descrizione |
Attributi |
---|---|---|
Elemento <assembly> (Riferimento Visual Studio Tools per Office Deployment) |
Obbligatorio. Elemento di primo livello. |
manifestVersion |
Elemento <assemblyIdentity> (Riferimento Visual Studio Tools per Office Deployment) |
Obbligatorio. Identifica il manifesto dell'applicazione per la soluzione. |
name version language publicKeyToken processorArchitecture |
Elemento <description> (Riferimento Visual Studio Tools per Office Deployment) |
Obbligatorio. Fornisce informazioni sull'applicazione, utilizzate per creare una shell e l'elemento Installazione applicazioni nel Pannello di controllo. |
publisher product |
Elemento <dependency> (Riferimento Visual Studio Tools per Office Deployment) |
Obbligatorio. Identifica la versione della soluzione da installare per la distribuzione e il percorso del manifesto dell'applicazione. |
name version |
Elemento <deployment> (Riferimento Visual Studio Tools per Office Deployment) |
Facoltativo. Identifica gli attributi utilizzati per la distribuzione degli aggiornamenti e l'esposizione al sistema. |
install |
Elemento <dependentAssembly> (Riferimento Visual Studio Tools per Office Deployment) |
Obbligatorio. |
codebase size hash hashalg |
Note
Il file manifesto della distribuzione identifica la versione corrente di una soluzione. Fa riferimento al manifesto dell'applicazione, che descrive la soluzione e tutti i file contenuti all'interno della versione corrente. Quando si rende disponibile una nuova versione di una soluzione, è necessario aggiornare il manifesto di distribuzione per fare riferimento al nuovo manifesto dell'applicazione. Durante l'esecuzione della soluzione, il runtime rileva automaticamente la nuova versione del manifesto di distribuzione. Il nuovo manifesto dell'applicazione specificato nel manifesto di distribuzione viene quindi scaricato per sostituire quello precedente.
L'attività GenerateDeployManifest di MSBuild genera il manifesto di distribuzione nella cartella di output. Questa attività viene richiamata dalla Pubblicazione guidata e inoltre quando si compila un progetto Visual Studio Tools per Office dalla riga di comando e si specifica una destinazione di pubblicazione. Per ulteriori informazioni, vedere Attività GenerateDeploymentManifest.
A differenza dei manifesti ClickOnce, i manifesti dell'applicazione e quelli di distribuzione nelle soluzioni Visual Studio Tools per Office non sono firmati. I manifesti non possono essere convalidati prima del loro utilizzo.
Alcuni dei campi presenti nei manifesti dell'applicazione e di distribuzione generati tramite gli strumenti di pubblicazione non vengono utilizzati nelle soluzioni Visual Studio Tools per Office, inclusi alcuni campi che identificano proprietà dell'assembly come le dimensioni e la versione.
Sintassi del nome file
Il nome di un manifesto di distribuzione deve avere l'estensione APPLICATION.
Esempio
Nell'esempio di codice seguente viene illustrato un manifesto di distribuzione relativo a una soluzione Visual Studio Tools per Office.
<?xml version="1.0" encoding="utf-8"?>
<asmv1:assembly xsi:schemaLocation=
"urn:schemas-microsoft-com:asm.v1 assembly.adaptive.xsd"
manifestVersion="1.0"
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="http://www.xrml.org/schema/2001/11/xrml2core"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<assemblyIdentity name="ExcelApplication1.application"
version="1.0.0.1" publicKeyToken="0000000000000000"
language="neutral" processorArchitecture="msil"
xmlns="urn:schemas-microsoft-com:asm.v1" />
<description asmv2:publisher="MS .NET"
asmv2:product="ExcelApplication1"
xmlns="urn:schemas-microsoft-com:asm.v1">Deployment
manifest description here.</description>
<deployment install="false" />
<dependency>
<dependentAssembly
codebase="ExcelApplication1_1.0.0.1\
ExcelApplication1.manifest" size="2518"
hash="0DE6E54FDCF3334A23D627402EF65668CBFB8587"
hashalg="SHA1">
<assemblyIdentity name="ExcelApplication1.manifest"
version="1.0.0.1" />
<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>
qws6Ku5WQeMv12bE1W5deGkSHcY=
</dsig:DigestValue>
</hash>
</dependentAssembly>
</dependency>
</asmv1:assembly>
Vedere anche
Attività
Procedura: modificare la posizione delle personalizzazioni a livello di documento (System 2003)
Concetti
Distribuzione delle personalizzazioni a livello di documento (2003 System)
Manifesti dell'applicazione e di distribuzione nelle soluzioni di Office