📦 bundle

📦 Capgo Cloud でのデプロイ用アプリバンドルを管理（アップロード、互換性チェック、暗号化を含む）。

⬆️ アップロード

エイリアス: u

npx @capgo/cli@latest bundle upload

配布用に新しいアプリbundleをCapgo Cloudへuploadします。 バージョンは0.0.0より大きく、かつ一意である必要があります。セキュリティ上、削除済みのバージョンは再利用できません。 Externalオプション：URLリンクのみを保存します（200MBを超えるアプリやプライバシー要件がある場合に便利です）。 Capgoは外部コンテンツを一切検査しません。トラストレスなセキュリティを実現するには暗号化を追加してください。

例:

npx @capgo/cli@latest bundle upload com.example.app --path ./dist --channel production,beta

バージョンを渡さない場合、チャンネル（または最新のリモートアプリバージョン）から次の空きsemverに自動bumpします。 --bundle. CIで、次の場合に便利です： package.json すでにCapgoに存在するバージョンと一致している場合：

npx @capgo/cli@latest bundle upload --channel=production --auto-bump
npx @capgo/cli@latest bundle upload --auto-bump major
npx @capgo/cli@latest bundle upload --auto-bump minor   # default when the flag has no value
npx @capgo/cli@latest bundle upload --auto-bump patch   # alias: fix
npx @capgo/cli@latest bundle upload --auto-bump metadata
npx @capgo/cli@latest bundle upload --channel=production --auto-bump ai

を使用すると、 --auto-bump ai, Capgo Cloudflare Workers AI がローカルの bundle ファイルを前回の Capgo/channel の差分 manifest と比較し、 major | minor | patch | metadata、CLI ログに短い理由を出力します。以前の Capgo バージョンが存在しない場合、AI はスキップされ、bump はデフォルトで パッチ.

オプション:

パラメータ	種類	説明
-a	string	アカウントに紐付ける API キー
-p	string	アップロードするフォルダのパス。指定しない場合は、capacitor.config で設定された webDir が使用されます
-c	string	リンクするチャネル。複数指定する場合はカンマ区切り（例: production,beta）
—rollout	string	アップロードした bundle を、このチャネルの rollout 対象として 0〜100 のパーセンテージで設定します
—stable	boolean	rollout が設定されたチャネルで、rollout 対象を設定する代わりに stable フォールバックを置き換えます
—rollout-percentage-bps	string	アップロードした bundle の rollout パーセンテージを 0〜10000 のベーシスポイントで設定します
—rollout-cache-ttl-seconds	string	Cloudflare の rollout 判定キャッシュ TTL（秒）
-e	string	Capgo Cloud にアップロードする代わりに外部URLにリンクする
—iv-session-key	string	外部バンドルURL用のIVとセッションキーを設定します
—s3-region	string	S3バケットのリージョン
—s3-apikey	string	S3エンドポイント用のAPIキー
—s3-apisecret	string	S3エンドポイント用のAPIシークレット
—s3-endpoint	string	S3エンドポイントのURL
—s3-bucket-name	string	AWS S3 バケット名
—s3-port	string	S3 エンドポイントのポート番号
—no-s3-ssl	boolean	S3 アップロードの SSL を無効化
—key-v2	string	プライベート署名キーのカスタムパス (v2 システム)
—key-data-v2	string	プライベート署名キー (v2 システム)
—bundle-url	boolean	bundle URL を stdout に出力
—no-key	boolean	署名キーを無視して、暗号化されていないアップデートを送信します
—no-code-check	boolean	ソースの code 内で notifyAppReady() が呼ばれているか、ルートフォルダに index が存在するかのチェックを無視します
—display-iv-session	boolean	アップデートの暗号化に使用された IV とセッションキーをコンソールに表示します
-b	string	アップロードする bundle のバージョン番号
—auto-bump	string	チャンネルにリンクされた bundle、なければ最新のリモートアプリバージョンから自動インクリメントします。レベル: major、minor (デフォルト)、patch (fix のエイリアス)、metadata、ai (Workers AI がローカルと前回の差分 manifest からレベルを推測。前回の Capgo バージョンがない場合は patch にフォールバック)。空き名が見つかるまでバンプします (削除済みの名前は使用済みのまま)。—bundle (-b) とは併用できません
—link	string	外部リソースへのリンク (例: GitHub のリリース)
—comment	string	このバージョンに関するコメント。リリースノート、コミットハッシュ、コミットメッセージなどを指定できます。
—min-update-version	string	このバージョンにアップデートするために必要な最小バージョン。チャンネルで disable auto update が metadata に設定されている場合のみ使用されます。
—auto-min-update-version	boolean	ネイティブパッケージに基づいて最小アップデートバージョンを設定します。
—ignore-metadata-check	boolean	アップロード時のメタデータ (node_modules) チェックをスキップします。
—fail-on-incompatible	boolean	バンドルがチャンネルの現在のネイティブパッケージと互換性がない場合、アップロードせずにエラー終了 (exit non-zero) します。インタラクティブターミナルではネイティブビルドを選択できますが、拒否すると失敗します。—ignore-metadata-check との併用はできません。
—ignore-checksum-check	boolean	アップロード時のチェックサムチェックをスキップします。
—force-crc32-checksum	boolean	アップロード時のCRC32チェックサムを強制（自動検出を上書き）
—timeout	string	アップロード処理のタイムアウト（秒）
—multipart	boolean	[非推奨] 代わりに —tus を使用してください。S3アップロードでmultipartプロトコルを使用します
—zip	boolean	zipでbundleをCapgo cloudへアップロードします（レガシー）
—tus	boolean	TUSでbundleをCapgo cloudへアップロードします
—tus-chunk-size	string	TUSレジュームアップロードのチャンクサイズ（バイト単位、デフォルト: auto）
—partial	boolean	[非推奨] 代わりに —delta を使用してください。差分アップデートをアップロードします
—partial-only	boolean	[非推奨] 代わりに —delta-only を使用してください。bundle全体をスキップし、差分アップデートのみをアップロードします
—delta	boolean	差分アップデート（変更されたファイルのみ）をアップロードし、大きなzipをダウンロードする代わりに、即時で超高速なアップデートを実現します
—delta-only	boolean	bundle全体を含めず差分アップデートのみをアップロードし、最大速度を実現します（大規模アプリに有効）
—no-delta	boolean	インスタントアップデートが有効な場合でも、差分アップデートを無効にします
—encrypted-checksum	string	暗号化されたチェックサム（署名）。外部bundleをアップロードする場合にのみ使用します。
—auto-set-bundle	boolean	capacitor.config.json の bundle を設定します
—dry-upload	boolean	bundle アップロード処理のドライラン: ファイルのアップロードや channel の更新を行わず、データベースに行を追加します（Capgo の内部テスト用）
—package-json	string	モノレポ用の package.json ファイルへのパス（カンマ区切り）
—node-modules	string	モノレポ用の node_modules ディレクトリへのパス（カンマ区切り）
—encrypt-partial	boolean	delta update ファイルを暗号化します（updater > 6.14.4 では自動有効化）
—delete-linked-bundle-on-upload	boolean	アップロード先の channel に現在リンクされている bundle を特定し、削除します
—no-brotli-patterns	string	Brotli 圧縮から除外するファイル（カンマ区切りのグロブ、例: “.jpg,.png”）
—disable-brotli	boolean	updater バージョンがサポートしていても、Brotli 圧縮を完全に無効にします
—version-exists-ok	boolean	バンドルバージョンが既に存在する場合に正常終了します。モノレポの CI/CD ワークフローに有用です
—self-assign	boolean	デバイスがこのチャネルに自動参加できるようにします（チャネル設定を更新）
—qr-preview	boolean	アップロード後、このバンドルのプレビュー用のターミナル QR code を出力します
—send-update-notification	boolean	リンクされたチャネルのバンドルを更新した後、デバイスにネイティブの更新チェック通知を送信します
—supa-host	string	カスタム Supabase ホスト URL (セルフホストまたは Capgo 開発用)
—supa-anon	string	カスタム Supabase anon キー (セルフホスト用)
—verbose	boolean	詳細ログ付きのverbose出力を有効にします

🧪 互換性

npx @capgo/cli@latest bundle compatibility

🧪 特定の channel に対する bundle の互換性を Capgo Cloud で確認し、アップデートの安全性を確保します。

例:

npx @capgo/cli@latest bundle compatibility com.example.app --channel production

オプション:

パラメータ	種類	説明
-a	string	アカウントに紐付ける API キー
-c	string	互換性を確認する channel
—text	boolean	絵文字の代わりにテキストを出力する
—package-json	string	モノレポ用の package.json ファイルへのパス（カンマ区切り）
—node-modules	string	モノレポ用の node_modules ディレクトリへのパス（カンマ区切り）
—supa-host	string	カスタム Supabase ホスト URL (セルフホストまたは Capgo 開発用)
—supa-anon	string	カスタム Supabase anon キー (セルフホスト用)

🔹 ReleaseType

npx @capgo/cli@latest bundle releaseType

🧭 チャンネルの最新メタデータとの互換性に基づいて「native」または「OTA」を表示します。

例:

npx @capgo/cli@latest bundle releaseType com.example.app --channel production

オプション:

パラメータ	種類	説明
-a	string	アカウントに紐付ける API キー
-c	string	比較対象となるChannel
—package-json	string	モノレポ用の package.json ファイルへのパス（カンマ区切り）
—node-modules	string	モノレポ用の node_modules ディレクトリへのパス（カンマ区切り）
—supa-host	string	カスタム Supabase ホスト URL (セルフホストまたは Capgo 開発用)
—supa-anon	string	カスタム Supabase anon キー (セルフホスト用)

🗑️ 削除

エイリアス: d

npx @capgo/cli@latest bundle delete

🗑️ Capgo Cloud から特定の bundle を削除します。オプションで単一バージョンを対象にできます。

例:

npx @capgo/cli@latest bundle delete BUNDLE_ID com.example.app

オプション:

パラメータ	種類	説明
-a	string	アカウントに紐付ける API キー
—supa-host	string	カスタム Supabase ホスト URL (セルフホストまたは Capgo 開発用)
—supa-anon	string	カスタム Supabase anon キー (セルフホスト用)

📋 一覧

エイリアス: l

npx @capgo/cli@latest bundle list

📋 Capgo Cloud にアップロードされたアプリの全 bundle を一覧表示します。

例:

npx @capgo/cli@latest bundle list com.example.app

オプション:

パラメータ	種類	説明
-a	string	アカウントに紐付ける API キー
—supa-host	string	カスタム Supabase ホスト URL (セルフホストまたは Capgo 開発用)
—supa-anon	string	カスタム Supabase anon キー (セルフホスト用)

🧹 クリーンアップ

エイリアス: c

npx @capgo/cli@latest bundle cleanup

🧹 Capgo Cloud 内の古い bundle を削除し、指定した数の最新バージョンを保持します。 channel にリンクされた bundle は、--ignore-channel を使用しない限り保持されます。

例:

npx @capgo/cli@latest bundle cleanup com.example.app --bundle=1.0 --keep=3

オプション:

パラメータ	種類	説明
-b	string	削除するアプリのBundleバージョン番号
-a	string	アカウントに紐付ける API キー
-k	string	保持するバージョン数
-f	boolean	強制削除
—ignore-channel	boolean	ChannelにリンクされていてもBundleを削除（警告: Channelも削除されます）
—supa-host	string	カスタム Supabase ホスト URL (セルフホストまたは Capgo 開発用)
—supa-anon	string	カスタム Supabase anon キー (セルフホスト用)

🔒 暗号化

npx @capgo/cli@latest bundle encrypt

安全な外部ストレージ用に zip バンドルを暗号化します。 アップロード/復号化用の ivSessionKey を返します。チェックサムは ‘bundle zip —json’ を使用して取得します。

例:

npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM

オプション:

パラメータ	種類	説明
—key	string	秘密鍵の署名用カスタムパス
—key-data	string	秘密鍵
-j	boolean	JSONで出力
—package-json	string	モノレポ用の package.json ファイルへのパス（カンマ区切り）

🔓 復号

npx @capgo/cli@latest bundle decrypt

暗号化された bundle を復号化します（主にテスト用）。 検証用に base64 のセッションキーを出力します。

例:

npx @capgo/cli@latest bundle decrypt ./myapp_encrypted.zip CHECKSUM

オプション:

パラメータ	種類	説明
—key	string	秘密鍵の署名用カスタムパス
—key-data	string	秘密鍵
—checksum	string	バンドルの整合性を検証するためのチェックサム
—package-json	string	モノレポ用の package.json ファイルへのパス（カンマ区切り）

🔹 Zip

npx @capgo/cli@latest bundle zip

🗜️ アプリバンドルのzipファイルを作成します。 暗号化に使用するチェックサムを返します。機械可読な出力には —json を使用してください。

例:

npx @capgo/cli@latest bundle zip com.example.app --path ./dist

オプション:

パラメータ	種類	説明
-p	string	アップロードするフォルダのパス。指定しない場合は、capacitor.config で設定された webDir が使用されます
-b	string	zipファイル名に使用するBundleのバージョン番号
-n	string	zipファイル名
-j	boolean	JSONで出力
—no-code-check	boolean	ソースの code 内で notifyAppReady() が呼ばれているか、ルートフォルダに index が存在するかのチェックを無視します
—key-v2	boolean	暗号化 v2 を使用
—package-json	string	モノレポ用の package.json ファイルへのパス（カンマ区切り）