Navigation
API > API/Developer > API/Developer/LauncherServices
References
| Module | LauncherServices |
| Header | /Engine/Source/Developer/LauncherServices/Public/ILauncherProfile.h |
| Include | #include "ILauncherProfile.h" |
Syntax
class ILauncherProfile
Remarks
Interface for launcher profile.
Destructors
| Type | Name | Description | |
|---|---|---|---|
| Virtual destructor. |
Functions
| Type | Name | Description | |
|---|---|---|---|
| void | AddCookedCulture
(
const FString& CultureName |
Adds a culture to cook (only used if cooking by the book). | |
| void | AddCookedMap
(
const FString& MapName |
Adds a map to cook (only used if cooking by the book). | |
| void | AddCookedPlatform
(
const FString& PlatformName |
Adds a platform to cook (only used if cooking by the book). | |
| void | Removes all cooked cultures. | ||
| void | Removes all cooked maps. | ||
| void | Removes all cooked platforms. | ||
| ILauncherProfileLaunchRolePtr | Creates a new launch role and adds it to the profile. | ||
| void | Notifies the profile that the fallback build target changed. | ||
| void | Notifies the profile that the fallback project path changed. | ||
| FString | Gets the additional command line parameters that will be used when the app launches. | ||
| FString | Gets the archive directory. | ||
| FString | |||
| EBuildConfiguration | Gets the name of the build configuration. | ||
| ELauncherProfileBuildModes::Type | GetBuildMode () |
Gets the current build mode. | |
| FString | Gets the build target.Target name to build/run (it would match a .Target.cs file) | ||
| EBuildConfiguration | Gets the build configuration name of the cooker. | ||
| const TArray< FString > & | Gets the list of cooked culture. | ||
| const TArray< FString > & | Gets the list of cooked maps. | ||
| const TArray< FString > & | Gets the names of the platforms to build for. | ||
| ELauncherProfileCookModes::Type | GetCookMode () |
Gets the selected cook mode. | |
| const FString & | Gets the cooker command line options. | ||
| FString | |||
| const FName | Gets the default platforms to deploy if no specific devices were selected. | ||
| const ILauncherProfileLaunchRoleRef & | Gets the default launch role. | ||
| ILauncherDeviceGroupPtr | Gets the device group to deploy to. | ||
| ELauncherProfileDeploymentModes::Type | Gets the deployment mode. | ||
| FString | Gets the human readable description of the profile. | ||
| FString | GetDLCName () |
||
| FString | GetEditorExe () |
Gets the path to the editor executable. | |
| TArray< FString > | Helper function to get all of the build targets available for this profile, based on its current project & cook platforms | ||
| FString | GetFileName () |
Gets the file name for serialization. | |
| FString | GetFilePath () |
Gets the full file path for serialization. | |
| bool | Gets the close mode for the cook on the fly server | ||
| FString | Where generated http chunk install data will be stored. | ||
| FString | What name to tag the generated http chunk install data with. | ||
| FGuid | GetId () |
Gets the unique identifier of the profile. | |
| FString | Gets the invalid platform, this is only valid when there is a platform centric validation error. | ||
| ELauncherProfileLaunchModes::Type | Gets the launch mode. | ||
| const TArray< ILauncherProfileLaunchRolePtr > & | Gets the profile's collection of launch roles. | ||
| const int32 | GetLaunchRolesFor
(
const FString& DeviceId, |
Gets the launch roles assigned to the specified device. | |
| FString | GetName () |
Gets the human readable name of the profile. | |
| FString | |||
| FString | Gets the packaging directory. | ||
| ELauncherProfilePackagingModes::Type | Gets the packaging mode. | ||
| FString | Gets the base project path for the project (e.g. Samples/Showcases/MyShowcase) | ||
| FString | Gets the name of the Unreal project to use. | ||
| FString | Gets the full path to the Unreal project to use. | ||
| FString | |||
| FString | Provides a database of compressed iostore chunks to reuse during the staging process. | ||
| const bool | |||
| uint32 | GetTimeout () |
Gets the timeout time for the cook on the fly server. | |
| bool | Checks whether the profile specifies a build target. | ||
| bool | Checks whether the profile specifies a project. | ||
| bool | Checks whether the last validation yielded any error. | ||
| bool | Checks whether the last validation yielded the specified error. | ||
| bool | IsArchiving () |
Whether to archive build | |
| bool | Checks whether UAT should be built. | ||
| bool | IsCompressed () |
Checks if compression is enabled | |
| bool | Checks whether incremental cooking is enabled. | ||
| bool | Checks whether unversioned cooking is enabled. | ||
| bool | |||
| bool | Creating a release version of the cooked content | ||
| bool | IsDeployablePlatform
(
const FString& PlatformName |
Checks whether devices of the specified platform can be deployed to. | |
| bool | Checks whether incremental deployment is enabled. | ||
| bool | |||
| bool | Checks if encrypting ini files is enabled | ||
| bool | Checks whether the file server's console window should be hidden. | ||
| bool | Checks whether the file server is a streaming file server. | ||
| bool | Checks if encrypting ini files is enabled | ||
| bool | Return whether packaging will use chunk data to generate http chunk install data. | ||
| bool | Return whether packaging will generate chunk data. | ||
| bool | Are we going to generate a patch (Source content patch needs to be specified) GetPatchSourceContentPath * SetPatchSourceContentPath | ||
| bool | Checks whether to include an installer for prerequisites of packaged games, such as redistributable operating system components, on platforms that support it. | ||
| bool | |||
| bool | Checks whether packaging with UnrealPak is enabled. | ||
| bool | Whether or not to save the unaltered staged directory for platforms that modify i/o store containers for deployment. | ||
| bool | Using I/O store or not. | ||
| bool | Using Zen storage server or not. | ||
| bool | Checks whether this profile is valid to use when running a game instance. | ||
| bool | Load
(
const FJsonObject& Object |
Loads the profile from a JSON file | |
| bool | Make binary config file during staging or not. | ||
| FOnProfileBuildTargetOptionsChanged & | Access delegate used when build target options change. | ||
| FCookCanceledDelegate & | Returns the cook delegate which should be called if the cook is canceled Used by cook by the book in the editor | ||
| FIsCookFinishedDelegate & | Returns the cook delegate which can be used to query if the cook is finished. | ||
| FOnProfileProjectChanged & | Accesses delegate used when the project changes. | ||
| void | RemoveCookedCulture
(
const FString& CultureName |
Removes a cooked culture. | |
| void | RemoveCookedMap
(
const FString& MapName |
Removes a cooked map. | |
| void | RemoveCookedPlatform
(
const FString& PlatformName |
Removes a platform from the cook list. | |
| void | RemoveLaunchRole
(
const ILauncherProfileLaunchRoleRef& Role |
Removes the given launch role from the profile. | |
| bool | Whether the profile will require an explicit -target=XXX parameter | ||
| void | Save
(
TJsonWriter<>& Writer |
Saves the profile into a JSON file | |
| bool | Serializes the profile from or into the specified archive. | ||
| void | SetAdditionalCommandLineParameters
(
const FString& Params |
Sets the additional command line parameters for the application to use at launch. | |
| void | SetAddPatchLevel
(
bool InAddPatchLevel |
||
| void | SetArchive
(
bool bArchive |
Sets whether to archive build | |
| void | SetArchiveDirectory
(
const FString& Dir |
Sets the archive directory. | |
| void | SetBasedOnReleaseVersionName
(
const FString& InBasedOnReleaseVersion |
||
| void | SetBuildConfiguration
(
EBuildConfiguration Configuration |
Sets the build configuration. | |
| void | Sets the current build mode | ||
| void | SetBuildTarget
(
const FString& TargetName |
Sets the build target. | |
| void | SetBuildTargetSpecified
(
bool Specified |
Sets whether this profile specfies a build target. | |
| void | SetBuildUAT
(
bool Build |
Sets whether to build UAT. | |
| void | SetCompressed
(
bool Enable |
Sets Compression. | |
| void | SetCookConfiguration
(
EBuildConfiguration Configuration |
Sets the build configuration of the cooker. | |
| void | Sets the cook mode. | ||
| void | SetCookOptions
(
const FString& Options |
Sets the cook options. | |
| void | SetCreateDLC
(
bool InBuildDLC |
||
| void | SetCreateReleaseVersion
(
bool InCreateReleaseVersion |
||
| void | SetCreateReleaseVersionName
(
const FString& InCreateReleaseVersionName |
||
| void | SetDefaultDeployPlatform
(
const FName PlatformName |
Adds a platform to deploy (only used if a specific device is not specified). | |
| void | SetDefaults () |
Sets all profile settings to their defaults. | |
| void | SetDeployedDeviceGroup
(
const ILauncherDeviceGroupPtr& DeviceGroup |
Sets the device group to deploy to. | |
| void | Sets the deployment mode. | ||
| void | SetDeployWithUnrealPak
(
bool UseUnrealPak |
Sets whether to pack with UnrealPak. | |
| void | SetDescription
(
const FString& NewDescription |
Updates the description of the profile. | |
| void | SetDLCIncludeEngineContent
(
bool InDLCIncludeEngineContent |
||
| void | SetDLCName
(
const FString& InDLCName |
||
| void | SetEditorExe
(
const FString& EditorExe |
Sets the path to the editor executable to use in UAT. | |
| void | SetEncryptingIniFiles
(
bool Enabled |
Set encrypt ini files | |
| void | SetForceClose
(
bool Close |
Sets the cook on the fly close mode | |
| void | SetForDistribution
(
bool Enabled |
Set this build is for distribution to the public | |
| void | SetGenerateChunks
(
bool bGenerateChunks |
Set whether packaging will generate chunk data. | |
| void | SetGenerateHttpChunkData
(
bool bGenerateHttpChunkData |
Set whether packaging will use chunk data to generate http chunk install data. | |
| void | SetGeneratePatch
(
bool InShouldGeneratePatch |
Sets if we are going to generate a patch | |
| void | SetHideFileServerWindow
(
bool Hide |
Sets whether to hide the file server's console window. | |
| void | SetHttpChunkDataDirectory
(
const FString& InHttpChunkDataDirectory |
Set where generated http chunk install data will be stored. | |
| void | SetHttpChunkDataReleaseName
(
const FString& InHttpChunkDataReleaseName |
Set what name to tag the generated http chunk install data with. | |
| void | SetIncludePrerequisites
(
bool InValue |
Sets whether to include game prerequisites. | |
| void | SetIncrementalCooking
(
bool Incremental |
Sets incremental cooking. | |
| void | SetIncrementalDeploying
(
bool Incremental |
Sets incremental deploying. | |
| void | SetIterateSharedCookedBuild
(
bool IterateSharedCookedBuild |
||
| void | Sets the launch mode. | ||
| void | SetMakeBinaryConfig
(
bool bMakeBinaryConfig |
Sets whether to make a binary config file during packaging | |
| void | Updates the name of the profile. | ||
| void | Changes the save location to an internal project path. | ||
| void | SetOriginalReleaseVersionName
(
const FString& InOriginalReleaseVersion |
||
| void | SetPackageDirectory
(
const FString& Dir |
Sets the packaging directory. | |
| void | Sets the packaging mode. | ||
| void | SetProjectPath
(
const FString& Path |
Sets the path to the Unreal project to use. | |
| void | SetProjectSpecified
(
bool Specified |
Sets whether this profile specifies the a project. | |
| void | SetReferenceContainerCryptoKeysFileName
(
const FString& InReferenceContainerCryptoKeysFileName |
||
| void | SetReferenceContainerGlobalFileName
(
const FString& InReferenceContainerGlobalFileName |
||
| void | SetRetainStagedDirectory
(
bool bInRetainStagedDirectory |
||
| void | SetShouldUpdateDeviceFlash
(
bool bInShouldUpdateFlash |
Sets whether or not the flash image/software on the device should attempt to be updated before running | |
| void | SetSkipCookingEditorContent
(
const bool InSkipCookingEditorContent |
Skip editor content while cooking, This will strip editor content from final builds | |
| void | SetStageBaseReleasePaks
(
bool InStageBaseReleasePaks |
||
| void | SetStreamingFileServer
(
bool Streaming |
Sets whether to use a streaming file server. | |
| void | SetTimeout
(
uint32 InTime |
Sets the cook on the fly server timeout | |
| void | SetUnversionedCooking
(
bool Unversioned |
Sets unversioned cooking. | |
| void | SetUseIoStore
(
bool bUseIoStore |
Sets whether to use I/O store for optimized loading. | |
| void | SetUseZenStore
(
bool bUseZenStore |
Sets whether to use the Zen storage server | |
| bool | Are we going to generate a new patch tier | ||
| bool | ShouldBuild () |
Determines whether the current profile requires building | |
| bool | Should we stage the pak files from the base release version this patch is built on | ||
| bool | Whether or not the flash image/software on the device should attempt to be updated before running | ||
| bool | Checks whether the profile's selected project supports Engine maps. |