如何打包UE5插件使其适配所有编译配置？

我有一个插件，仅需打包其公共部分用于其他项目。在UE5.1版本中创建项目并安装该插件后开始打包，由于该插件依赖另一个插件，我不得不安装引擎源码，将依赖插件放入引擎，并使用引擎的BuildPlugin命令进行打包。最终插件已完成打包且能在其他项目的Development Editor配置下运行，但切换至DebugGame Editor等配置时，会出现无法在插件Intermediate目录中找到对应配置.lib文件的错误。想了解如何打包插件以使其适配所有配置？

已尝试操作 #

• 配置.uplugin文件
• 配置BuildPlugin命令
• 尝试多种组合方式：仅在.uplugin中配置、仅在BuildPlugin中配置、两者同时配置或都不配置
• 编译全配置的引擎源码

当前配置文件与命令 #

.uplugin模块配置 #

"Modules": [
    {
        "Name": "QORPOUEFRM",
        "Type": "Runtime",
        "LoadingPhase": "Default",
        "WhitelistTargetConfigurations": [ "DebugGame", "Development", "Shipping" ],
        "WhitelistTargets" : [ "Game", "Editor", "Client", "Server", "Program" ],
        "WhitelistPlatforms": [ "Win64" ]
    }
],

BuildPlugin打包命令 #

"D:\UEngines\UnrealEngine\Engine\Build\BatchFiles\RunUAT.bat" BuildPlugin -Plugin="D:\Plugins\ProjectForPlugin\Plugins\QORPOUEFRM\QORPOUEFRM.uplugin" -Configuration=DebugGame+Development+Shipping -EditorConfig=DebugGameEditor+DevelopmentEditor -TargetPlatforms=Win64 -Package="D:\Plugins\Packaged\ver3\QORPOUEFRM" -Rocket -VS2022

解决步骤 #

1. 修正.uplugin配置逻辑 #

你的WhitelistTargetConfigurations已覆盖所需配置，但需确保模块与Editor配置的兼容性：

• 对于Runtime模块，Editor相关配置（如DebugGameEditor）会自动关联，但需确认模块未限制Editor环境的编译。可以将WhitelistPlatforms替换为SupportedTargetPlatforms，避免平台过滤过于严格。
• 若插件需要在Editor中运行，可在模块配置中添加bAllowedToBeLoadedInEditor: true（默认Runtime模块已支持，但显式声明更稳妥）。

2. 调整BuildPlugin命令参数 #

UE的UAT命令通常用逗号分隔多配置项，而非加号，修正后的命令如下：

"D:\UEngines\UnrealEngine\Engine\Build\BatchFiles\RunUAT.bat" BuildPlugin -Plugin="D:\Plugins\ProjectForPlugin\Plugins\QORPOUEFRM\QORPOUEFRM.uplugin" -Configuration=DebugGame,Development,Shipping -EditorConfiguration=DebugGameEditor,DevelopmentEditor -TargetPlatforms=Win64 -Package="D:\Plugins\Packaged\ver3\QORPOUEFRM" -Rocket -VS2022

该命令会明确触发所有指定配置的编译，避免加号分隔导致的识别异常。

3. 确保依赖插件全配置编译 #

由于你的插件依赖另一个引擎内的插件，必须同步编译该依赖插件的所有目标配置：

• 对依赖插件执行相同的全配置BuildPlugin命令，或直接在VS中编译依赖插件的DebugGameEditor、DevelopmentEditor等所有目标。
• 确认依赖插件的Binaries/Win64目录下存在对应配置的.lib文件。

4. 检查打包后插件的文件完整性 #

打包完成后，进入插件的Binaries/Win64目录，确认是否存在所有配置对应的文件：

• 例如QORPOUEFRM-Win64-DebugGameEditor.lib、QORPOUEFRM-Win64-DevelopmentEditor.lib、QORPOUEFRM-Win64-DebugGame.lib等
• 若缺少文件，说明打包过程未正确编译对应配置，需重新检查命令参数或引擎编译状态。

5. 调整目标项目的插件引用配置 #

在使用该插件的项目中：

• 打开项目的Build.cs，确保无配置限制地引用插件：

  PublicDependencyModuleNames.AddRange(new string[] { "QORPOUEFRM" });
  

• 检查项目的Target.cs，确保未排除DebugGame等配置的编译。

内容的提问来源于stack exchange，提问作者Arkadii