AGENT SKILL

10-ui-manager

暂无简介

License 许可
MIT
所属仓库
devwinsoft/devian
最近更新
2026-04-12
Stars
★ 0
Forks
0

03 SKILL.md 正文

UIManager

Status: ACTIVE AppliesTo: v11


Overview

UI Canvas 수명주기 진입점과 UI 메시지 시스템을 제공하는 중앙 매니저. AutoSingleton<UIManager> 기반이며 Instance 접근 시 script-created 된다.


Scope

Includes

  • UI 번들 에셋 로드 (LoadBundlesAsync)
  • UI 메시지 시스템 소유 (messageSystem)
  • Canvas 조회 (TryGetCanvas)
  • Canvas 생성 (CreateCanvas)
  • Canvas 제거 (DespawnCanvas)
  • Canvas 검증 (ValidateCanvas)

Excludes

  • 커서 설정 (UIUtils.SetCursor 사용)
  • EventSystem 보장/생성
  • 게임플레이 입력 (ActionMap, 리바인딩, 컨텍스트 전환)
  • 화면 스택/라우팅/네비게이션
  • 로컬라이제이션 정책

SSOT

Code Path

framework-cs/upm/com.devian.foundation/Samples~/UIPackage/Runtime/Base/UIManager.cs

Class

namespace Devian
{
    public sealed class UIManager : AutoSingleton<UIManager>
}

Singleton Type

  • AutoSingleton — Instance 접근 시 자동 생성
  • scene/prefab 사전 부착 금지

API

LoadBundlesAsync

public async Task LoadBundlesAsync()
  • UI 번들 에셋 로드. MobileBundleManager.LoadBundlesAsync()에서 호출한다.
  • UISettings.UIAddressablesKey로 Addressables label을 결정한다.
  • transition preset preload (AssetManager.LoadBundleAssets<UITransitionPresetAsset>) + UI GameObject 로드 (AssetManager.LoadBundleAssets<GameObject>)를 수행한다.

messageSystem

public static UIMessageSystem messageSystem => Instance?.mMessageSystem;
  • 정적 접근: UIManager.messageSystem
  • UIManager 내부 필드 mMessageSystem을 노출한다
  • Instance 접근이 AutoSingleton 생성을 트리거하므로 첫 접근 시 메시지 시스템도 준비된다
  • shutdown 중 Instance가 null을 반환할 수 있으므로 프로퍼티도 nullable 동작을 가진다

TryGetCanvas

public bool TryGetCanvas<TCanvas>(out TCanvas canvas)
    where TCanvas : MonoBehaviour
  • Singleton.TryGet<TCanvas>를 먼저 조회한다
  • 없으면 FindAnyObjectByType<TCanvas>(FindObjectsInactive.Include)로 씬 전체를 탐색한다
  • inactive object도 탐색 대상이다

CreateCanvas

public TCanvas CreateCanvas<TCanvas>(string prefabName, Transform parent = null)
    where TCanvas : MonoBehaviour, IPoolable
  • BundlePool.Spawn<TCanvas>(prefabName, parent: parent)로 생성한다
  • 생성 직후 같은 타입의 기존 singleton canvas가 이미 있으면: 새 인스턴스를 BundlePool.Despawn()하고 기존 인스턴스를 반환한다
  • 타입당 1개 singleton canvas 정책을 강제하기 위한 duplicate collapse 동작이다

DespawnCanvas

public void DespawnCanvas<TCanvas>()
    where TCanvas : MonoBehaviour
  • TryGetCanvas 성공 시 BundlePool.Despawn(canvas) 호출
  • poolable canvas를 대상으로 사용하는 API다

ValidateCanvas

public bool ValidateCanvas<TCanvas>(out string reason)
    where TCanvas : UIBaseCanvas<TCanvas>
  • canvas를 찾지 못하면 "Canvas of type {TCanvas} not found" 형식 reason을 반환한다
  • 찾으면 canvas.Validate(out reason)를 그대로 위임한다

Policies

Duplicate Handling

CreateCanvas는 중복 생성 시 새 인스턴스를 버리고 기존 singleton 인스턴스를 반환한다.

Responsibility Boundary

UIManager는 canvas lifecycle/service entry만 담당한다. UI utility (SetCursor, billboard, 좌표 변환)는 UIUtils로 분리되어 있다.


Dependencies

Dependency Location
AutoSingleton<T> framework-cs/upm/com.devian.foundation/Samples~/CommonPackage/Runtime/Unity/Singletons/AutoSingleton.cs
Singleton framework-cs/upm/com.devian.foundation/Samples~/CommonPackage/Runtime/Unity/Singletons/Singleton.cs
BundlePool framework-cs/upm/com.devian.foundation/Samples~/CommonPackage/Runtime/Unity/Pool/Factory/BundlePool.cs
IPoolable framework-cs/upm/com.devian.foundation/Samples~/CommonPackage/Runtime/Unity/Pool/IPoolable.cs
UIBaseCanvas<TCanvas> framework-cs/upm/com.devian.foundation/Samples~/UIPackage/Runtime/Base/UIBaseCanvas.cs
UIMessageSystem framework-cs/upm/com.devian.foundation/Samples~/UIPackage/Runtime/Base/UIMessageSystem.cs

Related Documents

04 同仓库更多 Skills