App Link (Android)

Определение App Link

App Link — встроенный механизм Android (появился в версии 6.0 Marshmallow, 2015) для автоматического открытия приложения по обычной HTTPS-ссылке. Когда пользователь нажимает на URL или сканирует QR-код, система проверяет: есть ли установленное приложение, которое «владеет» этим доменом. Если да — открывается приложение напрямую, без системного диалога «Выберите приложение» и без браузера.

До Android 6.0 разработчики использовали custom URI-схемы вроде myapp://product/123. Главная проблема: любое стороннее приложение могло объявить ту же схему, что создавало конфликты и диалоги выбора. App Link решает это через верификацию владения доменом — никто не может выдать себя за ваш HTTPS-домен.

Аналог технологии на iOS — Universal Link. Оба механизма преследуют одну цель, но настраиваются по-разному и не совместимы друг с другом.

Как настроить assetlinks.json

Настройка требует двух вещей: файла на сервере и флага в манифесте приложения.

1. Файл assetlinks.json размещается строго по адресу https://ваш-домен.ru/.well-known/assetlinks.json. Файл должен отдаваться с MIME-типом application/json, без редиректов, без авторизации. Содержимое — массив объектов с SHA-256 fingerprint подписи вашего APK:

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

SHA-256 fingerprint берётся из подписи APK командой keytool -printcert -jarfile release.apk. Для отладочной сборки и продакшн-ключа fingerprint разный — обычно добавляют оба в массив.

2. Флаг в AndroidManifest.xml. В <intent-filter> добавляется android:autoVerify="true":

<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="ваш-домен.ru" />
</intent-filter>

При установке приложения Android автоматически обращается к файлу assetlinks.json и верифицирует связку домен–приложение. Если верификация прошла — система запоминает, что этот домен «принадлежит» приложению, и больше не показывает диалоги.

Проверить результат можно через инструмент Digital Asset Links в Google Search Console или командой ADB: adb shell am start -a android.intent.action.VIEW -d "https://ваш-домен.ru/path".

App Link vs Intent URI vs Custom Scheme

Три способа открыть приложение из внешней ссылки принципиально отличаются поведением:

• Custom URI-схема (myapp://): самый простой вариант, но не работает если приложение не установлено — вместо fallback браузер просто выдаёт ошибку. Плюс любое приложение может перехватить схему.
• Intent URI (intent://...): специфично для Android, позволяет передать параметры и задать fallback-URL. Не поддерживается браузерами напрямую — нужен JavaScript-обёртка или специальная страница-роутер.
• App Link: обычная HTTPS-ссылка. Работает в браузере, QR-кодах, email, мессенджерах. Если приложение не установлено — пользователь просто попадает на веб-страницу (хороший fallback). Верификация через assetlinks.json исключает конфликты.

Для QR-кодов App Link — оптимальный выбор: в QR зашивается обычный HTTPS-URL. Пользователь с установленным приложением попадает в него напрямую, остальные видят веб-страницу. Один QR-код работает для всех. Подробнее — в материале про deep link vs QR.

Частые вопросы