리플렉션 선언은 클래스, 속성, 함수, 빌드 신호를 함께 점검한다
매크로를 많이 붙이는 것이 목표가 아니라 에디터가 알아야 할 것만 정확히 노출하는 것이 목표다.
| 계약 | 필수 조건 | 오류 때 먼저 볼 것 |
|---|---|---|
| Class | UCLASS와 GENERATED_BODY가 있다 | 엔진 타입 시스템에 등록되지 않음 |
| Property | UPROPERTY 지정자가 저장·편집·읽기 권한을 정한다 | Details 값이 보이지 않음 |
| Function | UFUNCTION이 호출, 이벤트, RPC 경로를 연다 | 노드 검색 결과가 없음 |
| Build Signal | generated.h 위치와 매크로 누락을 확인한다 | 일반 C++ 오류처럼 보이는 UHT 실패 |
리플렉션 문제는 문법보다 엔진에 어떤 정보를 공개했는지의 문제다.