iOS / Android Dev Tools

валидатор AASAУзнайте, какое правило сработало первым

Вставьте JSON и несколько URL; при необходимости укажите App ID. Запросы к введённому домену не отправляются.

валидатор AASA

Ввод

Отчёт

Измените пример и запустите проверку.

Проверка идёт в этой вкладке. Запросы к введённым доменам и URL не отправляются.

Параметры

Оставьте пустым для всех объявленных App ID; введённый ID должен совпасть точно.

Измените пример и запустите проверку.

Когда часть ссылок открывает приложение, а часть остаётся в Safari, валидатор AASA помогает до публикации понять, какое правило первым захватило путь. Одна лишь правильная синтаксическая форма JSON не объясняет скрытое исключение.

Этот валидатор AASA работает только с вставленным текстом и показывает выбранный App ID и правило. Раздачу файла сервером, кеш Apple CDN и запуск установленного приложения нужно проверять отдельно.

Зачем запускать валидатор AASA заранее

Разделить результаты до развёртывания

Валидатор AASA проводит несколько URL через один упорядоченный список правил и различает разрешение, исключение и отсутствие совпадения. Слишком широкий путь заметен ещё до публикации.

Локальный документ с правилами разделяет пути URL на разрешённые, исключённые и без совпадения; облако отключено.

Найти перекрытое исключение

Общее правило выше по списку может сработать раньше запрета. Валидатор AASA показывает номер решающего правила и предупреждает о явно скрытых последующих пунктах.

Широкое верхнее правило перехватывает путь, прежде чем он достигнет исключения ниже.

Читайте трассу отдельно от проверки телефона

01

Вставьте весь объект ассоциации

Нужен полный JSON с applinks.details. Пример использует современные appIDs и components; прежние appID и paths тоже поддерживаются. Ошибка синтаксиса содержит строку и столбец.

  • В примере есть разрешённый путь, исключение и условие запроса.
02

Укажите URL и приложение

Введите по одному HTTPS-адресу или пути с начальным / в строке. Пустой фильтр App ID показывает все объявленные приложения; любое изменение делает прежний отчёт устаревшим.

  • Ctrl/Cmd + Enter запускает ручную проверку без обращения к URL.
03

Проверьте первое решающее правило

Перед экспортом посмотрите индексы details и правила. Локальное разрешение означает лишь выбор приложения вставленным JSON; серверные и аппаратные пункты остаются непроверенными.

  • Устаревший отчёт нельзя скопировать или скачать.

Объяснение для каждой пары URL и приложения

Новый и прежний синтаксис

components сравнивает путь, запрос, фрагмент и exclude; старый paths обрабатывает NOT по порядку. Два формата не смешиваются.

Результаты по App ID

Сравните URL со всеми объявленными ID или выберите один точно. Отсутствующий ID отделён от пути без совпадения.

Отчёт для выпуска

Валидатор AASA экспортирует замечания о структуре, строки ввода, индексы решающих правил и непроверенные задачи развёртывания.

Границы локального вывода

Сайт не опрашивается
Валидатор AASA не запрашивает домен. TLS, перенаправления, Content-Type, публичный доступ и кеш Apple CDN всегда помечены как непроверенные.
Неизвестная семантика остаётся неопределённой
substitutionVariables, смешанные форматы и неподдерживаемые ключи components не превращаются в ложное «не совпало»; вывод отмечается как неопределённый.
Подпись приложения не видна
Формат Team ID.Bundle ID можно оценить в JSON, но валидатор AASA не читает подписанный entitlement, предпочтения устройства или контекст перехода Safari.
Другие службы вне проверки
webcredentials, appclips и Android assetlinks.json не анализируются. Успешный разбор applinks не подтверждает весь файл.

Частые вопросы про валидатор AASA

Почему универсальная ссылка открывается в браузере при правильном AASA?

Валидатор AASA проверяет только вставленные правила. На iOS также влияют размещение файла, CDN, Associated Domains, установка и место нажатия. Закончите список проверок и испытайте ссылку на устройстве.

Где разместить файл apple-app-site-association?

На том же хосте по пути /.well-known/apple-app-site-association или в корне, без расширения и перенаправления. Эта страница не подтверждает фактический ответ сервера.

Как проверить исключения и порядок правил paths?

Введите точный URL. Отчёт различает исключение и отсутствие совпадения и показывает первое решающее правило. Более раннее * может скрыть последующий NOT.

Проверяет ли локальный валидатор CDN Apple?

Нет. Валидатор AASA не отправляет сетевых запросов. После публикации проверьте копию CDN и тестовое устройство отдельно.

Почему iPhone использует старую версию AASA?

На обновление могут влиять кеш Apple CDN и устройство. Локальная проверка не получает опубликованный файл, поэтому сравните копию CDN и повторите реальный тест.

Остались вопросы по правилу?

Запустите валидатор AASA до публикации

Проверьте реальный URL с нужным App ID и передайте непроверенные серверные пункты в выпускной список.