📦 パッケージ

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

⬆️ アップロード

Alias: 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 ロールアウト決定キャッシュの有効期間 (秒)
-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
—fail-on-incompatible	boolean	—ignore-metadata-check
—link	boolean	アップロードを失敗させる (ゼロ以外の終了コードを返す) ではなく、チャンネルの現在のネイティブパッケージと不一致の場合にアップロードしない。インタラクティブなターミナルでは、ネイティブビルドを選択できますが、拒否すると失敗します。 —ignore-metadata-check と組み合わせることはできません。
—ignore-checksum-check	boolean	アップロード時にチェックサムチェックを無視します。
—force-crc32-checksum	boolean	アップロード時にCRC32チェックサムを強制します (自動検出をオーバーライド)
—timeout	string	アップロードプロセスのタイムアウト時間 (秒)
—multipart	boolean	[非推奨] —tus を使用してください。 S3 アップロードにマルチパートプロトコルを使用します。
—zip	boolean	zip を使用して Capgo クラウドにアップロードします (レガシー)
—tus	boolean	TUSを使用してバンドルをアップロードする: Capgo クラウド
—tus-chunk-size	string	TUS再開可能アップロードのバイト単位のチョンクサイズ (デフォルト: 自動)
—partial	boolean	[非推奨] —deltaを使用してください。インクリメンタルアップデートをアップロード
—partial-only	boolean	[非推奨] —delta-onlyを使用してください。フルバンドルをスキップしてインクリメンタルアップデートのみをアップロード
—delta	boolean	インスタント、超高速のアップデートのために大きなzipダウンロードを避けるために、変更されたファイルのみのdeltaアップデートをアップロード
—delta-only	boolean	最大速度でアップロードするために、フルバンドルを含まないdeltaアップデートのみをアップロード (大規模アプリ用)
—no-delta	boolean	Delta更新を無効にする (インスタント更新が有効になっている場合でも)
—encrypted-checksum	string	アップロードする外部バンドル用にのみ使用される暗号化されたチェックサム (署名)
—auto-set-bundle	boolean	config.jsonのcapacitorにバンドルを設定する
—dry-upload	boolean	バンドルプロセスのdryアップロード: データベースに行を追加するだけ (ファイルやチャンネルをアップデートしない) (内部テスト用にCapgoで使用)
—package-json	string	モノレポ用のpackage.jsonファイルのパス (カンマ区切り)
—node-modules	string	モノレポ用のnode_modulesディレクトリのパス (カンマ区切り)
—encrypt-partial	boolean	暗号化 delta 更新ファイル (アップデーター > 6.14.4 から自動有効)
—アップロード時にリンクされたバンドルを削除	boolean	アップロードしようとしているチャンネルで現在リンクされているバンドルを検索し、削除
—Brotli 圧縮から除外するファイル (カンマ区切りで、例えば “)	string	.jpg,.png”)—Brotli 圧縮を完全に無効にする (アップデーター版がサポートしている場合でも)
—バンドルバージョンがすでに存在する場合に成功する (モノレポの CI/CD ワークフロー向け)	boolean	—自身に割り当てる
—Brotli 圧縮パターンを指定しない	boolean	—Brotli 圧縮を無効にする
—バンドルバージョンがすでに存在する場合に成功する (モノレポの CI/CD ワークフロー向け)	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 anon キー (自作ホスティング用)

🗑️ 削除

Alias: d

npx @capgo/cli@latest bundle delete

🗑️ Capgo Cloud から特定のバンドルを削除します。バージョンを 1 つだけターゲットにすることもできます。

例:

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でアプリのアップロードしたすべてのバンドルをリストする

例:

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

オプション:

パラメーター	タイプ	説明
-a	string	APIのキーを使用してアカウントにリンクする
--supa-host	string	カスタム Supabase ホスト URL (自社ホスティングまたは Capgo 開発用)
—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

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

例:

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

オプション:

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