Skip to content

[NM-447] 위젯 알람이 무음 설정을 무시하는 버그 수정 - #165

Merged
ParkMazorika merged 1 commit into
developfrom
feature/NM-447-widget-alarm-ring-mode
Sep 9, 2026
Merged

ParkMazorika merged 1 commit into
developfrom
feature/NM-447-widget-alarm-ring-mode

Conversation

@ParkMazorika

@ParkMazorika ParkMazorika commented Sep 9, 2026 •

Copy link
Copy Markdown
Contributor

관련 이슈

  • NM-447

변경 요약

위젯에서 시작한 타이머 알람이 sound: .default 로 못박혀 있어 무음 설정을 무시했다. 앱과 같은 RingModeStore 를 보도록 맞춘다.

변경 내용

증상 — 앱에서 시작하면 무음을 따르는데(AlarmKitAlarmScheduler), 위젯에서 시작하면 항상 소리로 울렸다. 야간 병동에서 무음으로 맞춰둔 간호사에게 예고 없이 소리가 난다.

값 자체는 이미 위젯이 닿을 수 있는 곳에 있었다 — RingModeStore 는 앱 그룹 UserDefaults 라 주석부터 "앱·위젯·익스텐션이 같은 값을 보도록" 이라고 적혀 있다. 닿지 못한 건 두 가지 때문이었다.

① RingModeStore 가 Core 에 있었다

Core/Sources/Utils/RingMode.swift
위젯 dependencies: [TimerShared, TimerDomain]   ← Core 없음

위젯에 Core 를 붙이면 Firebase·GoogleSignIn 까지 익스텐션에 링크된다. 그래서 Core → TimerShared 로 옮겼다. TimerShared 는 앱과 위젯이 같은 타입을 링크하려고 만든 의존성 없는 leaf 모듈이고, 이 파일은 Foundation + UserDefaults 뿐이라 그대로 들어간다. TimerFeature 는 이미 TimerShared 를 의존해서 import 한 줄씩만 늘었다(4개 파일).

② silence.caf 가 앱 번들에만 있었다

AlarmKit 의 .named(_:) 는 예약을 건 프로세스의 번들에서 찾으므로, 앱에만 있으면 위젯이 무음 사운드를 쓸 수 없다. TimerWidget 과 데모 위젯 타깃에 리소스로 넣었다.

결과

let useSound = RingModeStore.shared.current == .sound
sound: useSound ? .default : .named("silence.caf")

AlarmKitAlarmScheduler 와 동일한 규칙 — 소리=기본 알람음+진동 / 무음=무음 사운드(소리 없음, 시스템 진동은 남음).

테스트

  • 로컬 빌드/실행 확인 — tuist build App 성공
  • 정상·에러 케이스 확인 — Domain 14개 통과 (회귀 없음)
  • 번들 산출물 확인 — App.app/PlugIns/TimerWidget.appex/silence.caf 존재. ② 가 실제로 해결됐는지가 이 수정의 핵심 가정이라 빌드 결과로 직접 확인했다

실기기 검증이 남았습니다

시뮬레이터에서는 AlarmKit 알람 발화를 끝까지 확인하기 어렵습니다. 아래는 실기기(iOS 26.1+) 로 봐주세요.

  1. 설정에서 울림 방식을 무음 으로
  2. 위젯 의 프리셋으로 타이머 시작
  3. 만료 시 소리가 나지 않고 진동만 나는지
  4. 울림 방식을 소리 로 바꾸고 2~3 반복 → 소리가 나는지
  5. 앱에서 시작한 경우와 동작이 같은지

특히 3번이 핵심입니다. .named("silence.caf") 의 번들 탐색이 익스텐션 기준이라는 전제로 고쳤는데, 애플 문서가 이를 명시하지 않아 양쪽 번들에 모두 넣는 방식으로 처리했습니다. 실기기에서 무음이 확인되면 전제가 맞은 것입니다.

체크리스트

  • PR 제목이 [NM-XXX] 요약 형식
  • 브랜치명 <type>/NM-XXX-요약 형식
  • 커밋 메시지 [NM-XXX] type: 요약 형식
  • 셀프 리뷰 완료

앱에서 시작하면 RingModeStore 를 보는데(AlarmKitAlarmScheduler), 위젯에서 시작하면
sound: .default 로 못박혀 있어 항상 소리로 울렸다. 야간 병동에서 무음으로 맞춰둔
간호사에게 예고 없이 소리가 난다.

값 자체는 이미 위젯이 닿을 수 있는 곳에 있었다 — RingModeStore 는 앱 그룹
UserDefaults 라 "앱·위젯·익스텐션이 같은 값을 보도록" 만들어 둔 것이다.
닿지 못한 건 두 가지 때문이었다.

① RingModeStore 가 Core 에 있었다
   위젯 dependencies 는 [TimerShared, TimerDomain] 뿐이고, Core 를 붙이면
   Firebase·GoogleSignIn 까지 익스텐션에 링크된다. Core → TimerShared 로 옮긴다.
   TimerShared 는 앱과 위젯이 같은 타입을 링크하려고 만든 의존성 없는 leaf 모듈이라
   Foundation + UserDefaults 뿐인 이 파일의 제 자리다. TimerFeature 는 이미
   TimerShared 를 의존해서 import 한 줄씩만 늘었다.

② silence.caf 가 앱 번들에만 있었다
   AlarmKit 의 .named(_:) 는 예약을 건 프로세스의 번들에서 찾으므로, 앱에만 있으면
   위젯이 무음 사운드를 못 쓴다. TimerWidget·데모 위젯 타깃에 리소스로 넣는다.
   빌드 산출물에서 App.app/PlugIns/TimerWidget.appex/silence.caf 확인.

규칙은 AlarmKitAlarmScheduler 와 동일하게 맞췄다 —
소리=기본 알람음+진동 / 무음=무음 사운드(소리 없음, 시스템 진동은 남음).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ch9vPGGKfeTUWMKEsZ3NWM
@ParkMazorika ParkMazorika self-assigned this Sep 9, 2026
@ParkMazorika ParkMazorika added the bug Something isn't working label Sep 9, 2026
@ParkMazorika
ParkMazorika merged commit 8255eff into develop Sep 9, 2026
1 check passed
@ParkMazorika
ParkMazorika deleted the feature/NM-447-widget-alarm-ring-mode branch September 9, 2026 18:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant