使用 Unreal5.4 开发游戏时新增子模块

416 阅读1分钟

新增模块

1.在 Visual Studio 解决方案资源管理器中右击项目弹出以下菜单。

image.png

2.下图输入框中 WorldSeed 只是个示例,可替换成实际的名称。

image.png

3.点击右下方的“确定”按钮就可新建模块。

image.png

4.修改 Xxxx.Build.cs 文件。

最好做这个步骤,在最后可能编译失败后再做这步也行。

image.png

这段代码复制主模块下的 Xxxx.Build.cs 改改模块名就行。

using UnrealBuildTool;

public class WorldSeed : ModuleRules
{
    public WorldSeed(ReadOnlyTargetRules Target) : base(Target)
    {
        PCHUsage = PCHUsageMode.UseExplicitOrSharedPCHs;

        PublicDependencyModuleNames.AddRange(new string[] { "Core", "CoreUObject", "Engine", "InputCore", "EnhancedInput" });
    }
}

5.修改两个 Xxxx.Target.cs 文件,下图中的 "UnrealWorlds" 是我的项目名。

image.png

Xxxx.Target.cs 文件里新增红框里的代码:

image.png

XxxxEditor.Target.cs 文件里新增红框里的代码:

image.png

6.修改 Xxxx.uproject 文件。

image.png

复制 Modules 下已有的代码改改 Name 就行。

image.png

7.关闭 Visual Studio后在项目目录下右击 Xxxx.uproject 重新生成 Xxxx.sln 文件。

最好做这个步骤,不然有可能编译会出错。

image.png

8.点击 Xxxx.sln 文件打开 Visual Studio,然后右击项目重新编译。

image.png

不出意外的话,编译成功后就会显示这样的输出。

image.png

添加依赖

比如 UnrealWords 模块依赖 WorldSeed 模块,可参看下图在模块下 Xxxx.Build.cs 文件中添加。其中 PublicDependencyModuleNames 和 PrivateDependencyModuleNames 的区别是加在前者中的依赖可传递,后者中的依赖只是本模块中使用。

image.png

如下图在 Xxxx.uproject 中添加依赖,最完这步后参考上述第 8 个和第 9 个步骤重新编译项目。

image.png

参考资料

虚幻引擎官方文档 Unreal5.4 虚幻引擎模块