Files
UnrealEngineUWP/Engine/Source/Runtime/Projects/Private/ModuleDescriptor.cpp
Marc Audy 68150e0be7 Merge UE5/Release-Engine-Staging to UE5/Main @ 14611496
This represents UE4/Main @ 14594913

[CL 14612291 by Marc Audy in ue5-main branch]
2020-10-29 13:38:15 -04:00

672 lines
20 KiB
C++

// Copyright Epic Games, Inc. All Rights Reserved.
#include "ModuleDescriptor.h"
#include "Misc/App.h"
#include "Misc/ScopedSlowTask.h"
#include "Dom/JsonObject.h"
#include "Serialization/JsonSerializer.h"
#include "JsonUtils/JsonObjectArrayUpdater.h"
#include "Modules/ModuleManager.h"
#define LOCTEXT_NAMESPACE "ModuleDescriptor"
namespace ModuleDescriptor
{
FString GetModuleKey(const FModuleDescriptor& Module)
{
return Module.Name.ToString();
}
bool TryGetModuleJsonObjectKey(const FJsonObject& JsonObject, FString& OutKey)
{
return JsonObject.TryGetStringField(TEXT("Name"), OutKey);
}
void UpdateModuleJsonObject(const FModuleDescriptor& Module, FJsonObject& JsonObject)
{
Module.UpdateJson(JsonObject);
}
}
ELoadingPhase::Type ELoadingPhase::FromString( const TCHAR *String )
{
ELoadingPhase::Type TestType = (ELoadingPhase::Type)0;
for(; TestType < ELoadingPhase::Max; TestType = (ELoadingPhase::Type)(TestType + 1))
{
const TCHAR *TestString = ToString(TestType);
if(FCString::Stricmp(String, TestString) == 0)
{
break;
}
}
return TestType;
}
const TCHAR* ELoadingPhase::ToString( const ELoadingPhase::Type Value )
{
switch( Value )
{
case Default:
return TEXT( "Default" );
case PostDefault:
return TEXT( "PostDefault" );
case PreDefault:
return TEXT( "PreDefault" );
case PostConfigInit:
return TEXT( "PostConfigInit" );
case PostSplashScreen:
return TEXT("PostSplashScreen");
case PreEarlyLoadingScreen:
return TEXT("PreEarlyLoadingScreen");
case PreLoadingScreen:
return TEXT( "PreLoadingScreen" );
case PostEngineInit:
return TEXT( "PostEngineInit" );
case EarliestPossible:
return TEXT("EarliestPossible");
case None:
return TEXT( "None" );
default:
ensureMsgf( false, TEXT( "Unrecognized ELoadingPhase value: %i" ), Value );
return NULL;
}
}
EHostType::Type EHostType::FromString( const TCHAR *String )
{
EHostType::Type TestType = (EHostType::Type)0;
for(; TestType < EHostType::Max; TestType = (EHostType::Type)(TestType + 1))
{
const TCHAR *TestString = ToString(TestType);
if(FCString::Stricmp(String, TestString) == 0)
{
break;
}
}
return TestType;
}
const TCHAR* EHostType::ToString( const EHostType::Type Value )
{
switch( Value )
{
case Runtime:
return TEXT( "Runtime" );
case RuntimeNoCommandlet:
return TEXT( "RuntimeNoCommandlet" );
case RuntimeAndProgram:
return TEXT( "RuntimeAndProgram" );
case CookedOnly:
return TEXT( "CookedOnly" );
case UncookedOnly:
return TEXT( "UncookedOnly" );
case Developer:
return TEXT( "Developer" );
case DeveloperTool:
return TEXT( "DeveloperTool" );
case Editor:
return TEXT( "Editor" );
case EditorNoCommandlet:
return TEXT( "EditorNoCommandlet" );
case EditorAndProgram:
return TEXT( "EditorAndProgram" );
case Program:
return TEXT("Program");
case ServerOnly:
return TEXT("ServerOnly");
case ClientOnly:
return TEXT("ClientOnly");
case ClientOnlyNoCommandlet:
return TEXT("ClientOnlyNoCommandlet");
default:
ensureMsgf( false, TEXT( "Unrecognized EModuleType value: %i" ), Value );
return NULL;
}
}
FModuleDescriptor::FModuleDescriptor(const FName InName, EHostType::Type InType, ELoadingPhase::Type InLoadingPhase)
: Name(InName)
, Type(InType)
, LoadingPhase(InLoadingPhase)
{
}
bool FModuleDescriptor::Read(const FJsonObject& Object, FText& OutFailReason)
{
// Read the module name
TSharedPtr<FJsonValue> NameValue = Object.TryGetField(TEXT("Name"));
if(!NameValue.IsValid() || NameValue->Type != EJson::String)
{
OutFailReason = LOCTEXT("ModuleWithoutAName", "Found a 'Module' entry with a missing 'Name' field");
return false;
}
Name = FName(*NameValue->AsString());
// Read the module type
TSharedPtr<FJsonValue> TypeValue = Object.TryGetField(TEXT("Type"));
if(!TypeValue.IsValid() || TypeValue->Type != EJson::String)
{
OutFailReason = FText::Format( LOCTEXT( "ModuleWithoutAType", "Found Module entry '{0}' with a missing 'Type' field" ), FText::FromName(Name) );
return false;
}
Type = EHostType::FromString(*TypeValue->AsString());
if(Type == EHostType::Max)
{
OutFailReason = FText::Format( LOCTEXT( "ModuleWithInvalidType", "Module entry '{0}' specified an unrecognized module Type '{1}'" ), FText::FromName(Name), FText::FromString(TypeValue->AsString()) );
return false;
}
// Read the loading phase
TSharedPtr<FJsonValue> LoadingPhaseValue = Object.TryGetField(TEXT("LoadingPhase"));
if(LoadingPhaseValue.IsValid() && LoadingPhaseValue->Type == EJson::String)
{
LoadingPhase = ELoadingPhase::FromString(*LoadingPhaseValue->AsString());
if(LoadingPhase == ELoadingPhase::Max)
{
OutFailReason = FText::Format( LOCTEXT( "ModuleWithInvalidLoadingPhase", "Module entry '{0}' specified an unrecognized module LoadingPhase '{1}'" ), FText::FromName(Name), FText::FromString(LoadingPhaseValue->AsString()) );
return false;
}
}
// Read the whitelisted and blacklisted platforms
Object.TryGetStringArrayField(TEXT("WhitelistPlatforms"), WhitelistPlatforms);
Object.TryGetStringArrayField(TEXT("BlacklistPlatforms"), BlacklistPlatforms);
// Read the whitelisted and blacklisted targets
Object.TryGetEnumArrayField(TEXT("WhitelistTargets"), WhitelistTargets);
Object.TryGetEnumArrayField(TEXT("BlacklistTargets"), BlacklistTargets);
// Read the whitelisted and blacklisted target configurations
Object.TryGetEnumArrayField(TEXT("WhitelistTargetConfigurations"), WhitelistTargetConfigurations);
Object.TryGetEnumArrayField(TEXT("BlacklistTargetConfigurations"), BlacklistTargetConfigurations);
// Read the whitelisted and blacklisted programs
Object.TryGetStringArrayField(TEXT("WhitelistPrograms"), WhitelistPrograms);
Object.TryGetStringArrayField(TEXT("BlacklistPrograms"), BlacklistPrograms);
// Read the additional dependencies
Object.TryGetStringArrayField(TEXT("AdditionalDependencies"), AdditionalDependencies);
return true;
}
bool FModuleDescriptor::ReadArray(const FJsonObject& Object, const TCHAR* Name, TArray<FModuleDescriptor>& OutModules, FText& OutFailReason)
{
bool bResult = true;
TSharedPtr<FJsonValue> ModulesArrayValue = Object.TryGetField(Name);
if(ModulesArrayValue.IsValid() && ModulesArrayValue->Type == EJson::Array)
{
const TArray< TSharedPtr< FJsonValue > >& ModulesArray = ModulesArrayValue->AsArray();
for(int Idx = 0; Idx < ModulesArray.Num(); Idx++)
{
const TSharedPtr<FJsonValue>& ModuleValue = ModulesArray[Idx];
if(ModuleValue.IsValid() && ModuleValue->Type == EJson::Object)
{
FModuleDescriptor Descriptor;
if(Descriptor.Read(*ModuleValue->AsObject().Get(), OutFailReason))
{
OutModules.Add(Descriptor);
}
else
{
bResult = false;
}
}
else
{
OutFailReason = LOCTEXT( "ModuleWithInvalidModulesArray", "The 'Modules' array has invalid contents and was not able to be loaded." );
bResult = false;
}
}
}
return bResult;
}
void FModuleDescriptor::Write(TJsonWriter<>& Writer) const
{
TSharedRef<FJsonObject> ModuleJsonObject = MakeShared<FJsonObject>();
UpdateJson(*ModuleJsonObject);
FJsonSerializer::Serialize(ModuleJsonObject, Writer);
}
void FModuleDescriptor::UpdateJson(FJsonObject& JsonObject) const
{
JsonObject.SetStringField(TEXT("Name"), Name.ToString());
JsonObject.SetStringField(TEXT("Type"), FString(EHostType::ToString(Type)));
JsonObject.SetStringField(TEXT("LoadingPhase"), FString(ELoadingPhase::ToString(LoadingPhase)));
if (WhitelistPlatforms.Num() > 0)
{
TArray<TSharedPtr<FJsonValue>> WhitelistPlatformValues;
for (const FString& WhitelistPlatform : WhitelistPlatforms)
{
WhitelistPlatformValues.Add(MakeShareable(new FJsonValueString(WhitelistPlatform)));
}
JsonObject.SetArrayField(TEXT("WhitelistPlatforms"), WhitelistPlatformValues);
}
else
{
JsonObject.RemoveField(TEXT("WhitelistPlatforms"));
}
if (BlacklistPlatforms.Num() > 0)
{
TArray<TSharedPtr<FJsonValue>> BlacklistPlatformValues;
for (const FString& BlacklistPlatform : BlacklistPlatforms)
{
BlacklistPlatformValues.Add(MakeShareable(new FJsonValueString(BlacklistPlatform)));
}
JsonObject.SetArrayField(TEXT("BlacklistPlatforms"), BlacklistPlatformValues);
}
else
{
JsonObject.RemoveField(TEXT("BlacklistPlatforms"));
}
if (WhitelistTargets.Num() > 0)
{
TArray<TSharedPtr<FJsonValue>> WhitelistTargetValues;
for (EBuildTargetType WhitelistTarget : WhitelistTargets)
{
WhitelistTargetValues.Add(MakeShareable(new FJsonValueString(LexToString(WhitelistTarget))));
}
JsonObject.SetArrayField(TEXT("WhitelistTargets"), WhitelistTargetValues);
}
else
{
JsonObject.RemoveField(TEXT("WhitelistTargets"));
}
if (BlacklistTargets.Num() > 0)
{
TArray<TSharedPtr<FJsonValue>> BlacklistTargetValues;
for (EBuildTargetType BlacklistTarget : BlacklistTargets)
{
BlacklistTargetValues.Add(MakeShareable(new FJsonValueString(LexToString(BlacklistTarget))));
}
JsonObject.SetArrayField(TEXT("BlacklistTargets"), BlacklistTargetValues);
}
else
{
JsonObject.RemoveField(TEXT("BlacklistTargets"));
}
if (WhitelistTargetConfigurations.Num() > 0)
{
TArray<TSharedPtr<FJsonValue>> WhitelistTargetConfigurationValues;
for (EBuildConfiguration WhitelistTargetConfiguration : WhitelistTargetConfigurations)
{
WhitelistTargetConfigurationValues.Add(MakeShareable(new FJsonValueString(LexToString(WhitelistTargetConfiguration))));
}
JsonObject.SetArrayField(TEXT("WhitelistTargetConfigurations"), WhitelistTargetConfigurationValues);
}
else
{
JsonObject.RemoveField(TEXT("WhitelistTargetConfigurations"));
}
if (BlacklistTargetConfigurations.Num() > 0)
{
TArray<TSharedPtr<FJsonValue>> BlacklistTargetConfigurationValues;
for (EBuildConfiguration BlacklistTargetConfiguration : BlacklistTargetConfigurations)
{
BlacklistTargetConfigurationValues.Add(MakeShareable(new FJsonValueString(LexToString(BlacklistTargetConfiguration))));
}
JsonObject.SetArrayField(TEXT("BlacklistTargetConfigurations"), BlacklistTargetConfigurationValues);
}
else
{
JsonObject.RemoveField(TEXT("BlacklistTargetConfigurations"));
}
if (WhitelistPrograms.Num() > 0)
{
TArray<TSharedPtr<FJsonValue>> WhitelistProgramValues;
for (const FString& WhitelistProgram : WhitelistPrograms)
{
WhitelistProgramValues.Add(MakeShareable(new FJsonValueString(WhitelistProgram)));
}
JsonObject.SetArrayField(TEXT("WhitelistPrograms"), WhitelistProgramValues);
}
else
{
JsonObject.RemoveField(TEXT("WhitelistPrograms"));
}
if (BlacklistPrograms.Num() > 0)
{
TArray<TSharedPtr<FJsonValue>> BlacklistProgramValues;
for (const FString& BlacklistProgram : BlacklistPrograms)
{
BlacklistProgramValues.Add(MakeShareable(new FJsonValueString(BlacklistProgram)));
}
JsonObject.SetArrayField(TEXT("BlacklistPrograms"), BlacklistProgramValues);
}
else
{
JsonObject.RemoveField(TEXT("BlacklistPrograms"));
}
if (AdditionalDependencies.Num() > 0)
{
TArray<TSharedPtr<FJsonValue>> AdditionalDependencyValues;
for (const FString& AdditionalDependency : AdditionalDependencies)
{
AdditionalDependencyValues.Add(MakeShareable(new FJsonValueString(AdditionalDependency)));
}
JsonObject.SetArrayField(TEXT("AdditionalDependencies"), AdditionalDependencyValues);
}
else
{
JsonObject.RemoveField(TEXT("AdditionalDependencies"));
}
}
void FModuleDescriptor::WriteArray(TJsonWriter<>& Writer, const TCHAR* ArrayName, const TArray<FModuleDescriptor>& Modules)
{
if (Modules.Num() > 0)
{
Writer.WriteArrayStart(ArrayName);
for(const FModuleDescriptor& Module : Modules)
{
Module.Write(Writer);
}
Writer.WriteArrayEnd();
}
}
void FModuleDescriptor::UpdateArray(FJsonObject& JsonObject, const TCHAR* ArrayName, const TArray<FModuleDescriptor>& Modules)
{
typedef FJsonObjectArrayUpdater<FModuleDescriptor, FString> FModuleJsonArrayUpdater;
FModuleJsonArrayUpdater::Execute(
JsonObject, ArrayName, Modules,
FModuleJsonArrayUpdater::FGetElementKey::CreateStatic(ModuleDescriptor::GetModuleKey),
FModuleJsonArrayUpdater::FTryGetJsonObjectKey::CreateStatic(ModuleDescriptor::TryGetModuleJsonObjectKey),
FModuleJsonArrayUpdater::FUpdateJsonObject::CreateStatic(ModuleDescriptor::UpdateModuleJsonObject));
}
bool FModuleDescriptor::IsCompiledInConfiguration(const FString& Platform, EBuildConfiguration Configuration, const FString& TargetName, EBuildTargetType TargetType, bool bBuildDeveloperTools, bool bBuildRequiresCookedData) const
{
// Check the platform is whitelisted
if (WhitelistPlatforms.Num() > 0 && !WhitelistPlatforms.Contains(Platform))
{
return false;
}
// Check the platform is not blacklisted
if (BlacklistPlatforms.Contains(Platform))
{
return false;
}
// Check the target is whitelisted
if (WhitelistTargets.Num() > 0 && !WhitelistTargets.Contains(TargetType))
{
return false;
}
// Check the target is not blacklisted
if (BlacklistTargets.Contains(TargetType))
{
return false;
}
// Check the target configuration is whitelisted
if (WhitelistTargetConfigurations.Num() > 0 && !WhitelistTargetConfigurations.Contains(Configuration))
{
return false;
}
// Check the target configuration is not blacklisted
if (BlacklistTargetConfigurations.Contains(Configuration))
{
return false;
}
// Special checks just for programs
if(TargetType == EBuildTargetType::Program)
{
// Check the program name is whitelisted. Note that this behavior is slightly different to other whitelist/blacklist checks; we will whitelist a module of any type if it's explicitly allowed for this program.
if(WhitelistPrograms.Num() > 0)
{
return WhitelistPrograms.Contains(TargetName);
}
// Check the program name is not blacklisted
if(BlacklistPrograms.Contains(TargetName))
{
return false;
}
}
// Check the module is compatible with this target.
switch (Type)
{
case EHostType::Runtime:
case EHostType::RuntimeNoCommandlet:
return TargetType != EBuildTargetType::Program;
case EHostType::RuntimeAndProgram:
return true;
case EHostType::CookedOnly:
return bBuildRequiresCookedData;
case EHostType::UncookedOnly:
return !bBuildRequiresCookedData;
case EHostType::Developer:
return TargetType == EBuildTargetType::Editor || TargetType == EBuildTargetType::Program;
case EHostType::DeveloperTool:
return bBuildDeveloperTools;
case EHostType::Editor:
case EHostType::EditorNoCommandlet:
return TargetType == EBuildTargetType::Editor;
case EHostType::EditorAndProgram:
return TargetType == EBuildTargetType::Editor || TargetType == EBuildTargetType::Program;
case EHostType::Program:
return TargetType == EBuildTargetType::Program;
case EHostType::ServerOnly:
return TargetType != EBuildTargetType::Program && TargetType != EBuildTargetType::Client;
case EHostType::ClientOnly:
case EHostType::ClientOnlyNoCommandlet:
return TargetType != EBuildTargetType::Program && TargetType != EBuildTargetType::Server;
}
return false;
}
bool FModuleDescriptor::IsCompiledInCurrentConfiguration() const
{
return IsCompiledInConfiguration(FPlatformMisc::GetUBTPlatform(), FApp::GetBuildConfiguration(), UE_APP_NAME, FApp::GetBuildTargetType(), !!WITH_UNREAL_DEVELOPER_TOOLS, FPlatformProperties::RequiresCookedData());
}
bool FModuleDescriptor::IsLoadedInCurrentConfiguration() const
{
// Check that the module is built for this configuration
if(!IsCompiledInCurrentConfiguration())
{
return false;
}
// Always respect the whitelist/blacklist for program targets
EBuildTargetType TargetType = FApp::GetBuildTargetType();
if(TargetType == EBuildTargetType::Program)
{
const FString TargetName = UE_APP_NAME;
// Check the program name is whitelisted. Note that this behavior is slightly different to other whitelist/blacklist checks; we will whitelist a module of any type if it's explicitly allowed for this program.
if(WhitelistPrograms.Num() > 0)
{
return WhitelistPrograms.Contains(TargetName);
}
// Check the program name is not blacklisted
if(BlacklistPrograms.Contains(TargetName))
{
return false;
}
}
// Check that the runtime environment allows it to be loaded
switch (Type)
{
case EHostType::RuntimeAndProgram:
#if (WITH_ENGINE || WITH_PLUGIN_SUPPORT)
return true;
#endif
break;
case EHostType::Runtime:
#if (WITH_ENGINE || WITH_PLUGIN_SUPPORT) && !IS_PROGRAM
return true;
#endif
break;
case EHostType::RuntimeNoCommandlet:
#if (WITH_ENGINE || WITH_PLUGIN_SUPPORT) && !IS_PROGRAM
if(!IsRunningCommandlet()) return true;
#endif
break;
case EHostType::CookedOnly:
return FPlatformProperties::RequiresCookedData();
case EHostType::UncookedOnly:
return !FPlatformProperties::RequiresCookedData();
case EHostType::Developer:
#if WITH_EDITOR || IS_PROGRAM
return true;
#else
return false;
#endif
case EHostType::DeveloperTool:
#if WITH_UNREAL_DEVELOPER_TOOLS
return true;
#else
return false;
#endif
case EHostType::Editor:
#if WITH_EDITOR
// GIsEditor is not set until the PostSplashScreen phase
ensure(LoadingPhase != ELoadingPhase::PostConfigInit && LoadingPhase != ELoadingPhase::EarliestPossible);
if(GIsEditor) return true;
#endif
break;
case EHostType::EditorNoCommandlet:
#if WITH_EDITOR
// GIsEditor is not set until the PostSplashScreen phase
ensure(LoadingPhase != ELoadingPhase::PostConfigInit && LoadingPhase != ELoadingPhase::EarliestPossible);
if(GIsEditor && !IsRunningCommandlet()) return true;
#endif
break;
case EHostType::EditorAndProgram:
#if WITH_EDITOR
// GIsEditor is not set until the PostSplashScreen phase
ensure(LoadingPhase != ELoadingPhase::PostConfigInit && LoadingPhase != ELoadingPhase::EarliestPossible);
return GIsEditor;
#elif IS_PROGRAM
return true;
#else
return false;
#endif
case EHostType::Program:
#if WITH_PLUGIN_SUPPORT && IS_PROGRAM
return true;
#endif
break;
case EHostType::ServerOnly:
return !FPlatformProperties::IsClientOnly();
case EHostType::ClientOnlyNoCommandlet:
#if (WITH_ENGINE || WITH_PLUGIN_SUPPORT) && !IS_PROGRAM
return (!IsRunningDedicatedServer()) && (!IsRunningCommandlet());
#endif
// the fall in the case of not having defines listed above is intentional
case EHostType::ClientOnly:
return !IsRunningDedicatedServer();
}
return false;
}
void FModuleDescriptor::LoadModulesForPhase(ELoadingPhase::Type LoadingPhase, const TArray<FModuleDescriptor>& Modules, TMap<FName, EModuleLoadResult>& ModuleLoadErrors)
{
FScopedSlowTask SlowTask(Modules.Num());
for (int Idx = 0; Idx < Modules.Num(); Idx++)
{
SlowTask.EnterProgressFrame(1);
const FModuleDescriptor& Descriptor = Modules[Idx];
// Don't need to do anything if this module is already loaded
if (!FModuleManager::Get().IsModuleLoaded(Descriptor.Name))
{
if (LoadingPhase == Descriptor.LoadingPhase && Descriptor.IsLoadedInCurrentConfiguration())
{
// @todo plugin: DLL search problems. Plugins that statically depend on other modules within this plugin may not be found? Need to test this.
// NOTE: Loading this module may cause other modules to become loaded, both in the engine or game, or other modules
// that are part of this project or plugin. That's totally fine.
EModuleLoadResult FailureReason;
IModuleInterface* ModuleInterface = FModuleManager::Get().LoadModuleWithFailureReason(Descriptor.Name, FailureReason);
if (ModuleInterface == nullptr)
{
// The module failed to load. Note this in the ModuleLoadErrors list.
ModuleLoadErrors.Add(Descriptor.Name, FailureReason);
}
}
}
}
}
#if !IS_MONOLITHIC
bool FModuleDescriptor::CheckModuleCompatibility(const TArray<FModuleDescriptor>& Modules, TArray<FString>& OutIncompatibleFiles)
{
FModuleManager& ModuleManager = FModuleManager::Get();
bool bResult = true;
for (const FModuleDescriptor& Module : Modules)
{
if (Module.IsCompiledInCurrentConfiguration() && !ModuleManager.IsModuleUpToDate(Module.Name))
{
OutIncompatibleFiles.Add(Module.Name.ToString());
bResult = false;
}
}
return bResult;
}
#endif
#undef LOCTEXT_NAMESPACE