Адаптация Siri AI для iOS 27: миграция и тестирование App

Если вашему приложению нужно поддержать новую Siri в iOS 27, одной совместимости со старыми командами SiriKit уже недостаточно. Адаптация Siri AI для iOS 27 требует заново описать действия и данные приложения через App Intents, проверить их обнаружение в Spotlight и Siri, а также отдельно протестировать межприложные сценарии и контекст экрана. Ниже — практическая схема миграции с таблицей решений, примерами для календаря и последовательностью App Intents-тестов перед отправкой сборки на проверку.

Что именно меняется для существующего приложения

В старой архитектуре Siri чаще вызывала заранее определённый интент: создать событие, показать заказ, начать тренировку или открыть нужный экран. Новая модель должна дать системе больше структурированных данных: какие сущности есть внутри приложения, какие параметры допустимы, какие действия безопасны без открытия интерфейса и какой результат можно вернуть пользователю.

Это означает, что Siri AI не должна восприниматься как ещё один голосовой экран приложения. Для разработчика это скорее дополнительный системный слой доступа к бизнес-логике. Пользователь может сформулировать запрос свободнее, а система попытается сопоставить его с вашими интентами, сущностями и схемами.

Apple указывает, что SiriKit и связанные с ним фреймворки остаются механизмом совместимости для прежних сценариев, тогда как для современной интеграции, включая Apple Intelligence, рекомендуется App Intents. (developer.apple.com)

На практике отсутствие адаптации приводит к нескольким потерям:

1. Приложение хуже обнаруживается. Если события, документы или проекты не представлены как App Entity и не индексируются, Siri и Spotlight не получают достаточно структурированной информации для поиска.
2. Действия остаются изолированными. Старый интент может работать только в привычной форме, но не участвовать в новых цепочках с данными других приложений.
3. Не хватает параметров для естественного запроса. Пользователь говорит «поставь встречу с командой на завтра после обеда», а приложение умеет принять только заранее сформированную дату и название.
4. Сложнее контролировать разрешения. Действия с календарём, сообщениями, оплатой или персональными данными должны иметь понятную границу между просмотром и изменением.
5. Тесты на старой системе дают ложную уверенность. SiriKit-команда может пройти проверку на iOS 18 или iOS 19, но это не доказывает, что сущность найдётся через Spotlight или будет корректно передана в App Intent на iOS 27.

Важно: не пытайтесь сразу перенести все функции. Сначала выберите несколько частых и понятных операций, где ошибка не приводит к потере данных.

SiriKit, App Shortcuts и App Intents: что оставить

Эти технологии решают разные задачи. SiriKit — прежний слой интеграции, App Intents — основной современный механизм описания действий и данных, а App Shortcuts — удобный способ показать самые востребованные действия с готовыми фразами и метаданными.

Для проекта с минимальной версией iOS ниже версии, где доступен полный современный стек, разумно оставить SiriKit как совместимый слой. Новые функции при этом лучше реализовывать через App Intents, а старые операции переносить по приоритету.

Apple отдельно отмечает, что App Shortcuts связывают интент с названием, изображением и фразами, которые пользователь может произнести. В документации также рекомендуется не превращать в App Shortcuts весь каталог приложения: обычно достаточно наиболее частых действий, а не десятков редко используемых команд. (developer.apple.com)

Критерии решения о миграции

Оставляйте SiriKit без немедленной замены, если:

• действие уже стабильно работает;
• оно нужно только на старых версиях iOS;
• у него нет сложных сущностей и свободного поиска;
• сценарий не должен участвовать в цепочке с другими приложениями.

Планируйте перенос в App Intents, если:

• команда должна находиться через Siri AI, Spotlight и Shortcuts;
• интент принимает объект вашего приложения, например событие или проект;
• пользователю нужно выбирать параметры естественным языком;
• операция должна возвращать структурированный результат;
• вы хотите связать действие с системной схемой календаря, напоминаний, почты или поиска.

Как начать адаптацию: инвентаризация функций

Перед написанием кода составьте таблицу всех шести существующих SiriKit-операций календарного приложения. Для каждой функции зафиксируйте:

• пользовательскую фразу;
• обязательные и необязательные параметры;
• используемую сущность;
• операцию чтения или изменения;
• требуемое разрешение;
• результат выполнения;
• допустимый сценарий отмены;
• версию iOS, на которой функция должна сохраниться.

Например:

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

В качестве базы можно использовать официальный раздел Apple об App Intents и сущностях. App Entity описывает тип или концепцию приложения, которую система может использовать для разрешения параметров, поиска и взаимодействия через Siri или Shortcuts. (developer.apple.com)

Как построить App Intent для календаря

Рассмотрим действие «создать встречу». Его нельзя проектировать как метод, который просто получает строку и вызывает внутренний сервис. Системе нужно понять название, дату, участников, календарь и, возможно, место встречи.

Минимальная модель должна включать:

1. title — название события;
2. startDate — начало;
3. duration или endDate — длительность;
4. calendar — целевой календарь;
5. notes — необязательное описание;
6. attendees — участники, если ваш продукт их поддерживает;
7. результат выполнения — созданное событие или понятная ошибка.

В кодовой архитектуре держите perform() тонким. Он должен:

• проверить параметры;
• запросить разрешение, если это необходимо;
• вызвать общий сервис календаря;
• вернуть типизированный результат;
• сформировать понятное сообщение для голосового режима.

Не переносите бизнес-логику из основного приложения непосредственно в App Intent. Иначе у вас появятся две реализации создания события: одна для интерфейса, вторая для Siri. Через несколько релизов они начнут расходиться.

Если действие соответствует известной системной области, используйте App Schema. Apple описывает схемы как способ сообщить системе, что конкретный интент представляет стандартную операцию — например, действие календаря или поиска. Для этого применяются схемы AppIntent, AppEntity и AppEnum, а не только произвольные пользовательские названия. (developer.apple.com)

Схема полезна по трём причинам:

• она снижает неоднозначность при сопоставлении запроса;
• помогает системе понять тип данных;
• делает действие более пригодным для межсистемных сценариев.

Если стандартной схемы недостаточно, используйте собственный App Intent, но дайте ему точное локализованное описание и предсказуемые параметры.

App Entities и Spotlight: почему Siri не находит события

Многие команды ошибочно проверяют только выполнение действия. Но до выполнения Siri должна найти нужную сущность. Для календарного приложения это может быть событие «Планирование релиза», календарь «Команда iOS» или участник «Алексей».

Для каждой сущности определите:

• стабильный идентификатор;
• отображаемое имя;
• краткое описание;
• свойства, по которым пользователь может её узнать;
• метод поиска;
• метод получения объекта по идентификатору;
• URL или маршрут для открытия в приложении;
• правила синхронизации и обновления.

Не используйте изменяемое название как единственный идентификатор. Если пользователь переименовал событие, Siri должна по-прежнему найти тот же объект, а не создать новый.

Apple указывает, что App Entities помогают системе разрешать параметры интентов, а индексируемые сущности можно сделать доступными для Spotlight. При поиске система может использовать найденную сущность, чтобы открыть приложение и перейти к соответствующему содержимому. (developer.apple.com)

Для календаря проверьте минимум четыре сценария:

• найти событие по точному названию;
• найти событие по части названия;
• найти ближайшее событие в диапазоне дат;
• открыть найденное событие после выбора из нескольких совпадений.

Если после переноса часть событий пропадает, проверьте:

1. вызывается ли обновление индекса после создания или изменения события;
2. совпадает ли идентификатор в базе и в App Entity;
3. возвращает ли запрос пустой массив при отсутствии результата;
4. корректно ли обрабатывается часовой пояс;
5. не фильтруются ли события по календарю или учётной записи слишком рано.

Межприложные операции и контекст экрана

Сценарий «найди время в календаре и отправь его в сообщении» состоит не из одной команды. Он требует, чтобы ваше приложение корректно отдало структурированный результат следующему действию, а пользователь мог подтвердить чувствительную операцию.

Разделите такие сценарии на три уровня:

1. Чтение. Получить событие, свободное время или список календарей.
2. Подготовка. Сформировать черновик приглашения, сообщения или напоминания.
3. Изменение. Отправить сообщение, создать встречу или удалить запись.

Без подтверждения допустимы только безопасные операции чтения, если это соответствует вашей модели доступа. Отправка сообщения, приглашение участников, удаление события и передача персональных данных должны иметь явный контроль пользователя.

Контекст экрана следует обрабатывать как входной сигнал, а не как безусловное разрешение на действие. Если пользователь находится на экране встречи, можно предложить открыть именно это событие. Но нельзя считать, что видимый текст автоматически даёт право изменить его или передать третьему приложению.

Проверьте:

• какой объект считается текущим;
• может ли экран содержать несколько сущностей;
• что происходит при отсутствии авторизации;
• какие поля разрешено передавать наружу;
• как приложение ведёт себя после закрытия исходного экрана;
• возвращается ли пользователю результат или причина отказа.

Важно: для финансовых, медицинских, коммуникационных и удаляющих операций проектируйте отдельную ветку подтверждения. Удобство Siri не должно превращаться в неконтролируемое выполнение команды.

Пошаговый план миграции в Xcode 27

Ниже — рабочая последовательность, которую можно использовать для проекта с несколькими разработчиками.

Шаг 1. Зафиксируйте матрицу совместимости

Запишите минимальную версию iOS, поддерживаемые устройства, версии Swift и схему сборки. Отдельно укажите, какие SiriKit-интенты должны продолжить работу на старых системах.

Не смешивайте миграцию и обновление всей архитектуры приложения. Для первого прохода создайте отдельную ветку и ограничьте объём двумя или тремя операциями.

Шаг 2. Подготовьте Xcode 27 и тестовое устройство

Установите нужную тестовую версию Xcode 27 в отдельную среду. Проверьте подпись, профиль разработчика, entitlements, разрешения календаря и локализацию.

Основной Mac лучше не переводить на тестовую систему без необходимости. Если команда выпускает рабочие сборки ежедневно, отдельный Mac снижает риск конфликта SDK, симуляторов и сертификатов.

Шаг 3. Создайте App Entity для ключевой модели

Начните с CalendarEvent. Добавьте стабильный идентификатор, отображение, свойства для поиска и запрос по идентификатору. После этого подключите индексацию и проверьте обновление при изменении события.

Не начинайте с самого сложного объекта. Хорошая первая сущность должна быстро находиться, иметь однозначное имя и не требовать большого числа разрешений.

Шаг 4. Перенесите один SiriKit-сценарий в App Intent

Выберите безопасную операцию — например, «показать ближайшие события». Реализуйте параметры, perform(), результат и обработку пустого ответа.

На этом этапе не добавляйте голосовые фразы для всех вариантов. Сначала добейтесь того, чтобы интент запускался напрямую и возвращал корректный результат.

Шаг 5. Добавьте App Shortcut

Для наиболее востребованного действия задайте короткое название, иконку и несколько естественных фраз. Не пытайтесь перечислить все формулировки пользователя: система использует смысловое сопоставление, но слишком похожие или расплывчатые фразы могут усложнить диагностику. (developer.apple.com)

Шаг 6. Подключите системную схему

Если действие относится к календарю, поиску, напоминаниям или другой поддерживаемой области, проверьте, можно ли использовать соответствующую схему. Схема должна описывать реальную семантику операции, а не служить декоративной аннотацией.

Шаг 7. Подключите межприложный результат

Передайте в следующий сценарий не строку, сформированную для интерфейса, а структурированный объект с необходимыми полями. Отдельно проверьте случай, когда найдено несколько событий.

Шаг 8. Добавьте негативные тесты

Проверьте отсутствие разрешения, просроченный идентификатор, конфликт часовых поясов, пустой результат, дубликаты и отмену пользователем. Для операций изменения добавьте проверку повторного запуска, чтобы команда не создала два одинаковых события.

Как организовать App Intents тестирование

Apple предоставляет App Intents Testing для проверки интентов, сущностей, перечислений и запросов вне основного процесса приложения. Такой подход позволяет тестировать интеграцию близко к тому, как её вызывают Siri или Shortcuts, а также проверять связи с Siri и Spotlight. (developer.apple.com)

Рекомендуемый порядок выглядит так:

1. Модульный уровень. Проверьте преобразование параметров, идентификаторы и бизнес-правила.
2. App Intents Testing. Запустите интент вне UI, передайте валидные и невалидные параметры, проверьте тип результата.
3. Shortcuts. Убедитесь, что действие появляется с правильным названием и принимает выходные данные предыдущего шага.
4. Spotlight. Найдите сущность по названию, части названия и дополнительному признаку.
5. Siri. Выполните голосовые фразы с разными датами, именами и вариантами порядка слов.
6. Сквозной сценарий. Найдите событие, выберите его, измените или передайте результат в другое приложение.
7. Регрессия. Повторите базовые SiriKit-команды на минимальной поддерживаемой версии iOS.

Для каждого теста сохраняйте не только факт успеха, но и:

• распознанные параметры;
• выбранную сущность;
• текст или тип ошибки;
• требование разрешения;
• состояние базы до и после выполнения;
• факт появления результата в Spotlight.

Разбор типичных ошибок

Siri не находит нужную сущность

Сначала проверьте индексацию и стабильность идентификатора. Если Spotlight не видит объект, бессмысленно начинать с настройки голосовой фразы. Затем проверьте локализованные названия и свойства, которые используются в запросе.

Интент появляется, но не запускается

Причиной часто бывает отсутствие обязательного параметра, ошибка в типе результата или неправильная регистрация App Shortcut. Запустите интент напрямую через App Intents Testing и исключите UI из цепочки.

Дата определяется неверно

Проверьте часовой пояс, локаль устройства и преобразование «завтра», «в пятницу», «после обеда». Храните внутреннее значение времени в однозначном формате, а локализованное описание используйте только на границе системы.

После миграции Spotlight показывает не все события

Проверьте повторную индексацию после изменений, обработку удалённых объектов и фильтры по календарям. В одном из типичных сценариев команда переносит интенты, но забывает обновить механизм публикации сущностей — в результате новая команда работает по идентификатору, а обычный поиск остаётся неполным.

Изменяющая команда выполняется без подтверждения

Проверьте дизайн результата и ветку авторизации. Разделите «подготовить» и «выполнить». Для удаления или отправки данных возвращайте состояние, в котором пользователь должен подтвердить действие.

Кейс: команда из четырёх человек и календарное приложение

Рассмотрим команду из четырёх человек, у которой уже есть шесть SiriKit-операций. После частичного переноса в App Intents разработчики обнаружили, что некоторые события не находятся через Spotlight. Одновременно нельзя было обновить основной Mac команды: на нём выполнялись релизные сборки, а тестовая ветка iOS 27 требовала отдельного набора инструментов.

Для изоляции проверки команда использовала экземпляр zovcloud со следующей конфигурацией:

• Mac на M4;
• 10 ядер CPU;
• 16 ГБ объединённой памяти;
• SSD 256 ГБ;
• выделенная полоса 1 Гбит/с;
• узел в Токио и узел на западе США;
• посуточная стоимость — 16,90 доллара;
• недельная стоимость — 51,90 доллара.

По данным тарификации zovcloud, пять дней проверки при посуточной аренде составляют 84,50 доллара. Недельный тариф за тот же период — 51,90 доллара, то есть при заранее известном окне тестирования экономия относительно пяти отдельных суток составит 32,60 доллара.

Команда разделила работу так:

1. первый разработчик перенёс модели сущностей;
2. второй проверил App Intents и общую бизнес-логику;
3. третий занимался Spotlight и разрешениями;
4. тестировщик выполнял голосовые и межприложные сценарии.

Сначала использовали узел в Токио, чтобы проверить задержку для участников в Азии, затем повторили сборку и основные сценарии на узле в США. Это не заменяет тестирование на физических iPhone, но позволяет отдельно проверить окружение Xcode 27, подпись, сборку, логику интентов и стабильность удалённого доступа.

Для команд, которые регулярно собирают iOS-проекты на удалённом Mac, полезно сопоставить этот сценарий с руководством по облачному Mac для iOS и Xcode. Если нужен только короткий период совместимости, сначала сравните варианты в тарифах аренды Mac, а затем закажите отдельную среду через форму аренды Mac.

Что проверить перед отправкой сборки

Перед публикацией составьте финальный чек-лист:

• все важные SiriKit-сценарии сохранены на старых версиях iOS;
• новые действия представлены через App Intents;
• App Entity имеет стабильный идентификатор;
• сущности обновляются после создания, изменения и удаления;
• App Shortcuts содержат только действительно частые операции;
• стандартная схема выбрана по смыслу;
• чтение и изменение данных разделены;
• опасные операции требуют подтверждения;
• разрешения проверены для чистой установки;
• пустые результаты отображаются понятно;
• несколько совпадений не приводят к случайному выбору;
• даты проверены в разных часовых поясах;
• Shortcuts получает и передаёт структурированные результаты;
• Spotlight находит новые и изменённые записи;
• Siri понимает несколько естественных формулировок;
• тесты выполнены на физическом устройстве;
• проверена сборка с чистым кэшем и новой учётной записью.

Автоматизированные тесты не отменяют ручную проверку на устройстве. Apple прямо предупреждает, что поведение тестовых систем может меняться, поэтому интеграцию необходимо проверять на финальной версии операционной системы перед выпуском. (developer.apple.com)

Итог: как не сорвать релиз из-за Siri AI

Для существующего приложения адаптация Siri AI для iOS 27 — это не массовая замена всех старых интентов. Надёжная стратегия состоит из пяти этапов: выбрать несколько полезных действий, описать сущности, перенести критичные операции в App Intents, подключить индексацию и провести раздельные тесты Siri, Shortcuts и Spotlight.

Обновление основного Mac под тестовую среду может нарушить текущие сборки, занять время на восстановление сертификатов и создать конфликт версий Xcode. Покупка отдельного Mac решает проблему, но требует капитальных затрат, обслуживания и постоянного хранения устройства. Для короткой миграции практичнее сначала арендовать независимый Mac, выполнить сборку Xcode 27 и провести регрессию Siri AI, а затем решить, нужна ли постоянная машина. Если тестирование занимает несколько дней, посуточная аренда zovcloud сохраняет гибкость; при межрегиональной проверке или более длинном окне выгоднее перейти на недельный тариф.