Для приёмки беспроводной отладки в Xcode 27 Device Hub сначала подтвердите, что Mac и устройство обнаруживают друг друга в одной Wi‑Fi-сети; не считайте подключение через интернет или доступ по SSH достаточным условием. Если сеть и устройство проходят эту проверку, выполняйте сопряжение, проверяйте разрешения и запускайте реальное приложение. Если обнаружение подтвердить нельзя, перенесите проверку на локальный Mac или используйте симулятор только для тех тестов, которые он действительно покрывает.
Этот материал для разработчиков, которым нужно подключить к Xcode 27 iPhone, iPad или Apple Watch без постоянного кабеля.
Инженеры удалённой инфраструктуры и CI смогут проверить, есть ли у тестового устройства реальный сетевой путь к Mac.
QA и ответственные за допуск релиза смогут отделить успешный запуск в симуляторе от проверки на физическом устройстве.
Последнее обновление: 24 октября 2026 года. Сведения о поддержке, сопряжении и разработческом режиме сверены с примечаниями к выпуску Xcode 27, актуальной документацией Apple по Device Hub и сопутствующими инструкциями. Перед публикацией или запуском приёмки сверяйте требования с текущей документацией: сведения о предварительных выпусках не заменяют описание официальной версии.
Этап 1. Сначала определите, что именно считается приёмкой
Device Hub — это рабочая точка для поиска и управления подключёнными устройствами в Xcode. Беспроводное сопряжение помогает работать с физическим устройством, если Mac и устройство могут увидеть друг друга через локальную Wi‑Fi-сеть. Оно не превращает Mac в доступную через интернет точку сопряжения: облачный доступ к рабочему столу и обнаружение iPhone в сети — разные свойства.
Разделите три результата, которые часто ошибочно объединяют:
- Симулятор запустил приложение. Это полезная проверка сборки и поведения в симулированной среде, но не доказательство, что телефон сопряжён или что приложение работает на реальном устройстве.
- Device Hub обнаружил и сопряг устройство. Это подтверждает, что Xcode видит устройство и прошёл этап сопряжения, но само по себе ещё не доказывает успешную установку и запуск приложения.
- Приложение собрано, установлено и отлаживается на физическом устройстве. Это уже проверка реального запуска; отдельно фиксируйте результат подписи и поведение после потери связи.
Apple описывает сетевое сопряжение для поддерживаемых устройств и указывает, что Mac и устройство должны находиться в одной Wi‑Fi-сети. Не расширяйте это условие до «доступны из интернета» — такого вывода официальная инструкция не даёт. Перед работой проверьте описание сопряжения устройств с Mac и ограничения из требований к системе для Xcode.
В рамках этой проверки цель — установить воспроизводимый цикл: устройство обнаружено, разрешения подтверждены, приложение запускается, а последствия обрыва связи понятны. Полную автоматизацию физического устройства в CI оценивайте отдельно: успешная ручная отладка не доказывает, что runner сможет самостоятельно управлять устройством по расписанию.
Этап 2. До сопряжения сопоставьте Xcode, устройство и сеть
Запишите фактическую версию Xcode, операционную систему устройства и его тип. Не ориентируйтесь только на имя установленного приложения: на Mac могут оставаться несколько версий Xcode, а сборка и обнаружение устройств зависят от той версии, которая выбрана для запуска. Сверьте соответствие с системными требованиями и актуальными примечаниями к выпуску; не переносите требования предварительного выпуска на финальный Xcode.
Затем проверьте сеть как отдельный компонент теста. Mac и iPhone могут оба открывать веб-страницы и при этом не обнаруживать друг друга. Например, в сети могут действовать ограничения на обнаружение устройств или разделение клиентов. Это возможные причины для проверки, а не диагноз: если Device Hub пуст, не объявляйте конкретное сетевое правило виновником без подтверждения администратора или теста на другой сети.
Зафиксируйте исходные условия до начала:
- где находится Mac и к какой сети он подключён;
- к какой Wi‑Fi-сети подключено тестовое устройство;
- допускают ли правила этой сети обнаружение между клиентами;
- доступно ли кабельное подключение для первоначального сопряжения;
- какой способ управления Mac используется — локальная консоль, VNC, веб-консоль или SSH.
Последний пункт важен для удалённого Mac: SSH подтверждает возможность войти в систему, но не подтверждает, что тестовый iPhone виден с сетевого интерфейса Mac в смысле, необходимом Device Hub.
| Вариант проверки | Что он подтверждает | Чего он не подтверждает | Решение |
|---|---|---|---|
| Mac и устройство в одной проверенной Wi‑Fi-сети | Есть подходящая исходная топология для беспроводного обнаружения | Успешное сопряжение, разрешения и запуск приложения | Продолжить в Device Hub |
| У обоих есть интернет, но локальная видимость не проверена | Только доступ к интернету с каждой стороны | Обнаружение устройства Mac и беспроводную отладку | Проверить сеть или перейти к кабелю |
| Mac доступен по SSH или VNC, устройство находится в другой сети | Удалённый доступ к самому Mac | Наличие сетевого пути от телефона к Mac | Не считать удалённую отладку принятой |
| Устройство подключено кабелем | Физический канал для процедуры сопряжения и диагностики | Работу беспроводного режима после отключения кабеля | Сопрячь, затем отдельно проверить беспроводной этап |
Если сетевые условия неизвестны, сначала получите подтверждение у администратора или проведите контролируемую проверку в сети, где устройства должны видеть друг друга. Не меняйте правила защищённой сети только ради удобства отладки без согласования: это может нарушить требования безопасности, а не решить проблему в допустимых границах.
Этап 3. Сопрягите устройство и завершите подтверждения на нём
Откройте Device Hub в выбранной версии Xcode и найдите устройство в списке доступных. Выберите его и пройдите диалог сопряжения, следуя подсказкам Xcode и самого устройства. Фиксируйте, где именно остановился процесс: устройство не появилось, запрос не принят, сопряжение завершилось ошибкой или Xcode сообщил о завершении. Эти состояния требуют разных дальнейших действий.
Если беспроводное обнаружение не сработало, проверьте соответствие системным условиям и принадлежность к одной Wi‑Fi-сети. Затем попробуйте кабельный путь, если он доступен. Успешное кабельное сопряжение поможет отделить проблему обнаружения от проблем доверия, разрешений и дальнейшего запуска. Но оно ещё не является подтверждением, что беспроводное подключение работает: после сопряжения отключите кабель и проверьте этот этап отдельно.
На устройстве могут появляться запросы на доверие или включение Developer Mode. Выполняйте их на самом устройстве, а не только в интерфейсе Xcode. Apple отдельно описывает включение Developer Mode на устройстве; следуйте именно подсказкам для вашей версии системы. Если требуется перезапуск и после него появляется дополнительное подтверждение, завершите процедуру и вернитесь к проверке в Xcode.
Важно. Успешное сопряжение не равно разрешению запускать любую сборку. Доверие к Mac, Developer Mode и корректная подпись приложения относятся к разным этапам. Не очищайте настройки подписи и не переустанавливайте Xcode, пока не установлено, какой этап завершился ошибкой.
Этап 4. FAQ: сеть, обнаружение и готовность устройства
Какая сеть требуется для беспроводного сопряжения в Device Hub?
Mac и устройство должны находиться в одной Wi‑Fi-сети и иметь возможность обнаруживать друг друга. Наличие интернета на обоих устройствах не гарантирует этого условия. При корпоративной или гостевой сети отдельно выясните, разрешено ли обнаружение клиентов; если ответ неизвестен, проверьте сопряжение в согласованной сети или используйте кабель для первичного подключения.
Что делать, если iPhone не появляется в Device Hub?
Сначала проверьте активную версию Xcode, совместимость устройства с ней и фактическое подключение Mac и iPhone к одной Wi‑Fi-сети. Затем исключите сеть, в которой обнаружение между устройствами ограничено, не делая вывод о причине без подтверждения. Если iPhone всё ещё отсутствует, попробуйте официальный кабельный путь сопряжения и сохраните текст ошибки для сравнения с последующими попытками.
Нужно ли включать Developer Mode после сопряжения?
Сопряжение и готовность устройства запускать приложение разработчика — не одно и то же. Проверьте, требует ли система вашего устройства включить Developer Mode, и выполните все её подтверждения, включая запрос после перезапуска, если он отображается. Только после этого возвращайтесь к запуску приложения. Наличие телефона в Device Hub не подтверждает, что разрешения на отладочный запуск уже пройдены.
Работает ли беспроводная отладка через удалённый Mac?
Она возможна только при проверяемой сетевой доступности между удалённым Mac и устройством, необходимой для обнаружения и дальнейшего соединения. Доступ по SSH или к удалённому рабочему столу не является доказательством такой доступности. Если устройство и Mac находятся в разных сетях, а способ обеспечить требуемую видимость не подтверждён, не обещайте себе беспроводную отладку: выполните приёмку локально либо разделите сборку и проверку на физическом устройстве.
Этап 5. Запустите приложение: устройство в списке ещё не означает успех
Выберите нужную схему проекта и именно физическое устройство в качестве назначения запуска. Соберите приложение и проследите всю цепочку: сборка, установка, запуск и появление отладочной сессии. Apple отдельно описывает запуск приложения на симуляторе или физическом устройстве; при приёмке не подменяйте один тип назначения другим.
Если запуск не проходит, разделите диагностику по этапам. Сообщение о неподдерживаемом устройстве ведёт к проверке требований Xcode и платформы. Запрос на устройстве — к проверке доверия и Developer Mode. Ошибка установки или запуска, связанная с подписью, — к проверке сертификата, регистрации устройства и provisioning profile. Для последнего полезно свериться с документацией Apple о внутреннем устройстве code signing и provisioning profiles и правилами регистрации отдельного устройства.
| Наблюдаемый результат | Вероятная область проверки | Как подтвердить следующий шаг |
|---|---|---|
| Устройство отсутствует в списке | Сеть, обнаружение, версия Xcode и совместимость | Сверить сеть и системные требования, затем проверить кабельное сопряжение |
| Устройство видно, но сопряжение не завершено | Запросы на доверие и состояние сопряжения | Пройти подтверждения на устройстве, сохранить сообщение Xcode |
| Сопряжение есть, приложение не запускается | Developer Mode, подпись, профиль или регистрация | Зафиксировать точную ошибку установки и проверить соответствующий этап |
| Приложение запускается, но отладочная сессия не устанавливается | Связь после сопряжения и состояние устройства | Проверить подключение без кабеля и повторить запуск с теми же исходными условиями |
| Симулятор проходит, физическое устройство — нет | Различие между средами тестирования | Считать симуляторную проверку отдельным результатом, а не заменой real-device теста |
При проблеме подписи не удаляйте сертификаты и профили наугад. Зафиксируйте идентификатор приложения, выбранную команду подписи и диагностический текст Xcode; затем проверьте, зарегистрировано ли устройство и допускает ли используемый профиль запуск на нём. Так вы не смешаете исправление provisioning с проблемой сетевого обнаружения.
Для каждого прогона сохраните схему и назначение запуска, итог сборки, результат установки, появление приложения на устройстве и состояние отладки. Если проект использует несколько конфигураций, укажите, какую именно вы проверили: зелёная сборка другой схемы не подтверждает требуемый релизный путь.
Этап 6. Оборвите соединение и проверьте восстановление
Приёмка не заканчивается сразу после успешного запуска. Отключите кабель, если он использовался, и проверьте, остаётся ли устройство доступным по беспроводному соединению. Затем выполните повторный запуск или отладочный сеанс и запишите, что потребовалось: повторное обнаружение, повторное сопряжение, подтверждение на устройстве или только восстановление подключения.
Разделяйте восстановление связи с устройством и восстановление незавершённой сборки. Даже если Xcode снова видит iPhone, это не означает, что прерванная сборка или тест автоматически продолжились с корректным состоянием. После разрыва проверьте фактический результат приложения и журналы, а не только индикатор подключения.
Для удалённого Mac добавьте отдельную проверку топологии. Убедитесь, что тестовый iPhone и Mac находятся в требуемой сети и устройство обнаруживается именно со стороны этого Mac. Удалённая консоль может помочь управлять хостом, но сама по себе не соединяет устройства из разных сетей. Если хостовая сеть не обеспечивает подтверждённую видимость, переключитесь на локальный Mac для физической приёмки; симулятор оставьте для задач, которым не нужен реальный телефон.
Перед тем как выбирать удалённую среду, изучите варианты доступа к удалённому Mac и отдельно проверьте актуальные условия и планы. Эти страницы не заменяют сетевую проверку Device Hub: решение о пригодности хоста принимайте только после подтверждения способа доступа и реальной достижимости устройства.
Этап 7. Допустите сценарий по доказательствам, а не по предположению
Соберите короткую запись, по которой другой инженер сможет повторить проверку:
- версия Xcode и версия системы устройства;
- тип устройства и выбранная схема приложения;
- сеть Mac и устройства, а также подтверждение возможности обнаружения;
- способ первичного подключения и состояние сопряжения;
- выполненные подтверждения доверия и Developer Mode;
- результат сборки, установки, запуска и отладочной сессии;
- результат отключения кабеля и повторного подключения;
- точный текст ошибки, если какой-либо этап завершился неудачно.
По этой записи выбирайте место выполнения задачи. Локальный Mac подходит, когда разработчику нужно непосредственно сопрягать устройство и проверять поведение приложения. Удалённый Mac можно допускать для такой проверки только при подтверждённой сетевой топологии и успешном повторяемом тесте с конкретным устройством. CI может выполнять сборку и симуляторные тесты отдельно, а физическую проверку — в специально проверенном контуре. Не выдавайте успешный симуляторный прогон за приёмку на iPhone или iPad.
Если текущий способ работы — локальная машина без нужного доступа, Linux-сервер или удалённый Mac с неподтверждённой сетью, у каждого варианта есть ограничения: локальный Mac занят или недоступен тестировщику, Linux не заменяет macOS-инструменты Xcode, а удалённая консоль не гарантирует видимость устройства. Для разовой проверки или временного тестового контура можно рассмотреть аренду Mac у VMSPIN, но сначала сопоставьте способ доступа с расположением устройства и подтвердите сетевые условия. Если физическое подключение необходимо постоянно, требуется специальный интерфейс или стабильная долгосрочная нагрузка, сравните аренду с собственной выделенной инфраструктурой. До оплаты запросите подтверждение именно того способа подключения к реальному устройству, который нужен вашему сценарию; доступность удалённого Mac сама по себе этого не обещает. Изучите варианты заказа Mac и используйте их только после проверки сетевой схемы.
Критерий допуска: беспроводная приёмка пройдена, когда зафиксированы обнаружение, сопряжение, разрешения, запуск реального приложения и результат восстановления после обрыва. Если хотя бы один сетевой или пользовательский этап не подтверждён, обозначьте его как ограничение контура, а не как успешную проверку.