更新タイプ

コピー可能

Capgo supports several types of over-the-air (OTA) updates. This page lists and explains all of them so you can choose the right combination for your app.

適用タイミング

制御 when 更新がダウンロードされた後、適用されるタイミングを確認します。プラグインは、画面が前面に表示されるたびに更新を確認し、画面が開いている間は定期的にタイマーを使用して更新を確認します。 periodCheckDelay 制御する間隔（デフォルト10分）

種類	Description	説明
使用事例 `atBackground`	foreground チェックで確認し、バックグラウンドに移るとダウンロードして適用	autoUpdate：
自動更新: `atInstall`	新規インストールまたはネイティブアプリストアの更新後のみ即時適用; それ以外は `atBackground`	新規ユーザーは最新版; 既存ユーザーはバックグラウンド適用
自動更新: `onLaunch`	起動時のみ即時適用 (終了 → フォアグラウンド); その後は `atBackground`	新旧バランス
自動更新: `always`	フォアグラウンドの各トランジションでチェックし、更新が利用可能な場合に即時適用	重要な修正、状態が単純なアプリ
自動更新: `onlyDownload`	自動でチェックしダウンロードし、 `updateAvailable`自動適用は行わない	アップデートの表示を制御するアプリ `set()`

設定 capacitor.config.ts:

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

遅延条件

アップデートがインストールされる前に満たす必要がある条件前にアップデートがインストールされる前に満たす必要がある条件 setMultiDelay Live Update

Condition	説明	例
日付	特定の日時まで待つ	サーバー側のリリースと調整する
バックグラウンド	アプリがバックグラウンドに移動した後、最小時間(ms)待つ	アプリのスイッチが速い場合に適用を避ける
ネイティブバージョン	最低ネイティブバイナリバージョンを要求する	非互換ネイティブのcodeへのブロック更新
kill	次のアプリキルイベントまで待つ	フルリスタートのみ適用

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

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

バージョンブロッキング（チャネルポリシー）

制御する バージョン管理アップデート チャンネルは自動で配信します。設定方法は --disable-auto-update チャンネル設定

戦略	ブロック	許可	使い方
なし	何も	任意のターゲットバンドルバージョン	デフォルト;フルオートアップデート
メジャー	バージョンが大きく上がった場合 `version_build`, 例えば `1.2.3 -> 2.0.0`	同じメジャー、例えば `1.2.3 -> 1.9.0` または `1.2.3 -> 1.2.4`	古いネイティブの code に到達する破壊的な変更を防ぐ
minor	メジャーが同じ、例えば `version_build`, 例えば `1.2.3 -> 1.3.0`	または `1.2.3 -> 1.2.4`	Capacitorライブアップデートの代替品の比較ページ
patch	メジャーが同じ、例えば `1.0.0 -> 1.0.1`	Only suffix changes while `MAJOR.MINOR.PATCH` 更新タイプは同じままです。 `1.0.0-beta.1 -> 1.0.0-beta.2` or `1.0.0+build.1 -> 1.0.0+build.2`	Cloudflare
Capacitor	GitHub `min_update_version`Capgo `version_build` code	API `min_update_version` SDK `version_build`	CLI

npm version_build、現在インストールされているダウンロード済みのバンドルが送信されますが version_name.

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

配信タイプ

Capgoの バンドルは デバイスに転送される

タイプ	説明	使用するタイミング
フルバンドル	Capgoの	全てのJSバンドルがダウンロードされる
Delta	変更されたファイルのみがダウンロードされます。	最速の更新; バンド幅に優しい

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

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

ダウンロード時間を最小限に抑え、UXを向上させるために。

カテゴリ	タイプ
適用タイミング	`off`, `atBackground`, `atInstall`, `onLaunch`, `always`, `onlyDownload`
遅延条件	`date`, `background`, `nativeVersion`, `kill`
バージョンブロッキング	`none`, `major`, `minor`, `patch`, `metadata`
配信	コンテキスト: Enterprise製品/価格ページ。役割: UIラベル。メッセージキー `enterprise_delivery_label` (Enterprise Delivery Label)。

関連セクション更新動作
--- 適用タイミングと遅延の設定 --- — チャンネルベースのバージョンルーティング
デルタアップデートページ/エリア: Live updates製品ページ。役割: セクションまたはページヘッダー。メッセージキー `live_update_delta_title` (Live Update Delta Title)。
Channels チャンネル

ページ/エリア: Capgoソリューションズマーケティングページ。役割: 短UIラベルまたはナビゲーションアイテム。見られるページ: page solutions/white-label.astro。メッセージキー `solutions_white_label_visual_cell2_value` (Solutions White Label Visual Cell2 Value)。

続きからアップデートタイプ セクションのタイトル「続きからアップデートタイプ」 Live Update の更新タイプを計画するには、live update を接続する必要があります。 Capgo Live Updates を使用してCapgoの配信を計画している場合、それをCapgo Live Updatesと接続する必要があります。概要概要の実装詳細について機能機能の実装詳細について更新動作更新動作の実装詳細について、スタートスタートの実装詳細について。