본문 바로가기
프로덕션 업데이트

모든 사용자에게 최신 패치를 배포하세요

CLI 또는 CI에서 새 웹 번들을 업로드하세요. 기기는 백그라운드에서 다운로드하여 앱이 다시 포그라운드로 돌아올 때 실행합니다. 퍼센트 단위로 롤아웃하고, Observe에서 모니터링하며, 문제가 발생하면 롤백할 수 있습니다.

신용카드 불필요
자동 롤백 내장
웹 레이어 업데이트만

문제점

스토어 릴리스로 작은 수정을 배포하기엔 너무 느립니다

스토어 심사만 거치는 수정 경로

1

버그 찾기

모니터링이나 지원팀에서 깨진 화면을 보고합니다. 수정은 JavaScript나 CSS 몇 줄이면 됩니다.

2

새 바이너리 빌드

버전을 올리고 iOS와 Android용으로 빌드한 뒤, 스토어 제출 두 건을 준비합니다.

3

심사 대기

스토어 리뷰는 보통 24~48시간, 때로는 훨씬 더 걸립니다. 거절되면 대기가 처음부터 다시 시작됩니다.

4

사용자 업데이트 대기

승인 후에도 각 사용자는 새 버전을 설치해야 합니다. 그때까지는 구버전 code를 실행합니다.

각 단계마다 수정이 준비된 뒤 사용자 기기에서 실행되기까지 시간이 더 걸립니다.

스토어 수정이 사용자에게 늦게 도달하는 이유

24–48시간+

일반적인 스토어 심사 시간

Apple과 Google은 모든 새 바이너리를 심사합니다. 심사는 보통 24~48시간, 때로는 훨씬 오래 걸리며, 반려되면 다시 제출해야 합니다.

사용자당

스토어 업데이트는 기기마다 다름

스토어 업데이트는 사용자가 직접 설치하거나 자동 업데이트 설정이 설치할 때만 기기에 도달합니다. 일부 기기는 한참 동안 이전 빌드에 머뭅니다.

2개 스토어

수정할 때마다 두 번 제출

같은 웹 수정이 App Store와 Google Play를 각각 거치며, 각각 별도의 심사와 릴리스가 필요합니다.

솔루션

live update가 사용자에게 도달하는 방식

이것은 Capgo의 기본 업데이트 동작입니다. 업데이트 프롬프트도, 강제 재시작도, 웹 레이어 변경을 위한 스토어 제출도 없습니다.

기본 업데이트 흐름

  1. 앱이 업데이트를 확인합니다

    앱이 포그라운드로 전환될 때와 앱이 열려 있는 동안 10분마다, 업데이터가 Capgo에 해당 채널의 최신 bundle을 요청합니다.

    포그라운드 전환 시

  2. 백그라운드에서 다운로드합니다

    사용자가 현재 버전을 사용하는 동안 새 bundle이 다운로드됩니다. delta 업데이트를 사용하면 변경된 파일만 다운로드됩니다.

    중단 없음

  3. 다음 재개 시 적용됩니다

    사용자가 앱을 나가면 업데이터가 bundle을 설치합니다. 다음에 앱을 열면 새 버전이 실행됩니다.

    다음 포그라운드 전환 시

사용자가 앱을 열자마자 새 버전을 보게 해야 하나요? Direct update 모드를 사용하면 앱 실행 시 스플래시 화면이 표시되는 동안 업데이트가 적용됩니다.

Direct updates 알아보기

업데이트 동작 문서

작동 방식

Capgo로 프로덕션 팀이 핫픽스를 배포하는 방법

이미 스토어에 출시된 Capacitor 앱의 일반적인 릴리스 과정입니다. 아래 모든 명령어는 Capgo CLI 문서에서 가져온 것입니다.

  1. 업데이터 최초 설정

    설정 마법사를 실행한 후, 앱이 시작될 때 notifyAppReady()를 호출하는지 확인하세요. 이 호출이 없는 번들은 자동으로 롤백됩니다.

    npx @capgo/cli@latest init
    # in your app start-up code
    await CapacitorUpdater.notifyAppReady()
    notifyAppReady() 문서
  2. 프로덕션 일부에 픽스 업로드

    --delta를 사용해 변경된 파일만 가져오게 하고, --rollout으로 소수의 기기부터 배포를 시작하세요. 나머지 기기는 안정적인 번들을 그대로 유지합니다.

    npx @capgo/cli@latest bundle upload --channel production --delta --rollout 5
    Progressive rollouts 문서
  3. Capgo로 잘못된 롤아웃 중단하기

    실패율 임계값으로 auto-pause를 켜세요(500bp는 5%입니다). 실패율이 임계값을 넘으면 Capgo가 롤아웃을 롤백합니다. 실행 중인 새 버전은 Observe에서 확인하세요.

    npx @capgo/cli@latest channel set production \
      --auto-pause-enabled \
      --auto-pause-failure-rate-bps 500 \
      --auto-pause-action rollback
    Observe 문서
  4. 모든 사용자에게 배포

    지표가 정상적으로 보이면 해당 채널의 모든 기기에 bundle을 배포하세요. 그렇지 않으면 롤아웃 코호트를 stable로 되돌리세요.

    npx @capgo/cli@latest channel set production --rollout-promote
    # or, if something looks wrong
    npx @capgo/cli@latest channel set production --rollout-rollback
    롤백 문서

프로덕션 릴리스를 위해 설계되었습니다

사용자를 놀라게 하지 않고 자주 배포하기 위해 프로덕션 팀이 쓰는 컨트롤입니다.

델타 업데이트

--delta로 업로드하면 디바이스는 현재 번들 이후 변경된 파일만 다운로드합니다. 거의 바뀌지 않는 대형 에셋은 한 번만 다운로드됩니다.

  • 느리거나 종량제 네트워크를 쓰는 사용자의 다운로드 용량 감소
  • 기본 모드에서는 업데이트가 세션 중간이 아니라 세션 사이에 적용됩니다
Delta updates 문서

--delta

변경된 파일만 다운로드됩니다

자동 일시정지가 있는 점진적 롤아웃

채널의 무작위 고정 비율에 새 번들을 보내고, 나머지는 안정적인 번들에 유지합니다. CLI 또는 콘솔에서 비율을 높이거나, 승격하거나, 롤백할 수 있습니다.

  • 실패율이 임계값을 넘으면 Auto-pause가 롤아웃을 일시 중지하거나 롤백할 수 있습니다.
  • Observe는 노출을 확대하기 전에 새 버전과 이전 버전을 비교합니다.
Progressive rollouts 문서

1–5%

일반적인 첫 번째 롤아웃 단계

자동 롤백

모든 업데이트는 제대로 시작되는지 증명해야 합니다. 새 bundle이 제때 notifyAppReady()를 호출하지 않으면 기기는 마지막 정상 bundle로 돌아가고, 새 bundle은 실패로 표시됩니다.

  • appReadyTimeout(기본 10초) 내에 notifyAppReady()가 호출되지 않으면 롤백이 트리거됩니다.
  • 채널 전체를 히스토리에 있는 이전 bundle로 롤백하세요
notifyAppReady() 문서

10초

자동 롤백 전 기본 appReadyTimeout

스토어 심사를 고려한 배포

Capgo는 JavaScript, CSS, 에셋으로 구성된 Capacitor 웹 레이어를 제공합니다. 네이티브 바이너리, 플러그인, 권한, entitlements, 앱 스토어 메타데이터는 변경하지 않습니다. 스토어 심사는 앱마다 다르므로 정책 준수와 승인 책임은 사용자에게 있습니다.

  • 네이티브 기능, 플러그인, 권한 또는 앱 스토어 메타데이터가 변경될 때는 네이티브 스토어 릴리스를 사용하세요
  • 리뷰어 노트에 앱의 의도된 기능과 웹 레이어 업데이트 경로를 명확히 작성하세요
  • 제출할 때마다 최신 Apple 및 Google 정책을 검토하세요

프로덕션 팀의 활용 사례

Live Updates 도입 후 일상적인 릴리스 작업입니다. 각 카드는 문서로 연결됩니다.

치명적 버그 수정

결제나 로그인 화면이 깨지면 웹 레이어 수정으로 해결합니다. 업로드하면 기기가 다음 업데이트 확인 시 반영합니다.

업데이트 동작 문서

문구 및 콘텐츠 변경

새 binary를 빌드하지 않고도 문구를 고치거나 도움말 텍스트를 업데이트하고, 이미지와 기타 번들 자산을 교체하세요.

네이티브 호환성 문서

Observe의 릴리스 상태

새 번들을 이전 번들과 비교해 이슈 없는 비율, 실행 및 WebView 타이밍, 버전별 배포 마커를 확인하세요.

Observe 문서

업데이트 알림으로 더 빠른 반영

채널의 bundle을 변경한 뒤 silent update 알림을 보내면, 디바이스가 다음 포그라운드 진입 때가 아니라 즉시 업데이트를 확인합니다.

업데이트 알림 보내기

오래된 native build 보호

채널에서 메이저 업데이트를 차단해 새 native code가 필요한 bundle이 오래된 binary에 도달하지 않도록 하세요.

버전 타겟팅 문서

채널 히스토리에서 롤백하기

채널의 History 탭에서 이전 번들을 선택해 해당 채널의 모든 기기에 다시 라이브로 배포하세요.

롤백 문서

이미 프로덕션 앱을 지원하는 인프라

Capgo는 2021년부터 프로덕션 앱에 라이브 업데이트를 제공해 왔습니다.

월간 업데이트 수
10억+
도달한 디바이스 수
9,000만+
Capgo 사용 앱
4.7K+
평균 API 지연 시간
~50ms

Capacitor로 빌드된 앱

트래픽이 많은 앱은 프로덕션 환경에서 안정적인 UI 변경이 필요합니다

날씨, 공공 보건, 통신 앱은 정확한 인터페이스, 알림, 내비게이션에 의존합니다. 프로덕션 업데이트를 사용하면 승인된 인터페이스 수정 사항을 배포하는 동시에, 범위를 넓히기 전 사용자 채택률을 모니터링할 수 있습니다.

Windy.com - 날씨 예보 앱 아이콘 날씨

Windy.com - 날씨 예보

지도, 알림, 내비게이션 수정을 프로덕션에 신중히 배포해야 하는 날씨 앱.

Google Play 설치 수
3,290만
스토어 평점
4.7
Conecte SUS 앱 아이콘 의료

연결하기

가이드와 서비스 정보에 빠르고 신뢰할 수 있는 업데이트가 필요한 공공 보건 앱.

Google Play 설치 수
2,770만
스토어 평점
4.6
Mi Orange 앱 아이콘 도구

Mi Orange

알림과 계정 화면이 자주 변경되는 통신사 계정 앱입니다.

Google Play 설치 수
930만
스토어 평점
4.2

고객 사례

Capgo로 배포하는 팀들의 이야기

5.0/5 개발 팀 평점 9,400+ 팀 리뷰 보기
Sergiu S의 사진

Sergiu S

drivolino GmbH 리드 개발자

“Capgo Capacitor Updater 플러그인 덕분에 업데이트 배포 방식이 완전히 바뀌었습니다. 며칠씩 걸리던 작업이 이제는 단 몇 분 만에 끝납니다.”

카필

NuTriQ 창립자

“App Store의 전체 리뷰 주기를 기다리지 않고 프로덕션 OTA 업데이트를 즉시 푸시할 수 있다는 점은 운영상 엄청난 이점이었습니다.”

Michael Haberler의 인물 사진

Michael Haberler

데이터 지표

“업데이터 플러그인 정말 잘 만드셨네요. 제 환경에서는 완벽하게 동작하고, 라이브 업데이트 덕분에 테스트 주기가 훨씬 빨라졌습니다.”

자주 묻는 질문

프로덕션 팀이 묻는 질문

업데이트가 기기에 전달되는 방식과 문제가 생겼을 때 대처하는 방법.

사용자는 언제 live update를 받게 되나요?

기본적으로 앱은 포그라운드로 전환될 때와 열려 있는 동안 10분마다 업데이트를 확인합니다. 새 bundle을 백그라운드에서 다운로드하고, 사용자가 앱을 나갈 때 설치한 뒤 다음에 앱을 열 때 실행합니다. autoUpdate 설정으로 이 동작을 바꿀 수 있습니다.

업데이트 동작 문서

기기가 긴급 수정 사항을 더 빨리 받을 수 있나요?

네. 채널의 bundle을 변경한 후 콘솔에서 업데이트 알림을 보내거나, bundle 업로드 시 --send-update-notification을 추가하세요. 기기는 silent push를 받고 즉시 업데이트를 확인합니다. 이를 위해서는 iOS 및 Android 푸시 자격 증명이 포함된 Capgo Notifications가 필요합니다. 전달은 best effort 방식이며, 오프라인이거나 강제 종료된 앱은 다음 실행 시 업데이트를 확인합니다.

업데이트 알림 보내기

업데이트로 인해 앱이 작동하지 않으면 어떻게 되나요?

새 bundle이 10초(기본 appReadyTimeout) 이내에 notifyAppReady()를 호출하지 않으면, 기기는 마지막으로 정상 작동하던 bundle로 복구하고 새 bundle을 실패로 표시합니다. 앱 시작을 막지 않는 버그라면, progressive rollout을 롤백하거나 채널 히스토리에서 이전 bundle을 선택하세요.

롤백 문서

일부 사용자에게만 먼저 출시하려면 어떻게 하나요?

--rollout으로 업로드하면 번들이 채널의 무작위 고정 비율로 배포되고, 나머지 사용자는 stable에 남습니다. CLI 또는 콘솔에서 비율을 올리거나, promote하거나, 롤백할 수 있습니다. 실패율이 임계값을 넘으면 Auto-pause가 노출을 중단합니다.

Progressive rollouts 문서

live update로 바꿀 수 없는 것은 무엇인가요?

Live Update는 웹 레이어(JavaScript, HTML, CSS, 에셋)를 교체합니다. 네이티브 플러그인, Capacitor 업그레이드, capacitor.config 변경, iOS 또는 Android 프로젝트 파일은 스토어 릴리스가 필요합니다. Capgo는 업로드 시 번들의 네이티브 호환성을 검사하고, 채널은 구버전 바이너리로의 업데이트를 차단할 수 있습니다.

네이티브 호환성 문서

다음 수정 사항을 live update로 배포하세요

트라이얼 기간에 내 앱에서 전체 플로우를 직접 해보세요: 번들 업로드, 일부 기기에 롤아웃, 롤백까지.