App Store 단계적 출시: 7일 롤아웃 작동 방식, 일시정지 시점, 롤아웃 중 수정 버전 배포 방법 (2026)

App Store 단계적 출시(phased release)는 7일에 걸쳐 자동 업데이트가 켜진 사용자 중 점점 더 많은 비율에게 버전 업데이트를 보내는 기능으로, 첫날 1%에서 시작해 7일째 100%에 도달합니다. 매일 크래시와 고객 지원 이메일을 확인하고 이상 징후가 보이는 즉시 일시정지하면, 문제 있는 빌드가 전체 사용자가 아닌 소수에게만 전달됩니다. 다만 단계적 출시에는 큰 한계가 하나 있습니다. 자동 업데이트만 제어한다는 점입니다. 새 버전은 누구나 여전히 수동으로 다운로드할 수 있습니다.

App Store 단계적 출시가 제어하는 것과 제어하지 못하는 것은?

단계적 출시가 제어하는 것은 자동 업데이트가 켜진 사용자 중 누가, 언제 버전 업데이트를 받는지뿐입니다. 새 버전을 수동 다운로드로부터 숨기지 않으며, 이미 받은 사용자를 롤백하지도 않습니다.

Apple의 App Store Connect 도움말에 따르면 "지원되는 기기에서 자동 업데이트를 켠 사용자 중 무작위 표본이 업데이트를 받으며, 단계적 출시에 참여한다는 알림은 받지 않습니다." 이 기능은 iOS, macOS, tvOS 버전 업데이트에서 작동하므로 앱의 첫 출시에는 사용할 수 없습니다. 설정하려면 Account Holder, Admin 또는 App Manager 역할이 필요합니다. Apple은 또한 "단계적 출시 중인 앱과 앱 업데이트는 누구나 언제든 App Store에서 수동으로 다운로드할 수 있습니다"라고 명시합니다.

App Store 단계적 출시 일정은 어떻게 되나요?

2026년 11월 기준으로 일정은 7일 동안 1%, 2%, 5%, 10%, 20%, 50%, 100%로 고정되어 있으며 수정할 수 없습니다. 개발자가 제어할 수 있는 것은 언제 일시정지할지, 언제 바로 100%로 건너뛸지입니다.

하루하루를 하나의 결정, 즉 계속 진행할지 일시정지할지로 끝나는 체크포인트로 다루세요.

App Store Connect에서 단계적 출시는 어떻게 켜나요?

단계적 출시는 업데이트가 공개되기 전이라면 언제든 버전 페이지의 Phased Release for Automatic Updates(자동 업데이트를 위한 단계적 출시) 항목에서 켤 수 있습니다. 제출 전에 미리 결정할 필요는 없습니다.

Apple은 버전이 Prepare for Submission, Waiting for Review, In Review, Waiting for Export Compliance, Pending Developer Release, Developer Rejected, Rejected 또는 Metadata Rejected 상태일 때 이 설정을 허용합니다.

1. Apps에서 앱을 선택한 다음 사이드바에서 제출할 버전을 클릭합니다.
2. Phased Release for Automatic Updates 항목까지 스크롤합니다.
3. Release update over a 7-day period using phased release(단계적 출시를 사용해 7일 동안 업데이트 출시)를 선택합니다.
4. Save를 클릭합니다. 승인 후에는 상태가 Ready for Distribution으로 표시되고 옆에 Phased Release가 함께 표시됩니다.

App Store Connect API로도 단계적 출시를 관리할 수 있어, 출시 파이프라인이 이미 스크립트로 자동화되어 있다면 유용합니다.

단계적 출시는 언제 일시정지해야 하며, 30일 한도는 어떻게 적용되나요?

미리 합의한 트리거 중 하나라도 발동하면 즉시 일시정지하세요. 일시정지 기간은 합산해 최대 30일까지이며, 재개하면 롤아웃은 멈췄던 날부터 이어집니다.

사용자가 버그를 겪는 와중에 트리거를 두고 논쟁하지 않도록, 출시일 전에 트리거를 문서로 정리해 두세요. 좋은 트리거는 구체적입니다. 예를 들어 크래시 없는 세션 비율이 이전 버전의 기준치 아래로 떨어질 때, 결제나 로그인이 측정 가능한 비율로 실패할 때, 여러 사용자가 같은 버그를 신고할 때입니다.

일시정지하려면 Ready for Distribution 상태의 버전을 열고 Pause Phased Release(단계적 출시 일시정지)를 선택한 뒤 Save를 클릭합니다. 재개하려면 Use Phased Release(단계적 출시 사용)를 선택합니다. Apple의 예시에 따르면 10일간 일시정지한 뒤 재개하면 남은 일시정지 기간은 20일입니다. 이 총 한도 안에서는 원하는 만큼 여러 번 일시정지할 수 있습니다. 남은 단계를 건너뛰려면 버전 페이지 오른쪽 상단의 Release to All Users를 클릭하세요.

버그가 발견되면 단계적 출시는 어떻게 진행되나요?

버그가 발견되면 일시정지하고, 수정한 뒤, 다시 단계적 출시를 켠 새 버전을 배포합니다. 작업하는 동안 아직 자동 업데이트를 기다리는 사용자는 이전 버전에 머뭅니다.

버전 3.4에서 동기화 엔진을 교체했다고 가정해 보겠습니다. 첫날 자동 업데이트 사용자의 1%가 이 버전을 받고, 크래시 리포터와 동기화 오류 로그를 두 번 확인합니다. 5%에 도달한 3일째, 특정 구형 iOS 버전에서 동기화 실패가 몰려서 나타납니다. 즉시 일시정지합니다. 모두가 업데이트를 받았을 때보다 영향을 받는 사용자가 훨씬 적고, 아직 배포 대상에 포함되지 않은 자동 업데이트 사용자는 3.3에 머뭅니다.

다음으로 버그를 수정하고 단계적 출시를 켠 3.4.1을 제출합니다. 수정 사항은 디버그 빌드만이 아니라 릴리스 빌드에서도 테스트하세요. 이 단계는 릴리스 빌드 테스트 계획에서 다룹니다. 3.4.1 릴리스 노트에는 동기화 문제가 수정되었다고 분명히 적으세요. 작성 방법은 릴리스 노트 예시에서 확인할 수 있습니다. 수정이 시급하고 확신이 있다면, 일주일을 더 기다리는 대신 승인 후 Release to All Users를 사용하세요.

안전장치를 하나 더 두세요. 새 동기화 엔진을 서버 측 플래그 뒤에 두는 것입니다. 일시정지는 업데이트가 더 퍼지는 것을 막지만, 플래그를 쓰면 이미 3.4를 설치한 사용자에게서도 위험한 코드를 끌 수 있습니다. 두 가지를 함께 쓰면 효과적입니다.

다른 개발자들은 단계적 출시를 일시정지하면서 어떤 문제를 겪었나요?

공개된 스레드들을 보면 같은 패턴이 반복됩니다. 개발자가 버그 있는 버전을 일시정지한 뒤, 후속 단계적 출시가 이미 업데이트를 받은 사용자에게 어떻게 적용되는지 확신하지 못합니다. Apple 문서는 이에 대한 답을 주지 않으므로, 수정 버전에도 별도의 롤아웃이 필요하다고 가정하고 계획하세요.

• Apple Developer Forums의 한 개발자는 문제 있는 빌드를 받은 사용자가 10% 미만인 상황에서 "크래시를 발견해 업데이트 롤아웃을 일시정지하고, 앱을 패치해 업로드한 뒤 새 단계적 롤아웃을 시작했다"고 밝혔습니다. 그리고 같은 사용자들이 새 롤아웃을 받게 되는지 물었습니다. 이 스레드에는 끝내 공식 답변이 없었고, 한 답글은 8.0 사용자가 "8.1 업데이트가 나오는 즉시 업데이트가 있다는 알림을 받을 것"이라고 했습니다.
• 다른 포럼 스레드에서는 한 개발자가 치명적인 버그 때문에 버전 15.0.1을 "1%에서 멈췄다"며, 15.0.2도 단계적으로 배포해 15.0.1이 "대다수 사용자에게는 사실상 건너뛰어지기"를 바랐습니다. 그 스레드의 앞선 답글은 버그 있는 버전을 일시정지한 상태에서 신속 심사를 요청하고, 경우에 따라 "새 사용자가 문제 있는 버전을 받지 않도록" 앱을 판매 중단하라고 제안했습니다. 그렇게 하기 전에 위 주의 상자에 설명한 판매 중단 규칙을 기억하세요.
• Tramline의 store-quirks 노트를 만든 출시 도구 팀은 새 출시를 시작하면 "기존 롤아웃이 그냥 취소된다"고 기록했으며, 이전 버전은 REPLACED_WITH_NEW_VERSION 상태로 바뀌고 단계적 출시는 COMPLETE로 표시된다고 설명합니다. 같은 노트는 일시정지가 "이미 업데이트를 받은 사용자에 대해서는 아무것도 할 수 없다"고도 말합니다.

세 사례 모두에서 일시정지는 시간을 벌어 주었을 뿐입니다. 해결책은 언제나 새 버전이었고, 같은 사용자 집단이 먼저 업데이트를 받는다고 기대할 수도 없었습니다. 그래서 일시정지 버튼보다 서버 측 플래그와 빠르게 배포할 수 있는 핫픽스 브랜치가 더 중요합니다.

Google Play 단계적 출시와는 어떻게 다른가요?

Google Play 단계적 출시(staged rollout)는 직접 정한 비율을 사용하며, 비율도 수동으로 올려야 합니다. 중단 후 재개하면 같은 사용자 집단에게 배포됩니다. 두 스토어의 롤아웃은 따로 계획하세요.

Play Console 고객센터에 따르면 "앱의 단계적 출시 비율은 자동으로 증가하지 않으며", 단계적 출시는 "앱 업데이트에만 사용할 수 있고, 앱을 처음 게시할 때는 사용할 수 없습니다." 중단 후에도 이미 해당 버전을 받은 사용자는 그 버전에 머물며, Google은 문제 있는 버전을 재개하는 대신 수정된 번들로 새 버전을 출시하라고 권장합니다. 프로덕션 출시는 특정 국가로 제한할 수 있지만, 출시가 시작된 후에는 국가를 제거할 수 없습니다. 다음 Android 업데이트가 새 타깃 SDK 요건도 충족해야 한다면 Google Play 타깃 API 레벨 36 가이드를 참고하세요.

단계적 출시를 시작하기 전에 무엇을 확인해야 하나요?

롤아웃이 시작되기 전에 버전에 단계적 출시가 저장되어 있는지, 기준치와 일시정지 트리거가 문서화되어 있는지, 수정 버전을 빠르게 배포할 수 있는지 확인하세요. 다음 체크리스트를 활용하세요.

• 버전 페이지에서 단계적 출시를 선택하고 저장함
• 크래시 리포팅과 백엔드 오류 대시보드를 북마크하고, 이전 버전의 기준치를 확보함
• 버튼을 누를 수 있는 모든 사람이 합의한 일시정지 트리거를 문서화함
• 위험한 기능을 서버 측 플래그 뒤에 둠
• 7일 동안 매일 지표를 확인할 담당자를 지정함
• 핫픽스 브랜치를 준비하고, 후속 빌드에 사용할 App Store 제출 체크리스트를 갖춤
• 롤아웃이 모든 사용자에게 도달할 때까지 스토어 등록정보 변경을 보류함

출시 작업 자체를 맡기고 싶다면, App Store 제출 서비스에서 App Store Connect 및 Play Console 설정, 심사 준비, 두 스토어 출시를 $599에 제공합니다(개발자 계정 비용은 별도). 위험한 업데이트에 대해 다른 관점의 검토가 필요하다면 앱과 변경 사항을 적어 yagyeshsrbobde@gmail.com으로 이메일을 보내 주세요.