Condividi tramite


Attività GenerateDeploymentManifest

Consente di generare un manifesto di distribuzione ClickOnce. In un manifesto di distribuzione ClickOnce viene descritta la distribuzione di un'applicazione definendone un'identità univoca, identificando caratteristiche di distribuzione quali la modalità di installazione o la modalità online, specificando impostazioni e percorsi di aggiornamento dell'applicazione e indicando il manifesto dell'applicazione ClickOnce corrispondente.

Parametri

Nella tabella riportata di seguito sono descritti i parametri dell'attività GenerateDeploymentManifest.

Parametro

Descrizione

AssemblyName

Parametro String facoltativo.

Specifica il campo Name relativo all'identità dell'assembly per il manifesto generato. Se questo parametro non è specificato, il nome viene dedotto dal parametro EntryPoint o InputManifest. Se non è possibile dedurre il nome, viene generato un errore.

AssemblyVersion

Parametro String facoltativo.

Specifica il campo Version relativo all'identità dell'assembly per il manifesto generato. Se questo parametro non è specificato, per l'attività viene utilizzato il valore "1.0.0.0".

CreateDesktopShortcut

Parametro Boolean facoltativo.

Se true, viene creata un'icona creata sul desktop durante l'installazione dell'applicazione ClickOnce.

DeploymentUrl

Parametro String facoltativo.

Specifica il percorso di aggiornamento per l'applicazione. Se questo parametro non è specificato, non viene definito alcun percorso di aggiornamento per l'applicazione. Tuttavia, se il parametro UpdateEnabled è impostato su true, è necessario specificare il percorso di aggiornamento. Il valore specificato deve essere un URL completo o un percorso UNC.

Description

Parametro String facoltativo.

Specifica una descrizione facoltativa per l'applicazione.

DisallowUrlActivation

Parametro Boolean facoltativo.

Specifica se l'applicazione deve essere eseguita automaticamente quando viene aperta tramite un URL. Se il parametro è impostato su true, è possibile avviare l'applicazione solo dal menu Start. Il valore predefinito del parametro è false. Questo input è applicabile solo quando il valore del parametro Install è impostato su true.

EntryPoint

Parametro ITaskItem[] facoltativo.

Indica il punto di ingresso per l'assembly del manifesto generato. Per un manifesto di distribuzione ClickOnce questo input specifica il manifesto dell'applicazione ClickOnce.

Per generare un manifesto dell'applicazione in Visual Studio 2005, l'attività Attività GenerateApplicationManifest richiede un EntryPoint. Gli assembly o i manifesti nativi non richiedono un EntryPoint. Questo requisito è stato applicato con l'errore di compilazione: "MSB3185: EntryPoint non specificato per il manifesto".

In MSBuild non viene generato questo errore quando non viene specificato il parametro EntryPoint dell'attività. Al contrario, viene inserito il tag <customHostSpecified> come figlio del tag <entryPoint>, ad esempio:

<entryPoint xmlns="urn:schemas-

microsoft-com:asm.v2">

<co.v1:customHostSpecified />

</entryPoint>

È possibile aggiungere dipendenze DLL al manifesto dell'applicazione utilizzando i passaggi seguenti:

  1. Risolvere i riferimenti dell'assembly con una chiamata a ResolveAssemblyReference.

  2. Passare l'output dell'attività precedente e l'assembly stesso a ResolveManifestFiles.

  3. Passare le dipendenze utilizzando il parametro Dependencies a GenerateApplicationManifest.

ErrorReportUrl

Parametro [String] facoltativo.

Specifica l'URL della pagina Web visualizzata nelle finestre di dialogo durante le installazioni ClickOnce.

InputManifest

Parametro ITaskItem facoltativo.

Indica un documento XML di input da utilizzare come base per il generatore del manifesto. In questo modo è possibile applicare nel manifesto di output dati strutturati, ad esempio definizioni del manifesto personalizzate. L'elemento radice del documento XML deve essere un nodo assembly nello spazio dei nomi asmv1.

Install

Parametro Boolean facoltativo.

Specifica se si tratta di un'applicazione installata o di un'applicazione disponibile solo online. Se il parametro è impostato su true, l'applicazione verrà installata nel menu Start dell'utente e potrà essere rimossa utilizzando la finestra di dialogo Installazione applicazioni. Se il parametro è invece impostato su false, l'applicazione è destinata all'utilizzo online da una pagina Web. Il valore predefinito del parametro è true.

MapFileExtensions

Parametro Boolean facoltativo.

Specifica se viene utilizzato il mapping dell'estensione di file deploy. Se il parametro è impostato su true, tutti i file di programma vengono pubblicati con l'estensione file deploy. Questa opzione è utile per la sicurezza del server Web, per limitare il numero di estensioni file che è necessario sbloccare per attivare la distribuzione delle applicazioni ClickOnce. Il valore predefinito del parametro è false.

MaxTargetPath

Parametro String facoltativo.

Specifica la lunghezza massima consentita di un percorso file nella distribuzione di un'applicazione ClickOnce. Se questo parametro è specificato, la lunghezza di ciascun percorso di file dell'applicazione viene verificata a fronte di tale limite. Per tutti gli elementi che superano il limite verrà visualizzato un avviso di compilazione. Se l'input non viene specificato o è uguale a zero, non verrà eseguita alcuna verifica.

MinimumRequiredVersion

Parametro String facoltativo.

Specifica se è possibile ignorare l'aggiornamento. Se viene utilizzata una versione precedente rispetto a quella minima richiesta, non sarà possibile ignorare l'aggiornamento. Questo parametro è applicabile solo quando il parametro Install è impostato su true.

OutputManifest

Parametro ITaskItem facoltativo.

Specifica il nome del file del manifesto di output generato. Se questo parametro non è specificato, il nome del file di output viene dedotto dall'identità del manifesto generato.

Platform

Parametro String facoltativo.

Specifica la piattaforma di destinazione dell'applicazione. Per il parametro è possibile specificare i seguenti valori:

  • AnyCPU

  • x86

  • x64

  • Itanium

Il valore predefinito è AnyCPU.

Product

Parametro String facoltativo.

Specifica il nome dell'applicazione. Se questo parametro non è specificato, il nome viene dedotto dall'identità del manifesto generato. Tale nome viene utilizzato per il collegamento nel menu Start e fa parte del nome visualizzato nella finestra di dialogo Installazione applicazioni.

Publisher

Parametro String facoltativo.

Specifica l'editore dell'applicazione. Se questo parametro non è specificato, il nome viene dedotto dall'utente registrato o dall'identità del manifesto generato. Tale nome viene utilizzato per la cartella nel menu Start e fa parte del nome visualizzato nella finestra di dialogo Installazione applicazioni.

SuiteNamel

Parametro String facoltativo.

Specifica il nome della cartella del menu Start in cui si trova l'applicazione dopo la distribuzione ClickOnce.

SupportUrl

Parametro String facoltativo.

Specifica il collegamento visualizzato per l'applicazione nella finestra di dialogo Installazione applicazioni. Il valore specificato deve essere un URL completo o un percorso UNC.

TargetCulture

Parametro String facoltativo.

Identifica le impostazioni cultura dell'applicazione e specifica il campo Language relativo all'identità dell'assembly per il manifesto generato. Se questo parametro non viene specificato, si presuppone che l'applicazione sia indipendente dalle impostazioni cultura.

TrustUrlParameters

Parametro Boolean facoltativo.

Specifica se i parametri della stringa di query dell'URL devono essere disponibili per l'applicazione. Il valore predefinito del parametro è false e indica che i parametri non saranno disponibili per l'applicazione.

UpdateEnabled

Parametro Boolean facoltativo.

Indica se per l'applicazione sono attivati gli aggiornamenti. Il valore predefinito del parametro è false. Questo parametro è applicabile solo quando il parametro Install è impostato su true.

UpdateInterval

Parametro Int32 facoltativo.

Specifica l'intervallo di aggiornamento per l'applicazione. Il valore predefinito del parametro è zero. Questo parametro è applicabile solo quando i parametri Install e UpdateEnabled sono entrambi impostati su true.

UpdateMode

Parametro String facoltativo.

Specifica se è necessario verificare gli aggiornamenti in primo piano prima dell'avvio dell'applicazione o in background durante l'esecuzione dell'applicazione. Per il parametro è possibile specificare i seguenti valori:

  • Foreground

  • Background

Il valore predefinito del parametro è Background. Questo parametro è applicabile solo quando i parametri Install e UpdateEnabled sono entrambi impostati su true.

UpdateUnit

Parametro String facoltativo.

Specifica le unità per il parametro UpdateInterval. Per il parametro è possibile specificare i seguenti valori:

  • Hours

  • Days

  • Weeks

Questo parametro è applicabile solo quando i parametri Install e UpdateEnabled sono entrambi impostati su true.

Note

Oltre ai parametri sopra elencati, questa attività eredita i parametri dalla classe GenerateManifestBase, che eredita dalla classe Task. Per un elenco dei parametri della classe Task, vedere Classe di base Task.

Vedere anche

Riferimenti

Attività GenerateApplicationManifest

Attività SignFile

Concetti

Attività di MSBuild

Altre risorse

Riferimenti delle attività MSBuild