始め方

インストール手順とこのプラグインの全マークダウンガイドを含む設定用の質問をコピーする。

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

必要なもの

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

ローカルで成功する Capacitor アプリ
Node.js 20 以上がインストールされている
Capgo アカウント (無料試用版でも十分)
あなたのアプリはすでにCapgo (run bunx @capgo/cli@latest app add もしも
(あらかじめ署名資格を用意する必要はありません — 次のステップで設定します。)

署名資格を設定

Capgoはアプリをビルドおよび提出するために署名資格が必要ですが、手動で管理する必要はありません。答えを2つ回答し、正しいコマンドを実行する場所を指示します。

最初のビルドを実行

Capgoに認証する必要があります。まだ認証していない場合は:

bunx @capgo/cli@latest login
# or, in CI, set the token directly:
export CAPGO_TOKEN=your_api_key

直前に実行した build init、あなたはすでに準備が整っています — オンボーディングはあなたのビルドを開始するためのオファーを提示しますので、最初のビルドはすでに送信されている可能性があります。 🎉

そうでない場合、 build request — セット --platform あなたが作成中のものに

bunx @capgo/cli@latest build request com.example.app --platform <android|ios> --build-mode debug

The CLI はあなたのプロジェクトをアップロードし、ターミナルでビルドログをリアルタイムでストリーミングし、 — あなたのクレデンシャルが設定されたら — ストアに結果を自動で提出します。

ビルドプロセスを理解する

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

flowchart LR
    A[Your Machine] -->|1. Zip Project| B[Local Temp]
    B -->|2. Upload| C[Capgo Cloud]
    C -->|3. Build| D[Mac Mini Silicon M4 Build Server]
    D -->|4. Logs Stream| A
    D -->|5. Cleanup| E[Auto Delete]

ローカル準備 - ごプロジェクトは zip 形式で圧縮されます (除く node_modules とドットファイル)
アップロード - zip 形式のファイルは Cloudflare R2 のセキュアクラウドストレージにアップロードされます
ビルド実行 - ごプロジェクトは専用のインフラでビルドされます
ログストリーミング - 実時間ログは Server-Sent Events を使用してターミナルにストリーミングされます
自動クリーンアップ - ビルドアーティファクトは削除されます (Android: 即時、iOS: 24 時間)

何がビルドされるか

Capgo Build only 上传する必要なファイルのみを コンパイルするために必要な最小限のファイル マシン上のあなたのフルソース code は、どのくらいの頻度で変更されるかを考慮してください。

What Gets Uploaded

Included	Description
`ios/` または `android/`	Capgoでビルドしているプラットフォームのフォルダ
`package.json`, `package-lock.json`	依存関係のマニフェスト
`capacitor.config.*`	Capacitor の設定
`resources/`	アプリのアイコン、スプラッシュスクリーン
ネイティブプラグイン code	Only the `ios/` or `android/` 各 Capacitor プラグインのサブフォルダ

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

除外	なぜ
`node_modules/` （ほとんどの場合）	Only native plugin code is included, not JS dependencies
`src/`	Your web source code stays local
`dist/`, `www/`, `build/` (root level)	すでにnativeフォルダにsync済み `cap sync`
`.git/`	バージョン管理の履歴
`.gradle/`, `.idea/`, `.swiftpm/`	ビルドキャッシュとIDEの設定
`.env`、シークレット	アップロードされていない

あなたの責任

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

Web アセットをビルドする - Run bun run build (またはフレームワークのビルドコマンド)
ネイティブに同步 - Run bunx cap sync Web アセットをネイティブプロジェクトにコピーする
依存関係をコミットする - __CAPGO_KEEP_0__のネイティブプラグインはすべて package.json

What Capgo Build Handles

ネイティブiOSのコンパイル(Xcode, Fastlane)
ネイティブAndroidのコンパイル(Gradle)
Codeの署名
アプリストアの提出(設定済み)

次のステップ

最初のビルドを作成した後

iOSのビルドの設定 - 証明書とプロファイルの設定
Androidビルドの設定 - キーストアとPlayストアの設定
トラブルシューティング - 一般的な問題と解決策
CLI リファレンス - 完全なコマンドドキュメント