현지화 키 디버그 컬처(localization key debug culture) 는 현지화된 텍스트를 디버깅하는 데 도움이 되는 특수한 현지화 컬처입니다. 애플리케이션의 컬처를 keys 의 값으로 설정하면 UI에 현지화된 모든 텍스트는 표시 텍스트가 아닌 현지화 키를 표시합니다. 여기에는 스트링 테이블을 사용하여 현지화된 텍스트와 C++에서 LOCTEXT 매크로를 통해 현지화된 텍스트가 모두 포함됩니다. 이를 통해 문제가 있을 수 있는 현지화된 텍스트를 더 쉽게 확인할 수 있으며, 복잡한 UI에서 특히 유용합니다. 그 이유는 표시된 텍스트의 맥락에서 키를 직접 관찰하면서 테이블과 빠르게 대조해볼 수 있기 때문입니다.
현지화 키 디버그 컬처를 사용하는 단계는 다음과 같습니다.
- 다음 중 하나를 수행합니다.
-
애플리케이션의 개발 빌드나 디버그 빌드를 실행합니다. 자세한 내용은 [패키징] 섹션에서 확인할 수 있습니다.
-
언리얼 에디터 에서 에디터에서 플레이(Play In Editor) 를 사용하여 애플리케이션을 실행합니다.
언리얼 에디터의 콘솔에서 현지화 컬처를 변경하면 에디터의 텍스트뿐만 아니라 프리뷰 내 텍스트에 사용되는 언어도 변경됩니다. 환경을 깨끗하게 유지하고 혼란을 피하려면 언리얼 에디터에서 실행하는 것보다 개발 빌드나 디버그 빌드를 사용하는 것이 좋습니다.
-
물결(~ ) 키를 탭하여 콘솔 을 불러옵니다.
-
다음 명령을 입력하고 Enter를 누릅니다.
-culture=keys
이 명령을 입력하면 UI에 현지화된 모든 텍스트가 일반 텍스트가 아닌 키로 표시됩니다.
키 디버그 컬처가 활성화된 라이라(Lyra) 메인 메뉴의 예입니다. Slate.LogPaintedText 가 true로 설정되어 있으므로 로그가 프리뷰에서 페인팅된 텍스트의 전체 현지화 키를 표시합니다.
전체 현지화 키 표시하기
Slate.LogPaintedText 를 1이나 true 로 설정하여 현재 화면에 페인팅된 모든 텍스트를 로그가 인쇄하게 만들 수 있습니다. 그러면 UI 클리핑 문제없이 전체 현지화 키를 확인할 수 있습니다.