Unreal Engine 4：编译打包Windows应用遇到的问题汇总

小鱼儿 2022-05-14 03:04 537阅读 0赞

本文目的是将在Unreal Engine 4开发中遇到的一些问题及解决方案记录下来，方便以后查找。

版本：4.18

**问题一：**

在编译如下代码时：

UWidgetComponent* WidgetComponent = Cast<UWidgetComponent>(this->GetComponentByClass(UWidgetComponent::StaticClass()));

报如下错误：

error LNK2019: unresolved external symbol 
    "__declspec(dllimport) private: static class UClass * __cdecl UWidgetComponent::GetPrivateStaticClass(void)"
     (__imp_?GetPrivateStaticClass@UWidgetComponent@@CAPEAVUClass@@XZ) 
    referenced in function "protected: virtual void __cdecl ATankModel::BeginPlay(void)" (?BeginPlay@ATankModel@@MEAAXXZ)

从错误信息中看，好像是UWidgetComponent::GetPrivateStaticClass(void)方法未找到。但实际上UWidgetComponent中并不存在此方法。而此问题实际上是由于UWidgetComponent所在的模块UMG，没有加入到需要编译的模块中造成的。修改方式为在工程的.Build.cs文件的编译选项中添加此模块：

using UnrealBuildTool;
    
    public class ClientProj : ModuleRules
    {
    	public ClientProj(ReadOnlyTargetRules Target) : base(Target)
    	{
    		PCHUsage = PCHUsageMode.UseExplicitOrSharedPCHs;
    
    		PublicDependencyModuleNames.AddRange(
    		    new string[] { "Core", "CoreUObject", "Engine", "InputCore", "UMG" });
        }
    }

**问题二：**

在编译如下代码时：

template<typename T>
    ValueBoxImpl<T>& getValueBox(std::shared_ptr<ValueBox> valueBox_ptr) {
    	return dynamic_cast<ValueBoxImpl<T>&>(*valueBox_ptr);
    };

报如下错误：

C:\Epic Games\UE_4.18\Engine\Source\Runtime\CoreUObject\Public\Templates/Casts.h(413): 
    error C4541: 'dynamic_cast' used on polymorphic type 'tanx::ValueBox' with /GR-; 
    unpredictable behavior may result

错误原因是RTTI未启用，需要在.Build.cs文件中启用RTTI功能：

using UnrealBuildTool;
    
    public class ClientProj : ModuleRules
    {
    	public ClientProj(ReadOnlyTargetRules Target) : base(Target)
    	{
    		PCHUsage = PCHUsageMode.UseExplicitOrSharedPCHs;
    
    		bUseRTTI = true;
    
    		PublicDependencyModuleNames.AddRange(
    		    new string[] { "Core", "CoreUObject", "Engine", "InputCore", "UMG" });
        }
    }

**问题三：**

在编译如下代码时：

class GameHome {
    private:
    	AClientProjGameModeBase& gameMode;
    }

报如下错误：

game_home.h(16): error C2143: syntax error: missing ';' before '&'
    game_home.h(16): error C4430: missing type specifier - int assumed. Note: C++ does not support default-int
    game_home.h(16): error C2238: unexpected token(s) preceding ';'

错误原因在于没有在ATanxClientProjGameModeBase前加上class，修改后编译通过：

class GameHome {
    private:
    	class AClientProjGameModeBase& gameMode;
    }

从这个例子可以看到，从unreal提供的类作为父类衍生出的类，在使用时最好都加上class来修饰。

**问题四：**

编译打包时报如下错误：

error C4577: 'noexcept' used with no exception handling mode specified; termination on exception is not guaranteed. Specify /EHsc

原因在于C++中使用了exception处理的机制。修改方法是在.Build.cs文件中打开相关的编译选项“bEnableExceptions”：

using UnrealBuildTool;
    
    public class ClientProj : ModuleRules
    {
    	public ClientProj(ReadOnlyTargetRules Target) : base(Target)
    	{
    		PCHUsage = PCHUsageMode.UseExplicitOrSharedPCHs;
    
    		bUseRTTI = true;
    
    		bEnableExceptions = true;
    
    		PublicDependencyModuleNames.AddRange(
    		    new string[] { "Core", "CoreUObject", "Engine", "InputCore", "UMG" });
        }
    }

**问题五：**

在新开的线程中调用SpawnActor，应用会崩溃或什么结果也没有。

SpawnActor必须在game thread中被调用，如果不在game thread中被调用，可能会导致系统自动退出。可以通过check(IsInGameThread())；来检测当前线程是否是game thread。

**问题六：**

在Plugins中设置了

> bUseRTTI = true;  
> bEnableExceptions = true;

结果打包Windows应用时，报如下警告和错误：

> warning C4652: compiler option 'C++ Exception Handling Unwinding' inconsistent with precompiled header; current command-line option will override that defined in the precompiled header  
> warning C4651: '/D\_HAS\_EXCEPTIONS=0' specified for precompiled header but not for current compile  
> error LNK2019: unresolved external symbol "\_\_declspec(dllimport) public: \_\_cdecl std::bad\_cast::bad\_cast(char const \*)"

造成此问题的原因是  
UE\_4.18\\Engine\\Intermediate\\Build\\Win64\\UE4\\Development\\Engine\\SharedPCH.Engine.RTTI.h  
在编译成  
UE\_4.18\\Engine\\Intermediate\\Build\\Win64\\UE4\\Development\\Engine\\SharedPCH.Engine.RTTI.h.pch  
的过程中没有设置bEnableExceptions = true;

需要修改UE\_4.18\\Engine\\Source\\Programs\\UnrealBuildTool\\Configuration\\UEBuildModuleCPP.cs

// 修改前
    public PrecompiledHeaderInstance FindOrCreateSharedPCH(UEToolChain ToolChain, PrecompiledHeaderTemplate Template, bool bOptimizeCode, bool bUseRTTI, ActionGraph ActionGraph)
    
    // 修改后
    public PrecompiledHeaderInstance FindOrCreateSharedPCH(UEToolChain ToolChain, PrecompiledHeaderTemplate Template, bool bOptimizeCode, bool bUseRTTI, bool bEnableExceptions, ActionGraph ActionGraph)

并在此函数中添加

CompileEnvironment.bEnableExceptions = bEnableExceptions;

将

// 修改前
    PrecompiledHeaderInstance Instance = FindOrCreateSharedPCH(ToolChain, Template, ModuleCompileEnvironment.bOptimizeCode, ModuleCompileEnvironment.bUseRTTI, ActionGraph); 
    
    
    // 修改后
    PrecompiledHeaderInstance Instance = FindOrCreateSharedPCH(ToolChain, Template, ModuleCompileEnvironment.bOptimizeCode, ModuleCompileEnvironment.bUseRTTI, ModuleCompileEnvironment.bEnableExceptions, ActionGraph);

再编译打包Windows应用时就不会报错了。