【UE4源代码观察】在空白工程中测试跨模块调用函数

2024-09-06 23:58

本文主要是介绍【UE4源代码观察】在空白工程中测试跨模块调用函数,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

目的

在之前的博客【UE4源代码观察】手动建立一个使用UBT进行编译的空白工程中,成功让UBT工作起来了。现在我想要测试编译出的多个模块之间是否能互相调用,我记录下测试的过程。最终工程见 工程GIT链接。

实践

第一部分

首先仿照TestA模块建立TestB模块。
在TestB.h文件中声明了一个函数

int TestBFunc(int x, int y);

并在TestB.cpp中写他的实现

#include"TestB.h"
int TestBFunc(int x, int y)
{return x + y;
}

然后在启动模块TestA的入口函数中尝试调用这个函数:

#include"../TestB/TestB.h"
#include<iostream>
int main()
{std::cout << TestBFunc(3, 2) << std::endl;return 0;
}

为了证明能成功调用,我还include了< iostream >然后用std::cout输出了结果。
启动“生成”,但是失败了:

1>TestA.cpp.obj : error LNK2019: 无法解析的外部符号 "int __cdecl TestBFunc(int,int)" (?TestBFunc@@YAHHH@Z),该符号在函数 main 中被引用

看来并没有找到这个函数的实现。于是我在TestA.Build.cs中增加了TestB的依赖:

 PrivateDependencyModuleNames.Add("TestB");

错误变成了:

1>LINK : error LNK2001: 无法解析的外部符号 IMPLEMENT_MODULE_TestB
1>D:\0_WorkSpace\UEYaksueTest\Engine\Binaries\Win64\Test1.exe : fatal error LNK1120: 1 个无法解析的外部命令

未找到的 IMPLEMENT_MODULE_TestB应该是由IMPLEMENT_MODULE这个宏定义的,见ModuleManager.h:

#define IMPLEMENT_MODULE( ModuleImplClass, ModuleName ) \\/**/ \/* InitializeModule function, called by module manager after this module's DLL has been loaded */ \/**/ \/* @return	Returns an instance of this module */ \/**/ \extern "C" DLLEXPORT IModuleInterface* InitializeModule() \{ \return new ModuleImplClass(); \} \/* Forced reference to this function is added by the linker to check that each module uses IMPLEMENT_MODULE */ \extern "C" void IMPLEMENT_MODULE_##ModuleName() { } \PER_MODULE_BOILERPLATE \PER_MODULE_BOILERPLATE_ANYLINK(ModuleImplClass, ModuleName)

不过,模块也不一定必须要用IMPLEMENT_MODULE宏,模块中有个属性 bRequiresImplementModule,在官方文档的说明是:
bRequiresImplementModule (Nullable)
此模块的实现是否需要IMPLEMENT_MODULE宏。大多数UE4模块都有此需要,因为我们使用IMPLEMENT_MODULE宏来执行其他全局重载(例如运算符新建/删除向GMalloc的传递)。

如果在TestB.build.cs中加:

 bRequiresImplementModule = false;

就可以编译成功,程序也运行正常。

第二部分

我又建立了一个TestC模块,想要尝试使用IMPLEMENT_MODULE( ModuleImplClass, ModuleName )这个宏。

这个宏的括号内两个符号,第二个是这个模块的名字,填“TestC”就好,而第一个是模块的实现类,需要继承自 IModuleInterface,为此我需要IModuleInterface的定义。
IModuleInterface的定义在ModuleInterface.h中,我将他拷贝到了自己的工程中,虽然他include了"CoreTypes.h"文件,但是我看似乎是没有必要的,因此暂时先注掉了。另外,他的成员函数都是空的并且实现都在头文件中,因此不需要cpp文件与之匹配。
下面,在TestC.h中继承了一个模块接口:

#include"../../Runtime/Core/Public/Modules/ModuleInterface.h"
class TestCModule: public IModuleInterface
{ 
public:static int TestCModuleFunction(int x, int y);
};

之后我想把 IMPLEMENT_MODULE 这个宏的定义也拷贝过来,可惜他本身牵扯到很多内容,最主要是这个宏也包括了PER_MODULE_BOILERPLATE这个宏,他的内容在ModuleBoilerplate.h可以看到,它实际想要为模块重载内存分配符号(new 和 delete):

/*** Override new + delete operators (and array versions) in every module.* This prevents the possibility of mismatched new/delete calls such as a new[] that* uses Unreal's allocator and a delete[] that uses the system allocator.*/
#if USING_CODE_ANALYSIS#define OPERATOR_NEW_MSVC_PRAGMA MSVC_PRAGMA( warning( suppress : 28251 ) )	//	warning C28251: Inconsistent annotation for 'new': this instance has no annotations
#else#define OPERATOR_NEW_MSVC_PRAGMA
#endif#if !FORCE_ANSI_ALLOCATOR
#define REPLACEMENT_OPERATOR_NEW_AND_DELETE \OPERATOR_NEW_MSVC_PRAGMA void* operator new  ( size_t Size                        ) OPERATOR_NEW_THROW_SPEC      { return FMemory::Malloc( Size ); } \OPERATOR_NEW_MSVC_PRAGMA void* operator new[]( size_t Size                        ) OPERATOR_NEW_THROW_SPEC      { return FMemory::Malloc( Size ); } \OPERATOR_NEW_MSVC_PRAGMA void* operator new  ( size_t Size, const std::nothrow_t& ) OPERATOR_NEW_NOTHROW_SPEC    { return FMemory::Malloc( Size ); } \OPERATOR_NEW_MSVC_PRAGMA void* operator new[]( size_t Size, const std::nothrow_t& ) OPERATOR_NEW_NOTHROW_SPEC    { return FMemory::Malloc( Size ); } \void operator delete  ( void* Ptr )                                                 OPERATOR_DELETE_THROW_SPEC   { FMemory::Free( Ptr ); } \void operator delete[]( void* Ptr )                                                 OPERATOR_DELETE_THROW_SPEC   { FMemory::Free( Ptr ); } \void operator delete  ( void* Ptr, const std::nothrow_t& )                          OPERATOR_DELETE_NOTHROW_SPEC { FMemory::Free( Ptr ); } \void operator delete[]( void* Ptr, const std::nothrow_t& )                          OPERATOR_DELETE_NOTHROW_SPEC { FMemory::Free( Ptr ); } \void operator delete  ( void* Ptr, size_t Size )                                    OPERATOR_DELETE_THROW_SPEC   { FMemory::Free( Ptr ); } \void operator delete[]( void* Ptr, size_t Size )                                    OPERATOR_DELETE_THROW_SPEC   { FMemory::Free( Ptr ); } \void operator delete  ( void* Ptr, size_t Size, const std::nothrow_t& )             OPERATOR_DELETE_NOTHROW_SPEC { FMemory::Free( Ptr ); } \void operator delete[]( void* Ptr, size_t Size, const std::nothrow_t& )             OPERATOR_DELETE_NOTHROW_SPEC { FMemory::Free( Ptr ); }
#else#define REPLACEMENT_OPERATOR_NEW_AND_DELETE
#endifclass FChunkedFixedUObjectArray;#ifdef DISABLE_UE4_VISUALIZER_HELPERS#define UE4_VISUALIZERS_HELPERS
#elif PLATFORM_UNIX// GDB/LLDB pretty printers don't use these - no need to export additional symbols. This also solves ODR violation reported by ASan on Linux#define UE4_VISUALIZERS_HELPERS
#else#define UE4_VISUALIZERS_HELPERS \uint8** GNameBlocksDebug = FNameDebugVisualizer::GetBlocks(); \FChunkedFixedUObjectArray*& GObjectArrayForDebugVisualizers = GCoreObjectArrayForDebugVisualizers;
#endif// in DLL builds, these are done per-module, otherwise we just need one in the application
// visual studio cannot find cross dll data for visualizers, so these provide access
#define PER_MODULE_BOILERPLATE \UE4_VISUALIZERS_HELPERS \REPLACEMENT_OPERATOR_NEW_AND_DELETE

对于目前的空白工程而言,内存管理相关的内容是没有的,因此我就算将一个空的IMPLEMENT_MODULE宏拷贝过来也意义不大,目前我只是想尝试不让bRequiresImplementModule为false的情况下编译通过,这其实只用在TestC.cpp最后补上一句就可以了:

extern "C" void IMPLEMENT_MODULE_TestC() { }

这一段本来会由IMPLEMENT_MODULE包括,但这里手动写上去了。
之后编译成功,程序也运行正常。

这篇关于【UE4源代码观察】在空白工程中测试跨模块调用函数的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1143488

相关文章

Python中re模块结合正则表达式的实际应用案例

《Python中re模块结合正则表达式的实际应用案例》Python中的re模块是用于处理正则表达式的强大工具,正则表达式是一种用来匹配字符串的模式,它可以在文本中搜索和匹配特定的字符串模式,这篇文章主... 目录前言re模块常用函数一、查看文本中是否包含 A 或 B 字符串二、替换多个关键词为统一格式三、提

使用Python进行GRPC和Dubbo协议的高级测试

《使用Python进行GRPC和Dubbo协议的高级测试》GRPC(GoogleRemoteProcedureCall)是一种高性能、开源的远程过程调用(RPC)框架,Dubbo是一种高性能的分布式服... 目录01 GRPC测试安装gRPC编写.proto文件实现服务02 Dubbo测试1. 安装Dubb

Python的端到端测试框架SeleniumBase使用解读

《Python的端到端测试框架SeleniumBase使用解读》:本文主要介绍Python的端到端测试框架SeleniumBase使用,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全... 目录SeleniumBase详细介绍及用法指南什么是 SeleniumBase?SeleniumBase

一文深入详解Python的secrets模块

《一文深入详解Python的secrets模块》在构建涉及用户身份认证、权限管理、加密通信等系统时,开发者最不能忽视的一个问题就是“安全性”,Python在3.6版本中引入了专门面向安全用途的secr... 目录引言一、背景与动机:为什么需要 secrets 模块?二、secrets 模块的核心功能1. 基

python多线程并发测试过程

《python多线程并发测试过程》:本文主要介绍python多线程并发测试过程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、并发与并行?二、同步与异步的概念?三、线程与进程的区别?需求1:多线程执行不同任务需求2:多线程执行相同任务总结一、并发与并行?1、

Python logging模块使用示例详解

《Pythonlogging模块使用示例详解》Python的logging模块是一个灵活且强大的日志记录工具,广泛应用于应用程序的调试、运行监控和问题排查,下面给大家介绍Pythonlogging模... 目录一、为什么使用 logging 模块?二、核心组件三、日志级别四、基本使用步骤五、快速配置(bas

MyBatisX逆向工程的实现示例

《MyBatisX逆向工程的实现示例》本文主要介绍了MyBatisX逆向工程的实现示例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学... 目录逆向工程准备好数据库、表安装MyBATisX插件项目连接数据库引入依赖pom.XML生成实体类、

C#实现查找并删除PDF中的空白页面

《C#实现查找并删除PDF中的空白页面》PDF文件中的空白页并不少见,因为它们有可能是作者有意留下的,也有可能是在处理文档时不小心添加的,下面我们来看看如何使用Spire.PDFfor.NET通过C#... 目录安装 Spire.PDF for .NETC# 查找并删除 PDF 文档中的空白页C# 添加与删

Python datetime 模块概述及应用场景

《Pythondatetime模块概述及应用场景》Python的datetime模块是标准库中用于处理日期和时间的核心模块,本文给大家介绍Pythondatetime模块概述及应用场景,感兴趣的朋... 目录一、python datetime 模块概述二、datetime 模块核心类解析三、日期时间格式化与

Python如何调用指定路径的模块

《Python如何调用指定路径的模块》要在Python中调用指定路径的模块,可以使用sys.path.append,importlib.util.spec_from_file_location和exe... 目录一、sys.path.append() 方法1. 方法简介2. 使用示例3. 注意事项二、imp