[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBF95HYMNXZHDSQ1QQ9TK7":3,"skill-same:01M6CBF95HYMNXZHDSQ1QQ9TK7":51},{"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":22,"publishedAt":26,"linkOnly":27,"markdownContent":28,"markdownBody":28,"frontMatter":29,"refName":30,"commitSha":31,"skillDirectory":32,"forksCount":13,"repositoryHtmlUrl":33,"repositoryHomepageUrl":6,"ownerHtmlUrl":34,"ownerBlogUrl":6,"ownerDescription":35,"updatedAt":36,"install":37,"resources":50},"01M6CBF95HYMNXZHDSQ1QQ9TK7","13-ui-component-size-fitter",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\u002F20-ui-components\u002F13-ui-component-size-fitter\u002FSKILL.md",[17],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000032","设计师","PROFESSION","适用职业",[23,24,25],"component","ui","13 ui component size fitter","2026-11-10 10:12:30",false,"# 13-ui-component-size-fitter\n\nStatus: ACTIVE\nAppliesTo: v11\n\n## Purpose\n\n`UIComponentBaseSizeFitter` 계열은 `RectTransform` 크기\u002F레이아웃을 화면 기준으로 자동 보정하는\n`ExecuteAlways` UI 컴포넌트 묶음이다.\n\n이 스킬은 아래 2개를 통합한다.\n\n- `UIComponentSafeSizeFitter` — safe area 기준 anchor\u002Foffset 보정\n- `UIComponentCanvasSizeFitter` — `Image`를 부모\u002Fcanvas 영역에 비율 유지로 맞춤\n\n같은 `GameObject`에 size-fitter 계열을 2개 이상 붙이는 것은 지원하지 않는다.\n조합이 필요하면 `parent = safe`, `child = canvas\u002Fimage fit` 계층으로 분리한다.\n\n## Scope\n\n### Includes\n- `UIComponentBaseSizeFitter : UIComponentBase`\n- baseline layout capture \u002F restore\n- disable \u002F domain reload 시 baseline 복원\n- `OnEnable` \u002F parent 변경 \u002F 해상도 변경 \u002F orientation 변경 refresh\n- world-space canvas no-op\n- same-object size-fitter 중복 guard\n- `UIComponentSafeSizeFitter`\n- `UIComponentCanvasSizeFitter`\n\n### Excludes\n- `LayoutGroup`과의 우선순위 조정\n- 같은 `GameObject`에서 safe fit + canvas fit 동시 적용\n- image crop \u002F mask \u002F shader 보정\n- device-specific safe area override\n\n## SSOT\n\n### Code Path\n\n```text\nframework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FUIPackage\u002FRuntime\u002FComponent\u002F\n├── UIComponentBase.cs\n├── UIComponentBaseSizeFitter.cs\n├── UIComponentSafeSizeFitter.cs\n└── UIComponentCanvasSizeFitter.cs\n```\n\n### Classes\n\n```csharp\nnamespace Devian\n{\n    public abstract class UIComponentBaseSizeFitter : UIComponentBase\n    {\n        public RectTransform Target { get; }\n        public void Refresh();\n    }\n\n    public sealed class UIComponentSafeSizeFitter : UIComponentBaseSizeFitter\n    {\n        public enum SafeAreaApplyMode\n        {\n            Anchor,\n            Offset,\n        }\n    }\n\n    public sealed class UIComponentCanvasSizeFitter : UIComponentBaseSizeFitter\n    {\n        public enum CanvasSizeFitMode\n        {\n            Inner,\n            Outer,\n        }\n    }\n}\n```\n\n## Common Base\n\n### Responsibilities\n\n- `UIComponentBase` lifecycle 통합\n- baseline capture \u002F restore\n- `Refresh()` 진입 전 baseline 복원 후 재계산\n- `WorldSpace` canvas early return\n- editor domain reload 전 baseline 복원\n- same-object 중복 size-fitter warning\n- `OnValidate`에서 `EditorApplication.delayCall`로 Refresh 지연 (SendMessage 경고 방지)\n- `onInit`에서 `isActiveAndEnabled` guard — 비활성화 상태면 Refresh를 건너뛰고 `OnEnable` 시 실행\n\n### Serialized Base Fields\n\n```csharp\n[SerializeField] private bool _refreshOnEnable = true;\n[SerializeField] private bool _refreshOnResolutionChange = true;\n[SerializeField] private bool _refreshOnOrientationChange = true;\n\n[SerializeField, HideInInspector] private RectTransform _baselineTarget;\n[SerializeField, HideInInspector] private Vector2 _baselineAnchorMin;\n[SerializeField, HideInInspector] private Vector2 _baselineAnchorMax;\n[SerializeField, HideInInspector] private Vector2 _baselineOffsetMin;\n[SerializeField, HideInInspector] private Vector2 _baselineOffsetMax;\n[SerializeField, HideInInspector] private Vector2 _baselineSizeDelta;\n[SerializeField, HideInInspector] private bool _hasBaseline;\n```\n\n## UIComponentSafeSizeFitter\n\n### Behavior\n\n- target은 self `RectTransform`\n- safe area source:\n  - runtime: `Screen.safeArea`\n  - editor: simulation profile\n- `Anchor`:\n  - safe rect를 0..1 anchor로 변환 (apply 체크된 edge만)\n  - non-applied edge의 anchor는 원본 유지\n- `Offset`:\n  - safe inset을 `offsetMin\u002FoffsetMax`에 반영 (apply 체크된 edge만)\n  - non-applied edge의 offset은 원본 유지\n- non-applied edge 보호:\n  - `CaptureCustomRefreshState`에서 baseline restore 전 rect 스냅샷(`_preRestore`)을 캡처\n  - `ApplySizeFitter` 말미에 `RestoreNonAppliedEdges`로 non-applied edge의 anchor+offset을 `_preRestore`로 복원\n  - `_preservePreRestore` 플래그로 `onInit` \u002F `OnDisable→OnEnable` 경로에서 `_preRestore` 오염 방지\n- 마지막 적용 상태:\n  - `LastAppliedSafeArea`\n  - `LastOrientation`\n  - `IsApplied`\n\n### Policy\n\n- 전체 safe root, HUD bar, 화면 모서리 버튼 루트에 사용\n- 배경 이미지 stretch 용도에는 직접 쓰지 않는다\n\n## UIComponentCanvasSizeFitter\n\n### Required Component\n\n- `Image` (`RequireComponent(typeof(Image))`)\n\n### Behavior\n\n- source image:\n  - `overrideSprite` 우선\n  - 없으면 `sprite`\n- fitting area:\n  - 우선 parent `RectTransform.rect.size`\n  - 없으면 root canvas rect\n- sprite 비율을 유지한다\n- `Inner`:\n  - contain\n  - fitting area 안에 완전히 들어오면서 가장 크게 맞춤\n- `Outer`:\n  - cover\n  - fitting area 전체를 덮으면서 가장 작게 맞춤\n- `RectTransform.SetSizeWithCurrentAnchors()`로 width\u002Fheight만 반영한다\n\n### Policy\n\n- fullscreen\u002Fbackground image, splash image, banner image에 사용\n- safe area와 같이 써야 하면 parent에 `UIComponentSafeSizeFitter`, child image에 `UIComponentCanvasSizeFitter`를 둔다\n- 같은 `GameObject`에 2개 이상 size-fitter를 붙이지 않는다\n\n## Naming\n\n- 사용자 요구의 `outter`는 오탈자로 보고 enum 값은 `Outer`를 사용한다.\n- `UIComponentCanvasSizeFitter`는 raw screen pixel이 아니라 canvas-space fitting을 의미한다.\n\n## Reference\n\n- Parent: [00-overview](..\u002F00-overview\u002FSKILL.md)\n- Base: [10-ui-component-base](..\u002F10-ui-component-base\u002FSKILL.md)\n- Debug: [UIComponentSafeSizeFitter_Debug_Guide](.\u002FUIComponentSafeSizeFitter_Debug_Guide.md)\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F23-ui-package\u002F20-ui-components\u002F13-ui-component-size-fitter","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":38,"prompt":48,"zipAvailable":49},[39,42,45],{"tool":40,"command":41},"npx","npx skills add devwinsoft\u002Fdevian --skill 13-ui-component-size-fitter",{"tool":43,"command":44},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 13-ui-component-size-fitter",{"tool":46,"command":47},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 13-ui-component-size-fitter","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F23-ui-package\u002F20-ui-components\u002F13-ui-component-size-fitter\u002FSKILL.md",true,[],[52,58,66,74,83,90],{"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":26},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[54],{"skillNo":59,"name":60,"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":61,"categories":62,"keywords":63,"publishedAt":26},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[64,65],"archive","90 project archive",{"skillNo":67,"name":68,"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":69,"categories":70,"keywords":71,"publishedAt":26},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[72,73],"management","30 env management",{"skillNo":75,"name":76,"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":77,"categories":78,"keywords":79,"publishedAt":26},"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",[],[80,81,82],"push","page","19 page push send",{"skillNo":84,"name":85,"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":86,"categories":87,"keywords":88,"publishedAt":26},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[81,89],"18 page savedata",{"skillNo":91,"name":92,"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":93,"categories":94,"keywords":95,"publishedAt":26},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[81,96],"17 page deobfuscate"]