コンテンツにスキップ
Capgo - Capacitor アプリのライブ更新 Capgo

始め方

Capgo Cloud Buildで始めて、iOSまたはAndroidのネイティブビルドを作成してみましょう。

必要なもの

「必要なもの」というタイトルのセクション

始める前に、以下の条件を確認してください。

  • Capacitor アプリケーションがローカルで正常にビルドされる
  • Node.js 20 以上がインストールされている
  • Capgo アカウントに有効なサブスクリプションが存在する
  • Capgo にアプリケーションがすでに登録されている (「登録されていない場合に実行する」) bunx @capgo/cli@latest app add ビルドクレデンシャルが設定されている
  • (証明書、キーストア) - 以下を参照 最初のビルド前

「最初のビルド前」というタイトルのセクション

最初のビルド前

__CAPGO_KEEP_0__ →

クイック スタート

  1. クイック スタート

    セットアップ ビルド クレデンシャル

    ビルドする前に、ローカルにクレデンシャルを保存する必要があります。

    iOS の場合:
    bunx @capgo/cli@latest build credentials save \
      --platform ios \
      --certificate ./cert.p12 \
      --p12-password "password" \
      --provisioning-profile ./profile.mobileprovision \
      --apple-key ./AuthKey.p8 \
      --apple-key-id "KEY123" \
      --apple-issuer-id "issuer-uuid" \
      --apple-team-id "team-id"

    コピーする

    ターミナル画面
    bunx @capgo/cli@latest build credentials save \
      --platform android \
      --keystore ./release.keystore \
      --keystore-alias "my-key" \
      --keystore-key-password "key-pass" \
      --keystore-store-password "store-pass"

    を参照してください 詳細については、 エラーがないことを確認してください。

  2. ローカルビルドを確認する

    最初に、エラーがないことを確認してください。

    ターミナル画面
    # Build your web assets
    bun run build
    

    # Sync with Capacitor
    bunx cap sync
    

    # Test local build (optional but recommended)
    bunx cap open ios    # For iOS
    bunx cap open android # For Android

  3. Capgoにログインする

    CapgoのAPIキーを設定します (既に設定されている場合は除きます):

    ターミナル画面
    bunx @capgo/cli@latest login

    または環境変数を設定します:

    ターミナル画面
    export CAPGO_TOKEN=your_api_key_here

  4. 最初のビルドを実行する

    Android デバッグ ビルドから始めます (テストに最適):

    ターミナル画面
    bunx @capgo/cli@latest build com.example.app \
      --platform android \
      --build-mode debug

    ビルドが進行中のリアルタイムログを確認できます:

    ✔ Creating build job...
    ✔ Uploading project (15.2 MB)...
    ✔ Build started
    

    📝 Build logs:
    → Installing dependencies...
    → Running Gradle build...
    → Signing APK...
    ✔ Build succeeded in 3m 42s

  5. ビルドのステータスを確認する

    The CLI will automatically poll and display the build status. Once complete, you’ll see:

    • ビルド時間
    • 成功/失敗のステータス
    • App Store/Play Storeにアプリを提出する (クレデンシャルが設定されている場合)

ビルドプロセスの理解

ビルドプロセスの理解

ビルドコマンドを実行すると、以下のことが起こります:

  1. ローカル準備 - プロジェクトはzip化されます (除く node_modules アップロード
  2. - zipは安全なクラウドストレージ (__CAPGO_KEEP_0__ R2) にアップロードされます - The zip is uploaded to secure cloud storage (Cloudflare R2)
  3. ビルド実行 - アプリは専用のインフラストラクチャ上でビルドされます。
  4. ログ ストリーミング - Server-Sent Events を使用してリアルタイムでログがターミナルにストリーミングされます。
  5. 自動クリーンアップ - ビルド アーティファクトは削除されます (Android: 即時、iOS: 24 時間)

ビルド インフラストラクチャ

ビルド インフラストラクチャ

ビルド実行は、M4 マシン上で実行されます。

  • 10-core M4 CPU (4 のパフォーマンス コア、6 の効率性 コア)
  • 10-core GPU
  • 16-core Neural Engine
  • 16GBのRAM
  • macOS Tahoe 26.2

ビルドイメージでは、Xcode 26.2、Android Studio 2025、および .NET 9/.NET 10 SDK のネイティブビルドパイプライン用のワークロードをサポートしています。

最初のプロダクションビルド

「最初のプロダクションビルド」

プロセスが正常に動作することを確認したら、プロダクションビルドを作成してください。

Android

「Android」
ターミナル画面
bunx @capgo/cli@latest build com.example.app \
  --platform android \
  --build-mode release

署名資格情報を設定する必要があります。詳細は「Android Build Configuration」を参照してください。 Android Build Configuration.

iOS

「iOS」セクション
ターミナル画面
bunx @capgo/cli@latest build com.example.app \
  --platform ios \
  --build-mode release

iOSのビルドには署名証明書とプロビジョニングプロファイルが必要です。詳しくは iOSビルド設定.

何がビルドされるか

「何がビルドされるか」セクション

Capgo ビルドのみ、コンパイルするために必要な __CAPGO_KEEP_0__ の全ソースは、機械上に残ります。 to compile your native app. Your full source code never leaves your machine.

__CAPGO_KEEP_0__

アップロードされるもののリスト
含まれる説明
ios/ または android/Nativeプラットフォームフォルダ
package.json, package-lock.json依存関係マニフェスト
capacitor.config.*Capacitorの設定
resources/アプリアイコン、スプラッシュスクリーン
ネイティブプラグインcodeそのプラグインのサブフォルダのみ ios/ または android/ 各Capacitorプラグインのサブフォルダ

アップロードされていないもの

「アップロードされていないもの」
除外なぜ
node_modules/ (ほとんど)code のネイティブ プラグインのみが含まれ、JS の依存関係は含まれません
src/code のウェブ ソースはローカルに残ります
dist/, www/, build/ (root level)__CAPGO_KEEP_0__ はすでにネイティブ フォルダにsync済みです cap sync
.git/バージョン管理の履歴
.gradle/, .idea/, .swiftpm/ビルドキャッシュとIDEの設定
.envシークレット__CAPGO_KEEP_0__

を実行する必要があるからです。

あなたの責任

実行前に bunx @capgo/cli@latest build:

  1. Webアセットを構築する - 実行 bun run build (またはフレームワークのビルドコマンド)
  2. ネイティブに同期する - 実行 bunx cap sync Webアセットをネイティブプロジェクトにコピーする
  3. 依存関係をコミットする - ネイティブプラグインがすべて含まれていることを確認する package.json

Capgo ビルドが扱うもの

セクション「Capgo ビルドが扱うもの」
  • ネイティブiOSコンパイル(Xcode, Fastlane)
  • ネイティブ Android コンパイル (Gradle)
  • Code であなたの資格情報で署名
  • アプリストアの提出 (設定済みの場合)

ビルド時間とコスト

ビルド時間とコスト

ビルド時間は、開始から完了までの時間で測定されます。

  • Android: 通常 3-5 分
  • iOS: 通常 5-10 分
  • インフラ: Mac Mini Silicon M4 マシンが macOS Tahoe 26.2 を実行しています

実際に使用したビルド時間のみに対して支払います。隠れた料金はありません。

一般的な使用例

「一般的な使用例」のセクション

CI/CD統合

「CI/CD統合」のセクション

Capgo をトリガーして、 GitHub Actions ワークフローから自動的にビルドを実行してください。プッシュ、タグ、または手動ボタンクリックのいずれかで。詳細なワークフロー例については、 Capgo Actions ガイドを参照してください。 GitHub Actions ガイド __CAPGO_KEEP_0__ Actions ガイド

ローカル開発

「ローカル開発」のセクション

コミットする前に、ローカルでビルドテストしてください:

ターミナル画面
# Quick debug build for testing
bun run build && bunx cap sync
bunx @capgo/cli@latest build com.example.app \
  --platform android \
  --build-mode debug

両プラットフォームのビルド

「両プラットフォームのビルド」セクション

両プラットフォームのビルドを行うには、2つのコマンドを実行します。

ターミナル画面
# iOS build
bunx @capgo/cli@latest build com.example.app \
  --platform ios \
  --build-mode release


# Android build
bunx @capgo/cli@latest build com.example.app \
  --platform android \
  --build-mode release

CI/CD環境では、並列ジョブでこれらのコマンドを実行することで、ビルドの速度を向上させることができます。

次のステップ

「次のステップ」セクション

最初のビルドを作成した後は、以下の手順に進んでください。

必要な助けを求める

「必要な助けを求める」のセクション