업데이트 유형

이 설정 프롬프트를 설치 단계와 이 플러그인의 전체 마크다운 가이드와 함께 복사합니다.

Capgo은 여러 종류의 오버 더 에어(OTA) 업데이트 유형을 지원합니다. 이 페이지는 앱에 맞는 올바른 combination을 선택할 수 있도록 OTA 업데이트 유형을 목록하고 설명합니다.

적용 시간

제어 언제 다운로드 후 적용되는 업데이트입니다. 플러그인은 앱이 전면으로 이동할 때와 앱이 열려 있는 동안 반복 타이머를 사용하여 업데이트를 확인합니다. periodCheckDelay 업데이트 주기 조절 (기본 10분)

유형	설명	사용 사례
자동 업데이트: `atBackground`	앱이 전면으로 이동할 때마다 확인하고 다운로드하고, 앱이 배경으로 이동할 때 적용	대부분의 앱; 최소한의 간섭
자동 업데이트: `atInstall`	새로운 사용자가 최신 버전을 받고, 기존 사용자가 배경에서 적용 `atBackground`	새 사용자는 최신 버전을 받고, 기존 사용자는 배경에서 적용
자동 업데이트: `onLaunch`	즉시 적용 (cold start 시 foreground → killed); 그 후 freshness 와 session stability 사이의 균형 `atBackground`	새로운 버전과 세션 안정성 사이의 균형
autoUpdate: `always`	foreground 전환 시마다 확인하고 업데이트 가능 시 즉시 적용	중요한 수정, 상태가 단순한 앱
autoUpdate: `onlyDownload`	자동 확인 및 다운로드, emit `updateAvailable`, 자동 적용하지 않음	자신의 업데이트 알림을 보여주거나 업데이트 시기를 정확히 제어하는 앱 `set()`

설정하기 capacitor.config.ts:

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

지연 조건

업데이트가 설치되기 전에 충족해야 하는 조건입니다. 업데이트가 설치되기 전에 이를 결합하여 (모든 조건이 충족되어야 함) 사용하세요. setMultiDelay 조건

설명	예시	Example
날짜	특정 날짜/시간 이후 기다리기	서버 측 릴리즈와 동기화
백그라운드	앱이 백그라운드 상태가 되면 최소 지연 시간 (ms) 기다리기	빠른 앱 Switching을 피하기 위해
네이티브 버전	네이티브 바이너리 버전의 최소 요구 사항	네이티브 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' },
  ],
});

버전 차단 (채널 정책)

어떤 버전 업데이트를 a channel will auto-deliver. Set via on channels. --disable-auto-update 전략

strategy	블록	사용	사용 사례
없음	없음	어떤 버전도	기본; 전체 자동 업데이트
주 버전	주 버전보다 높음 `version_build`, 예를 들어 `1.2.3 -> 2.0.0`	주 버전이 같으면, 예를 들어 `1.2.3 -> 1.9.0` 또는 `1.2.3 -> 1.2.4`	기존 네이티브 code 에서 깨지지 않는 변경을 막습니다.
minor	다른 주요 또는 부수적인 것보다 `version_build`, 예를 들어 `1.2.3 -> 1.3.0`	같은 주요 및 부수적인 경우, 예를 들어 `1.2.3 -> 1.2.4`	한 네이티브 부수적인 라인 내에 업데이트를 유지합니다.
patch	예를 들어 주요, 부수적인 또는 패치 번호 변경 `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.2`	가장 엄격한 모드: 코어 버전 이동이 없습니다.
metadata	누락된 `min_update_version`, 또는 `version_build` 아래에	업데이트 대상 번들 `min_update_version` 보다 작거나 같은 `version_build`	번들별 사용자 정의 호환성 규칙

이 검사들은 업데이트 대상 번들과 네이티브 베이스 라인 사이를 비교합니다. version_build현재 설치된 다운로드된 번들과 비교하지 않습니다. version_name.

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

세부 정보

배포 유형 장치로 전달되는 배포 유형

유형	설명	사용 시기
전체 패키지	전체 자바스크립트 패키지가 다운로드됩니다.	첫 번째 설치, 큰 변경 사항, 또는 델타가 unavailable일 때
델타	변경된 파일만 다운로드됩니다.	대부분의 업데이트; 빠르고 대역폭 친화적입니다.

# Full bundle (default)
npx @capgo/cli bundle upload --channel production

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

실시간 업데이트 유형

유형	적용 시간
지연 조건	`off`, `atBackground`, `atInstall`, `onLaunch`, `always`, `onlyDownload`
__CAPGO_KEEP_0__	`date`, `background`, `nativeVersion`, `kill`
버전 차단	`none`, `major`, `minor`, `patch`, `metadata`
배포	버전 차단, 델타

업데이트 동작 업데이트 동작 — 적용 시간 및 지연 설정
버전 목표 버전 목표 — 채널 기반 버전 라우팅
델타 업데이트 델타 업데이트 — 다운로드만 변경된 파일
채널 — 채널 설정 및 우선순위