バンドル

Capgo Cloud へのアップロード、互換性のチェック、暗号化など、デプロイ用のアプリケーションバンドルの管理に役立ちます。

⬆️ Upload

Alias: u

npx @capgo/cli@latest bundle upload

⬆️ Upload a new app bundle to Capgo Cloud for distribution. Version must be > 0.0.0 and unique. Deleted versions cannot be reused for security. External option: Store only a URL link (useful for apps >200MB or privacy requirements). Capgo never inspects external content. Add encryption for trustless security.

Example:

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

Options:

Param	Type	説明
-a,	string	API のアカウントにリンクするためのキー
-p,	string	capacitor.config の webDir を使用する場合、フォルダーのアップロードパスを指定します。
-c,	string	リンクするチャンネルを指定します。
-e,	string	Capgo の Cloud ではなく、外部 URL にリンクします。
—iv-session-key	string	バンドル URL の外部の IV とセッション キーを設定します。
—s3-region	string	AWS 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	アップロードするバンドルのバージョン番号
—link	string	外部リソースへのリンク (例: GitHub リリース)
—comment	string	このバージョンに関するコメント、リリースノート、コミットハッシュ、コミットメッセージなど
—min-update-version	string	このバージョンにアップデートするために必要な最小バージョン。チャンネル内のメタデータで自動アップデートを無効に設定した場合にのみ使用
—auto-min-update-version	boolean	ネイティブパッケージに基づいて最小アップデートバージョンを設定
—ignore-metadata-check	boolean	node_modules のメタデータを無視する
__CAPGO_KEEP_0__	boolean	アップロード時にチェックサムの確認を無視する
CRC32 チェックサムの確認強制	boolean	アップロードに CRC32 チェックサムを強制する (自動検出をオーバーライド)
アップロードプロセスのタイムアウト (秒)	string	[非推奨] —tus を使用してください。 マルチパートプロトコルを使用して S3 アップロード
[非推奨] —tus を使用してください。 zip を使用して __CAPGO_KEEP_0__ クラウドにアップロードする (レガシーモード)	boolean	TUS プロトコルを使用してください
—ignore-checksum-check	boolean	Upload the bundle using zip to Capgo cloud (legacy)
—timeout	boolean	TUSを使用してバンドルをCapgoクラウドにアップロードしてください
—tus-chunk-size	string	TUS再開可能アップロードのために使用するchunkサイズ（デフォルト：自動）
—partial	boolean	[非推奨] —deltaを使用してください。インクリメンタルアップデートをアップロード
—partial-only	boolean	[非推奨] —delta-onlyを使用してください。インクリメンタルアップデートのみをアップロードして、フルバンドルをスキップ
—delta	boolean	インスタントで超高速のアップデートに適した、変更されたファイルのみのdeltaアップデートをアップロード
—delta-only	boolean	最大速度を実現するために、フルバンドルを含まないdeltaアップデートのみをアップロードしてください（大規模アプリ用）
—no-delta	boolean	Direct Update を有効にしている場合でも、デルタ更新を無効にする
—暗号化されたチェックサム	string	アップロードする外部バンドル用にのみ使用される暗号化されたチェックサム (署名)。
—__CAPGO_KEEP_0__.config.json にバンドルを設定する	boolean	—データベースにエントリを追加するだけのファイルアップロードプロセス (内部テスト用に capacitor によって使用)
パッケージ.json ファイルのパス (モノレポ用、カンマ区切り)	boolean	Dry upload the bundle process, mean it will not upload the files but add the row in database (Used by Capgo for internal testing)
—部分的な暗号化	string	—部分的な暗号化
—部分的な暗号化	string	—部分的な暗号化
—部分的な暗号化	boolean	アップデートファイルを暗号化 (アップデーター 6.14.4 より上のバージョンでは自動有効)
__CAPGO_KEEP_0__	boolean	アップロードしようとしているチャンネルで現在リンクされているバンドルを検出し、削除します
__CAPGO_KEEP_0__	string	Brotli 圧縮から除外するファイル (カンマ区切りで、例: “.jpg, .png”)__CAPGO_KEEP_0__Brotli 圧縮を完全に無効にする (アップデーター バージョンがサポートする場合でも)
__CAPGO_KEEP_0__	boolean	バンドルバージョンがすでに存在する場合に成功する (モノレポの CI/CD ワークフロー向け)
__CAPGO_KEEP_0__	boolean	__CAPGO_KEEP_0__
__CAPGO_KEEP_0__	boolean	デバイスが自動でこのチャンネルに参加できるようにする (更新チャンネル設定)
—supa-host	string	自宅サーバーでホストしている場合や開発用に Capgo を使用する場合のカスタム Supabase ホスト URL
—supa-anon	string	自宅サーバーでホストしている場合のカスタム Supabase anon キー
—verbose	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	絵文字の代わりにテキストを出力する
—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	カスタムスパバースホストURL(自主ホスティングまたはCapgo開発)
—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	Custom Supabase host URL (for self-hosting or Capgo development)
—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,	string	強制削除
—ignore-channel	boolean	チャンネルにリンクされているバンドルを削除する場合も削除します (注意: チャンネルも削除されます)
—supa-host	string	自宅ホスティングまたは Capgo 開発用のカスタム Supabase ホスト URL
—supa-anon	string	自社ホスティング用のカスタムスーパーバーゼアノンキー

🔒 暗号化

npx @capgo/cli@latest bundle encrypt

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

例:

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

オプション:

パラメータ:	タイプ	説明
—key	string	__CAPGO_KEEP_0__のプライベート署名鍵のカスタムパス
—key-data	string	__CAPGO_KEEP_0__のプライベート署名鍵
-j,	string	JSON形式で出力
—package-json	string	モノレポの場合のpackage.jsonファイルのパス(カンマ区切り)

🔓 復号

npx @capgo/cli@latest bundle decrypt

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

例:

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

オプション:

パラメーター	タイプ	説明
—key	string	プライベート署名キー用カスタムパス
—__CAPGO_KEEP_0__	string	プライベート署名鍵
—__CAPGO_KEEP_1__	string	アプリケーションバンドルの整合性を確認するために使用するバンドルのチェックサム
—__CAPGO_KEEP_2__	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	string	JSON形式で出力
—no-code-check	boolean	codeのソースとインデックスがrootフォルダに存在する場合にnotifyAppReady()が呼び出されたかどうかをチェックする
—key-v2	boolean	暗号化v2を使用
—package-json	string	モノレポ用のpackage.jsonファイルのパス(カンマ区切り)

バンドルから続ける

Capgoを使用している場合 バンドルから続ける セキュリティとコンプライアンスの計画に役立つように接続する 暗号化 暗号化の実装詳細について コンプライアンス コンプライアンスの実装詳細について Capgo セキュリティ スキャナー Capgo セキュリティ スキャナーの製品ワークフローについて Capgo セキュリティ Capgo セキュリティの製品ワークフローについて Capgo トラスト センター Capgo トラスト センターの製品ワークフローについて