Partager via

Comment : générer des projets d'équipe sur un bureau

  • Article

Mise à jour : novembre 2007

Team Foundation Build fournit une fonctionnalité de build de bureau permettant de générer des solutions et d'effectuer des tests sur les fichiers binaires locaux avant de vérifier les modifications sur le serveur de contrôle de version Team Foundation public. Les builds de bureau ont un comportement différent des builds publiques en ce qui suit :

  • Les builds de bureau exécutent uniquement la compilation et les tests.

  • Elles n'exécutent pas les autres étapes de builds publiques telles que l'obtention de sources du contrôle de version, la mise à jour d'éléments de travail, l'étiquetage de sources, la création de nouveaux éléments de travail et la copie vers des emplacements cibles.

  • Le journal de MSBuild par défaut enregistre les résultats car le journal Team Foundation Build n'est pas activé pour les builds de bureau.

  • Les builds de bureau ne stockent pas les données de build dans la base de données.

  • Elles ne génèrent pas de rapports d'état. La sortie de la génération est écrite sur la console. Vous pouvez obtenir davantage de détails en activant l'option Verbosity lors de l'exécution de la commande MSBuild. Pour plus d'informations, consultez Référence de la ligne de commande MSBuild.

Pour plus d'informations sur la mise en file d'attente de builds, consultez Comment : démarrer ou mettre en file d'attente une définition de build.

Autorisations requises

Pour exécuter cette procédure, vous devez avoir les autorisations de système de fichiers appropriées pour être en mesure de créer des fichiers sur l'agent de build. Vous devez également avoir les autorisations de système de fichiers appropriées pour exécuter tout processus supplémentaire spécifié dans le cadre de votre processus de génération. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

Pour exécuter une build de bureau

  1. Synchronisez le répertoire racine du projet d'équipe au répertoire de l'ordinateur local. Pour plus d'informations, consultez Comment : obtenir la source de votre projet d'équipe.

    Remarque :

    Team Foundation Build stocke tous les fichiers de définition de génération dans le contrôle de version. Le répertoire par défaut est TeamBuildTypes sous le dossier racine de projet d'équipe. Vous pouvez désigner un répertoire différent lorsque vous créez une définition de build.

  2. Utilisez la commande MSBuild de l'invite de commandes de Visual Studio (cliquez sur Démarrer, Tous les programmes, Microsoft Visual Studio 2008,Visual Studio Tools, puis sur Invite de commandes de Visual Studio 2008) et utilisez le fichier de définition de build comme argument, comme illustré dans la syntaxe suivante :

    C:\temp\Team Project1\TeamBuildTypes\Main> MSBuild TfsBuild.proj /p:SolutionRoot=..\..

    Remarque :

    Votre chemin d'accès au dossier des fichiers de build peut être différent.

    Si la source a déjà été synchronisée à un répertoire, par exemple d:\temp\mysources\solution1, vous pouvez synchroniser le fichier de type de build avec un autre répertoire, par exemple : c:\temp. Utilisez la commande comme mentionné précédemment sauf qu'il faut spécifier l'emplacement de vos sources. La syntaxe de la commande est la suivante :

    MSBuild TfsBuild.proj /p:SolutionRoot= d:\temp\mysources

    Vous pouvez substituer toute propriété à l'aide de la ligne de commande avec le commutateur /p. La seule propriété requise pour la build de bureau est SolutionRoot.

    Vous pouvez, si vous le souhaitez, substituer ces propriétés pour la build de bureau :

    • Verbose

    • RunFxCopFlag

  3. Les commandes suivantes contiennent la syntaxe supplémentaire pour les builds de bureau Team Foundation Build :

    • msbuild TfsBuild.proj

      Utilisez celle-ci pour effectuer une génération incrémentielle et exécuter des tests :

    • msbuild TfsBuild.proj /t:Clean

      Utilisez celle-ci pour exécuter une opération de nettoyage des fichiers binaires et de tous les dossiers objets intermédiaires :

    • msbuild TfsBuild.proj /t:Compile

      Utilisez celle-ci pour exécuter une compilation incrémentielle.

    • msbuild TfsBuild.proj /t:Test

      Utilisez celle-ci pour exécuter uniquement des tests.

    • msbuild TfsBuild.proj /t:DesktopRebuild

      Utilisez celle-ci pour effectuer une compilation complète et exécuter des tests :

    • msbuild TfsBuild.proj /p:BinariesRoot=d:\NewBinariesRoot /p:TestResultsRoot=d:\NewTestResultsRoot

      Utilisez celle-ci pour substituer le répertoire de sortie en remplaçant le répertoire BinariesRoot où les fichiers binaires du produit sont copiés et le répertoire TestResultsRoot où les résultats de tests sont enregistrés.

    • msbuild TfsBuild.proj /p:RunCodeAnalysis=false

      Utilisez celle-ci pour désactiver l'analyse du code dans une build de bureau.

    • msbuild TfsBuild.proj /p:RunTest=false

      Utilisez celle-ci pour désactiver des séries de tests dans la build de bureau.

    Pour plus d'informations sur les options de ligne de commande MSBuild, consultez Référence de la ligne de commande MSBuild.

Voir aussi

Concepts

Vue d'ensemble de la journalisation dans MSBuild

Propriétés MSBuild

Référence

Référence de la ligne de commande MSBuild

Autres ressources

Exécution de builds dans Team Foundation Build