GenerateDeploymentManifest (attività)
Genera un manifesto della distribuzione ClickOnce. Un manifesto della distribuzione ClickOnce descrive la distribuzione di un'applicazione definendo un'identità univoca per la distribuzione, identificando i tratti di distribuzione, ad esempio la modalità di installazione o online, specificando le impostazioni di aggiornamento dell'applicazione e i percorsi di aggiornamento dell'applicazione e indicando il manifesto dell'applicazione ClickOnce corrispondente.
Parametri
La tabella seguente descrive 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, l'attività usa il valore "1.0.0.0". |
CreateDesktopShortcut |
Parametro Boolean facoltativo.Se true, durante l'installazione dell'applicazione ClickOnce viene creata un'icona sul desktop. |
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. Se tuttavia il parametro UpdateEnabled è impostato su true, è necessario specificare il percorso di aggiornamento. Il valore specificato deve essere un percorso URL o UNC completo. |
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 questo parametro è impostato su true, è possibile avviare l'applicazione solo dal menu Start. Il valore predefinito di questo 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 della distribuzione ClickOnce, questo input specifica il manifesto dell'applicazione ClickOnce. Se non viene specificato il parametro attività EntryPoint, il tag <customHostSpecified> viene inserito 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 seguendo questa procedura: 1. Risolvere i riferimenti all'assembly con una chiamata a ResolveAssemblyReference. 2. Passare l'output dell'attività precedente e l'assembly stesso a ResolveManifestFiles. 3. Passare le dipendenze usando il Dependencies parametro a GenerateApplicationManifest. |
ErrorReportUrl |
Parametro System.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 usare 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 usando la finestra di dialogo Installazione applicazioni. Se questo parametro è false, l'applicazione è destinata all'uso online da una pagina Web. Il valore predefinito di questo parametro è true. |
MapFileExtensions |
Parametro Boolean facoltativo.Specifica se viene usato il mapping dell'estensione di file deploy. Se il parametro è impostato su true, tutti i file di programma vengono pubblicati con l'estensione di file deploy. Questa opzione è utile per la sicurezza del server Web per limitare il numero di estensioni di file che devono essere sbloccate per abilitare la distribuzione dell'applicazione ClickOnce. Il valore predefinito di questo parametro è false. |
MaxTargetPath |
Parametro String facoltativo.Specifica la lunghezza massima consentita di un percorso di file in una distribuzione dell'applicazione ClickOnce. Se questo parametro è specificato, la lunghezza di ogni 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 questo input non è specificato o è uguale a zero, non viene eseguita alcuna verifica. |
MinimumRequiredVersion |
Parametro String facoltativo.Specifica se è possibile ignorare l'aggiornamento. Se viene usata 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 valori seguenti: - AnyCPU- x86- x64- ItaniumIl 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. Questo nome viene usato 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. Questo nome viene usato 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 percorso URL o UNC completo. |
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 l'applicazione è abilitata per gli aggiornamenti. Il valore predefinito di questo 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 di questo 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 valori seguenti: - Foreground- BackgroundIl valore predefinito di questo 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 valori seguenti:- Hours- Days- WeeksQuesto parametro è applicabile solo quando i parametri Install e UpdateEnabled sono entrambi impostati su true. |
Osservazioni:
Oltre ai parametri elencati sopra, questa attività eredita i parametri dalla classe GenerateManifestBase, che a sua volta eredita dalla classe Task. Per un elenco dei parametri della classe Task, vedere Classe di base Task.