メインコンテンツへスキップ

MacなしでCapacitorのiOS開発:できること・できないこと

Windows/Linuxチームのための明快な回答: iOS開発でmacOSが必要なタスクと不要なタスク、証明書の取得方法、XcodeなしでのTestFlightおよびApp Storeリリース、そしてCapgo BuildとLive Updatesの位置づけ。

Capacitor MacなしでiOS開発するFAQ Capgo ブログイラスト

毎週のように、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つの方法:

  1. Macを購入する。 シンプルですが、AppleがXcodeの最低バージョンを引き上げるたびに更新が必要です。2026年4月以降はXcode 26となり、最新のmacOSが必須です。
  2. クラウドでMacをレンタルする。 完全な制御が可能ですが、メンテナンスの負担も完全です。ビルドの有無にかかわらず時間課金されます。
  3. ビルドサービスを利用する。 プロジェクトを送信すると、署名済み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やLinuxでのCapacitorは、デザイン、code、Android、証明書、TestFlight、App Storeへの申請までカバーします。コンパイルのみがApple環境を必要としますが、それはCapgo Buildが処理します。WebレイヤーにLive Updatesを使用すれば、Macを持たないチームでもAndroidと同じペースでiOSをリリースできます。

Capacitor アプリ向けの Live Updates

Web レイヤーのバグが本番で発生したら、App Store の審査を何日も待たずに Capgo で修正を配信しましょう。ネイティブの変更は通常の審査フローに残したまま、ユーザーはバックグラウンドでアップデートを受け取れます。

最新のブログ記事

Capgoは、真にプロフェッショナルなモバイルアプリを作るために必要な最高のインサイトを提供します。