バージョニング

インストール手順と、このプラグインの完全なMarkdownガイドを含むセットアッププロンプトをコピーします。

Capgo はセマンティックバージョニング (semver) を、プラグイン、CLI、提供する製品に採用しています。これは、ご自身のアプリ bundle にも推奨している手法です。

このページでは、各バージョンの関係性、メジャーバージョン間での互換性、および LTS タグを使用して古い Capacitor のメジャーバージョンを固定する方法について説明します。

簡単なルール

プロダクト	メジャーバージョニング	互換性に関する注意点
Capgo プラグイン	対応するものに従ってください Capacitor メジャーバージョン	プラグインのメジャーバージョン `8` Capacitor 8 を対象、 `7` Capacitor 7 を対象、など
Capgo CLI	独立型	CLI のメジャーバージョンをプラグインや Capacitor と同期しないでください。常に最新の CLI を使用してください
Capgo コンソール	独立型	独自のリリースサイクル。サポート対象の updater プラグインのバージョンと互換性があります

プラグインはCapacitorのメジャーバージョンに追従します

各 Capgo プラグインのメジャーバージョンは、対応する Capacitor のメジャーバージョンを追跡します：

@capgo/capacitor-updater@8 → Capacitor 8
@capgo/capacitor-updater@7 → Capacitor 7
その他の Capgo プラグインも同様のパターンです

Capacitor が新しいメジャーバージョンをリリースすると、Capgo も対応するプラグインのメジャーバージョンをリリースします。その際に、変更される可能性があります デフォルトオプション そのCapacitor世代にとって、新しいデフォルトが長期的により良い選択である場合。

メジャーバージョン間でのAPIの安定性

プラグインAPIは、メジャーバージョン間で安定性を保ちます。ただし、すべてのユーザーに対して意図的に破壊的変更となる場合（例：すべての利用者に同じ破壊的変更を強制するCapacitorプラットフォーム要件）を除きます。Capacitorをアップグレードする際に、Capgoプラグインのメジャーバージョン間を移動しても、統合コードを書き直す必要は通常ありません。

デフォルトは新しいメジャーバージョンで変更される可能性があります。リリースノートとマイグレーションガイドを確認してください（ updaterのアップグレードおよびupdaterサイドバーのMigrationsにあるガイド）を、バージョンを上げる際に参照してください。

CLIとConsoleは独自のバージョンを使用

Capgo CLIとCapgo Consoleは 決して プラグインや Capacitor とメジャーバージョンを共有します。

次の場合には 決して CLI のメジャーバージョンが必要です 8 Capacitor 8 またはアップデーターを使用しているためです 8.
常にインストールまたは呼び出すのは最新 CLI です。
最新の CLI と Console は、サポートされているすべての @capgo/capacitor-updater （および関連するアップデーター）のメジャーバージョンと互換性があります。

古い CLI バージョンをピン留めすることは推奨されません。代わりに以下を使用してください：

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

プラグインの旧メジャーバージョン向けLTSタグ

古いCapacitorメジャーバージョンにとどまる場合、古いlockfileを永遠にコピーするのではなく、対応するCapgoプラグインメジャーバージョンをLTS dist-tag付きでインストールしてください。

# 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

updater以外では、以前のプラグインメジャーバージョンのLTSリリースが公開されています オンデマンドでデプロイし、.

Updaterのバックポート 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.4

LTSは最新版のバックポートです

新しいプラグインのメジャーバージョンがリリースされた後、 lts-v7 (または lts-v6、…）のリリースは 最新版のバックポート なので、以前の Capacitor メジャーでも同じ処理が動作します。

LTS ラインは最新版を追跡しているため、公開されている API は 変わる可能性があります 最新の変更を適用する場合 — メジャーバージョンが据え置きのままでも、 7LTSは「古いCapacitor上での現在のCapgoの挙動」として扱い、永久に凍結されたレガシーなAPIとは考えないでください。

アプリへの影響

Capacitorのメジャーバージョンをアップグレードする際は、Capgoプラグインもアップグレードしてください。
常に以下を実行してください： @capgo/cli@latest — Capacitor/pluginsとのCLIメジャー同期は不要です。
Capacitor 7（またはそれ以前）を使い続ける場合は、 @lts-v7 （または対応するタグ）を使い、数ヶ月前の適当な 7.x バージョンは使わないでください。
独自のLive Update bundleのバージョン管理には semver Capgo がパッケージをバージョン管理するのと同じ方法です。次を参照バンドルのバージョン管理とチャネルとバージョンターゲティングは、.

アプリの追加 — アップデーターのインストールコマンドとLTSタグ
CLI の概要 — Capgo CLI コマンドの実行方法
ネイティブ互換性 — ストアバイナリとOTAバンドル、どちらが必要になるか
V7からV8へ — Capacitor に準拠したプラグインのメジャーバージョンアップの例