C++ 선언은 UHT를 거쳐 런타임 도구가 읽는 타입 정보가 된다

리플렉션 매크로는 장식이 아니라 헤더 선언을 생성 코드와 에디터·블루프린트·직렬화·GC에 전달하는 빌드 계약이다.

01

Header Macro

UCLASS, UPROPERTY, UFUNCTION으로 도구가 읽을 대상을 표시한다.

02

UHT

컴파일 전에 헤더를 분석해 타입·속성·함수 정보를 추출한다.

03

Generated Code

등록 함수와 Property 테이블을 만들어 C++ 빌드에 합친다.

04

Runtime Tools

Details, Blueprint, Serialize, GC가 같은 타입 정보를 사용한다.

include 순서

generated.h는 헤더의 마지막 include에 둔다.

본문 위치

GENERATED_BODY()를 클래스 본문 계약에 맞게 둔다.

노출 최소화

도구가 필요로 하는 멤버만 지정자로 공개한다.