Compilazione di applicazioni ClickOnce dalla riga di comando

Aggiornamento: Luglio 2008

In Visual Studio è possibile compilare progetti dalla riga di comando, anche se sono stati creati nell'ambiente di sviluppo integrato (IDE). Infatti, un progetto creato con Visual Studio può essere ricompilato su un altro computer in cui è installato solo .NET Framework. Questa caratteristica consente di ripetere una compilazione mediante un processo automatico, ad esempio in un sistema di compilazione centrale o tramite tecniche di scripting avanzate che non rientrano nell'ambito di compilazione del progetto stesso.

Utilizzo di MSBuild per riprodurre distribuzioni di applicazioni ClickOnce

Se chiamata dalla riga di comando, l'istruzione msbuild /target:publish indica al sistema MSBuild di compilare il progetto e creare un'applicazione ClickOnce nella cartella di pubblicazione. Questa operazione equivale a selezionare il comando Pubblica nell'ambiente di sviluppo integrato.

Questo comando consente di eseguire msbuild.exe, il cui percorso è definito nella variabile di ambiente PATH del prompt dei comandi di Visual Studio.

Il parametro target indica a MSBuild la modalità di elaborazione del comando. I valori disponibili per questo parametro sono build e publish. Il valore build equivale a selezionare il comando Genera o a premere F5 nell'ambiente di sviluppo integrato. Se si desidera soltanto compilare il progetto, è sufficiente digitare msbuild. Infatti, build è il valore predefinito del parametro target per tutti i progetti generati da Visual Studio Pertanto non è necessario specificare in modo esplicito la destinazione della compilazione. Di conseguenza, il comando msbuild è equivalente al comando msbuild /target:build.

Il comando /target:publish indica a MSBuild di richiamare la destinazione (target) di pubblicazione. Quest'ultima dipende dalla destinazione di compilazione. In altre parole, l'operazione di pubblicazione costituisce un superset dell'operazione di compilazione. Se ad esempio si apporta una modifica a uno dei file di origine Visual Basic o C#, l'assembly corrispondente verrà rigenerato automaticamente dall'operazione di pubblicazione.

Per informazioni sulla generazione di una distribuzione completa di un'applicazione ClickOnce utilizzando lo strumento della riga di comando Mage.exe per creare il manifesto di ClickOnce, vedere Procedura dettagliata: distribuzione manuale di un'applicazione ClickOnce.

Creazione e compilazione di un'applicazione ClickOnce di base mediante MSBuild

Per creare e pubblicare un progetto ClickOnce

1. Scegliere Nuovo progetto dal menu File. Verrà visualizzata la finestra di dialogo Nuovo progetto.

2. Selezionare Applicazione Windows, quindi assegnare al progetto il nome CmdLineDemo.

3. Scegliere Pubblica dal menu Compila.

   In questo modo, il progetto verrà configurato correttamente in modo da generare un'applicazione ClickOnce.

   Verrà visualizzata la Pubblicazione guidata.

4. Nella Pubblicazione guidata scegliere Fine.

   Verrà generata e visualizzata la pagina Web predefinita, denominata Publish.htm.

5. Salvare il progetto e prendere nota del percorso di cartella in cui è archiviato.

La procedura sopra riportata consente di creare un progetto ClickOnce che è stato pubblicato per la prima volta. A questo punto è possibile ripetere la compilazione all'esterno dell'ambiente di sviluppo integrato.

Per ripetere la compilazione dalla riga di comando

1. Chiudere Visual Studio.

2. Dal menu Start di Windows, scegliere Tutti i programmi, Microsoft Visual Studio 2008, Visual Studio Tools, quindi Prompt dei comandi di Visual Studio 2008. Verrà aperto un prompt dei comandi nella cartella principale dell'utente corrente.

3. Nella finestra Prompt dei comandi di Visual Studio 2008, spostarsi nel percorso contenente il progetto appena compilato. Digitare, ad esempio, chdir Documenti\Visual Studio\Projects\CmdLineDemo.

4. Per rimuovere i file esistenti generati durante la procedura "Per creare e pubblicare un progetto ClickOnce", digitare rmdir /s publish.

   Questo passaggio è facoltativo, ma garantisce che tutti i nuovi file siano stati creati mediante la compilazione dalla riga di comando.

5. Digitare msbuild /target:publish.

Mediante questa procedura verrà generata una distribuzione completa dell'applicazione ClickOnce in una sottocartella del progetto denominata Publish. CmdLineDemo.application è il manifesto di distribuzione di ClickOnce. La cartella CmdLineDemo_1.0.0.0 contiene i file CmdLineDemo.exe e CmdLineDemo.exe.manifest, ossia il manifesto dell'applicazione ClickOnce. Setup.exe è il programma di avvio automatico, che per impostazione predefinita è configurato per l'installazione di .NET Framework. La cartella DotNetFX contiene i file ridistribuibili per .NET Framework, necessari per la distribuzione dell'applicazione sul Web oppure tramite UNC o CD/DVD.

Proprietà di pubblicazione

Quando viene pubblicata l'applicazione nelle procedure sopra riportate, durante l'esecuzione della Pubblicazione guidata verranno inserite nel file di progetto le seguenti proprietà, che influiscono direttamente sul modo in cui verrà generata l'applicazione ClickOnce.

In CmdLineDemo.vbproj / CmdLineDemo.csproj:

<AssemblyOriginatorKeyFile>WindowsApplication3.snk</AssemblyOriginatorKeyFile>
<GenerateManifests>true</GenerateManifests>
<TargetZone>LocalIntranet</TargetZone>
<PublisherName>Microsoft</PublisherName>
<ProductName>CmdLineDemo</ProductName>
<PublishUrl>https://localhost/CmdLineDemo</PublishUrl>
<Install>true</Install>
<ApplicationVersion>1.0.0.*</ApplicationVersion>
<ApplicationRevision>1</ApplicationRevision>
<UpdateEnabled>true</UpdateEnabled>
<UpdateRequired>false</UpdateRequired>
<UpdateMode>Foreground</UpdateMode>
<UpdateInterval>7</UpdateInterval>
<UpdateIntervalUnits>Days</UpdateIntervalUnits>
<UpdateUrlEnabled>false</UpdateUrlEnabled>
<IsWebBootstrapper>true</IsWebBootstrapper>
<BootstrapperEnabled>true</BootstrapperEnabled>

È possibile eseguire l'override di una qualsiasi di queste proprietà dalla riga di comando senza modificare il file di progetto stesso. Ad esempio, per compilare la distribuzione dell'applicazione ClickOnce senza il programma di avvio automatico è possibile utilizzare il seguente comando:

msbuild /target:publish /property:BootstrapperEnabled=false

In Visual Studio le proprietà di pubblicazione possono essere definite nelle pagine delle proprietà Pubblica, Protezione e Firma di Progettazione progetti. Di seguito è riportata la descrizione di ognuna di queste proprietà e viene indicato come impostare la proprietà nei riquadri appropriati di Progettazione progetti.

• AssemblyOriginatorKeyFile specifica il file di chiave utilizzato per firmare i manifesti dell'applicazione ClickOnce. Questa chiave può anche essere utilizzata per assegnare un nome sicuro agli assembly. Questa proprietà viene impostata nella scheda Firma di Progettazione progetti.

Di seguito sono riportate le proprietà disponibili nella scheda Protezione.

• Attiva le impostazioni di sicurezza ClickOnce determina se i manifesti ClickOnce verranno generati. Al momento della creazione di un progetto, l'opzione di generazione del manifesto di ClickOnce è disattivata per impostazione predefinita. La prima volta che il progetto viene pubblicato mediante la procedura guidata, questo flag verrà attivato automaticamente.

• TargetZone determina il livello di attendibilità da definire nel manifesto dell'applicazione ClickOnce. I valori possibili sono Internet, LocalIntranet e Custom. Se si specifica Internet o LocalIntranet, nel manifesto dell'applicazione ClickOnce verrà creato un insieme di autorizzazioni predefinito. LocalIntranet è il valore predefinito e corrisponde al livello di attendibilità totale. Il valore Custom specifica che nel manifesto dell'applicazione ClickOnce devono essere create soltanto le autorizzazioni indicate esplicitamente nel file app.manifest di base. Quest'ultimo è un file di manifesto parziale contenente soltanto le definizioni delle informazioni sull'attendibilità. Questo file è nascosto e viene aggiunto automaticamente al progetto quando si configurano le autorizzazioni nella scheda Protezione.

Di seguito sono riportate le proprietà disponibili nella scheda Pubblica.

• PublishUrl indica il percorso in cui verrà pubblicata l'applicazione nell'ambiente di sviluppo integrato. Questo valore verrà inserito nel manifesto dell'applicazione ClickOnce, se le proprietà InstallUrl e UpdateUrl non sono specificate.

• ApplicationVersion indica la versione dell'applicazione ClickOnce. La versione è costituita da un numero a quattro cifre. Se l'ultima cifra è un asterisco (*), il valore inserito nel manifesto in fase di compilazione verrà sostituito con quello della proprietà ApplicationRevision.

• ApplicationRevision indica la revisione. Si tratta di un valore integer che viene incrementato a ogni pubblicazione dell'applicazione nell'ambiente di sviluppo integrato. Questo valore non viene incrementato automaticamente per le compilazioni eseguite dalla riga di comando.

• Install determina se l'applicazione deve essere installata o eseguita dal Web.

• InstallUrl (non visualizzata) indica il percorso da cui gli utenti eseguiranno l'installazione dell'applicazione. Se specificato, questo valore verrà copiato nel programma di avvio automatico setup.exe, purché la proprietà IsWebBootstrapper sia attivata. Verrà inoltre inserito nel manifesto dell'applicazione, se la proprietà UpdateUrl non è specificata.

• SupportUrl (non visualizzata) indica il percorso del collegamento relativo a un'applicazione inclusa nella finestra di dialogo Installazione applicazioni.

Di seguito sono riportate le proprietà disponibili nella finestra di dialogo Aggiornamenti applicazione, accessibile dalla scheda Pubblica.

• UpdateEnabled indica se l'applicazione deve verificare o meno la disponibilità di eventuali aggiornamenti.

• UpdateMode specifica se il controllo degli aggiornamenti deve essere eseguito o meno in background.

• UpdateInterval specifica la frequenza con cui l'applicazione deve verificare la disponibilità di eventuali aggiornamenti.

• UpdateIntervalUnits specifica se il valore di UpdateInterval è espresso in ore, giorni o settimane.

• UpdateUrl (non visualizzata) indica il percorso da cui l'applicazione riceverà gli aggiornamenti. Se specificato, questo valore verrà inserito nel manifesto dell'applicazione.

• Di seguito sono riportate le proprietà disponibili nella finestra di dialogo Opzioni di pubblicazione, accessibile dalla scheda Pubblica.

• PublisherName specifica il nome dell'editore indicato nel messaggio visualizzato durante l'installazione o l'esecuzione dell'applicazione. Nel caso di un'applicazione installata, viene inoltre utilizzato per specificare il nome della cartella nel menu di avvio.

• ProductName specifica il nome del prodotto indicato nel messaggio visualizzato durante l'installazione o l'esecuzione dell'applicazione. Nel caso di un'applicazione installata, viene inoltre utilizzato per specificare il nome del collegamento nel menu di avvio.

• Di seguito sono riportate le proprietà disponibili nella finestra di dialogo Prerequisiti, accessibile dalla scheda Pubblica.

• BootstrapperEnabled determina se il programma di avvio automatico setup.exe deve essere generato.

• IsWebBootstrapper determina se il programma di avvio automatico setup.exe deve essere eseguito sul Web o in modalità basata su disco.

InstallURL, SupportUrl e PublishURL

È possibile specificare tre URL:InstallURL,SupportUrl e PublishURL. Se l'applicazione deve essere pubblicata in un URL sul Web, è necessario specificare soltanto la proprietà PublishURL. Gli altri URL devono essere specificati solo se sono diversi da quello impostato nella proprietà PublishURL. Nell'ambiente di sviluppo integrato può essere opportuno pubblicare l'applicazione in un percorso diverso da quello utilizzato dagli utenti finali per l'installazione. È possibile, ad esempio, impostare la proprietà PublishURL su un percorso FTP e la proprietà InstallURL su un URL Web. In questo caso, la proprietà PublishURL verrà utilizzata nell'ambiente di sviluppo integrato soltanto per il trasferimento dei file, ma non per le operazioni di compilazione dalla riga di comando. Infine, è possibile utilizzare la proprietà UpdateUrl se si desidera pubblicare un'applicazione ClickOnce i cui aggiornamenti vengono scaricati automaticamente da un percorso diverso da quello di installazione.

Vedere anche

Attività

Procedura dettagliata: distribuzione manuale di un'applicazione ClickOnce

Concetti

Cenni preliminari su MSBuild

Altre risorse

Distribuzione ClickOnce

Cronologia delle modifiche

Data	Cronologia	Motivo
Luglio 2008	Aggiornato l'elenco dei valori validi per la proprietà TargetZone.	Correzione di errori nel contenuto.