Procedura dettagliata: aggiunta di istruzioni di compilazione mediante l'attività BuildStep
Aggiornamento: novembre 2007
Un'attività BuildStep è un'attività di MSBuild scritta in modo specifico per Team Foundation Server. Per aggiungere un'attività BuildStep in una compilazione occorre aggiungere uno o più elementi BuildStep in un elemento Target del file TFSBuild.proj della definizione di compilazione della soluzione.
Prerequisiti
Prima di poter aggiungere un'attività BuildStep in una definizione di compilazione, è necessario disporre di quanto segue:
Accesso al file TFSBuild.proj della definizione di compilazione che si desidera personalizzare. Per ulteriori informazioni sulla creazione di definizioni di compilazione, vedere Procedura: creare una definizione di compilazione.
.gif "Nota importante")
Nota importante:Quando si personalizza il file TFSBuild.proj, viene personalizzata ogni definizione di compilazione associata al file.
Area di lavoro locale che contiene i file del progetto Team e i file di compilazione. Per ulteriori informazioni, vedere°Procedura: creare un'area di lavoro mappata e Procedura: ottenere il codice sorgente per il progetto team.
Autorizzazioni necessarie
Per eseguire le procedure di questo argomento è necessario che le proprie autorizzazioni Archivia ed Estrai siano impostate su Consenti. Per ulteriori informazioni, vedere la classe Autorizzazioni per Team Foundation Server.
Per aggiungere istruzioni di compilazione utilizzando l'attività BuildStep, attenersi alle procedure seguenti:
Aggiunta di un'attività al file del progetto
Aggiunta di un'istruzione di compilazione informativa al file del progetto
Aggiunta di un'attività al file del progetto
Per aggiungere e aggiornare le istruzioni di compilazione è possibile utilizzare l'attività BuildStep. Questa procedura descrive come modificare il file TFSBuild.proj come segue:
Aggiungere un'istruzione di compilazione.
Eseguire un'attività.
Aggiornare l'istruzione di compilazione con lo stato Operazione completata se l'attività ha esito positivo o con lo stato Operazione non riuscita se l'attività ha esito negativo.
L'attività dell'istruzione di compilazione descritta nell'esempio prevede la copia dei file di origine in un nuovo percorso.
Per aggiungere e aggiornare un'istruzione di compilazione nel file TFSBuild.proj
Avviare Visual Studio.
Estrarre il file TFSBuild.proj che si desidera modificare da Controllo della versione di Team Foundation e aprirlo nell'editor XML di Visual Studio.
Aggiungere il codice XML seguente all'elemento <ItemGroup>. Il codice XML può essere aggiunto all'elemento <ItemGroup> esistente. In alternativa, è possibile aggiungere un nuovo elemento <ItemGroup>:
.gif "Nota")
Nota:Il codice riportato in questo passaggio consente di identificare le cartelle che contengono i file di origine da copiare. Per le altre attività di MSBuild è possibile che sia necessario effettuare altre aggiunte al codice XML. Per ulteriori informazioni sui requisiti delle attività di MSBuild, vedere Riferimenti delle attività MSBuild.
<ItemGroup> <SourceFileFolder Include="C:\WorkingFolder\TeamBuildTypes\**\*.cs" /> </ItemGroup>Aggiungere il codice XML seguente alla fine del file TFSBuild.proj subito prima dell'elemento </Project>:
</ItemGroup> <Target Name="BeforeCompile"> <BuildStep TeamFoundationServerUrl="$(TeamFoundationServerUrl)" BuildUri="$(BuildUri)" Message="Working..."> <Output TaskParameter="Id" PropertyName="StepId" /> </BuildStep> <!-- Perform a task... --> <Copy SourceFiles="@(SourceFileFolder)" DestinationFolder="C:\NewSourceFileFolder" /> <BuildStep TeamFoundationServerUrl="$(TeamFoundationServerUrl)" BuildUri="$(BuildUri)" Id="$(StepId)" Status="Succeeded" /> <OnError ExecuteTargets="MarkBuildStepAsFailed" /> </Target> <Target Name="MarkBuildStepAsFailed"> <BuildStep TeamFoundationServerUrl="$(TeamFoundationServerUrl)" BuildUri="$(BuildUri)" Id="$(StepId)" Status="Failed" /> </Target> </Project>Nota:Per ulteriori informazioni sulle destinazioni di Team Foundation Build e l'elenco delle destinazioni personalizzabili, vedere Destinazioni personalizzabili di Team Foundation Build.
Salvare le modifiche, quindi chiudere TFSBuild.proj.
Archiviare il file TFSBuild.proj nel controllo della versione.
Eseguire la definizione di compilazione
Per ulteriori informazioni, vedere la classe Procedura: accodare o avviare una definizione di compilazione.
In Esplora compilazione è possibile visualizzare il messaggio dell'istruzione di compilazione. Nel log di compilazione è inoltre possibile vedere l'intero processo di creazione e aggiornamento dell'istruzione di compilazione. Infine, è possibile vedere i file copiati nella directory specificata. Per ulteriori informazioni, vedere la classe Procedura: monitorare l'avanzamento della generazione.
Aggiunta di un'istruzione di compilazione informativa al file del progetto
Se non è necessario eseguire un'attività ma si desidera aggiungere un'istruzione di compilazione informativa, non utilizzare la proprietà Id Output e impostare immediatamente lo stato. Questa procedura consente di aggiungere nel processo di compilazione soltanto un messaggio che viene visualizzato quando si apre la compilazione in Esplora compilazione.
Per aggiungere un'istruzione di compilazione informativa al file TFSBuild.proj
Avviare Visual Studio.
Estrarre il file TFSBuild.proj che si desidera modificare da Controllo della versione di Team Foundation e aprirlo nell'editor XML di Visual Studio.
Aggiungere il codice XML seguente alla fine del file TFSBuild.proj subito prima del tag </Project>:
</ItemGroup> <Target Name="AfterCompile"> <BuildStep TeamFoundationServerUrl="$(TeamFoundationServerUrl)" BuildUri="$(BuildUri)" Message="Compile step complete." Status="Succeeded" /> </Target> </Project>Nota:Per ulteriori informazioni sulle destinazioni di Team Foundation Build e l'elenco delle destinazioni personalizzabili, vedere Destinazioni personalizzabili di Team Foundation Build.
Salvare le modifiche, quindi chiudere TFSBuild.proj.
Archiviare il file TFSBuild.proj nel controllo della versione.
Eseguire la definizione di compilazione
Per ulteriori informazioni, vedere la classe Procedura: accodare o avviare una definizione di compilazione.
È possibile visualizzare il messaggio in Esplora compilazione e nel log di compilazione. Per ulteriori informazioni, vedere la classe Procedura: monitorare l'avanzamento della generazione.