개발 이야기2026년 11월 4일

가독 모바일 알림 일지

가독 모바일 알림 일지

11월 4일 오전 11시 13분, 가독 채팅방에 이런 메시지를 남겼다.

아이폰 쪽은 알림 정상화됨
그리고 그 우리 웹뷰라서 딴 쪽에서 읽으면 알림 사라지는 거 fcm이랑 연동된 듯? 카톡처럼
이런 또 처음이네

아이폰에 알림이 오기 시작했을 때 써 둔 메시지다. 다른 기기에서 대화를 읽었더니 아이폰에 떠 있던 알림도 사라졌다. 처음엔 FCM을 붙이면 여기까지 알아서 해 주나 싶었다. (생각해 보니 FCM한테 너무 많은 걸 기대한 것 같다...)

막상 만들어 보니 푸시를 보내는 것보다 이미 뜬 알림을 지우는 쪽에 손이 더 갔다. PC에서 읽은 메시지를 아이폰은 어떻게 알아볼까? 그사이에 같은 방에 새 메시지가 왔다면 그 알림은 남겨 둬야 했다. 어떤 알림까지 지워도 되는지 정하고 잠긴 아이폰에서 시험해 본 이야기는 가독 읽은 알림 지우기에 따로 적었다.

그날 아침엔 일단 내 아이폰에 알림부터 띄워야 했다. 처음 앱을 켰을 때 권한을 어떻게 물어볼지, 잠금화면에 메시지를 어디까지 보여 줄지부터 손봤다.

가독 모바일 앱의 알림 구조

가독 iOS·Android 앱은 gadoc.kr을 웹뷰로 띄우는 구조다. 로그인, 채팅, 문서, 이슈처럼 공통으로 쓰는 화면은 웹에서 만들고, 모바일 앱은 알림이나 권한, 파일과 외부 링크 처리처럼 기기와 연결이 필요한 부분을 맡는다. 데스크톱에서도 일렉트론으로 같은 웹을 띄운다.

가독의 모바일 푸시는 iOS에서 APNs, Android에서 FCM을 거친다. 가독 서버는 Expo 푸시 서비스로 요청을 보내고, Expo가 이를 APNs나 FCM으로 전달한다.

웹뷰 안에서는 휴대폰의 알림 목록을 직접 가져와 지울 수 없기 때문에 웹과 앱 사이에 브릿지도 필요했다. 웹에서 읽음 상태를 확인하면 브릿지로 앱에 알리고, 앱이 기기에 남은 알림을 정리하는 방식이다.

먼저 알림 권한부터 확인했다

아침에는 아이폰에서 알림이 오지 않았다. 뭐가 문제인지 설정부터 하나씩 살펴봤다. 휴대폰에서 알림 권한을 허용했는지, 앱이 푸시를 받을 수 있게 등록됐는지, 워크스페이스의 알림 설정은 켜져 있는지 확인해야 했다.

iOS의 알림 권한 요청은 첫 선택을 기억한다. 한 번 거부하면 같은 요청을 다시 호출해도 시스템 허용 창이 다시 뜨지 않는다. 이때는 사용자가 설정 앱에서 직접 허용해야 한다. 그런데 처음 앱을 켰을 때 왜 알림 권한이 필요한지 모른 채 거부할 수도 있겠다는 생각이 들었다.

그래서 로그인 후 처음 권한을 요청할 때는 시스템 창을 띄우기 전에 안내 화면을 먼저 보여 주도록 했다. 멘션이나 DM, 답글 알림을 받는 데 왜 권한이 필요한지 먼저 보고 선택할 수 있게 했다.

아직 푸시가 등록되지 않은 기기에는 워크스페이스 머리글 아래에 배너도 띄운다. "나중에"를 누르면 다음 실행, 하루 뒤, 3일 뒤, 이후에는 일주일 간격으로 다시 안내한다. 매번 앱을 열 때마다 보여 주면 알림을 켜기 전에 배너부터 닫게 되지 않을까. (나라도 그럴 것 같다...)

이미 권한을 거부했다면 설정 앱의 알림 메뉴로 가야 한다는 점을 알려 준다. 새 앱에서는 버튼을 눌러 설정 화면으로 바로 이동할 수도 있게 했다. 앱이 권한 상태를 웹에 전달하므로 가독의 알림 설정에서도 켜짐, 꺼짐, 차단됨, 등록 실패를 구분해서 볼 수 있다.

그날 아침에는 "워크스페이스 설정 가서 알림 허용 누르면 되긴 할 거"라고 답했었고, 설정을 확인한 뒤 아이폰에서도 알림이 다시 오기 시작했다.

잠금화면에서 보이는 내용도 바꿨다

원래 가독 푸시는 내용이 밖으로 보이는 게 걱정돼서 "새 알림이 있습니다. 앱에서 확인해 주세요."라는 문구만 보냈다.

그런데 직접 써 보니 누가 무엇을 보냈는지 알 수 없어서 알림이 올 때마다 앱을 열어야 했다. 급하게 확인해야 하는 메시지인지도 알 수 없었고. 그래서 설정에서 미리보기를 켠 경우에는 내용을 조금 보여 주도록 바꿨다.

채널 메시지는 #채널 · 보낸 사람, DM은 보낸 사람 (DM) 형태로 제목을 만든다. 본문은 서식을 제거한 평문으로 보내고, 멘션은 @이름, 첨부 파일은 [파일] 이름으로 바꾼 뒤 약 120자에서 자른다. 멘션이나 답글, 이슈 배정과 회의 알림 등도 종류를 구분할 수 있도록 한 줄로 요약한다.

미리보기를 켜면 메시지 일부가 Expo와 Apple·Google의 푸시 서비스를 거쳐 잠금화면에도 표시될 수 있다. 그래서 워크스페이스 설정에서 이 점을 안내하고 미리보기를 끌 수 있게 했다. 끄면 이전처럼 내용 없는 알림을 보낸다.

서버에서는 받는 사람의 권한과 차단 여부, 알림 설정을 확인한 뒤 발송할 때 내용을 읽는다. 발송 대기열에는 본문을 저장하지 않도록 했다. 미리보기를 만드는 데 실패한 경우에도 내용 없는 알림으로 대체한다.

PC에서 읽은 알림을 휴대폰에서도 지우기

가독을 PC와 휴대폰에서 같이 쓰다 보니 이미 읽은 내용인데도 폰의 알림은 그대로 남아 있는 게 신경 쓰였다. 나중에 휴대폰을 열면 읽은 알림을 다시 하나씩 지워야 했기 때문이다. 카톡에서는 자연스럽게 되던 동작이라 가독에서도 만들어 보기로 했다.

먼저 휴대폰이 어떤 알림을 지워야 하는지 알아볼 수 있어야 했다. 그래서 알림을 보낼 때 데이터에 묶음 표식인 ct와 원본 시각인 at을 함께 넣었다. 채널이나 이슈, 문서 같은 범위와 받는 사람을 기준으로 HMAC 표식을 만들어 쓰기 때문에 푸시에 내부 ID가 그대로 들어가지는 않는다.

시각을 함께 넣은 이유도 있다. PC에서 대화를 읽은 직후에 새 메시지가 도착할 수 있는데, 같은 채널의 알림을 전부 지우면 아직 읽지 않은 새 알림까지 사라지기 때문이다. 그래서 서버가 읽음 기준 시각을 보내면 앱은 표식과 원본 생성 시각을 비교해서 지운다. 폰에 도착한 시간이 아니라 메시지나 알림이 만들어진 시간이 기준이다.

서버는 읽음 상태를 소켓과 무음 푸시로 전달한다. 앱의 실행 상태에 따라 처리할 수 있는 경로가 달라진다.

MERMAID

앱이 열려 있고 웹뷰의 소켓이 연결되어 있으면 서버가 notification:mobile_clear 이벤트를 보낸다. 웹이 이 이벤트를 받아 브릿지로 앱에 넘기고, 앱은 조건에 맞는 알림을 dismissNotificationAsync로 지운 뒤 배지도 조정한다.

앱이 백그라운드에 있으면 소켓만으로는 전달하기 어렵다. 이때를 위해 표식과 기준 시각을 담은 무음 푸시도 보낸다. iOS에는 content-available 백그라운드 푸시로, Android에는 데이터 전용 메시지로 전달한다. 앱이 푸시를 받아 백그라운드 작업을 실행할 수 있을 때 같은 기준으로 알림을 지우는 방식이다.

구현하면서 푸시를 너무 자주 보내지 않는 방법도 고민했다. 채팅방을 옮길 때마다 읽음이 생길 수 있어서, 같은 사용자의 요청을 2초 동안 모아 한 번에 보내고 발송 간격은 최소 5초로 두었다. 한 번에 담는 표식은 최대 24개다. 이전에 해당 표식으로 보낸 알림이 없다면 지우기 푸시도 생략한다. 발송 기록은 약 7일 동안 보관한다.

예전 앱과의 호환성도 필요했다. 오래된 Android 빌드에서 처리하지 못하는 데이터 푸시가 빈 알림으로 표시될 수 있었기 때문이다. 그래서 새 빌드가 푸시를 등록할 때 clear-v1 지원 여부를 함께 보내고, 서버는 이를 지원하는 기기에만 지우기 푸시를 보낸다. 알림을 눌러 대화에 들어갔을 때는 같은 대화의 남은 알림을 정리하는 경로도 두었다.

무음 푸시가 항상 도착하는 건 아니었다

처음 메시지를 남겼을 때는 다른 기기에서 읽은 알림이 지워지는 걸 보고 꽤 신기했다. 그런데 이후 아이폰에서 다시 확인해 보니, 앱이 백그라운드에 있을 때는 기대한 대로 지워지지 않는 경우가 있었다.

무음 푸시는 OS가 전달과 백그라운드 실행을 보장하지 않는다. Apple 문서에도 시스템이 백그라운드 알림을 늦게 전달하거나 제한할 수 있다고 나온다. 사용자가 앱을 강제 종료했다면 앱이 자동으로 다시 실행되리라고 기대하기 어렵고, Android에서도 기기의 절전 상태에 따라 처리가 늦어질 수 있다.

그래서 무음 푸시가 도착하는 경로에만 의존하지 않도록 했다. 앱을 다시 열면 웹의 읽음 상태를 확인해 알림을 정리하고, 알림을 눌러 대화에 들어갔을 때도 같은 대화의 알림을 정리한다. iOS에서 더 시도해 볼 방법은 위에서 연결한 글에 따로 적어 뒀다.

내 폰에서 계속 써 보면서

알림이 안 올 때는 토큰 등록만 보고 있었는데, 막상 오기 시작하니 이번에는 누가 보냈는지 몰라서 앱을 열어야 했다. 내용을 보여 주니까 이미 읽은 알림이 폰에 남아 있는 게 신경 쓰였고. 하나 고치고 나서 직접 써 보면 다음 불편한 게 보인다.

이날은 권한 안내와 미리보기를 고쳤고, 읽은 알림을 정리하는 흐름까지 붙였다. 다만 아이폰이 잠겨 있을 때의 처리는 더 확인해야 했다.

이어지는 이야기