コンテキスト: Capgo マーケティングウェブサイト。役割: ウェブサイトのコピー文。見つける場所: コンポーネント doc/SignupCta.astro, コンポーネント Hero.astro。メッセージキー `hero_subtitle_v2` (Hero Subtitle V2)。

このプラグインのインストール手順とマークダウンガイドの全体を含むセットアップコマンドをコピーします。

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

インストール、同期、ソースマークダウンガイドを含みます。

始めましょう前に、次のことを確認してください:

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

署名資格情報を設定

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

最初のビルドを実行

認証が必要です: Capgo にログインしてください。まだしていない場合:

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

もし直前に build initあなたはすでにセットアップ済みです — オンボーディングでは、ビルドを開始するオプションを提示します。したがって、最初のビルドはすでに進行中かもしれません。 🎉

そうでない場合は、自分でビルドを開始してください。 build request — set --platform __CAPGO_KEEP_0__ は、準備されたネイティブプロジェクトをアップロードし、ターミナルでライブビルドログをストリームします。 __CAPGO_KEEP_1__ ビルドは、適切なリリースフローを設定した場合、署名済みアーティファクトを返すか、App Store Connect または Google Play に提出します。

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

The CLI uploads the prepared native project and streams build logs live in your terminal. Capgo Build can return a signed artifact or submit it to App Store Connect or Google Play when you configure the appropriate release flow.

Start a build yourself with — set to whichever you’re building:

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

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]

CIで準備 - ウェブ層をビルドし、プライベート依存関係を解決し、完了したアセットをネイティブプロジェクトに同期します。
アップロード - 準備されたネイティブプロジェクトは、ビルド用の安全なクラウドストレージにアップロードされます。
ビルド実行 - Capgo は、専用インフラでネイティブプロジェクトをコンパイルおよび署名します。
ログストリーミング -リアルタイムログは、Server-Sent Eventsを介してターミナルにストリーミングされます。
クリーンアップ - ビルド環境と一時的なプロジェクトデータは、ビルド後にクリーンアップされます。出力の保持は、選択したアーティファクトとストアデリバリーオプションに依存します。

Bitrise または別の CI を使用して Capgo をビルドします。

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

次に、準備されたネイティブプロジェクトに Capgo ビルドを呼び出してください。 Capgo は、用意されたプロジェクトを受け取ります。 ios/ または android/ プロジェクトをコンパイルして署名するために用意されたネイティブプロジェクトを呼び出します。 __CAPGO_KEEP_1__ は、コンパイルされたウェブアセットを保持する必要はありません。ウェブアセットはすでに用意されたネイティブプロジェクト内にあります。

何がビルドされるか

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

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

含まれています	概要
`ios/` または `android/`	Capgoで使用しているプラットフォームのフォルダ
`package.json`, `package-lock.json`	依存関係マニフェスト
`capacitor.config.*`	Capacitorの設定
`resources/`	アプリアイコン、スプラッシュ画面
Native plugin code	Capgo `ios/` または `android/` subfolder of each Capacitor plugin

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

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

あなたの責任

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

CIで準備する - 私的パッケージレジストリ、SSHベースのCocoaPods、デバイスSDK、拡張機能、Bitriseまたは既存のCIでカスタムネイティブの準備を解決する
ウェブアセットをビルドする - npm run build (またはフレームワークのビルドコマンド) を実行する
ネイティブに同期する - Run npx cap sync を実行して
リクエスト - 準備したものを送信する ios/ または android/ プロジェクトをCapgoにビルドします。

Capgo

__CAPGO_KEEP_0__
は
Code の認証情報で署名
のコンパイル (Xcode, Fastlane) を処理します。
環境変数を通じてサポートされるネイティブビルド構成と資格情報の値

Capgo 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 コピー

次のステップ

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

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