プレビュー画面が空白、または読み込み中のまま止まっていますか。
まずCanvasが開いているか、画面はあるのに内容が出ないのか、構築エラーなのかを分けてください。現在のファイル、プレビュー宣言、プロジェクトの構築状態を順に確認します。表示されなくても、すぐにXcodeを再インストールする必要はありません。
対象： Xcode 27.2 RCでSwiftUIを学び始め、プレビューの異常に初めて遭遇した学生向けです。
WindowsからリモートMacを使う場合も、プロジェクト側か利用環境側かを切り分けられます。
構築はできるのにプレビューだけ動かない場合の、課題確認方法も扱います。
最終更新：2026年10月24日。確認対象はAppleのXcodeシステム要件、SwiftUIプレビューの操作説明、Xcode 27リリースノートです。RCの公開状況やシステム要件は変わる可能性があるため、実際の作業時にも公式情報を確認してください。
Canvasが見えない場合と、プレビューが空白の場合
最初に見るのは、コードの内容ではなく画面の状態です。コードを書く場所がエディター、SwiftUIの表示確認をする領域がCanvas、その領域で動く画面がプレビューです。Canvasが閉じている状態と、開いているのに内容がない状態は、別の問題として扱います。
AppleのCanvas操作ガイドを見ながら、エディターのメニューやツールバーからCanvasを表示してください。メニュー名や配置は、Xcodeのバージョンや表示言語によって異なる場合があります。画面のどこにもCanvasが出ていないなら、まず表示操作を確認します。
Canvasが開いたら、次の項目をチェックします。
- [ ] コードエディターの横にプレビュー領域が表示されている
- [ ] 現在選んでいるファイルが、画面を作るSwiftUIのファイルである
- [ ] プレビュー領域に読み込み中、エラー、空白のどれが出ているか記録した
Canvasが表示されたのにプレビューが空白なら、パネルを開く操作だけでは解決しません。次はファイルとプレビュー宣言を確かめます。
空白や読み込み中なら、ファイルとプレビュー宣言を確認
SwiftUIの画面を作るコードがあるファイルを開いているか確認してください。データ型や補助処理だけのファイルを選んでいると、画面のプレビューが出ないことがあります。授業で指定されたファイル名だけで判断せず、画面を返すビューが含まれているかを見ます。
プレビュー宣言は、Xcodeに「この画面をCanvasに表示する」と伝えるための記述です。Appleのインターフェースファイルにプレビューを追加する説明と授業のサンプルを照らし合わせ、宣言の有無と対象ビューが合っているか確認します。APIの書き方はXcodeの世代やプロジェクトにより違うことがあるため、見つけたコードをそのまま別の課題へ貼り付けるのは避けてください。
プレビュー宣言を足したり書き換えたりする前に、元のファイルを保存するか、変更を戻せる状態にしておきます。最小の画面でも同じ症状が出るか比べると、問題が特定のビューにあるのかを判断しやすくなります。
たとえば、授業プロジェクト内の画面だけ失敗し、シンプルなビューは表示されるなら、プロジェクト全体の異常と決めつけず、該当ビューのコードや読み込むデータに範囲を絞ります。どちらも表示されない場合は、構築結果と実行先の状態へ進みます。
エラー表示と通常の構築失敗を分ける
プレビューにエラーが出たら、文面と最初に示されたファイル・行を控えます。コードのコンパイルエラー、選択中の構築スキーム、プレビュー実行時の問題は、似た画面に見えても確認場所が異なります。
まずプロジェクトを通常どおり構築できるか試します。構築スキームは、Xcodeがどの設定や対象を使って構築するかを決める仕組みです。選択中のスキームと対象が授業の指定に合っているか、Appleの構築スキーム設定の説明に沿って確認してください。
| 状態 | 読み取れること | 次に確認する場所 |
|---|---|---|
| Canvas自体が見えない | 表示領域が閉じている可能性 | Canvasの表示操作 |
| Canvasはあるが空白 | ファイルやプレビュー宣言などの可能性 | 選択中のファイルと宣言 |
| プレビューに構築エラー | コードや設定の問題が含まれる可能性 | エラー文、スキーム、通常の構築 |
| 構築できるがプレビューだけ失敗 | アプリ全体の構築失敗とは限らない | 最小ビューとプレビュー実行状態 |
Xcode 27のリリースノートにはプレビュー関連の変更や修正が記載されています。ただし、それだけでXcode 27.2 RCに同じ不具合が広く存在すると判断することはできません。個別の症状と、実際のエラーを根拠にしてください。
編集後に更新されないなら、変更と実行状態を見直す
画面を直したのにプレビューが変わらない場合は、まず編集内容を保存したか、プレビューが実行中かを確認します。読み込み中なのか、停止しているのか、エラーで中断したのかを見分けてから、必要な操作を行います。
次に、問題を小さくします。授業プロジェクトの画面から複雑な表示要素や外部データを一時的に外し、基本的なビューでも再現するかを比べます。小さな画面では表示され、課題の画面では失敗するなら、差分となるコードやリソースを一つずつ調べます。
原因が分からない段階で、キャッシュ削除、設定変更、Xcodeの再インストールを初手にするのは避けてください。公式資料で裏付けられた原因や手順を確認できないまま環境を変えると、元の症状を再現しにくくなるためです。
プレビューなしでも、構築とシミュレーターで課題を確認
SwiftUIプレビューとアプリの構築、シミュレーターでの実行は、確認できる内容が異なります。プレビューは画面の見た目を編集時に確かめる機能です。通常の構築はプロジェクトが構築できるかを確かめ、シミュレーターはアプリを仮想デバイス上で動かす確認に使います。
| 確認方法 | 分かること | それだけでは分からないこと |
|---|---|---|
| SwiftUIプレビュー | 対象ビューの見た目や変更の反映 | 課題全体がすべての条件で動くか |
| プロジェクトの構築 | 選択した設定で構築が完了するか | 実行時の画面や操作が正しいか |
| シミュレーターで実行 | アプリの起動や実際の画面遷移 | プレビューの異常が直ったか |
課題の提出条件がプレビュー画像を求めているなら、シミュレーターで代替できるとは限りません。提出要件を先に確認し、求められていない場合は構築結果とシミュレーターの画面で作業を続けられるか判断します。シミュレーターで確認する場合は、Appleのシミュレーターまたは実機でアプリを動かす説明を参照してください。代替確認は、プレビューが修復された証明にはなりません。
リモートMacで再現したら、環境情報をそろえる
WindowsからリモートMacを使っている場合は、環境の問題とプロジェクトの問題を混同しないように記録します。次の情報をそろえると、授業のサポート窓口や環境管理者へ状況を伝えやすくなります。
- [ ] Xcodeの表示バージョンが27.2 RCか確認する
- [ ] macOSのバージョンを確認する
- [ ] プロジェクトの対象と選択中の構築スキームを記録する
- [ ] Canvasの状態、表示されたエラー、発生までの操作を控える
- [ ] Appleのシステム要件と利用中のmacOSを照合する
同じプロジェクトがローカル環境では動き、リモート環境だけで失敗する場合でも、ネットワーク接続だけが原因とは限りません。XcodeやmacOSの版、対象設定が一致しているかを確かめ、最小のSwiftUI画面でも再現するかを見ます。Appleの要件ページやリリースノートが更新された場合は、以前の確認結果をそのまま当てはめず、改めて照合してください。
今使っているWindows環境だけでiOSアプリの構築やシミュレーター確認を完結させようとすると、macOS専用のXcodeを動かせないこと、別環境とのファイル移動、授業指定の版との不一致が負担になります。一方、リモートMacはネットワーク接続に左右され、ローカルMacのような使い心地や物理機器への接続を常に代替できるわけではありません。学習を短期間進めるためにMac環境が必要なら、まずMESHLAUNCHの利用案内を確認し、授業の要件と作業期間に合うかを判断してください。長期間、安定して重い作業を続ける場合や、手元の機器へ直接接続する必要がある場合は、自分のMacを用意する方法も比較対象になります。たとえば、日本でMac miniを購入する場合の案内も確認し、利用期間や必要な接続方法に合わせて選びましょう。