// Copyright Epic Games, Inc. All Rights Reserved. /*============================================================================= LinuxTargetPlatformControls.h: Declares the TLinuxTargetPlatformControls class. =============================================================================*/ #pragma once #include "CoreMinimal.h" #include "Interfaces/TargetDeviceId.h" #include "Common/TargetPlatformControlsBase.h" #include "SteamDeck/SteamDeckDevice.h" #include "AnalyticsEventAttribute.h" #include "InstalledPlatformInfo.h" #include "LinuxTargetDevice.h" #include "Linux/LinuxPlatformProperties.h" #if WITH_ENGINE #include "TextureResource.h" #endif // WITH_ENGINE #define LOCTEXT_NAMESPACE "TLinuxTargetPlatformControls" /** * Template for Linux target platforms controls */ template class TLinuxTargetPlatformControls : public TTargetPlatformControlsBase { public: typedef TTargetPlatformControlsBase TSuper; /** * Default constructor. */ TLinuxTargetPlatformControls(ITargetPlatformSettings* TargetPlatformSettings) : TSuper(TargetPlatformSettings) #if WITH_ENGINE , bChangingDeviceConfig(false) #endif // WITH_ENGINE { #if PLATFORM_LINUX if (!TProperties::IsArm64()) { // only add local device if actually running on Linux LocalDevice = MakeShareable(new FLinuxTargetDevice(*this, FPlatformProcess::ComputerName(), nullptr)); } #endif #if WITH_ENGINE InitDevicesFromConfig(); if (!TProperties::IsArm64()) { SteamDevices = TSteamDeckDevice::DiscoverDevices(*this, TEXT("Native Linux")); } #endif // WITH_ENGINE } public: //~ Begin ITargetPlatform Interface virtual void EnableDeviceCheck(bool OnOff) override {} virtual bool AddDevice(const FString& DeviceName, bool bDefault) override { return AddDevice(DeviceName, TEXT(""), TEXT(""), TEXT(""), bDefault); } virtual bool AddDevice(const FString& DeviceName, const FString& DeviceUserFriendlyName, const FString& Username, const FString& Password, bool bDefault) override { FLinuxTargetDevicePtr& Device = Devices.FindOrAdd(DeviceName); if (Device.IsValid()) { // do not allow duplicates return false; } Device = MakeShareable(new FLinuxTargetDevice(*this, DeviceName, #if WITH_ENGINE [&]() { SaveDevicesToConfig(); })); SaveDevicesToConfig(); // this will do the right thing even if AddDevice() was called from InitDevicesFromConfig #else nullptr)); #endif // WITH_ENGINE if (!Username.IsEmpty() || !Password.IsEmpty()) { Device->SetUserCredentials(Username, Password); } ITargetPlatformControls::OnDeviceDiscovered().Broadcast(Device.ToSharedRef()); return true; } virtual void GetAllDevices(TArray& OutDevices) const override { // TODO: ping all the machines in a local segment and/or try to connect to port 22 of those that respond OutDevices.Reset(); if (LocalDevice.IsValid()) { OutDevices.Add(LocalDevice); } for (const auto& DeviceIter : Devices) { OutDevices.Add(DeviceIter.Value); } for (const ITargetDevicePtr& SteamDeck : SteamDevices) { if (SteamDeck.IsValid()) { OutDevices.Add(SteamDeck); } } } virtual bool GenerateStreamingInstallManifest(const TMultiMap& PakchunkMap, const TSet& PakchunkIndicesInUse) const override { return true; } virtual ITargetDevicePtr GetDefaultDevice() const override { if (LocalDevice.IsValid()) { return LocalDevice; } return nullptr; } virtual ITargetDevicePtr GetDevice(const FTargetDeviceId& DeviceId) override { if (LocalDevice.IsValid() && (DeviceId == LocalDevice->GetId())) { return LocalDevice; } for (const auto& DeviceIter : Devices) { if (DeviceId == DeviceIter.Value->GetId()) { return DeviceIter.Value; } } for (const ITargetDevicePtr& SteamDeck : SteamDevices) { if (SteamDeck.IsValid() && DeviceId == SteamDeck->GetId()) { return SteamDeck; } } return nullptr; } virtual bool IsRunningPlatform() const override { // Must be Linux platform as editor for this to be considered a running platform return PLATFORM_LINUX && !UE_SERVER && !UE_GAME && WITH_EDITOR && TProperties::HasEditorOnlyData(); } virtual bool IsSdkInstalled(bool bProjectHasCode, FString& OutDocumentationPath) const override { if (!PLATFORM_LINUX) { // check for LINUX_MULTIARCH_ROOT or for legacy LINUX_ROOT when targeting Linux from Win/Mac // proceed with any value for MULTIARCH root, because checking exact architecture is not possible at this point FString ToolchainMultiarchRoot = FPlatformMisc::GetEnvironmentVariable(TEXT("LINUX_MULTIARCH_ROOT")); if (ToolchainMultiarchRoot.Len() > 0 && FPaths::DirectoryExists(ToolchainMultiarchRoot)) { return true; } // else check for legacy LINUX_ROOT FString ToolchainCompiler = FPlatformMisc::GetEnvironmentVariable(TEXT("LINUX_ROOT")); if (PLATFORM_WINDOWS) { ToolchainCompiler += "/bin/clang++.exe"; } else if (PLATFORM_MAC) { ToolchainCompiler += "/bin/clang++"; } else { checkf(false, TEXT("Unable to target Linux on an unknown platform.")); return false; } return FPaths::FileExists(ToolchainCompiler); } return true; } virtual int32 CheckRequirements(bool bProjectHasCode, EBuildConfiguration Configuration, bool bRequiresAssetNativization, FString& OutTutorialPath, FString& OutDocumentationPath, FText& CustomizedLogMessage) const override { int32 ReadyToBuild = TSuper::CheckRequirements(bProjectHasCode, Configuration, bRequiresAssetNativization, OutTutorialPath, OutDocumentationPath, CustomizedLogMessage); // do not support code/plugins in Installed builds if the required libs aren't bundled (on Windows/Mac) if (!PLATFORM_LINUX && !FInstalledPlatformInfo::Get().IsValidPlatform(TSuper::GetPlatformInfo().UBTPlatformString, EProjectType::Code)) { if (bProjectHasCode) { ReadyToBuild |= ETargetPlatformReadyStatus::CodeUnsupported; } FText Reason; if (this->RequiresTempTarget(bProjectHasCode, Configuration, bRequiresAssetNativization, Reason)) { ReadyToBuild |= ETargetPlatformReadyStatus::PluginsUnsupported; } } return ReadyToBuild; } virtual void GetPlatformSpecificProjectAnalytics(TArray& AnalyticsParamArray) const override { TSuper::GetPlatformSpecificProjectAnalytics(AnalyticsParamArray); TSuper::AppendAnalyticsEventConfigArray(AnalyticsParamArray, TEXT("/Script/LinuxTargetPlatform.LinuxTargetSettings"), TEXT("TargetedRHIs"), GEngineIni); } #if WITH_ENGINE virtual void GetTextureFormats(const UTexture* InTexture, TArray< TArray >& OutFormats) const override { if (this->AllowAudioVisualData()) { // just use the standard texture format name for this texture GetDefaultTextureFormatNamePerLayer(OutFormats.AddDefaulted_GetRef(), this->GetTargetPlatformSettings(), this, InTexture, true, 4, true); } } virtual void GetAllTextureFormats(TArray& OutFormats) const override { if (this->AllowAudioVisualData()) { // just use the standard texture format name for this texture GetAllDefaultTextureFormats(this->GetTargetPlatformSettings(), OutFormats); } } #endif //WITH_ENGINE virtual bool SupportsVariants() const override { return true; } virtual float GetVariantPriority() const override { return TProperties::GetVariantPriority(); } //~ End ITargetPlatform Interface protected: #if WITH_ENGINE /** Whether we're in process of changing device config - if yes, we will prevent recurrent calls. */ bool bChangingDeviceConfig; void InitDevicesFromConfig() { if (bChangingDeviceConfig) { return; } bChangingDeviceConfig = true; int NumDevices = 0; for (;; ++NumDevices) { FString DeviceName, DeviceUser, DevicePass; FString DeviceBaseKey(FString::Printf(TEXT("LinuxTargetPlatfrom_%s_Device_%d"), *TSuper::PlatformName(), NumDevices)); FString DeviceNameKey = DeviceBaseKey + TEXT("_Name"); if (!GConfig->GetString(TEXT("/Script/LinuxTargetPlatform.LinuxTargetSettings"), *DeviceNameKey, DeviceName, GEngineIni)) { // no such device break; } if (!AddDevice(DeviceName, false)) { break; } // set credentials, if any FString DeviceUserKey = DeviceBaseKey + TEXT("_User"); if (GConfig->GetString(TEXT("/Script/LinuxTargetPlatform.LinuxTargetSettings"), *DeviceUserKey, DeviceUser, GEngineIni)) { FString DevicePassKey = DeviceBaseKey + TEXT("_Pass"); if (GConfig->GetString(TEXT("/Script/LinuxTargetPlatform.LinuxTargetSettings"), *DevicePassKey, DevicePass, GEngineIni)) { for (const auto& DeviceIter : Devices) { ITargetDevicePtr Device = DeviceIter.Value; if (Device.IsValid() && Device->GetId().GetDeviceName() == DeviceName) { Device->SetUserCredentials(DeviceUser, DevicePass); } } } } } bChangingDeviceConfig = false; } void SaveDevicesToConfig() { if (bChangingDeviceConfig) { return; } bChangingDeviceConfig = true; int DeviceIndex = 0; for (const auto& DeviceIter : Devices) { ITargetDevicePtr Device = DeviceIter.Value; FString DeviceBaseKey(FString::Printf(TEXT("LinuxTargetPlatfrom_%s_Device_%d"), *TSuper::PlatformName(), DeviceIndex)); FString DeviceNameKey = DeviceBaseKey + TEXT("_Name"); if (Device.IsValid()) { FString DeviceName = Device->GetId().GetDeviceName(); // do not save a local device on Linux or it will be duplicated if (PLATFORM_LINUX && DeviceName == FPlatformProcess::ComputerName()) { continue; } GConfig->SetString(TEXT("/Script/LinuxTargetPlatform.LinuxTargetSettings"), *DeviceNameKey, *DeviceName, GEngineIni); FString DeviceUser, DevicePass; if (Device->GetUserCredentials(DeviceUser, DevicePass)) { FString DeviceUserKey = DeviceBaseKey + TEXT("_User"); FString DevicePassKey = DeviceBaseKey + TEXT("_Pass"); GConfig->SetString(TEXT("/Script/LinuxTargetPlatform.LinuxTargetSettings"), *DeviceUserKey, *DeviceUser, GEngineIni); GConfig->SetString(TEXT("/Script/LinuxTargetPlatform.LinuxTargetSettings"), *DevicePassKey, *DevicePass, GEngineIni); } ++DeviceIndex; // needs to be incremented here since we cannot allow gaps } } bChangingDeviceConfig = false; } #endif // WITH_ENGINE // Holds the local device. FLinuxTargetDevicePtr LocalDevice; // Holds a map of valid devices. TMap Devices; TArray SteamDevices; }; #undef LOCTEXT_NAMESPACE