Skip to content
Capgo - Capacitor アプリ向けのリアルタイム更新 Capgo

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

完了 onboardingCapgoの設定 一度アップロード→テスト→デプロイ 新しいストアビルドを出荷する.

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

一時設定チェックリスト

一時設定チェックリストのセクション

  1. チャンネルを作成する：最小のセットを選択してください（下記を参照）。

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

    • Team → production
    • プロダクション チャンネル： development

  3. パブリック オン、デバイス セルフ セット オフ、ネイティブ オン アンダー ブロック アップデート、オート アップデート ガード オン __CAPGO_KEEP_0__ major.

  4. テストチャンネル (development / stagingデバイス自律モードはQA用にオンになります。

  5. CIからアップロード と --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

    この --bundle 値 は有効でなければなりません シーケンスバージョニングの意味あります. semantic versioning. バリデーションを確認してください SemVer テスター アップロードする前に確認してください

  6. プロダクションにデプロイする テストを実行した後のみ、 ダッシュボード または CLI。

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

暗号化を残す min_update_version、メタデータ、そしてプレビュー オフ 明確な理由がなければなりません。

サイズを選びなさい

「サイズを選びなさい」というセクション

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

チーム: development + production. 開発用にアップロードし、生産用に展開する。

ネイティブ版: 必要な場合のみチャネルを追加する、例えば production-9.0 + test-9.0. メインの生産チャネルにストアユーザーを維持する。

多くのアプリ各アプリごとに同じシンプルなモデル (通常 1 つ)。 production 組織が大きいからといって、チャネルを多く作る必要はありません。

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

バンドル名 vs コメント

バンドル名 vs コメントのセクション

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

  • 名前 = CIからsemverを取得する 1.8.0, 1.8.0-beta.1または 1.8.0-20260629.42
  • コメント = 人間が読みやすいテキスト → commit abc1234 run 28059070270

セマンティック バージョニングを使用する 未リリース版 ラベル (バージョン番号の後ろの部分) -) 1 つのバンドル名で多くのビルドをリリースする場合に使用します。 MAJOR.MINOR.PATCH例えば、 1.8.0 と 1.8.0-20260629.1, 1.8.0-beta.2を使用して、未リリース版のバージョン番号に日付やビルドカウンタを追加します。 fix-login-bug 日付やビルドカウンタを含む未リリース版のバージョン番号は、 2.5.2026062306や

などの形式で記述してください。 --commentこれらの形式は、semver では有効ではありません。アップロードは失敗したり、予期しない動作を示したりする可能性があります。

リリースノートは に記載してください。bundle 名に記載してください。は避けてください。 と バンドルバージョニング.

Δアップロード

Δアップロード

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

Δアップロード --delta デフォルト:

(マニフェスト + zip バックアップ)
ターミナルウィンドウ
npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --delta

ほとんどのアプリケーションでは推奨のデフォルトです。 Capgo にはマニフェストが格納され、フルZIPをバックアップとして保持します。 そして ストレージコストが主な懸念事項ではない場合に適しています。

ストレージを節約する: --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 使用 reduce Capgo storageフルZIPは格納されず、delta/manifestファイルのみが格納されます。ストレージが高額になるアプリケーションや大量のアップロードがある場合に選択してください。

トレードオフ：サーバー上のZIPバックアップがなく、manifestパスに完全に依存します。スキップ --delta-only __CAPGO_KEEP_0__

__CAPGO_KEEP_0__

__CAPGO_KEEP_6__

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

__CAPGO_KEEP_9__

セクションのタイトルは「よくある間違い」
間違い修正
新しいストアのリリース前にOTAを期待しているプラグインを追加した後、ネイティブアプリを再構築して配信する
バンドルをアップロードしているが、チャンネルにデプロイしていないバンドルをチャンネルに割り当てる（例： production)
機能、チケット、または開発者ごとにチャンネル永久的なリリースレーンのみを使用する
CIチャンネル名が動的である固定名： development, production
シンプルなアプリ用にチャンネルが多すぎる1-2チャンネルから始めます
デバイスは生産用に設定されます生産用にオフ、テストチャンネル用にオン
スキップ --delta追加 --delta アップロードに追加して、 --delta-only ストレージを節約する必要がある場合にのみ使用してください
非semverバンドル名semverバージョニングに従って バリデーションを SemVerテスターで検証してください バンドル名はsemver形式で
バージョニングスキームを時間の経過とともに変更する__CAPGO_KEEP_0__1.8.0-20260629.1)
メタデータ/プレビューが有効になっているが理由がないデフォルトでオフにする

詳細を知る

「詳細を知る」をタイトルにしたセクション
チャンネル デフォルト、優先順位、ルーティングについて。
デルタアップデート DELTAを使用する理由と方法について
CI/CD 自動アップロードとデプロイ
バンドル チェックサム、依存関係、メタデータ。