Visual Studio 2026 iOS Hot Restart недоступен: как продолжить разработку?

После обновления вы открываете проект .NET MAUI и обнаруживаете, что пункт iOS Hot Restart исчез или больше не запускается.

Самое быстрое решение: не переустанавливайте Visual Studio 2026 в надежде вернуть функцию — оставьте Windows основной средой разработки, а сборку, Simulator, подпись и публикацию перенесите на доступный по сети Mac через Pair to Mac. Microsoft прямо указывает, что Visual Studio 2026 не поддерживает Hot Restart; актуальная документация рекомендует Pair to Mac для iOS-задач на Mac-хосте (документация Hot Restart, документация Pair to Mac).

Кому это руководство сэкономит время

Оно предназначено для разработчиков .NET MAUI, которые перешли на Visual Studio 2026 и потеряли привычный способ запуска iOS-приложения. Вы также найдёте здесь рабочую схему для Windows-компьютера без локального Mac и критерии, по которым временная отладка превращается в устойчивый сервер сборки.

SECTION 01 План действий: что сделать в первый день и что проверить перед релизом

В первый день не меняйте сразу несколько переменных. Сначала зафиксируйте версию Visual Studio, .NET SDK, .NET MAUI workload и состояние проекта, затем выберите один из двух маршрутов:

• Временный маршрут: оставить Visual Studio 2022 с поддерживаемым Hot Restart для ограниченной отладки совместимого приложения.
• Основной маршрут: настроить Pair to Mac и выполнять на Mac весь iOS-контур — компиляцию, запуск Simulator, подготовку подписи, Archive и передачу сборки.

Согласно официальной документации, Hot Restart имеет ограничения и не является полноценной заменой Mac-инструментам (описание ограничений Hot Restart). Поэтому старую Visual Studio не стоит считать готовым iOS-сервером: она может помочь пережить переход, но не решает вопрос производственной публикации.

Поставьте следующие контрольные точки:

1. Диагноз: функция действительно исключена из Visual Studio 2026, а не скрыта из-за проекта.
2. Связь: Windows стабильно видит Mac по сети и проходит SSH-аутентификацию.
3. Инструменты: на Mac завершена первичная настройка Xcode и выбран корректный активный developer directory.
4. Сборка: проект .NET MAUI собирается для iOS на удалённом хосте.
5. Публикация: создан Archive, проверены сертификат, закрытый ключ, Provisioning Profile и загрузочные учётные данные.
6. Восстановление: после разрыва соединения и перезапуска хоста процесс можно повторить без ручной пересборки всей среды.

SECTION 02 Почему исчезнувший Hot Restart не исправляется переустановкой

Ключевой вопрос здесь — изменение границы поддержки, а не состояние установщика. На странице Microsoft для Hot Restart зафиксировано, что Visual Studio 2026 эту функцию не поддерживает. Поэтому отсутствие пункта после обновления само по себе не доказывает, что у вас повреждён iOS workload.

Не смешивайте три разных ситуации:

• Функция отсутствует в продукте. Установка того же workload не добавит её обратно.
• Функция есть, но проект не подходит. Это относится к ограничениям старого Hot Restart, профилю приложения, подписи или конфигурации.
• Сборка не проходит на Mac. Здесь причина уже находится в Xcode, SDK, workload, зависимостях или сертификатах.

Проверка должна начинаться с официальной страницы, соответствующей вашему представлению .NET MAUI, а не с удаления кэшей. Microsoft отдельно публикует сведения о поддерживаемых платформах и установке workload (поддерживаемые платформы .NET MAUI, требования установки .NET MAUI).

Как выбрать между Visual Studio 2022 и Pair to Mac

Visual Studio 2022 можно временно сохранить, если вам нужно быстро проверить конкретный экран на совместимом устройстве и вы готовы жить с ограничениями Hot Restart. Но это решение имеет чёткую точку остановки: как только требуется удалённый Simulator, стабильный Release Archive, полноценная работа с Apple-подписью или автоматическая публикация, следует переходить на Mac-контур.

Pair to Mac подходит, когда Windows должна остаться редактором и управляющей системой, а macOS — исполнителем iOS-инструментов. Такая модель не требует переносить весь рабочий процесс на Mac, но требует, чтобы Mac был постоянно доступен, корректно настроен и не терял состояние после перезагрузки.

Возможности .NET MAUI меняются вместе с поддерживаемыми версиями SDK и инструментов, поэтому сведения о .NET 10 следует сверять с официальным описанием выпуска, а не с устаревшими инструкциями (официальные изменения .NET MAUI 10).

SECTION 03 Как восстановить Pair to Mac, если Mac не находится или не принимает вход

Не начинайте с удаления SSH-ключей и сброса удалённого кэша: такие действия могут стереть рабочую конфигурацию и заставить вас заново проходить аутентификацию. Сначала сохраните обезличенные журналы с обеих сторон и определите этап отказа.

Первый шаг: проверить сетевой маршрут

С Windows проверьте, что имя хоста разрешается в нужный адрес, а сам адрес доступен по вашей корпоративной или домашней сети. Если автоматическое обнаружение не показывает Mac, это ещё не означает, что Mac выключен. Обнаружение может не проходить через VLAN, VPN, маршрутизатор или фильтрацию широковещательных запросов.

Добавьте хост вручную по IP-адресу, если это предусмотрено интерфейсом Pair to Mac. Используйте адрес вида [MAC_IP], а не настоящий публичный адрес в скриншотах или отчётах. Если подключение по IP работает, проблема находится в механизме обнаружения, а не в Visual Studio и не в проекте.

Второй шаг: включить Remote Login на macOS

На Mac проверьте, разрешён ли удалённый вход и входит ли пользователь [MAC_USER] в список разрешённых. Имя пользователя, IP-адрес и доменное имя в журналах перед передачей коллегам заменяйте на [USER], [IP_ADDRESS] и [HOSTNAME].

Убедитесь, что вы проверяете именно ту учётную запись, под которой должен запускаться удалённый инструмент. Системный администратор может разрешить вход только отдельной группе, а firewall — принимать соединения лишь из определённой подсети.

Третий шаг: отделить аутентификацию от обнаружения

Если Mac виден, но вход не проходит, проверяйте:

• правильность имени пользователя [MAC_USER];
• выбранный способ SSH-аутентификации;
• наличие и права доступа к нужному ключу;
• отсутствие пробелов или переносов строк в секретах;
• время ожидания и повторные попытки после изменения сетевых правил.

Не публикуйте в тикете закрытый ключ, пароль, Team ID, Bundle ID или полный журнал, содержащий токены. Для диагностики достаточно строк, показывающих код ошибки, этап операции и обезличенный адрес.

Четвёртый шаг: дождаться удалённой настройки

Успешный вход по SSH ещё не означает, что Pair to Mac завершил установку удалённых компонентов. Разделяйте состояния:

1. Windows нашла Mac.
2. SSH-аутентификация прошла.
3. Mac принял и установил требуемые инструменты.
4. Проект смог вызвать сборку iOS.
5. Приложение запустилось в Simulator или на устройстве.

Если сбой появляется между третьим и четвёртым состоянием, повторная установка Visual Studio на Windows вряд ли поможет. Сначала проверяйте свободное место, права пользователя, активную версию Xcode и завершённость первоначальной настройки macOS-инструментов.

Пятый шаг: очищать кэш только с планом возврата

Сброс удалённого состояния или удаление SSH-ключей допустимы только после сохранения журнала и проверки, что у вас есть новый способ входа. До очистки запишите:

• адрес Mac и имя пользователя;
• выбранную версию инструментов;
• расположение проекта и локальных артефактов;
• способ восстановления ключа;
• владельца сертификатов и Provisioning Profile.

После очистки снова пройдите подключение по этапам, не маскируя ошибку новым массовым переустановочным действием.

SECTION 04 Что проверять, если Pair to Mac подключён, но iOS-проект не собирается

Подключение Mac — только транспортный этап. Для .NET MAUI iOS необходим согласованный набор проекта, .NET MAUI workload, Xcode, iOS SDK и macOS. Microsoft публикует матрицу поддерживаемых платформ и требования установки, но конкретное сочетание версий нужно проверять для вашей ветки проекта непосредственно перед миграцией (таблица поддерживаемых платформ).

Проверяйте в таком порядке.

Xcode запускается и завершил первый запуск

На Mac откройте Xcode вручную под тем пользователем, который используется Pair to Mac. Завершите первичную установку компонентов и лицензионные действия, если они отображаются. Если Xcode установлен, но первый запуск не закончен, удалённая сборка может остановиться до компиляции проекта.

Затем проверьте активный developer directory. Укажите в диагностике только безопасное значение вида [DEVELOPER_DIR], если путь содержит личное имя пользователя или структуру внутреннего диска. После обновления Xcode особенно важно убедиться, что система не использует старый или удалённый каталог разработчика.

Workload и Target Framework совпадают с проектом

На Windows и Mac зафиксируйте версии .NET SDK и workload, а в файле проекта проверьте целевой фреймворк, например [TARGET_FRAMEWORK]. Не подменяйте значение реальным идентификатором проекта в публичных логах.

Ошибки здесь часто выглядят как проблема Pair to Mac, хотя соединение уже работает. Если удалённый инструмент запускается, но MSBuild не может найти iOS SDK или нужный workload, исправлять нужно набор разработки и проектные зависимости, а не сетевой маршрут.

Зависимости восстанавливаются повторяемо

Выполните восстановление зависимостей на чистом или заранее подготовленном рабочем каталоге, затем повторите сборку без изменения исходников. Сохраните обезличированный результат [BUILD_LOG]. Если сборка зависит от локального кэша, ручного файла или переменной среды, после перезапуска Mac это выяснится сразу.

Для постоянного процесса зафиксируйте версии пакетов и не обновляйте Xcode посреди релизного цикла без отдельной проверки. Важно не только получить зелёную Debug-сборку, но и воспроизвести Release-путь.

SECTION 05 Почему Simulator, Hot Reload и реальное устройство не являются одной функцией

Hot Restart, Hot Reload, удалённый Simulator и развёртывание на физический iPhone решают разные задачи. Hot Restart был быстрым способом интерактивной проверки в ограниченном сценарии. Hot Reload изменяет код во время запущенного приложения, но не отменяет необходимость полноценной компиляции, подписи и проверки релизной конфигурации.

iOS Simulator работает в macOS-среде. В схеме Windows плюс Pair to Mac Windows отвечает за редактирование и управление, а Mac запускает iOS-инструменты. Поэтому успешное открытие проекта в Visual Studio не означает, что Simulator должен появиться локально в Windows.

Физическое устройство — отдельная граница. Удалённый Mac в дата-центре обычно не имеет прямого доступа к USB-порту рядом с вами. Для реального iPhone заранее проектируйте отдельный канал: локальная машина, поддерживаемый удалённый доступ к устройству или другой контролируемый стенд. Не включайте в план релиза обещание, что любой удалённый Mac автоматически увидит ваш кабель.

Проверьте эти сценарии раздельно:

• Debug-сборка и запуск Simulator;
• изменение интерфейса через Hot Reload;
• установка на физическое устройство;
• Release Archive;
• подпись и передача сборки;
• обработка загруженного пакета в App Store Connect.

SECTION 06 Почему отладка может работать, а Archive и публикация — нет

Запуск приложения в Debug не подтверждает наличие производственных ключей. Для публикации нужны отдельные артефакты и права: сертификат, закрытый ключ, Provisioning Profile, идентификатор приложения, команда разработчика и учётные данные для передачи сборки.

Проверьте, не остались ли сертификат и закрытый ключ только на старом локальном Mac. После миграции Pair to Mac приложение может запускаться с профилем разработчика, но Release Archive остановится на подписи. Храните секреты изолированно, не вставляйте их в журналы и не переносите закрытый ключ в общий каталог без контроля доступа.

Apple связывает подготовку распространения с требованиями Xcode и конфигурацией приложения; перед релизом сверяйте официальную инструкцию по подготовке приложения к распространению. Отдельно проверяйте актуальные требования Apple к отправке приложения, потому что порог Xcode и SDK может измениться независимо от того, запускается ли ваш Debug-проект.

Разделяйте этапы так:

1. Build: исходники и зависимости компилируются.
2. Debug: приложение запускается в Simulator или на разрешённом устройстве.
3. Archive: создаётся релизный архив с нужной конфигурацией.
4. Code signing: профиль и сертификат подходят идентификатору приложения.
5. Upload: пакет принимается каналом загрузки.
6. Processing: App Store Connect завершает серверную обработку и показывает результат проверки.

Только после шестого этапа можно считать публикационную цепочку проверенной. Возможность запустить приложение на Windows через удалённое управление не равна готовности к размещению в App Store.

SECTION 07 Как принять удалённый Mac по результатам реальной проверки

Перед оплатой длительного доступа выполните не демонстрационный вход, а короткий релизный прогон. Сначала создайте обезличенный проект или используйте копию репозитория без настоящих секретов. Имена вида [PROJECT_NAME], [BUNDLE_ID], [TEAM_ID], [CERTIFICATE] и [PROFILE] должны оставаться именно такими в опубликованных инструкциях и скриншотах.

Первый контрольный прогон

1. Подключите Windows к Mac через Pair to Mac.
2. Зафиксируйте время успешного входа и сохраните обезличенный лог.
3. Проверьте Xcode, активный developer directory и завершённость первичной настройки.
4. Восстановите зависимости .NET MAUI.
5. Выполните Debug-сборку iOS.
6. Запустите приложение в Simulator.
7. Проверьте логи, артефакты и возврат к проекту после закрытия IDE.
8. Выполните Release Archive без публикации секретов в консоли.
9. Проверьте подпись и подготовьте тестовую передачу в соответствии с требованиями Apple.
10. Перезапустите Mac и повторите подключение, чтобы проверить восстановление.

Количество шагов здесь не является заявлением о требованиях Microsoft или Apple, а представляет последовательность приёмочного теста, которая не позволяет принять среду только по факту обнаружения хоста.

Проверка устойчивости

Разорвите соединение в безопасный момент и убедитесь, что повторное подключение не создаёт второй набор конфликтующих инструментов. После перезапуска Mac проверьте, запускается ли Remote Login, доступен ли нужный пользователь и сохраняется ли конфигурация Xcode.

Если среда используется несколькими людьми, назначьте владельца обновлений и храните журнал изменений: [DATE], [XCODE_VERSION], [DOTNET_VERSION], [WORKLOAD_STATE]. Реальные версии и даты в вашей таблице должны подтверждаться официальными страницами или внутренней документацией команды, а не заполняться предположениями.

Результат можно свести к трём решениям:

• Оставить Visual Studio 2022 временно, если требуется только ограниченная отладка и релизный контур пока не готов.
• Перейти на удалённый Mac, если Pair to Mac проходит, Simulator работает, Archive подписывается, а повторное подключение после перезапуска предсказуемо.
• Разделить контуры, если Windows удобнее для ежедневного кода, а отдельный Mac нужен для ночных сборок, подписания и публикации.

Если вам нужна дополнительная проверка именно сертификатов, пригодится руководство по ротации сертификатов подписи. Когда требуется временная или постоянная машина, сначала сопоставьте ожидаемый цикл проверки с вариантами аренды Mac у VPSNIX, но принимайте решение только после выполнения теста Pair to Mac и Archive.

Текущая схема на одной Windows-машине с устаревшим Hot Restart имеет три реальных слабых места: функция ограничена, локального iOS Simulator нет, а производственная подпись и Archive остаются привязанными к отдельной macOS-среде. Покупка собственного Mac снимает сетевую зависимость, но добавляет расходы на оборудование, обслуживание и обновления. Если задача состоит в временном доступе, миграции или запуске постоянного iOS-сборщика, аренда удалённого Mac у VPSNIX может быть рациональнее — при условии, что вы сначала подтвердите подключение, сборку, Archive и восстановление после перезапуска.

SECTION 08 Частые вопросы

Почему в Visual Studio 2026 не находится iOS Hot Restart?

Это не обычная ошибка установки. В актуальной документации Microsoft указано, что Visual Studio 2026 не поддерживает Hot Restart. Поэтому повторная установка workload не возвращает пункт меню. Для нового рабочего процесса используйте Pair to Mac, а Visual Studio 2022 оставляйте только как временный контур, пока не проверены удалённая сборка и публикация.

Можно ли продолжать разработку .NET MAUI iOS без локального Mac?

Можно, если у вас есть сетевой доступ к реальному Mac, на котором доступны Xcode и необходимые iOS-инструменты. Windows остаётся основной средой редактирования, а Mac выполняет сборку и запуск Simulator через Pair to Mac. Ограничение возникает при тестировании физического iPhone: удалённый дата-центр обычно не даёт прямого доступа к вашему USB-устройству.

Что делать при ошибке подключения Pair to Mac?

Разделите диагностику на уровни: сначала проверьте доступность адреса, затем Remote Login, разрешённого пользователя, SSH-учётные данные и firewall. При неработающем автоматическом обнаружении добавьте Mac по IP вручную. После этого изучите обезличенные журналы и определите, где произошёл сбой — при обнаружении, аутентификации или установке удалённых компонентов.

Есть ли смысл оставаться на Visual Studio 2022?

Да, но только как на временном решении для ограниченной отладки совместимого приложения. Документация описывает Hot Restart для Visual Studio 2022, однако не обещает срок его дальнейшей доступности. Если вам нужны Simulator, Release Archive, подпись, загрузка и повторяемая сборка, переносите основной процесс на Pair to Mac, а не откладывайте миграцию.

Нужен ли Mac для публикации приложения .NET MAUI в App Store?

Для полноценной публикации нужен доступ к macOS-инструментам: требуется подготовить Archive, выполнить подпись и передать пакет в App Store Connect с учётом актуальных требований Apple к Xcode и SDK. Windows может управлять этим процессом через Pair to Mac, но сама Windows-сборка или успешный Debug-запуск не подтверждают готовность к производственному релизу.

На 1 сентября 2026 года вывод остаётся практическим: если Visual Studio 2026 убрал ваш привычный Hot Restart, не тратьте время на бесконечные переустановки. Проверьте Pair to Mac по полной цепочке — от сетевого входа до Archive и восстановления после перезапуска — и только затем выбирайте срок использования удалённого Mac или смешанную схему разработки и публикации.

SECTION 09 Часто задаваемые вопросы