3 ноября 2026 года Apple выпустила Xcode 27.3 Beta и подтвердила в официальном описании выпуска: Device Hub позволяет симулировать жест двумя пальцами на iPhone и iPad перетаскиванием с зажатой клавишей Option. Поэтому при сбое сначала сверьте версию и цель, затем выясните, не сработал ли ввод или приложение получило действие, но показало не тот результат. Одна неудачная попытка не доказывает общий дефект Xcode.
Это руководство для независимых разработчиков, проверяющих взаимодействия в Xcode 27.3 Beta, и небольших команд, поддерживающих UI-тесты. Вы отделите ошибку ввода от поведения приложения и поймёте, когда ручной проверки недостаточно. Если вы запускаете Xcode на удалённом Mac, отдельно зафиксируете, что именно проверено в вашей среде.
Последнее обновление: 11 ноября 2026 года. Сведения о поддержке жеста сверены с выпуском Apple, а требования к хост-системе — с официальной страницей системных требований Xcode.
Сначала определите, на каком этапе исчезает действие
Не начинайте с переустановки Xcode. Сначала запишите наблюдаемый симптом: действие не появляется, действие заметно в интерфейсе, но приложение реагирует неверно, либо действие и реакция есть, а тест не воспроизводит результат. Эти случаи требуют разных проверок.
| Наблюдение | Что пока можно заключить | Следующая проверка |
|---|---|---|
| После Option-перетаскивания нет заметного изменения | Ввод мог не сработать или вы могли не увидеть его эффект | Проверьте версию, цель, фокус приложения и траекторию указателя |
| Интерфейс меняется, но не так, как ожидается | Симуляция, вероятно, дошла до отображаемого сценария; причина может быть в логике приложения | Проверьте распознавание жеста, область касания и состояние экрана |
| Ручной жест работает, а автоматизированная проверка падает | Ручное воспроизведение само по себе не подтверждает корректность UI-теста | Проверьте тестовое действие, ожидание и критерий проверки |
Таблица помогает выбрать направление, но не доказывает, что событие ввода действительно дошло до конкретного обработчика приложения. Не приравнивайте видимое изменение экрана к проверке всего пути события.
Сформулируйте, что должно произойти после жеста, и запишите, что именно произошло. Например, если экран должен изменить масштаб, фиксируйте не только сам экран, но и наблюдаемое изменение масштаба. Это даст вам проверяемое различие между «жест не был воспроизведён» и «жест воспроизведён, но результат не совпал».
Сверьте Xcode, цель запуска и системные требования
Поддержка в выпуске относится к Device Hub и симуляции двухпальцевого взаимодействия на iPhone и iPad. Она не означает, что любые жесты приложения, любые тестовые сценарии или любой способ удалённого управления уже проверены. Сначала установите, что вы действительно запустили Xcode 27.3 Beta, а не другую установленную копию Xcode, и что тестируете подходящую цель.
| Условие | Что проверить | Почему это важно |
|---|---|---|
| Версия инструмента | Название и версию активного Xcode, запущенное приложение и выбранный инструмент | Результат другой версии нельзя автоматически приписать Xcode 27.3 Beta |
| Цель | Выбран ли симулятор iPhone или iPad и тот ли экземпляр сейчас запущен | В описании Apple область поддержки указана для iPhone и iPad |
| Хост-система | Соответствует ли компьютер системным требованиям указанного выпуска | Несоответствующая среда затрудняет сравнение результатов |
| Состояние приложения | Приложение запущено, нужный экран открыт и находится на переднем плане | Иначе отсутствие видимой реакции ничего не говорит о работе жеста |
Сопоставьте свою среду с требованиями Apple к Xcode. Не переносите вывод о системных требованиях на поддержку жеста: это разные вопросы. Первое относится к хосту, второе — к возможностям Device Hub, описанным в примечаниях к выпуску Xcode 27.3.
Если в команде установлено несколько копий Xcode, зафиксируйте, какая из них открыта и используется для запуска приложения. Не ограничивайтесь тем, что в папке есть нужная версия. Путь запуска и фактически выбранная среда важны, когда результат отличается между локальной машиной и удалённым рабочим местом.
Проверьте ввод Option-перетаскиванием
Чтобы симулировать касание двумя пальцами, зажмите Option и перетаскивайте указатель в Device Hub. Этот способ указан в описании взаимодействия с приложением в Device Hub. Обычное перетаскивание мышью не является подтверждением двухпальцевого ввода.
Проверьте цепочку без изменения проекта:
- Убедитесь, что в Device Hub открыт нужный запущенный симулятор, а приложение находится на переднем плане.
- Выберите участок экрана, где приложение ожидает жест, а не кнопку, текстовое поле или системный элемент.
- Нажмите и удерживайте Option перед началом перемещения указателя.
- Выполните перетаскивание с участком начала и траекторией, которые вы сможете повторить.
- Следите за видимым состоянием интерфейса во время действия и сразу после него.
- Повторите ту же последовательность без изменений, чтобы проверить воспроизводимость.
Здесь важно не приписывать интерфейсу индикацию, которую вы не наблюдали. Запишите конкретный факт: например, изменился ли экран, сработало ли ожидаемое действие или не было заметного эффекта. Если вы не уверены, что именно показывает Device Hub в вашей версии и конфигурации, не трактуйте отсутствие подсказки как доказательство отсутствия ввода.
Быстрая контрольная проверка — открыть минимальный экран приложения, где реакцию на жест легко заметить, и убедиться, что приложение реагирует на другие базовые действия. Это не заменяет теста нужного сценария. Задача проверки — исключить потерю фокуса и ошибку выбора экрана, прежде чем разбирать сложную логику.
Если жест виден, проверьте обработку в приложении
Когда интерфейс меняется, но не так, как ожидалось, перестаньте многократно повторять одно и то же перетаскивание. Разберите обработку жеста на стороне приложения. Проверьте, распознаётся ли нужный тип взаимодействия, совпадает ли область касания с ожидаемой и не перехватывает ли ввод другой обработчик.
Особое внимание уделите состоянию экрана. Например, жест может запускаться только после загрузки содержимого, анимированного перехода или выбора объекта. Если повторить действие до готовности нужного состояния, визуальный результат будет отличаться, хотя инструмент и приложение работают согласно текущему состоянию интерфейса.
Для сравнения используйте одну и ту же точку входа, одну траекторию и одинаковое исходное состояние. Меняйте только один фактор за раз: сначала экран, затем участок касания, затем обработчик или состояние. Сохраняйте минимальные шаги воспроизведения и ожидаемый результат. Так вы сможете отличить ошибку конкретного проекта от ошибки среды, не называя единичное наблюдение общим дефектом Xcode.
При проверке обработчиков жестов сравните результат с тем, что приложение должно делать в соответствующем сценарии. Если вы можете видеть только неправильное изменение интерфейса, но не можете подтвердить внутренний путь события, формулируйте вывод осторожно: «наблюдается некорректная реакция интерфейса», а не «Xcode не передал касание».
Решите, достаточно ли ручной проверки
Device Hub удобен для быстрой ручной проверки и поиска минимального воспроизведения. Но ручная симуляция не равна автоматизированному покрытию и не подтверждает поведение на физическом устройстве. Разделяйте три вида доказательств: действие, выполненное вручную; видимый отклик приложения; результат автоматизированного или аппаратного теста.
Порядок проверки может быть таким:
- Сначала повторите действие в Device Hub и сохраните точные шаги.
- Затем сформулируйте наблюдаемый критерий: какое изменение интерфейса считается успешным.
- Если важно предотвратить регрессию, добавьте проверку в подходящий UI-тест и проверьте его фактическое условие успеха.
- Если результат зависит от поведения устройства или его конфигурации, повторите сценарий на физическом устройстве.
- Сопоставьте журналы, шаги и видимый результат, не подменяя один тип проверки другим.
В документации Apple отдельно описаны возможности тестирования в Xcode и сборка и запуск приложения. Используйте соответствующие инструменты для своего сценария; из наличия ручного жеста не следует, что тот же жест автоматически становится покрытым тестом.
Преимущества ручной симуляции — быстрый просмотр поведения и возможность воспроизвести действие без подготовки отдельного тестового сценария. Ограничения — зависимость от действий оператора, отсутствие автоматической проверки критерия успеха и невозможность считать симуляцию подтверждением поведения на физическом устройстве. Для разовой диагностики ручного воспроизведения может хватить; для регрессионной проверки — нет.
Зафиксируйте воспроизведение и решите, что проверять дальше
Используйте эту карточку как рабочую запись для локальной или удалённой среды. Заполняйте наблюдения, а не предположения.
| Поле записи | Что указать |
|---|---|
| Инструмент | Активная версия Xcode и используемый Device Hub |
| Цель | Симулятор iPhone или iPad, модель и состояние запуска |
| Действие | Где зажат Option, начальная точка и траектория перетаскивания |
| Результат | Видимое изменение интерфейса либо отсутствие заметной реакции |
| Этап сбоя | Не сработал ввод, не совпала реакция приложения или не прошёл тест |
| Повторная проверка | Что повторено без изменений и совпал ли результат |
Перед тем как передать отчёт коллеге, проверьте, что из него можно повторить действие. Формулировка «двумя пальцами не работает» недостаточна: добавьте экран, исходное состояние и наблюдаемый ожидаемый результат. Не включайте секреты, токены, приватные данные или снимки экрана, содержащие пользовательскую информацию.
Пройдите список перед закрытием инцидента:
- [ ] Активная версия Xcode сверена с Xcode 27.3 Beta.
- [ ] Целью выбран iPhone или iPad, а приложение открыто на нужном экране.
- [ ] Option был зажат до начала перетаскивания.
- [ ] Траектория и исходное состояние описаны так, чтобы их можно было повторить.
- [ ] Записано, что именно наблюдалось: ввод, реакция интерфейса или итог теста.
- [ ] При необходимости добавлена автоматизированная проверка или выполнена проверка на физическом устройстве.
- [ ] Вывод не объявляет общий дефект инструмента на основании единичного случая.
Если сбой проявляется только на удалённом Mac, добавьте в карточку способ подключения, настройки управления указателем и место, где выполняется перетаскивание. Наличие удалённого доступа само по себе не доказывает, что Option и движение указателя передаются так же, как при локальном управлении. Проверьте действие в своей конкретной среде; не переносите результат одного подключения на все удалённые конфигурации. Сравнить доступные варианты удалённой работы и условия аренды можно в разделе MACCOME для русскоязычных пользователей.
Когда причиной окажется сама среда разработки, а не код приложения, отдельно оцените рабочий процесс на удалённом Mac. Для этого можно посмотреть варианты аренды Mac mini и сверить их с требованиями вашей команды. У удалённой машины есть реальные ограничения: ввод зависит от канала управления, проверку физического устройства она не заменяет, а постоянно используемый серверный контур требует настройки доступа и сохранения тестовых материалов.
Если вам нужна временная независимая среда для проверки Xcode, аренда MACCOME может быть удобнее покупки Mac только ради разового воспроизведения. Но для длительной непрерывной нагрузки, обязательного доступа к физическим интерфейсам или тестов, где решающим является конкретное устройство, сначала проверьте, подходит ли удалённая среда вообще. В любом случае фиксируйте результат именно для проверенной конфигурации: симуляция Device Hub помогает локализовать проблему, но не превращает ручной опыт в универсальную гарантию.