내용으로 건너뛰기

버전 관리

Capgo 사용 semver 플러그인, CLI, 및 우리가 제공하는 제품을 위한 동일한 관행을 권장합니다.

This page explains how those versions relate to each other, what stays compatible across majors, and how to pin older Capacitor majors with LTS tags.

빠른 규칙

제품
Quick rules메이저 버전 관리호환성 참고 사항
Capgo 플러그인일치하는 것을 따르세요 Capacitor 메이저플러그인 메이저 8 Capacitor 8, 7 Capacitor 7, 등
Capgo CLI독립적플러그인이나 Capacitor와 CLI 메이저를 동기화하지 마세요. 항상 CLI 최신 버전을 사용하세요
Capgo 콘솔Independent자체 릴리스 일정; 지원되는 업데이터 플러그인 버전과 호환

모든 Capgo 플러그인 메이저 버전은 Capacitor 메이저 버전을 위한 빌드에 따라 추적됩니다

  • @capgo/capacitor-updater@8 → Capacitor 8
  • @capgo/capacitor-updater@7 → Capacitor 7
  • 다른 Capgo 플러그인과 같은 패턴

Capacitor이 새로운 주요 버전을 출시할 때, Capgo은 일치하는 플러그인 주요 버전을 출시합니다. 그 때 우리는 변경할 수 있습니다 기본 설정 기본 설정이 새로운 Capacitor 세대에 대해 장기적으로 더 나은 선택일 때 기본 설정을 변경합니다.

API의 주요 버전 간 안정성

API 안정성의 주요 버전 간

플러그인 API는 메이저 간에 안정적입니다. 변경은 모든 사용자에게 적용되는 디자인 변경으로 인해 깨질 수 있습니다. 예를 들어, Capacitor 플랫폼 요구 사항이 모든 소비자에게 동일한 깨짐을 강요하는 경우입니다. 일반적으로 Capgo 플러그인 메이저를 업그레이드할 때 Capacitor을 업그레이드할 수 있습니다. 그러면 통합을 다시 작성하지 않고 플러그인 메이저를 이동할 수 있습니다.

기본 설정은 새로운 메이저에서 변경될 수 있습니다. 릴리스 노트와 마이그레이션 가이드를 검토하십시오 (see 업데이터 업그레이드 업데이터의 마이그레이션 가이드를 검토하십시오. (see

CLI와 콘솔은 각각의 버전을 사용합니다.

CLI and Console use their own versions

Capgo CLI과 Capgo Console은 아니오 플러그인이나 Capacitor과 메이저 버전을 공유하지 않습니다.

  • 업데이트를 받습니다. 아니오 당신은 CLI 8 또는 업데이터에 있습니다. 8 항상 최신 Capacitor을 설치하거나 호출하세요. 8.
  • __CAPGO_KEEP_0__ latest CLI.
  • 최신 CLI과 Console은 모든 지원되는 @capgo/capacitor-updater 업데이트 (및 관련 업데이터) 메이저.

CLI의 이전 버전을 고정하는 것은 권장되지 않습니다. 대신:

터미널 창
npx @capgo/cli@latest bundle upload --channel=production

When you stay on an older Capacitor major, install the matching Capgo plugin major with an LTS dist-tag instead of copying an outdated lockfile forever.

터미널 창
# Latest Capgo updater for Capacitor 7
npm i @capgo/capacitor-updater@lts-v7
# Same pattern for other majors
npm i @capgo/capacitor-updater@lts-v6
npm i @capgo/capacitor-updater@lts-v5
npm i @capgo/capacitor-updater@lts-v4

제목: "LTS 태그를 사용하여 이전 플러그인 메이저" 실시간 요청.

업데이터 백포팅 vs 다른 플러그인

업데이터 백포팅 vs 다른 플러그인 섹션
패키지이전 주요 백포팅
@capgo/capacitor-updater월별로 반영된 백포팅 v7 / v6 / v5 (lts-v7, lts-v6, lts-v5). lts-v4 Capacitor 4 에는 유지되지만 월별 일정에 포함되지 않습니다.
Capgo 다른 플러그인실시간 요청

동일한 기능, 반영된 버전 번호 섹션

LTS 라인은 백포팅이 존재할 때 현재 최신 라인의 마이너 및 패치 버전을 반영합니다. 8.3.4Capacitor 7 LTS 라인 7.3.4 __CAPGO_KEEP_0__ 기능 세트와 버그 수정Capacitor

이 Capacitor 메이저 버전의 최신 버전을 설치하려면 태그를 사용하세요:

터미널 창
npm i @capgo/capacitor-updater@lts-v7 # resolves to the current 7.x LTS, e.g. 7.3.4

LTS는 최신 버전의 백포트

LTS는 최신 버전의 백포트

새 플러그인 메이저 버전이 출시된 후 lts-v7 (또는 lts-v6... 릴리스는 최신 버전의 백포팅 따라서 이전 Capacitor 메이저 버전에서 동일한 작업이 실행됩니다.

최신 버전을 추적하기 때문에 LTS 라인 공공 API 변경될 수 있습니다 최신 버전이 변경되면 — 메이저 번호가 __CAPGO_KEEP_0__에 유지되더라도 7. LTS를 "Capgo의 현재 동작"으로 "Capacitor의 이전 버전"으로 간주하십시오. API는 영원히 얼어붙은 유산이 아닙니다.

이것이 앱에 대한 의미

제목 "이것이 앱에 대한 의미"
  1. Capgo 플러그인 업그레이드할 때 Capacitor 메이저 버전 업그레이드
  2. 항상 @capgo/cli@latest CLI 메이저 버전 동기화는 Capacitor/플러그인 동기화가 불필요합니다.
  3. Capacitor 7 (또는 이전 버전) 사용 @lts-v7 또는 일치하는 태그, 랜덤한 오래된 것 7.x 개월 전의 것
  4. 라이브 업데이트 패키지를 버전화하세요. semver Capgo 패키지를 버전화하는 것과 동일한 방식으로 패키지를 버전화하세요. 채널 및 버전 관리 그리고 버전 대상.
관련 문서
  • 앱 추가 업데이터의 설치 명령어 및 LTS 태그
  • CLI 개요 — Capgo CLI 명령어를 실행하는 방법
  • 자연 호환성 — 변경 사항이 저장 바이너리 vs OTA 패키지에 필요할 때
  • V7에서 V8로 — 예시 Capacitor-정렬 플러그인 주요 업그레이드