Condividi tramite


Procedura: personalizzare il gruppo SolutionToBuild Item

Aggiornamento: novembre 2007

Il file di progetto Team Foundation Build, TFSBuild.proj, può essere personalizzato passando proprietà e destinazioni alla compilazione nel gruppo di elementi SolutionToBuild. È possibile inoltre aggiungere o rimuovere soluzioni da compilare nel gruppo di elementi SolutionToBuild. Per ulteriori informazioni sul file TfsBuld.proj, vedere Informazioni sui file di configurazione di Team Foundation Build.

Autorizzazioni necessarie

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

Modifica del file di progetto Team Foundation Build

Per modificare il file TFSBuild.proj, è necessario estrarlo dal controllo del codice sorgente.

Per modificare il file TFSBuild.proj

  1. Scegliere Altre finestre dal menu Visualizza, quindi selezionare Esplora controllo del codice sorgente.

  2. In Esplora controllo del codice sorgente espandere il progetto team nel riquadro Cartelle, quindi selezionare TeamBuildTypes.

  3. Per ottenere la versione più recente di TFSBuild.proj, fare clic con il pulsante destro del mouse sulla cartella TeamBuildType, quindi fare clic suLeggi ultima versione .

    Questa operazione rende i file disponibili per l'estrazione e la conseguente modifica.

  4. Nel riquadro di visualizzazione fare doppio clic sul nome della definizione di compilazione che si intende modificare, fare clic con il pulsante destro del mouse su TFSBuild.proj e 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.

  5. Fare doppio clic sul file TFSBuild.proj per aprirlo nell'editor XML di Visual Studio.

Passaggio di proprietà al gruppo di elementi SolutionToBuild.

In Team Foundation Build sono presenti due proprietà riservate che è possibile utilizzare per personalizzare le definizioni di compilazione:

  • CustomPropertiesForClean passa valori personalizzati ad ogni soluzione quando la destinazione Clean è chiamata da .

  • CustomPropertiesForBuild passa valori personalizzati ad ogni soluzione quando la destinazione predefinita (in genere Build) è chiamata da Team Foundation Build.

Passare proprietà al gruppo di elementi SolutionToBuild.

  1. Individuare il tag <SolutionToBuild> nel file TFSBuild.proj.

  2. Per aggiungere una proprietà personalizzata alla destinazione predefinita, digitare quanto segue tra il tag <SolutionToBuild> ed il tag </SolutionToBuild>. Esempio:

    <SolutionToBuild Include="$(SolutionRoot)\HelloWorld.sln">
      <CustomPropertiesForBuild>
        Context=TeamBuild;RootDirectory=$(SolutionDir)
      </CustomPropertiesForBuild>
    </SolutionToBuild>
    

    Questo XML assegna alla proprietà di compilazione RootDirectory la proprietà SolutionDir predefinita

    Utilizzare la stessa sintassi per passare proprietà personalizzate nella proprietà CustomPropertiesForClean.

  3. In alternativa, è anche possibile passare proprietà personalizzate a specifici elementi SolutionToBuild specificandoli nei metadati.

    Esempio:

    <SolutionToBuild Include="$(SolutionRoot)\HelloWorld.sln">
      <Properties>
        OutDir=$(BinariesRoot)\$(Solution)\$(Platform)\$(Configuration\
      </Properties>
    </SolutionToBuild>
    

    Questo XML specifica la directory di output per la definizione di compilazione o per le definizioni associate al file TFSBuild.proj.

    Nota:

    L'aggiunta dei tag CustomPropertiesForBuild e CustomPropertiesForClean genera avvisi di convalida dello schema XML in Visual Studio. È possibile ignorare in modo sicuro questi avvisi..

Aggiungere ed eliminare soluzioni dal gruppo di elementi SolutionToBuild

È possibile modificare il gruppo di elementi SolutionToBuild per aggiungere o rimuovere soluzioni che saranno compilate dalla definizione di compilazione o definizioni associate col file del progetto diTeam Foundation Build, TFSBuild.proj.

Aggiungere o rimuovere soluzioni da compilare

  1. Individuare il tag <SolutionToBuild> nel file TFSBuild.proj.

    Se la definizione di compilazione è impostata per compilare solo una soluzione, la voce SolutionToBuild è simile al seguente XML:

    <ItemGroup>
    <SolutionToBuild Include="$(BuildProjectFolderPath)\path\MySolution.sln" />
      <Targets></Targets>
      <Properties></Properties>
    </SolutionToBuild>
    </ItemGroup>
    
  2. Per aggiungere un'altra soluzione, aggiungere un altro insieme di tag <SolutionToBuild></SolutionToBuild> dopo il tag <ItemGroup> di apertura e prima del tag </ItemGroup> di chiusura.

    <SolutionToBuild Include="$(BuildProjectFolderPath)\path\MySolution.sln" />
      <Targets></Targets>
      <Properties></Properties>
    </SolutionToBuild>
    <SolutionToBuild Include="$(BuildProjectFolderPath)\path\MySecondSolution.sln" />  <Targets></Targets>  <Properties></Properties></SolutionToBuild>
    
  3. Per rimuovere una soluzione, rimuovere i tag <SolutionToBuild></SolutionToBuild> e tutto il loro contenuto relativo alla soluzione che non si desidera compilare.

Chiamare una destinazione personalizzata nel gruppo di elementi SolutionToBuild

È possibile chiamare destinazioni personalizzate per singoli elementi SolutionToBuild specificandoli nei metadati.

Chiamare una destinazione personalizzata nel gruppo di elementi SolutionToBuild

  1. Individuare il tag <SolutionToBuild> nel file TFSBuild.proj.

  2. Utilizzare la seguente sintassi per chiamare una destinazione e passare delle proprietà.

    <SolutionToBuild Include="$(BuildProjectFolderPath)\path\MySolution.sln">
      <Targets>MyCustomTarget1;MyCustomTarget2</Targets>
      <Properties>Property1=Value1;PropertyTwo=Value2</Properties>
    </SolutionToBuild>
    

    Questo codice XML chiama le destinazioni MyCustomTarget1 e MyCustomTarget2 e gli passa le proprietà Property1 e Property2.

Vedere anche

Attività

Procedura: creare una definizione di compilazione

Altre risorse

Destinazioni, attività e proprietà di Team Foundation Build