Procédure pas à pas : création d'un environnement de build sur plusieurs ordinateursWalkthrough: Creating a Multiple-Computer Build Environment

Vous pouvez créer un environnement de build dans votre organisation en installant Visual Studio sur un ordinateur hôte, puis en copiant plusieurs fichiers et paramètres sur un autre ordinateur afin qu’il puisse participer aux builds.You can create a build environment within your organization by installing Visual Studio on a host computer and then copying various files and settings to another computer so that it can participate in builds. Vous n’avez pas à installer Visual Studio sur un autre ordinateur.You don't have to install Visual Studio on the other computer.

Ce document ne confère pas de droits pour redistribuer le logiciel en externe ou pour fournir des environnements de build à des tiers.This document does not confer rights to redistribute the software externally or to provide build environments to third parties.

Exclusion de responsabilitéDisclaimer

Ce document est fourni « en l’état ».This document is provided on a "as-is" basis. Nous avons testé les étapes décrites, mais nous ne pouvons pas tester exhaustivement chaque configuration.While we have tested the steps outlined, we are not able to exhaustively test every configuration. Nous tenterons de maintenir le document à jour avec toute information supplémentaire obtenue.We will attempt to keep the document current with any additional information learned. Les informations et opinions présentées dans ce document, notamment les URL et autres références à des sites web Internet, peuvent être modifiées sans information préalable.Information and views expressed in this document, including URL and other Internet website references, may change without notice. Microsoft n’offre aucune garantie, expresse ou implicite, concernant les informations fournies ici.Microsoft makes no warranties, express or implied, with respect to the information provided here. Vous assumez tous les risques liés à leur utilisation.You bear the risk of using it.

Ce document ne vous donne aucun droit légal de propriété intellectuelle quant aux produits Microsoft.This document does not provide you with any legal rights to any intellectual property in any Microsoft product. Vous pouvez copier et utiliser ce document à titre de référence interne.You may copy and use this document for your internal, reference purposes.

Vous n’avez aucune obligation de faire à Microsoft des suggestions, commentaires ou autre retour concernant ce document.You have no obligation to give Microsoft any suggestions, comments or other feedback ("Feedback") relating to this document. Toutefois, tout commentaire que vous fournissez volontairement peut être utilisé dans des produits Microsoft et les spécifications liées ou dans une autre documentation (collectivement, les "Offres Microsoft") qui peuvent elles-mêmes être utilisées par des tiers pour développer leurs propres produits.However, any Feedback you voluntarily provide may be used in Microsoft Products and related specifications or other documentation (collectively, "Microsoft Offerings") which in turn may be relied upon by other third parties to develop their own products. Par conséquent, si vous envoyez des retours sous forme de commentaires à Microsoft concernant n’importe quelle version de ce document ou les Offres Microsoft auxquelles ils s’appliquent, vous acceptez les points suivants : (a) Microsoft peut librement utiliser, reproduire, autoriser, distribuer et commercialiser vos commentaires dans toute Offre Microsoft ; (b) vous n’accorderez également aux tiers, sans frais, que les droits de brevet nécessaires pour permettre à d’autres produits d’utiliser ou d’interagir avec toutes les parties spécifiques d’un produit Microsoft qui incorporent vos commentaires ; et (c) vous n’enverrez à Microsoft aucun commentaire (i) pour lequel vous avez une raison de croire qu’il est soumis à un brevet, un copyright ou une autre revendication de propriété intellectuelle ou un autre droit envers un tiers ; ou (ii) qui soit soumis aux termes d’un contrat de licence exigeant que toute Offre Microsoft intégrant ou dérivée de ces commentaires, ou d’une autre propriété intellectuelle Microsoft, soit fournie sous licence à tout tiers ou partagée avec celui-ci.Accordingly, if you do give Microsoft Feedback on any version of this document or the Microsoft Offerings to which they apply, you agree: (a) Microsoft may freely use, reproduce, license, distribute, and otherwise commercialize your Feedback in any Microsoft Offering; (b) You also grant third parties, without charge, only those patent rights necessary to enable other products to use or interface with any specific parts of a Microsoft Product that incorporate Your Feedback; and (c) You will not give Microsoft any Feedback (i) that you have reason to believe is subject to any patent, copyright or other intellectual property claim or right of any third party; or (ii) subject to license terms which seek to require any Microsoft Offering incorporating or derived from such Feedback, or other Microsoft intellectual property, to be licensed to or otherwise shared with any third party.

Cette procédure pas à pas a été validée par rapport aux systèmes d’exploitation suivants, en exécutant MSBuild à partir de la ligne de commande et en utilisant Team Foundation Build.This walkthrough has been validated against the following operating systems, by executing MSBuild on the command line and by using Team Foundation Build.

PrérequisPrerequisites

  • Visual Studio, avec la charge de travail Développement Desktop .NET.Visual Studio with the .NET desktop development workload installed.

Installation du logiciel sur les ordinateursInstalling software on the computers

Configurez tout d’abord l’ordinateur hôte, puis l’ordinateur de build.First, set up the host computer and then set up the build computer.

En installant Visual Studio sur l’ordinateur hôte, vous créez des fichiers et des paramètres que vous copierez ultérieurement sur l’ordinateur de build.By installing Visual Studio on the host computer, you create the files and settings that you will copy to the build computer later. Vous pouvez installer Visual Studio sur un ordinateur x86 ou x64, mais l’architecture de l’ordinateur de build doit correspondre à l’architecture de l’ordinateur hôte.You can install Visual Studio on an x86 or an x64 computer, but the architecture of the build computer must match the architecture of the host computer.

  1. Sur l’ordinateur hôte, installez Visual Studio.On the host computer, install Visual Studio.

  2. Sur l’ordinateur de build, installez .NET Framework 4.5.On the build computer, install the .NET Framework 4.5. Pour vérifier qu’il est installé, assurez-vous que la valeur de la clé de Registre HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full@Version commence par "4.5".To verify that it's installed, make sure that the value of the registry key HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full@Version starts with "4.5".

Copie de fichiers de l’ordinateur hôte vers l’ordinateur de buildCopying files from the host computer to the build computer

Cette section décrit la copie de fichiers, compilateurs, outils de génération, composants MSBuild et paramètres de Registre spécifiques à partir de l’ordinateur hôte vers l’ordinateur de build.This section covers the copying of specific files, compilers, build tools, MSBuild assets, and registry settings from the host computer to the build computer. Ces instructions supposent que vous avez installé Visual Studio à l’emplacement par défaut sur l’ordinateur hôte ; si vous l’avez installé à un autre emplacement, ajustez les étapes en conséquence.These instructions assume that you've installed Visual Studio in the default location on the host computer; if you installed in another location, adjust the steps accordingly.

  • Sur un ordinateur x86, l’emplacement par défaut est C:\Program Files\Microsoft Visual Studio 11.0\On an x86 computer, the default location is C:\Program Files\Microsoft Visual Studio 11.0\
  • Sur un ordinateur x64, l’emplacement par défaut est C:\Program Files (x86)\Microsoft Visual Studio 11.0\On an x64 computer, the default location is C:\Program Files (x86)\Microsoft Visual Studio 11.0\

Notez que le nom du dossier Program Files dépend du système d’exploitation installé.Notice that the name of the Program Files folder depends on the operating system that's installed. Sur un ordinateur x86, le nom est \Program Files\ ; sur l’ordinateur x64, le nom est \Program Files (x86)\.On an x86 computer, the name is \Program Files\; on an x64 computer, the name is \Program Files (x86)\. Indépendamment de l’architecture du système, cette procédure pas à pas fait référence au dossier Program Files sous la forme %ProgramFiles%.Irrespective of the system architecture, this walkthrough refers to the Program Files folder as %ProgramFiles%.

Note

Sur l’ordinateur de build, tous les fichiers appropriés doivent se trouver sur le même lecteur ; toutefois, la lettre de ce lecteur peut être différente de la lettre du lecteur sur lequel Visual Studio est installé sur l’ordinateur hôte.On the build computer, all of the relevant files must be on the same drive; however, the drive letter for that drive can be different than the drive letter for the drive where Visual Studio is installed on the host computer. Dans tous les cas, vous devez tenir compte de l’emplacement des fichiers quand vous créez des entrées de Registre, comme décrit plus loin dans ce document.In any case, you must account for the location of files when you create registry entries as described later in this document.

Pour copier les fichiers du SDK Windows sur l’ordinateur de buildTo copy the Windows SDK files to the build computer

  1. Si seul le SDK Windows pour Windows 8 est installé, copiez ces dossiers de manière récursive de l’ordinateur hôte sur l’ordinateur de build :If you have only the Windows SDK for Windows 8 installed, copy these folders recursively from the host computer to the build computer:

    • %ProgramFiles%\Windows Kits\8.0\bin\%ProgramFiles%\Windows Kits\8.0\bin\

    • %ProgramFiles%\Windows Kits\8.0\Catalogs\%ProgramFiles%\Windows Kits\8.0\Catalogs\

    • %ProgramFiles%\Windows Kits\8.0\DesignTime\%ProgramFiles%\Windows Kits\8.0\DesignTime\

    • %ProgramFiles%\Windows Kits\8.0\include\%ProgramFiles%\Windows Kits\8.0\include\

    • %ProgramFiles%\Windows Kits\8.0\Lib\%ProgramFiles%\Windows Kits\8.0\Lib\

    • %ProgramFiles%\Windows Kits\8.0\Redist\%ProgramFiles%\Windows Kits\8.0\Redist\

    • %ProgramFiles%\Windows Kits\8.0\References\%ProgramFiles%\Windows Kits\8.0\References\

      Si les autres Kits Windows 8 suivants le sont aussi...If you also have these other Windows 8 kits...

    • Kit de déploiement et d’évaluation Microsoft WindowsMicrosoft Windows Assessment and Deployment Kit

    • Microsoft Windows Driver KitMicrosoft Windows Driver Kit

    • Kit de certification de matériel Microsoft WindowsMicrosoft Windows Hardware Certification Kit

      ...ils peuvent avoir installé des fichiers dans les dossiers %ProgramFiles%\Windows Kits\8.0\ indiqués à l’étape précédente, et les termes du contrat de licence peuvent ne pas autoriser les droits de serveur de builds pour ces fichiers....they might have installed files into the %ProgramFiles%\Windows Kits\8.0\ folders that are listed in the previous step, and their license terms might not allow build-server rights for those files. Consultez les termes du contrat de licence pour chaque Kit Windows installé afin de vérifier si les fichiers peuvent être copiés vers votre ordinateur de build.Check the license terms for every installed Windows kit to verify whether files may be copied to your build computer. Si ces termes n’autorisent pas les droits de serveur de builds, supprimez les fichiers de l’ordinateur de build.If the license terms don't allow build-server rights, then remove the files from the build computer.

  2. Copiez les dossiers suivants de manière récursive de l’ordinateur hôte vers l’ordinateur de build :Copy the following folders recursively from the host computer to the build computer:

    • %ProgramFiles%\Microsoft SDKs\Windows\v8.0A\bin\NETFX 4.0 Tools\%ProgramFiles%\Microsoft SDKs\Windows\v8.0A\bin\NETFX 4.0 Tools\

    • %ProgramFiles%\Common Files\Merge Modules\%ProgramFiles%\Common Files\Merge Modules\

    • %ProgramFiles%\Microsoft Visual Studio 11.0\VC\%ProgramFiles%\Microsoft Visual Studio 11.0\VC\

    • %ProgramFiles%\Microsoft Visual Studio 11.0\Common7\Tools\ProjectComponents\%ProgramFiles%\Microsoft Visual Studio 11.0\Common7\Tools\ProjectComponents\

    • %ProgramFiles%\MSBuild\Microsoft.Cpp\v4.0\V110\%ProgramFiles%\MSBuild\Microsoft.Cpp\v4.0\V110\

    • %ProgramFiles%\Reference Assemblies\Microsoft\Framework\.NETCore\v4.5\%ProgramFiles%\Reference Assemblies\Microsoft\Framework\.NETCore\v4.5\

    • %ProgramFiles%\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.5\%ProgramFiles%\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.5\

  3. Copiez les fichiers suivants de l’ordinateur hôte vers l’ordinateur de build :Copy these files from the host computer to the build computer:

    • %ProgramFiles%\Microsoft Visual Studio 11.0\Common7\IDE\msobj110.dll%ProgramFiles%\Microsoft Visual Studio 11.0\Common7\IDE\msobj110.dll

    • %ProgramFiles%\Microsoft Visual Studio 11.0\Common7\IDE\mspdb110.dll%ProgramFiles%\Microsoft Visual Studio 11.0\Common7\IDE\mspdb110.dll

    • %ProgramFiles%\Microsoft Visual Studio 11.0\Common7\IDE\mspdbcore.dll%ProgramFiles%\Microsoft Visual Studio 11.0\Common7\IDE\mspdbcore.dll

    • %ProgramFiles%\Microsoft Visual Studio 11.0\Common7\IDE\mspdbsrv.exe%ProgramFiles%\Microsoft Visual Studio 11.0\Common7\IDE\mspdbsrv.exe

    • %ProgramFiles%\Microsoft Visual Studio 11.0\Common7\IDE\msvcdis110.dll%ProgramFiles%\Microsoft Visual Studio 11.0\Common7\IDE\msvcdis110.dll

    • %ProgramFiles%\Microsoft Visual Studio 11.0\Common7\Tools\makehm.exe%ProgramFiles%\Microsoft Visual Studio 11.0\Common7\Tools\makehm.exe

    • %ProgramFiles%\Microsoft Visual Studio 11.0\Common7\Tools\VCVarsQueryRegistry.bat%ProgramFiles%\Microsoft Visual Studio 11.0\Common7\Tools\VCVarsQueryRegistry.bat

    • %ProgramFiles%\Microsoft Visual Studio 11.0\Common7\Tools\vsvars32.bat%ProgramFiles%\Microsoft Visual Studio 11.0\Common7\Tools\vsvars32.bat

  4. Les bibliothèques runtime Visual C++ suivantes sont nécessaires uniquement si vous exécutez des sorties de génération sur l’ordinateur de build, par exemple dans le cadre de tests automatisés.The following Visual C++ runtime libraries are required only if you run build outputs on the build computer—for example, as part of automated testing. Les fichiers sont généralement situés dans les sous-dossiers du dossier %ProgramFiles%\Microsoft Visual Studio 11.0\VC\redist\x86\ ou %ProgramFiles%\Microsoft Visual Studio 11.0\VC\redist\x64, selon l’architecture du système.The files are typically located in subfolders under the %ProgramFiles%\Microsoft Visual Studio 11.0\VC\redist\x86\ or %ProgramFiles%\Microsoft Visual Studio 11.0\VC\redist\x64\ folder, depending on the system architecture. Sur les systèmes x86, copiez les fichiers binaires x86 dans le dossier \Windows\System32.On x86 systems, copy the x86 binaries to the \Windows\System32\ folder. Sur les systèmes x64, copiez les fichiers binaires x86 dans le dossier Windows\SysWOW64, et les binaires x64 dans le dossier Windows\System32.On x64 systems, copy the x86 binaries to the Windows\SysWOW64\ folder, and the x64 binaries to the Windows\System32\ folder.

    • \Microsoft.VC110.ATL\atl110.dll\Microsoft.VC110.ATL\atl110.dll

    • \Microsoft.VC110.CRT\msvcp110.dll\Microsoft.VC110.CRT\msvcp110.dll

    • \Microsoft.VC110.CRT\msvcr110.dll\Microsoft.VC110.CRT\msvcr110.dll

    • \Microsoft.VC110.CXXAMP\vcamp110.dll\Microsoft.VC110.CXXAMP\vcamp110.dll

    • \Microsoft.VC110.MFC\mfc110.dll\Microsoft.VC110.MFC\mfc110.dll

    • \Microsoft.VC110.MFC\mfc110u.dll\Microsoft.VC110.MFC\mfc110u.dll

    • \Microsoft.VC110.MFC\mfcm110.dll\Microsoft.VC110.MFC\mfcm110.dll

    • \Microsoft.VC110.MFC\mfcm110u.dll\Microsoft.VC110.MFC\mfcm110u.dll

    • \Microsoft.VC110.MFCLOC\mfc110chs.dll\Microsoft.VC110.MFCLOC\mfc110chs.dll

    • \Microsoft.VC110.MFCLOC\mfc110cht.dll\Microsoft.VC110.MFCLOC\mfc110cht.dll

    • \Microsoft.VC110.MFCLOC\mfc110deu.dll\Microsoft.VC110.MFCLOC\mfc110deu.dll

    • \Microsoft.VC110.MFCLOC\mfc110enu.dll\Microsoft.VC110.MFCLOC\mfc110enu.dll

    • \Microsoft.VC110.MFCLOC\mfc110esn.dll\Microsoft.VC110.MFCLOC\mfc110esn.dll

    • \Microsoft.VC110.MFCLOC\mfc110fra.dll\Microsoft.VC110.MFCLOC\mfc110fra.dll

    • \Microsoft.VC110.MFCLOC\mfc110ita.dll\Microsoft.VC110.MFCLOC\mfc110ita.dll

    • \Microsoft.VC110.MFCLOC\mfc110jpn.dll\Microsoft.VC110.MFCLOC\mfc110jpn.dll

    • \Microsoft.VC110.MFCLOC\mfc110kor.dll\Microsoft.VC110.MFCLOC\mfc110kor.dll

    • \Microsoft.VC110.MFCLOC\mfc110rus.dll\Microsoft.VC110.MFCLOC\mfc110rus.dll

    • \Microsoft.VC110.OPENMP\vcomp110.dll\Microsoft.VC110.OPENMP\vcomp110.dll

  5. Copiez uniquement les fichiers suivants du dossier \Debug_NonRedist\x86\ ou \Debug_NonRedist\x64\ vers l’ordinateur de build, comme décrit dans Préparation d’un ordinateur de test pour lancer un exécutable de débogage.Copy only the following files from the \Debug_NonRedist\x86\ or \Debug_NonRedist\x64\ folder to the build computer, as described in Preparing a Test Machine To Run a Debug Executable. Aucun autre fichier ne peut être copié.No other files may be copied.

    • \Microsoft.VC110.DebugCRT\msvcp110d.dll\Microsoft.VC110.DebugCRT\msvcp110d.dll

    • \Microsoft.VC110.DebugCRT\msvcr110d.dll\Microsoft.VC110.DebugCRT\msvcr110d.dll

    • \Microsoft.VC110.DebugCXXAMP\vcamp110d.dll\Microsoft.VC110.DebugCXXAMP\vcamp110d.dll

    • \Microsoft.VC110.DebugMFC\mfc110d.dll\Microsoft.VC110.DebugMFC\mfc110d.dll

    • \Microsoft.VC110.DebugMFC\mfc110ud.dll\Microsoft.VC110.DebugMFC\mfc110ud.dll

    • \Microsoft.VC110.DebugMFC\mfcm110d.dll\Microsoft.VC110.DebugMFC\mfcm110d.dll

    • \Microsoft.VC110.DebugMFC\mfcm110ud.dll\Microsoft.VC110.DebugMFC\mfcm110ud.dll

    • \Microsoft.VC110.DebugOpenMP\vcomp110d.dll\Microsoft.VC110.DebugOpenMP\vcomp110d.dll

Création de paramètres du RegistreCreating registry settings

Vous devez créer des entrées de Registre pour configurer des paramètres pour MSBuild.You must create registry entries to configure settings for MSBuild.

Pour créer des paramètres du RegistreTo create registry settings

  1. Identifiez le dossier parent des entrées du Registre.Identify the parent folder for registry entries. Toutes les entrées du Registre sont créées sous la même clé parente.All of the registry entries are created under the same parent key. Sur un ordinateur x86, la clé parente est HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.On an x86 computer, the parent key is HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\. Sur un ordinateur x64, la clé parente est HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\.On an x64 computer the parent key is HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\. Indépendamment de l’architecture du système, cette procédure pas à pas fait référence à la clé parente sous la forme %RegistryRoot%.Irrespective of the system architecture, this walkthrough refers to the parent key as %RegistryRoot%.

    Note

    Si l’architecture de votre ordinateur hôte diffère de celle de votre ordinateur de build, veillez à utiliser la clé parente appropriée sur chaque ordinateur.If the architecture of your host computer differs from that of your build computer, make sure to use the appropriate parent key on each computer. Cela est particulièrement important si vous automatisez le processus d’exportation.This is especially important if you're automating the export process.

    De plus, si vous utilisez une lettre de lecteur différente sur l’ordinateur de build de celle que vous utilisez sur l’ordinateur hôte, veillez à changer les valeurs des entrées de Registre pour qu’elles correspondent.Also, if you're using a different drive letter on the build computer than the one that you're using on the host computer, make sure to change the values of the registry entries to match.

  2. Créez les entrées de Registre suivantes sur l’ordinateur de build.Create the following registry entries on the build computer. Toutes ces entrées sont des chaînes (Type == "REG_SZ" dans le Registre).All of these entries are strings (Type == "REG_SZ" in the registry). Définissez les valeurs de ces entrées identiques à celles des entrées comparables sur l’ordinateur hôte.Set the values of these entries the same as the values of the comparable entries on the host computer.

    • %RegistryRoot%\.NETFramework\v4.0.30319\AssemblyFoldersEx\VCMSBuild Public Assemblies@(Default)%RegistryRoot%\.NETFramework\v4.0.30319\AssemblyFoldersEx\VCMSBuild Public Assemblies@(Default)

    • %RegistryRoot%\Microsoft SDKs\Windows\v8.0@InstallationFolder%RegistryRoot%\Microsoft SDKs\Windows\v8.0@InstallationFolder

    • %RegistryRoot%\Microsoft SDKs\Windows\v8.0A@InstallationFolder%RegistryRoot%\Microsoft SDKs\Windows\v8.0A@InstallationFolder

    • %RegistryRoot%\Microsoft SDKs\Windows\v8.0A\WinSDK-NetFx40Tools@InstallationFolder%RegistryRoot%\Microsoft SDKs\Windows\v8.0A\WinSDK-NetFx40Tools@InstallationFolder

    • %RegistryRoot%\Microsoft SDKs\Windows\v8.0A\WinSDK-NetFx40Tools-x86@InstallationFolder%RegistryRoot%\Microsoft SDKs\Windows\v8.0A\WinSDK-NetFx40Tools-x86@InstallationFolder

    • %RegistryRoot%\VisualStudio\11.0@Source Directories%RegistryRoot%\VisualStudio\11.0@Source Directories

    • %RegistryRoot%\VisualStudio\11.0\Setup\VC@ProductDir%RegistryRoot%\VisualStudio\11.0\Setup\VC@ProductDir

    • %RegistryRoot%\VisualStudio\SxS\VC7@FrameworkDir32%RegistryRoot%\VisualStudio\SxS\VC7@FrameworkDir32

    • %RegistryRoot%\VisualStudio\SxS\VC7@FrameworkDir64%RegistryRoot%\VisualStudio\SxS\VC7@FrameworkDir64

    • %RegistryRoot%\VisualStudio\SxS\VC7@FrameworkVer32%RegistryRoot%\VisualStudio\SxS\VC7@FrameworkVer32

    • %RegistryRoot%\VisualStudio\SxS\VC7@FrameworkVer64%RegistryRoot%\VisualStudio\SxS\VC7@FrameworkVer64

    • %RegistryRoot%\VisualStudio\SxS\VC7@11.0%RegistryRoot%\VisualStudio\SxS\VC7@11.0

    • %RegistryRoot%\VisualStudio\SxS\VS7@11.0%RegistryRoot%\VisualStudio\SxS\VS7@11.0

    • %RegistryRoot%\Windows Kits\Installed Roots@KitsRoot%RegistryRoot%\Windows Kits\Installed Roots@KitsRoot

    • %RegistryRoot%\MSBuild\ToolsVersions\4.0\11.0@VCTargetsPath%RegistryRoot%\MSBuild\ToolsVersions\4.0\11.0@VCTargetsPath

    • %RegistryRoot%\MSBuild\ToolsVersions\4.0\11.0@VCTargetsPath10%RegistryRoot%\MSBuild\ToolsVersions\4.0\11.0@VCTargetsPath10

    • %RegistryRoot%\MSBuild\ToolsVersions\4.0\11.0@VCTargetsPath11%RegistryRoot%\MSBuild\ToolsVersions\4.0\11.0@VCTargetsPath11

      Sur un ordinateur de build x64, créez également l’entrée de Registre suivante, et reportez-vous à l’ordinateur hôte pour déterminer comment la définir.On an x64 build computer, also create the following registry entry and refer to the host computer to determine how to set it.

    • %RegistryRoot%\Microsoft SDKs\Windows\v8.0A\WinSDK-NetFx40Tools-x64@InstallationFolder%RegistryRoot%\Microsoft SDKs\Windows\v8.0A\WinSDK-NetFx40Tools-x64@InstallationFolder

      Si votre ordinateur de build est un ordinateur x64 et que vous voulez utiliser la version 64 bits de MSBuild, ou si vous utilisez le service de build Team Foundation Server sur un ordinateur x64, vous devez créer les entrées de Registre suivantes dans le Registre 64 bits natif.If your build computer is x64 and you want to use the 64-bit version of MSBuild, or if you're using Team Foundation Server Build Service on an x64 computer, you must create the following registry entries in the native 64-bit registry. Reportez-vous à l’ordinateur hôte pour savoir comment définir ces entrées.Refer to the host computer to determine how to set these entries.

    • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\11.0\Setup\VS@ProductDir

    • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSBuild\ToolsVersions\4.0\11.0@VCTargetsPath

    • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSBuild\ToolsVersions\4.0\11.0@VCTargetsPath10

    • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSBuild\ToolsVersions\4.0\11.0@VCTargetsPath11

Définition de variables d’environnement sur l’ordinateur de buildSetting environment variables on the build computer

Pour utiliser MSBuild sur l’ordinateur de build, vous devez définir les variables d’environnement PATH.To use MSBuild on the build computer, you must set the PATH environment variables. Pour ce faire, vous pouvez utiliser vcvarsall.bat, ou vous pouvez les configurer manuellement.You can use vcvarsall.bat to set the variables, or you can manually configure them.

Pour définir des variables d’environnement à l’aide de vcvarsall.batTo use vcvarsall.bat to set environment variables

  • Ouvrez une fenêtre d’invite de commandes sur l’ordinateur de build, puis exécutez %Program Files%\Microsoft Visual Studio 11.0\VC\vcvarsall.bat.Open a Command Prompt window on the build computer and run %Program Files%\Microsoft Visual Studio 11.0\VC\vcvarsall.bat. Vous pouvez utiliser un argument de ligne de commande pour spécifier l’ensemble d’outils à utiliser : compilateur croisé x64, x64 natif ou x86.You can use a command-line argument to specify the toolset you want to use—x86, native x64, or x64 cross-compiler. Si vous ne spécifiez pas d’argument de ligne de commande, l’ensemble d’outils x86 est utilisé.If you don't specify a command-line argument, the x86 toolset is used.

    Le tableau suivant décrit les arguments pris en charge pour vcvarsall.bat :This table describes the supported arguments for vcvarsall.bat:

    Argument Vcvarsall.batVcvarsall.bat argument CompilateurCompiler Architecture de l’ordinateur de buildBuild computer architecture Architecture de sortie de générationBuild output architecture
    x86 (valeur par défaut)x86 (default) Natif 32 bits32-bit Native x86, x64x86, x64 x86x86
    x86_amd64x86_amd64 x64 croiséx64 Cross x86, x64x86, x64 X64x64
    amd64amd64 x64 natifx64 Native X64x64 X64x64

    Si vcvarsall.bat s’exécute correctement, autrement dit, si aucun message d’erreur ne s’affiche, vous pouvez ignorer l’étape suivante et passer à la section Installation d’assemblys MSBuild dans le GAC (Global Assembly Cache) sur l’ordinateur de build de ce document.If vcvarsall.bat runs successfully—that is, no error message is displayed—you can skip the next step and continue at the Installing MSBuild assemblies to the Global Assembly Cache (GAC) on the build computer section of this document.

Pour définir manuellement des variables d’environnementTo manually set environment variables

  1. Pour configurer manuellement l’environnement de ligne de commande, ajoutez le chemin suivant à la variable d’environnement PATH :To manually configure the command-line environment, add this path to the PATH environment variable:

    • %Program Files%\Microsoft Visual Studio 11.0\Common7\IDE%Program Files%\Microsoft Visual Studio 11.0\Common7\IDE
  2. Si vous le souhaitez, vous pouvez également ajouter les chemins suivants à la variable PATH afin de faciliter l’utilisation de MSBuild pour générer vos solutions.Optionally, you can also add the following paths to the PATH variable to make it easier to use MSBuild to build your solutions.

    Si vous voulez utiliser MSBuild 32 bits natif, ajoutez les chemins suivants à la variable PATH :If you want to use the native 32-bit MSBuild, add these paths to the PATH variable:

    • %Program Files%\Microsoft SDKs\Windows\v8.0A\bin\NETFX 4.0 Tools%Program Files%\Microsoft SDKs\Windows\v8.0A\bin\NETFX 4.0 Tools

    • %windir%\Microsoft.NET\Framework\v4.0.30319%windir%\Microsoft.NET\Framework\v4.0.30319

      Si vous voulez utiliser MSBuild 64 bits natif, ajoutez les chemins suivants à la variable PATH :If you want to use the native 64-bit MSBuild, add these paths to the PATH variable:

    • %Program Files%\Microsoft SDKs\Windows\v8.0A\bin\NETFX 4.0 Tools\x64%Program Files%\Microsoft SDKs\Windows\v8.0A\bin\NETFX 4.0 Tools\x64

    • %windir%\Microsoft.NET\Framework64\v4.0.30319%windir%\Microsoft.NET\Framework64\v4.0.30319

Installation d’assemblys de MSBuild dans le GAC (Global Assembly Cache) sur l’ordinateur de buildInstalling MSBuild assemblies to the Global Assembly Cache (GAC) on the build computer

MSBuild exige que certains assemblys supplémentaires soient installés dans le GAC sur l’ordinateur de build.MSBuild requires some additional assemblies to be installed to the GAC on the build computer.

  1. Copiez les assemblys suivants à partir de l’ordinateur hôte vers l’ordinateur de build.Copy the following assemblies from the host computer to the build computer. Étant donné qu’ils seront installés dans le GAC, l’emplacement où vous les placez sur l’ordinateur de build n’a pas d’importance.Because they will be installed to the GAC, it doesn't matter where you put them on the build computer.

    • %ProgramFiles%\MSBuild\Microsoft.Cpp\v4.0\v110\Microsoft.Build.CPPTasks.Common.v110.dll%ProgramFiles%\MSBuild\Microsoft.Cpp\v4.0\v110\Microsoft.Build.CPPTasks.Common.v110.dll

    • %ProgramFiles%\Microsoft Visual Studio 11.0\Common7\IDE\CommonExtensions\Microsoft\VC\Project\Microsoft.VisualStudio.Project.VisualC.VCProjectEngine.dll%ProgramFiles%\Microsoft Visual Studio 11.0\Common7\IDE\CommonExtensions\Microsoft\VC\Project\Microsoft.VisualStudio.Project.VisualC.VCProjectEngine.dll

    • %ProgramFiles%\Microsoft Visual Studio 11.0\Common7\IDE\PublicAssemblies\Microsoft.VisualStudio.VCProjectEngine.dll%ProgramFiles%\Microsoft Visual Studio 11.0\Common7\IDE\PublicAssemblies\Microsoft.VisualStudio.VCProjectEngine.dll

  2. Pour installer les assemblys dans le GAC, recherchez gacutil.exe sur l’ordinateur de build (il se trouve généralement dans %ProgramFiles%\Microsoft SDKs\Windows\v8.0A\bin\NETFX 4.0 Tools\).To install the assemblies to the GAC, locate gacutil.exe on the build computer—typically, it's in %ProgramFiles%\Microsoft SDKs\Windows\v8.0A\bin\NETFX 4.0 Tools\. Si vous ne trouvez pas ce dossier, répétez les étapes de la section Copie de fichiers de l’ordinateur hôte vers l’ordinateur de build de cette procédure pas à pas.If you can't locate this folder, repeat the steps in the Copying files from the host computer to the build computer section of this walkthrough.

    Ouvrez une fenêtre d’invite de commandes disposant de droits d’administration, puis exécutez la commande suivante pour chaque fichier :Open a Command Prompt window that has administrative rights and run this command for each file:

    gacutil -i <fichier>gacutil -i <file>

    Note

    Pour qu’un assembly s’installe totalement dans le GAC, un redémarrage peut être nécessaire.A reboot may be required for an assembly to fully install into the GAC.

Génération de projetsBuilding projects

Vous pouvez utiliser Team Foundation Build pour générer des projets et des solutions Visual Studio 2012Visual Studio 2012. Vous pouvez également les générer sur la ligne de commande.You can use Team Foundation Build to build Visual Studio 2012Visual Studio 2012 projects and solutions, or you can build them on the command line. Quand vous utilisez Team Foundation Build pour générer des projets, il appelle l’exécutable MSBuild correspondant à l’architecture système.When you use Team Foundation Build to build projects, it invokes the MSBuild executable that corresponds to the system architecture. Sur la ligne de commande, vous pouvez utiliser MSBuild 32 bits ou MSBuild 64 bits, et vous pouvez choisir l’architecture de MSBuild en définissant la variable d’environnement PATH ou en appelant directement l’exécutable MSBuild spécifique à l’architecture.On the command line, you can use either 32-bit MSBuild or 64-bit MSBuild, and you can choose the architecture of MSBuild by setting the PATH environment variable or by directly invoking the architecture-specific MSBuild executable.

Pour utiliser msbuild.exe à l’invite de commandes, exécutez la commande suivante, dans laquelle solution.sln est un espace réservé pour le nom de votre solution.To use msbuild.exe at the command prompt, run the following command, in which solution.sln is a placeholder for the name of your solution.

msbuild solution.slnmsbuild solution.sln

Pour plus d’informations sur l’utilisation de MSBuild sur la ligne de commande, consultez Informations de référence sur la ligne de commande.For more information about how to use MSBuild on the command line, see Command-Line Reference.

Note

Pour générer des projets Visual Studio 2012Visual Studio 2012, vous devez utiliser l’ensemble d’outils de plateforme "v110".To build Visual Studio 2012Visual Studio 2012 projects, you must use the "v110" Platform Toolset. Si vous ne souhaitez pas modifier les fichiers projet Visual Studio 2012Visual Studio 2012, vous pouvez définir l’ensemble d’outils de plateforme en utilisant l’argument de ligne de commande suivant :If you don't want to edit the Visual Studio 2012Visual Studio 2012 project files, you can set the Platform Toolset by using this command-line argument:

msbuild solution.sln /p:PlatformToolset=v110msbuild solution.sln /p:PlatformToolset=v110

Création de l’environnement de build afin qu’il puisse être archivé dans le contrôle de code sourceCreating the build environment so that it can be checked into source control

Vous pouvez créer un environnement de build qui peut être déployé sur plusieurs ordinateurs et qui ne nécessite pas d’installer des fichiers dans le GAC ou de modifier des paramètres du Registre.You can create a build environment that can be deployed to various computers and doesn't require GAC'ing files or modifying registry settings. Les étapes suivantes sont juste une manière d’accomplir cette opération.The following steps are just one way to accomplish this. Adaptez ces étapes aux caractéristiques propres à votre environnement de build.Adapt these steps to the unique characteristics of your build environment.

Note

Vous devez désactiver la génération incrémentielle afin que tracker.exe ne provoque pas d’erreur lors de la génération.You must disable incremental building so that tracker.exe will not throw an error during a build. Pour désactiver une génération incrémentielle, définissez le paramètre de build suivant :To disable incremental building, set this build parameter:

msbuild solution.sln /p:TrackFileAccess=falsemsbuild solution.sln /p:TrackFileAccess=false

  1. Créez un répertoire de dépôt ("Depot") sur l’ordinateur hôte.Create a "Depot" directory on the host computer.

    Les étapes suivantes font référence à ce répertoire sous la forme %Depot%.These steps refer to the directory as %Depot%.

  2. Copiez les répertoires et fichiers, comme décrit dans la section Copie de fichiers de l’ordinateur hôte vers l’ordinateur de build de cette procédure pas à pas, puis collez-les dans le répertoire %Depot% que vous venez de créer.Copy the directories and files as described in the Copying files from the host computer to the build computer section of this walkthrough, except paste them under the %Depot% directory that you just created. Par exemple, effectuez la copie de %ProgramFiles%\Windows Kits\8.0\bin\ vers %Depot%\Windows Kits\8.0\bin\.For example, copy from %ProgramFiles%\Windows Kits\8.0\bin\ to %Depot%\Windows Kits\8.0\bin\.

  3. Une fois les fichiers collés dans %Depot%, apportez les modifications suivantes :When the files are pasted in %Depot%, make these changes:

    • Dans %Depot%\MSBuild\Microsoft.Cpp\v4.0\v110\Microsoft.CPP.Targets, \Microsoft.Cpp.InvalidPlatforms.targets\, \Microsoft.cppbuild.targets\ et \Microsoft.CppCommon.targets\, remplacez toutes les instances deIn %Depot%\MSBuild\Microsoft.Cpp\v4.0\v110\Microsoft.CPP.Targets, \Microsoft.Cpp.InvalidPlatforms.targets\, \Microsoft.cppbuild.targets\, and \Microsoft.CppCommon.targets\, change every instance of

      AssemblyName="Microsoft.Build.CppTasks.Common.v110, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"AssemblyName="Microsoft.Build.CppTasks.Common.v110, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"

      par celle-ci :to

      AssemblyFile="$(VCTargetsPath11)Microsoft.Build.CppTasks.Common.v110.dll".AssemblyFile="$(VCTargetsPath11)Microsoft.Build.CppTasks.Common.v110.dll".

      Le nommage précédent dépend de l’assembly installé dans le GAC.The former naming relies on the assembly being GAC'ed.

    • Dans %Depot% \MSBuild\Microsoft.Cpp\v4.0\v110\Microsoft.CPPClean.Targets, remplacez chaque instance deIn %Depot% \MSBuild\Microsoft.Cpp\v4.0\v110\Microsoft.CPPClean.Targets, change every instance of

      AssemblyName="Microsoft.Build.CppTasks.Common.v110, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"AssemblyName="Microsoft.Build.CppTasks.Common.v110, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"

      par celle-ci :to

      AssemblyFile="$(VCTargetsPath11)Microsoft.Build.CppTasks.Common.v110.dll".AssemblyFile="$(VCTargetsPath11)Microsoft.Build.CppTasks.Common.v110.dll".

  4. Créez un fichier .props (par exemple, Partner.AutoImports.props), puis placez-le à la racine du dossier qui contient vos projets.Create a .props file—for example, Partner.AutoImports.props—and put it at the root of the folder that contains your projects. Ce fichier sert à définir les variables qui sont utilisées par MSBuild pour rechercher diverses ressources.This file is used to set variables that are used by MSBuild to find various resources. Si les variables ne sont pas définies par ce fichier, elles sont définies par d’autres fichiers .props et des fichiers .targets qui reposent sur des valeurs de Registre.If the variables are not set by this file, they are set by other .props files and .targets files that rely on registry values. Comme nous ne définissons aucune valeur de Registre, ces variables sont vides et la génération échoue.Because we aren't setting any registry values, these variables would be empty and the build would fail. À la place, ajoutez ceci à Partner.AutoImports.props :Instead, add this to Partner.AutoImports.props:

    <?xml version="1.0" encoding="utf-8"?>
    <!-- This file must be imported by all project files at the top of the project file. -->
    <Project ToolsVersion="4.0"
    xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <PropertyGroup>
    <VCTargetsPath>$(DepotRoot)MSBuild\Microsoft.Cpp\v4.0\v110\</VCTargetsPath>
    <VCTargetsPath11>$(DepotRoot)MSBuild\Microsoft.Cpp\v4.0\v110\</VCTargetsPath11>
    <MSBuildExtensionsPath>$(DepotRoot)MSBuild</MSBuildExtensionsPath>
    <MSBuildExtensionsPath32>$(DepotRoot)MSBuild</MSBuildExtensionsPath32>
    <VCInstallDir_110>$(DepotRoot)Microsoft Visual Studio 11.0\VC\</VCInstallDir_110>
    <VCInstallDir>$(VCInstallDir_110)</VCInstallDir>
    <WindowsKitRoot>$(DepotRoot)Windows Kits\</WindowsKitRoot>
    <WindowsSDK80Path>$(WindowsKitRoot)</WindowsSDK80Path>
    <WindowsSdkDir_80>$(WindowsKitRoot)8.0\</WindowsSdkDir_80>
    <WindowsSdkDir>$(WindowsSDKDir_80)</WindowsSdkDir>
    <WindowsSdkDir_80A>$(DepotRoot)Microsoft SDKs\Windows\v8.0A\</WindowsSdkDir_80A>
    </PropertyGroup>
    </Project>
    
  5. Dans chacun de vos fichiers projet, ajoutez la ligne suivante en haut, après la ligne <Project Default Targets...>.In each of your project files, add the following line at the top, after the <Project Default Targets...> line.

    <Import Project="$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory), Partner.AutoImports.props))\Partner.AutoImports.props"/>
    
  6. Changez l’environnement de ligne de commande comme suit :Change the command-line environment as follows:

    • Set Depot=emplacement du répertoire Depot que vous avez créé à l’étape 1Set Depot=location of the Depot directory that you created in step 1

    • Set path=%path%;emplacement de MSBuild sur l’ordinateur;%Depot%\Windows\System32;%Depot%\Windows\SysWOW64;%Depot%\Microsoft Visual Studio 11.0\Common7\IDE\Set path=%path%;location of MSBuild on the computer;%Depot%\Windows\System32;%Depot%\Windows\SysWOW64;%Depot%\Microsoft Visual Studio 11.0\Common7\IDE\

      Pour une génération 64 bits native, pointez sur MSBuild 64 bits.For native 64-bit building, point to the 64-bit MSBuild.

Voir aussiSee also

Préparation d’un ordinateur de test pour lancer un exécutable de débogagePreparing a Test Machine To Run a Debug Executable
Informations de référence sur la ligne de commandeCommand-Line Reference