UE5.3 虚幻引擎 Windows插件开发打包（带源码插件打包、无源码插件打包）
0 引言随着项目体量的增大，全部代码功能都放一起很难管理。以是有什么办法可以将大模块划分成一个个小模块吗。固然有，由于虚幻引擎本身就遇到过这个问题，他的办理办法就是使用插件的形式开发。
例如，一个团队开发了文件I/O模块插件，另一个团队开发了网络模块，那么大家各个模块可以同一的组合，那样虚幻引擎的功能就可以快速状态。
1 快速入门
1.1 新建插件的前提
创建插件之前，必须已经有一个UE C++的工程
1.2 创建插件步调
[*]打开【编辑】-【插件】面板
https://i-blog.csdnimg.cn/blog_migrate/e7141acf0734f8e6fe0d614b19e11770.png#pic_center
[*]点击左上角【添加】按钮，添加插件。选择空白插件模版，然后设置好插件名称等内容，举行创建。
https://i-blog.csdnimg.cn/blog_migrate/71298744f70e67f77397e658be695b22.png#pic_center
[*]创建成功后的VS目次如下所示：
每个文件的内容看文章的第三部分。
https://i-blog.csdnimg.cn/blog_migrate/e5e71e6c6514b455a51214d5aaf5bfe2.png#pic_center
[*]打开【工具】栏新建C++类，父类选择【蓝图函数库】（相当于C++的全局函数，其他蓝图类可以直接使用）
https://i-blog.csdnimg.cn/blog_migrate/7eecd646f4b1c86ddfd8f05f9794aa00.png#pic_center
https://i-blog.csdnimg.cn/blog_migrate/c01eb8adc084e403a9b603667f81fbba.png#pic_center
[*]选择新建C++类的位置，即是哪个模块的C++类。
https://i-blog.csdnimg.cn/blog_migrate/a60568c54fd42a1e9420c207ac7e0022.png#pic_center
[*]随后在 UGlobalFunction 类中添加一个静态函数 PrintNumer007（注意，一定要静态函数才行）
https://i-blog.csdnimg.cn/blog_migrate/d3228f910c993231ca4486871f0ebd3e.png#pic_center
[*]这个函数要让蓝图使用必要添加对应的宏 UFUNCTION(BlueprintCallable)
https://i-blog.csdnimg.cn/blog_migrate/42ccab0aca20f1e898d5cdea23406d56.png#pic_center
[*]编译工程（天生办理方案），测试函数是否可以正常使用。任意在一个蓝图类中右键搜索函数名，可以搜索到就说明功能可以正常使用。
https://i-blog.csdnimg.cn/blog_migrate/d9db82cd3b9f43063efda442340c9458.png#pic_center
此时插件的功能就制作完成，只必要打包插件即可。
1.3 打包插件
[*]打包插件之间必要在插件的.uplugin做一些配置，确保WhitelistPlatforms是“Win32","Win64”，Type是“Runtime”。
https://i-blog.csdnimg.cn/blog_migrate/bd32295e1e8d437e4073f56a91cdc57c.png#pic_center
[*]打开【编辑】-【插件】面板，点击【包】，举行插件打包。
https://i-blog.csdnimg.cn/blog_migrate/dd523241fa841aa44ab8e5e1d9cd0bf0.png#pic_center
https://i-blog.csdnimg.cn/blog_migrate/a19b7336996e67d7d539298f42248653.png#pic_center
https://i-blog.csdnimg.cn/blog_migrate/7bcbd7ef87ccd9dea8be55ef55b8541a.png#pic_center
[*]测试打包后的插件可否正常使用（注意：测试的工程一定要与插件编译的版本保持划一，即都是UE4.27版本或者UE5.0版本）
[*]将Plugins目次直接拷贝到别的工程下即可
测试的工程是纯蓝图工程或者C++工程都可以
https://i-blog.csdnimg.cn/blog_migrate/868871f08e987486658f87ec92cf9954.png#pic_center
https://i-blog.csdnimg.cn/blog_migrate/80989fe6ddd96dac5d94dbee6a28a0a4.png#pic_center
https://i-blog.csdnimg.cn/blog_migrate/07105866df7adc85a738da47cea6da35.png#pic_center
2 无源代码的插件制作
为什么可以不用源码：插件编译后天生了动态库文件，若是删除插件源码的话，就不能再举行编译。以是就不必要让插件编译，bUsePrecompiled = true; 就可以不让插件编译。（就和使用动态库一样，只必要保存头文件，另有动态库文件就可以让别人使用）
注意：无源码插件是在已经打包好插件的基础上，举行一些修改。然后再将步伐给别人使用。
[*]将打包后的插件Source文件夹中的Private文件夹删除
https://i-blog.csdnimg.cn/blog_migrate/b663e86d48aae78e99f2cc834d2db8da.png#pic_center
[*]必要修改.Build.cs文件内容
https://i-blog.csdnimg.cn/blog_migrate/e8963d25f96e522201da80e7c4aa2de5.png#pic_center
[*]得到了最终的文件目次，如下所示，我们只必要把插件目次下的文件拷贝到别的UE工程的Plugins文件夹下即可使用插件。
https://i-blog.csdnimg.cn/blog_migrate/59eb90891120f970b49399f4a1dddcb7.png#pic_center
3 插件详细介绍
3.1 插件的使用方法
插件有两种使用方法：
[*]安装到引擎目次
你可以将插件直接放到C:\Program Files\Epic Games\UE_5.0\Engine\Plugins\Marketplace目次下，也可以放到这个的上级目次。Marketplace目次一般存放的是虚幻阛阓中下载的插件，我也风俗将本身做的插件放到这个目次，看个人风俗了。
https://i-blog.csdnimg.cn/blog_migrate/3a536d462a662fca055800017d06dc3c.png#pic_center
[*]安装到工程目次
如果必要举行工程拷贝的话，将插件安装到工程目次中是最简单的，别人不必要再去引擎中配置一下你工程中的插件。而是可以直接把插件也拷贝过去。
将插件放到工程的Plugins目次下即可，如果没有该目次则新建一个。
https://i-blog.csdnimg.cn/blog_migrate/6bbdee7b56362223d20532708e4bdc48.png#pic_center
3.1 UE 预置插件模版
在UE中新建插件时，有很多 UE 预置的插件模版，如下图所示：
https://i-blog.csdnimg.cn/blog_migrate/fb8d78422fecc0e626de3847a53e49b3.png#pic_center
3.1.1 空白
[*]使用少少量的代码创建一个空白插件
[*]如果想要从头开始设置，或创建一个不可见的插件，请选择此模版。用此模板创建的插件将会出如今编辑器的插件列表中，但不会注册任何按钮或菜单输入。
该模板创建出来，只包罗下面这些最基本的文件。https://i-blog.csdnimg.cn/blog_migrate/cf163ed3295221dbe5d991884aaad47a.png#pic_center
3.1.2 纯内容
[*]创建一个值包罗内容的空白插件。
[*]这个模板创建出来是真正意义上的空白插件，什么都没有(一般不会用这个模板)。不会天生C++代码。
3.1.3 编辑器独立窗口
[*]创建一个插件，其将在关卡编辑器的工具栏中添加一个按钮；点击按钮可调出一个空白独立选项卡窗口。
[*]该插件的代码，如下图所示：内容就多了很多，用于完成按钮点击变乱，另有窗口调用等功能。
https://i-blog.csdnimg.cn/blog_migrate/2b1d99e35c4a376bc0d3b746447626b8.pnghttps://i-blog.csdnimg.cn/blog_migrate/0faad7e777eee731e5c274afaa623235.png
3.1.4 编辑器工具栏按钮
[*]创建一个插件，其将在关卡编辑器的工具栏中添加一个按钮。
[*]首先在创建的"OnButtonClick"变乱中实现一些内容
[*]插件的代码如图所示：
https://i-blog.csdnimg.cn/blog_migrate/38d05312afa2dda20fb8f8d3a66eefe9.pnghttps://i-blog.csdnimg.cn/blog_migrate/f5964683ae09d9becaa6f0f4f1cd6d6e.png
3.1.5 编辑器模式
[*]创建一个将含有编辑器模式的插件。
[*]其将包罗工具包范例，以指定出如今**“模式”选项卡**（在植物、地形等选项卡旁边）中的UI。其也将包罗最基础的UI，展示编辑器交互和取消/复兴功能的使用。
[*]插件的代码如图所示：可以发现代码量增多了。
[*]【注意】必要编译下插件再打开工程才能瞥见插件的UI。
https://i-blog.csdnimg.cn/blog_migrate/70b2a11b2b75e2540e0ae052a6d03482.pnghttps://i-blog.csdnimg.cn/blog_migrate/6206e1a1d8bba9473eb6e5056207d4fa.png
3.1.6 第三方库
[*]创建一个使用已包罗第三方库的插件。
[*]这可用作范例，展示怎样自行包罗、加载和使用第三方库
[*]该模版包括了一个测试用的三方库，然后另有怎样使用该三方库的代码
https://i-blog.csdnimg.cn/blog_migrate/cc7e0f97f9b55f99c28f612682bbb914.png
3.1.7 蓝图库
[*]创建一个含有蓝图函数库的插件。
[*]如果创建静态蓝图节点，请选择此模板
[*]代码布局如图所示：
https://i-blog.csdnimg.cn/blog_migrate/b3c0bdbb3ba06a225a72d44c63e03951.png
3.2 插件中文件的寄义
[*]插件中包罗很多文件夹和文件
https://i-blog.csdnimg.cn/blog_migrate/1c2b23ffc5e8f34597d5f92aa1a9219a.png#pic_center
[*]Binaries：编译后的dll文件存放位置
[*]Content：游戏资源Asset文件存放位置
[*]Intermediate：编译的中间文件存放位置
[*]Resources：一般为图片图标的存放位置
[*]Source：代码存放位置
[*].uplugin文件：插件项目配置文件，JSON格式
[*].Build.cs文件：每个 .build.cs 文件声明派生自 ModuleRules 基类的类，并设置属性控制器从构造函数举行编译的方式。由虚幻编译工具编译，并被构造来确定团体编译环境。使用 C# 语法。
[*]***.uplugin文件详解
{
"FileVersion": 3,
"Version": 1,
"VersionName": "1.0",
"FriendlyName": "HHW_PluginTest",
"Description": "TestPlugin",
"Category": "Other", // 类目名即在插件浏览器中所属的类目
"CreatedBy": "hhw",
"CreatedByURL": "",
"DocsURL": "",
"MarketplaceURL": "",
"SupportURL": "",
"CanContainContent": true,
"IsBetaVersion": false,
"IsExperimentalVersion": false,
"Installed": false, // 默认启用或禁用状态，在插件浏览器中可以控制加载卸载插件模块
"Modules": [ // 描述模块名、运行类型、加载时机、支持平台等信息
{
"Name": "HHW_PluginTest",
"Type": "Runtime", // 有多种：Runtime，RuntimeNoCommandlet，Developer，Editor，EditorNoCommandlet，Program
"LoadingPhase": "Default",
"WhitelistPlatforms": [ // 支持的平台
"Win32",
"Win64"
]
}
]
}
[*]***.Build.cs文件
// Copyright Epic Games, Inc. All Rights Reserved.
using UnrealBuildTool;
public class HHW_PluginTest : ModuleRules
{
public HHW_PluginTest(ReadOnlyTargetRules Target) : base(Target)
{
PCHUsage = ModuleRules.PCHUsageMode.UseExplicitOrSharedPCHs;
// 将bUsePrecompiled设置为true后，就不会让插件编译
//bUsePrecompiled = true;
//PrecompileForTargets = PrecompileTargetsType.None;
PublicIncludePaths.AddRange(
new string[] {
// ... add public include paths required here ...
}
);
PrivateIncludePaths.AddRange(
new string[] {
// ... add other private include paths required here ...
}
);
PublicDependencyModuleNames.AddRange(
new string[]
{
"Core",
// ... add other public dependencies that you statically link with here ...
}
);
PrivateDependencyModuleNames.AddRange(
new string[]
{
"CoreUObject",
"Engine",
"Slate",
"SlateCore",
// ... add private dependencies that you statically link with here ...
}
);
DynamicallyLoadedModuleNames.AddRange(
new string[]
{
// ... add any modules that your module loads dynamically here ...
}
);
}
}
4 插件开发常见问题
[*]增删代码时，没有更新VistualStudio项目（uproject文件上右键点击Generate Vistual Studio project files可更新重载项目代码）
[*].Build.cs 代码语法错误导致编译错误。
[*].uplugin内容语法错误导致启动失败。
[*]第三方库路径配置错误，导致引入失败，头文件找不到或者链接lib文件失败。
[*]引擎版本与插件版本不划一导致插件模块丢失不能使用。
[*]插件的"Installed": false,或者插件欣赏器中没有启动插件，导致插件模块没有找到。
[*]插件的Module下的"Type"配置与实际项目运行类型不划一。
[*].插件的Module下的"LoadingPhase"配置与项目实际使用插件模块机遇不划一，导致插件模块没有找到。
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。
页:
[1]