アップデートタイプ

このプラグインのインストール手順とフルマークダウンガイドを含むセットアップコマンドをコピーします。

Capgoはオーバー・ザ・エア（OTA）アップデートのいくつかのタイプをサポートしています。このページでは、すべてのタイプをリストし、説明を付けて、適切な組み合わせを選択することができます。

タイミングの適用

制御 更新がダウンロードされた後、更新が適用されるタイミング プラグインは、画面が前面に表示されるたびに、更新を確認し、画面が閉じられない限り、一定時間ごとに更新を確認します。 periodCheckDelay 制御する間隔（デフォルト10分）

種類	説明	使用例
autoUpdate: `atBackground`	画面が前面に表示されたときに確認し、画面が背景に移動したときに適用	ほとんどのアプリ;最小限の影響
autoUpdate: `atInstall`	新しいインストールまたはネイティブアプリストアの更新後のみ即時適用; そうでない場合は `atBackground`	新規ユーザーは最新版を取得; 既存ユーザーはバックグラウンド適用
autoUpdate: `onLaunch`	起動後即時適用 (kill → フォアグラウンド); その後は `atBackground`	新鮮さとセッション安定性のバランス
autoUpdate: `always`	フォアグラウンドのトランジションごとにチェックし、更新が利用可能な場合に即時適用	シンプルな状態を持つアプリやクリティカルな修正
autoUpdate: `onlyDownload`	チェックし、ダウンロードする; 但し、自動適用は行わない `updateAvailable`更新の提示や適用のタイミングを制御するアプリ	updatePrompt: `set()`

設定を capacitor.config.ts:

plugins: {
  CapacitorUpdater: {
    autoUpdate: 'atBackground', // default; true is still accepted
    // or: 'off' | 'atInstall' | 'onLaunch' | 'always' | 'onlyDownload'
  }
}

更新の遅延条件

更新がインストールされる前に満たされる必要のある条件 更新がインストールされる前に 更新がインストールされる前に setMultiDelay 更新をインストールする前に使用して組み合わせる (すべての条件を満たす必要があります)

条件	説明	例
日付	特定の日時以降に待機する	サーバー側のリリースと調整する
背景	アプリが背景化された後、最低時間(ms)待機する	アプリのスイッチが速い場合に適用を避ける
ネイティブバージョン	最低ネイティブバイナリバージョンを要求する	不互換なネイティブcodeに対してアップデートをブロックする
kill	Wait until the next app kill event	Apply only on full restart

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.setMultiDelay({
  delayConditions: [
    { kind: 'date', value: '2023-06-01T00:00:00.000Z' },
    { kind: 'background', value: '60000' },
  ],
});

Version Blocking (Channel Policy)

Controls which semver updates 自動配信チャネルが設定されます。__CAPGO_KEEP_0__ --disable-auto-update チャネル設定

戦略	ブロック	許可	使用例
なし	何も	任意のターゲットバンドルバージョン	デフォルト;フルオートアップデート
メジャー	メジャー以上 `version_build`、例えば `1.2.3 -> 2.0.0`	同じメジャー、例えば `1.2.3 -> 1.9.0` または `1.2.3 -> 1.2.4`	古いネイティブのcodeに到達する破壊的な変更を防ぐ
小	メジャーまたは小の数字が異なる場合 `version_build`、例えば `1.2.3 -> 1.3.0`	同じメジャーと小の数字、例えば `1.2.3 -> 1.2.4`	ネイティブの小の数字のライン内にアップデートを保持する
パッチ	メジャー、ミニ、またはパッチ番号の変更、例えば `1.0.0 -> 1.0.1`	サフィックスの変更のみ `MAJOR.MINOR.PATCH` 変わりません、例えば `1.0.0-beta.1 -> 1.0.0-beta.2` または `1.0.0+build.1 -> 1.0.0+build.2`	厳格モード: コアバージョン移動なし
メタデータ	欠落 `min_update_version`, または `version_build` 下にある	ターゲットバンドルの `min_update_version` は、以下の `version_build`	カスタム互換性のルールごとにバンドル

これらのチェックは、送信されたネイティブのベースラインと比較します version_build, ではなく、ダウンロード済みの現在のインストールバンドルとして送信されたもの version_name.

npx @capgo/cli channel set production --disable-auto-update major

配信タイプ

How the bundle is transferred to the device.

Type	Description	When to Use
Full bundle	Entire JS bundle is downloaded	First install, large changes, or when delta is unavailable
Delta (manifest)	Only changed files are downloaded	Most updates; faster and bandwidth-friendly

# Full bundle (default)
npx @capgo/cli bundle upload --channel production

# Delta updates
npx @capgo/cli bundle upload --channel production --delta

クイックリファレンス

カテゴリ	種類
タイミングの適用	`off`, `atBackground`, `atInstall`, `onLaunch`, `always`, `onlyDownload`
遅延条件	`date`, `background`, `nativeVersion`, `kill`
バージョンブロッキング	`none`, `major`, `minor`, `patch`, `metadata`
配信	フルバンドル、デルタ（マニフェスト）

更新動作 — 遅延とタイミングの設定
バージョン対象 — チャネルベースのバージョンルーティング
Δルート (マニフェスト) アップデート — パーシャルダウンロードの有効化
チャンネル — チャンネル設定と優先順位

アップデートの種類から続けて

Capgoを使用している場合 アップデートの種類 ライブアップデートの配信計画を行うには、 Capgo Live Updates for the product workflow in Capgo Live Updates, 概要概要の実装詳細機能機能の実装詳細更新動作開始手順の実装詳細ページを編集前