コンテンツにジャンプする
Capgo - Capacitor アプリ向けライブアップデート Capgo

一度のセットアップチェックリスト

あなたは完了 onboarding. Now configure Capgo あなたは__CAPGO_KEEP_0__を設定する必要があります。その後、毎日は アップロード→テスト→デプロイ.

ルール: チャンネルはリリースの流れ (development, production)、チケット、機能、開発者の名前ではありません。

一回限りのセットアップチェックリスト

セクション「一回限りのセットアップチェックリスト」

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

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

    • チーム → production
    • リリースチャンネル: development

  3. app settings パブリックオン、デバイス自律オフ、ネイティブオンの下で更新をブロック、オートアップデートガードオン major.

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

  5. CIからアップロード with --delta (チェックサムとネイティブ依存関係は自動):

    ターミナルウィンドウ
    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

    The --bundle 値 は有効でなければなりません must セマンティック バージョニング. __CAPGO_KEEP_0__ で検証する SemVer テスター アップロードする前に検証してください。

  6. テストが終わったら、プロダクションにデプロイする ダッシュボードから __CAPGO_KEEP_0__。 or CLI.

  7. 1 回の招待、最小限の権限 2 つの要素 組織に 2 つの要素 CI に 1 つの API キー

暗号化をオフにします。 min_update_version, メタデータ、プレビュー オフ 明確な理由がない場合は

サイズを選択

サイズを選択

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

チーム: development + production. 開発用にアップロード、プロダクション用にデプロイ

ネイティブ版: 必要な場合にのみチャネルを追加する、例えば production-9.0 + test-9.0. 本番チャネルにユーザーを保持するようにしてください。

多くのアプリ: 1 つのアプリごとに通常 1 つの production それぞれ) ごとに同じシンプルなモデルを使用しないでください。

リリーストレイン (任意): staging → rc → production. すべてのアプリに必要なアプリに同じテンプレートを使用してください。

バンドル名 vs コメント

「バンドル名 vs コメント」というセクション

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

  • ですべての名前を検証してください。 名前 1.8.0, 1.8.0-beta.1= CI から semver を取得する、例えば 1.8.0-20260629.42
  • 、または コメント commit abc1234 run 28059070270

Use semver pre-release ラベル (バージョン番号の後ろの部分) -同じバージョン番号の下で多くのビルドを配信する場合に使用します。 MAJOR.MINOR.PATCH例えば、 1.8.0 と追加して、プレリリースに日付またはビルドカウンタを追加してください。 1.8.0-20260629.1, 1.8.0-beta.2プレリリースに日付またはビルドカウンタを追加してください。 fix-login-bug プレリリースに日付またはビルドカウンタを追加してください。 2.5.2026062306プレリリースに日付またはビルドカウンタを追加してください。

プレリリースに日付またはビルドカウンタを追加してください。 --commentプレリリースに日付またはビルドカウンタを追加してください。

プレリリースに日付またはビルドカウンタを追加してください。 __CAPGO_KEEP_0__ と バンドルバージョニング.

デルタアップロード

デルタアップロード

--delta アップロード マニフェスト マニフェスト

デフォルト: --delta デフォルト: --デルタ (マニフェスト + zip バックアップ)

ターミナル画面
バックアップ
npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --delta

ほとんどのアプリでは推奨されるデフォルトです。Capgoはマニフェストを保存します そして ストレージを節約する利点

ストレージ節約: --delta-only --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_KEEP_0__のストレージ reduce Capgo storagedelta/マニフェストファイルのみを保存し、フルZIPは保存しません。ストレージが高価になるアプリや大量のアップロードが発生する場合に使用してください。

サーバー上のzipバックアップがなければ、manifestパスに完全に依存することになる。スキップ --delta-only 実際にストレージの節約が必要な場合に限り

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

毎日のワークフロー

クリップボードにコピー
Upload to development (--delta)
  → test
  → deploy to production
  → don't touch channel settings again

よくある間違い

「よくある間違い」セクション
間違い修正
新しいストアのリリース前にOTAを期待するプラグインを追加した後、ネイティブアプリを再構築して配信する
バンドルをアップロードするが、チャンネルに展開しないバンドルをチャンネルに割り当てる (例えば production)
機能、チケット、または開発者ごとにチャンネルを割り当てる永久的なリリースレーンのみを使用する
ダイナミック CI チャンネル名固定名: development, production
複雑なアプリ用に多すぎるチャネル1-2チャネルから始める
デバイスが自動的にプロダクションモードに設定プロダクション用にオフ、テストチャネル用にオン
スキップ --delta追加 --delta アップロードに追加; ストレージを節約する必要がある場合にのみ使用 --delta-only 非semverバンドル名
semverのバージョニングに従うバンドル名を検証する semantic versioning and validate in the SemVer テスター
バージョニングスキームの変更セマンティックバージョニングを維持し、追加のビルド用にプレリリースラベルを使用します。1.8.0-20260629.1)
メタデータ/プレビューが有効になっているが理由がないデフォルトではオフ

詳細を確認

チャンネル
デフォルト、優先順位、ルーティング デルタアップデート
デルタアップデートの使用方法 CI/CD
CI/CD 自動アップロードとデプロイを自動化
バンドル チェックサム、依存関係、メタデータ