Skip to content
Capgo - Capacitor 앱을 위한 Live Updates Capgo

업데이트 유형

Capgo은 여러 종류의 오버 더 에어(OTA) 업데이트 지원합니다. 이 페이지는 모든 유형을 나열하고 설명하여 앱에 적합한 combination을 선택할 수 있도록 합니다.

적용 시간

Apply Timing

제어 when 업데이트가 다운로드된 후 적용되는 시간을 제어합니다. 플러그인은 앱이 전면으로 이동할 때 업데이트를 확인하고 앱이 열려 있는 동안 반복 타이머를 사용하여 업데이트를 확인합니다. periodCheckDelay 제어하는 간격(기본 10분)

유형설명사용 사례
context atBackground페이지/영역: Capgo 솔루션 마케팅 페이지. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 보이는 곳: 페이지 솔루션/코르도바에서 카파시터 AI.astro. 메시지 키 `solutions_cordova_to_capacitor_ai_table_use_case` (Solutions Cordova To Capacitor Ai Table Use Case).대부분의 앱; 최소한의 중단
autoUpdate: atInstall새로운 설치나 네이티브 앱 스토어 업데이트 후에 즉시 적용; 그렇지 않으면 atBackground새 사용자는 최신 버전을 받고; 기존 사용자는 배경에서 적용
autoUpdate: onLaunch냉각 시작 (죽음 → 전면) 후에 즉시 적용; 그렇지 않으면 atBackground최신성과 세션 안정성의 균형
autoUpdate: always전면 전환 시마다 확인하고 업데이트가 있을 때 즉시 적용중요한 수정, 상태가 단순한 앱
autoUpdate: onlyDownload자동으로 확인하고 다운로드하고, emit updateAvailable그리고 자동으로 적용하지 않습니다.자체 업데이트 알림을 표시하거나 업데이트 호출을 정확히 제어하는 앱 set()

설정 capacitor.config.ts:

plugins: {
  CapacitorUpdater: {
    autoUpdate: 'atBackground', // default; true is still accepted
    // or: 'off' | 'atInstall' | 'onLaunch' | 'always' | 'onlyDownload'
  }
}

지연 조건

지연 조건 섹션

조건 앞서서 업데이트가 설치됩니다. setMultiDelay 이를 결합하여 (모든 조건이 충족되어야 함).

조건설명예시
날짜특정 날짜/시간 이후 기다립니다.서버 측 릴리스와 동기화
백그라운드앱이 백그라운드에 있을 때 최소 지속 시간 (ms) 기다립니다.빠른 앱 전환을 피하기 위해
네이티브 버전__CAPGO_KEEP_0__code
__CAPGO_KEEP_0__다음 앱 종료 이벤트까지 기다립니다.전체 재시작 시에만 적용
import { CapacitorUpdater } from '@capgo/capacitor-updater';


await CapacitorUpdater.setMultiDelay({
  delayConditions: [
    { kind: 'date', value: '2023-06-01T00:00:00.000Z' },
    { kind: 'background', value: '60000' },
  ],
});

버전 차단 (채널 정책)

__CAPGO_KEEP_0__

제어하는 semver 업데이트 채널이 자동으로 전달할 --disable-auto-update 설정 via

전략차단허용사용 사례
없음nothing어떤 타겟 버전기본; 전체 자동 업데이트
주요 업데이트더 높은 주요 업데이트 version_build, 예를 들어 1.2.3 -> 2.0.0같은 주요 업데이트, 예를 들어 1.2.3 -> 1.9.0 또는 1.2.3 -> 1.2.4기존 네이티브 code에서 깨지지 않는 변경을 방지
소수 업데이트다른 주요 또는 소수 업데이트 version_build, 예를 들어 1.2.3 -> 1.3.0같은 주요 및 소수, 예를 들어 1.2.3 -> 1.2.4업데이트를 한 네이티브 소수 라인 내에 유지
패치어떤 주요, 부수, 또는 패치 번호 변경, 예를 들어 1.0.0 -> 1.0.1수식어만 변경되며 MAJOR.MINOR.PATCH 동일한, 예를 들어 1.0.0-beta.1 -> 1.0.0-beta.2 또는 1.0.0+build.1 -> 1.0.0+build.2strictest 모드: 코어 버전 이동이 없음
메타데이터없는 min_update_version, 또는 version_build 아래에목표 번들을 위한 min_update_version 은 또는 version_build사용자 정의 호환성 규칙 per 번들

이러한 검사는 대상 번들을 native baseline으로 비교합니다. version_build현재 설치된 다운로드된 번들이 아닌 version_name.

터미널 창
npx @capgo/cli channel set production --disable-auto-update major

배포 유형

배포 유형 섹션

어떻게 번들 장치로 전송됩니다.

유형설명사용할 때
전체 번들전체 JS 번들이 다운로드됩니다.첫 번째 설치, 큰 변경 사항, 또는 델타가 unavailable일 때
컨텍스트: Capgo Builder / 네이티브 클라우드 빌드 제품 페이지. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 메시지 키 `native_build_builder_credit_first` (네이티브 빌드 빌더 크레딧 퍼스트).변경된 파일만 다운로드대부분의 업데이트; 더 빠르고 대역폭 친화적
터미널 창
# Full bundle (default)
npx @capgo/cli bundle upload --channel production


# Delta updates
npx @capgo/cli bundle upload --channel production --delta

빠른 참조

Quick Reference
분류유형
적용 시간off, atBackground, atInstall, onLaunch, always, onlyDownload
지연 조건date, background, nativeVersion, kill
버전 차단none, major, minor, patch, metadata
배포전체 패키지, 델타 (매니페스트)
업데이트 동작

계속 업데이트 유형

계속 업데이트 유형

업데이트 유형을 사용하여 실시간 업데이트 배포를 계획하는 경우 __CAPGO_KEEP_0__ 실시간 업데이트 Capgo Live Updates for the product workflow in Capgo Live Updates, 개요 개요 에서 구현 세부 정보에 대해 기능 기능 에서 구현 세부 정보에 대해 업데이트 동작 업데이트 동작 에서 구현 세부 정보에 대해 시작하기 시작하기 에서 구현 세부 정보에 대해