メインコンテンツへスキップ
Capgo - Capacitor アプリのビルド、リリース、アップデート Capgo

スタートガイド

Capgo Cloud Build を使って、iOS または Android の Native Build を数分で作成しましょう。

必要なもの

「事前準備」セクション

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

  • ローカルで正常にビルドできる Capacitor アプリ
  • Node.js 20 以上がインストールされていること
  • Capgo アカウント（無料トライアルで開始可能です）
  • アプリはすでに Capgo に登録されています（実行してください： 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 ビルド対象に合わせて設定してください：

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

CLI は、準備されたネイティブプロジェクトをアップロードし、ビルドログをターミナルにリアルタイムでストリーミングします。Capgo Buildは、署名済みアーティファクトを返却するか、適切なリリースフローを設定することでApp Store ConnectやGoogle Playへ直接送信することも可能です。

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

「ビルドプロセスの理解」セクション

ビルドコマンドを実行すると、以下のプロセスが行われます：

  1. CIでの準備 - Webレイヤーをビルドし、プライベートな依存関係を解決して、完了したアセットをネイティブプロジェクトに同期します。
  2. アップロード - 準備されたネイティブプロジェクトは、ビルド用に安全なクラウドストレージへアップロードされます。
  3. ビルドの実行 - Capgo は専用インフラ上でネイティブプロジェクトをコンパイルし、署名します。
  4. ログストリーミング - リアルタイムのログが Server-Sent Events 経由でターミナルにストリーミングされます。
  5. クリーンアップ - ビルド後、ビルド環境と一時的なプロジェクトデータはクリーンアップされます。出力の保持期間は、選択したアーティファクトとストア配信オプションによって異なります。

Bitriseや他のCIで Capgo Build を使用する

「Bitrise または他の CI で Capgo Build を使用する」というセクション

Capgo Build は既存の CI を置き換えるものではありません。プライベートアクセスが必要なステップは Bitrise や他の CI システムに残してください：プライベートレジストリからのインストール、SSH 経由のプライベート CocoaPods の解決、カスタムネイティブセットアップの実行、Web レイヤーのビルド、そして実行 npx cap sync.

その後、準備したネイティブプロジェクトで Capgo Build を呼び出します。Capgo は準備済みの ios/ または android/ コンパイルと署名用のプロジェクトです。そのため、プライベートNexus、CocoaPods SSH、web-buildの認証情報は不要です。コンパイル済みのWebアセットは準備済みのネイティブプロジェクト内にあり、ソースリポジトリとして保持されずビルドに使用されます。

ビルド対象

「ビルドされるもの」セクション

Capgo Buildは、アプリのコンパイルに必要な準備済みのネイティブプロジェクトを受け取ります。Webソースのcode、プライベート依存関係のインストール、Capacitor同期は、引き続きお客様のCI内で行われます。

アップロード対象

「アップロードされるもの」セクション
込み説明
ios/ または android/ビルド対象のネイティブプラットフォームフォルダ
package.json, package-lock.json依存関係マニフェスト
capacitor.config.*Capacitor の設定
resources/アプリアイコン、スプラッシュ画面
ネイティブプラグイン code〜のみ ios/ または android/ 各 Capacitor プラグインのサブフォルダ

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

「アップロードされないもの」セクション
除外理由
node_modules/ (その大部分)ネイティブプラグイン code のみが含まれ、JS の依存関係は含まれません
src/Webソース code はローカルに留まります
dist/, www/, build/ (ルート直下)以下経由でネイティブフォルダに同期済み： cap sync
.git/バージョン管理履歴
.gradle/, .idea/, .swiftpm/ビルドキャッシュとIDE設定
.env、シークレットアップロードされません

あなたの責任範囲

「開発者の責任範囲」セクション

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

  1. CI環境での準備 - Bitriseや既存のCIで、プライベートパッケージレジストリ、SSHベースのCocoaPods、デバイスSDK、拡張機能、およびカスタムのNative Build準備を完了させてください。
  2. Webアセットをビルド - 実行 npm run build (または使用しているフレームワークのbuildコマンド)。
  3. ネイティブへの同期 - 実行 npx cap sync コンパイル済みのWebアセットを、準備されたネイティブプロジェクトにコピーします。
  4. Native Buildのリクエスト - 準備した ios/ または android/ プロジェクトを Capgo Build に渡します。

Capgo Build が処理する内容

「Capgo Build の処理内容」セクション
  • iOS ネイティブコンパイル (Xcode, Fastlane)
  • Android ネイティブコンパイル (Gradle)
  • 自分の認証情報を使った Code 署名
  • 任意：App Store Connect または Google Play への申請
  • サポートされているネイティブビルド設定と、環境変数として渡される認証情報の値

CI でネイティブプロジェクトの準備が完了していれば、Capgo Build がプライベート Nexus レジストリや SSH 認証情報にアクセスする必要はありません。詳細は ビルド設定 サポートされている環境変数とストアオプションを参照してください。

MDM経由で配布するキオスク用フレーバーの場合、Androidプロジェクト/ビルドの設定をAPKを生成するように構成してください。ビルドをリクエストする際は、以下の2つのフラグを使用してGoogle Playをスキップし、署名済み出力ファイルを取得します：

ターミナル
npx @capgo/cli@latest build request YOUR_APP_ID --platform android --no-playstore-upload --output-upload

--no-playstore-upload Playの認証情報が保存されていても、Play Storeへのuploadを防止します。 --output-upload 署名済み出力ファイルへの有効期限付きリンクを提供します。そのAPKをMDM経由で配布してください。

次のステップ

「次のステップ」セクション

最初のビルドが完了したら：

ヘルプが必要ですか？

「お困りですか？」セクション