capawesome-cloud

Capawesome Cloud

Capacitor および Cordova アプリ向けに、Capawesome Cloud を使ってネイティブビルド、ライブアップデート、アプリストアへの公開を設定・管理します。

前提条件

1. Capawesome Cloud のアカウントと組織。
2. Capacitor 6/7/8 または Cordova アプリ。注：
   • Live Updates：Capacitor（Android、iOS、および — Capacitor 8 のみ — Electron デスクトッププラットフォーム @capawesome/capacitor-electron）と Cordova の両方でサポートされています。
   • Native Builds：Capacitor、Cordova、ネイティブ iOS／Android プロジェクトでサポートされています。
   • App Store Publishing：フレームワークに依存せず、Native Builds で生成されたネイティブビルドであれば利用できます。
3. Node.js と npm がインストールされていること。
4. Native Builds の場合：アプリが Git リポジトリ（GitHub、GitLab、Bitbucket、または Azure DevOps）にあること。
5. Apple App Store Publishing の場合：有効な Apple Developer Program メンバーシップと、App Store Connect で作成済みのアプリがあること。
6. Google Play Store Publishing の場合：Google Play Developer アカウントと、少なくとも 1 つのバージョンを手動でアップロード済みの、Google Play Console で作成したアプリがあること。

全般的なルール

@capawesome/cli のコマンドを初めて実行する前に、--help フラグを付けて実行し、利用可能なすべてのオプションを確認してください。

MCP サーバー

Capawesome MCP server は最新の Capawesome ドキュメントを提供するため、このスキルに含まれるガイダンスよりも常に新しい情報を参照できます。API トークンを使うと、Capawesome Cloud 管理 API も利用できます。

• Capawesome MCP ツールを利用できる場合は、search_docs でトピックを検索し、該当するページを get_doc_page で読んでから、以下のガイダンスを適用してください。両者の内容が異なる場合は、ドキュメントに従ってください。cloud_* ツールを使えば、このスキルの Capawesome Cloud の手順を直接実行できます。アプリの作成、ビルドの開始、チャネルやストアへのデプロイ、ロールバック、失敗したジョブの診断が可能で、Capawesome CLI の代わりとして利用できます。
• 利用できない場合は、以下のコマンドでサーバーを追加できることを一度だけ伝え、その後はこのスキルを続行してください。サーバーの利用を必須条件にしないでください。

claude mcp add --transport http capawesome "https://mcp.capawesome.io/mcp"

ドキュメントツールの利用にアカウントやトークンは必要ありません。Capawesome Cloud ツールを含む完全なセットアップ手順については、capawesome-mcp スキルを参照してください。

手順

ステップ 1：Capawesome Cloud で認証する

npx @capawesome/cli login

CI/CD では、トークンベースの認証を使用します。

npx @capawesome/cli login --token <token>

ステップ 2：Capawesome Cloud にアプリを作成する

ユーザーがすでにアプリ ID を持っている場合はスキップします。

npx @capawesome/cli apps:create

CLI は組織とアプリ名を尋ねた後、アプリ ID（UUID）を出力します。後続の手順で使うため、保存してください。

アプリの種類は既定で capacitor です。Cordova アプリの場合は --type cordova を渡してください（指定可能な値：android、capacitor、cordova、ios）。

npx @capawesome/cli apps:create --type cordova

ステップ 3：必要な機能を特定する

セットアップする Capawesome Cloud の機能をユーザーに確認してください。

1. Native Builds — iOS および Android アプリをクラウドでビルドします。
2. Live Updates — デプロイ済みアプリに OTA ウェブアップデートを配信します。
3. App Store Publishing — Apple App Store または Google Play Store への申請を自動化します。

ユーザーは 1 つ以上の機能を選択できます。以下の該当するセクションに進んでください。

Native Builds

ネイティブビルドのセットアップと使用手順の全容については、references/native-builds.md を参照してください。内容は次のとおりです。

• Git リポジトリの接続
• 署名証明書のアップロード（Android キーストア、iOS .p12 とプロビジョニングプロファイル）
• 環境とシークレットの設定
• ビルド設定の構成（モノレポ、カスタムビルドコマンド）
• ビルドの開始
• ビルド成果物の監視とダウンロード
• Trapeze を使ったネイティブ設定の上書き
• CI/CD パイプラインのセットアップ

ライブアップデート

まず references/live-updates.md を読みます。このファイルでは、フレームワーク（Capacitor または Cordova）を判定し、対応する手順（live-updates-capacitor.md または live-updates-cordova.md）に案内します。どちらの手順でも、以下を説明しています。

• ライブアップデートプラグイン（Capacitor 用の @capawesome/capacitor-live-update、Cordova 用の @capawesome/cordova-live-update）のインストール
• プラグインの設定（Capacitor の設定または Cordova の config.xml の設定項目）
• ロールバック保護の追加
• アップデートロジックの追加（常に最新版、手動同期、強制アップデート）
• iOS Privacy Manifest の設定
• バージョンの処理方法の設定（バージョン管理されたチャンネル、バージョン管理されたバンドル）
• Electron デスクトッププラットフォームでのライブアップデートの有効化（Capacitor のみ）
• セットアップのテスト

App Store への公開

App Store 公開のセットアップと使用手順の詳細については、references/app-store-publishing.md を読みます。以下の内容を説明しています。

• Apple App Store の配信先の作成（API Key または Apple ID 認証）
• Google Play Store の配信先の作成
• ビルドの配信先へのデプロイ
• 1 ステップでのビルドとデプロイ

エラー処理

ネイティブビルド

• invalid source release: 21 → JAVA_VERSION 環境変数を 17 または 21 に設定します。references/build-troubleshooting.md を読みます。
• JavaScript heap out of memory → NODE_OPTIONS 環境変数を --max-old-space-size=4096 に設定します。references/build-troubleshooting.md を読みます。
• 認証エラー → npx @capawesome/cli login を再実行します。CI/CD の場合は、トークンを確認します。
• 署名証明書がない → apps:certificates:create でアップロードします。references/certificates-android.md または references/certificates-ios.md を読みます。
• プロビジョニングプロファイルの有効期限切れ → Apple Developer Portal で再生成して、再アップロードします。references/certificates-ios.md を読みます。
• Web ビルドのステップが失敗する → package.json に capawesome:build または build スクリプトがあることを確認します。references/build-configuration.md を読みます。

ライブアップデート

• npx cap sync が失敗する（Capacitor）→ package.json 内のプラグインのバージョンが Capacitor のバージョンと一致することを確認します。
• バンドルが適用されない → readyTimeout／READY_TIMEOUT が期限切れになる前に ready() が呼び出されることを確認します。
• 再起動後にアプリがデフォルトのバンドルに戻る → ready() が呼び出されていない可能性があります。アプリの初期化時に早い段階で追加します（Cordova では deviceready リスナー内に追加します）。
• アップロードの認証エラー → npx @capawesome/cli login を再実行します。
• autoUpdateStrategy: "background"／AUTO_UPDATE_STRATEGY=background でアップデートが検出されない → 前回の確認から 15 分以上経過した場合にのみ、アップデートが確認されます。アプリを強制終了して再起動します。
• **Cordova：**設定項目を変更しても反映されない → Cordova が設定項目を読み込むのは、プラットフォームを追加するときだけです。cordova platform rm <platform> を実行してから、cordova platform add <platform> を実行します。
• **Cordova：**アップデートが適用されない／WebView エラーが発生する → このプラグインには、デフォルトのカスタム WebView スキームが必要です。config.xml で Scheme=file または AndroidInsecureFileModeEnabled=true が設定されていないことを確認します。
• Electron：npx cap sync electron を実行しても何も起きない → 無関係な electron npm パッケージに解決されます。npx cap sync @capawesome/capacitor-electron を実行します。
• Electron：manifest バンドルが配信されない → Electron デバイスが受信できるのは zip バンドルのみです。デフォルトの --artifact-type zip を指定してアップロードします。
• **Electron：**リリースのたびにアプリのバージョンが 0.0.0 と報告される → デスクトップのリリースごとに electron/package.json の version を更新します。これは、バージョン制約とバージョン管理されたチャンネルに使用されるアプリのバージョンです。
• SDK API リファレンスの全内容については、references/live-update-plugin-api.md を読みます。
• コンプライアンス、請求、制限については、references/live-update-faq.md を読みます。

App Store への公開

• 認証エラー → npx @capawesome/cli login を再実行してください。
• 配信先の作成に失敗する → 認証情報を確認してください。references/apple-app-store-credentials.md または references/google-play-store-credentials.md を参照してください。
• iOS ビルドが TestFlight に表示されない → ビルドの処理には時間がかかる場合があります。よくある原因として、ビルド番号がインクリメントされていないこと、Info.plist にプライバシーに関する説明がないこと、権限が不足していることが挙げられます。
• Google Play へのデプロイに失敗する → 最初のバージョンが手動でアップロードされていることを確認してください。サービスアカウントにリリース権限があることを確認してください。
• デプロイがタイムアウトする → --detached フラグを使用し、apps:deployments:logs でログを確認してください。
• apps:deployments:create が「build not found」で失敗する → ビルドが正常に完了したことを確認してください。
• 停滞したデプロイをキャンセルする → npx @capawesome/cli apps:deployments:cancel --app-id <APP_ID> --deployment-id <DEPLOYMENT_ID>。

関連スキル

• capacitor-app-development — Capacitor の一般的な開発トピック、CI/CD のパターン、トラブルシューティングについて説明します。
• capawesome-cli — Capawesome CLI の全コマンドリファレンス、プロジェクト設定、CI/CD 統合の詳細を説明します。
• capacitor-plugins — @capawesome/capacitor-live-update プラグインを含む、Capacitor プラグインのインストールと設定について説明します。
• capacitor-platforms — Live Updates を受信する @capawesome/capacitor-electron デスクトッププラットフォームの追加と設定について説明します。
• ionic-appflow-migration — 既存の Ionic Appflow プロジェクトを Capawesome Cloud に移行する方法を説明します。
• capgo-cloud-migration — 既存の Capgo プロジェクトを Capawesome Cloud に移行する方法を説明します。
• capacitor-in-app-purchases — アプリストアに公開する前に、アプリ内購入とサブスクリプションを設定する方法を説明します。
• capawesome-mcp — MCP クライアントをホストされた Capawesome MCP サーバーに接続し、常に最新のドキュメントと Capawesome Cloud の管理機能を利用できます。