Visual Studio 2026 iOS Hot Restart が利用できない：開発を続けるには？

Visual Studio 2026 iOS Hot Restart が利用できないなら、Windowsを編集環境として残し、Pair to Macで接続したMacへiOSのビルド、シミュレーター実行、署名を移してください。Visual Studio 2022のHot Restartを残す方法は短期の実機デバッグ向けであり、正式公開用のMac環境の代わりにはなりません。Microsoftは.NET MAUIの公式ドキュメントで、Visual Studio 2026ではHot Restartをサポートしないと案内しています。
（Hot Restartの対応状況、2026年9月1日確認）

このページは、Visual Studio 2026へ更新してHot Restartの入口が消えた.NET MAUI開発者向けです。WindowsだけでiOSアプリを開発している独立開発者、または一時的なデバッグ環境を常駐ビルド環境へ変更したい小規模チームに適しています。

今週の推奨アクション：まず旧版の再インストールではなく、Pair to Macの接続確認を行ってください。接続後にシミュレーター用ビルド、Release Archive、再接続の順で通らなければ、公開環境としては未完成です。

SECTION 01 Visual Studio 2026でiOS Hot Restartが使えない理由

今回の問題は、通常のVisual Studioインストール不良とは切り分ける必要があります。Visual Studio 2026でHot Restartが見つからない場合、ワークロードを追加し直したり、Visual Studioのキャッシュを削除したりしても、公式にサポートされない機能が戻るとは限りません。

一方、Visual Studio 2022のHot Restartについては、Microsoftが現行ドキュメントで説明している範囲の機能として扱う必要があります。短期的に旧版を残す場合は、次の停止条件を先に決めてください。

• 実機での一時的なデバッグだけが目的なら、旧版を隔離して使う。
• チームで同じビルドを繰り返す場合は、旧版依存を終了する。
• Release Archive、署名、App Store Connectへの提出まで必要なら、最初からMacを接続先にする。
• Visual Studio 2026を主環境にするなら、Pair to Macでの接続検証を優先する。

Hot Restart、Hot Reload、Pair to Macは同じ機能ではありません。Hot Reloadは実行中のコード変更を反映するための開発支援機能であり、Pair to MacはWindows側のVisual StudioからMac側のiOSツールチェーンへ処理を渡す接続方式です。名称が似ているため、Hot Reloadが動くことをHot Restartの代替と判断しないでください。

SECTION 02 Pair to Macの接続障害を切り分ける

Pair to MacでMacが表示されない場合、問題は大きく「検出」「認証」「リモート設定」のどこかにあります。MicrosoftのPair to Mac公式手順に沿って、次の順番で確認すると、不要な再インストールを避けられます。

1. ネットワーク到達性を確認する
   WindowsからMacのホスト名またはIPアドレスへ到達できるか確認します。自動検出だけに依存せず、検証用の[MAC_IP_ADDRESS]を使って手動追加します。IPアドレスは記事、ログ、画面共有の記録に実値を残さないでください。

2. MacのRemote Loginを有効にする
   macOSの共有設定でRemote Loginを確認し、接続に使う[MAC_USER]が許可されたユーザーに含まれているか確認します。管理者権限の有無と、SSH接続を許可されたユーザーであることは別の確認項目です。

3. SSH資格情報を確認する
   ユーザー名、認証方式、秘密鍵の参照先を確認します。[SSH_KEY_PATH]、秘密鍵の内容、パスワード、Team IDはログやスクリーンショットに残さないでください。

4. ファイアウォールと経路を確認する
   Mac側のファイアウォール、社内ネットワーク、VPN、ルーターの分離設定を確認します。自宅のMacとデータセンターのMacでは、同じLANに見えても自動検出の前提が成立しないことがあります。

5. ログで失敗地点を確定する
   Windows側とMac側のログを、[PROJECT_NAME]、[MAC_IP_ADDRESS]、[BUNDLE_ID]などの占有語へ置換して保存します。「Macが見えない」の一言で終わらせず、検出前、認証時、リモートツールの設定時のどこで停止したかを確認します。

SSH鍵の削除やPair to Macのキャッシュリセットは、最後の手段にしてください。削除する前に接続情報を安全な保管場所へ退避し、旧環境で再接続できること、または新しい鍵を登録できることを確認しないと、復旧経路そのものを失う可能性があります。

SECTION 03 接続後に.NET MAUI iOSをビルドできない場合

Pair to Macの接続成功は、iOSプロジェクトのコンパイル成功を意味しません。少なくとも「Macへ接続できた」「Mac側のリモートツールが設定された」「プロジェクトが対象フレームワークでビルドできた」の三段階を分けて記録してください。

Mac側では、次の項目を順に確認します。

• Xcodeがインストールされ、初回起動時の使用許諾と追加コンポーネントの導入が完了している。
• xcode-selectが意図したXcodeを指している。
• macOS、Xcode、iOS SDKの組み合わせが、使用中のVisual Studioと.NET MAUIのサポート範囲に合っている。
• Windows側に必要な.NET MAUIワークロードが導入されている。
• プロジェクトのターゲットフレームワークが、iOS向けの設定になっている。
• binやobjの古い生成物ではなく、依存関係を復元した状態で再ビルドしている。

.NET MAUIのインストール条件は更新されるため、手元の経験則だけでXcodeの版を固定しないでください。.NET MAUIのインストール要件、サポート対象プラットフォーム、.NET 10向けの変更点を、採用するSDKと併せて確認します。

特に注意が必要なのは、Visual Studio側の更新だけを先に進めることです。Windows側が新しくても、Mac上のXcode、macOS、署名資産が適合していなければ、プロジェクトは接続後のビルド段階で止まります。

切り分けの基準：接続ボタンが成功したことではなく、空の検証用プロジェクトをシミュレーター向けにビルドできることを最初の合格条件にしてください。実際のアプリ固有のNuGet依存関係や署名設定は、その後に戻します。

SECTION 04 シミュレーター、Hot Reload、実機デバッグの境界

iOSシミュレーターはMac上のiOS開発ツールチェーンで動作します。Windows側はコード編集と操作の中心になれますが、WindowsだけでiOSシミュレーターを実行できるという意味ではありません。

機能の役割は次のように整理できます。

• Hot Restart：対応するVisual Studio環境で、開発中のアプリを実機へ素早く反映するための経路です。
• Hot Reload：実行中のアプリへ変更を反映する開発支援機能です。iOSのArchiveや署名を実行する機能ではありません。
• Pair to Mac：WindowsのVisual StudioとMac側のビルド環境を接続します。iOSのビルド、シミュレーター、デバッグの基盤になります。
• リモートシミュレーター：Mac上のシミュレーター画面をWindows側から操作する構成です。シミュレーターは実機のカメラ、プッシュ通知、Bluetooth、性能を完全には再現しません。
• 実機配置：証明書、Provisioning Profile、端末の登録、Mac側の接続経路が必要です。

データセンターのリモートMacを使う場合、手元のiPhoneをUSBで直接接続できるとは限りません。無線経由の実機配置、端末を置く場所、ネットワーク経路、画面確認の方法を別途設計する必要があります。実機テストが主目的なら、シミュレーターだけで受け入れ判定を終わらせないでください。

SECTION 05 Debug成功から公開までを別のマイルストーンにする

アプリがDebugで起動しても、公開可能な状態とは限りません。開発作業では次のマイルストーンを別々に扱うと、最後に署名で止まる問題を早く発見できます。

1. Pair to MacでMacへ再接続できる。
2. 依存関係を復元し、シミュレーター向けDebugビルドが完了する。
3. シミュレーター上で主要画面とネイティブ連携を確認する。
4. Release設定でArchiveを作成する。
5. 証明書の秘密鍵とProvisioning Profileを使って署名する。
6. App Store Connectへアップロードし、処理結果を確認する。
7. Macの再起動後も同じ手順を再現する。

[BUNDLE_ID]、[TEAM_ID]、証明書、Provisioning Profile、App Store Connectのアップロード認証情報が、古いMacだけに存在していないか確認してください。秘密鍵を新しいMacへコピーする場合も、平文ファイルやチャットへ置かず、アクセス権と削除手順を先に決めます。

Appleの提出条件や、必要となるXcodeとSDKの組み合わせは変更される可能性があります。公開直前にはAppleのApp Store提出案内と、配布用アプリの準備手順を確認してください。Macでアプリが起動した事実だけでは、現在の提出条件を満たした証拠になりません。

SECTION 06 失敗しないための検証タイムライン

環境を常用する前に、次の時間軸で検証します。各段階でログを保存し、失敗した段階より後を成功扱いにしないことが重要です。

• 接続段階：ホスト名または[MAC_IP_ADDRESS]で接続し、再接続まで確認する。
• ツール段階：Xcodeの初回設定、アクティブな開発者ディレクトリ、.NET MAUIワークロードを確認する。
• 開発段階：検証用プロジェクトをシミュレーターでビルドし、実際のアプリへ進む。
• リリース段階：Release Archive、署名、アップロードを順番に実行する。
• 運用段階：Macの再起動、接続断、認証期限切れを想定し、復旧手順を別の担当者でも実行できる状態にする。

Macの再起動後にXcodeの選択状態が変わる、証明書の秘密鍵だけが見つからない、VPN切断後に自動検出できない、といった問題は、初回のPair to Mac成功だけでは発見できません。常駐ビルド環境として使うなら、成功ログだけでなく失敗時のログ保存場所と再試行条件も決めてください。

SECTION 07 どの開発環境へ移行するべきか

判断を急いで旧版へ戻す前に、必要な工程とMacの利用形態を照合します。

Macを常時購入するか迷っている場合は、まずリモートMacの利用方法を確認し、必要な接続方式と運用条件を整理してください。料金や契約期間を比較する段階では、VPSNIXの料金案内だけでなく、Mac側に証明書を安全に配置できるか、再起動後に復旧できるかも判断材料に含めます。

SECTION 08 よくある質問

Visual Studio 2026でiOS Hot Restartが表示されないのはなぜですか？

Visual Studio 2026では、Microsoftの.NET MAUI公式ドキュメント上、iOS Hot Restartはサポート対象外です。ワークロードの再インストールで復活する種類の不具合ではないため、Windowsを編集環境として残し、Pair to Macへ移行するのが現実的です。

Macを持っていなくても.NET MAUI iOSを続けられますか？

コード編集はWindowsで続けられますが、iOSビルド、シミュレーター、署名、公開にはMac側の環境が必要です。手元にMacがない場合は、ネットワーク経由で接続できるリモートMacを用意し、シミュレーター用ビルドとArchiveを別々に検証してください。

Pair to Macで接続できないとき、最初に何を確認しますか？

自動検出の失敗だけでVisual Studioを再インストールするのは早計です。まずネットワーク到達性、MacのRemote Login、許可ユーザー、SSH認証情報、ファイアウォールを順番に確認し、ホスト名で見つからない場合は[MAC_IP_ADDRESS]で手動追加します。

Visual Studio 2022のHot Restartを使い続けても問題ありませんか？

短期の実機デバッグだけなら、Visual Studio 2022の現行ドキュメントに記載された範囲で旧環境を残す選択肢があります。ただし、長期の開発、Release Archive、コード署名、App Store公開を旧版だけに依存させると、環境更新時の移行リスクが大きくなります。

.NET MAUI iOSの公開にMacは必要ですか？

Windowsでアプリを編集して起動できても、公開に必要なArchive、署名、証明書の秘密鍵、Provisioning Profile、App Store Connectへの提出まで完了したとは限りません。現在のXcodeとSDKの条件を満たすMac環境で、公開用の一連の工程を確認する必要があります。

Visual Studio 2026で起きている問題を単なる設定ミスとして扱い続けるより、Windowsはコーディング、MacはiOSツールチェーンという役割分担へ切り替える方が、開発と公開の境界を管理しやすくなります。旧版Hot Restartは一時的な実機確認には使えても、Xcode更新、証明書管理、Archive、App Store提出まで担う常用環境にはなりません。

ローカルMacを購入すると、初期費用、保管場所、OSとXcodeの更新、故障時の交換を自分で負担する必要があります。反対に、手元のUSB実機を直接使えないリモート構成にも制約があるため、まずPair to Mac、シミュレーター、Archive、再起動後の復旧を確認してください。その検証を通過したうえで、必要な期間だけVPSNIXのMacレンタルを選べば、公開前の作業用環境や常駐ビルド環境を無理なく判断できます。

SECTION 09 よくある質問 FAQ