스토어에 문을 연 지 한 달, 네 번째 공개이자 첫 기능 업데이트인 1.1.0을 냈다. 받은 알림을 다시 볼 수 있는 알림함과, 아이폰 아이콘에 안 읽은 알림 수를 띄우는 배지가 들어갔다. 만드는 것보다 어려웠던 건 아직 1.0.x를 쓰는 폰이었다. 서버는 하나인데 살아 있는 앱 버전은 여럿이다.

이번 회차 숫자
설계를 정리한 10월 31일부터 공개한 11월 6일까지 7일이 걸렸다. 직전 공개인 1.0.3과는 6일 11시간 간격이다. 마일스톤에 묶은 일은 11건(기능 5, 결함 3, 운영 3)이었고, 그 기간에 병합한 PR은 26건이었다. iOS는 「심사 중」에서 「개발자 출시 대기」로 넘어가는 데 15분이 걸렸다. 이번 회차에 그랬다는 기록일 뿐, 늘 이렇게 빠르다는 뜻은 아니다.
한 번은 빌드를 다시 했다. 빌드 번호는 한 번 쓰면 끝이라는 규칙대로, 고친 뒤 새 번호로 다시 올렸다.
서버가 기억하고, 앱은 읽는다
1.0.x까지 푸시는 보내면 끝이었다. 서버는 무엇을 보냈는지 남기지 않았다. 알림함을 만들려면 앱이 아니라 서버가 먼저 바뀌어야 했다.
그래서 서버가 푸시를 보내는 순간 한 줄을 남기게 했다. 알림 종류, 제목, 본문, 눌렀을 때 갈 곳, 그리고 읽은 시각이다. 앱은 이 기록을 조회해서 보여 주기만 한다. 알림함은 새 기능이라기보다 발송 기록에 「읽음」 표시를 더한 것에 가깝다.
기록은 사용자당 최신 100건, 30일까지만 둔다. 오래된 기록을 지우는 일은 새 작업을 만들지 않고, 이미 돌고 있는 정기 배치에 끼워 넣었다. 정리가 한 번 실패해도 알림 발송은 영향을 받지 않는다.
구버전은 모르는 값을 어떻게 다루나
기능을 더하기 전에 1.0.x 앱 코드부터 읽었다. 알림을 눌렀을 때 1.0.x 앱은 알림 종류가 출조 계획이 아니면 그냥 넘긴다. 그러니 서버가 새 알림 종류나 이동할 화면 정보를 실어 보내도 구버전은 깨지지 않는다. 모르는 값은 무시하게 짜여 있었던 덕이다.
서버 쪽도 같은 원칙을 지켰다. 서버 기능은 새로 몇 개를 추가만 했고, 기존 응답의 모양은 하나도 바꾸지 않았다. 1.0.x 앱이 받는 응답은 업데이트 전과 같다.
배지: 구버전이 지울 수 없는 상태
배지만은 이 원칙으로 막을 수 없었다. iOS 아이콘의 배지 숫자는 푸시에 실린 badge 값을 iOS가 그대로 띄운다. 숫자를 지우는 건 앱의 몫인데, 1.0.x 앱에는 배지를 지우는 코드가 없다. 서버가 1.0.x 폰에 배지 숫자를 한 번이라도 보내면, 그 숫자는 사용자가 앱을 업데이트할 때까지 아이콘에 남는다.
앞의 호환 원칙은 「구버전이 깨지는가」를 봤다. 배지는 깨지지는 않지만 되돌릴 수 없는 상태를 만든다. 그래서 1.1.0 앱이 푸시 토큰을 등록할 때 서버에 배지 지원을 선언하게 했다. 서버는 토큰마다 배지 지원 여부를 기록해 두고, 선언한 토큰에만 배지 숫자를 싣는다. 싣는 숫자는 그 알림을 보낸 뒤의 안 읽은 수다. Android는 런처가 알아서 처리하므로 애초에 싣지 않는다.
1.0.x 앱과 1.1.0 앱이 알림을 다루는 방식
- 1.0.x 앱: 출조 계획 알림만 처리 · 새 알림 종류는 그냥 넘김 · 배지를 지우는 코드가 없음
- 1.1.0 앱: 알림함에서 30일 다시 보기 · 알림을 누르면 해당 화면으로 · 서버에 배지 지원을 선언
호환성을 볼 때 「깨지느냐」만 물으면 배지 같은 경우를 놓친다. 「잘못 보냈을 때 되돌릴 수 있느냐」까지 물어야 한다. 되돌릴 수 없는 상태는 기능 스위치 하나로 켜고 끄지 말고, 기기마다 받을 수 있다고 선언받은 뒤에만 보낸다.
출시에서 걸린 것 두 가지
스토어 스크린샷 8장은 이번에 코드로 만들었다. 앱 화면을 캡처하고, HTML 카드에 얹은 뒤, Playwright로 PNG를 뽑았다. 그런데 App Store Connect의 6.9인치와 6.5인치 칸이 규격대로 만든 파일을 「파일 크기가 유효하지 않습니다」라며 받지 않았다. 다른 기기 규격인 1206×2622로 다시 뽑아 올리니 통과했다. 왜 거부됐는지는 아직 모른다.
또 하나는 스토어의 개인정보 설문이다. 알림함은 사용자가 무엇을 받고 읽었는지를 서버에 남기는 기능이라, 두 스토어의 설문에서 수집 항목을 고쳐야 했다. 기능을 하나 더하면 코드만큼 설문도 다시 봐야 한다.
룰을 어긴 날
공개 사이에 7일 간격을 두자는 룰을 스스로 정해 두었다. 1.1.0은 그 룰보다 13시간 일찍 공개했다. 주말 출조 알림은 출조 전날 18시에 나간다. 금요일에 공개해야 그 주말 출조 알림을 받은 사람이 바로 알림함을 써 볼 수 있었다.
이 룰은 처음부터 「권고」로 만들었다. 어길 때는 이유를 기록하고, 마지막 결정은 사람이 한다. 그래서 이번에도 어기는 절차가 있었고, 왜 어겼는지가 기록으로 남았다. 혼자 운영하는 회사의 규칙은 어길 길까지 열어 두어야 오래 지켜진다.
가져다 쓸 것
- 알림함은 발송 기록에 「읽음」 표시를 더한 것이다. 서버가 기억하고 앱은 읽기만 한다.
- 기능을 더하기 전에 구버전 코드가 모르는 값을 어떻게 다루는지부터 읽는다.
- 되돌릴 수 없는 상태는 기기마다 받을 수 있다고 선언받은 뒤에만 보낸다.
- 기능이 늘면 스토어 개인정보 설문을 다시 본다.
- 룰에는 어기는 절차를 함께 둔다.
낚시어때가 어떤 앱인지는 낚시어때 소개 페이지에서, 지금까지의 개발 기록은 개발기 안내에서 볼 수 있다.
이 글은 2026-11-06 기준으로 헥사허브가 직접 겪은 일을 적었습니다.