C++ 선언은 UHT를 지나 에디터가 읽는 메타데이터가 된다
리플렉션 매크로는 장식이 아니라 Header에서 생성 코드, 타입 정보, 도구 노출로 이어지는 계약이다.
| 파이프라인 | 일어나는 일 | 확인할 규칙 |
|---|---|---|
| Header Macro | UCLASS, UPROPERTY, UFUNCTION으로 대상을 표시한다 | GENERATED_BODY 위치 |
| UHT | 빌드 전 헤더를 읽어 타입 정보를 추출한다 | generated.h 마지막 include |
| Generated Code | 등록 함수와 Property table이 붙는다 | 컴파일 오류가 일반 C++보다 먼저 난다 |
| Runtime Tools | Details, Blueprint, Serialize, GC가 같은 정보를 읽는다 | 필요한 노출만 열려 있다 |
보이지 않는 문제는 매크로 개수보다 UHT가 읽을 수 있는 선언 계약부터 확인한다.