毎週のように、Capacitor アプリをWindowsやLinuxからiOS向けにビルド、テスト、リリースできるかどうかの質問を受けます。正直なところ、例外がいくつかあるものの、ほぼすべて可能です。このページは、各タスクがmacOSを必要とするかどうか、そして代替手段をまとめたリファレンスです。
全タスク一覧
| タスク | macOSは必須? | WindowsまたはLinuxからの実行方法 |
|---|---|---|
| アプリの作成とブラウザでの実行 | いいえ | エディタ・OSは自由 |
| Apple Developer Programへの登録 | いいえ | ブラウザ |
| App ID と App Store Connect レコードを作成 | いいえ | ブラウザ |
| 配布用証明書 | いいえ | OpenSSL または 証明書ジェネレーター |
| プロビジョニングプロファイル | いいえ | Apple Developer ポータル |
| App Store Connect API キー | いいえ | App Store Connect ウェブサイト |
cap add ios, cap sync ios |
いいえ | Capacitor CLI では、CocoaPods の警告が表示されます |
| IPA をコンパイルして署名する | はい | Capgo のビルド クラウドで Xcode を実行します |
| TestFlight にアップロード | はい、通常は | Capgo Build は API キーでアップロードされます |
| App Store レビューに提出 | いいえ | App Store Connect ウェブサイト |
| iPhone にインストールしてテスト | いいえ | TestFlightアプリ、またはad hoc IPAリンク |
| リリース後のアップデート配信 | いいえ | Capgo Live Update |
| iOS シミュレーター | はい | 代用不可。実機のiPhoneを使用してください |
| iOS上のSafari Web Inspector | はい | リモートログ、共有Webレイヤー用のAndroid版Chrome DevTools |
| ネイティブクラッシュ用のXcodeデバッガ | はい | 必要なときにMacを時間単位でレンタル |
編集 Info.plist, エンタイトルメント、アイコン |
いいえ | プレーンテキストと画像ファイルを ios/ |
| ネイティブiOS code を備えた Capacitor プラグインを追加 | いいえ | インストール、 cap sync ios, クラウドビルド |
| カスタムSwift code を書く | 部分的に | 任意のエディタで編集。コンパイルエラーはクラウドビルドのログに表示されます |
なぜコンパイルにmacOSが必要なのか
AppleはiOSのSDKを xcodebuild と codesign macOS向けにのみ提供しており、ライセンスもAppleハードウェアに紐付けられています。ストア承認済みのIPAを生成できる、サポートされているLinuxやWindowsのツールチェーンは存在しません。LinuxからiOSをクロスコンパイルするプロジェクトは研究目的で存在しますが、署名が施されておらず、App Store Connectでは承認されません。そのため、機能する「Macなし」ワークフローはすべて、コンパイルという1ステップだけmacOSマシンに移行します。
そのマシンを手に入れる3つの方法:
- Macを購入する。 シンプルですが、AppleがXcodeの最低バージョンを引き上げるたびに更新が必要です。2026年4月以降はXcode 26となり、最新のmacOSが必須です。
- クラウドでMacをレンタルする。 完全な制御が可能ですが、メンテナンスの負担も完全です。ビルドの有無にかかわらず時間課金されます。
- ビルドサービスを利用する。 プロジェクトを送信すると、署名済みIPAが返却され、またはアップロードされます。Capgo Buildはこの選択肢であり、最新のXcodeでメンテナンスされているため、Appleの期限はあなたの問題ではありません。
Macを使わない最小限のワークフロー
# once
bunx cap add ios
bunx @capgo/cli@latest build init --platform ios
# every native release
bun run build
bunx cap sync ios
bunx @capgo/cli@latest build request com.example.app --platform ios --build-mode release
# every web-only change
bunx @capgo/cli@latest bundle upload --channel production
最初のブロックはプロジェクトを生成し、署名認証情報を保存します。2つ目は署名済みビルドを生成してTestFlightに送信します。3つ目はWeb変更時にNative Buildを完全にスキップします。
詳細なチュートリアル: Windowsから と Linuxから.
Keychain Accessを使わない証明書管理
多くの人が身構える部分です。実際にはOpenSSLコマンド3つとブラウザページ2つで済みます:
openssl genrsa -out ios_distribution.key 2048
openssl req -new -key ios_distribution.key -out ios_distribution.csr -subj "/emailAddress=you@example.com/CN=Your Name/C=US"
# upload the CSR in the Apple Developer portal, download distribution.cer
openssl x509 -in distribution.cer -inform DER -out distribution.pem -outform PEM
openssl pkcs12 -export -inkey ios_distribution.key -in distribution.pem -out ios_distribution.p12 -legacy
その後、ポータルでApp Store用プロビジョニングプロファイルを作成し、App Store ConnectでAPIキーを作成します。 iOS証明書とプロビジョニングプロファイルの解説 すべてのタイプとエラーを解説しています。
Simulatorを使わないテスト方法
実機のiPhoneを使用してください。クラウドビルド完了の数分後にはTestFlightにビルドが届き、内部テスターはBeta App Reviewをスキップできます。チーム外のデバイス向けには、次でad hocビルドをリクエストしてください: --ios-distribution ad_hoc --output-upload してリンクを共有します。 テストガイド Safariなしでデバッグする方法を含む、全プロセスを網羅しています。
Native code とプラグイン
コミュニティプラグインの追加は bun add と cap sync iosです。Swiftのcodeはクラウドでコンパイルされます。カスタムプラグイン用のSwiftを自分で書くことも、どのエディタからでも可能です。オートコンプリートや即座のコンパイルフィードバックは失われますが、実用的なアプローチはネイティブ部分を小さく保ち、デバッグ用のクラウドビルドで早期にコンパイルし、ストリーミングされたXcodeログからエラーを読むことです。 --ai-analytics 失敗したビルドを、わかりやすい言葉で診断します。
Macのレンタルが適しているケース
- ログだけでは原因が特定できないネイティブクラッシュで、Xcodeデバッガが必要な場合。
- 毎日Swiftで開発を繰り返しているプラグイン開発者。
- App Storeへの初回セットアップで、Xcodeの署名UIを一度見て仕組みを理解したい場合。
これらは一般的なCapacitorチームにとって毎週発生するようなものではありません。発生時にMacを1時間レンタルする方が、開発者ごとにMacを用意するより安上がりです。
関連するセットアップガイド
- WindowsでのCapacitor開発
- LinuxでのCapacitor開発
- WindowsでWSL2を使ったCapacitor
- WindowsとLinuxからのAndroidライブリロード
- Android StudioなしのAndroidリリースビルド
まとめ
WindowsやLinuxでのCapacitorは、デザイン、code、Android、証明書、TestFlight、App Storeへの申請までカバーします。コンパイルのみがApple環境を必要としますが、それはCapgo Buildが処理します。WebレイヤーにLive Updatesを使用すれば、Macを持たないチームでもAndroidと同じペースでiOSをリリースできます。