2nd/10_Wiki/Topics/Coding/iOS_UIKit_AutoLayout_Patterns.md

id, title, category, status, source_trust_level, verification_status, created_at, updated_at, tags, tech_stack, applied_in, aliases

id	title	category	status	source_trust_level	verification_status	created_at	updated_at	tags	tech_stack	applied_in	aliases
ios-uikit-autolayout-patterns	UIKit AutoLayout 실전 패턴	Coding	draft	B	conceptual	2026-05-09	2026-05-09	ios uikit autolayout layout vibe-coding	language applicable_to Swift / UIKit iOS		NSLayoutAnchor priority content hugging compression resistance

UIKit AutoLayout 실전 패턴

AutoLayout 의 어려움은 (1) anchor / constraint API 자체가 아니라 (2) priority + hugging + compression resistance 의 의미와 (3) runtime 충돌 디버깅.

📖 핵심 개념

• Constraint 는 식: view1.attribute = m * view2.attribute + c
• Priority 1~1000: 1000 = required, 그 외 = optional. 충돌 시 priority 높은 게 이김.
• Content hugging: "내가 늘어나기 싫어" 강도.
• Compression resistance: "내가 줄어들기 싫어" 강도.

💻 코드 패턴

NSLayoutAnchor (UIKit native)

view.translatesAutoresizingMaskIntoConstraints = false
NSLayoutConstraint.activate([
    view.topAnchor.constraint(equalTo: superview.safeAreaLayoutGuide.topAnchor, constant: 16),
    view.leadingAnchor.constraint(equalTo: superview.leadingAnchor, constant: 16),
    view.trailingAnchor.constraint(equalTo: superview.trailingAnchor, constant: -16),
    view.heightAnchor.constraint(equalToConstant: 44),
])

Stack views (제일 자주 쓰임)

let stack = UIStackView(arrangedSubviews: [titleLabel, subtitleLabel, button])
stack.axis = .vertical
stack.spacing = 8
stack.alignment = .fill
view.addSubview(stack)
// stack 자체만 외부 constraint

Hugging / Compression — 두 label 한 줄에

// 길어지면 잘리지 말아야 할 쪽
priceLabel.setContentCompressionResistancePriority(.required, for: .horizontal)
nameLabel.setContentCompressionResistancePriority(.defaultLow, for: .horizontal)
// → name 이 "..." 잘림, price 는 풀 표시

동적 height (multiline label)

descriptionLabel.numberOfLines = 0 // 무제한
// width 만 제약, height 는 알아서
descriptionLabel.widthAnchor.constraint(equalTo: view.widthAnchor, constant: -32).isActive = true

런타임 충돌 디버그

// 충돌 시 콘솔에 "Will attempt to recover by breaking constraint ..."
// 해당 constraint 에 identifier 부여 → 추적 쉬움
let c = view.heightAnchor.constraint(equalToConstant: 44)
c.identifier = "RowMinHeight"
c.isActive = true

🤔 의사결정 기준

레이아웃	권장
정렬·간격 단순	UIStackView
복잡 비율 (golden ratio 등)	NSLayoutAnchor + multiplier
외부 라이브러리 OK	SnapKit (가독성↑)
동적 height (table cell)	label numberOfLines 0 + UITableView.automaticDimension
안전영역 / 노치	safeAreaLayoutGuide
키보드 회피	NSLayoutConstraint constant 변경 + animation

❌ 안티패턴

• translatesAutoresizingMaskIntoConstraints 끄기 잊음: 자동 frame constraint 가 충돌. 먼저 false.
• frame + autolayout 혼용: 한 view 는 한 모델. layoutSubviews 에서 frame 조작 시 autolayout 깨짐.
• 모든 priority required: 첫 충돌에 앱 crash.
• stack view 안에 0 spacing 으로 또 stack: 가독성 떨어짐. 설계 재고.
• safeAreaLayoutGuide 무시: 노치 / Dynamic Island 위에 그림.
• dynamic type 무시 (큰 글씨 설정): label 잘림. preferredFont(forTextStyle:) + adjustsFontForContentSizeCategory.
• 다국어 RTL 무시: leading/trailing (NOT left/right).

🤖 LLM 활용 힌트

• "leading/trailing 사용 (RTL 자동), top/bottom" 명시.
• 복잡 layout 은 SnapKit 또는 Stack View first.

🔗 관련 문서

• iOS_SwiftUI_State_Property_Wrappers
• iOS_SwiftUI_Lifecycle_View_Identity