AGENT SKILL
13-ui-settings
暂无简介
适用职业设计师
- License 许可
- MIT
- 最近更新
- 2026-04-12
- Stars
- ★ 0
- Forks
- 0
03 SKILL.md 正文
13-ui-settings — UISettings
Status: ACTIVE AppliesTo: v1
Purpose
Toast/Popup/Loading 공용 전역 settings asset.
canvas ID, toast group 목록, loading canvas bootstrap 정보를 단일 ScriptableObject에 보관한다.
Code Path
framework-cs/upm/com.devian.foundation/Samples~/UIPackage/Runtime/Base/UISettings.cs
Implementation Location (3-path mirror)
| 경로 | 역할 |
|---|---|
framework-cs/upm/com.devian.foundation/Samples~/UIPackage/Runtime/Base/UISettings.cs |
UPM (정본) |
framework-cs/apps/UnityExample/Packages/com.devian.foundation/Samples~/UIPackage/Runtime/Base/UISettings.cs |
Packages (sync) |
framework-cs/apps/UnityExample/Assets/Samples/Devian Foundation/{version}/UIPackage/Runtime/Base/UISettings.cs |
Assets/Samples (import) |
Asset Path
Assets/Resources/Devian/UISettings.asset
Shape
[CreateAssetMenu(fileName = "UISettings", menuName = "Devian/UI/UI Settings")]
public sealed class UISettings : ScriptableObject
{
public const string ResourcesPath = "Devian/UISettings";
public const string DefaultResourcesAssetPath = "Assets/Resources/Devian/UISettings.asset";
// ── UI ──
public string UIAddressablesKey { get; } // default: "ui"
public UIAssetSearchEntry[] AssetSearchEntries { get; }
public string GetSearchDir(string key); // key → SearchDir lookup
public string GetResourcesSearchDir(string key); // key → Resources relative path
// ── Toast ──
public UI_TOAST_CANVAS_ID ToastCanvasId { get; }
public ToastGroupConfig[] GroupConfigs { get; }
// ── Popup ──
public UI_POPUP_CANVAS_ID PopupCanvasId { get; }
// ── Loading ──
public UI_LOADING_CANVAS_ID LoadingCanvasId { get; }
}
Rules
- UI 전체 settings의 단일 전역 source다.
UIAddressablesKey는UIManager.LoadBundlesAsync()에서 Addressables label로 사용한다.AssetSearchEntries는 UI_*_ID Selector들의 SearchDir source다.GetSearchDir(key)로 조회한다.GetResourcesSearchDir(key)는AssetSearchEntries의Assets/.../Resources/...경로를 runtimeResources.Load()경로로 변환한다.- UI_*_ID Selector는
BaseEditorUIAssetIdSelector/BaseEditorUIScriptableAssetIdSelector를 통해 이 entries를 참조한다. UIToastService와UIPopupManager가Resources.Load<UISettings>(UISettings.ResourcesPath)로 load/cache한다.MobileApplication.onBootAsync()는Resources.Load<UISettings>(UISettings.ResourcesPath)로 settings를 읽고LoadingCanvasId를 사용해UILoadingCanvas를 bootstrap한다.ToastCanvasId는 toast canvas bootstrap에 사용한다.PopupCanvasId는 popup canvas bootstrap에 사용한다.LoadingCanvasId는 loading canvas bootstrap에 사용한다.LoadingCanvasId.Value는 prefab id다.- loading runtime path는
GetResourcesSearchDir("UI_LOADING_CANVAS_ID") + "/" + LoadingCanvasId.Value로 만든다. - 현재
UI_LOADING_CANVAS_IDsearch dir는Assets/Resources/UI/Prefabs이다. GroupConfigs는 toast group 설정의 source다.
Reference
- Parent:
../../SKILL.md - Toast System:
../../13-ui-toast-system/00-overview/SKILL.md - Popup System:
../../12-ui-popup-system/00-overview/SKILL.md - Loading System:
../../11-ui-loading-system/00-overview/SKILL.md