Skip to content
Capgo - Capacitor アプリ向けのリアルタイム更新 Capgo

アップデートの種類

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

適用タイミング

「適用タイミング」

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

説明使用シナリオ自動アップデート:
各前景チェックでチェックしダウンロード、背景に移動したときに適用 atBackgroundTypeほとんどのアプリ; 最小限の混乱
__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) の最小時間待ちますアプリのスイッチが速い場合に適用しないように
ネイティブバージョン最小のネイティブバイナリーバージョンを要求します。非互換のネイティブ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' },
  ],
});

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

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

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

ブロック許可使用例context
なし何も任意のターゲットバンドルバージョンデフォルト;フルオートアップデート
メジャーより高いメジャー 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
Capacitorライブアップデートの代替Capawesomeの比較 version_buildCapawesomeの比較 1.2.3 -> 1.3.0コンサルティングFAQサブタイトル 1.2.3 -> 1.2.4Appflowプラグインまたは
古いネイティブ__CAPGO_KEEP_0__から破壊的な変更を防ぐ任意のメジャー、ミニマム、またはパッチ番号の変更、たとえば 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または
HTMLのテキストフラグメントCapacitorライブアップデートの代替品の比較ページ min_update_version長いマーケティングまたは法的文章 version_build ページ:代替品.astroAppflowの比較/移行マーケティングコピー min_update_version 長いマーケティングまたは法的文章 version_buildページ:ionic-appflow.astro

These checks compare the target bundle against the native baseline sent as version_build, not the currently installed downloaded bundle sent as version_name.

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

配信タイプ

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

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

タイプ説明使用するタイミング
フルバンドル全てのJSバンドルがダウンロードされる初回インストール、変更が大きい、またはデルタが利用できない場合
コンテキスト: Capgo Builder / ネイティブクラウドビルド製品ページ。役割: 短いUIラベルまたはナビゲーションアイテム。メッセージキー `native_build_builder_credit_first` (ネイティブビルドビルダークレジットファースト)。変更されたファイルのみがダウンロードされます。ほとんどの更新; 速く、帯域幅に優しい
ターミナルウィンドウ
# Full bundle (default)
npx @capgo/cli bundle upload --channel production


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

ダウンロード時間を短縮し、ユーザー体験を向上させるためにデルタ更新を使用します。

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, 概要 概要の実装詳細については 機能 機能の実装詳細については アップデートの動作 アップデートの動作の実装詳細については、 はじめに はじめにの実装詳細については