업데이트 유형

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

적용 시간

Controls 업데이트가 다운로드 된 후 적용되는 시점을 결정합니다. Type

설명	사용 사례	autoUpdate:
배경에서 다운로드 후 사용자가 앱을 백그라운드 또는 종료할 때 적용 atBackground	대부분의 앱; 최소한의 중단	autoUpdate:
새로운 사용자가 최신 버전을 받고 기존 사용자가 기본 흐름을 사용할 때 즉시 적용 atInstall	새로운 사용자가 최신 버전을 받고 기존 사용자가 기본 흐름을 사용합니다.	autoUpdate:
__CAPGO_KEEP_0__ onLaunch	설치, 저장, 앱 종료 시 즉시 적용	최신성과 세션 안정성의 균형
__CAPGO_KEEP_0__ always	다운로드 중인 업데이트를 포함하여 즉시 적용	중요한 수정, 단순한 상태를 가진 앱
__CAPGO_KEEP_0__ onlyDownload	자동 다운로드 및 전달 updateAvailable업데이트를 표시하거나 정확히 언제 호출할지 앱이 제어하는 경우	설정에서 set()

클립보드에 복사 capacitor.config.ts:

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

Tip

For full details and splashscreen handling, see 업데이트 동작.

지연 조건

업데이트가 설치되기 전에 해야 조건을 combination (모든 조건이 충족되어야 함) 하십시오. setMultiDelay 조건

설명	__CAPGO_KEEP_0__	예시
날짜	특정 날짜/시간 이후 기다려주세요	서버 측 릴리즈와 동기화
배경	앱이 배경화면으로 전환되면 최소 __CAPGO_KEEP_0__ ms 기다려주세요	빠른 앱 전환을 피하기 위해
nativeVersion	최소 native 바이너리 버전 __CAPGO_KEEP_0__을 요구합니다	incompatible native code으로 인한 업데이트를 차단합니다
kill	다음 앱 종료 이벤트까지 기다려주세요	__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' },
  ],
});

위험

이 kill 처음으로 죽음 이벤트가 발생한 후에 조건이 트리거 되며, 다른 것들과 같이 배경에서 다음 이벤트가 발생한 후에 트리거 되지 않습니다. 향후 릴리즈에서 수정될 예정입니다.

버전 차단 (채널 정책)

어떤 semver 업데이트를 채널은 자동으로 전달할 수 있는 업데이트를 제어합니다. 채널에서 --disable-auto-update 설정됩니다.

전략	블록	허용	사용 사례
없음	Nothing	어떤 버전의 번들	기본; 전체 자동 업데이트
major	Higher major than version_build예를 들어 1.2.3 -> 2.0.0	같은 major, 예를 들어 1.2.3 -> 1.9.0 또는 1.2.3 -> 1.2.4	code에서 오래된 네이티브로 도달하는 변경 사항을 막아라
소	major 또는 소수보다 version_build예를 들어 1.2.3 -> 1.3.0	major와 소수는 동일합니다. 예를 들어 1.2.3 -> 1.2.4	한 네이티브 소수 라인 내에 업데이트를 유지하라
patch	major, minor, 또는 patch 번호 변경, 예를 들어 1.0.0 -> 1.0.1	suffix만 변경하되 MAJOR.MINOR.PATCH identical로 동일합니다. 예를 들어 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	사용자 지정 호환성 규칙 per 번들

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

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

주의

patch 그리고 metadata 주의ful한 설정이 필요합니다. 자세한 내용은 CLI 명령어 그리고 버전 목표 에 대한 자세한 내용입니다.

배포 유형

의 섹션입니다. 어떻게 배포되는지에 대해 설명합니다. __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__

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

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

Tip

즉시 적용 모드 (atInstall, onLaunch, or always)를 사용할 때 다운로드 시간을 최소화하고 UX를 개선하기 위해 Quick Reference

Quick Reference

타입	적용 시간
__CAPGO_KEEP_0__	off, atBackground, atInstall, onLaunch, always, onlyDownload
__CAPGO_KEEP_0__ 지연 조건	date, background, nativeVersion, kill
__CAPGO_KEEP_0__ 버전 차단	none, major, minor, patch, metadata
배포	전체 패키지, Delta (매니페스트)

관련

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

Update Types에서 계속하기

__CAPGO_KEEP_0__을 사용하는 경우 Update Types 실시간 업데이트 전달을 계획하는 경우, Update Types를 Capgo Live Updates 제품 워크플로우에서 Capgo Live Updates와 연결하세요. __CAPGO_KEEP_0__ Live Updates 실시간 업데이트 구현 세부 정보를 __CAPGO_KEEP_0__ Live Updates에서 확인하세요. __CAPGO_KEEP_0__ Live Updates 기능에 대한 구현 세부 정보 업데이트 동작 업데이트 동작에 대한 구현 세부 정보, 및 시작하기 시작하기에 대한 구현 세부 정보.