// Copyright Epic Games, Inc. All Rights Reserved. using System; using System.Collections.Generic; using System.Linq; using System.Text; using EpicGames.Core; using UnrealBuildBase; using UnrealBuildTool; namespace AutomationTool { public partial class CommandUtils { /// /// Runs UBT with the specified commandline. Automatically creates a logfile. When /// no LogName is specified, the executable name is used as logfile base name. /// /// Environment to use. /// Commandline to pass on to UBT. /// Optional logfile name. [Obsolete("Deprecated in UE5.1; function signature has changed")] public static void RunUBT(CommandEnvironment Env, string UBTExecutable, string CommandLine) { if (!FileExists(UBTExecutable)) { throw new AutomationException("Unable to find UBT executable: " + UBTExecutable); } string BaseLogName = String.Format("UBT-{0}", String.Join("-", SharedUtils.ParseCommandLine(CommandLine).Where(x => !x.Contains('/') && !x.Contains('\\') && !x.StartsWith("-")))); string LogName; for(int Attempt = 1;;Attempt++) { LogName = String.Format("{0}.txt", (Attempt == 1)? BaseLogName : String.Format("{0}_{1}", BaseLogName, Attempt)); FileReference LogLocation = FileReference.Combine(new DirectoryReference(Env.LogFolder), LogName); if(!FileReference.Exists(LogLocation)) { CommandLine += String.Format(" -log=\"{0}\"", LogLocation); break; } if (Attempt >= 50) { throw new AutomationException("Unable to find name for UBT log file after {0} attempts", Attempt); } } IProcessResult Result = Run(UBTExecutable, CommandLine, Options: ERunOptions.AllowSpew | ERunOptions.NoStdOutCapture); if(Result.ExitCode != 0) { throw new AutomationException((ExitCode)Result.ExitCode, "UnrealBuildTool failed. See log for more details. ({0})", CommandUtils.CombinePaths(Env.FinalLogFolder, LogName)) { OutputFormat = AutomationExceptionOutputFormat.Minimal }; } } /// /// Runs UBT with the specified commandline. Automatically creates a logfile. When /// no LogName is specified, the executable name is used as logfile base name. /// /// Environment to use. /// Commandline to pass on to UBT. /// Optional logfile name. public static void RunUBT(CommandEnvironment Env, FileReference UnrealBuildToolDll, string CommandLine) { if (!FileReference.Exists(UnrealBuildToolDll)) { throw new AutomationException($"Unable to find UnrealBuildTool.dll: {UnrealBuildToolDll}"); } string BaseLogName = String.Format("UBT-{0}", String.Join("-", SharedUtils.ParseCommandLine(CommandLine).Where(x => !x.Contains('/') && !x.Contains('\\') && !x.StartsWith("-")))); string LogName; for(int Attempt = 1;;Attempt++) { LogName = String.Format("{0}.txt", (Attempt == 1)? BaseLogName : String.Format("{0}_{1}", BaseLogName, Attempt)); FileReference LogLocation = FileReference.Combine(new DirectoryReference(Env.LogFolder), LogName); if(!FileReference.Exists(LogLocation)) { CommandLine += String.Format(" -log=\"{0}\"", LogLocation); break; } if (Attempt >= 50) { throw new AutomationException("Unable to find name for UBT log file after {0} attempts", Attempt); } } CommandLine = $"\"{UnrealBuildToolDll}\" {CommandLine}"; IProcessResult Result = Run(Unreal.DotnetPath.FullName, CommandLine, Options: ERunOptions.AllowSpew | ERunOptions.NoStdOutCapture); if(Result.ExitCode != 0) { throw new AutomationException((ExitCode)Result.ExitCode, "UnrealBuildTool failed. See log for more details. ({0})", CommandUtils.CombinePaths(Env.FinalLogFolder, LogName)) { OutputFormat = AutomationExceptionOutputFormat.Minimal }; } } /// /// Builds a UBT Commandline. /// /// Unreal project to build (optional) /// Target to build. /// Platform to build for. /// Configuration to build. /// Additional arguments to pass on to UBT. public static string UBTCommandline(FileReference Project, string Target, UnrealTargetPlatform Platform, UnrealTargetConfiguration Config, string AdditionalArgs = "") { string CmdLine; if (Project == null) { CmdLine = String.Format("{0} {1} {2} {3}", Target, Platform, Config, AdditionalArgs); } else { CmdLine = String.Format("{0} {1} {2} -Project={3} {4}", Target, Platform, Config, CommandUtils.MakePathSafeToUseWithCommandLine(Project.FullName), AdditionalArgs); } return CmdLine; } /// /// Builds a target using UBT. Automatically creates a logfile. When /// no LogName is specified, the executable name is used as logfile base name. /// /// BuildEnvironment to use. /// Unreal project to build (optional) /// Target to build. /// Platform to build for. /// Configuration to build. /// Additional arguments to pass on to UBT. /// Optional logifle name. [Obsolete("Deprecated in UE5.1; Use the alternate version below with the UnrealBuildTool.dll, not executable")] public static void RunUBT(CommandEnvironment Env, string UBTExecutable, FileReference Project, string Target, UnrealTargetPlatform Platform, UnrealTargetConfiguration Config, string AdditionalArgs = "") { RunUBT(Env, UBTExecutable, UBTCommandline(Project, Target, Platform, Config, AdditionalArgs)); } /// /// Builds a target using UBT. Automatically creates a logfile. When /// no LogName is specified, the executable name is used as logfile base name. /// /// BuildEnvironment to use. /// Unreal project to build (optional) /// Target to build. /// Platform to build for. /// Configuration to build. /// Additional arguments to pass on to UBT. /// Optional logifle name. public static void RunUBT(CommandEnvironment Env, FileReference UnrealBuildToolDll, FileReference Project, string Target, UnrealTargetPlatform Platform, UnrealTargetConfiguration Config, string AdditionalArgs = "") { RunUBT(Env, UnrealBuildToolDll, UBTCommandline(Project, Target, Platform, Config, AdditionalArgs)); } } }