バージョニング

コピー用の設定プロンプトにインストールステップとこのプラグインの全てのマークダウンガイドを含める

Capgoの使用プラグイン、__CAPGO_KEEP_0__、および提供する製品すべてに、セマンティックバージョニング（semver）を使用します。 Capgoのプラグイン、CLI、およびCapgoで配信する製品 — これらの製品に対しておすすめする同様の実践をあなたのアプリのバンドルにも適用することをお勧めします。

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 コンソール	独立	独自のリリースサイクル;サポートされているアップデートプラグインのバージョンと互換性があります

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

各Capgoプラグインのメジャーバージョンは、Capacitorのメジャーバージョンに合わせて構築されています:

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

Capacitor が新しいメジャーをリリースしたとき、Capgo も対応するプラグインメジャーをリリースします。その時点で、Capacitor のメジャー間で変更が行われる可能性があります。 デフォルトの設定 新しいデフォルトがそのCapacitor 世代の長期的な最善の選択である場合、そのCapacitor のデフォルトの設定を変更することがあります。

API の安定性

プラグイン API はメジャー間で安定しています。ただし、すべてのユーザーに影響を与える変更が必要な場合、例えば Capacitor のプラットフォーム要件がすべての消費者に同じ影響を与えるように強制される場合、その変更はメジャー間で安定しません。通常、Capgo のプラグインメジャーを Capacitor にアップグレードするときに、再度コードを書き直すことなく、プラグインを移動できます。

デフォルトの設定は新しいメジャーで変更される場合があります。リリースノートとマイグレーションガイドを確認してください (see アップデーターがアップグレードするその他のガイドは、アップデーター側バーの「マイグレーション」セクションにあります

CLIとコンソールはそれぞれのバージョンを使用します。

Capgo CLIとCapgoコンソールは not Capacitorメジャーバージョンが必要です。

あなたは行います not 最新のCLIを常にインストールまたは呼び出してください。 8 Capacitorとコンソールはそれぞれのバージョンを使用します。 8.
__CAPGO_KEEP_0__とコンソールはそれぞれのバージョンを使用します。 latest CLI.
最新のCLIとコンソールは、どのサポートされている @capgo/capacitor-updater (および関連のアップデート) メジャー。

CLIの古いバージョンを固定することはお勧めしません。代わりに:

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

前回のプラグインメジャーのLTSタグ

古いCapacitorのメジャーに留まる場合、LTS distタグを持つ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リリースは オンデマンドで公開されます.

アップデーターバックポート vs 他のプラグイン

パッケージ	前のメジャーバックポート
`@capgo/capacitor-updater`	月次ミラーリングバックポート `v7` / `v6` / `v5` (`lts-v7`, `lts-v6`, `lts-v5`). `lts-v4` Capacitor 4 では利用可能ですが、毎月のカレンダーに含まれていません
その他の Capgo プラグイン	オンデマンド

オンデマンド

セクション “同等の機能、ミラーリングバージョン番号”

LTS ラインは、バックポートが存在する場合に、現在の最新ラインのマイナーバージョンとパッチバージョンをミラーリングします。 8.3.4バージョニング, the Capacitor 7 LTS ラインは公開されます。 7.3.4 同等の機能セットとバグ修正 、Capgo 7 のメジャーバージョンに適応,Capacitor メジャーに適応されました。

インストールするときは、タグを指定して「この Capacitor の最新のメジャー版」を選択します。

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ラインの公開API は変更される 最新が変更されると、メジャー番号が変わる 7。LTSを「古いCapacitorで現在のCapgoの動作」と見なすのではなく、永久に凍結されたAPIとして永遠に

これがあなたのアプリに意味すること

Capgo プラグインをCapacitor メジャーにアップグレードする
常に @capgo/cli@latest CLI メジャー同期はCapacitor/プラグインの同期は不要
Capacitor 7 (または古い)に留まる場合は @lts-v7 （または一致するタグ）、ランダムな古いものではありません。 7.x 数ヶ月前の古いものではありません。
独自のライブアップデートパッケージをバージョン化してください。 semver Capgo パッケージをバージョン化する方法と同じようにバンドルバージョニングとチャンネルそしてバージョン対象.

アプリを追加してください — アップデートャー用のインストールコマンドとLTSタグ
Capgo CLI — Capgoを実行するためのCLIコマンド
ネイティブ互換性 — ストアバイナリとOTAバンドルのどちらが必要なのか
V7からV8 — Capacitorに合わせたプラグインのメジャーアップグレードの例

バージョニング