내용으로 건너뛰기
Capgo - Capacitor 앱의 Live Updates Capgo

업데이트 유형

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

적용 시간

“적용 시간”이라는 제목을 가진 섹션

제어 다운로드된 업데이트 후 적용되는 시간 when

Type설명사용 사례
기본값배경화면 또는 앱 종료 시 다운로드 후 적용대부분의 앱; 최소한의 간섭
directUpdate: atInstall새 사용자에게 최신 버전 제공; 기존 사용자는 기본 흐름 사용directUpdate:
설치, 스토어 업데이트 또는 앱 종료 후 즉시 적용 onLaunch최신성과 세션 안정성의 균형__CAPGO_KEEP_0__
직접 업데이트: always다운로드 중인 모든 업데이트에 대해 즉시 적용 (재개 시도 포함)중요한 수정, 상태가 단순한 앱

설정하기 capacitor.config.ts:

plugins: {
  CapacitorUpdater: {
    directUpdate: false, // default
    // or: 'atInstall' | 'onLaunch' | 'always'
  }
}

지연 조건

‘지연 조건’ 섹션

이행해야 하는 조건 업데이트가 설치되기 전에 사용하세요. 모두 충족되어야 하는 조건이 있는 경우에 그들을 결합하세요. setMultiDelay 조건

설명예시날짜
특정 날짜/시간 이후에 기다리세요.서버 측 릴리즈와 동기화하세요.앱이 백그라운드에 있을 때 최소 지속 시간 (ms) 기다리세요.
빠른 앱 Switching을 피하세요.quick app switches를 피하세요.quick app switches를 피하세요.
원생 버전최소 원생 바이너리 버전을 요구합니다.원생 code이 불일치할 경우 업데이트를 차단합니다.
kill다음 앱 kill 이벤트까지 기다립니다.전체 재시작 시에만 적용합니다.
import { CapacitorUpdater } from '@capgo/capacitor-updater';


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

버전 차단 (채널 정책)

버전 차단 (채널 정책)

어떤 semver 업데이트 채널이 자동으로 전달할 --disable-auto-update 채널을 통해

전략차단허용사용 사례
없음업데이트가 전혀모든 업데이트기본; 전체 자동 업데이트
major0.0.0 → 1.0.0같은 메이저 버전 (예: 1.x → 1.y)기존 네이티브에서 깨지는 변경을 막아줍니다.
minor0.0.0 → 1.1.0, 1.1.0 → 1.2.0같은 메인 버전 (예: 1.2.x → 1.2.y)메이저 버전 내에서 더 엄격한 제어
patch메이저 버전 바뀌지 않는 모든 변경0.0.311 → 0.0.314patch-only 업데이트로 매우 엄격합니다.
메타데이터업데이트 없이 min_update_version업데이트와 명시적인 호환성 메타데이터번들당의 사용자 지정 호환성 규칙
터미널 창
npx @capgo/cli channel set production --disable-auto-update major

배송 유형

배송 유형

배송 방법 bundle이 장치로 전달되는 방식 형식

설명사용 시기전체 배달
전체 JS 배달이 다운로드됩니다.첫 번째 설치, 큰 변경 사항, 또는 델타가 사용할 수 없을 때첫 번째 설치, 큰 변경 사항, 또는 델타가 사용할 수 없을 때
델타 (매니페스트)변경된 파일만 다운로드대부분의 업데이트; 더 빠르고 대역폭 친화적
터미널 창
# Full bundle (default)
npx @capgo/cli bundle upload --channel production


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

빠른 참조

빠른 참조 섹션
카테고리타입
적용 시간기본 atInstall, onLaunch, always
지연 조건date, background, nativeVersion, kill
버전 차단none, major, minor, patch, metadata
배달전체 번들, 델타 (매니페스트)
관련 섹션