작성 시점 2026-11-06 기준직접 경험읽기 4분

구버전을 깨지 않고 기능을 더하는 법: 낚시어때 1.1.0

스토어 앱은 사용자가 업데이트를 바로 하지 않는다. 낚시어때 1.1.0에 알림함과 앱 아이콘 배지를 더하면서 1.0.x 앱을 깨지 않으려고 지킨 원칙과, 스스로 정한 출시 간격 룰을 어긴 날의 기록.

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

낚시어때 1.1.0 업데이트 안내 이미지. 왼쪽 화면은 MY 탭의 알림 목록, 오른쪽 화면은 출조 계획 알림을 눌러 열린 계획 상세다. 아래에 알림함, 누르면 바로 그 화면, 출조 계획 메뉴, 앱 아이콘 배지 네 가지 변경점이 적혀 있다.

이번 회차 숫자

설계를 정리한 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는 런처가 알아서 처리하므로 애초에 싣지 않는다.

서버가 푸시를 보낼 때 그 토큰이 배지 지원을 선언했는지 확인한다. 선언한 토큰이면 배지 숫자를 실어 보내고 iOS가 아이콘에 표시한다. 선언하지 않은 토큰이면 배지 없이 보내서 1.0.x 앱과 Android에는 숫자가 남지 않는다.예아니오서버가 푸시 발송배지 지원을선언한 토큰?배지 숫자를 실어 보냄iOS가 아이콘에 표시배지 없이 보냄1.0.x·Android: 숫자가 남지 않음
배지를 실을지 정하는 흐름. 파랑은 서버가 자동으로 하는 일, 회색은 조건, 초록은 iOS·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시에 나간다. 금요일에 공개해야 그 주말 출조 알림을 받은 사람이 바로 알림함을 써 볼 수 있었다.

이 룰은 처음부터 「권고」로 만들었다. 어길 때는 이유를 기록하고, 마지막 결정은 사람이 한다. 그래서 이번에도 어기는 절차가 있었고, 왜 어겼는지가 기록으로 남았다. 혼자 운영하는 회사의 규칙은 어길 길까지 열어 두어야 오래 지켜진다.

가져다 쓸 것

  • 알림함은 발송 기록에 「읽음」 표시를 더한 것이다. 서버가 기억하고 앱은 읽기만 한다.
  • 기능을 더하기 전에 구버전 코드가 모르는 값을 어떻게 다루는지부터 읽는다.
  • 되돌릴 수 없는 상태는 기기마다 받을 수 있다고 선언받은 뒤에만 보낸다.
  • 기능이 늘면 스토어 개인정보 설문을 다시 본다.
  • 룰에는 어기는 절차를 함께 둔다.

Google Play · App Store

낚시어때가 어떤 앱인지는 낚시어때 소개 페이지에서, 지금까지의 개발 기록은 개발기 안내에서 볼 수 있다.

이 글은 2026-11-06 기준으로 헥사허브가 직접 겪은 일을 적었습니다.