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:
|
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:
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:
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:
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 GenerateManifest, che eredita dalla classe Task. Per un elenco dei parametri della classe Task, vedere Classe di base Task.
Vedere anche
Riferimenti
Attività GenerateApplicationManifest