コンテンツにスキップ
Capgo - Capacitor アプリ向けのライブアップデート Capgo

更新タイプ

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

適用タイミング

「適用タイミング」のセクション

コントロール ダウンロード後、更新が適用されるタイミング タイプ

説明用途autoUpdate:
バックグラウンドでダウンロードし、ユーザーがアプリをバックグラウンドに送ったり、アプリを強制終了したときに適用 atBackgroundほとんどのアプリ; 最小限の影響autoUpdate:
新規ユーザーに最新版を提供し、既存ユーザーはデフォルトフローを使用 atInstall新規ユーザーが最新版を使用し、既存ユーザーはデフォルトフローを使用するようにします。__CAPGO_KEEP_0__
__CAPGO_KEEP_0__: onLaunchインストール、ストアの更新、またはアプリの終了後に即時適用新鮮さとセッションの安定性のバランス
__CAPGO_KEEP_0__: always更新がダウンロードされた場合（再開時も含む）に即時適用重大な修正、シンプルな状態を持つアプリ
__CAPGO_KEEP_0__: onlyDownload自動ダウンロードし、 updateAvailable ただし、自動適用や次のバンドルを設定することはありませんアプリが自分の更新の表示を制御し、または正確にアップデートを呼び出す場合 set()

「 capacitor.config.ts:

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

遅延条件

「遅延条件」のセクション

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

説明For full details and splashscreen handling, see __CAPGO_KEEP_0__.例
日付特定の日時まで待つサーバー側のリリースと調整
バックグラウンドアプリがバックグラウンドに移動した後、最低時間(ms)待つアプリのスイッチが速い場合に適用しない
ネイティブバージョンネイティブバイナリの最低バージョンを要求不相応のネイティブcodeの更新をブロック
終了次のアプリ終了イベントまで待つ全リスタート時のみ適用
import { CapacitorUpdater } from '@capgo/capacitor-updater';


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

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

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

制御する semver チャネルは自動で配信するsemverアップデートを設定します。 --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

配信タイプ

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

バンドルがどのように転送されるか バンドルがどのように転送されるか デバイスに送信します。

タイプ説明使用するとき
フルバンドル全てのJSバンドルがダウンロードされます。初回インストール、変更が大きい、またはデルタが利用できない場合
デルタ(マニフェスト)変更されたファイルのみがダウンロードされます。ほとんどの更新; 速く帯域幅に優しい
ターミナルウィンドウ
# Full bundle (default)
npx @capgo/cli bundle upload --channel production


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

カテゴリ

タイプ
適用タイミング__CAPGO_KEEP_0__
__CAPGO_KEEP_0__off, atBackground, atInstall, onLaunch, always, onlyDownload
遅延条件date, background, nativeVersion, kill
バージョンブロッキングnone, major, minor, patch, metadata
配信フルバンドル、デルタ（マニフェスト）
セクション「関連」

Update Typesから続ける

Update Typesから続けるセクションのタイトル

Capgoを使用している場合 Update Types を使用してライブアップデートの配信計画を立てる場合、__CAPGO_KEEP_0__ Live Updates に接続してください。Capgo Live Updates for the product workflow in Capgo Live Updates, の概要 Live Updatesの実装詳細についてはOverview の詳細を参照してください。Features 機能の実装詳細については、 更新動作 機能の実装詳細については、更新動作、 はじめに 機能の実装詳細については、はじめに。