Валидатор AASA / iOS Universal Links
Примечание: браузеры ограничены CORS, поэтому инструмент получает AASA через публичный прокси. Не вводите чувствительные внутренние адреса; AASA должен быть доступен публично.
Результаты
Источник AASA для проверки/сопоставления
Вставить JSON AASA
Тест соответствия Universal Links
Не выбран корректный AASA
Примечание: здесь проверяется только совпадение на уровне правил AASA; реальное поведение iOS зависит от кеша, состояния установки, версии ОС и источника открытия.
Инструкция (быстрый разбор проблем)
1) Разместить AASA (сервер)
- Разместите файл по адресу `https://<domain>/.well-known/apple-app-site-association` (рекомендуется) или `https://<domain>/apple-app-site-association`.
- Без расширения (без `.json`), доступен по HTTPS и возвращает 200.
- Рекомендуется `Content-Type: application/json` (подписанный AASA может быть `application/pkcs7-mime`).
- Типичная структура: `applinks.apps` равен `[]`; `applinks.details` содержит `appID` и `paths`/`components`.
2) Настроить iOS (клиент)
- В Xcode > Associated Domains добавьте `applinks:your-domain.com` (при необходимости включите поддомены).
- Убедитесь, что `appID` корректен: `<TeamID>.<BundleID>` и соответствует подписи.
- Установите приложение и тестируйте, открывая ссылки из Safari/Заметок/Сообщений.
3) Частые причины неудачи
- Неверный путь/имя файла (нет `.well-known` или ошибочно добавлен `.json`).
- Редирект/авторизация/WAF возвращает HTML.
- Некорректный JSON AASA: отсутствует `applinks.details[].appID` или нет `paths/components`.
- Кеш iOS: изменения могут применяться с задержкой.
- Кеш CDN Apple: `app-site-association.cdn-apple.com` может обновляться не сразу.
4) Быстрые локальные проверки (опционально)
curl -i https://your-domain.com/.well-known/apple-app-site-association
xcrun simctl openurl booted https://your-domain.com/your/path
Примечание: команды могут отличаться в зависимости от версий macOS/iOS; корпоративные сети/прокси могут влиять на загрузку.
Как пользоваться
- Введите домен, связанный с вашим приложением (например, example.com) в поле «Домен / URL сайта».
- Выберите источник AASA (по умолчанию .well-known) и нажмите «Получить и проверить».
- В разделе «Результаты» проверьте HTTP-статус, Content-Type и корректность JSON.
- В разделе «Тест соответствия Universal Links» введите URL и проверьте совпадение с правилами AASA.
Советы
Инструмент использует публичный прокси, чтобы обойти CORS-ограничения браузера.
Файл AASA должен быть доступен по HTTPS и не должен иметь расширение .json.
iOS при проверке Universal Links в первую очередь запрашивает `/.well-known/apple-app-site-association`.
Режим «Вставить вручную» подходит для проверки правил до публикации файла.
