버전 관리
설치 단계와 이 플러그인에 대한 전체 마크다운 가이드를 포함한 설정 명령어를 복사하세요.
Capgo은 세미 버전 (semver) 사용 플러그인, CLI, 및 우리가 제공하는 제품 — 당신의 앱 번들을 위해 권장하는 것과 같은 관행을 사용합니다.
이 페이지는 각 버전 간의 관계, 메이저 버전 간에 호환되는 항목, 및 LTS 태그와 함께 이전 Capacitor 메이저 버전을 고정하는 방법을 설명합니다.
빠른 규칙
제목 '빠른 규칙'| 제품 | 주 버전 관리 | 호환성 참고사항 |
|---|---|---|
| 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 Console | Independent | 자체 릴리스 일정; 지원되는 업데이터 플러그인 버전과 호환 |
제목: 플러그인은 Capacitor의 메이저 버전
Section titled “Plugins follow Capacitor majors”모든 Capgo 플러그인 메이저는 Capacitor 메이저를 위해 빌드되는 메이저를 추적합니다:
@capgo/capacitor-updater@8→ Capacitor 8@capgo/capacitor-updater@7→ Capacitor 7- 그리고 다른 Capgo 플러그인에 대해 동일한 패턴이 적용됩니다.
When Capacitor ships a new major, Capgo ships a matching plugin major. That is when we may change 기본 설정 기본 설정이 새로운 기본이 Capacitor 세대에 더 나은 장기적인 선택일 때입니다.
API stability across majors
Section titled “API stability across majors”Plugin APIs stay stable between majors unless a change is broken by design for everyone (for example a Capacitor platform requirement that forces the same break on all consumers). You should usually be able to move between Capgo plugin majors as you upgrade Capacitor without rewriting your integration.
플러그인 메이저를 업그레이드할 때, 일반적으로 __CAPGO_KEEP_1__ 플러그인 메이저를 이동할 수 있습니다. 기본 설정은 새로운 메이저에서 변경될 수 있습니다. 릴리스 노트와 마이그레이션 가이드를 검토하십시오 (see 그리고 업데이터 사이드바 아래의 마이그레이션 가이드를 참조하여 버전을 올려주세요.
CLI와 콘솔은 각각의 버전을 사용합니다.
제목: CLI와 콘솔은 각각의 버전을 사용합니다.Capgo CLI Capgo 콘솔은 플러그인이나 Capgo과 메이저 버전을 공유하지 않습니다. 아니요 share major versions with plugins or Capacitor.
- __CAPGO_KEEP_0__ 메이저 버전이 필요하지 않습니다. 왜냐하면 당신은 __CAPGO_KEEP_0__ 8 또는 업데이터를 사용하고 있기 때문입니다. need CLI major
8because you are on Capacitor 8 or updater8. - 업데이터 최신 CLI.
- CLI와 Console은 모든 지원되는 버전과 호환됩니다.
@capgo/capacitor-updater(및 관련 업데이터) 메이저.
CLI의 이전 버전을 고정하는 것은 권장되지 않습니다. 대신:
npx @capgo/cli@latest bundle upload --channel=production이전 플러그인 메이저의 LTS 태그
제목 "이전 플러그인 메이저의 LTS 태그"Capacitor의 이전 메이저를 유지하는 경우 Capgo 플러그인 메이저의 LTS dist-tag를 설치하는 것이 업데이트된 lockfile를 영원히 복사하는 것보다 좋습니다.
# Latest Capgo updater for Capacitor 7npm i @capgo/capacitor-updater@lts-v7
# Same pattern for other majorsnpm i @capgo/capacitor-updater@lts-v6npm i @capgo/capacitor-updater@lts-v5npm i @capgo/capacitor-updater@lts-v4업데이터 외부에서 이전 플러그인 메이저의 LTS 릴리스가 게시됩니다. On demand.
업데이터 백포트 vs 다른 플러그인
업데이터 백포트 vs 다른 플러그인 섹션| 패키지 | 이전 주요 백포트 |
|---|---|
@capgo/capacitor-updater | 월별로 반영된 백포트 v7 / v6 / v5 (lts-v7, lts-v6, lts-v5). lts-v4 Capacitor 4에 유지되지만 월별 일정에 포함되지 않습니다. |
| Capgo 다른 플러그인 | 온 디맨드 |
동일한 기능, 반영된 버전 번호
동일한 기능, 반영된 버전 번호 섹션LTS 라인은 백포트가 존재할 때 현재 최신 라인의 마이너 및 패치 버전을 반영합니다.
최신 릴리스가 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.4LTS는 최신 버전의 백포트입니다.
제목 "LTS는 최신 버전의 백포트입니다"새 플러그인 메이저가 출시된 후 lts-v7 (또는 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.
최신 버전의 동작을 이전 버전에서 실행하는 것과 같이 간주합니다.
이것이 앱에 대한 의미는- Upgrade Capgo plugins when you upgrade Capacitor majors.
- 플러그인 업그레이드 시
@capgo/cli@latest— CLI major sync with Capacitor/plugins is unnecessary. - 7 (또는 이전 버전)에서 유지하시겠습니까? Capacitor
@lts-v7(또는 일치하는 태그), 무작위로 오래된7.x개월 전의 - __CAPGO_KEEP_0__ 패키지와 동일한 방식으로 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