はじめに

このプラグインのフルマークダウンガイドとインストールステップを含むセットアッププロンプトをコピーしてください。

Capgo Cloud Buildで始めて、iOSまたはAndroidのネイティブビルドを作成してください。

必要なものは何ですか?

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

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

署名資格情報の設定

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

最初のビルドを実行

をビルドするには、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]

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

ビトリースまたは他のCIでCapgoビルドを使用します

次に、準備されたネイティブプロジェクトにCapgoビルドを呼び出してください。__CAPGO_KEEP_1__は準備されたネイティブプロジェクトを受け取ります。 npx cap sync.

Then call Capgo Build with the prepared native project. Capgo receives the ready ios/ __CAPGO_KEEP_0__ビルドは既存のCIを置き換えません。ビトリースまたは他のCIシステムで必要なプライベートアクセスを持つステップを保持してください: プライベートレジストリからインストール、プライベートCocoaPodsをSSH経由で解決、カスタムネイティブセットアップを実行、ウェブ層をビルド、カスタムネイティブセットアップを実行します。 android/ 次に、準備されたネイティブプロジェクトに__CAPGO_KEEP_0__ビルドを呼び出してください。__CAPGO_KEEP_1__は準備されたネイティブプロジェクトを受け取ります。

プロジェクトをコンパイルして署名するために必要な準備されたネイティブプロジェクトを受け取ります。__CAPGO_KEEP_1は既存のCIで保持されるWebソース、プライベート依存性のインストール、CAPGO_KEEP_2__のシンクです。

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

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

含まれる	説明
`ios/` または `android/`	Capacitorライブアップデートの代替品の比較ページ
`package.json`, `package-lock.json`	Capacitorライブアップデートの代替品の比較ページ
`capacitor.config.*`	Capacitor configuration
`resources/`	Capacitorライブアップデートの代替品の比較ページ
Native plugin code	Capacitorライブアップデートの代替品の比較ページ `ios/` Capacitorライブアップデートの代替品の比較ページ `android/` subfolder of each Capacitor plugin

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

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

あなたの責任

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

あなたの CI で準備する - ビトリースまたはあなたの既存の CI で、プライベートパッケージレジストリ、SSH ベースの CocoaPods、デバイス SDK、拡張機能、およびカスタムネイティブの準備を解決する
- ビルド - npm run build または、フレームワークのビルドコマンド
ネイティブに同期 - ビルド npx cap sync ネイティブのビルドを要求
- 準備した または ios/ Capacitorライブアップデートの代替 android/ project to Capgo Build.

What Capgo Build Handles

コンサルティングサービス
プロジェクトを__CAPGO_KEEP_0__ビルド
Code の署名にあなたの資格情報を使用します。
App Store Connect または Google Play の提出は任意です。
サポートされているネイティブビルド構成と資格情報は環境変数として渡されます。

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

ビルド構成

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

--no-playstore-upload ターミナルウィンドウ --output-upload コピー

Play Storeのアップロードを防ぐため、Playの資格情報が保存されている場合でも、提供される時間制限付きのリンクを使用して署名済みの出力を配布します。

最初のビルドを作成しました。

iOSビルドの設定 - 証明書とプロファイルの設定
Androidビルドの設定 - キーストアとPlayストアの設定
トラブルシューティングコンテキスト:サポート/プレミアムサポートページまたはフッターのサポートセクション。役割:セクションまたはページヘッダー。見つける場所:ページサポートポリシー。メッセージキー`サポートポリシートラブルシューティングタイトル` (サポートポリシートラブルシューティングタイトル)。
CLI Reference __CAPGO_KEEP_0__ リファレンス

- コマンドの完全なドキュメント

確認してくださいトラブルシューティングガイド
Discordコミュニティに参加してくださいサポートメール
support@__CAPGO_KEEP_0__.app support@capgo.app