FASTBuild is an open-source distributed build system, which could be a free alternative to Incredibuild. Unreal Engine 4 (UE4) does not support FASTBuild natively, however it's not hard to integrate it manually.
We assume you already have the full UE4 source code. First you'll need to grab the latest FASTBuild tools from here. We use v0.93 Windows x64 version in this tutorial. Download it and extract all the files. Here you have several choices:
- Place the files under any folder which could be found with your system's
PATHenvironment variable. To see where these folders are, run thePATHcommand in a command prompt window; - Place the files under the
Engine\Binaries\ThirdParty\FASTBuildfolder of your engine. This is the recommended place; - Place the files anywhere you like. This is not recommended because you'll have to hard-code the path later.
Then you'll need an ActionExecutor, which acts as a bridge between Unreal Build Tool (UBT) and FASTBuild. There is already one written by liamkf, I also forked it and made my own version, which contains bug fixes and improvements. In this tutorial, I would recommend and use this variant. You can get it here.
The ActionExeuctor is simply a C# class. Download the file FASTBuild.cs and place it under the Engine\Source\Programs\UnrealBuildTool\System folder of your engine.
If you have placed your FASTBuild files in a random location, you can change the default value of FBuildExePathOverride in FASTBuild.cs.
The next step is to teach Unreal Build Tool how to use FASTBuild. This involves several modifications to the engine code. Add the lines with the plus sign before them to your engine's source code.
Location: Engine\Source\Programs\UnrealBuildTool\Configuration\BuildConfiguration.cs
[XmlConfig]
public static bool bUseUHTMakefiles;
+ [XmlConfig]
+ public static bool bAllowFastbuild;
/// <summary>
/// Whether DMUCS/Distcc may be used.
/// </summary>
[XmlConfig]
public static bool bAllowDistcc; public static void LoadDefaults()
{
bAllowLTCG = false;
bAllowASLRInShipping = true;
bAllowRemotelyCompiledPCHs = false;
bAllowXGE = true;
bXGENoWatchdogThread = false;
bAllowSNDBS = true;
+ bAllowFastbuild = true;
bUsePDBFiles = false; //Only required if you're using MSVC public static void ValidateConfiguration(CPPTargetConfiguration Configuration, CPPTargetPlatform Platform, bool bCreateDebugInfo, UEBuildPlatformContext PlatformContext)
{
UEBuildPlatform BuildPlatform = UEBuildPlatform.GetBuildPlatformForCPPTargetPlatform(Platform);
+ if (!BuildPlatform.CanUseFastbuild())
+ {
+ bAllowFastbuild = false;
+ }
// E&C support.
if (bSupportEditAndContinue)
{
bUseIncrementalLinking = BuildPlatform.ShouldUseIncrementalLinking(Platform, Configuration);
}Location: Engine\Source\Programs\UnrealBuildTool\Configuration\UEBuildPlatform.cs
public virtual bool CanUseDistcc()
{
return false;
}
+ public virtual bool CanUseFastbuild()
+ {
+ return false;
+ }
/// <summary>
/// If this platform can be compiled with SN-DBS
/// </summary>
public virtual bool CanUseSNDBS()
{
return false;
}Location: Engine\Source\Programs\UnrealBuildTool\System\ActionGraph.cs
if ((XGE.IsAvailable() && BuildConfiguration.bAllowXGE) || BuildConfiguration.bXGEExport)
{
Executor = new XGE();
}
+ else if (FASTBuild.IsAvailable() && BuildConfiguration.bAllowFastbuild)
+ {
+ Executor = new FASTBuild();
+ }
else if(BuildConfiguration.bAllowDistcc)
{
Executor = new Distcc();
}Location: Engine\Source\Programs\UnrealBuildTool\Windows\UEBuildWindows.cs
[XmlConfig]
public static bool bLogDetailedCompilerTimingInfo = false;
+ public override bool CanUseFastbuild()
+ {
+ return true;
+ }
/// True if we should use Clang/LLVM instead of MSVC to compile code on Windows platform
public static readonly bool bCompileWithClang = false;That should be all. Your UE4 source code compilation will be handled by FASTBuild from now on.
FASTBuild Documentation has fully covered this topic. Essentially, you'll need to:
- Have a shared folder which everyone in the intra-network can read and write
- Have the build machine (master) and all worker machines (slaves) set their
FASTBUILD_BROKERAGE_PATHenvironment variable to the address of this shared folder. You can use thesetxcommand or the Advanced System Settings window to do this. - Run
FBuildWorker.exeon all worker machines
I prefer to write a batch file so all team members can set this up in a double-click:
setx FASTBUILD_BROKERAGE_PATH "\\smellyriver\FASTBuild" :: set environment variable
reg add HKCU\Software\Microsoft\Windows\CurrentVersion\Run /v FASTBuildWorker /d FBuildWorker.exe :: start with windows
start FBuildWorker.exe :: run build workerYou can check the shared folder to see which worker machines are available.
FASTBuild can cache built objects. As long as the corresponding source is not changed, FASTBuild can reuse the cached object, rather than compile it again. This brings a tremendous boost to compile speed. You can either place the cache folder locally or in a network sharing place. Local cache has better performance (due to heavy IO), but network cache could be shared with your team, so team members could take advantage of others' build result.
To enable cache mode, you can either:
- set the
FASTBUILD_CACHE_PATHenvironment variable to the path of your cache folder - or, modify FASTBuild.cs:
private bool bEnableCaching = true; // enable caching
private string CachePath = @"\\YourCacheFolderPath"; // set cache folder pathIf you have Incredibuild installed, it will have a higher priority over FASTBuild. You can turn off UE4's Incredibuild support by modifying BuildConfiguration.xml:
Location: Engine\Saved\UnrealBuildTool\BuildConfiguration.xml
<?xml version="1.0" encoding="utf-8" ?>
<Configuration xmlns="https://www.unrealengine.com/BuildConfiguration">
<BuildConfiguration>
+ <bAllowXGE>false</bAllowXGE>
</BuildConfiguration>
</Configuration>
If you are using Windows 10 SDK, there could be some issues with the XInput library. Modify Core.Build.cs to fix this:
Location: Engine\Source\Runtime\Core\Core.Build.cs
- AddEngineThirdPartyPrivateStaticDependencies(Target,
- "IntelTBB",
- "XInput");
+ AddEngineThirdPartyPrivateStaticDependencies(Target,
+ "IntelTBB");
+ if (!WindowsPlatform.bUseWindowsSDK10)
+ {
+ AddEngineThirdPartyPrivateStaticDependencies(Target, "XInput");
+ }
+ else
+ {
+ PublicAdditionalLibraries.Add("XInput.lib"); //Included in Win10 SDK
+ }The following warning could be raised during compilation:
warning C4628: digraphs not supported with -Ze. Character sequence '<:' not interpreted as alternate token for '['
You can suppress this warning by modifying WindowsPlatformCompilerSetup.h:
Location: Engine\Source\Runtime\Core\Public\Windows\WindowsPlatformCompilerSetup
- #pragma warning(default : 4628) // digraphs not supported with -Ze. Character sequence 'digraph' not interpreted as alternate token for 'char'
+ #pragma warning(disable : 4628) // digraphs not supported with -Ze. Character sequence 'digraph' not interpreted as alternate token for 'char'(i.e. change default to disable.)
Have you considered opening a PR for this work with Epic? It would be great to see this in the official engine. I'm going to try integrating this in our version soon enough. Thanks!