버전 관리

Capgo는 다음을 사용합니다 유의적 버전 관리 (semver) 플러그인, CLI, 그리고 저희가 제공하는 제품 모두에 적용됩니다. 이는 여러분의 앱 번들에도 권장하는 방식입니다.

이 페이지에서는 각 버전 간의 관계, 메이저 버전 간 호환성 유지 방법, 그리고 LTS 태그를 사용하여 이전 Capacitor 메이저 버전을 고정하는 방법을 설명합니다.

간단 규칙

제품	메이저 버전 관리	호환성 참고 사항
Capgo 플러그인 둘러보기	일치하는 버전을 따르세요 Capacitor 메이저	플러그인 메이저 8 Capacitor 8 대상, 7 Capacitor 7 대상 등
Capgo CLI	독립형	CLI 메이저를 플러그인이나 Capacitor와 동기화하지 마세요. 항상 최신 CLI를 사용하세요.
Capgo 콘솔	독립형	자체 릴리스 주기; 지원되는 updater 플러그인 버전과 호환됨

항상 최신 버전의 CLI를 사용하세요

CLI를 다음 명령어로 실행하세요: @latest (예를 들어 npx @capgo/cli@latest ...). CLI 메이저 버전은 하지 마세요 사용 중인 플러그인의 메이저 버전 또는 Capacitor 메이저 버전과 일치해야 합니다. 최신 CLI은 지원되는 모든 updater 플러그인 버전과 호환됩니다.

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

각 Capgo 플러그인의 메이저 버전은 빌드 대상인 Capacitor 메이저 버전을 따릅니다:

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

Capacitor에서 새로운 메이저 버전을 출시하면 Capgo에서도 그에 맞는 플러그인 메이저 버전을 출시합니다. 이때 다음과 같은 항목이 변경될 수 있습니다. 기본 옵션 새로운 기본값이 해당 Capacitor 세대에 더 나은 장기적 선택인지 확인하세요.

메이저 버전 전반의 API 안정성

모두에게 의도적으로 적용되는 변경 사항(예: 모든 사용자에게 동일한 중단 사항을 강제하는 Capacitor 플랫폼 요구 사항)이 없는 한, Plugin API는 메이저 버전 간에도 안정적으로 유지됩니다. 일반적으로 Capacitor를 업그레이드할 때 통합 코드를 다시 작성할 필요 없이 Capgo 플러그인의 메이저 버전을 전환할 수 있습니다.

새로운 메이저 버전에서는 기본값이 변경될 수 있습니다. 버전을 올릴 때 릴리스 노트와 마이그레이션 가이드를 검토하세요(참조: 업데이터 업그레이드 및 업데이터 사이드바의 Migrations 항목에 있는 가이드)

CLI와 Console은 자체 버전을 사용합니다

Capgo CLI 및 Capgo Console은 하지 마세요 플러그인 또는 Capacitor와 메이저 버전을 공유합니다.

• 직접 수행 하지 마세요 CLI 메이저 버전이 필요합니다 8 Capacitor 8 버전 또는 updater를 사용 중이므로 8.
• 항상 다음을 설치하거나 호출하세요: 최신 CLI.
• 최신 CLI 및 Console은 지원되는 모든 @capgo/capacitor-updater (및 관련 updater) 메이저 버전과 호환됩니다.

이전 CLI 버전을 고정하는 것은 권장하지 않습니다. 다음을 권장합니다:

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

이전 플러그인 메이저 버전용 LTS 태그

이전 Capacitor 메이저 버전을 사용 중이라면, 오래된 lockfile을 계속 복사하지 말고 LTS dist-tag로 일치하는 Capgo 플러그인 메이저 버전을 설치하세요.

# 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 릴리스가 요청 시.

Updater 백포트 vs 다른 플러그인

패키지	이전 메이저 버전 백포트
@capgo/capacitor-updater	매월 미러링된 백포트 대상 v7 / v6 / v5 (lts-v7, lts-v6, lts-v5). lts-v4 Capacitor 4에서 계속 사용할 수 있지만, 해당 매월 주기에는 포함되지 않습니다.
기타 Capgo 플러그인	온디맨드

동일한 기능, 동일한 버전 번호

LTS 라인은 백포트가 있는 경우 현재 최신 라인의 minor 및 patch를 미러링합니다.

최신 릴리스가 8.3.4인 경우, Capacitor 7 LTS 라인은 다음과 같이 게시됩니다: 7.3.4 를 사용하여 동일한 기능 세트와 버그 수정 사항을해당 Capacitor 메이저 버전에 맞게 조정한 것입니다.

이 Capacitor 메이저 버전의 최신 버전을 원할 때 태그로 설치하세요:

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

LTS는 최신 버전의 백포트입니다

새 플러그인 메이저 버전이 출시되면, lts-v7 (또는 lts-v6, …) 릴리스는 최신 버전의 백포트이며, 따라서 동일한 작업이 이전 Capacitor 메이저 버전에서도 실행됩니다.

LTS 라인은 최신 버전을 추적하므로, 공개 API 버전이 변경될 수 있습니다. 최신 변경 사항이 반영될 때 — 메이저 번호는 그대로여도 7. LTS를 영구적인 레거시 API가 아니라 “구버전 Capacitor에서의 현재 Capgo 동작”으로 보세요.

앱에 미치는 영향

1. Capacitor 메이저 버전을 업그레이드할 때 Capgo 플러그인도 함께 업그레이드하세요.
2. 항상 실행하세요 @capgo/cli@latest — Capacitor/플러그인과 CLI 메이저 버전을 동기화할 필요는 없습니다.
3. Capacitor 7(또는 이전 버전)을 계속 사용 중인가요? 그렇다면 @lts-v7 (또는 일치하는 태그)를 사용하세요 — 몇 달 전의 아무 7.x 버전이 아니라.
4. 자체 live-update 번들에 버전을 지정하려면 다음을 사용하세요: semver Capgo가 패키지 버전을 관리하는 방식과 같습니다. 참고: bundle 버전 관리 및 채널 및 버전 타겟팅.

관련 문서

• 앱 추가 — 업데이터의 설치 명령 및 LTS 태그
• CLI 개요 — Capgo CLI 명령 실행 방법
• Native 호환성 — 변경 사항에 스토어 바이너리가 필요할 때 vs OTA bundle이 필요할 때
• V7에서 V8로 — Capacitor에 맞춘 플러그인 메이저 업그레이드 예시