UE4【C++】【UEBuildTarget源码分析之PreBuild和PostBuild】

水深无声 2023-02-18 09:34 14阅读 0赞

//1.UEBuildTarget.cs
    //初始化UEBuildTarget
    private UEBuildTarget(TargetDescriptor InDescriptor, ReadOnlyTargetRules InRules, RulesAssembly InRulesAssembly)
    //2.生成PreBuild和PostBuild对应的.bat文件
    WriteCustomBuildStepScripts
    private FileReference[] WriteCustomBuildStepScripts(UnrealTargetPlatform HostPlatform, DirectoryReference Directory, string FilePrefix, List<Tuple<string[], UEBuildPlugin>> CommandBatches)
    //3.Build
    public TargetMakefile Build(BuildConfiguration BuildConfiguration, ISourceFileWorkingSet WorkingSet, bool bIsAssemblingBuild, FileReference SingleFileToCompile)

原理：解析.uproject生成对应的PreBuild.ran、PreBuild.bat和PostBuild.ran、PostBuild.bat。然后通过Cmd调用执行。

所以PreBuild和PostBuild都可以通过自己实现bat文件来执行调用。比如：

@echo off
    set ProjectPath=%1%
    set ProjectUProjectPath=%2%
    set TargetName=%3%
    set Build=%4%
    set Engine=%4%
    
    echo %ProjectPath%
    echo %ProjectUProjectPath%
    echo %TargetName%
    echo %Build%
    
    if exist "%ProjectPath%\Plugins\BacktraceIntegration\Content\BacktraceIntegration\backtrace_post_build.exe" set BacktraceExe="%ProjectPath%\Plugins\BacktraceIntegration\Content\BacktraceIntegration\backtrace_post_build.exe"
    @echo %BacktraceExe%
    
    set TargetConfiguration=%4%
    if %Build%==Development (
    	set TargetConfiguration=Development
    ) else if %Build%==Shipping (
        set TargetConfiguration=Shipping
    ) else (
    	set TargetConfiguration=Development
    )
    @echo off
    
    %BacktraceExe% --token=bef0161bc5cfc73f6dadec0a6a4b1baba305da85af44467b688de78de877561a --send_debug=True --send_release=True --realm=scp3501 --symbols_token=175aef1bff7f6b349b36c7ec84f8860bd5ade7850af087990fa2948e414c6095 --engine_dir=%Engine% --project_dir=%ProjectPath% --target_name=%TargetName% --target_configuration=%TargetConfiguration% --target_type="Game" --project_file=%ProjectUProjectPath%

这是一个Backtrace插件打包并上传Symbols.zip的功能，可以直接实现bat，也可以通过配置.uproject实现。

{
    	"FileVersion": 3,
    	"EngineAssociation": "{7608E28F-4791-3BBA-D3A0-D6904CA14DA5}",
    	"Category": "",
    	"Description": "",
    	"Modules": [
    		{
    			"Name": "UE4_BackTrace",
    			"Type": "Runtime",
    			"LoadingPhase": "Default"
    		}
    	],
    	"Plugins": [
    		{
    			"Name": "BacktraceIntegration",
    			"Enabled": true,
    			"MarketplaceURL": "com.epicgames.launcher: //ue/marketplace/content/66f20b48cf6741e3a47a1fad7d118651",
    			"Token": "bef0161bc5cfc73f6dadec0a6a4b1baba305da85af44467b688de78de877561a",
    			"SymbolsToken": "175aef1bff7f6b349b36c7ec84f8860bd5ade7850af087990fa2948e414c6095",
    			"Realm": "scp3501",
    			"ProjectName": "ProjectX",
    			"SendReleasePdb": true,
    			"SendDebugPdb": true,
    			"OverrideGlobalReporter": true
    		}
    	],
    	"PostBuildSteps":
    	{
    		"Win64": [
    			"\"$(ProjectDir)/Plugins/BacktraceIntegration/Content/BacktraceIntegration/backtrace_post_build.exe\" --token=bef0161bc5cfc73f6dadec0a6a4b1baba305da85af44467b688de78de877561a --send_debug=True --send_release=True --realm=scp3501 --symbols_token=175aef1bff7f6b349b36c7ec84f8860bd5ade7850af087990fa2948e414c6095 --engine_dir=\"$(EngineDir)\" --project_dir=\"$(ProjectDir)\" --target_name=\"$(TargetName)\" --target_configuration=\"$(TargetConfiguration)\" --target_type=\"$(TargetType)\" --project_file=\"$(ProjectFile)\""
    		]
    	}
    }