Watch Pomodoro Timer — Overview

Android 모바일 앱과 Wear OS 워치 앱을 함께 제공하는 포모도로 타이머입니다. 모바일과 워치 어느 쪽에서도 독립적으로 타이머를 실행할 수 있고, 기록은 두 기기에서 공유됩니다.

현재 제품 지원·배포 범위는 Android phone과 Wear OS입니다. 저장소의 ios/ 디렉터리는 현재 사용·빌드·배포하지 않는 iOS/watchOS 보관용 프로젝트이며 제품 범위에 포함되지 않습니다.

워치 타이머 만료 구조

• Wear OS는 실행 중 elapsedRealtime deadline을 ticker와 exact AlarmManager가 함께 감시합니다. 세션 generation을 저장해 먼저 도착한 유효 경로만 완료하며, 재부팅 뒤에는 별도 wall-clock deadline으로 미래 알람만 복원합니다.
• Wear foreground service는 정확 알람 기반 타이머·햅틱 용도의 systemExempted 타입을 사용합니다. Play Console 정책 선언은 배포 전에 별도로 확인해야 합니다.

주요 기능

• 루틴 — 기존 사용자 설정을 보존한 편집 가능한 기본 루틴과 이름을 붙인 루틴 최대 5개를 제공합니다. 첫 화면과 설정 상단의 선택기는 하나의 목록에서 선택·추가·이름 변경·삭제를 제공합니다. 추가는 현재 선택값을 복사하고 이름만 입력한 뒤 저장을 누르면 새 루틴을 선택합니다. 이름 변경도 저장 버튼으로 확정하며 취소하면 변경을 버립니다. 편집 아이콘으로는 이름만 바꾸고 시간·세션 수는 설정 화면에서만 변경합니다. 선택 자체로 타이머를 시작하지 않습니다. 설정의 네 값은 선택 루틴에 자동 저장되고 선택은 중지 후에도 유지됩니다. 선택 이름과 네 값을 함께 Wear OS에 전달해 양쪽의 새 타이머 시작에 사용하며, 실행·일시정지한 타이머는 시작 당시 값을 유지합니다. Wear OS에는 선택 화면이 없습니다.

• 포모도로 타이머 — 작업/휴식/긴 휴식 3단계 루프. 세션 수와 각 단계 길이를 사용자 지정

• 모바일 타이머 — monotonic deadline을 포그라운드 ticker와 elapsed-realtime AlarmManager가 함께 감시하며, generation으로 중복 만료를 방지. Doze·프로세스 재생성·재부팅 복구 지원

• 워치 독립 타이머 — 모바일 없이 워치 단독 사용 가능

• 홈 화면 위젯 — 2x2 / 4x4 크기로 타이머 상태 확인 및 제어 (v7.0.0+)

• 워치페이스 컴플리케이션 — 오늘의 완료 세션 수를 워치페이스에 표시

• 통계 대시보드 — 일간/주간 집중 시간, 시간대별 패턴, 연속 기록, 월별 잔디 차트

• 집중 라벨 — 작업 세션을 업무·공부·프로젝트 등 하나의 라벨로 기록하고 기록 카드에 표시

• 동기 부여 인용구 — 타이머 시작 시 짧은 인용구 (v5.0.0+)

• 온보딩 — 첫 실행 시 가이드

기술 스택

• 모바일 앱: Kotlin, Fragment, ViewBinding + DataBinding, ViewModel, LiveData, DataStore (Preferences), Gson, Material Components
• 워치 앱: Kotlin, Jetpack Compose for Wear OS, Horologist, Wear Complications API
• 기기 간 통신: Wear Data Layer (MessageClient, DataClient)
• 백그라운드 실행: Foreground Service (specialUse), AlarmManager.setExact() + USE_EXACT_ALARM
• 수익화: Google AdMob, Google Play Billing, User Messaging Platform (GDPR)
• 최소 SDK: 26 (앱), 30 (워치)

아키텍처 요약

• 모바일 앱은 단일 MainActivity 하위에 MainFragment / SettingsFragment / TimerRecordsFragment 구조
• 공유 ViewModel(MainViewModel)이 설정과 타이머 기록 LiveData를 관리
• 타이머 기록은 모바일·Wear OS의 Room timer_records 테이블에 저장하며 nullable 라벨 스냅샷을 포함
• 설정은 SharedPreferences("MySettings")에 저장
• 라벨 목록은 모바일에서 JSON으로 관리하고 별도 버전 Data Layer 메시지로 Wear OS에 전달
• 모바일/워치 기록 충돌은 타임스탬프 ±5분 + 동일 타이머 타입 기준으로 모바일 우선 병합