更新タイプ

このプラグインのインストール手順と完全なマークダウンガイドを含むセットアップ用の質問をコピーする

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__は、オーバー・ザ・エア（OTA）アップデートのいくつかのタイプをサポートしています。このページでは、すべてのタイプをリストし、説明を付けて、アプリの組み合わせを選択するのに役立ちます。

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

タイプ	説明	利用例
autoUpdate: `atBackground`	起動中の各チェックでダウンロードし、背景に移動したときに適用	ほとんどのアプリ; ほとんどの混乱
autoUpdate: `atInstall`	インストール後に新しいアプリをインストールした直後またはネイティブのアプリストアの更新時のみ即時適用; そうでない場合は `atBackground`	新規ユーザーは最新版を使用; 既存ユーザーは背景適用を使用
autoUpdate: `onLaunch`	起動時に即時適用する場合にのみ、冷却開始 (終了 → フォアグラウンド); その後は `atBackground`	新しさとセッションの安定性のバランス
autoUpdate: `always`	起動中の各トランジションでチェックし、更新が利用可能な場合に即時適用	重大修正、状態が単純なアプリ
autoUpdate: `onlyDownload`	自動で確認し、ダウンロードし、発行 `updateAvailable`, そして自動適用しない	アップデートの提示や適用のタイミングを制御するアプリ `set()`

Configure in capacitor.config.ts:

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

アップデートの動作

条件を満たす必要があります前コンテキスト:Capgoのマーケティングウェブサイト。ロール:長いマーケティングまたは法的文章。ページ/エリア:contributing.astro。メッセージキー:Create An Issue And Discuss Before Working On A New Feature (新機能に取り組む前に問題を提起して議論する)。 setMultiDelay すべての条件を満たす必要があります。

Condition	Description	条件
説明	例	日付
特定の日時まで待つ必要があります	アプリがバックグラウンドに移動した後 (ms) から最小時間待機	アプリのスイッチが速い場合に適用を避ける
nativeVersion	最小のネイティブバイナリバージョンを要求する	ネイティブ code が不互換の場合にアップデートをブロックする
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 戦略

ブロック	許可	使用例	使い方
なし	何も	任意のターゲットバンドルバージョン	デフォルト; フルオートアップデート
メジャー	メジャーが高い `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つのネイティブのマイナーリーン内にアップデートを保持する
パッチ	メジャー、マイナー、またはパッチ番号の変更の場合、例えば `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`	最厳格モード：コアバージョン移動なし
metadata	メタデータ `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

クイックリファレンス

カテゴリ	種類
適用時期	`off`, `atBackground`, `atInstall`, `onLaunch`, `always`, `onlyDownload`
遅延条件	`date`, `background`, `nativeVersion`, `kill`
バージョンブロッキング	`none`, `major`, `minor`, `patch`, `metadata`
配信	フルバンドル、Δ

更新動作 — アプリケーション適用タイミングと遅延の設定
バージョン対象ページ/エリア: Capgo ソリューションズマーケティングページ。役割: 短い UI ラベルまたはナビゲーションアイテム。見られる場所: サイトヘッダー、コンポーネント SolutionsMegaMenu.astro、ページ solutions/version-targeting.astro。メッセージキー `solutions_version_targeting` (ソリューションズバージョンターゲティング)。
— チャネルベースのバージョンルーティング Δ更新
Channels — ダウンロードする変更されたファイルのみ

チャネル

— チャネル設定と優先順位の設定 アップデートの種類 を計画するためにlive updateの配信を、 Capgo Live Updates for the product workflow in Capgo Live Updates, Overview 概要概要の実装詳細に機能機能の実装詳細にアップデートの動作アップデートの動作の実装詳細に、スタートガイド