カスタムストレージ

セットアッププロンプトをコピーして、インストールステップとこのプラグインの全マークダウンガイドを含めます。

Capgo

概要

Capgoのカスタムストレージでは、Capgoにアップロード先のURLを提供することで、Capgoのバンドルを外部の場所にアップロードし、Capgo SDKは、Capgoのデフォルトのクラウドストレージではなく、カスタムストレージの場所から直接アップデートをダウンロードします。

外部URLアップロード

カスタムストレージを使用する最も簡単な方法は、Capgoにアップロード先のURLを提供することです。

基本的な外部URLアップロード

npx @capgo/cli@latest bundle upload --external https://your-domain.com/bundles/v1.2.3.zip

Capgoに指定されたURLのバンドルを参照するように指示します。Capgoのクラウドストレージにアップロードするのではなく。

暗号化付き

安全な外部ストレージのために、バンドルを暗号化し、復号用のキーを提供できます。

npx @capgo/cli@latest bundle upload --external https://your-domain.com/bundles/v1.2.3.zip --iv-session-key YOUR_IV_SESSION_KEY

S3統合

CapgoはAmazon S3とS3互換ストレージサービスに対して組み込みのサポートを提供します。CLIは自動的にS3にバンドルをアップロードし、CapgoをS3 URLで使用するように設定します。

S3アップロードオプション

npx @capgo/cli@latest bundle upload \
  --s3-region us-east-1 \
  --s3-apikey YOUR_ACCESS_KEY \
  --s3-apisecret YOUR_SECRET_KEY \
  --s3-bucket-name your-bucket-name

S3設定の完了

S3互換サービスまたはカスタムエンドポイントの場合:

npx @capgo/cli@latest bundle upload \
  --s3-region us-east-1 \
  --s3-apikey YOUR_ACCESS_KEY \
  --s3-apisecret YOUR_SECRET_KEY \
  --s3-endpoint https://s3.your-provider.com \
  --s3-bucket-name your-bucket-name \
  --s3-port 443 \
  --no-s3-ssl  # Only if your endpoint doesn't support SSL

S3設定パラメータ

パラメータ	説明	必要
`--s3-region`	S3 バケットのAWS リージョン	はい
`--s3-apikey`	S3 アクセスキーID	はい
`--s3-apisecret`	S3 シークレットアクセスキー	はい
`--s3-bucket-name`	S3 バケットの名前	はい
`--s3-endpoint`	カスタムS3エンドポイントURL	No
`--s3-port`	S3 エンドポイントのためのポート	No
`--no-s3-ssl`	S3 アップロード用に SSL を無効にする	No

バンドル準備と暗号化

カスタムストレージを使用する場合、特に暗号化を使用する場合、バンドルを適切に準備する必要があります。これには、zip ファイルを作成し、オプションで暗号化することが含まれます。

ステップ 1: Zip バンドルを作成する

最初に、zip ファイルを作成してアプリケーションバンドルを圧縮してください:

npx @capgo/cli@latest bundle zip com.example.app --path ./dist

zipコマンドはzipファイルのチェックサムを返します。このチェックサムを使用してzipファイルを暗号化することができます。必要に応じて、 --json オプションを使用して、チェックサムを含む構造化された出力を取得します。

Zipコマンドオプション

npx @capgo/cli@latest bundle zip [appId] \
  --path ./dist \
  --bundle 1.2.3 \
  --name myapp-v1.2.3 \
  --json \
  --no-code-check \
  --key-v2 \
  --package-json ../../package.json,./package.json

オプション	説明
`--path`	zipファイルを作成するフォルダのパス（capacitor.configのwebDirをデフォルト値として使用）
`--bundle`	バンドルバージョン番号をzipファイルの名前として使用
`--name`	zipファイルのカスタム名
`--json`	JSON形式で出力結果 (チェックサムを含む)
`--no-code-check`	notifyAppReady()の呼び出しとindexファイルのチェックをスキップ
`--key-v2`	暗号化 v2 を使用
`--package-json`	モノレポ用のpackage.jsonファイルのパス (カンマで区切る)

ステップ 2: バンドルを暗号化 (オプション)

アップロードする前に、zip バンドルを暗号化してセキュリティを高めましょう:

# Using default local key
npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM

# Using custom key file
npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM --key ./path/to/.capgo_key_v2

# Using key data directly
npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM --key-data "PRIVATE_KEY_CONTENT"

The CHECKSUM パラメータは必須で、zipファイルのチェックサムを指定してください。zipコマンドの出力からチェックサムを取得できます (構造化された出力のオプションを使用してください)。 --json parameter

デフォルトでは、エンコードコマンドはローカルプライベートサインインキーを使用します。カスタムキーを指定するには --key または --key-data カスタムストレージを使用するには、

アップロードまたは復号化に必要な ivSessionKey エンコードコマンドのオプション

エンコードコマンドのオプション

説明	エンコードする ZIP ファイルのパス (必須)
`zipPath`	ZIP ファイルのチェックサム (必須) - ZIP コマンドから取得
`checksum`	プライベートサインインキーのカスタムパス (省略可、ローカルキーを使用する場合)
`--key`	__CAPGO_KEEP_0__
`--key-data`	プライベート署名キーデータを直接 (任意)
`--json`	結果を JSON 形式で出力します

「完了したワークフロー例」のセクション

「例 1: エンコードされた外部 URL」のセクション

Build your app:
ターミナル画面
```
npm run build
```
zipアーカイブを作成:
ターミナル画面
```
npx @capgo/cli@latest bundle zip com.example.app --path ./dist --bundle 1.2.3
```
このコマンドの返されたチェックサムを注意してください。
アーカイブを暗号化:
ターミナル画面
```
npx @capgo/cli@latest bundle encrypt ./com.example.app-1.2.3.zip CHECKSUM_FROM_STEP_2
```
出力から ivSessionKey チェックサムを注意してください。
あなたのストレージにアップロード: エンコードされたzipファイルをホスティングサービスにアップロードしてください。

Capgoで登録してください。

npx @capgo/cli@latest bundle upload \
  --external https://your-cdn.com/bundles/com.example.app-1.2.3.zip \
  --iv-session-key IV_SESSION_KEY_FROM_STEP_3

例 2: S3への直接アップロード

アプリをビルドしてください。
ターミナル画面
```
npm run build
```

S3に直接アップロードしてください。

npx @capgo/cli@latest bundle upload \
  --s3-region us-west-2 \
  --s3-apikey YOUR_ACCESS_KEY \
  --s3-apisecret YOUR_SECRET_KEY \
  --s3-bucket-name your-app-bundles \
  --channel Production

例 3: S3 での暗号化

ビルドと ZIP:

npm run build
npx @capgo/cli@latest bundle zip com.example.app --path ./dist --key-v2

バンドルを暗号化:

npx @capgo/cli@latest bundle encrypt ./com.example.app.zip CHECKSUM

暗号化されたバンドルを S3 にアップロード:

npx @capgo/cli@latest bundle upload \
  --s3-region us-west-2 \
  --s3-apikey YOUR_ACCESS_KEY \
  --s3-apisecret YOUR_SECRET_KEY \
  --s3-bucket-name your-app-bundles \
  --iv-session-key IV_SESSION_KEY_FROM_STEP_2 \
  --channel Production

セキュリティ上の考慮事項

カスタムストレージを使用する場合、以下のセキュリティベストプラクティスを考慮してください。

アクセス制御

ストレージのURLはアプリのユーザーにのみアクセス可能で、一般に公開されないようにする
署名URLまたはトークンベースの認証を使用する
Webベースのアプリでは適切なCORSヘッダーを実装する

暗号化

敏感なバンドルを常にCapgo暗号化ツールで暗号化する
暗号化キーを安全に保存し、定期的にローテートする
すべてのバンドルURLにHTTPSを使用する(モバイルおよびElectronアプリでは必須)

監視

アクセスログを監視して不正なダウンロードパターンを検出する
失敗したバンドルダウンロードのアラートを設定する
ストレージ権限を定期的に検証する

トラブルシューティング

一般的な問題

バンドルダウンロードができません:

URLがパブリックにアクセス可能かつHTTPSを使用していることを確認する(モバイルやElectronアプリ用)
ウェブアプリ用のCORSヘッダを確認する
バンドルのフォーマットが正しいことを確認してください

暗号化エラー:

Verify the ivSessionKey 暗号化されたバンドルと一致することを確認してください
指定されたキーで暗号化されたことを確認してください
新しいバンドルには暗号化 v2 を使用することを確認してください

S3 アップロード失敗:

S3 の資格情報と権限を確認してください
バケットポリシーと CORS 設定を確認してください
指定されたリージョンが正しいことを確認してください

デバッグコマンド

バンドルステータスを確認してください:

npx @capgo/cli@latest app debug

バンドル完整性を検証してください:

npx @capgo/cli@latest bundle list

次のステップ

セクション「次のステップ」学びましょうチャンネル
Capgoリリースチャンネル機能名。Capgoソリューションズマーケティングページ。短いUIラベルまたはナビゲーションアイテム。ソリューションズ/ホワイトラベル.astroページに表示される。メッセージキー`solutions_white_label_visual_cell2_value` (ソリューションズホワイトラベルビジュアルセル2値)。アップデートの動作アップデートの適用方法をカスタマイズする
設定 CI/CD統合コンテキスト:Capgo Builder /ネイティブクラウドビルド製品ページ。役割:短いUIラベルまたはナビゲーションアイテム。メッセージキー`native_build_feature_ci_cd` (Native Build Feature Ci Cd)。

アップデートの適用方法を自動化する

セクション「カスタムストレージから続けて」 カスタムストレージを使用している場合 カスタムストレージセキュリティと法的合致を計画するために、カスタムストレージを暗号化ガイドラインガイドラインの実装詳細について Capgo セキュリティスキャナー Capgo セキュリティスキャナーの製品ワークフローについて Capgo セキュリティ Capgo セキュリティの製品ワークフローについて Capgo トラストセンター Capgo トラストセンターの製品ワークフローについて