一回限りのセットアップチェックリスト
このプラグインのインストール手順とフルマークダウンガイドを含むセットアップコマンドをコピーしてください。
オンボーディング onboarding. Capgo を設定するには 一度. その後、毎日の作業は アップロード → テスト → デプロイ.
チャンネルはリリースのレーン ( ) です。チケット、機能、または開発者の名前ではありません。development, production一時設定チェックリスト
一時設定チェックリスト
チャンネルを作成する-
: 最小のセットを選択してください (以下を参照)チャンネルを作成する
-
デフォルトアップロードチャンネルを設定 in アプリ設定:
- Soloアプリ →
production - Team →
development
- Soloアプリ →
-
プロダクションチャンネル: パブリックオン、デバイス自律オフ、ネイティブオンの更新ブロック、オートアップデートガードオン
major. -
テストチャンネル: (
development/stagingパブリックオフ、デバイス自律オンfor QA. -
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この
--bundle値 は 有効 シーケンスバージョニング. これを SemVer テスター で検証する -
アップロード 生産環境にデプロイする ダッシュボード または CLI。
-
チーム & セキュリティ: 招待 1 回、最小限の権限 2要素認証 組織のために 1 つの API キーを CI に
暗号化 min_update_versionメタデータ、プレビュー オフ 明確な理由がない限り
サイズを選択
「サイズを選択」のセクションシンプル: 1 アプリ、1 チャネル: production
チーム: development + production. 開発用にアップロード、実用に展開。
ネイティブ版: 必要なときにのみチャネルを追加する、例えば production-9.0 + test-9.0. メインの実用チャネルにストアユーザーを維持する。
多数のアプリ: 同じシンプルなモデルを各アプリに適用する（通常は１つ）。組織が大きいからといって、チャネルを多く作る必要はない。 production リリーストレイン
(任意:) __CAPGO_KEEP_0__ staging → rc → production. 同じテンプレートがすべてのアプリに必要。
バンドル名とコメント
「バンドル名とコメント」のセクションバンドル名は 必要 セマンティックバージョニングを に従う必要があります。Capgoは、互換性のチェック、チャンネル自動更新のルール、ロールバックのためにsemverを使用しています。すべての名前を SemVerテスター アップロード前に。
- Name = CI から semver 例えば
1.8.0,1.8.0-beta.1、または1.8.0-20260629.42 - Comment = 人間が読めるテキスト →
commit abc1234 run 28059070270
semver を使用 プレリリース ラベル（バージョン番号の後ろの部分）を使用して、同じバージョン番号の多くのビルドを配布する場合。 -例えば、 MAJOR.MINOR.PATCHと追加して、プレリリースに日付またはビルドカウンタを追加します。 1.8.0 __CAPGO_KEEP_0__ 1.8.0-20260629.1, 1.8.0-beta.2. Do not invent custom formats like __CAPGO_KEEP_0__、__CAPGO_KEEP_1__。 They are not valid semver and uploads will fail or behave unpredictably。 fix-login-bug リリースノートは、バンドル名にではなく、 2.5.2026062306も参照してください
バージョン対象 --commentと
バンドルバージョン Δアップロード タイトル「Δアップロード」 Δアップロード.
バンドルバージョン
バンドルバージョン--delta バンドルバージョン manifest デバイスは毎回全てのファイルをダウンロードするのではなく、変更されたファイルのみをダウンロードするようにします。チェックサムは常に自動的に計算されます。チェックサムフラグを指定する必要はありません。
Default: --delta (manifest + zip backup)
「Default: --delta (manifest + zip backup)」npx @capgo/cli@latest bundle upload \ --channel development \ --bundle "1.8.0-${BUILD_NUMBER}" \ --deltaほとんどのアプリでは推奨されるデフォルトです。Capgoはmanifestを保存し、フルZIPをバックアップとして保存します。ストレージコストが主な問題ではありません。 ストレージを節約する: 「ストレージを節約する: --delta-only」
Section titled “Storage saving: --delta-only” --delta-only
Section titled “Default: --delta (manifest + zip backup)”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ストレージを削減するには、. Only the delta/manifest files are stored, not the full zip. Choose this for large apps or high upload volume where storage adds up.Trade-off: without the zip backup on the server, you rely fully on the manifest path. Skip
unless you actually need the storage savings. --delta-only No extra plugin config is required on the device. The updater reads the manifest and fetches changed files only.
Tip
Daily workflow
Section titled “Daily workflow”Upload to development (--delta) → test → deploy to production → don't touch channel settings againCommon mistakes
Section titled “Common mistakes”| Mistake | Fix |
|---|---|
| 新しいストアのリリース前にOTAを期待している | プラグインを追加した後、ネイティブアプリを再構築して配信する |
| __CAPGO_KEEP_0__をアップロードするが、チャネルにデプロイしない | __CAPGO_KEEP_0__をチャネルに割り当てる (例えば、 production) |
| 機能、チケット、または開発者ごとにチャネルを設定する | 常にリリースレーンを使用する |
| CIチャネル名を動的に設定する | 固定名: development, production |
| シンプルなアプリには多くのチャネルが必要ない | 1-2チャネルから始める |
| デバイスは生産環境で設定される | 生産環境ではオフ、テストチャネルではオン |
__CAPGO_KEEP_0__ --delta | 追加 --delta アップロードに使用する場合のみ --delta-only ストレージを節約する必要がある場合のみ |
| 非semver バンドル名 | 「Follow」を参照してください セマンティック バージョニングを使用してください セマンティック バージョニングを使用してバージョンを検証する セマンティック バージョニングを使用してバージョンを検証する |
| バージョニング スキームを時間の経過とともに変更しないでください | セマンティック バージョニングを使用し、プレリリース ラベルを追加ビルドに使用してください (1.8.0-20260629.1) |
| メタデータ / プレビューが有効になっているが理由がない場合 | デフォルトではオフにする |