[Unrael Engine] IWYU 간단 정리

IWYU는 “Include What You Use” 의 준말로, 소스 코드에 필요한 헤더 파일만 포함(Include) 해야 한다는 원칙입니다.

 

Unreal Engine은 해당 IWYU를 준수하기 위해 언리얼 5 버전부터 다음과 같은 규칙을 적용합니다.

1. 모든 헤더 파일은 필수기능이 집약된 CoreMinimal.h를 포함합니다.
2. *.cpp 파일은 매칭된 *.h 파일을 우선 포함합니다.
3. UBT(Unreal Build Tool)에서 어떤 PCH(Precompiled Header)를 Include 할지 판단하여 포함합니다.
4. Engine.h 또는 UnrealEd.h 같은 모놀리식 헤더 파일은 더 이상 포함되지 않습니다.

 

모듈이 위 규칙을 사용하도록 하려면 *.Build.cs 파일에서 PCHUsage를 PCHUsageMode.UseExplicitOrSharedPCHs  로 설정해야 합니다.

 

소스 코드가 필요한 헤더를 적절히 포함하고 있는지 확인하려면,

*.Target.cs 파일에서 다음과 같이 설정하여 PCH를 끄고, Non-Unity 빌드를 진행하여 로그를 확인하면 됩니다.

public class MyProjectTarget : TargetRules
{
	public MyProjectTarget(TargetInfo Target) : base(Target)
	{
		Type = TargetType.Game;

		bUseUnityBuild = false;
		bUsePCHFiles = false;
...

더 자세한 내용은 하단 문서에서 확인할 수 있습니다.

https://dev.epicgames.com/documentation/en-us/unreal-engine/include-what-you-use-iwyu-for-unreal-engine-programming