Files
UnrealEngine/Engine/Build/Graph/Tasks/Inc/GauntletSettings.xml
2025-05-18 13:04:45 +08:00

58 lines
4.5 KiB
XML

<?xml version='1.0' ?>
<BuildGraph xmlns="http://www.epicgames.com/BuildGraph" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.epicgames.com/BuildGraph ../../Schema.xsd" >
<!--
This script defines parameters passed to Gauntlet. It is expected that most licensees will need
to create a custom version of this scrupt due to things like the device service url
This script should be includedEng after CommonProperties.xml and PathSettings.xml where build
strings and paths are defines
InProperty: ProjectName - Name of the project (e.g. <ProjectName>.uproject)
OutProperty: GauntletEditorTestArgs - Arguments to pass to Gauntlet tests executed under the editor
OutProperty: GauntletTargetTestArgs - Arguments to pass to Gauntlet tests executed using cooked builds
-->
<!-- How long to give Gauntlet before a test is considered timed out (some tests will time out earlier if they detect inactivity)-->
<Option Name="GauntletTimeout" DefaultValue="3600" Description="Max running time of a test in Gauntlet"/>
<Option Name="GauntletDeviceService" DefaultValue="" Description="Gauntlet Device Service to use for device reservation when running tests"/>
<Option Name="GauntletDevicePool" DefaultValue="UE4" Description="Gauntlet Device Pool to use to run target platform tests"/>
<Option Name="AlternateGauntletDevicePool" DefaultValue="UE5" Description="Alternate Gauntlet Device Pool to use to run target platform tests"/>
<Option Name="AlternateDevicePoolPlatforms" DefaultValue="XSX;PS5" Description="Platforms that need to use the Alternate Gauntlet Device Pool"/>
<Option Name="EnableDeviceLoginVerification" DefaultValue="$(IsBuildMachine)" Description="Verify a user is login on Devices that supports it, try to sign in if not."/>
<Option Name="ExtraGauntletCommonArgs" DefaultValue="" Description="Additional Common arguments passed to Gauntlet command line"/>
<Option Name="ExtraGauntletTargetTestArgs" DefaultValue="" Description="Additional Target test arguments passed to Gauntlet command line"/>
<Option Name="ExtraGauntletEditorTestArgs" DefaultValue="" Description="Additional Editor test arguments passed to Gauntlet command line"/>
<Option Name="AdbKeysPath" DefaultValue="" Description="Path to adbkeys location (for Android)"/>
<Option Name="DisableTestResultsForHorde" DefaultValue="false" Restrict="true|false" Description="Force disabling test results for Horde production"/>
<Property Name="GauntletCommonArgs" Value="-maxduration=$(GauntletTimeOut) -unattended -verbose -ResumeOnCriticalFailure $(ExtraGauntletCommonArgs)" />
<Property Name="GauntletCommonArgs" Value="$(GauntletCommonArgs) -WriteTestResultsForHorde" If="$(Horde) and !$(DisableTestResultsForHorde)"/>
<Property Name="GauntletCommonArgs" Value="$(GauntletCommonArgs) -branch=&quot;$(Branch)&quot; -changelist=&quot;$(Change)&quot;" />
<Property Name="GauntletDeviceArgs" Value="" />
<Property Name="GauntletDeviceArgs" Value="-reboot -cleardevices -sandbox=&quot;$(ProjectName)&quot;" If="$(IsBuildMachine)" />
<Property Name="GauntletDeviceArgs" Value="$(GauntletDeviceArgs) -VerifyLogin" If="$(EnableDeviceLoginVerification)"/>
<Property Name="GauntletDeviceAltArgs" Value="$(GauntletDeviceArgs)" />
<Do If="$(IsBuildMachine) And '$(GauntletDeviceService)' != ''">
<Property Name="GauntletDeviceArgs" Value="$(GauntletDeviceArgs) -deviceurl=$(GauntletDeviceService) -devicepool=&quot;$(GauntletDevicePool)&quot;"/>
<Property Name="GauntletDeviceAltArgs" Value="$(GauntletDeviceAltArgs) -deviceurl=$(GauntletDeviceService) -devicepool=&quot;$(AlternateGauntletDevicePool)&quot;"/>
</Do>
<Property Name="GauntletTargetTestArgs" Value="$(GauntletCommonArgs) $(GauntletDeviceArgs) $(ExtraGauntletTargetTestArgs)" />
<Property Name="GauntletTargetTestAltArgs" Value="$(GauntletCommonArgs) $(GauntletDeviceAltArgs) $(ExtraGauntletTargetTestArgs)" />
<Property Name="GauntletEditorTestArgs" Value="-build=editor $(GauntletCommonArgs) $(ExtraGauntletEditorTestArgs)" />
<Property Name="GauntletCookedEditorTestArgs" Value="-cookededitor $(GauntletCommonArgs) $(ExtraGauntletEditorTestArgs)" />
<!-- Arguments for handling devices when using device reservation block -->
<Property Name="GauntletPreInstallArgs" Value="-fullclean"/>
<Property Name="GauntletTestSkipInstallArgs" Value="-skipinstall"/>
<!-- this is fully generated dynamiclly when needed, it's simply here so it can be used without worrying if its set -->
<Property Name="GauntletReportArgs" Value="" />
</BuildGraph>