📦 パッケージ

📦 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,beta

チャンネル (またはリモートアプリの最新バージョン) から、__CAPGO_KEEP_0__ を指定しない場合に、次のフリーバージョンを自動的に増分します。 --bundle__CAPGO_KEEP_0__ のバージョンが CI の場合に便利です。 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__/チャンネル デルタ マニフェストと比較し、推測し --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 patch.

オプション:

パラメータ	タイプ	説明
-a	string	APIで指定したアカウントにリンクするためのキー
-p	string	capacitor.configで指定されているwebDirを使用しない場合、アップロードするフォルダーのパス
-c	string	リンクするチャンネルを指定。複数のチャンネルを指定する場合は、カンマで区切る。例: production,beta
—rollout	string	0から100のパーセンテージでアップロードしたバンドルをこのチャンネルのロールアウトターゲットとして設定
—stable	boolean	ロールアウト設定済みのチャンネルで、安定版のフォールバックを置き換えるのではなく、ロールアウトのターゲットを設定する
—ロールアウトパーセンテージbps	string	ロールアウトパーセンテージを0から10000の範囲で設定します。
—ロールアウトキャッシュTTL秒	string	Cloudflare ロールアウト決定キャッシュのTTLを秒単位で設定します。
-e	string	Capgo へのアップロードの代わりに、外部URLにリンクする
—IVセッションキー	string	URL外部のバンドルURLのIVとセッションキーを設定する
—S3リージョン	string	S3バケットのリージョンを指定する
—S3APIキー	string	API key for your S3 endpoint
—s3-エサインにを以得にを使用してきる	string	API secret for your S3 endpoint
—s3-エサインを以得にを使用してきる	string	エサインを以得にを読したん
—s3-バーター名前	string	エサインを以得にを使用してきるバーター名前
—s3-バーターバー	string	エサインを以得にを使用してきるバーターバー
エサインを以得にを使用してきるバーターバーにいますにを巹れ	boolean	—no-s3-エメエレカ
—エメエレカヒログを巹れ	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 リリース)
—comment	string	このバージョンについてのコメント、リリースノート、コミットハッシュ、コミットメッセージなど
—min-update-version	string	このバージョンにアップデートするために必要な最小バージョン。チャンネルの自動アップデートを無効にし、メタデータに設定した場合にのみ使用
—auto-min-update-version	boolean	ネイティブパッケージに基づいて最小アップデートバージョンを設定
—ignore-metadata-check	boolean	アップロードの際にメタデータ (node_modules) のチェックを無視します。
—fail-on-incompatible	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	CapgoクラウドにTUSを使用してアップロードしてください
—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	capacitor.config.json にバンドルを設定する
—dry-upload	boolean	バンドルアップロードプロセスをドライ実行: データベースに行を追加するだけ、ファイルをアップロードせず、チャンネルを更新しない ( Capgo の内部テスト用)
—package-json	string	モノレポ用の package.json ファイルのパス (カンマ区切り)
—node-modules	string	モノレポ用のnode_modulesディレクトリのパス (カンマ区切り)
—encrypt-partial	boolean	delta更新ファイルを暗号化 (アップデーター6.14.4以上の場合、自動有効)
—delete-linked-bundle-on-upload	boolean	アップロードしようとしているチャンネルで、現在リンクされているバンドルを検索し、削除
—no-brotli-patterns	string	Brotli圧縮から除外するファイル (カンマ区切り、例： “.jpg,” “.png”)—disable-brotliアップデーター版が対応している場合でも、Brotli圧縮を完全に無効にする
—version-exists-ok	boolean	Paths to node_modules directories for monorepos (comma-separated)
—encrypt-partial	boolean	バンドルのバージョンがすでに存在する場合、CI/CD ワークフローとモノレポのために成功して終了します。
—self-assign	boolean	このチャンネルにデバイスを自動で参加させることを許可します (更新されたチャンネル設定)
—qr-preview	boolean	このバンドルのプレビューをアップロードした後にターミナル QR code を表示します。
—send-update-notification	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 key to link to your account
-c	string	Channel to check the compatibility with
—text	boolean	Output text instead of emojis
—package-json	string	Paths to package.json files for monorepos (comma-separated)
—node-modules	string	Paths to node_modules directories for monorepos (comma-separated)
—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 キー (自作の場合)

🗑️ 削除

別名: 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	カスタム Supabase ホスト URL (自社ホスティングまたは Capgo 開発用)
--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	自宅サーバーまたは開発用の Capgo のカスタム Supabase ホスト URL
—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

オプション:

パラメーター	タイプ	説明
-b	string	削除するアプリのバンドルバージョン番号
-a	string	APIアカウントにリンクするためのキー
-k	string	保管するバージョンの数
-f	boolean	強制削除
—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	boolean	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	プライベート署名鍵のカスタムパス
—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ファイルのパス(カンマ区切り)