업데이트 유형

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

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.

Apply Timing

Controls 업데이트가 다운로드 된 후 적용되는 시간을 지정합니다. 플러그인은 앱이 전면에 표시될 때와 앱이 열려 있는 동안 반복 타이머를 사용하여 업데이트 여부를 확인합니다. 업데이트가 다운로드 된 후 적용되는 시간을 지정합니다. periodCheckDelay Type

Description	Use Case	autoUpdate:
앱이 전면에 표시될 때마다 확인하고 다운로드 후 앱이 배경에 표시될 때 적용합니다. `atBackground`	대부분의 앱; 최소한의 간섭	autoUpdate:
__CAPGO_KEEP_0__ `atInstall`	새 설치 또는 네이티브 앱 스토어 업데이트가 끝난 후에만 즉시 적용; 그렇지 않으면 사용 `atBackground`	새 사용자는 최신 버전을 받고; 기존 사용자는 배경 적용
autoUpdate: `onLaunch`	냉장 시작 시 즉시 적용 (죽음 → 전면); 그 다음에는 `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'
  }
}

지연 조건

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

조건	설명	예시
날짜	특정 날짜/시간 이후 기다리기	서버 측 릴리즈와 동기화하기
배경	앱이 배경화된 후 최소 지연 시간 (ms) 기다리기	빠른 앱 Switch를 피하기 위해
네이티브 버전	최소 네이티브 바이너리 버전을 요구하기	호환되지 않는 네이티브 code에 대한 업데이트를 차단하기
__CAPGO_KEEP_0__	__CAPGO_KEEP_0__	__CAPGO_KEEP_0__

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__

__CAPGO_KEEP_0__ __CAPGO_KEEP_0__ __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` stays identical, for example `1.0.0-beta.1 -> 1.0.0-beta.2` or `1.0.0+build.1 -> 1.0.0+build.2`	가장 엄격한 모드: 코어 버전 이동이 없습니다
메타데이터	미설치 `min_update_version`, 또는 `version_build` 아래에	타겟 번들을 포함하는 `min_update_version` 보다 작거나 같은 `version_build`	번들을 위한 사용자 정의 호환성 규칙

이 검사는 타겟 번들을 native baseline으로 비교합니다. native baseline은 version_build, 현재 설치된 다운로드된 번들이 아닌 version_name.

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

배송 유형

How the bundle is transferred to the device.

Type	설명	사용하는 시점
전체 번들	전체 JS 번들이 다운로드 됩니다.	첫 번째 설치, 큰 변경 사항, 또는 델타가 unavailable일 때
델타 (매니페스트)	변경된 파일만 다운로드 됩니다.	업데이트의 대부분; 더 빠르고 대역폭 친화적입니다.

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

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