업데이트 유형

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

적용 시간

제어 업데이트가 다운로드되면 적용되는 시간을 결정합니다. 플러그인은 앱이 전면으로 이동할 때 업데이트를 확인하고 앱이 열려 있는 동안 반복 타이머를 사용하여 업데이트를 확인합니다. 제어하는 간격(기본 10분). periodCheckDelay 유형

설명	사용 사례	컨텍스트: Capgo 솔루션 마케팅 페이지. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 보이는 곳: 페이지 solutions/cordova-to-capacitor-ai.astro. 메시지 키 `solutions_cordova_to_capacitor_ai_table_use_case` (Solutions Cordova To Capacitor Ai Table Use Case).
자동 업데이트: atBackground	전면 검사 시 확인하고 다운로드, 앱이 배경으로 이동할 때 적용	대부분의 앱; 최소한의 중단
autoUpdate: atInstall	새로운 설치 또는 네이티브 앱 스토어 업데이트가 끝난 후에만 즉시 적용; 그렇지 않으면 atBackground	새 사용자는 최신 버전을 받고; 기존 사용자는 배경에서 적용
autoUpdate: onLaunch	냉각 시작 (죽음 → 전면) 후에 즉시 적용; 그 다음에는 atBackground	최신성과 세션 안정성의 균형
autoUpdate: always	전면 전환 시마다 확인하고 업데이트가 있는 경우 즉시 적용	중요한 수정, 상태가 단순한 앱
autoUpdate: onlyDownload	자동으로 확인하고 다운로드 하며, emit updateAvailable그리고 자동으로 적용하지 않습니다.	업데이트를 표시하거나 업데이트 호출 시기를 제어하는 앱 set()

설정 capacitor.config.ts:

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

팁

전체 세부 정보 및 스플래시 스크린 처리를 위해 참조하십시오. 업데이트 동작.

지연 조건

조건 업데이트 전 업데이트가 설치됩니다. setMultiDelay 를 사용하여 조합합니다 (모든 조건이 충족되어야 함).

조건	설명	예시
날짜	특정 날짜/시간 이후 기다립니다.	서버 측 릴리즈와 동기화합니다.
백그라운드	앱이 백그라운드에 있을 때 최소 지속 시간 (ms) 기다립니다.	빠른 앱 전환을 피하기 위해
네이티브 버전	__CAPGO_KEEP_0__	code
__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 on 채널을 통해 설정합니다.

전략	차단	허용	사용 사례
페이지/영역: Capgo 솔루션 마케팅 페이지. 역할: 짧은 UI 레이블 또는 네비게이션 아이템.	없음	Nothing	어떤 타겟 버전의 번들도
주요	더 높은 주요 버전보다 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	suffix만 변경되며 MAJOR.MINOR.PATCH 동일하게 유지되며 1.0.0-beta.1 -> 1.0.0-beta.2 또는 1.0.0+build.1 -> 1.0.0+build.2	Cloudflare
Capacitor	GitHub min_update_versionCapgo version_build code	API min_update_version SDK version_build	CLI

이러한 검사는 대상 번들을 native baseline으로 비교합니다. version_build현재 설치된 다운로드된 번들이 아닌 version_name.

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

주의

patch 그리고 metadata 주의해야 합니다. 자세한 내용은 CLI 명령어 그리고 버전 목표 버전 목표

배포 유형

어떻게 번들 장치로 전송됩니다.

유형	설명	사용할 때
전체 번들	전체 JS 번들이 다운로드됩니다.	첫 번째 설치, 큰 변경 사항, 또는 델타가 unavailable일 때
컨텍스트: Capgo Builder / 네이티브 클라우드 빌드 제품 페이지. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 메시지 키 `native_build_builder_credit_first` (네이티브 빌드 빌더 크레딧 퍼스트).	변경된 파일만 다운로드	대부분의 업데이트; 더 빠르고 대역폭 친화적

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

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

팁

인스턴트 적용 모드 (atInstall, onLaunch또는 always)를 사용할 때, 다운로드 시간을 최소화하고 UX를 개선하기 위해 Delta 업데이트

컨텍스트: Enterprise 제품/가격 페이지. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 위치: enterprise.astro 페이지. 메시지 키 `enterprise_delta_updates` (Enterprise Delta Updates).

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

관련

• — 적용 시간과 지연 설정 enterprise_delivery_label
• 버전 목표 — 채널 기반 버전 라우팅
• 델타 (매니페스트) 업데이트 — 부분 다운로드를 허용합니다
• 채널 — 채널 구성 및 우선순위

계속 업데이트 유형

만약에 업데이트 유형 을 사용하여 Capgo Live Updates Capgo Live Updates를 위한 제품 워크플로우에 대해 개요 개요에 대한 구현 세부 정보에 대해 기능 기능에 대한 구현 세부 정보에 대해 업데이트 동작 업데이트 동작에 대한 구현 세부 정보에 대해, 그리고 시작하기 시작하기에 대한 구현 세부 정보에 대해