📦 バンドル

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

⬆️ アップロード

エイリアス: 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

オプション:

パラメータ	タイプ	説明
-a,	string	APIで指定したアカウントにリンクするためのキー
-p,	string	アップロードするフォルダのパスを指定します。指定しない場合は、capacitor.configのwebDirを使用します。
-c,	string	リンクするチャンネル
-e,	string	外部URLにリンクするのではなく、Capgoにアップロードする
—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 バケットの名前
__CAPGO_KEEP_0__	string	S3 エンドポイントのポート
__CAPGO_KEEP_0__	boolean	S3 アップロードで SSL を無効にする
__CAPGO_KEEP_0__	string	プライベート署名キー (バージョン 2 システム) のカスタムパス
__CAPGO_KEEP_0__	string	プライベート署名キー (バージョン 2 システム)
__CAPGO_KEEP_0__	boolean	バンドル URL を標準出力に表示する
__CAPGO_KEEP_0__	boolean	署名キーを無視して明示的な更新を送信
—no-code-check	boolean	codeのソースとインデックスがルートフォルダに存在するかどうかを確認しない
—display-iv-session	boolean	更新を暗号化するために使用されるIVとセッションキーをコンソールに表示
-b,	string	アップロードするバンドルのバージョン番号
—link	string	外部リソースへのリンク (例: GitHub リリース)
—comment	string	このバージョンに関するコメント、リリースノート、コミットハッシュ、コミットメッセージなど
—min-update-version	string	このバージョンにアップデートするために必要な最小バージョン。自動アップデートを無効に設定した場合にのみ使用します。
__CAPGO_KEEP_0__	boolean	ネイティブパッケージに基づいて最小アップデートバージョンを設定します。
__CAPGO_KEEP_0__	boolean	アップロード時にメタデータ (node_modules) チェックを無視します。
__CAPGO_KEEP_0__	boolean	アップロード時にチェックサムチェックを無視します。
__CAPGO_KEEP_0__	boolean	アップロード時にCRC32チェックサムを強制します (自動検出を上書き)。
__CAPGO_KEEP_0__	string	アップロードプロセスのタイムアウト (秒) を設定します。
__CAPGO_KEEP_0__	boolean	[DEPRECATED] —tus を使用してください。S3 へのアップロードに使用されるマルチパートプロトコル
—zip	boolean	Capgo クラウド (レガシー) へのバンドルアップロードに zip を使用します
—tus	boolean	Capgo クラウドへのバンドルアップロードに TUS を使用します
—tus-chunk-size	string	TUS リスナブルアップロードのチョンクサイズ (バイト単位) (デフォルト: 自動)
—partial	boolean	[DEPRECATED] —delta を使用してください。インクリメンタルアップデートをアップロードします
—partial-only	boolean	[DEPRECATED] —delta-only を使用してください。インクリメンタルアップデートのみをアップロードし、フルバンドルをスキップします
—delta	boolean	即時、高速のアップデートのために、変更されたファイルのみのデルタアップデートをアップロードします。
—delta-only	boolean	最大のスピードを得るために、大きなアプリの場合に便利な、フルバンドルの代わりにデルタアップデートのみをアップロードします。
—no-delta	boolean	Direct Update が有効でも、デルタアップデートを無効にします。
—encrypted-checksum	string	アップロードする外部バンドルの場合にのみ使用される、暗号化されたチェックサム (署名)。
—auto-set-bundle	boolean	「capacitor.config.json」にバンドルを設定します。
—dry-upload	boolean	アップロードプロセスのドライモードで、ファイルをアップロードせずにデータベースに追加する行を追加します (内部テスト用に Capgo で使用)。
—package-json	string	モノレポ用のパッケージ.jsonファイルのパス (カンマ区切り)
—node-modules	string	モノレポ用のnode_modulesディレクトリのパス (カンマ区切り)
—encrypt-partial	boolean	deltaアップデートファイルを暗号化 (アップデートバージョン 6.14.4 より自動有効)
—delete-linked-bundle-on-upload	boolean	アップロードしようとしているチャンネルで現在リンクされているバンドルを検出し、削除
—no-brotli-patterns	string	Brotli圧縮から除外するファイル (カンマ区切りグロブ、例: “*.js、*.jpg、*.png”)—disable-brotliBrotli圧縮を無効
—disable-brotli	boolean	完全にブロリ圧縮を無効にする (アップデートのバージョンがサポートしている場合でも)
—version-exists-ok	boolean	バンドルバージョンがすでに存在する場合に成功して終了する (モノレポのCI/CDワークフロー向け)
—self-assign	boolean	デバイスがこのチャンネルに自動で参加できるようにする (アップデートのチャンネル設定)
—supa-host	string	カスタムのSupabaseホストURL (自宅ホスティングまたはCapgoの開発用)
—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	チェックするチャンネル
—text	boolean	エモジーではなくテキストを出力
—package-json	string	モノレポ用のパッケージ.jsonファイルのパス(カンマ区切り)
—node-modules	string	モノレポ用のnode_modulesディレクトリのパス(カンマ区切り)
—supa-host	string	カスタムSupabaseホストURL(自宅ホスティングまたはCapgo開発用)
—supa-anon	string	カスタム Supabase 匿名キー (自社ホスティング用)

🔹 リリースタイプ

npx @capgo/cli@latest bundle releaseType

🧭 最新のメタデータと互換性があるチャンネルの「native」または「OTA」を印刷します。

例:

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

オプション:

パラメーター	タイプ	概要
-a,	string	API を使用してアカウントにリンクするためのキー
-c,	string	比較対象のチャンネル
–パッケージ-JSON	string	モノレポ用のパッケージ.json ファイルのパス (カンマ区切り)
–ノード-モジュール	string	モノレポ用の node_modules ディレクトリのパス (カンマ区切り)
–スパ-ホスト	string	カスタム Supabase ホスト URL (自宅ホスティングまたは Capgo 開発用)
–スパ-アノン	string	自作ホスティング用のカスタム Supabase anon キー

🗑️ 削除

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開発用のカスタムスパバースホストURL
—supa-anon	string	自宅ホスティング用のカスタムスパバースアノンキー

📋 リスト

エイリアス: l

npx @capgo/cli@latest bundle list

📋 List all bundles uploaded for an app in 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キー (自作の場合)

🧹 Cleanup

Alias: 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

オプション:

__CAPGO_KEEP_0__	タイプ	説明
-b,	string	アプリのバンドルバージョン番号を削除する
-a,	string	API キーをアカウントにリンクする
-k,	string	削除するバージョンの数
-f,	string	強制削除
—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

オプション:

パラメーター	タイプ	説明
—key	string	プライベート署名鍵のカスタムパス
—key-data	string	プライベート署名鍵
-j、	string	JSON形式で出力
—package-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	string	JSON形式で出力します。
—no-code-check	boolean	ソースcodeとインデックスがrootフォルダに存在する場合にnotifyAppReady()が呼ばれるかどうかのチェックを無視します。
—key-v2	boolean	暗号化v2を使用します。
—package-json	string	モノレポのpackage.jsonファイルのパスを指定します(カンマ区切り)

Keep going from bundle

If you are using bundle to plan security and compliance, connect it with Encryption for the implementation detail in Encryption, Compliance for the implementation detail in Compliance, Capgo Security Scanner for the product workflow in Capgo Security Scanner, Capgo Security 製品ワークフローにおけるCapgo セキュリティのため、 Capgo トラストセンター 製品ワークフローにおけるCapgo トラストセンターのため、