docs(10_Wiki): 위키 전체 재구성 — Topic_* 폴더를 4개 카테고리로 통합 + 대규모 중복 제거
Topic_Agent/Topic_Blog/Topics/Topics_Biz/Topics_Meeting/Topics_Rag의 마크다운 지식 문서를 Topic_General/Topic_Programming/Topic_Graphic/Topic_Business 4개 카테고리로 재분류. - 중복 제거: frontmatter의 status:duplicate/merged + duplicate_of/redirect_to 필드로 자기 자신을 중복으로 선언한 리다이렉트 stub 1032개 제거, 완전 동일 내용 파일 472개 제거, 동일 파일명·다른 내용 충돌 시 더 큰(완전한) 버전만 유지(162개 제거) — 총 1639개 중복 제거. - 분류: 폴더 단위로 명확한 항목(AI_and_ML/Coding/Architecture 등 → Programming, Comfyui/Visual_Effects → Graphic, Topics_Biz/Topics_Meeting/사업 등 → Business, Poetic_Blog_Writing/창의성/Game_Design 등 → General)은 폴더 우선순위로, 나머지 혼재 폴더(Topic_Agent/Topic_Blog/Topics 루트/Thinking & Reasoning/Other/UI_UX_Assets)는 title/tags 키워드 스코어링으로 파일 단위 분류(불명확한 경우 General로 폴백). 원본 폴더명은 "From_*" 서브폴더로 보존해 추적 가능성 유지. - 최종 배치: Programming 2784 / General 1608 / Graphic 285 / Business 249 = 4926개 문서. - 에이전트 운영 상태(.astra/.agent/.obsidian/sessions/memory/_company/docs/lessons/_shared/src)는 지식 콘텐츠가 아니므로 재분류 대상에서 제외하고 원위치 유지. - Topics/Topic_email(상위 보호 폴더 Topic_email과 파일명 100% 중복) 삭제 — 보호 폴더 자체는 미변경. - 완전히 비게 된 Topic_Agent/Topic_Blog/Topics_Biz/Topics_Rag 폴더 제거.
This commit is contained in:
Antigravity Agent
@@ -0,0 +1,139 @@
|
||||
---
|
||||
id: ios-widget-extension
|
||||
title: iOS Widget — WidgetKit + Timeline
|
||||
category: Coding
|
||||
status: draft
|
||||
source_trust_level: B
|
||||
verification_status: conceptual
|
||||
created_at: 2026-05-09
|
||||
updated_at: 2026-05-09
|
||||
tags: [ios, widget, widgetkit, vibe-coding]
|
||||
tech_stack: { language: "Swift / WidgetKit / SwiftUI", applicable_to: ["iOS 14+", "macOS"] }
|
||||
applied_in: []
|
||||
aliases: [Home Screen Widget, Lock Screen, Timeline, Provider]
|
||||
---
|
||||
|
||||
# iOS Widget (WidgetKit)
|
||||
|
||||
> 홈 / 잠금 화면에 표시. **Timeline 기반** — provider 가 시점별 entry list 반환 → OS 가 시간에 맞춰 표시. 메모리 / 실행시간 엄격 제한.
|
||||
|
||||
## 📖 핵심 개념
|
||||
- Widget = Extension target.
|
||||
- TimelineProvider 가 entries 반환.
|
||||
- 각 entry = 표시할 시점 + view data.
|
||||
- OS 가 timeline 끝나면 새로 요청.
|
||||
|
||||
## 💻 코드 패턴
|
||||
|
||||
### Widget 정의
|
||||
```swift
|
||||
import WidgetKit
|
||||
import SwiftUI
|
||||
|
||||
struct StockEntry: TimelineEntry {
|
||||
let date: Date
|
||||
let symbol: String
|
||||
let price: Double
|
||||
}
|
||||
|
||||
struct StockProvider: TimelineProvider {
|
||||
func placeholder(in: Context) -> StockEntry {
|
||||
StockEntry(date: .now, symbol: "AAPL", price: 0)
|
||||
}
|
||||
func getSnapshot(in: Context, completion: @escaping (StockEntry) -> Void) {
|
||||
completion(.init(date: .now, symbol: "AAPL", price: 175.0))
|
||||
}
|
||||
func getTimeline(in: Context, completion: @escaping (Timeline<StockEntry>) -> Void) {
|
||||
Task {
|
||||
let prices = try await fetchHourlyPrices()
|
||||
let entries = prices.map { StockEntry(date: $0.time, symbol: "AAPL", price: $0.price) }
|
||||
// 다음 fetch 는 1시간 후
|
||||
completion(Timeline(entries: entries, policy: .after(.now.addingTimeInterval(3600))))
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
struct StockWidgetView: View {
|
||||
let entry: StockEntry
|
||||
var body: some View {
|
||||
VStack(alignment: .leading) {
|
||||
Text(entry.symbol).font(.headline)
|
||||
Text("$\(entry.price, specifier: "%.2f")").font(.title)
|
||||
Text(entry.date, style: .time).font(.caption)
|
||||
}
|
||||
.containerBackground(.fill, for: .widget) // iOS 17+
|
||||
}
|
||||
}
|
||||
|
||||
@main
|
||||
struct StockWidget: Widget {
|
||||
var body: some WidgetConfiguration {
|
||||
StaticConfiguration(kind: "StockWidget", provider: StockProvider()) { entry in
|
||||
StockWidgetView(entry: entry)
|
||||
}
|
||||
.configurationDisplayName("주가")
|
||||
.description("실시간 주가 표시")
|
||||
.supportedFamilies([.systemSmall, .systemMedium, .accessoryRectangular])
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### App Group — 메인 앱과 데이터 공유
|
||||
```swift
|
||||
let defaults = UserDefaults(suiteName: "group.com.example.app")
|
||||
defaults?.set(token, forKey: "shared_token")
|
||||
// Widget extension 에서도 같은 group 접근
|
||||
```
|
||||
|
||||
### Widget refresh trigger
|
||||
```swift
|
||||
// 메인 앱에서 데이터 변경 후
|
||||
WidgetCenter.shared.reloadTimelines(ofKind: "StockWidget")
|
||||
```
|
||||
|
||||
### Interactive widget (iOS 17+)
|
||||
```swift
|
||||
struct CounterWidget: View {
|
||||
let entry: CounterEntry
|
||||
var body: some View {
|
||||
VStack {
|
||||
Text("\(entry.count)")
|
||||
Button(intent: IncrementIntent()) { Image(systemName: "plus") }
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
struct IncrementIntent: AppIntent {
|
||||
static var title: LocalizedStringResource = "Increment"
|
||||
func perform() async throws -> some IntentResult {
|
||||
await Counter.shared.increment()
|
||||
return .result()
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 🤔 의사결정 기준
|
||||
| 표시 | family |
|
||||
|---|---|
|
||||
| 단일 정보 | systemSmall |
|
||||
| 차트 / list | systemMedium / Large |
|
||||
| 잠금 화면 (iOS 16+) | accessoryRectangular / accessoryCircular |
|
||||
| Live Activity | 별도 (ActivityKit) |
|
||||
| 사용자 설정 가능 (intent) | IntentConfiguration |
|
||||
|
||||
## ❌ 안티패턴
|
||||
- **Widget 안에서 무거운 fetch 동기 호출**: 시간 초과 → 빈 표시.
|
||||
- **timeline policy `.never`**: 영원히 안 갱신. `.atEnd` 또는 `.after`.
|
||||
- **너무 잦은 reload**: OS 가 budget 제한. 의미 있는 변화만.
|
||||
- **App Group 미설정**: 메인 앱 데이터 못 봄.
|
||||
- **deep link URL handler 없음**: 위젯 탭 시 메인 앱 못 열림. widgetURL.
|
||||
- **거대 image**: 메모리 한계. 작게 + caching.
|
||||
- **dark/light mode 무시**: 한쪽만 보임. SwiftUI 자동.
|
||||
|
||||
## 🤖 LLM 활용 힌트
|
||||
- App Group + WidgetCenter.reloadTimelines + intent 권장.
|
||||
- iOS 17+ interactive widget 는 AppIntent.
|
||||
|
||||
## 🔗 관련 문서
|
||||
- [[iOS_Live_Activities]]
|
||||
- [[iOS_Background_Tasks]]
|
||||
Reference in New Issue
Block a user