📦 bundle

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

⬆️ Upload

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

自動バージョンアップを実行します。 --bundleCIの場合、有効です。 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 は、ローカル バンドル ファイルを前の Capgo/チャネル デルタ マニフェストと比較し、推測 major | minor | patch | metadataCLIコマンドが実行され、CLI ログに短い理由が表示されます。 Capgo の前のバージョンが存在しない場合、AIはスキップされ、バージョンアップはデフォルト値に戻ります。 patch.

Options:

Param	パッチ	概要
-a	string	API を使用してアカウントにリンクするキー
-p	string	capacitor.config の webDir に指定されていない場合、アップロードするフォルダーのパス
-c	string	リンクするチャンネルを指定します。複数のチャンネルを指定する場合は、カンマで区切ってください (例: production,beta)
—rollout	string	0 から 100 の範囲のパーセンテージでロールアウトのターゲットを設定します
—stable	boolean	ロールアウトが設定されたチャンネルで、安定版の代わりにロールアウトのターゲットを設定します
—rollout-percentage-bps	string	0 から 10000 までのアップロード バンドル ロールアウト パーセントを設定します (基点)
—ロールアウト キャッシュ TTL 秒	string	Cloudflare ロールアウト決定キャッシュ TTL 秒
-e	string	Capgo へのアップロードではなく、外部 URL にリンクします
—IV セッション キー	string	バンドル URL の外部の IV とセッション キーを設定します
—S3 リージョン	string	S3 バケットのリージョン
—S3 API キー	string	API の S3 エンドポイントの API キー
—S3 API シークレット	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 と root フォルダ内のインデックスが存在する場合に notifyAppReady() が呼び出されたかどうかを確認しない
—display-iv-session	boolean	コンソールに使用される IV とセッション キーを表示します
-b	string	アップロードするバンドルのバージョン番号
—auto-bump	string	チャンネルの紐づけられたバンドルから自動的にインクリメントする。そうでない場合は、リモートのアプリの最新バージョン。レベル: メジャー、ミニマム (デフォルト)、パッチ (alias fix)、メタデータ、または ai (ワーカー AI はローカル vs 前回の delta マニフェストからレベルを推測します; 前回の Capgo バージョンがない場合はパッチにフォールバックします)。フリー名が見つかるまでバージョンを上げ続ける (削除された名前は占有され続ける)。—bundle (-b) と組み合わせることはできない。
—link	string	外部リソースにリンクする (例: GitHub リリース)
—comment	string	このバージョンにアップデートするには必要な最小バージョン。チャンネルの自動アップデートを無効にし、メタデータに設定した場合にのみ使用
—min-update-version	string	アップロード時にメタデータ (node_modules) チェックを無視
互換性のない場合に失敗する	boolean	—fail-on-incompatible
—ignore-metadata-check	boolean	—auto-min-update-version
—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	TUSを使用してバンドルをアップロードする: Capgo クラウド
—tus-chunk-size	string	TUS再開可能アップロードのバイト単位のチョークサイズ (デフォルト: 自動)
—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	アップロードしようとしているチャンネルで現在リンクされているバンドルを検索し、削除
—ブロトリ圧縮対象外のファイル (カンマ区切り、例： “	string	.jpg,.png”)—ブロトリ圧縮を完全に無効
—disable-brotli	boolean	—バージョンがすでに存在する場合に成功
—version-exists-ok	boolean	—自身に割り当てる
—self-assign	boolean	デバイスが自動でこのチャンネルに参加できるようにする (更新チャンネル設定)
—qr-プレビュー	boolean	このバンドルプレビューをアップロードした後、ターミナルQR code を表示
—送信更新通知	boolean	デバイスにアップデートされたリンクされたチャンネルバンドルの更新チェック通知を送信
—スパーバースホスト	string	カスタムスパーバースホストURL (自社ホスティングまたは Capgo 開発用)
—スパーバースアノン	string	カスタムスパーバースアノンキー (自社ホスティング用)
—詳細	boolean	詳細なログとともに詳細な出力を有効にする

🧪 互換性

npx @capgo/cli@latest bundle compatibility

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

例:

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

オプション:

パラメーター	種類	説明
-a	string	APIキーを使用してアカウントにリンクする
-c	string	チャンネルを確認するための互換性
—テキスト	boolean	エモジーではなくテキストを出力する
—パッケージjson	string	モノレポ用のパッケージjsonファイルのパス(カンマ区切り)
—ノードモジュール	string	モノレポ用のノードモジュールディレクトリのパス(カンマ区切り)
—スパーバスホスト	string	カスタムスパーバスホストURL(自宅ホスティングまたはCapgo開発用)
—スパーバスアノニマス	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 Cloudにアップロードされたすべてのアプリのバンドルをリストします。

例:

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 から古いバンドルを __CAPGO_KEEP_1__ 個の最新バージョンを残して削除します。 チャンネルにリンクされたバンドルは、—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	強制削除
—ignore-channel	boolean	チャンネルに関連付けられているバンドルを削除する場合も、チャンネルも削除します (注意: チャンネルも削除されます)
—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

オプション:

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

🔓 復号

npx @capgo/cli@latest bundle decrypt

暗号化されたバンドルを復号する(主にテスト用)。 検証のためにbase64セッションキーを出力する。

例:

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

オプション:

パラメータ	種類	説明
—キー	string	プライベート署名鍵のカスタムパス
—キーデータ	string	プライベート署名鍵
—チェックサム	string	バンドルのチェックサム（バンドルの完全性を確認するために）
—パッケージjson	string	モノレポのパッケージjsonファイルのパス（カンマ区切り）

🔹 Zip

npx @capgo/cli@latest bundle zip

🗜️ アプリケーションバンドルのzipファイルを作成します。 チェックサムを取得して暗号化に使用します。 —json を使用すると、機械読み取り可能な出力が得られます。

例:

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

オプション:

パラメーター	種類	Description
説明	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ファイルのパス(カンマ区切り)