@echo off rem ## Unreal Engine 4 Visual Studio project setup script rem ## Copyright 1998-2019 Epic Games, Inc. All Rights Reserved. rem ## rem ## This script is expecting to exist in the UE4 root directory. It will not work correctly rem ## if you copy it to a different location and run it. setlocal echo Setting up Unreal Engine 4 project files... rem ## First, make sure the batch file exists in the folder we expect it to. This is necessary in order to rem ## verify that our relative path to the /Engine/Source directory is correct if not exist "%~dp0..\..\Source" goto Error_BatchFileInWrongLocation rem ## Change the CWD to /Engine/Source. We always need to run UnrealBuildTool from /Engine/Source! pushd "%~dp0..\..\Source" if not exist ..\Build\BatchFiles\GenerateProjectFiles.bat goto Error_BatchFileInWrongLocation rem ## Check to make sure that we have a Binaries directory with at least one dependency that we know that UnrealBuildTool will need rem ## in order to run. It's possible the user acquired source but did not download and unpack the other prerequiste binaries. if not exist ..\Build\BinaryPrerequisitesMarker.dat goto Error_MissingBinaryPrerequisites rem ## Get the path to MSBuild call "%~dp0GetMSBuildPath.bat" if errorlevel 1 goto Error_NoVisualStudioEnvironment call "%~dp0FixDependencyFiles.bat" rem ## If we're using VS2017, check that NuGet package manager is installed. MSBuild fails to compile C# projects from the command line with a cryptic error if it's not: rem ## https://developercommunity.visualstudio.com/content/problem/137779/the-getreferencenearesttargetframeworktask-task-wa.html if not exist "%ProgramFiles(x86)%\Microsoft Visual Studio\Installer\vswhere.exe" goto NoVsWhere set MSBUILD_15_EXE= for /f "delims=" %%i in ('"%ProgramFiles(x86)%\Microsoft Visual Studio\Installer\vswhere" -latest -products * -requires Microsoft.Component.MSBuild -property installationPath') do ( if exist "%%i\MSBuild\15.0\Bin\MSBuild.exe" ( set MSBUILD_15_EXE="%%i\MSBuild\15.0\Bin\MSBuild.exe" goto FoundMsBuild15 ) ) :FoundMsBuild15 set MSBUILD_15_EXE_WITH_NUGET= for /f "delims=" %%i in ('"%ProgramFiles(x86)%\Microsoft Visual Studio\Installer\vswhere" -latest -products * -requires Microsoft.Component.MSBuild -requires Microsoft.VisualStudio.Component.NuGet -property installationPath') do ( if exist "%%i\MSBuild\15.0\Bin\MSBuild.exe" ( set MSBUILD_15_EXE_WITH_NUGET="%%i\MSBuild\15.0\Bin\MSBuild.exe" goto FoundMsBuild15WithNuget ) ) :FoundMsBuild15WithNuget if not [%MSBUILD_EXE%] == [%MSBUILD_15_EXE%] goto NoVsWhere if not [%MSBUILD_EXE%] == [%MSBUILD_15_EXE_WITH_NUGET%] goto Error_RequireNugetPackageManager :NoVsWhere rem Find platform extension source files call "%~dp0FindPlatformExtensionSources.bat" rem Check to see if the files in the UBT directory have changed. We conditionally include platform files from the .csproj file, but MSBuild doesn't recognize the dependency when new files are added. md ..\Intermediate\Build >nul 2>nul dir /s /b Programs\UnrealBuildTool\*.cs >..\Intermediate\Build\UnrealBuildToolFiles.txt if exist ..\..\Platforms dir /s /b ..\..\Platforms\*.cs >> ..\Intermediate\Build\UnrealBuildToolFiles.txt fc /b ..\Intermediate\Build\UnrealBuildToolFiles.txt ..\Intermediate\Build\UnrealBuildToolPrevFiles.txt >nul 2>nul if not errorlevel 1 goto SkipClean copy /y ..\Intermediate\Build\UnrealBuildToolFiles.txt ..\Intermediate\Build\UnrealBuildToolPrevFiles.txt >nul %MSBUILD_EXE% /nologo /verbosity:quiet Programs\UnrealBuildTool\UnrealBuildTool.csproj /property:Configuration=Development /property:Platform=AnyCPU /target:Clean :SkipClean %MSBUILD_EXE% /nologo /verbosity:quiet Programs\UnrealBuildTool\UnrealBuildTool.csproj /property:Configuration=Development /property:Platform=AnyCPU /target:Build if errorlevel 1 goto Error_UBTCompileFailed rem ## Run UnrealBuildTool to generate Visual Studio solution and project files rem ## NOTE: We also pass along any arguments to the GenerateProjectFiles.bat here ..\Binaries\DotNET\UnrealBuildTool.exe -ProjectFiles %* if errorlevel 1 goto Error_ProjectGenerationFailed rem ## Success! popd exit /B 0 :Error_BatchFileInWrongLocation echo. echo GenerateProjectFiles ERROR: The batch file does not appear to be located in the /Engine/Build/BatchFiles directory. This script must be run from within that directory. echo. pause goto Exit :Error_MissingBinaryPrerequisites echo. echo GenerateProjectFiles ERROR: It looks like you're missing some files that are required in order to generate projects. Please check that you've downloaded and unpacked the engine source code, binaries, content and third-party dependencies before running this script. echo. pause goto Exit :Error_NoVisualStudioEnvironment echo. echo GenerateProjectFiles ERROR: Unable to find a valid installation of Visual Studio. Please check that you have Visual Studio 2017 or Visual Studio 2019 installed, and the MSBuild component is selected as part of your installation. echo. pause goto Exit :Error_RequireNugetPackageManager echo. echo UE4 requires the NuGet Package Manager to be installed to use %MSBUILD_EXE%. Please run the Visual Studio Installer and add it from the individual components list (in the 'Code Tools' category). echo. pause goto Exit :Error_UBTCompileFailed echo. echo GenerateProjectFiles ERROR: UnrealBuildTool failed to compile. echo. pause goto Exit :Error_ProjectGenerationFailed echo. echo GenerateProjectFiles ERROR: UnrealBuildTool was unable to generate project files. echo. pause goto Exit :Exit rem ## Restore original CWD in case we change it popd exit /B 1