CI/CD

Flutter 3.47 iOS CIでMacが必須の作業は?2026年ガイド

iOS向けCIを動かしているのに、Dartの検査までMacへ移すべきか判断できない。

結論:Flutter 3.47 iOS CIでは、Dartの汎用検査やiOS以外の作業は条件に応じて既存環境に残し、iOSツールチェーン、iOS Simulator、署名・公開に関わる工程をmacOSノードへ割り当てます。先にタスクを分け、継続稼働する遠隔Macが本当に必要かを決めてください。

Flutter開発者:開発環境を維持しながら、iOSビルドと公開を行いたい方。
CIエンジニア:プラットフォーム別に処理を分け、実行先を検証したい方。
基盤担当者:macOSビルドノードの追加やレンタルを検討している方。

コミット時のコード品質検査

プロジェクトがiOS向けでも、すべての検査がAppleのツールチェーンを必要とするわけではありません。Dartの書式確認、静的解析、依存関係の検査、プラットフォーム固有機能を使わない単体テストは、Flutter SDKなどの要件を満たす既存のLinux環境で実行できる場合があります。Flutterのテストの種類に関する公式説明に照らし、テストが実際に何を呼び出すかを確認してください。

FlutterのDartテストはLinux CIで実行できますか。
Dartだけで完結し、iOS SDKやシミュレーター、ネイティブプラグインの実行に依存しないテストなら、Linuxノードに置けます。ただし、iOSプラットフォームの実装をロードするテストや、Appleのビルド工程を含む検証までLinuxで完了すると判断してはいけません。Flutterの対応プラットフォーム一覧では、開発対象ごとに公式の対応環境が示されています。

作業場面 既存のLinuxノードに置ける条件 macOSノードへ割り当てる条件
Dart書式・静的解析 Dart/Flutterの検査で完結する 同じジョブ内でiOSビルドも実行する
単体テスト iOSネイティブ機能を呼ばない iOS実装やAppleツールに依存する
Android・Web向け処理 対象プラットフォームの要件を満たす iOS向け成果物と同じ工程にまとめる必要がある
iOSアプリのビルド 該当しない macOSとXcodeを使うiOS工程

依存パッケージの取得が成功しただけでは、iOS向けのビルドやネイティブ連携まで検証できた証拠にはなりません。Flutterのプラグインテストの説明も確認し、共通ロジックの検査とプラットフォーム実装の検証を別ジョブとして設計します。

注意:ジョブを分ける場合も、同じコミット、依存関係のロックファイル、ビルド設定を対象にしているかを記録してください。別の入力を検査した結果を、同一リリースの証拠として扱わないためです。

iOSビルドとシミュレーター検証

Flutter 3.47の対象プラットフォームとリリース情報は、Flutter 3.47.0の公式リリースノートで確認できます。Flutter公式はiOS開発にmacOS環境を求めており、iOSセットアップ手順ではXcodeを含む前提条件を案内しています。したがって、iOS向けビルドとiOS Simulatorでの実行確認はmacOSの作業として計画します。

Flutter iOSシミュレーター向けのビルドにmacOSは必要ですか。
iOS Simulatorを使ったビルドや実行確認には、iOS向けのAppleツールチェーンが必要です。シミュレーター用のビルドが通ったことは、アプリがシミュレーター上で起動したことや、実機で正常に動作したことを意味しません。Flutterの統合テストの説明を参考に、確認した対象と結果を分けて記録してください。

検証段階 確認できること それだけでは確認できないこと
iOS向けコンパイル 対象設定でのビルド可否 起動後の画面・機能の動作
iOS Simulatorでの実行 シミュレーター上の起動や操作 実機固有の挙動、配布用署名の成立
実機テスト 対象デバイスでの動作確認 未確認の端末・構成での動作

シミュレーター用成果物と実機向け成果物は、検証目的を混同しないようジョブ名や保存記録で区別します。ノードの受け入れ時にも、公式のiOS向け環境条件を満たしているか確認してください。

署名・アーカイブ・公開の分担

iOSアプリの署名、アーカイブ、配布には、iOS向けのAppleツールチェーンを使う工程があります。FlutterのiOS公開ガイドと、Appleのベータテストおよびリリース向け配布資料を基準に、公開用成果物を作るジョブはmacOS側に分けてください。

CI工程 推奨する配置 確認する証拠
署名なしの共通検査 既存ノードを条件付きで利用 コミット、検査結果、依存関係
iOS向けビルドとアーカイブ macOS、Xcodeが利用できる環境 ビルド設定、アーカイブの生成結果
署名・配布 アクセスを限定したmacOSジョブ 使用した資格情報の範囲、処理記録、成果物

署名とアーカイブはどのようにCIで分けますか。
署名を必要としない検査・ビルドと、配布用資格情報を扱う署名・公開工程を分離します。資格情報を通常の検査ジョブへ渡さず、公開権限のあるジョブでのみ参照できる構成にし、アーカイブと処理記録を再確認可能な形で保管してください。具体的な署名方式や公開可否は、プロジェクトの設定とAppleの要件に基づいて確認し、CI構成だけで配布成功を保証するものとは扱いません。

注意:資格情報を保存する場所だけでなく、どのジョブが読み取れるか、ログや成果物に値が残らないかも確認対象です。シークレットの隔離状況を確認できない場合は、公開工程を有効化する前にアクセス境界を見直してください。

プラグインとネイティブコードの検証

iOSプラグインが存在することだけを理由に、すべてのFlutter検査をMacへ移す必要はありません。Dart側のロジック検査と、SwiftまたはObjective-Cの実装、iOSプロジェクト設定、プラットフォームチャンネルを含む統合検証を分けます。

プラグインのモックを使った単体テストは既存環境で実行できる場合がありますが、実際のiOS実装と接続した結果はmacOS側で確認します。モックで代替した範囲と実機能を検証した範囲を分けて記録してください。

変更内容 先に実行する検査 追加するiOS検証
Dartのみの共通ロジック 静的解析、単体テスト iOS成果物への影響がある場合にビルド
プラグイン利用箇所の変更 共通ロジックの検査 macOSでiOSビルド、必要に応じて実行
Swift・Objective-C・Xcode設定の変更 差分と依存関係の確認 macOSでコンパイルし、対象機能を検証

Android・Webとの並行実行

AndroidとWebのジョブは、それぞれのツール要件を満たすノードへ配置し、iOS専用の工程だけをmacOSへルーティングする構成が基本です。複数プラットフォームを一つのジョブに押し込むと、失敗時にどのツールチェーンが原因か見分けにくくなります。逆に、共通のDart検査までプラットフォーム別に複製すると、結果の不一致や保守対象の増加につながります。

まずコミット単位の共通検査を実行し、その結果を入力としてAndroid、Web、iOSの各ジョブを分けます。iOSジョブではXcode、シミュレーター、署名のどれを使ったかを明記し、CI製品固有の同時実行機能を前提にせず、実際のキュー設定とノードの利用条件を確認してください。

ノード境界の決定と受け入れ確認

macOSノードを追加するかは、対象プラットフォーム、ネイティブ依存、シミュレーターの必要性、署名担当、公開頻度で判断します。以下は、既存ノードを残す範囲とMacへ移す範囲を確定するためのチェック項目です。

  • [ ] Dartの書式確認、静的解析、依存関係検査をiOSツールなしで実行できるか確認する
  • [ ] テストがiOSネイティブ実装やプラットフォームチャンネルを呼ぶか分類する
  • [ ] iOS向けビルドとiOS Simulator実行をmacOSジョブとして分離する
  • [ ] 実機確認とシミュレーター確認を別の受け入れ結果として記録する
  • [ ] 署名・公開資格情報を通常の検査ジョブから隔離する
  • [ ] XcodeとFlutterの利用可否を、対象ジョブの実行結果で確認する
  • [ ] 代表的なiOSタスクの成果物、ログ、実行コミットを後から照合できるか確認する

遠隔Macを受け入れる際は、環境情報の表示だけで完了とせず、対象プロジェクトの代表的なiOSビルドが実行できるか、必要なシミュレーター検証が可能か、資格情報のアクセス範囲を確認できるかを記録します。KuzCloudのコンソールで確認できる情報と、実際の契約条件・利用可能な環境は分けて照合してください。利用条件を比較するときは、対象地域の料金案内も参照し、未確認の構成やビルド性能を前提にしないでください。

最終更新日:2026年10月2日。Flutter 3.47の対応状況とmacOS・Xcodeの前提条件は、Flutter公式のプラットフォーム情報、リリースノート、iOSセットアップ、公開ガイドに基づいて確認してください。公式ページは更新されるため、導入前にも最新の記載を照合します。

Dart検査を既存ノードに残し、iOSビルド、シミュレーター、署名・公開だけを分ければ、Macの追加範囲を限定できます。一方、自前Macの常時運用は、ハードウェア調達、保守、稼働管理、資格情報の管理が必要です。通常のLinuxノードだけではiOSツールチェーンを使えず、仮想環境などで代替する場合も、公式要件や検証対象との差を埋める必要があります。iOS工程だけに使う環境を継続運用する負担が大きい場合は、実際のタスクと受け入れ条件を決めたうえでKuzCloudのMacレンタルを比較すると、必要な工程に限定した構成を検討できます。

KuzCloudの専用Macで、iOS向けCIを始めませんか?

ビルドやシミュレーター検証、署名・公開など、macOSが必要な工程を専用ノードに集約できます。

物理専用のMac環境はroot権限付きで、必要な開発ツールやCI環境を自由に構成できます。