버전 관리

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	독립적	Do not sync CLI major with plugins or Capacitor. Always use the latest CLI
Capgo 콘솔	독립	자체 릴리스 일정; 지원되는 업데이터 플러그인 버전과 호환

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 메이저를 위해 빌드된 Capacitor 메이저를 추적합니다:

• @capgo/capacitor-updater@8 → Capacitor 8
• @capgo/capacitor-updater@7 → Capacitor 7
• 그리고 다른 Capgo 플러그인에 대해 동일한 패턴이 적용됩니다.

Capacitor이 새로운 메이저를 출시할 때 Capgo은 일치하는 플러그인 메이저를 출시합니다. 그 때 우리는 변경할 수 있습니다 기본 설정 기본 설정이 새로운 Capacitor 메이저에서 더 나은 장기적인 선택일 때 기본 설정을 변경할 수 있습니다.

API의 메이저 간 안정성

플러그인 API는 메이저 간에 안정적입니다. 변경이 모든 사용자에게 적용되는 변경이 발생하지 않는 한(예를 들어 Capacitor 플랫폼 요구 사항이 모든 소비자에게 동일한 영향을 미치는 변경이 발생하는 경우). 일반적으로 Capgo 플러그인 메이저를 업그레이드할 때 Capacitor을 업그레이드할 수 있습니다.

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

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

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

• 업데이트를 할 필요가 없습니다. __CAPGO_KEEP_0__ 메이저 버전이 필요하지 않습니다. 8 이상의 CLI 버전 또는 업데이터를 사용 중이므로 8 because you are on Capacitor 8 or updater 8.
• 최신 최신 CLI.
• CLI @capgo/capacitor-updater __CAPGO_KEEP_0__

CLI

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

기존 플러그인 메이저의 LTS 태그

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 태그 On demand.

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

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

온 디맨드

같은 기능, 반영된 버전 번호 섹션입니다. LTS 라인은 백포트가 존재할 때 현재 최신 라인의 마이너 및 패치 버전을 반영합니다.

최신 릴리스가 8.3.4Capacitor 7 LTS 라인은 7.3.4 같은 기능 세트와 버그 수정 , __CAPGO_KEEP_0__ 메이저 버전을 위해 적응 Capacitor 메이저 버전의 "최신"을 설치하려면 태그를 사용하십시오:

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는 최신의 백포트"

(또는 lts-v7 (or lts-v6…) 최신 버전의 so the same work runs on the previous Capacitor major.

Because it tracks latest, the LTS line’s public API 변경될 수 있습니다. 최신 버전이 변경되더라도 7. Treat LTS as “current Capgo behavior on an older Capacitor,” not as a frozen legacy API forever.

LTS 버전을

1. Upgrade Capgo plugins when you upgrade Capacitor majors.
2. 영구적인 버전으로 간주하지 마십시오. @capgo/cli@latest — CLI major sync with Capacitor/plugins is unnecessary.
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