개요

Capgo의 Live Updates 기능을 사용하면 앱의 JavaScript bundle을 실시간으로 원격 업데이트할 수 있습니다. 스토어 심사 과정을 거치지 않고도 iOS, Android, Electron 사용자에게 JS 업데이트를 직접 푸시하여 버그를 수정하고 새로운 기능을 더 빠르게 배포하세요. 제품 개요 및 FAQ는 다음을 참조하세요: Capacitor 라이브 업데이트 capgo.app 에서 확인하실 수 있습니다.

참고

Live Updates는 JavaScript bundle 변경 사항에만 적용됩니다. 플러그인을 추가/삭제하거나 네이티브 프로젝트 설정을 변경하는 등 네이티브 code 업데이트가 필요한 경우에는 일반적인 플랫폼 배포 프로세스를 통해 새로운 binary build를 제출해야 합니다.

Public Asset 모델

Capgo에 upload된 암호화되지 않은 bundle은 공개 배포 자산으로 간주해야 합니다. Channel은 어떤 기기에 업데이트를 제공할지 결정하지만, channel의 프라이버시 설정이 내부 bundle을 기밀로 유지해주지는 않습니다. 암호화는 저장 및 전송 시 보호 기능을 제공하며 제3자가 유효한 암호화 업데이트를 생성하는 것을 방지하지만, 앱 내에 복호화에 필요한 공개 키가 포함되어 있으므로 배포된 웹 자산의 검사를 완전히 차단할 수는 없습니다. 자세한 내용은 종단간 암호화(end-to-end encryption) 정확한 위협 모델을 위해.

Live Updates 작동 방식

Capgo의 Live Update 시스템은 두 가지 핵심 구성 요소로 이루어져 있습니다:

1. 앱에 설치하는 Capgo SDK. SDK는 사용 가능한 업데이트를 확인하고 백그라운드에서 다운로드합니다.

2. 특정 사용자 그룹을 대상으로 업데이트를 배포할 수 있는 Channels가 있습니다. Channels를 사용하면 다음과 같은 다양한 릴리스 트랙을 관리할 수 있습니다. Production, Staging, 그리고 Dev.

Capgo에 새로운 JS bundle을 upload하고 채널에 할당하면, 해당 채널에 설정된 앱의 Capgo SDK가 업데이트를 감지하고 download합니다. 다음에 앱이 재시작되면 새로운 bundle이 로드됩니다.

Capgo 로그가 중요한 이유 (마케팅 관점)

• 모든 롤아웃에 대한 즉각적인 분석: 기기별 타임라인을 통해 체크, 다운로드, 설치, 정책 차단 및 롤백 내역을 확인할 수 있습니다. 추측하거나 “내 폰에서는 되는데?”라며 논쟁할 필요 없이 정확히 어떤 일이 일어났는지 파악하세요.
• 더 빠른 장애 대응: 알림 형태의 코드(예: rate limits, checksum fails, notifyAppReady misses)가 사용자 문의가 폭주하기 전에 노출되므로, 몇 분 안에 수정 버전을 배포하거나 롤백할 수 있습니다.
• 채널 정책 검증: 로그를 통해 가드레일(메이저 버전 차단, 에뮬레이터/dev build 비활성화, 플랫폼 제한 등)이 프로덕션을 안전하게 보호하고 있는지 확인할 수 있습니다.
• 수익 및 평판 보호: 네트워크 상태가 좋지 않아 업데이트가 중단되거나 플랜 제한에 걸리는 시점을 파악하여, 전환율, 세션 수 또는 리뷰가 떨어지기 전에 조치를 취할 수 있습니다.
• 단일 진실 공급원 (Single source of truth): 제품, QA, 지원 팀이 동일한 클라우드 로그 스트림을 공유합니다. 네이티브 로그를 찾으려고 Xcode나 Android Studio를 뒤지거나 엔지니어에게 DM을 보낼 필요가 없습니다.

시작하기

Live Updates를 시작하려면 다음 단계를 따르세요:

1. 다음을 완료하세요: Capgo 빠른 시작하기 Capgo에 앱을 설정하고 Capgo SDK를 설치하려면 Capgo Quickstart를 참고하세요.

2. 앱의 code에서 다음을 호출하세요: CapacitorUpdater.notifyAppReady() 앱 초기화가 완료된 후 호출합니다. 이를 통해 Capgo SDK에 앱이 업데이트를 받을 준비가 되었음을 알립니다.

3. JS bundle을 빌드하고 Capgo에 upload하세요:

   npm run build
   npx @capgo/cli@latest bundle upload --channel=production

4. Open your app and wait for the update to download. You can check the status with:

   npx @capgo/cli@latest app debug

5. 업데이트가 다운로드되면 앱을 닫았다가 다시 열어 새 bundle을 로드하세요.

전체 권한 목록은 Live Updates 배포하기 자세한 내용은 가이드를 참조하세요.

다음 단계

업데이트 요청에 자체 호스트네임을 사용하려면 다음을 따르세요: 커스텀 도메인 설정 가이드.

업데이트 유형

모든 OTA 업데이트 유형 레퍼런스: 적용 시점, 지연 조건, 버전 차단, 배포 방식.

채널

채널로 다양한 릴리스 트랙을 관리하고 특정 사용자에게 업데이트를 타겟팅하는 방법을 알아보세요.

단계적 배포

고정 코호트에 후보 번들을 배포하고 모니터링한 뒤, 승격하거나 롤백하세요.

롤백

업데이트로 인해 문제가 발생하면 이전 JS 번들 버전으로 롤백하는 방법을 알아보세요.

업데이트 동작

앱에서 업데이트를 다운로드하고 적용하는 방식과 시점을 커스텀하세요.

Native + OTA 워크플로우

Dev/production 채널과 --fail-on-incompatible, 네이티브 code을 의도적으로 변경했을 때 업로드하는 방법.

Native Build 테스트

다운로드된 live update이 번들된 웹 에셋을 가리지 않는 상태에서 네이티브 바이너리를 검증하세요.

빠른 업데이트

fast updates로 업데이트 프로세스 속도를 높이는 방법을 알아보세요.

Overview에서 계속하기

사용 중인 경우 개요 스토어 승인과 배포를 계획하려면, 다음 항목과 연결하세요: @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 승인 가이드에서.