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

更新タイプ

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

適用タイミング

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

制御 ダウンロードされたアップデートが適用されるタイミング タイプ

説明使用シナリオ制御
Default__CAPGO_KEEP_0____CAPGO_KEEP_0__
directUpdate: atInstall__CAPGO_KEEP_0____CAPGO_KEEP_0__
directUpdate: onLaunch__CAPGO_KEEP_0__directUpdate:
__CAPGO_KEEP_0__ alwaysdirectUpdate:Critical fixes, apps with simple state

設定する capacitor.config.ts:

plugins: {
  CapacitorUpdater: {
    directUpdate: false, // default
    // or: 'atInstall' | 'onLaunch' | 'always'
  }
}

遅延条件

「遅延条件」セクション

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

条件説明例
日付特定の日時以降に待機するサーバーサイドのリリースと調整する
背景アプリが背景化された後、最小時間(ms)待機するアプリのスイッチが速い場合に適用を避ける
ネイティブバイナリの最小バージョンを要求するネイティブ__CAPGO_KEEP_0__が不相応の場合のアップデートをブロックする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更新 自動配信チャンネルが設定されます。__CAPGO_KEEP_0__ --disable-auto-update チャンネル設定

戦略ブロック許可使用例
なし何もすべての更新デフォルト; フルオートアップデート
メジャー0.0.0 → 1.0.0メジャー同等 (例: 1.x → 1.y)古いネイティブに到達する破壊的な変更を防ぐ
小さな0.0.0 → 1.1.0, 1.1.0 → 1.2.0同じ小さなバージョン (例: 1.2.x → 1.2.y)メジャー内での厳しい制御
パッチメジャーバージョン以外の変更0.0.311 から 0.0.314 までの更新パッチのみの更新; 非常に厳しい制限
メタデータメタデータなしの更新 min_update_versionメタデータありの更新バンドルごとのカスタム互換性のルール
ターミナルウィンドウ
npx @capgo/cli channel set production --disable-auto-update major

配信タイプ

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

デバイスにバンドルが転送される方法。 ファイルの変更が少ない場合に使用します。 ファイルの変更が多い場合に使用します。

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


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

クイック リファレンス

「クイック リファレンス」のセクション
カテゴリタイプ
タイミングの適用デフォルト atInstall, onLaunch, always
遅延条件date, background, nativeVersion, kill
バージョンブロッキングnone, major, minor, patch, metadata
配信フルバンドル、デルタ(マニフェスト)
セクション「関連」