WindowsまたはLinuxマシンからiOSをテストするポイントは1つ: iOS SimulatorとSafari Web InspectorはmacOS専用であること。それ以外はすべて対応可能。このガイドでは、Macなしで動作するテストの段階をブラウザから実機iPhoneまで示し、どこで Capgo のビルド と Live Update 待ち時間を削減できるかを示します。
テストの段階
| レベル | テスト対象 | 実行場所 | Macが必要か |
|---|---|---|---|
| 1 | Webレイヤー: ロジック、レイアウト、レスポンシブデザイン | iPhoneビューポートのデスクトップブラウザ | いいえ |
| 2 | Capacitor プラグイン、ネイティブブリッジ、権限 | Androidエミュレーターまたは実機 | いいえ |
| 3 | iOSの実挙動:WebKitの癖、セーフエリア、キーボード、プッシュ通知、iOSプラグイン | TestFlight経由のiPhone | いいえ、Capgo Buildで可能 |
| 4 | 特定デバイス向けのAd hoc QAビルド | Ad Hoc IPA経由のiPhone | いいえ、Capgo Buildで可能 |
| 5 | Xcodeでのステップ実行によるネイティブデバッグ | Mac | はい |
ほとんどのバグはレベル1と2で見つかります。レベル3はiOS特有のバグを捕捉します。レベル5はCapacitorアプリでは稀で、発生したとしてもMacを1時間レンタルする方が購入より安く済みます。
レベル 1: iPhoneビューポートのブラウザ
ChromeやEdgeで開発サーバーを開き、デバイスエミュレーションをオンにしてiPhoneのプロファイルを選択します。Capacitor はプラットフォーム情報を公開しているので、UIを分岐できます:
import { Capacitor } from '@capacitor/core';
if (Capacitor.getPlatform() === 'ios') {
// iOS-only behavior
}
これで検知できないもの: WebKitのレンダリングの違い、セーフエリアのインセット、iOSキーボードによるビューポートの押し上げ、そしてネイティブプラグインが絡む挙動すべて。
レベル 2: Webレイヤーが共通なので、まずAndroidから
Capacitor は両方のプラットフォームで同じWeb bundleを実行します。プラグインの接続、権限プロンプト、ブリッジ呼び出しは、WindowsやLinuxからChrome DevToolsを使ってAndroid上で検証できます: chrome://inspect。Androidでプラグイン呼び出しが動けば、JavaScript側は正しいということです。残るのはiOSのネイティブ実装だけで、それはレベル3でテストします。
レベル3: TestFlight経由の実機iPhone
Mac なしで iOS をテストする主な方法です。フロー:
- iOSプロジェクトをローカルで生成・同期します。
- App Store Connectの認証情報を保存してクラウドビルドをリクエストします。
- iPhoneでTestFlightを開きます。
bun run build
bunx cap sync ios
bunx @capgo/cli@latest build request com.example.app --platform ios --build-mode release
Capgo はmacOS上でアプリのコンパイルと署名を行い、App Store Connectへアップロードします。Appleがビルドを処理すると、数分以内にTestFlightの内部テスターに表示されます。内部テスター(App Store Connectチームのメンバー)はBeta App Reviewが不要なため、初回インストールがすぐに完了します。
認証情報のセットアップは一度だけで済みます。 bunx @capgo/cli@latest build init --platform ios これに従えば、OpenSSLなどを使ってMacがなくても証明書を作成できます。 iOS証明書ジェネレーター.
実機で確認できること:本物のWebKit、セーフエリア、キーボード、プッシュ通知、そしてプラグインの挙動。これらはブラウザでは検証できない要素です。
レベル4:指定デバイス向けのAd Hocビルド
テスターがApp Store Connectのチーム外にいる場合や、Appleの処理をスキップしたい場合は、デバイスのUDIDを登録したAd Hocプロファイルを使用します:
bunx @capgo/cli@latest build request com.example.app \
--platform ios \
--ios-distribution ad_hoc \
--output-upload \
--output-record build.json
CLI は、IPAの有効期限付きダウンロードリンクとQR code を返します。保持期間は1時間から7日まで、以下で設定できます: --output-retentionAd HocプロファイルにはApp Store Connectの API キーは不要で、証明書とプロファイルだけが必要です。
WindowsやLinuxからテスターのUDIDを取得するには、iPhoneの「設定」>「一般」>「情報」を開いて該当項目を確認してもらうか、UDID取得用のWebツールを使ってもらいましょう。取得したらAppleのポータルにデバイスを追加し、プロファイルを再生成します。
ビルドし直さずに改善を繰り返す: Live Updates
TestFlightのビルドをインストールした後は、変更のたびに再ビルドする必要はありません。代わりにWeb bundleをプッシュしてください:
bun run build
bunx @capgo/cli@latest bundle upload --channel beta
テスターは、 beta channel経由で次回のアプリ起動時に新しいbundleを受け取ります。WindowsやLinuxを使うチームにとって、これでiOSのフィードバックループは「クラウドビルドとApple側の処理待ち」から「数秒」になります。ネイティブの再ビルドが必要になるのは、プラグイン、権限、または Capacitor のバージョンが変わったときだけです。
TestFlightのビルドは専用のchannelに向けておき、ベータテスターが本番用のbundleを取得しないようにしましょう。 channelガイド で設定方法を説明しています。
Safari Web InspectorなしでiOSをデバッグする
SafariのインスペクタはmacOSからしか接続できません。どのOSでも使える代替手段:
- リモートのシンクへの構造化ログ。 送信
console.errorまた、エラーをSentryなどのツールにブリッジします。これにより、 Firebase Crashlyticsを使ったCapacitorガイド ネイティブのSDKセットアップについて解説します。 - アプリ内デバッグパネル。 ジェスチャーで切り替える非表示ビューに、直近N行のログを表示します。TestFlightビルドでは手軽で効果的です。
- ビルドログ。 ネイティブのコンパイル問題は、ターミナルにストリーミングされるCapgoのビルドログに表示されます。さらに、
--ai-analyticsビルド失敗の原因が自動的に説明されるようにします。 - Androidで再現する。 共有ウェブレイヤーに関するものであれば、Android上のChrome DevToolsでフル機能のデバッガーが使えます。
Xcodeのデバッガーが必要な真のネイティブクラッシュについては、Macを1時間レンタルするか、チームメイトに頼んでください。Capacitorアプリではそのようなケースは稀で、ほとんどの問題はウェブレイヤーかプラグインの設定にあります。
現実的な週次ワークフロー
- 毎日: WindowsまたはLinuxから、ブラウザとAndroidデバイスを使えます。Live Updatesを
betaiPhoneテスター向けのチャンネルへ。 - ネイティブの変更が入ったら: 1回のCapgo BuildでTestFlightへ。数分待つだけで、Macは不要。
- リリース: App Store配布用のCapgo Buildを実行し、その後bundleチャンネルを昇格させます。
まとめ
WindowsやLinuxでiOSをシミュレートすることはできませんが、MacなしでiPhoneの実機テストは可能です。Capgo Buildなら、コマンド1つで署名済みアプリをTestFlightやAd Hocリンクへ届けられ、インストール後もLive Updatesでイテレーションを高速に回せます。Macは、まれなネイティブデバッグのときだけ使いましょう。