Quick Comparison
기존 Canvas·Prefab·world-space 자산은 uGUI가, 새 UXML·USS·panel 중심 화면과 Editor·runtime 공통 구조는 UI Toolkit이 적합합니다.
| 먼저 답할 질문 | 더 자주 맞는 선택 |
|---|---|
| 기존 Canvas·Prefab·world-space UI를 유지하는가 | uGUI |
| 새 화면을 UXML/USS와 panel 중심으로 설계하는가 | UI Toolkit |
| 3D geometry에 UI를 렌더 텍스처로 표시할 수 있는가 | UI Toolkit Target Texture 검토 |
| Button, Slider, Canvas 자산을 그대로 재사용하는가 | uGUI |
| Editor 도구와 runtime 화면이 구조/스타일을 공유하는가 | UI Toolkit 검토 |
- Unity 6.5에서 UI Toolkit은 Editor와 runtime UI를 지원하지만, “최신이므로 모든 런타임 UI의 자동 정답”은 아닙니다. 기존 에셋, input, rendering, 화면 수명주기를 먼저 봅니다.
- uGUI는 Canvas·RectTransform·GraphicRaycaster의 scene workflow가 강점이고, UI Toolkit은 UIDocument·PanelSettings·visual tree·USS의 panel workflow가 강점입니다.
경계와 선택
- uGUI: World Space Canvas, prefab 기반 UI, 기존 animation/asset/third-party UI와의 결합이 필요한 경우 비용이 낮습니다. Canvas rebuild, Raycast Target, layout 설정을 팀이 이미 관리하고 있다면 전환 자체가 이득인지 따져야 합니다.
- UI Toolkit: UXML template, USS style reuse, ListView, UI Builder, Editor extension과의 공통 작업 방식이 필요한 새 화면에 잘 맞습니다.
UIDocument와PanelSettings를 명시해 panel의 scale·sort·input policy를 코드와 별도로 관리합니다. - Target Texture: PanelSettings는 UI를 Render Texture에 렌더링해 3D geometry에 표시하는 경로를 제공합니다. 이는 uGUI World Space Canvas의 즉시 대체가 아니므로 camera, texture mapping, pointer position 변환, 해상도 비용을 prototype에서 확인한 뒤 채택합니다.
- 혼용: 한 화면에 둘을 섞을 수 있다는 사실만으로 경계를 흐리게 두지 않습니다. 예를 들어 HUD는 uGUI, settings menu는 UI Toolkit처럼 화면 단위로 owner를 나누고, 어느 system이 pointer/focus와 popup stacking을 소유하는지 기록합니다.
마이그레이션 점검
- 기존 화면의 Canvas, prefab, animation, event, world-space 의존성을 목록으로 만듭니다.
- 새 UI Toolkit 화면에는 UXML, USS, UIDocument, PanelSettings, input/focus 소유자를 같이 정의합니다.
- uGUI와 UI Toolkit이 같은 화면에 보이면 rendering 순서, pointer 차단, keyboard/gamepad focus, 해상도 변경을 실제 target에서 테스트합니다.
- 한 화면의 기능·시각·입력 회귀가 없을 때만 다음 화면을 옮깁니다.
자주 틀리는 부분
UI Toolkit의 data binding을 “모든 model 변경을 자동 감지한다”로 이해하면 안 됩니다. binding source와 변경 통지 방식이 맞아야 합니다. 작은 화면 controller는 explicit update가 더 예측 가능할 수 있습니다.
uGUI를 바로 제거하지 마세요. Canvas와 UIDocument는 render·input·focus·layout 모델이 다릅니다. 새 화면을 하나씩 옮기며 경계를 검증하는 방식이 전체 UI를 한 번에 교체하는 것보다 안전합니다.
참고 링크
2 sources