Google Play 단계적 출시: 작동 원리 가이드

Google Play 단계적 출시를 사용하면 100% 배포 전, 특정 트랙의 사용자 중 일부에게만 새로운 Android App Bundle을 먼저 출시할 수 있습니다. 다음 환경에서 사용 가능: 프로덕션, 공개 테스트, 그리고 비공개 테스트 크래시와 평점을 모니터링하며 장애 범위를 제한할 수 있습니다. 내부 테스트 최대 100명의 테스터를 대상으로 빠르게 확인하는 용도이며, 프로덕션 단계의 단계적 출시와는 다릅니다. Capacitor 앱의 경우, 스토어 출시와 Capgo 채널을 및 단계적 출시 스토어 업데이트 사이의 Live Update를 퍼센트 단위로 배포해야 할 때 유용합니다.

2026년 Play Console 트래킹

Google이 정의하는 4가지 출시 방식:

출처: 릴리스 준비 및 배포 및 공개, 비공개 또는 내부 테스트 설정.

일반적인 흐름: 내부 테스트 스모크 테스트용, 비공개 테스트 신뢰할 수 있는 베타 그룹용, 공개 테스트 더 넓은 피드백을 받은 뒤, 프로덕션 단계별 배포 비율로.

Play 단계별 배포 작동 방식

Google의 단계별 배포를 통한 앱 업데이트 출시 가이드는 다음 루프를 설명합니다:

1. 열고 프로덕션, 공개 테스트, 또는 비공개 테스트 Play Console에서 진행합니다.
2. 릴리스를 생성하거나 수정하여 다음을 업로드하세요: Android App Bundle 버전이 versionCode 해당 트랙에 이미 배포된 버전보다 높아야 합니다. Play Store는 사용자가 접근 가능한 트랙 중 가장 높은 호환 버전을 제공하므로, versionCode 새로운 Production 빌드가 동일 사용자의 낮은 테스트 트랙 빌드보다 우선하여 설치될 수 있습니다.
3. 다음 항목을 설정하세요: 출시 비율 (1%에서 100% 사이).
4. rollout을 시작합니다.
5. Android vitals, 크래시 및 리뷰를 모니터링합니다.
6. 비율을 높입니다 백분율, 중단, 또는 재개 Releases 탭에서 롤아웃을 (롤아웃 관리).
7. 지표가 안정적이면 100%로 승격하세요.

Google 문서에 명시된 주요 제한 사항:

• 롤아웃 대상 사용자는 Google이 선정하며, 콘솔 UI에서 개별 사용자를 직접 선택할 수 없습니다.
• 새 롤아웃을 시작하기 전에 해당 트랙의 충돌하는 초안 릴리스를 완료하거나 삭제하세요. 이전 릴리스가 100%에 도달하기 전에 새로운 단계적 롤아웃을 생성하는 것에 대해 Google은 주의를 권고합니다.
• 사용자에게 즉시 설치를 강제할 수 없으며, Play 스토어가 릴리스를 전달할 때 업데이트가 진행됩니다.
• 프로덕션 단계적 롤아웃은 다음을 대상으로 할 수 있습니다: 특정 국가 또는 지역; 테스트 트랙은 해당 트랙의 테스터 규칙을 따릅니다.

이 Google Play 개발자 API 트랙 ID를 매핑합니다 (production, beta 공개 테스트용, qa 내부 테스트용 및 이름이 지정된 비공개 트랙 포함) 릴리스를 자동화하는 경우.

롤아웃 중 모니터링 항목

신호를 수집할 수 있도록 배포 비율을 올리는 단계 사이에 충분한 시간을 두세요. Google 고객센터는 배포를 확대하기 전 모니터링을 권장하며, 많은 팀이 프로덕션에서는 초기 비율을 최소 하루 유지합니다.

네이티브 버그가 배포되었다면, 중단하고 Play 배포를 중단하고 수정된 번들을 더 높은 버전으로 게시하세요 versionCodePlay는 바이너리를 자동으로 롤백해주지 않습니다.

Capgo 채널 및 퍼센트 롤아웃 (Live Update)

스토어 롤아웃은 다음을 변경합니다: 네이티브 셸 사용자가 Play에서 다운로드하는 항목입니다. Capgo 다음 기능을 처리합니다: Live Update 웹 번들 업데이트 이미 설치된 Capacitor 앱 내부에서 실행됩니다.

• 채널 디바이스를 업데이트 스트림에 매핑합니다 ("production, beta", 사용자 지정 이름). 디버깅 시 특정 디바이스 ID를 채널에 강제로 할당할 수 있습니다.
• 단계적 배포 안정적인 fallback 번들을 채널에 유지하면서 rollout 대상이 설정된 비율에 도달할 때까지 진행합니다. 웹 레이어 수정을 위해 새로운 Play 빌드를 배포할 필요 없이 배포 비율을 늘리거나, 줄이거나, 일시 중지하거나, 완료하거나, 롤백할 수 있습니다.

네이티브 code, 권한 또는 targetSdkVersion를 변경할 때는 Play staged rollouts를 사용하세요. 수정 사항이 HTML, CSS 또는 JavaScript에 있고 컴플라이언스 검토에서 OTA 배포를 허용한다면 Capgo 비율의 rollouts를 사용하세요.

권장하는 결합 전략

1. 네이티브 변경 사항은 다음을 통해 배포하세요 내부 테스트, 그런 다음 비공개 테스트 또는 공개 테스트, 그 다음 프로덕션 단계적 출시를 진행합니다.
2. 일상적인 웹 수정 사항을 위해 프로덕션 기기를 안정적인 Capgo 채널로 지정하세요.
3. 다음 기능을 실행하세요: 점진적 출시(progressive rollout) 자동 안정화 폴백(fallback) 기능이 포함된 카나리 웹 번들을 채널에 배포하고 싶을 때 사용합니다.
4. vitals가 악화되면 Play 출시를 중단하고, 웹 지표가 악화되면 Capgo 점진적 출시를 롤백하세요.

규칙 및 요구사항 안내

• 새 번들은 더 높은 versionCode 사용자가 겹치는 트랙에서 이미 받을 수 있는 빌드보다 높아야 합니다.
• Play App Signing을 사용하는 앱은 서명된 AAB를 다음 기준으로 업로드해야 합니다 Google Play 앱 서명.
• 같은 트랙에서 충돌하는 출시를 시작하기 전에 진행 중인 단계적 출시를 완료하거나 초안을 삭제하세요 (출시 준비 및 배포).

자주 묻는 질문

내부 테스트에서도 퍼센트를 사용하나요?

아니요. 내부 테스트는 테스터 목록(최대 100명)에 출시를 배포합니다. 퍼센트 기반 단계적 출시를 사용하려면 Closed, Open 또는 Production 트랙을 이용하세요.

테스터는 내부 테스트 또는 Closed 빌드를 어떻게 설치하나요?

내부 테스트는 이메일 리스트(최대 100명)를 사용합니다. 비공개 테스트는 이메일 리스트, Google Groups 또는 Play Console 조직 관리를 지원합니다. 공개 테스트는 스토어 등록정보에 공개 참여 프로그램이 표시되는 유일한 트랙입니다. 내부 또는 비공개 트랙의 테스터는 공유받은 Play Store URL이 필요하며, 공개 테스트나 프로덕션 트랙을 사용하지 않는 한 검색으로는 빌드를 찾을 수 없습니다.

Play 롤아웃을 진행하는 대신 Capacitor 팀이 Capgo을 사용해야 하는 경우는 언제일까요?

변경 사항이 웹 에셋에 국한되고 스토어 규정 준수 체크리스트를 통과한 경우입니다. Native plugin 업그레이드, manifest 변경 및 권한 변경은 여전히 새로운 Play 릴리스가 필요합니다.

계속 읽기 - Google Play Staged Rollouts: How It Works

사용 중인 경우 Google Play 단계적 출시(Staged Rollouts): 작동 원리 알아보기 스토어 승인 및 배포 계획을 세우고, 이를 다음 항목과 연결하세요: @capgo/capacitor-in-app-review @capgo/capacitor-in-app-review의 구현 세부 사항은 @capgo/capacitor-in-app-review에서 확인하세요, @capgo/capacitor-in-app-review 사용하기 @capgo/capacitor-in-app-review 사용하기에서 네이티브 기능은, @capgo/capacitor-native-market @capgo/capacitor-native-market의 구현 세부 사항은, @capgo/capacitor-native-market 사용하기 Native 기능은 @capgo/capacitor-native-market 사용 문서에서, 그리고 Capacitor OTA Updates: App Store 승인 가이드 실무 맥락은 Capacitor OTA Updates: App Store 승인 가이드에서.