SuperAPI AI 工具集

unreal-thirdparty

通用与其它

查看项目

更新于 10-16 00:22

技能介绍

用途:指导在 Unreal Engine 5.x 项目与插件中集成第三方 C/C++ 库,涵盖静态链接、动态链接(DLL/SO/dylib)及跨平台构建配置。

主要能力:说明集成流程——将头文件与库放入 Plugin/Source/ThirdParty/,创建 ModuleType.External 的外部模块,通过 PublicIncludePaths、PublicAdditionalLibraries、PublicDelayLoadDLLs、RuntimeDependencies、PublicDefinitions 等属性配置;消费模块通过 PublicDependencyModuleNames.Add 依赖该外部模块,并用 THIRD_PARTY_INCLUDES_START/END 包裹头文件包含。给出四种集成方式(静态库、动态库+导入库、无导入库运行时查找、多平台静态库)及适用场景,并列出各平台库文件类型与命名前缀。

使用方式:编辑器内 Plugins > New Plugin > Third Party Library 可生成基于 DLL 的脚手架;静态库可用 Build.cs 两行式配置。文档还介绍屏障模块隔离 RTTI/异常设置、UE4CMake 的 CMakeTarget.add、UnrealMacroNuke 宏清理、conan-ue4cli 包管理、Android APL、ExternalDependencies 变更检测,以及 AddEngineThirdPartyPrivateStaticDependencies 复用引擎自带库。

适用场景:需要引入 Boost、PCL、OpenSSL、libcurl、zlib 等库,或为插件打包跨平台原生依赖时。

限制与注意:UE 默认关闭 RTTI 与异常,许多 C++ 库需在外部模块和所有消费模块中同时开启 bUseRTTI 与 bEnableExceptions;需用 /MD 与 Release CRT 匹配;check 宏可能与第三方代码冲突;VS 工程设置对 UBT 无效;Binaries/ThirdParty/ 不会被 UBT 重新生成;Linux 下 C++ 库需用 UE 的 Clang + libc++ 重编译。具体版本变更与完整代码示例见原文参考文档。