Build an iOS App from Windows with Capacitor and Capgo Build

Windows環境でiOSアプリを開発することは、通常、XcodeとmacOSを必要とすることを意味します。XcodeとmacOSは、WindowsまたはLinux環境でチームが全員がいる場合、またはMacを維持するためのビルドマシンを維持したくない場合に厄介な制約です。

の組み合わせ Capacitor と Capgo Build を使用すると、WindowsワークステーションからiOSビルドとTestFlightの提出が可能になります。

このガイドでは、チームで効果的に機能する実用的ワークフローを紹介します。

Windows環境で通常のWebプロジェクトのように開発します。
リポジトリに ios/ を保持します (ネイティブの状態が再現可能です)。
ローカルに cap sync を実行します (WebビルドがiOSプロジェクトにコピーされます)。
iOS クラウドビルドをトリガーするには Capgo ビルド。

何が実際に作成されるか

There are two separate “builds” in a Capacitor app:

ウェブビルド (あなたの JS/HTML/CSS): Windows上でこのように実行します。
ネイティブビルド (Xcodeアーカイブ、署名、アップロード): Capgo Windows上のMacハードウェアでクラウド内でこのビルドを行います。

Capgoでは、この分離が鍵です： Capgo Buildはネイティブプロジェクトをコンパイルしますが、既にウェブアセットを同期していることを前提としています。 ios/.

必要な環境

A working Capacitor app (any framework is fine).
Apple Developer アカウント。
App Store接続アクセス（テストフライト/アプリストア提出用）
あなたの Capgo アカウントと API トークン (CAPGO_TOKEN).

1) WindowsでCapacitorアプリを作成または準備する

すでにウェブアプリを持っている場合は、Capacitorステップに進みます。

Viteの例:

bun create vite@latest my-app
cd my-app
bun install

ビルドは静的アセットを生成する必要があります (Viteの場合はデフォルトで) dist/ 2) __CAPGO_KEEP_0__とiOSプラットフォームを追加する

bun run build

Capacitorをインストールする:

Capacitorを初期化し、iOSプラットフォームフォルダを作成する:

bun add @capacitor/core @capacitor/ios
bun add -d @capacitor/cli

この時点で、フォルダが作成されます。Gitにコミットする。__CAPGO_KEEP_0__ビルドは、その中に含まれるものをコンパイルするので、バージョン管理と再現性が必要です。

bunx cap init
bunx cap add ios

__CAPGO_KEEP_0__ ios/ Capgo ios/__CAPGO_KEEP_0__

3) iOSアプリケーションにWebアセットを常にSyncする

WindowsでWebアプリを変更するたびに、以下のシーケンスを実行してください。

bun run build
bunx cap sync ios

cap sync Capgoは、実際にコンパイルされるファイルを含むネイティブiOSプロジェクトに、ビルドされたWebアセットをコピーするものです。

4) CapgoとCLIをインストールして認証する

Capgoビルドは、Capgo CLIを介してトリガーされます。bunを使用して bunx:

bunx @capgo/cli@latest login

または、シェル/CIで環境変数を使用してトークンを設定します。

export CAPGO_TOKEN="your_api_key_here"

5) Cloudビルド用にiOSの署名を設定する

iOSビルドには署名資材が必要です。

Apple Distribution証明書 (.p12)とそのパスワード
プロビジョニングプロファイル (.mobileprovision)
App Store Connect APIキー (AuthKey_XXXXXX.p8)とメタデータ (キーID、発行者ID、チームID)

必要な場合は、Capgoドキュメントを参照してください。

資格情報の管理 (保存するものと保存しないもの)
iOS証明書とプロビジョニングプロファイルの取得方法

最も簡単な方法は、Macを使用して一度だけ作成/エクスポートし、Windowsで毎回使用することです。

Capgoビルドにファイルを保存したら

bunx @capgo/cli@latest build credentials save \
  --platform ios \
  --certificate ./cert.p12 \
  --p12-password "password" \
  --provisioning-profile ./profile.mobileprovision \
  --apple-key ./AuthKey.p8 \
  --apple-key-id "KEY123" \
  --apple-issuer-id "issuer-uuid" \
  --apple-team-id "team-id"

CI環境では、資格情報ファイルをbase64エンコードしてシークレットとして保存し、実行時にはデコードして実行することをお勧めします。 build credentials save 6) WindowsからiOSビルドをトリガーする

アプリフォルダから

実行中のログがターミナルに表示されます。App Store Connectキーの設定が完了している場合、__CAPGO_KEEP_0__ビルドは自動的にTestFlightにビルドを送信できます。

bun run build
bunx cap sync ios
bunx @capgo/cli@latest build com.example.app --platform ios --build-mode release

You will see real-time logs in your terminal. If your App Store Connect key is configured, Capgo Build can submit the resulting build to TestFlight automatically.

7) Iterate Fast: Live Updates for Web-Only Changes

Capgo Build is for native changes:

Capacitor を追加/削除する
changing native permissions
changing icons/splash
updating Capacitor
any Swift/Objective-C changes

Live Updates (OTA) により、毎回ネイティブバイナリを再構築する必要はありません。 A good team workflow is:

Live Updates を頻繁に使用します。

__CAPGO_KEEP_0__ Build is for native changes:
CapgoでCapgo Buildを時々使用してください。Nativeの変更が必要な場合に。

Windowsの一般的な落とし穴 (と修正)

UIの変更がiOSのビルドに表示されない場合 cap syncあなたはWebアプリをビルドしたが、CapacitorにSyncすることを忘れている可能性があります。 ios/.
コミットしない ios/Capgo BuildはNativeプロジェクトをコンパイルします。Gitにフォルダが含まれていない場合 (またはビルドのコンテキストに含まれていない場合)、ビルドはあなたのアプリを再現できません。
Nativeの再構築なしでプラグインの変更プラグインを追加することはNativeの変更です。Capgo Buildの実行 (およびストアの提出) を計画してください。

概要

WindowsではXcodeを実行することはできませんが、 iOSアプリをWindowsから配信することはできます。 Capacitorを使用してWindowsからiOSアプリをビルドする方法

WebアプリをCapacitor (ios/ リポジトリ内に)に Wrap
Webアセットをローカルでビルドし、次に__CAPGO_KEEP_0__ Buildを使用してiOSバイナリをコンパイル、署名、提出 cap sync.
Build an iOS App from Windows with Capgo and CLI Build