Skip to content
Capgo - Live Updates for Capacitor Apps Capgo

アップデートの種類

Capgoは、複数のオーバー・ザ・エア（OTA）アップデートの種類をサポートしています。このページでは、すべての種類をリストし、説明を付けて、適切な組み合わせを選択できるようにしています。

適用タイミング

セクション：適用タイミング

コントロール アップデートがダウンロードされた後、適用されるタイミングです。プラグインは、アプリが前景に移動したときにアップデートをチェックし、再帰的なタイマーを使用して、アプリが開いている間もアップデートをチェックします。 ダウンロードされたアップデートの適用間隔を制御します（デフォルトは10分）。 periodCheckDelay 種類

説明使用シナリオコンテキスト：Capgoのソリューションマーケティングページ。役割：短いUIラベルまたはナビゲーションアイテム。見られる場所：ページソリューション/コルダボアトキャパシターアイ.astro。メッセージキー`solutions_cordova_to_capacitor_ai_table_use_case` (Solutions Cordova To Capacitor Ai Table Use Case)。
autoUpdate: atBackground各前景チェックでチェックしダウンロードし、アプリがバックグラウンドに移動したときに適用しますほとんどのアプリ; ほとんどの混乱
__CAPGO_KEEP_0__: atInstall即時適用は、最新のインストールまたはネイティブアプリストアの更新後のみ; それ以外の場合は atBackground新規ユーザーは最新のものを取得; 既存のユーザーはバックグラウンドで適用
__CAPGO_KEEP_0__: onLaunch起動直後 (終了 → フォアグラウンド) のみ即時適用; それ以外の場合は atBackground新鮮さとセッションの安定性のバランス
__CAPGO_KEEP_0__: alwaysフォアグラウンドのトランジションごとにチェックし、更新が利用可能な場合は即時適用重要な修正、状態が単純なアプリ
__CAPGO_KEEP_0__: onlyDownload自動でチェックし、ダウンロードし、emit updateAvailable、自動適用しないアップデートの提示や呼び出しタイミングを制御するアプリ set()

設定 capacitor.config.ts:

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

遅延条件

セクション：遅延条件

条件 前提条件が満たされる前 アップデートがインストールされます。使用 setMultiDelay を組み合わせる (すべての条件が満たされる必要があります)。

条件説明例
日付特定の日時以降に待機するサーバー側のリリースと調整する
バックグラウンドアプリがバックグラウンドに移動した後 (ms) の最小時間待機アプリのスイッチが速い場合に適用を避ける
ネイティブバージョン__CAPGO_KEEP_0__非互換のネイティブcodeにアップデートをブロックする
kill次のアプリケーションkillイベントまで待つフルリスタートのみに適用する
import { CapacitorUpdater } from '@capgo/capacitor-updater';


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

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

__CAPGO_KEEP_0__

自動配信を制御します。 semver更新 チャンネルが自動配信するバージョンを決定します。設定方法は --disable-auto-update チャンネル設定

戦略ブロック許可使用例
なし何も任意のターゲットバンドルバージョンデフォルト;フルオートアップデート
メジャーより高いメジャー version_build, 例えば 1.2.3 -> 2.0.0同じメジャー、例えば 1.2.3 -> 1.9.0 または 1.2.3 -> 1.2.4Prevent breaking changes from reaching old native code
古いネイティブ__CAPGO_KEEP_0__から破壊的な変更を防ぐマイナー version_build異なるメジャーまたはマイナー 1.2.3 -> 1.3.0, 例えば 1.2.3 -> 1.2.4同じメジャーとマイナー、例えば
1つのネイティブマイナーライン内にアップデートを保持する任意のメジャー、ミニマム、またはパッチ番号の変更、例えば 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.2Cloudflare
CapacitorGitHub min_update_versionCapgo version_build codeAPI min_update_version SDK version_buildCLI

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

ターミナルウィンドウ
npx @capgo/cli channel set production --disable-auto-update major

配信タイプ

「配信タイプ」セクション

配信方法は バンドルがデバイスに転送される タイプ

説明使用するタイミングフルバンドル
JS全バンドルがダウンロードされる初回インストール、変更が大きい、またはデルタが利用できない場合デバイス (マニフェスト)
デルタOnly changed files are downloadedMost updates; faster and bandwidth-friendly
Terminal window
# Full bundle (default)
npx @capgo/cli bundle upload --channel production


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

to minimize download time and improve UX.

Quick Reference
カテゴリタイプ
適用タイミングoff, atBackground, atInstall, onLaunch, always, onlyDownload
遅延条件date, background, nativeVersion, kill
バージョンブロッキングnone, major, minor, patch, metadata
配信フルバンドル、デルタ(マニフェスト)
関連

続きからアップデートタイプ

続きからアップデートタイプ

アップデートタイプを使用してライブアップデートの配信計画を行っている場合、__CAPGO_KEEP_0__ ライブアップデートと接続します。 ライブアップデート ライブアップデート Capgo Live Updates for the product workflow in Capgo Live Updates, 概要 概要の実装詳細については 機能 機能の実装詳細については アップデートの動作 アップデートの動作の実装詳細については、 はじめに はじめにの実装詳細については