Windy.com - 날씨 예보
지도, 알림, 내비게이션 수정을 프로덕션에 신중히 배포해야 하는 날씨 앱.
- Google Play 설치 수
- 3,290만
- 스토어 평점
- 4.7
CLI 또는 CI에서 새 웹 번들을 업로드하세요. 기기는 백그라운드에서 다운로드하여 앱이 다시 포그라운드로 돌아올 때 실행합니다. 퍼센트 단위로 롤아웃하고, Observe에서 모니터링하며, 문제가 발생하면 롤백할 수 있습니다.
문제점
버그 찾기
모니터링이나 지원팀에서 깨진 화면을 보고합니다. 수정은 JavaScript나 CSS 몇 줄이면 됩니다.
새 바이너리 빌드
버전을 올리고 iOS와 Android용으로 빌드한 뒤, 스토어 제출 두 건을 준비합니다.
심사 대기
스토어 리뷰는 보통 24~48시간, 때로는 훨씬 더 걸립니다. 거절되면 대기가 처음부터 다시 시작됩니다.
사용자 업데이트 대기
승인 후에도 각 사용자는 새 버전을 설치해야 합니다. 그때까지는 구버전 code를 실행합니다.
각 단계마다 수정이 준비된 뒤 사용자 기기에서 실행되기까지 시간이 더 걸립니다.
24–48시간+
일반적인 스토어 심사 시간
Apple과 Google은 모든 새 바이너리를 심사합니다. 심사는 보통 24~48시간, 때로는 훨씬 오래 걸리며, 반려되면 다시 제출해야 합니다.
사용자당
스토어 업데이트는 기기마다 다름
스토어 업데이트는 사용자가 직접 설치하거나 자동 업데이트 설정이 설치할 때만 기기에 도달합니다. 일부 기기는 한참 동안 이전 빌드에 머뭅니다.
2개 스토어
수정할 때마다 두 번 제출
같은 웹 수정이 App Store와 Google Play를 각각 거치며, 각각 별도의 심사와 릴리스가 필요합니다.
솔루션
이것은 Capgo의 기본 업데이트 동작입니다. 업데이트 프롬프트도, 강제 재시작도, 웹 레이어 변경을 위한 스토어 제출도 없습니다.
앱이 포그라운드로 전환될 때와 앱이 열려 있는 동안 10분마다, 업데이터가 Capgo에 해당 채널의 최신 bundle을 요청합니다.
포그라운드 전환 시
사용자가 현재 버전을 사용하는 동안 새 bundle이 다운로드됩니다. delta 업데이트를 사용하면 변경된 파일만 다운로드됩니다.
중단 없음
사용자가 앱을 나가면 업데이터가 bundle을 설치합니다. 다음에 앱을 열면 새 버전이 실행됩니다.
다음 포그라운드 전환 시
사용자가 앱을 열자마자 새 버전을 보게 해야 하나요? Direct update 모드를 사용하면 앱 실행 시 스플래시 화면이 표시되는 동안 업데이트가 적용됩니다.
Direct updates 알아보기작동 방식
이미 스토어에 출시된 Capacitor 앱의 일반적인 릴리스 과정입니다. 아래 모든 명령어는 Capgo CLI 문서에서 가져온 것입니다.
설정 마법사를 실행한 후, 앱이 시작될 때 notifyAppReady()를 호출하는지 확인하세요. 이 호출이 없는 번들은 자동으로 롤백됩니다.
npx @capgo/cli@latest init
# in your app start-up code
await CapacitorUpdater.notifyAppReady() notifyAppReady() 문서 --delta를 사용해 변경된 파일만 가져오게 하고, --rollout으로 소수의 기기부터 배포를 시작하세요. 나머지 기기는 안정적인 번들을 그대로 유지합니다.
npx @capgo/cli@latest bundle upload --channel production --delta --rollout 5 Progressive rollouts 문서 실패율 임계값으로 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 문서 지표가 정상적으로 보이면 해당 채널의 모든 기기에 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
변경된 파일만 다운로드됩니다
채널의 무작위 고정 비율에 새 번들을 보내고, 나머지는 안정적인 번들에 유지합니다. CLI 또는 콘솔에서 비율을 높이거나, 승격하거나, 롤백할 수 있습니다.
1–5%
일반적인 첫 번째 롤아웃 단계
모든 업데이트는 제대로 시작되는지 증명해야 합니다. 새 bundle이 제때 notifyAppReady()를 호출하지 않으면 기기는 마지막 정상 bundle로 돌아가고, 새 bundle은 실패로 표시됩니다.
10초
자동 롤백 전 기본 appReadyTimeout
Capgo는 JavaScript, CSS, 에셋으로 구성된 Capacitor 웹 레이어를 제공합니다. 네이티브 바이너리, 플러그인, 권한, entitlements, 앱 스토어 메타데이터는 변경하지 않습니다. 스토어 심사는 앱마다 다르므로 정책 준수와 승인 책임은 사용자에게 있습니다.
Live Updates 도입 후 일상적인 릴리스 작업입니다. 각 카드는 문서로 연결됩니다.
채널의 bundle을 변경한 뒤 silent update 알림을 보내면, 디바이스가 다음 포그라운드 진입 때가 아니라 즉시 업데이트를 확인합니다.
업데이트 알림 보내기채널에서 메이저 업데이트를 차단해 새 native code가 필요한 bundle이 오래된 binary에 도달하지 않도록 하세요.
버전 타겟팅 문서Capgo는 2021년부터 프로덕션 앱에 라이브 업데이트를 제공해 왔습니다.
팀의 요구에 맞는 솔루션을 찾아보세요
Capacitor로 빌드된 앱
날씨, 공공 보건, 통신 앱은 정확한 인터페이스, 알림, 내비게이션에 의존합니다. 프로덕션 업데이트를 사용하면 승인된 인터페이스 수정 사항을 배포하는 동시에, 범위를 넓히기 전 사용자 채택률을 모니터링할 수 있습니다.
지도, 알림, 내비게이션 수정을 프로덕션에 신중히 배포해야 하는 날씨 앱.
가이드와 서비스 정보에 빠르고 신뢰할 수 있는 업데이트가 필요한 공공 보건 앱.
알림과 계정 화면이 자주 변경되는 통신사 계정 앱입니다.
drivolino GmbH 리드 개발자
“Capgo Capacitor Updater 플러그인 덕분에 업데이트 배포 방식이 완전히 바뀌었습니다. 며칠씩 걸리던 작업이 이제는 단 몇 분 만에 끝납니다.”
NuTriQ 창립자
“App Store의 전체 리뷰 주기를 기다리지 않고 프로덕션 OTA 업데이트를 즉시 푸시할 수 있다는 점은 운영상 엄청난 이점이었습니다.”
데이터 지표
“업데이터 플러그인 정말 잘 만드셨네요. 제 환경에서는 완벽하게 동작하고, 라이브 업데이트 덕분에 테스트 주기가 훨씬 빨라졌습니다.”
자주 묻는 질문
업데이트가 기기에 전달되는 방식과 문제가 생겼을 때 대처하는 방법.
기본적으로 앱은 포그라운드로 전환될 때와 열려 있는 동안 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는 웹 레이어(JavaScript, HTML, CSS, 에셋)를 교체합니다. 네이티브 플러그인, Capacitor 업그레이드, capacitor.config 변경, iOS 또는 Android 프로젝트 파일은 스토어 릴리스가 필요합니다. Capgo는 업로드 시 번들의 네이티브 호환성을 검사하고, 채널은 구버전 바이너리로의 업데이트를 차단할 수 있습니다.
네이티브 호환성 문서트라이얼 기간에 내 앱에서 전체 플로우를 직접 해보세요: 번들 업로드, 일부 기기에 롤아웃, 롤백까지.