111 lines
9.1 KiB
Markdown
111 lines
9.1 KiB
Markdown
|
---
|
|||
|
|
title: BuildGraph与UnrealBinaryBuilde
|
|||
|
|
date: 2022-08-06 20:41:15
|
|||
|
|
tags: BuildGraph
|
|||
|
|
rating: ⭐️⭐️
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## BuildGraph
|
|||
|
|
- 共享共同的构建步骤，以节约构建时间
|
|||
|
|
- 能使用Graph对编译量进行优化
|
|||
|
|
- 易于并行化构建
|
|||
|
|
- 存储构建脚本在每个分支中，而不需要编写额外的后端程序
|
|||
|
|
- 不同的产品可以定制不同的额外步骤
|
|||
|
|
|
|||
|
|
基于以上的需求，EPIC的开发了BuildGraph，类似于Make/Ant/MSBuild,但一开始就是基于并行分布式处理设计的。各种操作定义在AutomationTool中，可以通过派生CustomTask类来扩展构建任务。
|
|||
|
|
文档：https://docs.unrealengine.com/4.27/en-US/ProductionPipelines/BuildTools/AutomationTool/BuildGraph/
|
|||
|
|
|
|||
|
|
本人推荐看查利鹏的文章《BuildGraph：构建支持多平台打包的二进制引擎》https://imzlp.com/posts/11956/，里面除了介绍了基础用法之外还介绍了加快构建的方法（如何砍掉不必要的构建过程）以及构建安卓与IOS端的方法。
|
|||
|
|
|
|||
|
|
官方视频也有对它进行介绍（10：17分开始）：
|
|||
|
|
《Tools and Infrastructure for Large Teams | Unreal Dev Days 2019 | Unreal Engine》
|
|||
|
|
https://youtu.be/d6lyAI4Ftkw
|
|||
|
|
|
|||
|
|
视频中还介绍了：
|
|||
|
|
- EPIC的自动合并工具RoboMerge，源码位于Engine\Extras\RoboMerge。
|
|||
|
|
- 同步工作区工具BuildAgent，源码位于Engine\Source\Programs\BuildAgent。
|
|||
|
|
- AutoSDK，源码位于Engine\Extras\AutoSDK。
|
|||
|
|
- UnrealGameSync，源码位于Engine\Source\Programs\UnrealGameSync。
|
|||
|
|
|
|||
|
|
PS.BuildAgent与UnrealGameSync基于perforce。
|
|||
|
|
|
|||
|
|
分布式流程逻辑：
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 插件构建命令
|
|||
|
|
>Engine\Build\BatchFiles\RunUAT.bat BuildPlugin -Plugin=[Path to .uplugin file, must be outside engine directory] -Package=[Output directory] -Rocket -VS2019
|
|||
|
|
|
|||
|
|
`D:\UnrealEngine\UnrealEngine\Engine\Build\BatchFiles\RunUAT.bat BuildPlugin -Plugin=C:\Users\BlueRose\Desktop\YueHuaProject\Plugins\MultiDraw\MultiDraw.uplugin -Package=C:\Users\BlueRose\Desktop\Ouput\plugins -Rocket -VS2019 -TargetPlatforms=Win64`
|
|||
|
|
|
|||
|
|
## 引擎构建命令
|
|||
|
|
`D:\UnrealEngine\UnrealEngine\Engine\Build\BatchFiles\RunUAT.bat BuildGraph -target="Make Installed Build Win64" -script=Engine/Build/InstalledEngineBuild.xml -set:WithDDC=true -set:SignExecutables=false -set:EmbedSrcSrvInfo=false -set:GameConfigurations=Development;Shipping -set:WithFullDebugInfo=false -set:HostPlatformEditorOnly=false -set:AnalyticsTypeOverride= -set:HostPlatformDDCOnly=true -set:WithWin64=true -set:WithMac=false -set:WithAndroid=false -set:WithIOS=false -set:WithTVOS=false -set:WithLinux=false -set:WithLumin=false -set:WithLinuxArm64=false -set:CompileDatasmithPlugins=false -set:WithServer=false -set:WithClient=false -set:WithHoloLens=false`
|
|||
|
|
|
|||
|
|
## AutomationTool其他命令
|
|||
|
|
具体可以参考：https://github.com/botman99/ue4-unreal-automation-tool
|
|||
|
|
```
|
|||
|
|
AnalyzeThirdPartyLibs CleanDevices RebasePublicIncludePaths TestKillAll
|
|||
|
|
BenchmarkBuild CleanFormalBuilds RebuildHLOD TestLog
|
|||
|
|
BenchmarkOptions CleanTempStorage RebuildLightMaps TestMacZip
|
|||
|
|
BlameKeyword CodeSurgery RecordPerformance TestMcpConfigs
|
|||
|
|
Build CopySharedCookedBuild ReplaceAssetsUsingManifest TestMessage
|
|||
|
|
BuildCMakeLib CopyUAT ResavePackages TestOSSCommands
|
|||
|
|
BuildCommonTools CryptoKeys ResavePluginDescriptors TestP4_ClientOps
|
|||
|
|
BuildCookRun DebugSleep ResaveProjectDescriptors TestP4_CreateChangelist
|
|||
|
|
BuildDerivedDataCache DumpBranch RunEditorTests TestP4_Info
|
|||
|
|
BuildEditor ExportIPAFromArchive RunP4Reconcile TestP4_LabelDescription
|
|||
|
|
BuildForUGS ExportMcpTemplates RunUnreal TestP4_StrandCheckout
|
|||
|
|
BuildGame ExtractPaks StashTarget TestRecursion
|
|||
|
|
BuildGraph FinalizeInstalledBuild SubmitUtilizationReportToEC TestRecursionAuto
|
|||
|
|
BuildHlslcc FixPerforceCase SyncBinariesFromUGS TestStopProcess
|
|||
|
|
BuildPhysX FixupRedirects SyncDDC TestSuccess
|
|||
|
|
BuildPlugin GenerateAutomationProject SyncDepotPath TestTestFarm
|
|||
|
|
BuildServer GenerateDSYM SyncProject TestThreadedCopyFiles
|
|||
|
|
BuildTarget GitPullRequest SyncSource TestUATBuildProducts
|
|||
|
|
BuildThirdPartyLibs IPhonePackager TempStorageTests UBT
|
|||
|
|
CheckBalancedMacros ListMobileDevices TestArguments UE4BuildUtilDummyBuildCommand
|
|||
|
|
CheckCsprojDotNetVersion ListThirdPartySoftware TestBlame UnstashTarget
|
|||
|
|
CheckForHacks Localise TestChangeFileType UpdateLocalVersion
|
|||
|
|
CheckPerforceCase Localize TestChanges UploadDDCToAWS
|
|||
|
|
CheckRestrictedFolders LookForOverlappingBuildProducts TestCleanFormalBuilds WriteIniValueToPlist
|
|||
|
|
CheckTargetExists MegaXGE TestCombinePaths ZipProjectUp
|
|||
|
|
CheckXcodeVersion OpenEditor TestFail ZipUtils
|
|||
|
|
CleanAutomationReports P4WriteConfig TestFileUtility
|
|||
|
|
CleanDDC ParseMsvcTimingInfo TestGauntlet
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## UnrealBinaryBuilder
|
|||
|
|
使用BuildGraph需要使用命令行，对开发者还是不够友好，所以可以使用UnrealBinaryBuilder：https://github.com/ryanjon2040/Unreal-Binary-Builder 这个项目使用c#编写，代码相对比较简单，可以参考用于公司内部的CI/CD工具以及分布式构建系统编写（如何与BuildGraph交互与通信）。查看源码后发现已经对应UE5进行了适配，所以可以放心使用。
|
|||
|
|
|
|||
|
|
一开始进入的是界面。如果是刚下载的源代码可以点击Start来下载二进制文件、生成引擎解决方案文件以及构建AutomationTool。
|
|||
|
|
|
|||
|
|
|
|||
|
|
之后点击Compile选项卡来设置构建选项。左边的Platform选择要构建的平台，其中Mac、Ios、Android可以参考查利鹏的文章。其中构建需要能够打开的引擎需要勾选的include DDC与Host DDC Only，不然运行引擎会提示丢失各种Shader与Shader文件夹。左下角的输入栏可以指定编译的版本，默认是Development与Shipping。点击Copy Commandline To Clipboard，会将生成的命令行复制到剪贴板，之后可以粘贴到文字编辑工具中查看，来确定所有的编译参数是否正确，也可以之后在cmd中直接运行这个命令来执行编译。最后点击Build UnrealEngine来进行构建。
|
|||
|
|
|
|||
|
|
|
|||
|
|
实际的编译时间比你手动编译的要长，是因为默认的BuildGraph构建文件**Engine/Build/InstalledEngineBuild.xml**中会有编译所有模块的指令。这里可以根据需求来创建新的BuildGraph文件去掉 -allmodules与-nolink来解决。
|
|||
|
|
```xml
|
|||
|
|
<Node Name="Compile UE4Game Win64" Requires="Compile UnrealHeaderTool Win64" Produces="#UE4Game Win64;#UE4Game Win64 Unstripped;#UE4Game Win64 Stripped;#UE4Game Win64 Unsigned;#UE4Game Win64 Signed">
|
|||
|
|
<ForEach Name="Target" Values="UE4Game;$(OptionalClientTarget);$(OptionalServerTarget)">
|
|||
|
|
<ForEach Name="Configuration" Values="$(GameConfigurations)">
|
|||
|
|
<Compile Target="$(Target)" Platform="Win64" Configuration="$(Configuration)" Tag="#UE4Game Win64" Arguments="-precompile -allmodules -nolink $(VSCompilerArg) $(TargetDebugInfoArg)"/>
|
|||
|
|
<Compile Target="$(Target)" Platform="Win64" Configuration="$(Configuration)" Tag="#UE4Game Win64" Arguments="-precompile $(VSCompilerArg) $(TargetDebugInfoArg)" Clean="false"/>
|
|||
|
|
</ForEach>
|
|||
|
|
</ForEach>
|
|||
|
|
</Node>
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
在Zip Build选项卡中，你可以设置是否在编译完成后使用zip将引擎打包，推荐勾选FeaturePacks、Samples、Templates，不然新建项目与Level中的选项将会失效。如果用户需要debug那就需要勾选PDB与DEBUG。
|
|||
|
|
|
|||
|
|
|
|||
|
|
### “missing PDBCopy”问题解决
|
|||
|
|
构建的时候会遇到一个“missing PDBCopy”的问题。需要下载Win10 SDK安装Debugging Tools for Windows。下载地址：
|
|||
|
|
https://developer.microsoft.com/en-us/windows/downloads/windows-10-sdk
|
|||
|
|
|
|||
|
|
只需要勾选**Debugging Tools for Windows**并安装即可解决问题。
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 构建无源码版本
|
|||
|
|
编译是需要所有的头文件的。所以使用默认设置，并在打包Zip时勾选`Source`,最后再解压把所有`*.cpp`文件删除。
|
|||
|
|
|
|||
|
|
|