Сохраните точный URL и место, откуда по нему переходят. Затем выясните, запускается ли приложение вообще или запускается, но показывает главный экран. В первом случае проверяют связь сайта с установленным пакетом и контекст перехода; во втором — обработку входящего маршрута самим приложением.

Не начинайте с удаления приложения у пользователя: можно потерять локальные данные и всё равно не увидеть причину. Подготовьте тестовое устройство и минимальную ссылку без личных параметров. Различайте основной домен, www и другие поддомены: они участвуют в настройке как конкретные назначения.

Двусторонняя связь относится к установленному пакету

Apple Supporting associated domains, проверенный 2 ноября 2026 года, требует association-файл сайта и соответствующий entitlement приложения. Для Universal Links используется сервис applinks. Сопоставьте идентификатор приложения в файле с реальной подписью и bundle установленной версии, а не только с открытым проектом Xcode.

Файл apple-app-site-association размещается без расширения в .well-known и отдаётся по HTTPS с действительным сертификатом без редиректа. Проверьте ответ конкретного host. Условная ссылка на www.example.com не подтверждается тем, что association доступен только у example.com.

НаблюдениеГраница
Всегда SafariКонтекст, host, association
Работает один путьПравила URL
Приложение открылось без объектаОбработка маршрута
После входа главный экранСохранение намерения навигации

У association есть правила компонентов URL. Допущенный путь и исключённый путь могут вести себя по-разному при исправной общей настройке. Сравните один заведомо подходящий маршрут с проблемным, включая query и fragment, если ваши правила их учитывают. Не расширяйте шаблон на все адреса только ради зелёного теста.

Открытая страница Safari меняет контекст проверки

Условный контроль:
https://example.com/.well-known/apple-app-site-association
entitlement: applinks:example.com
путь: /orders/example
холодный старт / работающая копия

Apple описывает поведение, при котором переход в Safari по ссылке того же домена остаётся в Safari. Это может соответствовать намерению продолжить просмотр сайта. Поэтому один такой клик не доказывает поломку Universal Links. Сравните согласованный переход из другого контекста на тестовом устройстве.

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

Для каждой попытки сохраните URL, источник перехода, версию приложения и результат. Если часть ссылок открывается, сузьте отличие до host или правила пути. Если ни одна не запускает приложение, вернитесь к entitlement и association именно отправленного пакета.

Приложение открылось — теперь нужен правильный экран

В документации Supporting universal links in your app входящий переход представлен через NSUserActivity с типом просмотра веб-страницы. Конкретный обработчик зависит от жизненного цикла приложения. Проследите доставку URL в вашем проекте отдельно для холодного запуска и уже работающей копии.

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

Обрабатывайте отсутствующий объект и неверные параметры понятным экраном. Apple предупреждает о проверке входящих URL и недопустимости опасных действий по ссылке. Переход должен открыть безопасный контекст, а не немедленно удалить запись или выполнить операцию без подтверждения и проверки прав.

  1. Зафиксировать URL и источник перехода.
  2. Сопоставить host, association и entitlement пакета.
  3. Проследить получение URL приложением.
  4. Проверить навигацию после входа и отказ по чужому объекту.

Приёмочная матрица включает допустимый путь, исключённый путь, холодный и тёплый запуск, вход и гостевой режим. Для разбора нужны несекретный URL, bundle ID, entitlement установленной сборки, безопасная версия association и журнал получения маршрута. Эти сведения показывают, на какой границе заканчивается корректная доставка ссылки.

Проверенные источники