버전 관리

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.

빠른 규칙

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

항상 최신 CLI을 사용하세요

CLI을 실행하세요 @latest (예를 들어 npx @capgo/cli@latest ...) CLI의 메이저 버전 메이저 버전이 플러그인 메이저 버전이나 __CAPGO_KEEP_0__ 메이저 버전과 일치할 필요는 없습니다. 최신 __CAPGO_KEEP_1__은 지원되는 업데이터 플러그인 버전과 호환됩니다. need to match your plugin major or Capacitor major. The latest CLI works with any supported updater plugin version.

플러그인은 Capacitor 메이저 버전을 따릅니다

모든 Capgo 플러그인 메이저는 Capacitor 메이저를 위해 빌드되는 Capgo 메이저를 추적합니다:

• @capgo/capacitor-updater@8 → Capacitor 8
• @capgo/capacitor-updater@7 → Capacitor 7
• and the same pattern for other Capgo plugins

When Capacitor ships a new major, Capgo ships a matching plugin major. That is when we may change 기본 설정 기본 설정이 새로운 메이저에서 변경될 수 있습니다. 새로운 기본 설정이 Capacitor 메이저에 대한 장기적인 최선의 선택인지 확인합니다.

API stability across majors

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

기본 설정은 새로운 메이저에서 변경될 수 있습니다. 릴리스 노트와 마이그레이션 가이드(see 업데이터 업그레이드 그리고 업데이터 사이드바 아래의 마이그레이션 가이드를 참조할 때 버그를 발생시킬 때

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

Capgo CLI과 Capgo 콘솔은 플러그인이나 __CAPGO_KEEP_0__과 메이저 버전을 공유하지 않습니다. share major versions with plugins or Capacitor.

• 업데이터 __CAPGO_KEEP_0__ 8 또는 __CAPGO_KEEP_0__ 메이저 버전이 필요하지 않습니다. 최신 업데이터 CLI 8 또는 CLI 메이저 버전이 필요하지 않습니다. 8 because you are on Capacitor 8 or updater 8.
• 업데이터 __CAPGO_KEEP_0__ 8 또는 __CAPGO_KEEP_0__ 메이저 버전이 필요하지 않습니다. 최신 CLI.
• CLI와 Console은 모든 지원되는 버전과 호환됩니다. @capgo/capacitor-updater (및 관련된 업데이터) 메이저.

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

npx @capgo/cli@latest bundle upload --channel=production

이전 플러그인 메이저의 LTS 태그

Capacitor의 이전 메이저를 유지하는 경우 Capgo 플러그인 메이저의 LTS dist-tag를 설치하는 것이 오래된 lockfile를 영원히 복사하는 것보다 좋습니다.

# 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 릴리스가 게시됩니다. On demand.

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

패키지	이전 주요 백포트
@capgo/capacitor-updater	월별로 반영된 백포트 v7 / v6 / v5 (lts-v7, lts-v6, lts-v5). lts-v4 Capacitor 4에 유지되지만 월별 일정에 포함되지 않습니다.
다른 Capgo 플러그인	페이지/영역: Enterprise 제품/가격 페이지. 역할: 웹사이트 복사 문장. 위치: enterprise.astro 페이지. Capgo 제품/브랜드 및 개발자 용어를 정확하게 유지합니다.

온 디맨드

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

최신 릴리스가 8.3.4, the Capacitor 7 LTS line is published as 7.3.4 7 LTS 라인은 와 동일한 기능 세트와 버그 수정 , adapted to that Capacitor major.

Install with the tag when you want “latest for this Capacitor major”:

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

이

로 설치하려면 태그를 사용하세요: lts-v7 터미널 창 lts-v6…) 버전은 최신 버전의 이러한 작업은 이전 Capacitor 메이저 버전에서도 동일하게 작동합니다.

최신 버전을 추적하기 때문에 LTS 라인(public API)의 버전이 변경될 수 있습니다. 버전이 변경될 수 있습니다. 최신 버전이 변경될 때도 메이저 버전은 변경되지 않습니다. 7LTS를 "Capgo의 최신 동작을 이전 Capacitor에서 수행하는 것"으로 간주하고, 영원히 API로 유지하는 것은 아닙니다.

이것이 앱에 대한 의미는 무엇입니까?

1. Capgo 플러그인 업그레이드 시 Capacitor 메이저 버전 업그레이드도 함께 진행해야 합니다.
2. __CAPGO_KEEP_0__ 메이저 버전과 __CAPGO_KEEP_1__/plugins의 동기화는 항상 필요합니다. @capgo/cli@latest CLI 메이저 버전과 Capacitor/plugins의 동기화는 불필요합니다.
3. Capacitor 7 (or 이전)에서 유지하시겠습니까? 사용 @lts-v7 (또는 일치하는 태그), 무작위로 오래된 7.x 개월 전의
4. 라이브 업데이트 번들을 버전화하세요. semver Capgo가 패키지를 버전화하는 것과 동일한 방식으로 번들 버전화 및 채널 그리고 버전 목표.

관련 문서

• 앱 추가 설치 명령어 및 LTS 태그를 업데이터에 제공합니다.
• CLI 개요 Capgo CLI 명령어를 실행하는 방법
• 자연어 호환성 페이지/영역: Live 업데이트 제품 페이지. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 보이는 곳: 페이지 live-update.astro. 메시지 키 `live_update_v2_comp_compat_l` (Live Update V2 Comp Compat L).
• 변경이 저장소 바이너리 vs OTA 번들을 필요로 할 때 — example of a Capacitor-aligned plugin major upgrade