結論：Xcode 27.2 RCのシミュレータランタイムは、接続可能なMacでApple公式のxcodebuild手順を使って取得し、対象Macへ転送して読み込めます。ただし、対象Xcodeで認識されることと、プロジェクトのテストが通ることを確認するまでは、CI対応完了と判断できません。AppleのXcode 27.2 RC公開情報も参照してください。
ネットワーク制限のあるmacOS Runnerを運用するCI担当者向けです。
複数台のMacでビルド環境を管理する担当者が、ランタイムの配布と照合を進めるための手順をまとめます。
遠隔のMacでiOSシミュレーターを使う開発者は、プロジェクト単位の受け入れ確認に活用できます。
最終更新：2026年10月29日。AppleのXcode公開情報、リリースノート、システム要件、コンポーネント関連資料を照合しています。Xcodeやランタイムの提供状況は更新されるため、作業当日にも確認してください。
まず、止まっている原因を切り分けます
オフライン導入が有効なのは、必要なiOSシミュレーターランタイムを対象Macがネットワーク経由で取得できない場合です。ランタイムが未導入なのか、転送や読み込みに失敗しているのか、それともプロジェクト側の設定・テストに問題があるのかを先に分けます。
AppleはXcodeの追加コンポーネントを取得・読み込む方法を案内していますが、オフラインパッケージを渡しただけで、対象Xcodeとの適合やプロジェクトの実行まで保証されるわけではありません。コンポーネントのダウンロードとインストールに関する公式手順を確認し、導入後の検証までを作業範囲に含めます。
個人開発者は、まずプロジェクトが要求するプラットフォームと、手元で選択中のXcodeを確認してください。プロジェクト自体が別のビルドエラーで止まっている場合、ランタイムを追加しても原因は解消しません。
CI担当者は取得元と対象Runnerを分けて準備します
接続可能なMacでは、対象Xcodeを選択したうえで、Appleの案内に従ってプラットフォームをダウンロードし、書き出します。コマンドのオプションや取得できるプラットフォームは環境によって確認が必要です。実行時はAppleのコマンドラインツール資料と、そのMacでのxcodebuild -helpを照合してください。
xcodebuild -downloadPlatform iOS -exportPath <保存先>
対象Macでは、インポート前に使うXcodeを明示します。下記のアプリケーションパスは環境に合わせて置き換えます。複数のXcodeをインストールしている環境では、どれが選ばれているか曖昧なまま作業しないでください。
sudo xcode-select -s <対象Xcode.appのパス>
xcodebuild -importPlatform <転送したパッケージのパス>
コマンドの受け付け方やファイルの扱いに差がある場合は、作業時点の公式資料とコマンドヘルプを優先します。導入後は、まずXcodeの選択状態とランタイムの列挙結果を確認し、その後にプロジェクトのビルドまたはテストへ進みます。
転送したパッケージのファイル名や配置先だけで、導入が成功したとは判断できません。未確認のパッケージを本番Runnerへ展開せず、読み込み結果とプロジェクトのテスト結果を記録してから利用します。
複数台への展開では「共通キャッシュ」と決めつけません
ダウンロード済みパッケージを使えば、各Runnerがそれぞれコンポーネントを取得する作業を避けられる場合があります。ただし、これはXcodeの異なるバージョン間で常に使い回せる共通キャッシュという意味ではありません。Appleの追加シミュレーターに関する説明と、対象Xcodeでの実際の認識結果を合わせて確認してください。
複数のXcodeを管理するチームは、SDK、シミュレーターランタイム、シミュレーター上のデバイスを別々の要素として扱います。ディレクトリにファイルがあることやSDKが見えることだけでは、テスト用デバイスまで準備できたとは限りません。Xcodeの選択状態とランタイムの利用可否を各ホストで確かめます。
| 確認対象 | 対象Macで行うこと | 次へ進める条件 |
|---|---|---|
| 選択中のXcode | xcodebuild -versionとxcode-select -pを確認 |
想定したXcodeが選択されている |
| ランタイム | xcrun simctl list runtimesを確認 |
対象ランタイムが利用可能な状態で表示される |
| シミュレーター | xcrun simctl list devices availableを確認 |
プロジェクトが使うデバイスが列挙される |
| プロジェクト | CIと同じ設定でビルドまたはテストを実行 | 対象の処理が完了し、ログを保存できる |
Xcodeのシステム要件もホストごとに確認します。AppleのXcodeシステム要件は、対象MacのOSとXcodeの組み合わせを確認する基準になります。ランタイムの導入可否だけを見て、システム要件の確認を省かないでください。
運用担当者は導入記録と失敗時の切り分けを残します
複数台へ広げる前に、取得元、パッケージの管理場所、対象Xcode、読み込み結果、検証したプロジェクトを環境変更記録に残します。パッケージの受け渡し経路やインストール権限も、組織のホスト管理手順に合わせます。
一覧にランタイムが出ないときは、パッケージの読み込み状態と選択中のXcodeを分けて確認します。ランタイムが見えても指定デバイスがない場合は、デバイス一覧とプロジェクトの指定を確認します。シミュレーターが起動してもテストに失敗する場合は、失敗ログを保存し、ランタイム導入の問題とアプリ側の問題を切り分けます。Appleのシミュレーターまたは実機でアプリを実行する説明も照合してください。
導入を進める前の確認項目
- [ ] プロジェクトが必要とするプラットフォームとテスト対象を確認した
- [ ] 接続可能なMacと対象Runnerで、使用するXcodeをそれぞれ確認した
- [ ]
xcodebuild -helpとAppleの資料で、取得・書き出し・読み込み方法を照合した - [ ] 転送したパッケージを対象MacのXcodeで読み込んだ
- [ ] ランタイム一覧と利用可能なシミュレーターデバイスを確認した
- [ ] CIと同じプロジェクト設定でビルドまたはテストを実行し、ログを保存した
どれか一つでも未確認なら、本番Runnerへ展開せず、その項目を満たしてから受け入れ判定を行います。
手段ごとの適用範囲を見比べます
| 方法 | 向いている状況 | 注意点 |
|---|---|---|
| 対象Macから直接取得 | Runnerが必要な配布先へ接続できる | ホストごとの取得可否と導入結果を確認する |
| 接続可能なMacで取得して転送 | 対象Runnerのネットワーク制限が強い | 転送後に対象Xcodeで読み込みと実行確認が必要 |
| 既存ランタイムをそのまま利用 | すでに対象Xcodeとプロジェクトで検証済み | 別Xcodeや別ホストにも適合すると決めつけない |
この比較で重要なのは、取得経路ではなく受け入れ条件です。CIの各ホストで同じランタイムが認識され、プロジェクトが必要とするデバイスを使って処理できることを確認してください。遠隔Macの構成や開発環境については、DebugMacのガイドも参考になります。
よくある疑問
Xcode 27.2 RC向けのiOSシミュレータランタイムはどう取得しますか？
接続可能なMacで対象Xcodeを選び、Appleの案内に沿ってxcodebuildのプラットフォームダウンロード機能を利用します。取得できるプラットフォームは固定とみなさず、作業時点のコマンドヘルプと公式資料で確認します。
インターネットに接続できないMacへランタイムを入れるには？
別のMacで取得・書き出しを行い、許可された経路でパッケージを対象Macへ転送してから読み込みます。ファイルを置くだけでは完了ではありません。対象Xcodeでの認識、デバイスの列挙、プロジェクトのテストを確認します。
異なるバージョンのXcodeで同じランタイムを使えますか？
常に使えるとは限りません。対象Macで選択されているXcodeを確認し、そのバージョンがランタイムを認識するかを実際に調べます。未検証の組み合わせはCIへ展開しないでください。
ランタイムがCIで使える状態か、どう確認しますか？
ランタイム一覧に表示されることに加え、利用可能なデバイスが列挙されることを確認します。そのうえでCIと同じプロジェクト設定を使い、ビルドまたはテストを実行します。結果と失敗ログを環境変更記録に残すと、後から原因を追えます。
継続運用が必要ならMac環境も選択肢に入れます
ローカルMacだけで検証すると、その端末の停止や環境変更がCIの再現性に影響することがあります。Linux RunnerではXcodeを使う処理を完結できず、Macを購入して増設する場合は機器の調達や保守も必要です。こうした制約が継続的な負担になるなら、対象Xcodeとプロジェクトの受け入れ条件を固めたうえで、遠隔のMac環境を使う方法も比較できます。
一方、長期にわたり高負荷で使い続ける場合や、手元の物理インターフェースが必須の場合は、自社管理のMacが適することもあります。短期の検証やRunner増設など、必要な期間だけmacOS環境を用意したい場合は、DebugMacのMac環境を確認し、接続方法と利用条件が要件に合うかを見比べてください。Xcodeの選択確認からプロジェクトテストまで完了して初めて、オフライン導入をCIで使える状態と判断できます。
よくある質問
Xcode 27.2 RC向けのiOSシミュレータランタイムはどう取得しますか？
ネットワークに接続できるMacで対象のXcodeを選び、Appleの案内に沿ってxcodebuildのプラットフォームダウンロード機能を使います。取得できるプラットフォームやランタイムは変更される可能性があるため、実行前に現在のXcodeコマンドヘルプとAppleのコンポーネント案内を確認してください。
インターネットに接続できないMacへランタイムを入れるには？
接続可能なMacでランタイムを取得して書き出し、許可された転送経路で対象Macへ渡してから、対象側のXcodeで読み込みます。ファイルをコピーしただけではインストール完了とは判断できません。読み込み後にランタイム一覧と利用可能なシミュレーターを確認し、プロジェクトを実行して受け入れ判定を行います。
異なるバージョンのXcodeで同じシミュレータランタイムを使えますか？
一律に共用できるとは判断しないでください。読み込み先で選択されているXcodeと、そのXcodeが対象ランタイムを認識し利用できるかを確認します。複数のXcodeを運用している場合は、Xcodeの選択状態、ランタイム一覧、利用するデバイスの可否を組み合わせて確かめ、未確認の組み合わせをCIへ展開しないことが重要です。
シミュレータランタイムがCIで使える状態か、どう確認しますか？
ランタイムが一覧に表示されることだけで完了とはしません。対象Xcodeの選択を確認し、利用可能なシミュレーターが列挙されること、さらにCIと同じスキームやテスト対象でビルドまたはテストが通ることを確認します。失敗した場合は、読み込み状態、Xcodeの選択、デバイス指定を分けて調べ、ログを残します。
シミュレータ環境の検証に、専有のクラウドMacを
DebugMacでは、Mac mini M4の専有物理ノードを利用して、シミュレータランタイムの導入やビルドの検証を進められます。