📦 バンドル

📦 Capgo Cloudで配布に使用するアプリケーションバンドルの管理を行います。アップロード、互換性チェック、暗号化を含みます。

⬆️ アップロード

Alias: u

npx @capgo/cli@latest bundle upload

⬆️ Capgo Cloudに新しいアプリケーションバンドルをアップロードして配布します。バージョンは 0.0.0 より大きく、ユニークでなければなりません。削除されたバージョンはセキュリティ上再利用できません。外部オプション: URL リンクのみを保存する (200MB より大きいアプリまたはプライバシー要件の場合に便利)。Capgo は外部コンテンツを検査しません。暗号化を追加して信頼なしのセキュリティを実現します。

例:

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

チャンネル (またはリモートアプリの最新バージョン) から、__CAPGO_KEEP_0__ を指定しない場合に、次のフリーセーベルのバージョンを自動的に上げます。 --bundleCI の場合、有用です。 package.json Capgo のバージョンがすでに __CAPGO_KEEP_1__ に一致している場合:

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

__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ のワーカー AI は、ローカル バンドル ファイルを前の __CAPGO_KEEP_2__/チャンネル デルタ マニフェストと比較し、推測し --auto-bump ai, Capgo Cloudflare Workers AI compares local bundle files to the previous Capgo/channel delta manifest, infers major | minor | patch | metadata, and prints a short reason in the CLI log. If no previous Capgo version exists, AI is skipped and the bump defaults to オプション:.

__CAPGO_KEEP_0__

パラメータ	タイプ	説明
-a	string	APIアカウントへのリンク用キー
-p	string	capacitor.configのwebDirを使用する場合、フォルダへのアップロードパス
-c	string	リンクするチャンネル。例えば、production,beta
—ロールアウト	string	0から100のパーセンテージでロールアウトターゲットを設定
-b	string	0 から 10000 までのアップロード済みバンドルロールアウトパーセントを設定します (基点)
—rollout-cache-ttl-seconds	string	Cloudflare ロールアウト決定キャッシュの有効期間 (秒)
-e	string	Capgo へのアップロードではなく、外部 URL にリンクします (Cloud)
—iv-session-key	string	バンドル URL の外部で IV とセッション キーを設定します
—s3-region	string	S3 バケットの地域
—s3-apikey	string	API エンドポイントの S3 キー
—s3-apisecret	string	API S3 エンドポイントのシークレット
—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	標準出力にバンドル URL を出力します
—no-key	boolean	署名キーを無視して明示的な更新を送信します
—no-code-check	boolean	ソース code とインデックスがルートフォルダに存在する場合に、notifyAppReady() が呼び出されたかどうかのチェックを無視します
—display-iv-session	boolean	コンソールに使用される IV とセッション キーを表示します
-b	string	アップロードするバンドルのバージョン番号
—auto-bump	string	チャンネルの紐付けされたバンドルから自動的にインクリメントする。そうでない場合は、最新のリモートアプリのバージョンを使用する。レベル: メジャー、ミニマム（デフォルト）、パッチ（修正）、メタデータ、またはAI（ワーカーAIはローカルvs前のデルタマニフェストからレベルを推測し、前のCapgoバージョンがない場合はパッチにフォールバックする）。フリー名が見つかるまでバージョンを上げる（削除された名前は占有される）。—bundle (-b) と組み合わせることはできない。
—link	string	外部リソースへのリンク (例: GitHub リリース)
このバージョンについてのコメント、リリースノート、コミットハッシュ、コミットメッセージなど	string	このバージョンにアップグレードするために必要な最小バージョン。チャンネルの自動アップデートを無効にし、メタデータに設定した場合にのみ使用
ネイティブパッケージに基づいて最小アップデートバージョンを設定	string	アップロード時にメタデータ (node_modules) チェックを無視
互換性のない場合に失敗する	boolean	—auto-min-update-version
—ignore-metadata-check	boolean	—fail-on-incompatible
—auto-min-update-version	boolean	アップロードを失敗させる (非ゼロの終了コード) ではなく、チャンネルの現在のネイティブパッケージと不一致の場合、バンドルをアップロードしない。インタラクティブなターミナルでは、ネイティブビルドを選択できますが、拒否すると失敗します。 —ignore-metadata-check と組み合わせることはできません。
—ignore-checksum-check	boolean	アップロード時にチェックサムチェックを無視します。
—force-crc32-checksum	boolean	アップロード時にCRC32チェックサムを強制します (オート検出をオーバーライド)
—timeout	string	アップロードプロセスのタイムアウト時間 (秒)
—multipart	boolean	[非推奨] —tus を使用してください。 S3 アップロード用にマルチパートプロトコルを使用します。
—zip	boolean	バンドルを Capgo クラウドに ZIP でアップロードします (レガシーモード)
—tus	boolean	Upload the bundle using TUS to Capgo cloud
—tus-chunk-size	string	TUS再開可能アップロードのバイト単位のchunkサイズ（デフォルト：自動）
—partial	boolean	[非推奨] —deltaを使用してください。インクリメンタルアップデートをアップロード
—partial-only	boolean	[非推奨] —delta-onlyを使用してください。フルバンドルをスキップしてインクリメンタルアップデートのみをアップロード
—delta	boolean	インスタント、超高速のアップデートのために大きなzipダウンロードを避けるために、変更されたファイルのみのdeltaアップデートをアップロード
—delta-only	boolean	最大速度で最大化するために、大きなアプリ用にフルバンドルを含まないdeltaアップデートのみをアップロード
—no-delta	boolean	Delta更新を無効にする (インスタント更新が有効になっている場合でも)
—encrypted-checksum	string	暗号化されたチェックサム (署名)。外部のバンドルをアップロードする場合にのみ使用。
—auto-set-bundle	boolean	バンドルを capacitor.config.json に設定する
—dry-upload	boolean	バンドルアップロードプロセスのドライラン: データベースにレコードを追加するだけ (ファイルやチャンネルを更新しない) ( Capgo 内部テスト用)
—package-json	string	モノレポ用の package.json ファイルのパス (カンマ区切り)
—node-modules	string	モノレポ用の node_modules ディレクトリのパス (カンマ区切り)
—encrypt-partial	boolean	暗号化 delta 更新ファイル (アップデーター > 6.14.4 から自動有効)
—アップロード時にリンクされたバンドルを削除	boolean	アップロードしようとしているチャンネルで現在リンクされているバンドルを検索し、削除
—Brotli 圧縮から除外するファイル (カンマ区切りで、例えば “)	string	.jpg,.png”)—Brotli 圧縮を完全に無効にする (アップデーター版がサポートしている場合でも)
—バンドルバージョンがすでに存在する場合に成功する (モノレポの CI/CD ワークフローに便利)	boolean	—自分自身に割り当てる
__CAPGO_KEEP_0__	boolean	__CAPGO_KEEP_0__
__CAPGO_KEEP_0__	boolean	デバイスが自動でこのチャンネルに参加できるようにする (アップデートのチャンネル設定)
—qr-preview	boolean	このバンドルのプレビューをアップロードした後、ターミナル QR code を出力する
—send-update-notification	boolean	アップデートしたリンクされたチャンネル バンドルの後、デバイスにネイティブのアップデート チェック通知を送信する
—supa-host	string	カスタム Supabase ホスト URL (自社ホスティングまたは Capgo 開発用)
—supa-anon	string	カスタム Supabase anon キー (自社ホスティング用)
—verbose	boolean	詳細なログとともに詳細な出力を有効にする

🧪 互換性

npx @capgo/cli@latest bundle compatibility

Capgo Cloud で、特定のチャンネルとバンドルの互換性を確認し、更新が安全であることを確認します。

Example:

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

Options:

オプション:	パラメーター	タイプ
説明	string	APIキーを使用してアカウントにリンクする
-c	string	チャンネルを確認してください
—text	boolean	テキストを出力する代わりに絵文字を使用
—package-json	string	モノレポ用のパッケージ.jsonファイルのパス(カンマ区切り)
—node-modules	string	モノレポ用のnode_modulesディレクトリのパス(カンマ区切り)
—supa-host	string	カスタムのSupabaseホストURL(自宅ホスティングまたはCapgo開発用)
—supa-anon	string	自作サーバーでホストするためのカスタム Supabase anon キー

🔹 リリースタイプ

npx @capgo/cli@latest bundle releaseType

🧭 最新のチャンネルのメタデータと互換性があるかどうかを判断して「ネイティブ」または「OTA」を出力します。

例:

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

オプション:

パラメーター	タイプ	説明
-a	string	APIキーを使用してアカウントにリンク
-c	string	比較するチャンネル
—package-json	string	モノレポ用のパッケージ.jsonファイルのパス(カンマ区切り)
—node-modules	string	モノレポ用のnode_modulesディレクトリのパス(カンマ区切り)
—supa-host	string	カスタムSupabaseホストURL(自宅ホスティングまたはCapgo開発用)
—supa-anon	string	自作の Supabase 匿名キー (自作ホスティング用)

🗑️ 削除

エイリアス: d

npx @capgo/cli@latest bundle delete

🗑️ Capgo Cloud から特定のバンドルを削除する (バージョンを特定する場合もあります)。

例:

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 にアップロードされたアプリのすべてのバンドルをリストします。

例:

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 で指定された最近のバージョンの数を除くまで、古いバンドルを削除します。 チャンネルにリンクされているバンドルは、—ignore-channel を使用しない限り保存されます。

例:

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

オプション:

パラメーター	タイプ	説明
-b	string	アプリのバンドルバージョン番号を削除する
-a	string	API
-k	string	削除するバージョンの数
-f	boolean	強制削除
—無視チャネル	boolean	チャネルにリンクされているバンドルを削除する場合もバンドルを削除します (注意: チャネルも削除されます)
—スパバホスト	string	自宅ホスティングまたはCapgo開発用のカスタムスパバースホストURL
—スパバアノン	string	自宅ホスティング用のカスタムスパバースアノンキー

🔒 暗号化

npx @capgo/cli@latest bundle encrypt

安全な外部ストレージに保存するためにzipバンドルを暗号化します。 アップロード/復号化に使用するivSessionKeyを取得します。チェックサムを取得するには「バンドル zip —json」を実行してください。

例:

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

オプション:

パラメーター	タイプ	説明
—key	string	プライベート署名鍵のカスタムパス
—key-data	string	プライベート署名鍵
-j	boolean	JSON形式で出力
—パッケージ・json	string	モノレポ用のパッケージ・jsonファイルのパス(カンマ区切り)

🔓 復号

npx @capgo/cli@latest bundle decrypt

暗号化されたバンドルを復号する(主にテスト用)。 検証用に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ファイルの名前として指定します。
-n	string	zipファイルの名前
-j	boolean	JSON形式で出力します。
—no-code-check	boolean	ソースcodeとインデックスがrootフォルダに存在する場合、notifyAppReady()が呼び出されたかどうかをチェックするのを無視します。
—key-v2	boolean	暗号化v2を使用します。
—package-json	string	モノレポ用のpackage.jsonファイルのパス(カンマ区切り)