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

初回設定後チェックリスト

あなたは完了しました onboarding. Now configure Capgo onceその後、毎日作業はただ アップロード → テスト → デプロイ.

トラブルシューティング ルール:development, productionチャンネルはリリースの流れ（)、チケット、機能、または開発者の名前ではありません。

一時設定チェックリスト

セクションのタイトル「一時設定チェックリスト」

  1. チャンネルを作成する: 最小セットを選択してください (以下を参照してください).

  2. デフォルトアップロードチャンネルを設定 で アプリ設定:

    • ソロアプリ → production
    • チーム → development

  3. プロダクションチャンネル: パブリックオン、デバイス自律オフ、ネイティブ更新ブロックオン、オートアップデートガードオン major.

  4. テストチャンネル (development / staging): パブリックオフ、デバイス自律オン(QA用).

  5. CI からアップロード with --delta ({checksum and native dependencies are automatic):

    トミムストログ
    npx @capgo/cli@latest bundle upload \
      --channel development \
      --bundle "1.8.0-${BUILD_NUMBER}" \
      --comment "commit ${GIT_SHA:0:7} run ${CI_RUN_ID}" \
      --delta

    コンタートログ --bundle コンタートログ must 有効なもの パトログです、コンタートログに反定にきですパトログです、コンタートログに反定にきです パトログです、コンタートログに反定にきです パトログです、コンタートログに反定にきです

  6. パトログです、コンタートログに反定にきです テストが完了した後、または ダッシュボード CLI。

  7. チーム & セキュリティ: 組織に一度だけ招待し、最小限の権限で 2要素認証 CIで1つのAPIキー

暗号化をオフ min_update_version, メタデータ、プレビュー オフ 明確な理由がなければ

サイズを選択

サイズを選択

シンプル: 1アプリ、1チャンネル: production

チーム: development + productionページ/エリア: Capgo マーケティング ウェブサイト。役割: 短い UI ラベルまたはナビゲーション アイテム。ページ sla.astro で見られる。メッセージ キー `team_plan` (チーム プラン)。

. 開発用にアップロード、実稼働用に展開。ネイティブ バージョン production-9.0 + test-9.0: 必要なときにのみチャンネルを追加する、例えば

アプリケーション多数多くのアプリ production : 1 つのアプリごとに同じシンプルなモデル (通常 1 つ)。組織が大きいだけにチャンネルを多く作る必要はない。

リリース トレイン (option) staging → rc → production. 同じテンプレートは、必要なすべてのアプリに使用されます。

バンドル名とコメント

バンドル名とコメント

バンドル名は 必要 セマンティックバージョニングを に従う必要があります。Capgoは、互換性のチェック、チャンネル自動更新のルール、ロールバックのためにsemverを使用します。すべての名前を検証してください。 バージョン管理テスター アップロードする前に

  • 名前 = CI から取得した SemVer 例えば 1.8.0, 1.8.0-beta.1、または 1.8.0-20260629.42
  • コメント = ヒューマン向けのフリーテキスト → commit abc1234 run 28059070270

SemVer を使用する プレリリースラベル (プレリリースラベルは、同じバージョンで多くのビルドを出荷する場合の) -の部分。例えば、 MAJOR.MINOR.PATCHCapgoのセットアップ後チェックリストの例では、 . 例えば、 Capgoのセットアップ後チェックリストの例では、 . 例えば、 Capgoのセットアップ後チェックリストの例では、 . 例えば、 Capgoのセットアップ後チェックリストの例では、 . 例えば、 Capgoのセットアップ後チェックリストの例では、 . 例えば、 Capgoのセットアップ後チェックリストの例では、 . 例えば、 Capgoのセットアップ後チェックリストの例では、 . 例えば、 Capgoのセットアップ後チェックリストの例では、 . 例えば、 Capgoのセットアップ後チェックリストの例では、 . 例えば、 Capgoのセットアップ後チェックリストの例では、 . 例えば、 Capgoのセットアップ後チェックリストの例では、 . 例えば、 Capgoのセットアップ後チェックリストの例では、 . 例えば、 Capgoのセットアップ後チェックリストの例では、 . 1.8.0 と、プレリリースに日付またはビルドカウンタを追加します。 1.8.0-20260629.1, 1.8.0-beta.2。カスタム形式を発明しないでください。 fix-login-bug 、または 2.5.2026062306。カスタム形式を発明しないでください。

。カスタム形式を発明しないでください。 --comment。カスタム形式を発明しないでください。

See also 。カスタム形式を発明しないでください。 and 。カスタム形式を発明しないでください。.

。カスタム形式を発明しないでください。

。カスタム形式を発明しないでください。

--delta アップロード Δファイル デバイスは毎回全てのファイルをダウンロードするのではなく、変更されたファイルのみをダウンロードするので、パフォーマンスが向上します。チェックサムは常に自動的に計算されます。チェックサムフラグを指定する必要はありません。

デフォルト: --delta (Δファイル + zip バックアップ)

セクション "デフォルト: --delta (Δファイル + zip バックアップ)"
ターミナルウィンドウ
npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --delta

この設定は、ほとんどのアプリケーションで推奨されるデフォルトです。Capgo は Δファイルを保存し、フルな zip をバックアップとして保存します。 そして デバイスが古いプラグインバージョンで Δサポートが無い場合、zip を使用します。ストレージコストが主な懸念事項ではない場合に適しています。

ストレージの節約: --delta-only

Storage saving: --delta-only
ターミナル画面
npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --comment "commit ${GIT_SHA:0:7} run ${CI_RUN_ID}" \
  --delta-only

使用 --delta-only 必要な場合にのみ Capgo のストレージを削減します。 Delta ファイルのみが保存され、フル ZIP は保存されません。 大規模アプリまたは高アップロードボリュームの場合、ストレージが蓄積されるため、このオプションを選択します。トレードオフ: サーバー上の ZIP バックアップがなく、完全に Delta ファイルに依存し、Delta サポートがない古いプラグインバージョンのデバイスでは更新ができません。 スキップ

必要な場合にのみ実行してください。 --delta-only ストレージの節約が必要な場合は除きます。

デバイス上で追加のプラグイン設定は必要ありません。アップデーターは、差分ファイルのリストを読み取り、変更されたファイルのみを取得します。

日々のワークフロー

Daily workflow
Upload to development (--delta)
  → test
  → deploy to production
  → don't touch channel settings again

コモン・ミスステイク

Common mistakes
MistakeFix
OTAの新しいストアリリース前に期待するプラグインを追加した後、ネイティブアプリを再構築して配信する
バンドルをアップロードするが、チャンネルに展開しないバンドルをチャンネルに割り当てる (例えば production)
機能ごと、チケットごと、開発者ごとにチャンネルを分ける永久的なリリースレーンのみを使用する
CIチャンネル名を動的に変更する固定名: development, production
シンプルなアプリ用にチャンネルが多すぎる1-2チャンネルから始める
デバイスが生産用に設定されている生産用ではオフ、テストチャンネルではオン
スキップ --delta追加 --delta アップロードに追加; 必要なときにのみ使用 --delta-only 非semver バンドル名
フォローシーケンスバージョニング バージョニングスキームを変える semverを維持; プレリリースラベルを使用して追加のビルドを追加 メタデータ / プレビュー有効
デフォルトでオフバージョニングスキームを変える1.8.0-20260629.1)
semverを維持; プレリリースラベルを使用して追加のビルドを追加メタデータ / プレビュー有効

詳細を確認

詳細を確認
チャンネル デフォルト、優先度、ルーティング
Δ更新 Δ更新の使用方法と理由
CI/CD 自動アップロードとデプロイ
バンドル チェックサム、依存関係、メタデータ