설명서

Capgo의 Live Updates 기능을 사용하여 앱의 자바스크립트 번들을 실시간으로 원격으로 업데이트할 수 있습니다. iOS, Android 및 Electron에서 사용자에게 직접 JS 업데이트를 푸시하여 버그를 고치고 새로운 기능을 더 빠르게 배포할 수 있습니다.

주의

code의 네이티브 업데이트는 자바스크립트 번들의 변경만 지원합니다. 플러그인 추가 또는 제거, 네이티브 프로젝트 구성 변경과 같은 네이티브 code 업데이트가 필요할 경우, 일반적인 플랫폼 배포 프로세스를 통해 새로운 바이너리 빌드를 제출해야 합니다.

공개 자산 모델

Capgo에 업로드된 암호화되지 않은 번들은 공개 배포 자산으로 처리해야 합니다. 채널은 업데이트 대상 장치를 결정하지만 채널의 개인 정보는 underlying 번들의 비밀을 제공하지 않습니다. 암호화는 저장 및 전송에서 보호를 제공하고第三자들이 유효한 암호화된 업데이트를 생성하는 것을 막지만, 앱이 포함된 공개 키를 사용하여 복호화할 수 있기 때문에 shipped 웹 자산은 검사할 수 없습니다. end-to-end 암호화 정확한 위협 모델을 참조하십시오.

라이브 업데이트 작동 방식

Capgo의 Live Update 시스템은 두 가지 주요 구성 요소를 가지고 있습니다:

1. Capgo SDK을 앱에 설치하고 SDK는 사용 가능한 업데이트 확인 및 배경에서 다운로드합니다.

2. 채널, 사용자 그룹을 대상으로 업데이트 관리를 할 수 있습니다. 채널을 사용하여 다양한 릴리즈 트랙을 관리할 수 있습니다. Production, Staging, Dev.

라이브 업데이트 업로드 시 Capgo에 새로운 JS 번들을 업로드하고 채널 assign 시 Capgo SDK는 해당 채널에 구성된 앱에서 업데이트 감지 및 다운로드합니다. 앱이 재시작 시 새로운 번들이 로드됩니다.

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

• 즉시 롤아웃 x-ray:
• 디바이스별 타임라인은 체크, 다운로드, 설치, 정책 차단, 롤백을 보여주어 정확히 무슨 일이 일어났는지 알 수 있습니다. 추측이나 "내폰에서는 작동한다"의 논쟁이 없습니다.: 사용자들이 지원에 몰려들기 전에, 예를 들어, 속도 제한, 체크섬 오류, notifyAppReady 누락과 같은 경고 코드가 표시되도록 해서, 몇 분 만에 수정 또는 롤백을 수행할 수 있습니다.
• : 채널 정책 증명: 로그가 실제로 프로덕션을 보호하기 위해 주요 버전을 차단하거나 에뮬레이터/개발자 빌드를 비활성화하거나 플랫폼 제한을 활성화하는 경비대 (guardrails)를 확인합니다.
• : 수익 및 명성 보호: 업데이트 속도가 느려지거나 플랜 제한에 부딪히면, 변환, 세션, 리뷰가 감소하기 전에 intervene할 수 있도록 업데이트 상태를 확인할 수 있습니다.
• : 단일 진실의 근원: 제품, QA, 및 지원 팀이 동일한 클라우드 로그 스트림을 공유하므로, Xcode/Android Studio를 통해 로그를 찾거나 엔지니어에게 DM을 보내는 것을 피할 수 있습니다.

: 시작하기

: Live Updates를 사용하기 위해 다음 단계를 따르십시오.

1. : __CAPGO_KEEP_0__ 빠른 시작 : Capgo 빠른 시작 앱을 Capgo에 설정하고 Capgo SDK를 설치하세요.

2. 앱 code에서 다음을 호출하세요. CapacitorUpdater.notifyAppReady() Capgo SDK가 앱이 업데이트 받을 준비가 되었는지 알리기 위해 앱이 초기화가 끝난 후에 호출하세요.

3. JS 번들을 빌드하고 Capgo에 업로드하세요:

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

4. 업데이트를 다운로드하기 위해 앱을 열고 기다리세요. 상태를 확인하려면:

   npx @capgo/cli@latest app debug

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

라이브 업데이트의 Live Updates를 배포하는 방법 자세한 내용은 안내서를 참조하세요.

다음 단계

업데이트 유형

OTA 업데이트의 모든 유형에 대한 참조: 적용 시간, 지연 조건, 버전 차단 및 전달.

채널

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

진행적 롤아웃

특정 사용자에게 업데이트를 대상으로하는 후보 버전을 지속적으로 배포하고 모니터링한 후 승격하거나 롤백하세요.

롤백

업데이트가 문제를 일으키면 이전 JS 버전으로 롤백하는 방법을 알아보세요.

업데이트 동작

앱에서 업데이트가 다운로드되고 적용되는 방법과 시간을 조절하세요.

자연스러운 + OTA 워크플로우

개발/운영 채널과 --fail-on-incompatible, 그리고 네이티브 code가 의도적으로 변경되었을 때 업로드하는 방법.

네이티브 빌드 테스트

네이티브 바이너리 없이 다운로드된 live update가 패키지된 웹 자산을 가리는 것을 피하기 위해 네이티브 바이너리를 검증하세요.

빠른 업데이트

빠른 업데이트를 사용하여 업데이트 프로세스를 가속화하는 방법을 알아보세요.

Overview에서 계속

앱을 사용 중이라면 Overview 라이브 업데이트를 위해 스토어 승인 및 배포를 계획하고 연결하세요. capgo/capacitor 인앱 리뷰 capgo/capacitor 인앱 리뷰의 구현 세부 사항 capgo/capacitor 인앱 리뷰 사용 capgo/capacitor 인앱 리뷰의 네이티브 기능 capgo/capacitor 네이티브 마켓 capgo/capacitor 네이티브 마켓의 구현 세부 사항 capgo/capacitor 네이티브 마켓 사용 capgo/capacitor 네이티브 마켓의 네이티브 기능 Capacitor OTA 업데이트: 앱 스토어 승인 안내서 Capacitor OTA 업데이트: 앱 스토어 승인 안내서의 실용적인 맥락