업데이트 유형

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

적용 시간

제어 다운로드 후 업데이트 적용 시간 타입

설명	사용 사례	autoUpdate:
백그라운드에서 다운로드 후 사용자가 앱을 백그라운드나 종료할 때 업데이트 적용 atBackground	대부분의 앱; 최소한의 간섭	when user backgrounds or kills the app
자동 업데이트: atInstall	새로운 설치 또는 앱 스토어 업데이트 시 즉시 적용	새로운 사용자는 최신 버전을 받고, 기존 사용자는 기본 흐름을 사용
자동 업데이트: onLaunch	설치, 스토어 업데이트 또는 앱 종료 후 즉시 적용	최신성과 세션 안정성의 균형
자동 업데이트: always	다운로드 중인 업데이트에 대해 즉시 적용 (재개 시도 포함)	중요한 수정 사항, 상태가 간단한 앱
자동 업데이트: onlyDownload	자동 다운로드 및 전송 updateAvailable하지만 자동으로 적용하거나 다음 번들 설정하지 않음	앱이 자신의 업데이트 알림을 표시하거나 업데이트 호출을 언제 호출할지 정확하게 제어하는 경우 set()

설정 capacitor.config.ts:

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

팁

전체 세부 정보 및 스플래시 스크린 처리에 대해서는 업데이트 동작.

지연 조건

업데이트가 설치되기 전에 충족해야 하는 조건 업데이트가 설치되기 전에 업데이트가 설치되기 전에 setMultiDelay 그들을 결합 (모든 조건이 충족되어야 함).

조건	설명	예시
날짜	특정 날짜/시간까지 기다리세요.	서버 측 릴리즈와 동기화하세요.
백그라운드	앱이 백그라운드에 있을 때 최소 지연 시간 (ms) 이후 기다리세요.	빠른 앱 Switch를 피하세요.
네이티브 버전	네이티브 바이너리 버전의 최소 요구 사항	code 업데이트를 불일치하는 네이티브 블록에 적용합니다.
kill	앱 종료 이벤트가 발생할 때까지 기다립니다.	전체 재시작 시에만 적용합니다.

import { CapacitorUpdater } from '@capgo/capacitor-updater';

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

위험

The kill 조건이 첫 번째 kill 이벤트 후에 트리거되며, 다른 배경과 달리 다음 이벤트가 아닌 것입니다. 향후 릴리스에서 수정될 예정입니다.

버전 차단 (채널 정책)

버전 차단 (채널 정책) 섹션에 대한 제어 semver 업데이트 채널이 자동으로 전달합니다. 설정 방법 --disable-auto-update 채널

전략	블록	허용	사용 사례
없음	Nothing	모든 업데이트	기본; 전체 자동 업데이트
메이저	0.0.0 → 1.0.0	같은 메이저 (예: 1.x → 1.y)	기존 네이티브에 도달하는 변경 사항을 막습니다.
소수	0.0.0 → 1.1.0, 1.1.0 → 1.2.0	같은 소수 (예: 1.2.x → 1.2.y)	메이저 내에서 엄격한 제어
패치	패치 버전 외의 모든 변경	0.0.311 → 0.0.314	패치만 업데이트하는 매우 엄격한 제어
메타데이터	업데이트가 없는 min_update_version	업데이트가 있는	Bundle별 맞춤형 호환성 규칙

npx @capgo/cli channel set production --disable-auto-update major

주의

patch 그리고 metadata 주의한 설정이 필요합니다. 자세한 내용은 CLI 명령 및 버전 대상 설정 세부 사항을 참조하십시오.

배송 유형

Capgo는 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)를 사용할 때, 다운로드 시간을 최소화하고 UX를 향상시키기 위해 델타 업데이트

빠른 참조

카테고리	타입
적용 시간 설정	off, atBackground, atInstall, onLaunch, always, onlyDownload
지연 조건	date, background, nativeVersion, kill
버전 차단	none, major, minor, patch, metadata
배포	전체 번들, 델타 (매니페스트)

관련

• 업데이트 동작 — 적용 시간 및 지연 설정 구성
• 버전 대상 설정 — 채널 기반 버전 라우팅
• 델타 (매니페스트) 업데이트 — 부분 다운로드를 위한 설정
• 채널 — 채널 설정 및 우선순위

업데이트 유형에서 계속

__CAPGO_KEEP_0__ Live Updates를 사용 중이라면 업데이트 유형 __CAPGO_KEEP_0__ Live Updates와 연결하여 Capgo Live Updates를 위한 제품 워크플로우에 Capgo Live Updates를 사용 중이라면 개요 __CAPGO_KEEP_0__ 기능 __CAPGO_KEEP_1__ 업데이트 동작 __CAPGO_KEEP_2__ 시작하기 __CAPGO_KEEP_3__