はじめに

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]

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

Use Capgo ビルトリスまたは他のCIを使用

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

Then call Capgo Build with the prepared native project. Capgo receives the ready ios/ または android/ ビルトリスまたは他のCIを使用して__CAPGO_KEEP_0__ビルトを実行します。

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

Capgo Build receives the prepared native project required to compile your app. Your web source code, private dependency installation, and Capacitor sync remain in your CI.

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

含まれる	説明
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/ (ほとんど)	Only native plugin code is included, not JS dependencies
src/	Your web source code stays local
dist/, www/, build/ (rootレベル)	バージョン管理の履歴 cap sync
.git/	ビルドキャッシュとIDEの設定
.gradle/, .idea/, .swiftpm/	, 秘密情報
.env(ほとんど)	アップロードされていません

注意

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

あなたの責任

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

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

What Capgo Build Handles

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

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

MDM から配布されるキオスク フラビアの場合、Android プロジェクト/ビルドを APK を生成するように設定します。ビルドを要求するときは、両方のフラグを使用して Google Play をスキップし、署名された出力を取得します:

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

--no-playstore-upload Play Store のアップロードを防止します。Play 資格情報が保存されている場合でも。 --output-upload 署名された出力への時限付きリンクを提供します。MDM からその APK を配布します。

次のステップ

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

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

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

• チェックする トラブルシューティング ガイド
• コミュニティに参加する Discordコミュニティに参加する
• サポートメール capgo.appのサポートメール