📦

📦 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

オプション:

パラメーター	タイプ	説明
-a	string	API へのアカウントへのリンク用キー
-p	string	capacitor.config の webDir の指定がない場合はアップロードするフォルダーのパス
-c	string	リンクするチャンネル。複数のチャンネルを使用する場合は、例えば production,beta のようにカンマで区切ってください。
—ロールアウト	string	アップロードしたバンドルをこのチャンネルのロールアウトターゲットとして、0 から 100 のパーセンテージで設定
—ロールアウトパーセンテージBPS	string	0から10000までの基準点からロールアウトしたバンドルアップロードパーセンテージを設定します。
—ロールアウトキャッシュTTL秒	string	Cloudflare ロールアウト決定キャッシュTTL秒
-e	string	Capgo Cloudにアップロードするのではなく、外部URLにリンクします。
—IVセッションキー	string	バンドルURLの外部IVとセッションキーを設定します。
—S3リージョン	string	あなたのS3バケットのリージョンを設定します。
—S3APIキー	string	あなたのS3エンドポイントのAPI キーを設定します。
—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	プライベート署名キー（バージョン2システム)
—bundle-url	boolean	バンドルURLを標準出力に表示
—no-key	boolean	署名キーを無視し、明示的な更新を送信
—no-code-check	boolean	codeのソースとインデックスがルートフォルダに存在するかどうかのチェックを無視
—display-iv-session	boolean	アップデートを暗号化するために使用されるIVとセッションキーをコンソールに表示
-b	string	アップロードするバンドルのバージョン番号
—リンク	string	GitHubへの外部リソースへのリンク
—コメント	string	このバージョンに関するコメント、リリースノート、コミットハッシュ、コミットメッセージなど
—最小更新バージョン	string	このバージョンにアップデートするために必要な最小バージョン。自動アップデートを無効にし、チャンネルのメタデータを使用する場合にのみ使用
—自動最小更新バージョン	boolean	ネイティブパッケージに基づいて最小アップデートバージョンを設定
—メタデータチェックを無視	boolean	アップロード時にメタデータ（node_modules）チェックを無視
—互換性のない場合に失敗	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	Capgo クラウドにバンドルを TUS でアップロードします
—tus-バイト数	string	TUS再開可能アップロードのバイト数 (デフォルト: 自動)
—部分	boolean	[廃止] —deltaを使用してください。インクリメンタルアップデートをアップロード
—部分のみ	boolean	[廃止] —deltaのみを使用してください。インクリメンタルアップデートのみをアップロードし、フルバンドルをスキップ
—delta	boolean	インスタントアップデートの代わりに大きなzipダウンロードの代わりに、インクリメンタルアップデートのみをアップロードします。
—deltaのみ	boolean	最大速度でアップロードするために、フルバンドルを含まないインクリメンタルアップデートのみをアップロードします (大規模アプリ用)
—delta無効	boolean	インスタントアップデートが有効でも、deltaアップデートを無効にします
—暗号化チェックサム	string	外部バンドルをアップロードする場合にのみ使用される暗号化チェックサム（署名）。
—自動セットバンドル	boolean	「capacitor.config.json」にバンドルを設定します。
—ドライアップロード	boolean	Dry upload the bundle process: add the row in database without uploading files or updating channels (Used by Capgo for internal testing)
—パッケージjson	string	モノレポ用のパッケージjsonファイルのパス (カンマ区切り)
—ノードモジュール	string	モノレポ用のノードモジュールディレクトリのパス (カンマ区切り)
—部分暗号化	boolean	Deltaアップデートファイルの暗号化 (アップデータバージョン 6.14.4 より自動有効)
__CAPGO_KEEP_0__	boolean	アップロード中のチャンネルにリンクされている現在のバンドルを探し、削除します。
__CAPGO_KEEP_0__	string	Brotli 圧縮から除外するファイルを指定します (カンマで区切ったパターン、例: “.jpg, .png”)。__CAPGO_KEEP_0__アップデータのバージョンが Brotli 圧縮をサポートしている場合でも、Brotli 圧縮を完全に無効にします。
__CAPGO_KEEP_0__	boolean	バンドルバージョンがすでに存在する場合に成功して終了します。モノレポのCI/CDワークフローに便利です。
__CAPGO_KEEP_0__	boolean	このチャンネルにデバイスが自動的に参加できるようにします (チャンネル設定を更新)。
Capgo	boolean	Capacitor
—QRプレビュー	boolean	このバンドルプレビューのアップロード後、ターミナルQR code を表示します。
—アップデート通知の送信	boolean	アップデートしたリンクされたチャンネルバンドルの後、デバイスにネイティブのアップデートチェック通知を送信します。
—スパーバースホスト	string	自宅ホスティングまたは Capgo 開発用のカスタムスパーバースホストURL
—スパーバースアノン	string	自宅ホスティング用のカスタムスパーバースアノンキー
—詳細	boolean	詳細なログとともに詳細な出力を有効にします。

🧪 互換性

npx @capgo/cli@latest bundle compatibility

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

例:

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	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	カスタムSupabase anonキー(自社ホスティング用)

🔹 リリースタイプ

npx @capgo/cli@latest bundle releaseType

🧭 最新のチャンネルメタデータと互換性がある場合に「native」または「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	自宅ホスティングまたはCapgo開発用のカスタムスパバースホストURL
—supa-anon	string	自宅ホスティング用のカスタムスパバースアノンキー

🗑️ 削除

Alias: 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	自宅ホスティングまたはCapgo開発用のカスタム Supabase ホスト URL
—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	自作ホスト用のカスタムスパバースアノニマスキー

🧹 クリーンアップ

Alias: c

npx @capgo/cli@latest bundle cleanup

🧹 Delete old bundles in Capgo Cloud, keeping specified number of recent versions. Bundles linked to channels are preserved unless —ignore-channel is used.

__CAPGO_KEEP_0__クラウドの古いバンドルを🧹削除する（指定された最近のバージョンを保存）。チャンネルにリンクされているバンドルは、—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	Delete bundles even if linked to channels (WARNING: deletes channels too)
—supa-host	string	自社ホスト用のカスタムサプアベースURL（Capgo開発用）
—supa-anon	string	自社ホスト用のカスタムサプアベースアノンキー

🔒 Encrypt

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	Paths to package.json files for monorepos (comma-separated)

🔓 Decrypt

npx @capgo/cli@latest bundle decrypt

🔓 Decrypt an encrypted bundle (mainly for testing). Prints base64 session key for verification.

Example:

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

Options:

Param	Type	説明
—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ファイルのパス(カンマ区切り)