AGENT SKILL

10-service

暂无简介

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

03 SKILL.md 正文

10-service — UIToastService

Status: ACTIVE AppliesTo: v11


목적

Toast system의 단일 진입점. AutoSingleton으로 등록되며, canvas bootstrap과 show 요청을 모두 담당한다.


SSOT

Code Path

framework-cs/upm/com.devian.foundation/Samples~/UIPackage/Runtime/Toast/UIToastService.cs

Class Signature

namespace Devian
{
    public sealed class UIToastService : AutoSingleton<UIToastService>
    {
        public UISettings Settings { get; }
        public ToastGroupConfig[] GetGroupConfigs();

        /// UISettings에서 canvas ID를 읽어 UIToastCanvas를 spawn/init한다.
        /// MobileApplication.onLoadCompletedAsync()에서 1회 호출.
        public void Initialize();

        public void Show(
            string message,
            string groupId = UIToastDefaults.DefaultGroupId,
            ToastType toastType = ToastType.Info);
    }
}

Initialize 동작

MobileApplication.onLoadCompletedAsync() → UIToastService.Instance.Initialize() 호출.

1. UIToastCanvas.Instance 조회
2. null이면 FindAnyObjectByType<UIToastCanvas>(FindObjectsInactive.Include)
3. 여전히 null이면:
   a. ResolveSettings() → settings.ToastCanvasId 읽기
   b. IsValid 검사 (invalid이면 return)
   c. BundlePool.Spawn<UIToastCanvas>(canvasId)
4. DontDestroyOnLoad(canvas)
5. canvas.isInitialized가 false이면 canvas.Init()

Settings 동작

1. Resources.Load<UISettings>(UISettings.ResourcesPath)
2. 없으면 warning 1회 출력
3. service 내부에 cache
4. panel은 GetGroupConfigs()를 통해 전역 group 설정을 조회
5. settings null 또는 empty면 panel 쪽 default group fallback 사용

ResolvePanel 동작

1. UIToastCanvas.Instance 조회
2. null이면 FindAnyObjectByType<UIToastCanvas>(FindObjectsInactive.Include)
3. canvas가 null이면 → return null
4. canvas.isInitialized && canvas.isInitComplete 모두 true인지 확인
5. canvas.panel이 null이면 → LogWarning, return null
6. return canvas.panel

panel이 null이면 toast 요청은 silent skip (LogWarning만 출력).


Reference

  • Overview: ../00-overview/SKILL.md
  • Canvas/Panel: ../11-canvas-panel/SKILL.md
  • Data Model: ../14-data-model/SKILL.md

04 同仓库更多 Skills