UE_C++ —— Gameplay Modules

目录

[一,Module Creation](#一,Module Creation)

[INI File Setup](#INI File Setup)

[二,Multiple Gameplay Modules](#二,Multiple Gameplay Modules)

三,Limitations


编译成 DLL 的游戏相关类的集合;正如引擎本身由一组模块构成一样,每个游戏也是由一个或多个游戏模块构成的;这些模块类似于引擎以前的版本中的包packages的概念,它们都是一组相关类的容器;在引擎中,由于游戏逻辑都可以通过 C++ 实现,所以模块实际上是 DLL 文件,而不再是包文件;

一,Module Creation

游戏模块至少要包含一个头文件 (.h)、一个 C++ 文件 (.cpp) 和一个编译文件 (*.Build.cs);

头文件 必须位于模块目录的 Public 文件夹中,如 [GameName] \Source\ [ModuleName]\Public 目录;该文件包含了编译该模块中的类所需的所有头文件 - 包括模块自动生成的头文件;

cpp 复制代码
#include "Engine.h"
#include "EnginePrivate.h"
#include "<ModuleName>Classes.h"

C++ 文件 必须位于模块目录的 Private 文件夹中,也就是 **[GameName]\Source\[ModuleName]\Private**目录,用于注册及实现模块;

注,至少要使用 IMPLEMENT_PRIMARY_GAME_MODULE 注册一个模块,其他模块可以使用另一个可选的 IMPLEMENT_GAME_MODULE 方法进行注册;

cpp 复制代码
// Include our game's header file
#include "<ModuleName>.h"

// Designate the module as primary
IMPLEMENT_PRIMARY_GAME_MODULE(<ModuleName>, "<GameName>");

编译文件 位于游戏模块的根目录中,如目录 [GameName]\Source\[ModuleName],它定义了 UnrealBuildTool 编译该模块时要使用的一些信息;

cpp 复制代码
using UnrealBuildTool;

public class <ModuleName> : ModuleRules
{
	public <ModuleName>(TargetInfo Target)
	{
		PublicDependencyModuleNames.AddRange(new string[]{ "Core", "Engine" });
		PrivateDependencyModuleNames.AddRange(new string[]{ "RenderCore" });
	}
}
INI File Setup

由于新的游戏模块包含 UObject 代码,所以需进行一些必要的配置;

  • 需要在 DefaultEngine.ini 文件中的几个地方添加该模块:
    • [UnrealEd.EditorEngine] 部分的 EditPackages 数组;
    • [Launch] 部分;
    • [/Script/Engine.UObjectPackages] 部分的 NativePackages 数组;
cpp 复制代码
[UnrealEd.EditorEngine]
+EditPackages=<ModuleName>
cpp 复制代码
[Launch]
Module=<ModuleName>
cpp 复制代码
[/Script/Engine.UObjectPackages]
+NativePackages=<ModuleName>

二,Multiple Gameplay Modules

关于游戏 DLL 文件模块化处理有一些明智的做法选择;把游戏分为多个 DLL 文件会通常会得不偿失,带来很多麻烦,但这需要每个独立团队根据其需要和原则独立做出决定;使用多个游戏模块会使得链接时间更短,代码迭代速度更快; 但使用过多的模块,需要更加频繁地处理 DLL 文件导出 和/或 接口类;对于引擎和编辑器代码来说,做出这种妥协是正确的选择,但对于游戏代码来说,就不是很合理了;

可创建一个主要的游戏模块,然后在创建多个额外的游戏相关的模块;可针对这些新模块创建 *.Build.cs 文件,然后把到这些模块的引用添加到游戏的 Target.cs 文件(OutExtraModuleNames 数组)中;在C++代码中,请确保游戏模块使用适当的宏;至少有一个模块必须使用 IMPLEMENT_PRIMARY_GAME_MODULE 宏,而所有其他模块应该使用 IMPLEMENT_GAME_MODULE 宏;UBT会自动发现这些模块,并编译额外的游戏DLL文件;

三,Limitations

确实支持创建相互依赖的模块(包括模块彼此间导入和导出函数及数据 -- 比如 Engine 和 UnrealEd 模块),但是这会对编译时间造成不利影响,且有时候可能导致出现变量静态初始化相关的问题;没有相互依赖的游戏模块更难进行设计和维护,但模块的的代码可能会比较整洁;

相关推荐
m0_687399841 小时前
Ubuntu22 上,用C++ gSoap 创建一个简单的webservice
开发语言·c++
屁股割了还要学1 小时前
【C语言进阶】一篇文章教会你文件的读写
c语言·开发语言·数据结构·c++·学习·青少年编程
Shingmc31 小时前
【C++】二叉搜索数
开发语言·c++
洁可3 小时前
上位机程序开发基础介绍
c++·笔记
寒心雨梦4 小时前
本地preload hook案例
c++
滴水成川5 小时前
现代 C++ 开发工作流(VSCode / Cursor)
开发语言·c++·vscode·cursor
张同学的IT技术日记5 小时前
重构 MVC:让经典架构完美适配复杂智能系统的后端业务逻辑层(内附框架示例代码)
c++·后端·重构·架构·mvc·软件开发·工程应用
万能的小裴同学5 小时前
星痕共鸣数据分析2
c++·数据分析
刚入坑的新人编程6 小时前
暑期算法训练.8
数据结构·c++·算法·面试·哈希算法
TalkU浩克6 小时前
C++中使用Essentia实现STFT/ISTFT
开发语言·c++·音频·istft·stft·essentia