📦 バンドル

📦 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	Link to external URL instead of upload to Capgo Cloud
—iv-session-key	string	バンドルURLのIVとセッションキーを設定する
—s3-region	string	S3バケットの地域
—s3-apikey	string	S3エンドポイントのAPIキー
—s3-apisecret	string	S3エンドポイントのAPIシークレット
—s3-endpoint	string	S3エンドポイントのURL
—s3-バケット名	string	AWS S3 バケットの名前
—s3-ポート	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	アップロードするバンドルのバージョン番号
—link	string	外部リソースへのリンク（例：GitHubのリリース）
—comment	string	このバージョンに関するコメント、リリースノート、コミットハッシュ、コミットメッセージなど
---min-update-version	string	このバージョンにアップデートするために必要な最小バージョンです。自動アップデートを無効にした場合にのみ使用されます。
---auto-min-update-version	boolean	ネイティブパッケージに基づいて最小アップデートバージョンを設定します。
---ignore-metadata-check	boolean	アップロード時にメタデータ (node_modules) チェックを無視します。
---ignore-checksum-check	boolean	アップロード時にチェックサムチェックを無視します。
---force-crc32-checksum	boolean	アップロードにCRC32チェックサムを強制します (自動検出を上書き)
---timeout	string	秒単位のアップロードプロセスのタイムアウト時間
—分割	boolean	[廃止] —tus を使用してください。S3 へのアップロードに分割プロトコルを使用します
—zip	boolean	Capgo クラウド (レガシー) へのバンドルを ZIP でアップロードします
—tus	boolean	Capgo クラウドへのバンドルを TUS でアップロードします
—tus-チャンクサイズ	string	TUS 可再生アップロードのチャンクサイズ (バイト単位) (デフォルト: 自動)
—部分	boolean	[廃止] —delta を使用してください。インクリメンタルアップデートをアップロードします
—部分のみ	boolean	[廃止] —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	ファイルをアップロードせずに、データベースにレコードを追加するdryアップロードプロセス(内部テスト用にCapgoによって使用)
—パッケージ-JSON	string	モノレポ用のパッケージJSONファイルのパス(カンマ区切り)
—ノードモジュール	string	モノレポ用のノードモジュールディレクトリのパス(カンマ区切り)
—部分暗号化	boolean	デルタアップデートファイルを暗号化(アップデーター6.14.4以上で自動有効)
—アップロード先のチャンネルに現在リンクされているバンドルを探し、削除	boolean	—ブロトリパターン
ブロトリ圧縮から除外するファイル(カンマ区切りグロブ、例： “.js、.css”、 “.jpg、.png”)	string	__CAPGO_KEEP_0____CAPGO_KEEP_0____CAPGO_KEEP_0__
---Brotliを完全に無効にする	boolean	アップデートのバージョンがBrotliをサポートしている場合でも、Brotli圧縮を完全に無効にする
---バージョンがすでに存在する場合に成功する	boolean	バンドルバージョンがすでに存在する場合に成功する、モノレポのCI/CDワークフローに便利
---デバイスがこのチャンネルに自動で参加できるようにする	boolean	このチャンネルの更新設定をデバイスに自動で参加させる
---自社ホストURL	string	Custom Supabase host URL (for self-hosting or Capgo development)
---匿名鍵	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	__CAPGO_KEEP_0__の互換性を確認するチャンネル
—text	boolean	エモジーではなくテキストを出力
—package-json	string	モノレポ用のpackage.jsonファイルのパス(カンマ区切り)
—node-modules	string	モノレポ用のnode_modulesディレクトリのパス(カンマ区切り)
—supa-host	string	カスタムSupabaseホストURL(自宅ホスティングまたはCapgo開発用)
—supa-anon	string	自作ホスト用のカスタムスパバースアノニマスキー

🔹 リリースタイプ

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	自作ホスト用のカスタムスパバースアノニマスキー

🗑️ 削除

エイリアス: d

npx @capgo/cli@latest bundle delete

🗑️ Delete a specific bundle from Capgo Cloud, optionally targeting a single version.

__CAPGO_KEEP_0__ 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

📋 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	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	自主サーバーでホストする場合のカスタム Supabase anon キー

🧹 Cleanup

Alias: c

npx @capgo/cli@latest bundle cleanup

🧹 Capgo Cloud から古いバンドルを Capgo 個の最新バージョンを残して削除します。 チャンネルにリンクされているバンドルは、—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	Custom Supabase host URL (for self-hosting or Capgo development)
—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	モノレポ用のpackage.jsonファイルのパス（カンマ区切り）

🔓 暗号化解除

npx @capgo/cli@latest bundle decrypt

暗号化されたバンドルの暗号化解除（主にテスト用） 確認のためにbase64セッションキーを出力します。

例：

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

オプション：

パラメータ	型	説明
—key	string	__CAPGO_KEEP_0__のカスタムパス
—key-data	string	__CAPGO_KEEP_0__
—checksum	string	__CAPGO_KEEP_0__
—package-json	string	__CAPGO_KEEP_0__

🔹 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	__CAPGO_KEEP_0__のzipファイル名に使用するバンドルバージョン番号を指定します。
-n,	string	zipファイルの名前を指定します。
-j,	string	JSON形式で出力します。
—no-code-check	boolean	ソースcodeとインデックスがrootフォルダに存在する場合、notifyAppReady()が呼ばれていないことを確認しないようにします。
—key-v2	boolean	暗号化v2を使用します。
—package-json	string	パッケージ.jsonファイルのパス（カンマで区切る）

bundleから続ける

bundleを使用している場合 bundle セキュリティとコンプライアンスの計画に使用するため、CloudflareのEncryptionと接続する Encryption CloudflareのEncryptionの実装詳細 Compliance CloudflareのComplianceの実装詳細 CapacitorのCapgoセキュリティスキャナ CapacitorのCapgoセキュリティスキャナの製品ワークフロー, Capgo セキュリティ Capgo セキュリティの製品ワークフローに Capgo トラストセンター Capgo トラストセンターの製品ワークフローに