はじめから

Get started with Capgo Cloud Build and create your first iOS or Android native build in minutes.

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

Before you begin, ensure you have:

• A Capacitor アプリがローカルで正常にビルドされる
• Node.js 20 以上がインストールされている
• A Capgo アカウント (無料試用版でも十分)
• あなたのアプリが Capgo に既に登録されている (実行して確認してください) npx @capgo/cli@latest app add (手前準備する署名資格情報は必要ありません — 次のステップで設定します)
• 署名資格情報を設定

「署名資格情報を設定」のセクション

Capgo needs signing credentials to build and submit your app — but you don’t have to wrangle them by hand. Answer a couple of questions and we’ll point you to the exact command to run:

「最初のビルドを実行」のセクション

Capgo

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

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

そうでない場合は、 build request 自分でビルドを開始してください。 --platform — ビルドするものに応じて

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

CLIは、準備されたネイティブプロジェクトをアップロードし、実行中のビルドログをライブでターミナルにストリーミングします。 Capgo ビルドは、署名済みアーティファクトを返すか、App Store Connect または Google Play に送信するように設定すると、適切なリリースフローを構成します。

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

テストログイントエントを話できだって：

flowchart LR
    A[Your CI] -->|1. Prepare Native Project| B[Prepared iOS / Android Project]
    B -->|2. Upload| C[Capgo Build]
    C -->|3. Compile and Sign| D[Dedicated Build Infrastructure]
    D -->|4. Stream Logs| E[Your Terminal]
    D -->|Return Signed Artifact or Store Delivery| F[Output]
    D -->|5. Clean Temporary Project Data| G[Cleanup]

1. CIにモータイントエントを表示した - バータイントエントをコングにきだっています。バータイントエントを話だたれにいます。バータイントエントをコングにきだっています。
2. 保存 - バータイントエントを保存だたれにいます。
3. バータイントエントをコングにきだっています。バータイントエントをコングにきだっています。 - Capgo compiles and signs the native project on dedicated infrastructure.
4. バータイントエントをコングにきだっています。バータイントエントをコングにきだっています。バータイントエントをコングにきだっています。 バータイントエントをコングにきだっています。バータイントエントをコングにきだっています。バータイントエントをコングにきだっています。
5. バータイントエントをコングにきだっています。バータイントエントをコングにきだっています。バータイントエントをコングにきだっています。 バータイントエントをコングにきだっています。バータイントエントをコングにきだっています。バータイントエントをコングにきだっています。

CapgoでCapgoを使用してビルドする

Capgo ビルドは既存のCIを置き換えません。Bitriseまたは他のCIシステムで必要なプライベートアクセスを持つステップを維持してください: プライベートレジストリからインストール、プライベートCocoaPodsをSSH経由で解決、カスタムネイティブセットアップを実行、ウェブレイヤーをビルド、カスタムネイティブセットアップを実行します。 npx cap sync.

準備されたネイティブプロジェクトをCapgo ビルドに呼び出してください。Capgoは、ネイティブプロジェクトが完了したときに受信します。 ios/ または android/ プロジェクトをコンパイルして署名するために使用されるため、__CAPGO_KEEP_1__はあなたのプライベートNexus、CocoaPods SSH、またはウェブビルドのクレデンシャルを必要としません。コンパイルされたウェブアセットはすでに準備されたネイティブプロジェクト内にあります。ビルドに使用されるのではなく、ソースリポジトリとして保持されるのではなく。

何がビルドされるか

Capgo ビルドは、コンパイルするアプリ用に必要な準備されたネイティブプロジェクトを受け取ります。code、プライベート依存性のインストール、CapacitorシンクはあなたのCIに残ります。

何がアップロードされるか

含まれています	概要
ios/ または android/	nativeプラットフォームフォルダ
package.json, package-lock.json	依存関係マニフェスト
capacitor.config.*	Capacitorの設定
resources/	アプリアイコン、スプラッシュスクリーン
ネイティブプラグインcode	Only the ios/ または android/ 各Capacitorプラグインのサブフォルダ

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

除外	なぜ
node_modules/ （ほとんどは）	native プラグインのみ code が含まれ、JS の依存関係は含まれません
src/	ウェブソースの code はローカルに残ります
dist/, www/, build/ （root level）	すでにnativeフォルダにsync済み cap sync
.git/	バージョン管理の履歴
.gradle/, .idea/, .swiftpm/	ビルドキャッシュとIDEの設定
.env, secrets	秘密情報

注意

あなたのビルドされたWebアセット（JS、CSS、HTML）は、 npx cap sync は、ネイティブプロジェクトにコピーしたもののみがアップロードされます。Webソースと依存関係のインストールのステップはCIに残り、準備されたネイティブプロジェクトはバイナリをビルドし、最後にクリーンアップされます。

あなたの責任

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

1. CIで準備する - Bitriseまたは既存のCIで、プライベートパッケージレジストリ、SSHベースのCocoaPods、デバイスSDK、拡張機能、およびカスタムネイティブの準備を解決する。
2. Webアセットをビルドする - Run npm run build (またはフレームワークのビルドコマンド)。
3. ネイティブに同期する - Run npx cap sync を実行して、コンパイルされたWebアセットを用意されたネイティブプロジェクトにコピーします。
4. Request the native build - Send the prepared ios/ または android/ プロジェクトをCapgo Buildに送信します。

What Capgo Build Handles

• ネイティブiOSのコンパイル(Xcode、Fastlane)
• ネイティブAndroidのコンパイル(Gradle)
• Codeの署名にあなたの資格情報を使用する
• オプション：App Store ConnectまたはGoogle Playの提出
• 環境変数を通じてネイティブのビルド構成と資格情報をサポートしています。

Capgo ビルドには、CIがネイティブプロジェクトを準備した後、プライベートNexusレジストリやSSH資格情報へのアクセスが必要ありません。詳しくは ネイティブビルド構成 を参照してください。サポートされる環境変数とストアオプションについて詳しくは

を参照してください。

npx @capgo/cli@latest build request YOUR_APP_ID --platform android --no-playstore-upload --output-upload

--no-playstore-upload コピー --output-upload Play Storeへのアップロードを防止します。Play資格情報が保存されている場合でも。

署名された出力への時間制限付きリンクを提供します。MDMを通じてそのAPKを配布します。

セクションのタイトルは “次のステップ” です。

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

ヘルプが必要ですか

• 確認する トラブルシューティングガイド
• __CAPGO_KEEP_0__ Discordコミュニティに参加
• __CAPGO_KEEP_0__サポートチームに連絡 support@capgo.app