Logging Setting - 로깅 환경의 설정

언리얼 엔진에서는 로깅 환경을 위해 기본적으로 UE_LOG라는 매크로를 제공한다.

이 매크로의 사용법은 아래와 같다.

UE_LOG(카테고리, 로깅 수준, 형식 문자열, 인자...)

이렇게 출력되는 로그는 에디터의 출력 로그 창에서 확인할 수 있다.

출력 로그창이 활성화 되있지 않다면, 상단 메뉴에서 [창 -> 개발자 툴 -> 출력 로그]에서 활성화할 수 있다.

이렇게 기록 된는 로그들은 프로젝트 폴더의 Saved폴더 내에 있는 .log 확장자 파일로 저장된다.

 

로그의 중요도를 나타내는 로깅수준은 크게 메시지, 경고, 에러 이렇게 세 가지로 나뉜다. 그리고 이 중요도에 따라 출력 로그 창에 표시되는 텍스트 색상은 흰색, 노란색, 붉은색으로 표시된다. 이 로깅 수준별 색상은 에디터 메뉴에서 변경이 가능하다.

상위 메뉴에서 [편집 -> 에디터 개인설정.. -> 일반 -> 외형 -> 출력 로그]에서 편집할 수 있다.

 

로그 매크로는 다양한 데이터를 하나의 문자열로 조합해 출력할 수 있다. C언어의 printf 함수와 같은 형식으로 가변 인자를 받을 수도 있다.

문자열을 정의할 때는 앞서 설명한 것처럼 모든 플랫폼에서 2바이트 문자열을 지원하는 TEXT매크로를 사용하는 것이 바람직하다. 여기서 주의할 점은 문자열을 관리하는 기본 클래스로 언리얼 엔진은 FString 클래스를 제공하는데, FString으로 선언된 변수에서 문자열을 얻어오려면 반드시 * 연산자를 앞에 지정해줘야 한다. 다음은 이를 사용한 예시다.

FString::Printf(TEXT("Actor Name : %s, ID : %d, Location X : %.3f"), *GetName(), ID, GetActorLocation().X)

//출력 결과 - Actor Name : 액터이름, ID : 아이디, Location X : X좌표값

 

모든 로그에는 분류를 위해 카테고리가 지정된다. 이미 언리얼 엔진에는 다양한 로그 카테고리가 선언되어 있다. 하지만 개인적으로 필요한 카테고리가 필요하다면, 커스텀 카테고리를 선언하면 된다.

언리얼 엔진은 로그 카테고리를 선언하기 위해 두개의 매크로를 제공한다. 하나는 선언부에서 사용하는 DECLARE_LOG_CATEGORY_EXTERN이고, 나머지 하나는 구현부의 DEFINE_LOG_CATEGORY이다.

 

다음은 커스텀 로그 카테고리를 선언하는 예이다.

//header (선언부)
DECLARE_LOG_CATEGORY_EXTERN(MyCategory, Log, All);

//cpp (구현부)
DEFINE_LOG_CATEGORY(MyCategory);

//PlayerCharacter클래스의 Tick 메서드 부분에 로그를 출력하는 매크로를 사용.
void APlayerCharacterBase::Tick(float DeltaTime)
{
	Super::Tick(DeltaTime);
	UE_LOG(MyCategory, Warning, TEXT("Actor Name : %s"), *GetName());
}

컴파일 후 플레이를 하면 로그 출력창이 이렇게 도배된다...