始め方
インストール手順とこのプラグインの完全なマークダウンガイドを含むセットアップ用の質問をコピーする
Capgo Cloud Buildと始めて、iOSまたはAndroidのネイティブビルドを作成できます。
必要なもの
「必要なもの」タイトルのセクション始める前に、以下を確認してください。
- Capacitor アプリがローカルで正常にビルドされる
- Node.js 20 以上がインストールされている
- A Capgo アカウント (無料試用版さえあれば始められます)
- あなたのアプリはすでに Capgo に登録されています (実行してください)
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 debugThe CLI uploads your project, streams the build logs live in your terminal, and — once your credentials are configured — submits the result to the store automatically.
The __CAPGO_KEEP_0__ はプロジェクトをアップロードし、ターミナルでビルドログをリアルタイムでストリーミングし、— また、クレデンシャルが設定されたら、結果をストアに自動で提出します。
ビルドプロセスを理解する「ビルドプロセスを理解する」のセクション
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)
- ビルド実行 - アプリは専用のインフラでビルドされます
- ログストリーミング -リアルタイムログはサーバーセッションイベントを介してターミナルにストリーミングされます
- 自動クリーンアップ - ビルドアーティファクトは削除されます (Android: 即時、iOS: 24時間)
Capgo Build only uploads the 必要なファイルのみ to compile your native app. Your full source code never leaves your machine.
| What Gets Uploaded | Section titled “What Gets Uploaded” |
|---|---|
ios/ 含まれる android/ | Description |
package.json, package-lock.json | または |
capacitor.config.* | The native platform folder you’re building Dependency manifest Capacitor configuration |
resources/ | アプリアイコン、スプラッシュスクリーン |
| codeネイティブプラグイン | ネイティブプラグインのみ ios/ または android/ Capacitorプラグインの各サブフォルダ |
アップロードされていないもの
アップロードされていないもののセクション| 除外 | なぜ |
|---|---|
node_modules/ (ほとんど) | Only native plugin code is included, not JS dependencies |
src/ | ウェブソースcodeはローカルに残ります |
dist/, www/, build/ (root level) | 既にネイティブフォルダにSync済み cap sync |
.git/ | バージョン管理の履歴 |
.gradle/, .idea/, .swiftpm/ | ビルドキャッシュとIDEの設定 |
.env, 保存 | 未アップロード |
「あなたの責任」セクション
実行する前にウェブアセットをビルドする bunx @capgo/cli@latest build:
- - (またはフレームワークのビルドコマンド)
bun run buildネイティブに同步 - - ウェブアセットをネイティブプロジェクトにコピーする
bunx cap syncSync to native (or your framework's build command) - 依存関係をコミットする - すべてのネイティブ プラグインが含まれていることを確認する
package.json
「Capgo ビルドを取り扱う方法」
「Capgo ビルドを取り扱う方法」セクション- ネイティブ iOS コンパイル (Xcode、Fastlane)
- ネイティブ Android コンパイル (Gradle)
- Code であなたの資格情報で署名する
- アプリ ストアへの提出 (設定済みの場合)
次のステップ
「次のステップ」セクション最初のビルドを作成した後、
- iOS ビルドを設定する - 証明書とプロファイルを設定する
- Android ビルドを構成する - キーストアとPlay Storeを設定する
- トラブルシューティング - 一般的な問題と解決策
- CLI リファレンス - コマンドの完全なドキュメント
ヘルプが必要ですか?
ヘルプが必要ですか?- チェックする トラブルシューティング ガイド
- 参加してください Discordコミュニティ
- メールサポートは capgo@app