[UE4] いつもどんな時もフルクラッシュダンプ

クラッシュ原因の調査に有用なのがフルクラッシュダンプ。
ミニダンプでは変数の中身などが見えず、解決に有用な情報を得られないことも多い。

なので私は、

エディタを起動するときも

/path/to/UE4Editor.exe /path/to/project/MyGame.uproject -fullcrashdump

ビルドするときも

/path/to/engine/Build/BatchFiles/Build.bat ... -fullcrashdump

パッケージするときも

/path/to/engine/Build/BatchFiles/RunUAT.bat ... -fullcrashdump

クックやコマンドレットを起動するときも

/path/to/engine/Binaries/Win64/UE4Editor-Cmd.exe ... -fullcrashdump

常に -fullcrashdump をつけて作業していた。

それでも BuildSteps を利用した外部スクリプトが呼び出しているコマンドレットのクラッシュダンプは自動で取る手段がなかったので、デフォルトの出力をフルクラッシュダンプにしてみた。

Engine/Source/Runtime/CrashReportCore/Private/CrashDescription.cpp

FPrimaryCrashProperties::FPrimaryCrashProperties()
    ... // Initialize list
{
#if UE_BUILD_SHIPPING
    CrashDumpMode = ECrashDumpMode::Default;
#else
    CrashDumpMode = ECrashDumpMode::FullDump;
#endif
}

FCrashWERContext::FCrashWERContext( const FString& WERXMLFilepath )
    : FPrimaryCrashProperties()
{
    ...
#if UE_BUILD_SHIPPING
    CrashDumpMode = CommandLine.AsString().Contains( TEXT( "-fullcrashdump" ) ) ? ECrashDumpMode::FullDump : ECrashDumpMode::Default;
#else
    CrashDumpMode = CommandLine.AsString().Contains( TEXT( "-minicrashdump" ) ) ? ECrashDumpMode::Default: CrashDumpMode;
#endif
    ...
}

Engine/Runtime/Core/Private/GenericPlatform/GenericPlatformCrashContext.cpp

void FGenericCrashContext::Initialize()
{
    ...
#if UE_BUILD_SHIPPING
    NCached::Session.CrashDumpMode = (int32)ECrashDumpMode::Default;
#else
    NCached::Session.CrashDumpMode = (int32)ECrashDumpMode::FullDump;
#endif
    if (FPlatformMisc::SupportsFullCrashDumps() && FCommandLine::IsInitialized())
    {
        const TCHAR* CmdLine = FCommandLine::Get();
        if (FParse::Param(CmdLine, TEXT("fullcrashdumpalways")))
        {
            NCached::Session.CrashDumpMode = (int32)ECrashDumpMode::FullDumpAlways;
        }
        else if (FParse::Param(CmdLine, TEXT("fullcrashdump")))
        {
            NCached::Session.CrashDumpMode = (int32)ECrashDumpMode::FullDump;
        }
        else if (FParse::Param(CmdLine, TEXT("minicrashdump")))
        {
            NCached::Session.CrashDumpMode = (int32)ECrashDumpMode::Default;
        }
    }
    ...
}

これでテストビルド以外ではデフォルトでフルダンプが出ているので、バグ報告に対し「-fullcrashdump で再現してみて」というやりとりが減ることを期待する。