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,106 @@
|
||||
---
|
||||
id: android-workmanager-patterns
|
||||
title: WorkManager — 신뢰성 있는 백그라운드 작업
|
||||
category: Coding
|
||||
status: draft
|
||||
source_trust_level: B
|
||||
verification_status: conceptual
|
||||
created_at: 2026-05-09
|
||||
updated_at: 2026-05-09
|
||||
tags: [android, workmanager, background, vibe-coding]
|
||||
tech_stack: { language: "Kotlin / WorkManager 2.9+", applicable_to: ["Android"] }
|
||||
applied_in: []
|
||||
aliases: [periodic work, one-time work, constraints, deferred]
|
||||
---
|
||||
|
||||
# WorkManager 패턴
|
||||
|
||||
> "배터리 / 네트워크 / 충전" 조건 충족 시 OS 가 알아서 실행해주는 영속 작업 큐. **process 죽어도 살아남음**. 즉각 백그라운드 작업이 아닌 "결국 실행되어야 함" 인 작업에 적합.
|
||||
|
||||
## 📖 핵심 개념
|
||||
- One-time vs Periodic (최소 15분).
|
||||
- Constraints: 네트워크 / 충전 / idle / 배터리.
|
||||
- Backoff: 실패 시 재시도 정책.
|
||||
- Unique work: 같은 이름의 작업 중복 방지.
|
||||
|
||||
## 💻 코드 패턴
|
||||
|
||||
### CoroutineWorker
|
||||
```kotlin
|
||||
@HiltWorker
|
||||
class SyncWorker @AssistedInject constructor(
|
||||
@Assisted ctx: Context,
|
||||
@Assisted params: WorkerParameters,
|
||||
private val repo: SyncRepository,
|
||||
) : CoroutineWorker(ctx, params) {
|
||||
|
||||
override suspend fun doWork(): Result = try {
|
||||
val sinceMs = inputData.getLong("since", 0L)
|
||||
repo.pullChanges(sinceMs)
|
||||
Result.success(workDataOf("count" to 42))
|
||||
} catch (e: IOException) {
|
||||
if (runAttemptCount < 3) Result.retry() else Result.failure()
|
||||
} catch (e: Exception) {
|
||||
Result.failure()
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Enqueue with constraints
|
||||
```kotlin
|
||||
val req = OneTimeWorkRequestBuilder<SyncWorker>()
|
||||
.setConstraints(Constraints.Builder()
|
||||
.setRequiredNetworkType(NetworkType.UNMETERED)
|
||||
.setRequiresCharging(true)
|
||||
.build())
|
||||
.setInputData(workDataOf("since" to lastSyncMs))
|
||||
.setBackoffCriteria(BackoffPolicy.EXPONENTIAL, 30, TimeUnit.SECONDS)
|
||||
.build()
|
||||
|
||||
WorkManager.getInstance(context)
|
||||
.enqueueUniqueWork("sync-changes", ExistingWorkPolicy.KEEP, req)
|
||||
```
|
||||
|
||||
### Periodic
|
||||
```kotlin
|
||||
val req = PeriodicWorkRequestBuilder<SyncWorker>(1, TimeUnit.HOURS)
|
||||
.setConstraints(networkConstraints)
|
||||
.build()
|
||||
WorkManager.getInstance(context)
|
||||
.enqueueUniquePeriodicWork("hourly-sync", ExistingPeriodicWorkPolicy.KEEP, req)
|
||||
```
|
||||
|
||||
### Foreground (긴 작업)
|
||||
```kotlin
|
||||
override suspend fun doWork(): Result {
|
||||
setForeground(createForegroundInfo()) // 알림 표시
|
||||
return processLongJob()
|
||||
}
|
||||
```
|
||||
|
||||
## 🤔 의사결정 기준
|
||||
| 작업 | 도구 |
|
||||
|---|---|
|
||||
| 즉시 1회 (UI 동안) | viewModelScope |
|
||||
| 화면 닫혀도 계속 (5분 이내) | Service (foreground) |
|
||||
| 결국 실행돼야 함 (나중 OK) | WorkManager one-time |
|
||||
| 주기적 (≥15분) | WorkManager periodic |
|
||||
| 긴 다운로드 + 진행 표시 | WorkManager + foreground info |
|
||||
| 특정 시각 alarm | AlarmManager (정확 시각) — WorkManager 는 시각 보장 X |
|
||||
|
||||
## ❌ 안티패턴
|
||||
- **WorkManager 를 즉시 작업에**: OS 가 지연 가능. 즉시 = Service 또는 coroutine.
|
||||
- **enqueue 대신 enqueueUnique 안 씀**: 같은 작업 중복 큐잉.
|
||||
- **Result.failure() 인데 사용자 모름**: 실패 알림 누락. observe + UI 표시.
|
||||
- **input/output Data 가 큼 (>10KB)**: Bundle 크기 한계. ID 만 전달, 본문은 DB/file.
|
||||
- **doWork 가 너무 오래 (>10분)**: OS 가 강제 종료. expedited work 또는 foreground.
|
||||
- **Hilt 통합 빠뜨림**: 의존성 주입 안 됨. HiltWorker + WorkerFactory 등록.
|
||||
- **periodic 15분 미만**: OS 가 무시.
|
||||
|
||||
## 🤖 LLM 활용 힌트
|
||||
- 상황 분류 → 작업 도구 매트릭스 먼저 그리기.
|
||||
- HiltWorker 통합 코드 같이.
|
||||
|
||||
## 🔗 관련 문서
|
||||
- [[Android_Kotlin_Coroutines_Scopes]]
|
||||
- [[Backpressure_Patterns]]
|
||||
Reference in New Issue
Block a user