iOS и Android подтверждают владение доменом разными файлами. Если Universal Link работает на iPhone, на Android всё равно нужны `<intent-filter android:autoVerify="true">` и `/.well-known/assetlinks.json`. Самая частая производственная ошибка — в JSON оставлен SHA-256 debug-ключа, а Google Play установил APK/AAB, подписанный ключом Play App Signing.

Разделите тест на две части. Сначала Android должен признать домен verified и выбрать пакет. Только затем имеет смысл чинить роутер приложения: он может получить правильный Intent, но потерять path/query при cold start или повторном открытии.

Минимальный intent-filter объявляет весь допустимый host

<intent-filter android:autoVerify="true">
  <action android:name="android.intent.action.VIEW" />
  <category android:name="android.intent.category.DEFAULT" />
  <category android:name="android.intent.category.BROWSABLE" />
  <data android:scheme="https" android:host="app.example.com" />
</intent-filter>

Фильтр находится у Activity, которая принимает ссылку. Не смешивайте в одном фильтре несвязанные scheme/host, если их комбинации не должны все поддерживаться. На Android 15+ серверные Dynamic App Links могут уточнять пути, но не расширяют область, объявленную статически в manifest.

assetlinks.json связывает домен и release-пакет

[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.example.app",
    "sha256_cert_fingerprints": ["AA:BB:...:FF"]
  }
}]

Файл отдаётся по HTTPS на каждом объявленном hostname по точному пути `/.well-known/assetlinks.json`, как JSON и без перенаправления на www или другой host. Для Play App Signing берите fingerprint сертификата, которым Google подписывает поставляемую пользователю сборку, а не только upload key.

Состояние домена читается с устройства

adb shell pm get-app-links com.example.app
adb shell pm verify-app-links --re-verify com.example.app
adb shell pm get-app-links com.example.app

adb shell am start -a android.intent.action.VIEW \
  -c android.intent.category.BROWSABLE \
  -d "https://app.example.com/orders/42?source=test"

Команды выполняют на тестовом устройстве с нужной сборкой. Повторная верификация может быть асинхронной, поэтому итог смотрят отдельным `get-app-links`. На новых версиях Android также учитывается пользовательское разрешение «Open supported links»: verified-домен может быть вручную отключён.

Таблица результатов экономит переустановки

НаблюдениеСлойЧто исправлять
домен не verifiedwebsite associationURL JSON, redirect, package, fingerprint
verified, но открывается браузервыбор обработчика/настройка пользователяsupported links и конкурирующие приложения
Activity открылась, экран не тотapp routerpath/query и таблица маршрутов
работает после запуска, не работает cold startlifecycleinitial intent/link до инициализации router
debug работает, release нетподпись/manifest variantrelease fingerprint и merged manifest

Кроссплатформенный плагин не заменяет настройку ОС

Flutter или React Native библиотека получает ссылку после того, как Android уже выбрал приложение. Она не публикует assetlinks.json и не исправляет manifest автоматически во всех build variants. Запишите входной URI в начале lifecycle без персональных query-параметров и убедитесь, что один URL одинаково обрабатывается при cold start, warm start и resume.

  • Нормализуйте только известные route, не исполняйте произвольный redirect из query.
  • Не считайте неизвестный path успешным — откройте безопасный fallback-экран.
  • Сохраните query до готовности router, но не пишите токены в аналитические логи.
  • Проверьте несколько build flavors: package name и fingerprint у них различаются.
  • Оставьте веб-страницу полезным fallback для устройства без приложения.

Контрольный набор покрывает реальные источники ссылки

  1. Установить release из того же канала, что используют пользователи.
  2. Проверить domain state и запустить ADB Intent с полным URL.
  3. Открыть ссылку из Chrome, почты и мессенджера — их in-app browser может вести себя иначе.
  4. Повторить при закрытом и открытом приложении.
  5. Проверить URL с query, trailing slash и percent-encoding.
  6. Удалить приложение: тот же URL должен открыть рабочую веб-страницу.
  7. Зафиксировать Android version, package, versionCode и источник установки.

Для диагностики достаточно merged manifest, содержимого публичного assetlinks.json, вывода `pm get-app-links`, release package/versionCode и обезличенного URL. Keystore, пароли и приватные ключи не передавайте. Успех — verified state плюс правильный экран во всех трёх состояниях lifecycle.

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