必要な助け

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 Build with Bitrise or another CI

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

次に、準備されたネイティブプロジェクトにCapgo Buildを呼び出してください。Capgoは、ビルドが完了した後すぐに、準備されたネイティブプロジェクトを受け取ります。 ios/ または android/ Capacitorライブアップデートの代替

Capacitorライブアップデートの代替

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のコンサルティングサービスについてのFAQのサブタイトルです。

含まれる	説明
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 level)	バージョン管理の履歴 cap sync
.git/	バージョン管理の履歴
.gradle/, .idea/, .swiftpm/	ビルドキャッシュとIDE設定
.envシークレット	アップロードされていません

注記

あなたのビルドされたウェブアセット (JS、CSS、HTML) は、 npx cap sync がコピーしたものだけがアップロードされます。ウェブソースと依存性のインストールのステップはあなたのCIに残ります。準備されたネイティブプロジェクトはバイナリをビルドし、次にクリーンアップされます。

あなたの責任

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

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

What Capgo Build Handles

• Capacitorライブアップデートの代替案の比較ページ。ロール：長いマーケティングまたは法的文章。見つける：ページconsulting.astro。Capgo製品/ブランドと開発者用語を正確に保存する。
• Appflowの比較/移行マーケティングコピー。ロール：短いUIラベルまたはナビゲーションアイテム。見つける：ページionic-appflow.astro、ページionic-enterprise-plugins.astro、ページsolutions/ionic-enterprise-plugins.astro。メッセージキー：appflow_plugins_or (Appflow Plugins Or)。
• 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ストアの設定
• トラブルシューティング - 一般的な問題と解決策
• CLI リファレンス - コマンドの完全なドキュメント

必要な支援

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