업데이트 유형

설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함하는 설정 명령어를 복사하세요.

Capgo supports several types of over-the-air (OTA) updates. This page lists and explains all of them so you can choose the right combination for your app.

__CAPGO_KEEP_0__

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

설명	사용 사례	autoUpdate:
앱이 전면에 표시될 때마다 확인하고 다운로드하고, 앱이 백그라운드에 이동할 때 적용 `atBackground`	대부분의 앱; 최소한의 간섭	autoUpdate:
autoUpdate: `atInstall`	새로운 설치 또는 네이티브 앱 스토어 업데이트 후에만 즉시 적용; 그렇지 않으면 사용 `atBackground`	새로운 사용자는 최신 버전을 받고, 기존 사용자는 배경 적용을 사용
autoUpdate: `onLaunch`	cold start (종료 → 전면)에서만 즉시 적용; 그 다음에는 `atBackground`	최신성과 세션 안정성의 균형
autoUpdate: `always`	전면 전환 시마다 확인하고 업데이트 가능 시 즉시 적용	중요한 수정, 단순한 상태를 가진 앱
autoUpdate: `onlyDownload`	확인하고 다운로드 자동화, `updateAvailable`자동 적용하지 않음	자신의 업데이트 알림을 보여주거나 정확히 언제 호출할지 제어하는 앱 `set()`

설정하기 capacitor.config.ts:

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

지연 조건

업데이트가 설치되기 전에 만족해야 하는 조건입니다. 조건을 combination하기 위해 사용하세요 (모든 조건이 충족되어야 함). setMultiDelay __CAPGO_KEEP_0__

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

버전 차단 (채널 정책)

어떤 semver 업데이트들 __CAPGO_KEEP_0__ 채널이 자동으로 전달합니다. __CAPGO_KEEP_1__을 통해 설정합니다. --disable-auto-update __CAPGO_KEEP_0__ 채널.

__CAPGO_KEEP_0__ 전략	__CAPGO_KEEP_0__ 블록	__CAPGO_KEEP_0__ 사용 사례	__CAPGO_KEEP_0__
__CAPGO_KEEP_0__	__CAPGO_KEEP_0__	__CAPGO_KEEP_0__	__CAPGO_KEEP_0__; 전체 자동 업데이트
__CAPGO_KEEP_0__	__CAPGO_KEEP_0__ `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.2`	가장 엄격한 모드: 코어 버전 이동이 없음
메타데이터	미설정 `min_update_version`, 또는 `version_build` 아래에	타겟 번들을 포함하는 `min_update_version` 보다 작거나 같은 `version_build`	번들당 사용자 정의 호환성 규칙

이 검사는 타겟 번들을 원본 baseline에 비교합니다. 원본 baseline은 현재 설치된 다운로드된 번들이 아닌 version_build, not the currently installed downloaded bundle sent as version_name.

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

배송 유형

How the __CAPGO_KEEP_0__ is transferred to the device. __CAPGO_KEEP_0__ __CAPGO_KEEP_1__

__CAPGO_KEEP_2__	__CAPGO_KEEP_3__	__CAPGO_KEEP_4__
__CAPGO_KEEP_5__	__CAPGO_KEEP_6__	__CAPGO_KEEP_7__
__CAPGO_KEEP_8__	__CAPGO_KEEP_9__	__CAPGO_KEEP_10__

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

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

‘빠른 참조’라는 제목의 섹션

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

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