Procedura dettagliata: configurazione di Team Build per la compilazione di un progetto di installazione di Visual Studio

Articolo
09/12/2008

Aggiornamento: novembre 2007

È possibile personalizzare Team Foundation Build aggiungendo attività personalizzate o utilizzando attività di MSBuild eseguite in un punto specificato durante il processo di compilazione. In questo argomento vengono illustrati i passaggi necessari per personalizzare una definizione di compilazione per utilizzare l'attività Exec di MSBuild allo scopo di compilare un progetto di installazione di Visual Studio.

Prerequisiti

Per completare questa procedura dettagliata, sono necessari i seguenti elementi:

Un computer client con:

Development Edition installato
Team Explorer installato
Una connessione disponibile a Team Foundation Server
Una directory locale da utilizzare come area di lavoro

Un progetto Team con:

Una definizione di compilazione creata
Un'area di lavoro per il controllo del codice sorgente mappata alla directory locale.

Per ulteriori informazioni, vedere Procedura: creare un'area di lavoro mappata. In questa procedura dettagliata viene utilizzata l'area di lavoro locale C:\ProgettiDistribuzione.
Il controllo del codice sorgente attivato
1. Per verificare che Visual Studio sia configurato per l'utilizzo di Controllo della versione di Team Foundation, scegliere Opzioni dal menu Strumenti, quindi Controllo del codice sorgente.
2. Selezionare Visual Studio Team Foundation Server nella casella di riepilogo Plug-in del controllo del codice sorgente corrente.

A build agent with Team Foundation Build installed.

Visual Studio deve essere installato nell'agente di compilazione affinché sia possibile utilizzare l'attività Exec di MSBuild per chiamare devenv.exe per la compilazione di un progetto di installazione. Per ulteriori informazioni, vedere Attività Exec e Opzioni della riga di comando devenv.

Nota:
L'agente di compilazione è un computer sul quale sono eseguite le compilazioni. Per ulteriori informazioni, vedere Procedura: creare e gestire agenti di compilazione.

Autorizzazioni necessarie

Per completare queste procedura guidata, è necessario disporre delle autorizzazioni Amministra compilazione e Amministra aree di lavoro impostate su Consenti. È inoltre necessario che le autorizzazioni Archivia ed Estrai siano impostate su Consenti.

Per creare un progetto Team, è necessario disporre dell'autorizzazione Crea nuovi progetti impostata su Consenti, nonché essere un membro del gruppo Amministrazione centrale SharePoint in Windows SharePoint Server e disporre delle autorizzazioni Gestione contenuto in SQL Reporting Services.

È necessario disporre dell'autorizzazione per l'installazione nel computer in cui si esegue il programma di installazione creato tramite Team Foundation Build.

Creazione di un progetto di Visual Studio

Le istruzioni incluse in questa procedura dettagliata consentono di creare una semplice applicazione Windows Form in C# come esempio per la configurazione di Team Foundation Build per compilare un progetto di installazione di Visual Studio.

Per creare un'applicazione Windows Form di Visual Studio

Scegliere Nuovo dal menu File, quindi fare clic su Progetto.
Nella finestra di dialogo Nuovo progetto selezionare Visual C# nel riquadro Tipi progetto. Nel riquadro Modelli selezionare Applicazione Windows Windows.
Digitare HelloWorldTest nella casella Nome. Nella casella Percorso digitare C:\ProgettiDistribuzione oppure aprire l'area di lavoro locale selezionata per il progetto Team.
Scegliere OK.

HelloWorldTest verrà visualizzato in Esplora soluzioni e il file Form1.cs verrà visualizzato in Progettazione Windows Form.
Scegliere Casella degli strumenti dal menu Visualizza per rendere visibile l'elenco dei controlli.
Trascinare un controllo Button nel form.
Fare doppio clic sul nuovo pulsante per aprire l'editor di codice.

In Visual C# è stato inserito un metodo chiamato button1_Click.

Aggiungere il seguente codice al metodo:

private void button1_Click(object sender, EventArgs e)
        {
            MessageBox.Show("Hello World!");

        }

Scegliere Salva tutto dal menu File per salvare le modifiche.
Scegliere Compila HelloWorldTest dal menu Compila per compilare la soluzione e verificare che non vi siano errori di compilazione.

Per creare un progetto di distribuzione

Selezionare la soluzione HelloWorldTest in Esplora soluzioni, scegliere Aggiungi dal menu File, quindi fare clic su Nuovo progetto.
Nel riquadro Tipi progetto della finestra di dialogo Aggiungi nuovo progetto aprire il nodo Altri tipi di progetto, fare clic su Installazione e distribuzione, quindi scegliere Progetto di installazione nel riquadro Modelli. Nella casella Nome digitare HelloWorldTestInstaller.
Scegliere OK per chiudere la finestra di dialogo.

Il progetto verrà aggiunto a Esplora soluzioni e verrà visualizzata la finestra Editor del file system.

Per aggiungere l'applicazione HelloWorldTest al programma di installazione

Selezionare HelloWorldTestInstaller in Esplora soluzioni. In Editor del file system fare clic con il pulsante destro del mouse sul nodo Cartella applicazione, scegliere Aggiungi, quindi fare clic su File.
Nella finestra di dialogo Aggiungi file aprire il percorso di HelloWorldTest.exe, selezionare il file, quindi fare clic su Apri.

Il percorso utilizzato in questa procedura dettagliata è C:\ProgettiDistribuzione\HelloWorldTest\HelloWorldTest\obj\Debug\HelloWorldTest.exe. Il percorso del file potrebbe essere diverso a seconda del percorso dell'area di lavoro locale.
Scegliere Salva tutto dal menu File per salvare le modifiche.

Scegliere Compila HelloWorldTestInstaller dal menu Compila per compilare una copia locale del programma di installazione e verificare che non vi siano errori di compilazione.

Per verificare che il progetto di installazione abbia compilato il programma di installazione, aprire il percorso del file di output. HelloWorldTestInstaller.msi e setup.exe dovrebbero essere visualizzati nel percorso del file di output.

Nota:
Per trovare il file di output, fare clic con il pulsante destro del mouse sul progetto HelloWorldTestInstaller in Esplora soluzioni, quindi scegliere Proprietà. Nella finestra di dialogo Pagine delle proprietà di HelloWorldTestInstaller la casella Nome file di output contiene il percorso dei file di installazione.

Per modificare il file con estensione vdproj per l'utilizzo con Team Foundation Build

Fare clic con il pulsante destro del mouse sul progetto HelloWorldTestInstaller in Esplora soluzioni, quindi scegliere Proprietà. Nella finestra di dialogo Pagine delle proprietà di HelloWorldTestInstaller fare clic su Gestione configurazione.

Assicurarsi che la casella Compilazione sia selezionata per HelloWorldTest e HelloWorldTestInstaller.
Fare clic su Chiudi per chiudere la finestra di dialogo Gestione configurazione, quindi scegliere OK per chiudere la finestra di dialogo Pagine delle proprietà di HelloWorldTestInstaller.
Scegliere Salva tutto dal menu File per salvare le modifiche.
Individuare il file HelloWorldTestInstaller.vdproj.

Il percorso utilizzato in questa procedura dettagliata è C:\ProgettiDistribuzione\HelloWorldTest\HelloWorldTestInstaller. Il percorso del file potrebbe essere diverso a seconda del percorso dell'area di lavoro locale.
Fare clic con il pulsante destro del mouse su HelloWorldTestInstaller.vdproj, scegliere Apri con, quindi fare clic su Scegli programma. Nella finestra di dialogo Apri con selezionare Blocco note nel riquadro Programmi, quindi scegliere OK per aprire HelloWorldTestInstaller in Blocco note.
Verificare che tutti i percorsi dei file siano indicati come relativi al percorso dei file HelloWorldTestInstaller.vdproj.

È necessario che non sia elencato alcun percorso assoluto.

Per aggiungere e archiviare HelloWorldTest nel controllo del codice sorgente Team Foundation

Fare clic con il pulsante destro del mouse sulla soluzione HelloWorldTest in Esplora soluzioni, quindi scegliere Aggiungi soluzione a controllo del codice sorgente.

Accanto a tutti i file viene visualizzato un segno più di colore giallo. Questo indica che si tratta di aggiunte in sospeso al controllo del codice sorgente.
Fare clic con il pulsante destro del mouse sulla soluzione HelloWorldTest in Esplora soluzioni, quindi scegliere Archivia. Nella finestra di dialogo Archivia - File di origine - Area di lavoro: <Nome area di lavoro> scorrere la finestra per visualizzare i file selezionati. Deselezionare la casella Nome per HelloWorldTest.exe, quindi fare clic su Archivia.

I file verranno archiviati in Controllo della versione di Team Foundation.

Nota importante:

Verificare che il file eseguibile sia deselezionato perché si sta configurando Team Foundation Build per compilare un file eseguibile nuovo.

Nota importante:
Verificare che il file eseguibile sia deselezionato perché si sta configurando Team Foundation Build per compilare un file eseguibile nuovo.

Modifica del file TFSBuild.proj

Prima di compilare il progetto HelloWorldTestInstaller tramite Team Foundation Build, è necessario creare una nuova definizione di compilazione oppure modificarne una esistente. Per ulteriori informazioni, vedere Procedura: creare una definizione di compilazione. È necessario modificare il file di progetto TFSBuild.proj associato alla definizione della compilazione per indicargli di compilare il progetto di installazione.

Per modificare il file TFSBuild.proj per la compilazione del progetto di installazione

Scegliere Altre finestre dal menu Visualizza, quindi selezionare Esplora controllo del codice sorgente.
In Esplora controllo codice sorgente, espandere il progetto Team nel riquadro Cartelle e trovare il file TFSBuild.proj creato. Il percorso predefinito si trova nella cartella TeamBuildTypes, sotto la cartella del progetto Team.
Nel riquadro di visualizzazione selezionare il tipo di compilazione che si desidera utilizzare per la compilazione di HelloWorldTest e HelloWorldTestInstaller. Se nell'area di lavoro locale non è inclusa una copia del file, fare clic con il pulsante destro del mouse sulla cartella, quindi scegliere Leggi ultima versione.

Questa operazione rende i file disponibili per l'estrazione e la conseguente modifica.
Nel riquadro di visualizzazione fare doppio clic sul tipo di compilazione, fare clic con il pulsante destro del mouse su TFSBuild.proj, quindi scegliere Estrai per la modifica. Nella finestra di dialogo Estrai selezionare Nessuno - Consente l'estrazione condivisa, quindi fare clic su Estrai.

Un segno di spunta rosso verrà visualizzato accanto al file TFSBuild.proj, a indicarne lo stato del controllo del codice sorgente.
Fare doppio clic sul file TFSBuild.proj per aprirlo nell'editor XML di Visual Studio.
Aggiungere il seguente codice, in grassetto, alla fine del file TFSBuild.proj e prima del tag di chiusura </Project>.
```
<Target Name="AfterCompile">     <Exec Command="&quot;$(ProgramFiles)\Microsoft Visual Studio 9.0\Common7\IDE\devenv&quot; &quot;$(SolutionRoot)\HelloWorldTest\HelloWorldTestInstaller\HelloWorldTestInstaller.vdproj&quot; /Build &quot;Debug|Any CPU&quot;"/>     <Copy SourceFiles="$(SolutionRoot)\HelloWorldTest\HelloWorldTestInstaller\Debug\HelloWorldTestInstaller.msi; SolutionRoot)\HelloWorldTest\HelloWorldTestInstaller\Debug\setup.exe" DestinationFolder="$(OutDir)" /> </Target> 
```
In questo modo verrà utilizzata l'attività exec di MSBuild per compilare il progetto di installazione HelloWorldTestInstaller richiamando il programma devenv.exe. Per ulteriori informazioni, vedere Attività Exec. L'attività copy di MSBuild viene utilizzata per copiare i file msi ed exe nella directory di output Team Foundation Build. Per ulteriori informazioni, vedere Attività Copy.

La destinazione AfterCompile viene eseguita dopo che Team Foundation Build ha terminato l'esecuzione della destinazione CoreCompile, dove l'applicazione di HelloWorldTest è compilata. Per ulteriori informazioni sui nomi di destinazione, vedere Informazioni sui file di configurazione di Team Foundation Build.
Scegliere Salva dal menu File per salvare le modifiche, quindi chiudere TFSBuild.proj.
In Esplora controllo del codice sorgente fare clic con il pulsante destro del mouse su TFSBuild.proj, quindi scegliere Archivia modifiche in sospeso. È facoltativamente possibile aggiungere un commento nella finestra di dialogo Archivia - File di origine - Area di lavoro: <nome area di lavoro>. Fare clic su Archivia per archiviare TFSBuild.proj nel controllo del codice sorgente.

Esecuzione della definizione di compilazione

Dopo avere modificato il file TFSBuild.proj e avere salvato le modifiche in Controllo della versione di Team Foundation, eseguire la definizione di compilazione per compilare il progetto di distribuzione.

Per eseguire la definizione di una compilazione di un progetto Team

Scegliere Accoda nuova compilazione dal menu Compila.
Nella finestra di dialogo Accoda compilazione "nome progetto Team", selezionare la definizione di compilazione che si desidera utilizzare, l'agente di compilazione, la priorità in coda e quindi fare clic su Accoda.

Per ulteriori informazioni, vedere Procedura: accodare o avviare una definizione di compilazione.

È possibile monitorare il processo di compilazione in Esplora compilazione. Per ulteriori informazioni, vedere Procedura: monitorare l'avanzamento della generazione.

In Esplora compilazione fare clic sul file di log sotto l'intestazione Riepilogo. Esaminare il file di log per individuare eventuali errori.

Nota:
È possibile ignorare l'avviso MSB4078: file di progetto "HelloWorldTestInstaller\HelloWorldTestInstaller.vdproj" non supportato in MSBuild. Impossibile compilarlo. Il file viene compilato dal programma devenv.exe, che utilizza l'attività Exec di MSBuild.

Per installare il file di installazione generato

Individuare la destinazione finale della compilazione \\<destinazione finale> \Public_build\HelloWorldTestBuild_ <numero build>\Release.

La destinazione finale è la stessa condivisione file del percorso del file di log ed è indicata sotto l'intestazione Riepilogo in Esplora compilazione.
Copiare i file HelloWorldTestInstaller.msi e setup.exe in un computer in cui si è membri del gruppo di sicurezza Windows Administrator o si dispone dell'autorizzazione Installa impostata su Consenti.
Fare doppio clic sul file setup.exe e seguire le istruzioni visualizzate nell'installazione guidata.

HelloWorldTestInstaller.exe viene installato nel percorso <directory principale>:\Programmi\Microsoft\HelloWorldTestInstaller.
Passare a <directory principale>:\Programmi\Microsoft\HelloWorldTestInstaller.
Fare doppio clic sul file con estensione exe per eseguire l'applicazione.

Passaggi successivi

È possibile modificare il progetto di installazione di Visual Studio per configurare l'installazione guidata per ulteriori passaggi. Per ulteriori informazioni, vedere Concetti sulla distribuzione con Windows Installer.

Vedere anche

Attività

Procedura dettagliata: personalizzazione di Team Foundation Build con un'attività personalizzata

Altre risorse

Utilizzo delle definizioni di compilazione in Team Foundation Build

Gestione delle compilazioni con Team Foundation Build

Condividi tramite