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

アップデートのタイプ

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.

__CAPGO_KEEP_0__

「適用タイミング」を設定

制御 更新がダウンロードされた後、更新が適用されるタイミングです。 プラグインは、画面が前面に表示されるたびに、そして画面が開いている間、一定時間ごとに更新をチェックします。 periodCheckDelay 制御する間隔（デフォルト10分）

種類説明使用例
autoUpdate: atBackground画面が前面に表示されるたびにチェックし、ダウンロードして、画面がバックグラウンドに移動したときに適用ほとんどのアプリ; 最小限の混乱
autoUpdate: atInstall新しいインストールまたはネイティブアプリストアの更新後のみ適用してください。そうでない場合は使用 atBackground新規ユーザーは最新版を取得し、既存のユーザーはバックグラウンドで適用
__CAPGO_KEEP_0__ onLaunch起動直後のみ適用し、更新が必要な場合は atBackground新鮮さとセッションの安定性のバランス
__CAPGO_KEEP_0__ alwaysフォアグラウンドのトランジションごとにチェックし、更新が利用可能な場合は即時適用シンプルな状態を持つアプリや緊急修正
__CAPGO_KEEP_0__ onlyDownloadチェックしダウンロードし、自動適用せずに updateAvailable更新の表示や適用タイミングを制御するアプリ__CAPGO_KEEP_0__ 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
終了次のアプリ終了イベントまで待ってくださいフルリスタートのみに適用
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 チャネル設定

戦略ブロック許可使用例
なし何も任意のターゲットバンドルバージョンデフォルト;フルオートアップデート
メジャーメジャー以上 version_build, for example 1.2.3 -> 2.0.0Same major, for example 1.2.3 -> 1.9.0 or 1.2.3 -> 1.2.4Prevent breaking changes from reaching old native code
minorDifferent major or minor than version_build, for example 1.2.3 -> 1.3.0Same major and minor, for example 1.2.3 -> 1.2.4Keep updates inside one native minor line
patchAny major, minor, or patch number change, for example 1.0.0 -> 1.0.1Only suffix changes while 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

配信タイプ

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

How the bundle is transferred to the device.

TypeDescriptionWhen to Use
Full bundleEntire JS bundle is downloadedFirst install, large changes, or when delta is unavailable
Delta (manifest)Only changed files are downloadedMost updates; faster and bandwidth-friendly
ターミナルウィンドウ
# Full bundle (default)
npx @capgo/cli bundle upload --channel production


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

クイック リファレンス

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

アップデートの種類から続ける

アップデートの種類から続けるのセクション

アップデートの種類から続けるの場合 アップデートの種類から続けるの場合、__CAPGO_KEEP_0__ ライブアップデートに接続してください __CAPGO_KEEP_0__ ライブアップデートの製品ワークフローに Capgo Live Updates Capgo ライブアップデートの製品ワークフローに接続してください。 __CAPGO_KEEP_0__ ライブアップデートの製品ワークフローに接続してください。 概要の実装詳細について 機能 機能の実装詳細について 更新動作 更新動作の実装詳細について スタートガイド 実装詳細について