📦 バンドル

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

⬆️ アップロード

エイリアス: u

npx @capgo/cli@latest bundle upload

⬆️ Capgo クラウドに新しいアプリケーションバンドルをアップロードして配布します。 バージョンは 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__ Workers AI は、ローカル バンドル ファイルを前の __CAPGO_KEEP_2__/チャンネル デルタ マニフェストと比較し、推測し、__CAPGO_KEEP_0__ ログに短い理由を表示します。 --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__.

__CAPGO_KEEP_1__

パラメータ	タイプ	説明
-a	string	API のアカウントにリンクするためのキー
-p	string	capacitor.config の webDir を使用する場合、または指定しない場合、アップロードするフォルダーのパス
-c	string	リンクするチャンネルを指定します。複数のチャンネルを指定する場合は、カンマで区切ってください。例えば、production,beta
—rollout	string	0 から 100 のパーセンテージで指定したパーセンテージのチャンネルのロールアウトターゲットとしてアップロードしたバンドルを設定
—rollout-percentage-bps	string	0から10000までの基点でアップロードしたバンドルの展開率を設定します。
—rollout-cache-ttl-seconds	string	Cloudflareロールアウト決定キャッシュのTTL(秒)
-e	string	Capgoにアップロードするのではなく、URLにリンクする
—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	チャンネルの紐づけられたバンドルから自動インクリメント、なければ最新のリモートアプリバージョン。レベル: メジャー、メイン (デフォルト)、パッチ (alias fix)、メタデータ、または 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
—link	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再開可能アップロードのバイト単位のチョンクサイズ (デフォルト: 自動)
—partial	boolean	[非推奨] —deltaを使用してください。インクリメンタルアップデートをアップロード
—partial-only	boolean	[非推奨] —delta-onlyを使用してください。フルバンドルをスキップしてインクリメンタルアップデートのみをアップロード
—delta	boolean	インスタント、超高速のアップデートに最適なdeltaアップデートをアップロード (変更されたファイルのみ)
—delta-only	boolean	最大速度でアップロードするために、フルバンドルを含まないdeltaアップデートのみをアップロード (大規模アプリ用)
—no-delta	boolean	アップデートを無効にする
—encrypted-checksum	string	暗号化されたチェックサム（署名）。外部バンドルをアップロードする場合にのみ使用。
—auto-set-bundle	boolean	capacitor.config.jsonにバンドルを設定する
—dry-upload	boolean	バンドルアップロードプロセスをdryモードで実行: データベースに追加する行を追加するだけ (内部テスト用にCapgoで使用)
—package-json	string	モノレポ用のpackage.jsonファイルのパス (カンマ区切り)
—node-modules	string	モノレポ用のnode_modulesディレクトリのパス (カンマ区切り)
—encrypt-partial	boolean	ファイルを暗号化 (アップデーター 6.14.4 より上のバージョンでは自動で有効)
—アップロード時にリンクされたバンドルを削除	boolean	アップロードしようとしているチャンネルで現在リンクされているバンドルを検索し、削除
—ブロトリ圧縮対象外のファイル (カンマ区切り、例： “	string	.jpg,.png”)—ブロトリ圧縮を完全に無効
アップデーター バージョンがブロトリ圧縮をサポートしている場合でも、ブロトリ圧縮を完全に無効	boolean	—バージョンがすでに存在する場合に成功
バンドルのバージョンがすでに存在する場合に成功するため、モノレポのCI/CDワークフローに便利	boolean	—自分自身に割り当てる
—アップロード時にリンクされたバンドルを削除	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	チャンネルを確認してください
—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 Cloud でリストします。

例:

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

オプション:

パラメーター	タイプ	説明
-a	string	API のキーを使用してアカウントにリンク
--supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—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	Custom Supabase host URL (for self-hosting or Capgo development)
---スパバースアノン	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形式で出力
—パッケージ・ジャソンのファイル	string	モノレポ用のパッケージ・ジャソンのファイルのパス（カンマで区切る)

🔓 復号

npx @capgo/cli@latest bundle decrypt

暗号化されたバンドルを復号する（主にテスト用）。

ベース64セッションキーを出力して検証する。

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とインデックスがルートフォルダに存在する場合、notifyAppReady()が呼ばれるかどうかをチェックすることを無視します。
—key-v2	boolean	暗号化v2を使用します。
—package-json	string	モノレポ用のpackage.jsonファイルのパス(カンマ区切り)