[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBDBH4HHRZPXX0552KW3SR":3,"skill-same:01M6CBDBH4HHRZPXX0552KW3SR":45},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":20,"linkOnly":21,"markdownContent":22,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":13,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M6CBDBH4HHRZPXX0552KW3SR","10-ui-manager",null,"devwinsoft\u002Fdevian","devwinsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22570160?v=4","01M6C6RR8W05NH8NPKQNCE3Q72","maoshy","01M6C6RRDJ5TJJCZXRTY801YDH",0,"MIT","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F23-ui-package\u002F10-base-system\u002F10-ui-manager\u002FSKILL.md",[],[18,19],"ui","10 ui manager","2026-11-10 10:12:30",false,"# UIManager\n\nStatus: ACTIVE\nAppliesTo: v11\n\n---\n\n## Overview\n\nUI Canvas 수명주기 진입점과 UI 메시지 시스템을 제공하는 중앙 매니저.\n`AutoSingleton\u003CUIManager>` 기반이며 `Instance` 접근 시 script-created 된다.\n\n---\n\n## Scope\n\n### Includes\n- UI 번들 에셋 로드 (`LoadBundlesAsync`)\n- UI 메시지 시스템 소유 (`messageSystem`)\n- Canvas 조회 (`TryGetCanvas`)\n- Canvas 생성 (`CreateCanvas`)\n- Canvas 제거 (`DespawnCanvas`)\n- Canvas 검증 (`ValidateCanvas`)\n\n### Excludes\n- 커서 설정 (`UIUtils.SetCursor` 사용)\n- EventSystem 보장\u002F생성\n- 게임플레이 입력 (ActionMap, 리바인딩, 컨텍스트 전환)\n- 화면 스택\u002F라우팅\u002F네비게이션\n- 로컬라이제이션 정책\n\n---\n\n## SSOT\n\n### Code Path\n```\nframework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FUIPackage\u002FRuntime\u002FBase\u002FUIManager.cs\n```\n\n### Class\n```csharp\nnamespace Devian\n{\n    public sealed class UIManager : AutoSingleton\u003CUIManager>\n}\n```\n\n### Singleton Type\n- **AutoSingleton** — `Instance` 접근 시 자동 생성\n- scene\u002Fprefab 사전 부착 금지\n\n---\n\n## API\n\n### LoadBundlesAsync\n\n```csharp\npublic async Task LoadBundlesAsync()\n```\n\n- UI 번들 에셋 로드. `MobileBundleManager.LoadBundlesAsync()`에서 호출한다.\n- `UISettings.UIAddressablesKey`로 Addressables label을 결정한다.\n- transition preset preload (`AssetManager.LoadBundleAssets\u003CUITransitionPresetAsset>`) + UI GameObject 로드 (`AssetManager.LoadBundleAssets\u003CGameObject>`)를 수행한다.\n\n### messageSystem\n\n```csharp\npublic static UIMessageSystem messageSystem => Instance?.mMessageSystem;\n```\n\n- 정적 접근: `UIManager.messageSystem`\n- `UIManager` 내부 필드 `mMessageSystem`을 노출한다\n- `Instance` 접근이 `AutoSingleton` 생성을 트리거하므로 첫 접근 시 메시지 시스템도 준비된다\n- shutdown 중 `Instance`가 `null`을 반환할 수 있으므로 프로퍼티도 nullable 동작을 가진다\n\n### TryGetCanvas\n\n```csharp\npublic bool TryGetCanvas\u003CTCanvas>(out TCanvas canvas)\n    where TCanvas : MonoBehaviour\n```\n\n- `Singleton.TryGet\u003CTCanvas>`를 먼저 조회한다\n- 없으면 `FindAnyObjectByType\u003CTCanvas>(FindObjectsInactive.Include)`로 씬 전체를 탐색한다\n- inactive object도 탐색 대상이다\n\n### CreateCanvas\n\n```csharp\npublic TCanvas CreateCanvas\u003CTCanvas>(string prefabName, Transform parent = null)\n    where TCanvas : MonoBehaviour, IPoolable\n```\n\n- `BundlePool.Spawn\u003CTCanvas>(prefabName, parent: parent)`로 생성한다\n- 생성 직후 같은 타입의 기존 singleton canvas가 이미 있으면:\n  새 인스턴스를 `BundlePool.Despawn()`하고 기존 인스턴스를 반환한다\n- 타입당 1개 singleton canvas 정책을 강제하기 위한 duplicate collapse 동작이다\n\n### DespawnCanvas\n\n```csharp\npublic void DespawnCanvas\u003CTCanvas>()\n    where TCanvas : MonoBehaviour\n```\n\n- `TryGetCanvas` 성공 시 `BundlePool.Despawn(canvas)` 호출\n- poolable canvas를 대상으로 사용하는 API다\n\n### ValidateCanvas\n\n```csharp\npublic bool ValidateCanvas\u003CTCanvas>(out string reason)\n    where TCanvas : UIBaseCanvas\u003CTCanvas>\n```\n\n- canvas를 찾지 못하면 `\"Canvas of type {TCanvas} not found\"` 형식 reason을 반환한다\n- 찾으면 `canvas.Validate(out reason)`를 그대로 위임한다\n\n---\n\n## Policies\n\n### Duplicate Handling\n`CreateCanvas`는 중복 생성 시 새 인스턴스를 버리고 기존 singleton 인스턴스를 반환한다.\n\n### Responsibility Boundary\nUIManager는 canvas lifecycle\u002Fservice entry만 담당한다.\nUI utility (`SetCursor`, billboard, 좌표 변환)는 `UIUtils`로 분리되어 있다.\n\n---\n\n## Dependencies\n\n| Dependency | Location |\n|------------|----------|\n| `AutoSingleton\u003CT>` | `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FCommonPackage\u002FRuntime\u002FUnity\u002FSingletons\u002FAutoSingleton.cs` |\n| `Singleton` | `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FCommonPackage\u002FRuntime\u002FUnity\u002FSingletons\u002FSingleton.cs` |\n| `BundlePool` | `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FCommonPackage\u002FRuntime\u002FUnity\u002FPool\u002FFactory\u002FBundlePool.cs` |\n| `IPoolable` | `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FCommonPackage\u002FRuntime\u002FUnity\u002FPool\u002FIPoolable.cs` |\n| `UIBaseCanvas\u003CTCanvas>` | `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FUIPackage\u002FRuntime\u002FBase\u002FUIBaseCanvas.cs` |\n| `UIMessageSystem` | `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FUIPackage\u002FRuntime\u002FBase\u002FUIMessageSystem.cs` |\n\n---\n\n## Related Documents\n\n- [UIBaseCanvas\u002FUIBasePanel\u002FUIBaseContainer](..\u002F11-ui-canvas-system\u002FSKILL.md)\n- [UIMessageSystem](..\u002F33-ui-message-system\u002FSKILL.md)\n- [UIUtils](..\u002F50-ui-utils\u002FSKILL.md)\n- [Singleton](..\u002F..\u002F..\u002F20-common-package\u002F29-singleton\u002FSKILL.md)\n- [Pool System](..\u002F..\u002F..\u002F20-common-package\u002F27-pool-system\u002FSKILL.md)\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F23-ui-package\u002F10-base-system\u002F10-ui-manager","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft","Kim Hyong Joon","2026-04-12 18:44:10",{"source":7,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add devwinsoft\u002Fdevian --skill 10-ui-manager",{"tool":37,"command":38},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 10-ui-manager",{"tool":40,"command":41},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 10-ui-manager","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F23-ui-package\u002F10-base-system\u002F10-ui-manager\u002FSKILL.md",true,[],[46,52,60,68,77,84],{"skillNo":47,"name":48,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":49,"categories":50,"keywords":51,"publishedAt":20},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[48],{"skillNo":53,"name":54,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":20},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[58,59],"archive","90 project archive",{"skillNo":61,"name":62,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":20},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[66,67],"management","30 env management",{"skillNo":69,"name":70,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":20},"01M6CBWYD3TGWBQV7V35551THF","19-page-push-send","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F19-page-push-send\u002FSKILL.md",[],[74,75,76],"push","page","19 page push send",{"skillNo":78,"name":79,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":20},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[75,83],"18 page savedata",{"skillNo":85,"name":86,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":20},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[75,90],"17 page deobfuscate"]