チュートリアル: 複数のコンピューターを使用するビルド環境の作成Walkthrough: Creating a Multiple-Computer Build Environment

組織内でビルド環境を作成するには、ホスト コンピューターに Visual Studio をインストールし、ビルドに参加できるように各種のファイルおよび設定を別のコンピューターにコピーします。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. 別コンピューターの方に Visual Studio をインストールする必要はありません。You don't have to install Visual Studio on the other computer.

このドキュメントは、ソフトウェアを外部に再配布する権利または第三者にビルド環境を提供する権利を付与するものではありません。This document does not confer rights to redistribute the software externally or to provide build environments to third parties.

免責情報Disclaimer

このドキュメントは "現状有姿" で提供されます。This document is provided on a "as-is" basis. ここに記載されている手順はテスト済みですが、あらゆる構成を網羅してテストすることはできません。While we have tested the steps outlined, we are not able to exhaustively test every configuration. Microsoft では、追加情報があればこのドキュメントを更新するように努めます。We will attempt to keep the document current with any additional information learned. URL および他の参照されているインターネットの Web サイトをはじめ、このドキュメントに記載されている情報および見解は、通知なく変更されることがあります。Information and views expressed in this document, including URL and other Internet website references, may change without notice. Microsoft はここに示されている情報について、明示か黙示かを問わず、一切保証しません。Microsoft makes no warranties, express or implied, with respect to the information provided here. お客様は、その使用に関するリスクを負うものとします。You bear the risk of using it.

このドキュメントは、Microsoft 製品の知的財産権に関する法的な権利をお客様に許諾するものではありません。This document does not provide you with any legal rights to any intellectual property in any Microsoft product. 内部的な参照目的に限り、このドキュメントを複製して使用することができます。You may copy and use this document for your internal, reference purposes.

お客様がこのドキュメントに関する提案、コメント、またはその他のフィードバック (以下 "フィードバック") を Microsoft に提供する義務はありません。You have no obligation to give Microsoft any suggestions, comments or other feedback ("Feedback") relating to this document. ただし、お客様から自発的に提供されたフィードバックは、Microsoft 製品および関連する仕様書またはその他のドキュメント (以下総称して "Microsoft 提供物") に使用されることがあります。さらに、これらのドキュメントは第三者によって独自製品の開発時に使用されることがあります。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. これに基づき、お客様がこのドキュメントまたは Microsoft 提供物のいずれかのバージョンに関するフィードバックを Microsoft に提供する場合、お客様は次の点に同意するものとします。(a) Microsoft は、Microsoft 提供物の中で、お客様のフィードバックを自由に複製、使用許諾、配布、およびその他の方法で商品化できる。(b) 第三者の製品において、お客様のフィードバックを反映した Microsoft 製品の特定部分を使用または Microsoft 製品の特定部分と連携するために必要な特許権のみをお客様が無償で第三者に付与する。(c) 次のような場合、お客様はフィードバックを Microsoft に提供しない。(i) 第三者の特許、著作権、またはその他の知的財産権の主張または権限がそのフィードバックに適用されるとお客様が確信する根拠がある場合、または (ii) そのフィードバックが反映されているかそのフィードバックから派生する Microsoft 提供物またはその他の Microsoft 知的財産を第三者に使用許諾またはその他の方法で共有することを求めるライセンス条件がそのフィードバックに適用される場合。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.

このチュートリアルは、コマンド ラインでの MSBuild の実行および Team Foundation ビルドの使用により、次のオペレーティング システムに対して検証済みです。This walkthrough has been validated against the following operating systems, by executing MSBuild on the command line and by using Team Foundation Build.

必須コンポーネントPrerequisites

  • ライセンス供与された Visual Studio Ultimate、Visual Studio Premium、または Visual Studio ProfessionalA licensed copy of Visual Studio Ultimate, Visual Studio Premium, or Visual Studio Professional

  • .NET Framework 4.5.1 (Visual Studio の Web サイトからダウンロードできます)A copy of the .NET Framework 4.5.1, which you can download from the Visual Studio website.

コンピューターにソフトウェアをインストールするInstalling software on the computers

最初にホスト コンピューターを設定し、次にビルド コンピューターを設定します。First, set up the host computer and then set up the build computer.

ホスト コンピューターに Visual Studio をインストールすると、ファイルや設定が作成されます。後でこれらをビルド コンピューターにコピーします。By installing Visual Studio on the host computer, you create the files and settings that you will copy to the build computer later. Visual Studio は x86 または x64 コンピューターにインストールできますが、ビルド コンピューターのアーキテクチャは、ホスト コンピューターのアーキテクチャと一致する必要があります。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.

コンピューターにソフトウェアをインストールするにはTo install software on the computers

  1. ホスト コンピューターに、Visual Studio をインストールします。On the host computer, install Visual Studio.

  2. ビルド コンピューターに、.NET Framework 4.5 をインストールします。On the build computer, install the .NET Framework 4.5. インストールされていることを確認するには、レジストリ キー HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full@Version の値が "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".

ホスト コンピューターからビルド コンピューターにファイルをコピーするCopying files from the host computer to the build computer

このセクションでは、特定のファイル、コンパイラ、ビルド ツール、MSBuild の資産、およびレジストリ設定をホスト コンピューターからビルド コンピューターにコピーする操作ついて説明します。This section covers the copying of specific files, compilers, build tools, MSBuild assets, and registry settings from the host computer to the build computer. ここに示す手順では、Visual Studio がホスト コンピューターの既定の場所にインストールされていることを想定しています。別の場所にインストールした場合は、手順を適宜調整してください。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.

  • x86 コンピューターの既定の場所は C:\Program Files\Microsoft Visual Studio 11.0\ です。On an x86 computer, the default location is C:\Program Files\Microsoft Visual Studio 11.0\

  • x64 コンピューターの既定の場所は 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\

    Program Files フォルダーの名前が、インストールされているオペレーティング システムによって異なる点に注意してください。Notice that the name of the Program Files folder depends on the operating system that's installed. x86 コンピューターでは \Program Files\、x64 コンピューターでは \Program Files (x86)\ です。On an x86 computer, the name is \Program Files\; on an x64 computer, the name is \Program Files (x86)\. システムのアーキテクチャに関係なく、このチュートリアルでは、Program Files フォルダーを %ProgramFiles% と示します。Irrespective of the system architecture, this walkthrough refers to the Program Files folder as %ProgramFiles%.

注意

ビルド コンピューターでは、関連するファイルをすべて同じドライブに配置する必要がありますが、そのドライブのドライブ文字は、Visual Studio がホスト コンピューターにインストールされているドライブのドライブ文字と異なってもかまいません。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. いずれにしても、後でこのドキュメント内で説明するように、レジストリ エントリの作成時にファイルの場所の情報が必要になります。In any case, you must account for the location of files when you create registry entries as described later in this document.

Windows SDK ファイルをビルド コンピューターにコピーするにはTo copy the Windows SDK files to the build computer

  1. Windows SDK for Windows 8 のみがインストールされている場合は、次に示すフォルダーを再帰的にホスト コンピューターからビルド コンピューターにコピーします。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\

      次に示す他の Windows 8 キットもインストールされている場合: If you also have these other Windows 8 kits...

    • Microsoft Windows アセスメント & デプロイメント キットMicrosoft Windows Assessment and Deployment Kit

    • Microsoft Windows Driver KitMicrosoft Windows Driver Kit

    • Microsoft Windows ハードウェア認定キットMicrosoft Windows Hardware Certification Kit

      これらもインストールされている場合、前の手順で示した %ProgramFiles%\Windows Kits\8.0\ フォルダーにファイルがインストールされている可能性があります。また、ライセンス条項によっては、ビルド サーバーでこれらのファイルへのアクセスが許可されない可能性があります。...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. インストールされているすべての Windows キットについてライセンス条項を調べて、ファイルをビルド コンピューターにコピーできるかどうかを確認します。Check the license terms for every installed Windows kit to verify whether files may be copied to your build computer. ライセンス条項によってビルド サーバーでのアクセスが許可されていない場合は、該当するファイルをビルド コンピューターから削除します。If the license terms don't allow build-server rights, then remove the files from the build computer.

  2. ホスト コンピューターからビルド コンピューターに、次のフォルダーを再帰的にコピーします。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. ホスト コンピューターからビルド コンピューターに、次のファイルをコピーします。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. 次に示す Visual C++ ランタイム ライブラリは、ビルド コンピューターで (たとえば自動テストの一部として) ビルド出力を実行する場合にのみ必要です。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. これらのファイルは通常、システムのアーキテクチャに応じて %ProgramFiles%\Microsoft Visual Studio 11.0\VC\redist\x86\ フォルダーまたは %ProgramFiles%\Microsoft Visual Studio 11.0\VC\redist\x64\ フォルダー内のサブフォルダーに配置されます。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. x86 システムの場合は、x86 バイナリを \Windows\System32\ フォルダーにコピーします。On x86 systems, copy the x86 binaries to the \Windows\System32\ folder. x64 システムでは、x86 バイナリを Windows\SysWOW64\ フォルダーに、x64 バイナリを 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. デバッグ バージョンのアプリケーションを実行するテスト用コンピューターの準備」の説明に従って、\Debug_NonRedist\x86\ フォルダーまたは \Debug_NonRedist\x64\ フォルダーから次のファイルのみをビルド コンピューターにコピーします。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. 他のファイルはコピーしないでください。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

レジストリ設定を作成するCreating registry settings

MSBuild 用の設定を構成するには、レジストリ エントリを作成する必要があります。You must create registry entries to configure settings for MSBuild.

レジストリ設定を作成するにはTo create registry settings

  1. レジストリ エントリの親フォルダーを特定します。Identify the parent folder for registry entries. レジストリ エントリはすべて、同じ親キーの下に作成します。All of the registry entries are created under the same parent key. x86 コンピューターの場合、親キーは HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ です。On an x86 computer, the parent key is HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\. x64 コンピューターの場合、親キーは HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\ です。On an x64 computer the parent key is HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\. システムのアーキテクチャに関係なく、このチュートリアルでは、親キーを %RegistryRoot% と示します。Irrespective of the system architecture, this walkthrough refers to the parent key as %RegistryRoot%.

    注意

    ホスト コンピューターのアーキテクチャがビルド コンピューターと異なる場合は、各コンピューターで適切な親キーを使用してください。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. このことは、エクスポート プロセスを自動化する場合に特に重要です。This is especially important if you're automating the export process.

    また、ホスト コンピューターで使用しているものと異なるドライブ文字をビルド コンピューターで使用する場合は、レジストリ エントリの値が一致するように必ず変更してください。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. 次のレジストリ エントリをビルド コンピューターに作成します。Create the following registry entries on the build computer. これらのエントリはすべて、文字列 (レジストリでの種類は "REG_SZ") です。All of these entries are strings (Type == "REG_SZ" in the registry). これらのエントリの値が、ホスト コンピューターの該当するエントリの値と同じになるように設定します。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 ディレクトリ%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

      x64 ビルド コンピューターでは、次のレジストリ エントリも作成し、ホスト コンピューターを参照して設定方法を決定します。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

      ビルド コンピューターが x64 であり MSBuild の 64 ビット バージョンを使用する場合または x64 コンピューターで Team Foundation Server ビルド サービスを使用している場合は、ネイティブの 64 ビット レジストリに次のレジストリ エントリを作成する必要があります。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. これらのエントリの設定方法を決定するには、ホスト コンピューターを参照してください。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

ビルド コンピューターで環境変数を設定するSetting environment variables on the build computer

ビルド コンピューターで MSBuild を使用するには、PATH 環境変数を設定する必要があります。To use MSBuild on the build computer, you must set the PATH environment variables. vcvarsall.bat を使用して変数を設定することも、手動で構成することもできます。You can use vcvarsall.bat to set the variables, or you can manually configure them.

vcvarsall.bat を使用して環境変数を設定するにはTo use vcvarsall.bat to set environment variables

  • ビルド コンピューターでコマンド プロンプト ウィンドウを開き、%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. 使用するツールセット (x86、ネイティブ x64、x64 クロス コンパイラ) を指定するには、コマンド ライン引数を使用します。You can use a command-line argument to specify the toolset you want to use—x86, native x64, or x64 cross-compiler. コマンド ライン引数を指定しなかった場合は、x86 のツールセットが使用されます。If you don't specify a command-line argument, the x86 toolset is used.

    次の表では、vcvarsall.bat でサポートされている引数を説明しています。This table describes the supported arguments for vcvarsall.bat:

    vcvarsall.bat 引数Vcvarsall.bat argument コンパイラCompiler ビルド コンピューターのアーキテクチャBuild computer architecture ビルド出力のアーキテクチャBuild output architecture
    x86 (既定)x86 (default) 32 ビット ネイティブ32-bit Native x86、x64x86, x64 x86x86
    x86_amd64x86_amd64 x64 クロスx64 Cross x86、x64x86, x64 x64x64
    amd64amd64 x64 ネイティブx64 Native x64x64 x64x64

    vcvarsall.bat が正常に実行された (エラー メッセージが表示されない) 場合は、次の手順をスキップして、このドキュメントの「ビルド コンピューターのグローバル アセンブリ キャッシュ (GAC) に MSBuild アセンブリをインストールする」に進むことができます。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.

手動で環境変数を設定するにはTo manually set environment variables

  1. 手動でコマンド ライン環境を構成するには、次のパスを 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. 必要に応じて、ソリューションのビルド時に MSBuild を使用しやすくなるように、次のパスも PATH 環境変数に追加することができます。Optionally, you can also add the following paths to the PATH variable to make it easier to use MSBuild to build your solutions.

    ネイティブ 32 ビットの MSBuild を使用する場合は、次のパスを 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

      ネイティブ 64 ビットの MSBuild を使用する場合は、次のパスを 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

ビルド コンピューターのグローバル アセンブリ キャッシュ (GAC) に MSBuild アセンブリをインストールするInstalling MSBuild assemblies to the Global Assembly Cache (GAC) on the build computer

MSBuild を使用するには、ビルド コンピューターの GAC にいくつかの追加のアセンブリをインストールする必要があります。MSBuild requires some additional assemblies to be installed to the GAC on the build computer.

ホスト コンピューターからアセンブリをコピーしてビルド コンピューターにインストールするにはTo copy assemblies from the host computer and install them on the build computer

  1. ホスト コンピューターからビルド コンピューターに次のアセンブリをコピーします。Copy the following assemblies from the host computer to the build computer. これらは GAC にインストールされるため、ビルド コンピューター上のコピー先の場所は重要ではありません。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. アセンブリを GAC にインストールするには、ビルド コンピューター上で gacutil.exe を探します。一般的には %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\. このフォルダーが見つからない場合は、このチュートリアルの「ホスト コンピューターからビルド コンピューターにファイルをコピーする」に記載されている手順を繰り返します。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.

    管理者権限でコマンド プロンプト ウィンドウを開き、ファイルごとに次のコマンドを実行します。Open a Command Prompt window that has administrative rights and run this command for each file:

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

    注意

    GAC へのアセンブリのインストールを完了するために、再起動が必要になる場合があります。A reboot may be required for an assembly to fully install into the GAC.

プロジェクトをビルドするBuilding projects

Visual Studio 2012Visual Studio 2012 のプロジェクトおよびソリューションをビルドするには、Team Foundation ビルドまたはコマンド ラインを使用します。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. Team Foundation ビルドを使用してプロジェクトをビルドすると、システムのアーキテクチャに対応する MSBuild 実行可能ファイルが起動されます。When you use Team Foundation Build to build projects, it invokes the MSBuild executable that corresponds to the system architecture. コマンド ラインでは、32 ビット MSBuild または 64 ビット MSBuild を使用できます。MSBuild のアーキテクチャは、PATH 環境変数を設定するか、アーキテクチャ固有の MSBuild 実行可能ファイルを直接呼び出すことによって選択できます。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.

コマンド プロンプトで msbuild.exe を使用するには、次のコマンドを実行します (solution.sln は、ソリューションの名前のプレースホルダーです)。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

コマンド ラインで MSBuild を使用する方法について詳しくは、「コマンド ライン リファレンス」をご覧ください。For more information about how to use MSBuild on the command line, see Command-Line Reference.

注意

Visual Studio 2012Visual Studio 2012 プロジェクトをビルドするには、"v110" のプラットフォーム ツールセットを使用する必要があります。To build Visual Studio 2012Visual Studio 2012 projects, you must use the "v110" Platform Toolset. Visual Studio 2012Visual Studio 2012 のプロジェクト ファイルを編集しない場合は、次のコマンド ライン引数を使用してプラットフォーム ツールセットを設定できます。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

ソース管理にチェックインできるようにビルド環境を作成するCreating the build environment so that it can be checked into source control

GAC へのファイルのインストールやレジストリ設定の変更を必要としない、さまざまなコンピューターに配置できるビルド環境を作成することもできます。You can create a build environment that can be deployed to various computers and doesn't require GAC'ing files or modifying registry settings. 次の手順は、これを実現する方法の 1 つです。The following steps are just one way to accomplish this. ビルド環境ごとの特性に合わせて、手順を調整してください。Adapt these steps to the unique characteristics of your build environment.

注意

ビルド時に tracker.exe によるエラーが発生しないように、インクリメンタル ビルドを無効にする必要があります。You must disable incremental building so that tracker.exe will not throw an error during a build. インクリメンタル ビルドを無効にするには、次のビルド パラメーターを設定します。To disable incremental building, set this build parameter:

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

ソース管理にチェックインできるようにビルド環境を作成するにはTo create a build environment that can be checked into source control

  1. ホスト コンピューターに "Depot" ディレクトリを作成します。Create a "Depot" directory on the host computer.

    ここに示す手順では、このディレクトリを %Depot% と示します。These steps refer to the directory as %Depot%.

  2. このチュートリアルの「ホスト コンピューターからビルド コンピューターにファイルをコピーする」の説明に従って、ディレクトリとファイルをコピーします。ただしコピー先は、先ほど作成した %Depot% ディレクトリ内とします。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. たとえば、%ProgramFiles%\Windows Kits\8.0\bin\ からのコピー先は %Depot%\Windows Kits\8.0\bin\ になります。For example, copy from %ProgramFiles%\Windows Kits\8.0\bin\ to %Depot%\Windows Kits\8.0\bin\.

  3. %Depot% へのファイルのコピーが完了したら、次の変更を行います。When the files are pasted in %Depot%, make these changes:

    • %Depot%\MSBuild\Microsoft.Cpp\v4.0\v110\Microsoft.CPP.Targets、\Microsoft.Cpp.InvalidPlatforms.targets\、\Microsoft.cppbuild.targets\、および \Microsoft.CppCommon.targets\ で、次のように変更します (すべてのインスタンスを変更します)。In %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"

      からto

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

      変更前の名前は、GAC にインストールするアセンブリに依存しています。The former naming relies on the assembly being GAC'ed.

    • %Depot% \MSBuild\Microsoft.Cpp\v4.0\v110\Microsoft.CPPClean.Targets で、In %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"

      からto

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

  4. .props ファイル (例: Partner.AutoImports.props) を作成し、プロジェクトが含まれるフォルダーのルートに配置します。Create a .props file—for example, Partner.AutoImports.props—and put it at the root of the folder that contains your projects. このファイルは、さまざまなリソースを検索するために MSBuild によって使用される変数の設定用に使用されます。This file is used to set variables that are used by MSBuild to find various resources. このファイルで設定されていない変数は、レジストリ値に依存する他の .props ファイルおよび .targets ファイルによって設定されます。If the variables are not set by this file, they are set by other .props files and .targets files that rely on registry values. ここではレジストリ値を設定しないため、これらの変数が空になり、ビルドは失敗します。Because we aren't setting any registry values, these variables would be empty and the build would fail. 代わりに、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. 各プロジェクト ファイル内の先頭で、<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. コマンド ライン環境を次のように変更します。Change the command-line environment as follows:

    • Set Depot=location of the Depot directory that you created in step 1Set Depot=location of the Depot directory that you created in step 1

    • Set path=%path%;location of MSBuild on the computer;%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\

      ネイティブ 64 ビットのビルドの場合は、64 ビットの MSBuild が指定されるように調整します。For native 64-bit building, point to the 64-bit MSBuild.

関連項目See Also

デバッグ バージョンのアプリケーションを実行するテスト用コンピューターの準備 Preparing a Test Machine To Run a Debug Executable
Command-Line Reference (コマンド ライン リファレンス)Command-Line Reference