// Copyright 1998-2015 Epic Games, Inc. All Rights Reserved. using System; using System.Collections.Generic; using System.Text.RegularExpressions; using System.Diagnostics; using System.IO; using Microsoft.Win32; using System.Text; namespace UnrealBuildTool { class VCEnvironment { public readonly CPPTargetPlatform Platform; // The platform the envvars have been initialized for public readonly string BaseVSToolPath; // The path to Visual Studio's /Common7/Tools directory. public readonly string PlatformVSToolPath; // The path to the platform tool binaries. public readonly string WindowsSDKDir; // Installation folder of the Windows SDK, e.g. C:\Program Files\Microsoft SDKs\Windows\v6.0A\ public readonly string CompilerPath; // The path to the linker for linking executables public readonly Version CLExeVersion; // The version of cl.exe we're running public readonly string LinkerPath; // The path to the linker for linking executables public readonly string LibraryLinkerPath; // The path to the linker for linking libraries public readonly string ResourceCompilerPath; // The path to the resource compiler private string _MSBuildPath = null; public string MSBuildPath // The path to MSBuild { get { if (_MSBuildPath == null) { _MSBuildPath = GetMSBuildToolPath(); } return _MSBuildPath; } } /** * Initializes environment variables required by toolchain. Different for 32 and 64 bit. */ public static VCEnvironment SetEnvironment(CPPTargetPlatform Platform) { if (EnvVars != null && EnvVars.Platform == Platform) { return EnvVars; } EnvVars = new VCEnvironment(Platform); return EnvVars; } private VCEnvironment(CPPTargetPlatform InPlatform) { Platform = InPlatform; // If Visual Studio is not installed, the Windows SDK path will be used, which also happens to be the same // directory. (It installs the toolchain into the folder where Visual Studio would have installed it to). BaseVSToolPath = WindowsPlatform.GetVSComnToolsPath(); if (string.IsNullOrEmpty(BaseVSToolPath)) { throw new BuildException("Visual Studio 2012 or Visual Studio 2013 must be installed in order to build this target."); } WindowsSDKDir = FindWindowsSDKInstallationFolder(Platform); PlatformVSToolPath = GetPlatformVSToolPath (Platform, BaseVSToolPath); CompilerPath = GetCompilerToolPath (PlatformVSToolPath); CLExeVersion = FindCLExeVersion (CompilerPath); LinkerPath = GetLinkerToolPath (PlatformVSToolPath); LibraryLinkerPath = GetLibraryLinkerToolPath (PlatformVSToolPath); ResourceCompilerPath = GetResourceCompilerToolPath(Platform, WindowsSDKDir); var VCVarsBatchFile = Path.Combine(BaseVSToolPath, (Platform == CPPTargetPlatform.Win64) ? "../../VC/bin/x86_amd64/vcvarsx86_amd64.bat" : "vsvars32.bat"); Utils.SetEnvironmentVariablesFromBatchFile(VCVarsBatchFile); // When targeting Windows XP on Visual Studio 2012+, we need to override the Windows SDK include and lib path set // by the batch file environment (http://blogs.msdn.com/b/vcblog/archive/2012/10/08/10357555.aspx) if (WindowsPlatform.IsWindowsXPSupported()) { // Lib and bin folders have a x64 subfolder for 64 bit development. var ConfigSuffix = (Platform == CPPTargetPlatform.Win64) ? "\\x64" : ""; Environment.SetEnvironmentVariable("PATH", Utils.ResolveEnvironmentVariable(WindowsSDKDir + "bin" + ConfigSuffix + ";%PATH%")); Environment.SetEnvironmentVariable("LIB", Utils.ResolveEnvironmentVariable(WindowsSDKDir + "lib" + ConfigSuffix + ";%LIB%")); Environment.SetEnvironmentVariable("INCLUDE", Utils.ResolveEnvironmentVariable(WindowsSDKDir + "include;%INCLUDE%")); } } /// The path to Windows SDK directory for the specified version. private static string FindWindowsSDKInstallationFolder(CPPTargetPlatform InPlatform) { // When targeting Windows XP on Visual Studio 2012+, we need to point at the older Windows SDK 7.1A that comes // installed with Visual Studio 2012 Update 1. (http://blogs.msdn.com/b/vcblog/archive/2012/10/08/10357555.aspx) string Version; if (WindowsPlatform.IsWindowsXPSupported()) { Version = "v7.1A"; } else switch (WindowsPlatform.Compiler) { case WindowsCompiler.VisualStudio2013: Version = "v8.1"; break; case WindowsCompiler.VisualStudio2012: Version = "v8.0"; break; default: throw new BuildException("Unexpected compiler setting when trying to determine Windows SDK folder"); } // Based on VCVarsQueryRegistry var Result = Microsoft.Win32.Registry.GetValue(@"HKEY_CURRENT_USER\SOFTWARE\Microsoft\Microsoft SDKs\Windows\" + Version, "InstallationFolder", null) ?? Microsoft.Win32.Registry.GetValue(@"HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Microsoft SDKs\Windows\" + Version, "InstallationFolder", null) ?? Microsoft.Win32.Registry.GetValue(@"HKEY_CURRENT_USER\SOFTWARE\Wow6432Node\Microsoft\Microsoft SDKs\Windows\" + Version, "InstallationFolder", null); if (Result == null) { throw new BuildException("Windows SDK {0} must be installed in order to build this target.", Version); } return (string)Result; } /** Gets the path to the tool binaries for the specified platform. */ static string GetPlatformVSToolPath(CPPTargetPlatform Platform, string BaseVSToolPath) { // Regardless of the target, if we're linking on a 64 bit machine, we want to use the 64 bit linker (it's faster than the 32 bit linker) //@todo.WIN32: Using the 64-bit linker appears to be broken at the moment. if (Platform == CPPTargetPlatform.Win64) { // Use the native 64-bit compiler if present, otherwise use the amd64-on-x86 compiler. VS2012 Express only includes the latter. var Result = Path.Combine(BaseVSToolPath, "../../VC/bin/amd64"); if (Directory.Exists(Result)) { return Result; } return Path.Combine(BaseVSToolPath, "../../VC/bin/x86_amd64"); } return Path.Combine(BaseVSToolPath, "../../VC/bin"); } /** Gets the path to the compiler. */ static string GetCompilerToolPath(string PlatformVSToolPath) { // If we were asked to use Clang, then we'll redirect the path to the compiler to the LLVM installation directory if (WindowsPlatform.bCompileWithClang) { string Result; if( WindowsPlatform.bUseVCCompilerArgs ) { // Use regular Clang compiler on Windows Result = Path.Combine( Environment.GetFolderPath( Environment.SpecialFolder.ProgramFilesX86 ), "LLVM", "msbuild-bin", "cl.exe" ); } else { // Use 'clang-cl', a wrapper around Clang that supports Visual C++ compiler command-line arguments Result = Path.Combine( Environment.GetFolderPath( Environment.SpecialFolder.ProgramFilesX86 ), "LLVM", "bin", "clang.exe" ); } if (!File.Exists(Result)) { throw new BuildException( "Clang was selected as the Windows compiler, but LLVM/Clang does not appear to be installed. Could not find: " + Result ); } return Result; } return Path.Combine(PlatformVSToolPath, "cl.exe"); } /// The version of the compiler. private static Version FindCLExeVersion(string CompilerExe) { var ExeVersionInfo = FileVersionInfo.GetVersionInfo(CompilerExe); if (ExeVersionInfo == null) { throw new BuildException("Failed to read the version number of: " + CompilerExe); } return new Version(ExeVersionInfo.FileMajorPart, ExeVersionInfo.FileMinorPart, ExeVersionInfo.FileBuildPart, ExeVersionInfo.FilePrivatePart); } /** Gets the path to the linker. */ static string GetLinkerToolPath(string PlatformVSToolPath) { // If we were asked to use Clang, then we'll redirect the path to the compiler to the LLVM installation directory if( WindowsPlatform.bCompileWithClang && WindowsPlatform.bAllowClangLinker ) { var Result = Path.Combine( Environment.GetFolderPath( Environment.SpecialFolder.ProgramFilesX86 ), "LLVM", "bin", "lld.exe" ); if( !File.Exists( Result ) ) { throw new BuildException( "Clang was selected as the Windows compiler, but LLVM/Clang does not appear to be installed. Could not find: " + Result ); } return Result; } return Path.Combine(PlatformVSToolPath, "link.exe"); } /** Gets the path to the library linker. */ static string GetLibraryLinkerToolPath(string PlatformVSToolPath) { // Regardless of the target, if we're linking on a 64 bit machine, we want to use the 64 bit linker (it's faster than the 32 bit linker) //@todo.WIN32: Using the 64-bit linker appears to be broken at the moment. return Path.Combine(PlatformVSToolPath, "lib.exe"); } /** Gets the path to the resource compiler's rc.exe for the specified platform. */ static string GetResourceCompilerToolPath(CPPTargetPlatform Platform, string WindowsSDKDir) { // 64 bit -- we can use the 32 bit version to target 64 bit on 32 bit OS. if (Platform == CPPTargetPlatform.Win64) { return Path.Combine(WindowsSDKDir, "bin/x64/rc.exe"); } if (!WindowsPlatform.IsWindowsXPSupported()) // Windows XP requires use to force Windows SDK 7.1 even on the newer compiler, so we need the old path RC.exe { return Path.Combine(WindowsSDKDir, "bin/x86/rc.exe"); } return Path.Combine(WindowsSDKDir, "bin/rc.exe"); } /** Gets the path to MSBuild. */ static string GetMSBuildToolPath() { string FrameworkDirectory = Environment.GetEnvironmentVariable("FrameworkDir"); string FrameworkVersion = Environment.GetEnvironmentVariable("FrameworkVersion"); if (FrameworkDirectory == null || FrameworkVersion == null) { throw new BuildException( "NOTE: Please ensure that 64bit Tools are installed with DevStudio - there is usually an option to install these during install" ); } return Path.Combine(FrameworkDirectory, FrameworkVersion, "MSBuild.exe"); } static VCEnvironment EnvVars = null; } }