업데이트 유형

__CAPGO_KEEP_0__ 설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함하는 설정 지시어를 복사하십시오.

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

__CAPGO_KEEP_0__

__CAPGO_KEEP_2__ __CAPGO_KEEP_3__ __CAPGO_KEEP_4__ periodCheckDelay __CAPGO_KEEP_5__

__CAPGO_KEEP_6__	__CAPGO_KEEP_7__	__CAPGO_KEEP_8__
__CAPGO_KEEP_9__ `atBackground`	__CAPGO_KEEP_10__	__CAPGO_KEEP_11__
자동 업데이트: `atInstall`	새로 설치하거나 네이티브 앱 스토어 업데이트가 끝난 후에만 즉시 적용; 그렇지 않으면 `atBackground`	새 사용자는 최신 버전을 받고; 기존 사용자는 배경 적용을 사용합니다.
자동 업데이트: `onLaunch`	cold start (kill → foreground) 에서 즉시 적용; 그 다음 `atBackground`	최신성과 세션 안정성의 균형
자동 업데이트: `always`	전면 전환 시마다 확인하고 업데이트가 있을 때마다 즉시 적용	중요한 수정, 상태가 간단한 앱
자동 업데이트: `onlyDownload`	전면 전환 시마다 확인하고 다운로드를 자동으로 하되, `updateAvailable`자동으로 적용하지 않습니다.	업데이트를 직접 제어하거나 업데이트 알림을 표시하는 앱 `set()`

설정 capacitor.config.ts:

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

지연 조건

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

조건	설명	예시
날짜	특정 날짜/시간까지 기다리세요.	서버 측 릴리즈와 동기화하세요.
배경	앱이 배경화면이 된 후 최소 지속 시간 (ms) 기다리세요.	빠른 앱 Switching을 피하세요.
네이티브 버전	최소 네이티브 바이너리 버전을 요구하세요.	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' },
  ],
});

버전 차단 (채널 정책)

__CAPGO_KEEP_0__ semver 업데이트 채널이 자동으로 전달합니다. 설정 방법 --disable-auto-update 채널

전략	블록	허용	사용 사례
없음	Nothing	어떤 타겟 번들 버전	기본; 전체 자동 업데이트
메이저	__CAPGO_KEEP_0__보다 높은 메이저 버전 `version_build`__CAPGO_KEEP_0__보다 낮은 메이저 버전 `1.2.3 -> 2.0.0`	, 예를 들어 `1.2.3 -> 1.9.0` __CAPGO_KEEP_0__와 동일한 메이저 버전 `1.2.3 -> 1.2.4`	Prevent breaking changes from reaching old native code
__CAPGO_KEEP_0__의 오래된 네이티브 버전으로부터 깨지는 변경 사항을 막기 위해	__CAPGO_KEEP_0__의 메이저 버전이 낮은 경우 `version_build`__CAPGO_KEEP_0__의 메이저 버전과 메이저 버전이 다른 경우 `1.2.3 -> 1.3.0`	__CAPGO_KEEP_0__의 메이저 버전과 메이저 버전이 다른 경우, 예를 들어 `1.2.3 -> 1.2.4`	__CAPGO_KEEP_0__의 메이저 버전과 메이저 버전이 동일한 경우, 예를 들어
__CAPGO_KEEP_0__의 네이티브 메이저 버전 내에서 업데이트를 유지하기 위해	__CAPGO_KEEP_0__의 패치 버전 `1.0.0 -> 1.0.1`	Only 접미사 변경은 `MAJOR.MINOR.PATCH` 이동하지 않으면서 동일한, 예를 들어 `1.0.0-beta.1 -> 1.0.0-beta.2` or `1.0.0+build.1 -> 1.0.0+build.2`	Strictest 모드: 코어 버전 이동이
메타데이터	누락 `min_update_version`, 또는 `version_build` 아래에	목표 번들을 `min_update_version` 보다 작거나 같은 `version_build`	사용자 지정 호환성 규칙 per 번들

이 검사들은 목표 번들을 원래 baseline에 비교합니다. version_build아직 설치된 다운로드 된 패키지를 보낸 version_name.

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

배송 유형

Capgo가 bundle이 장치로

타입	설명	사용할 때
전체 bundle	전체 JS bundle이 다운로드	처음 설치, 큰 변경 사항, 또는 델타가 unavailable일 때
델타(매니페스트)	변경된 파일만 다운로드	Most updates; 빠른 속도와 대역폭 친화적인 업데이트입니다.

# 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`
배포	전체 번들, 델타 (매니페스트)

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