Диплинки
Что такое файл apple-app-site-association?
Коротко
apple-app-site-association (AASA) — JSON-файл по адресу https://<домен>/.well-known/apple-app-site-association, который подтверждает, что домен связан с вашим приложением. В нём перечислены ID приложений (Team ID и bundle ID) и пути, которые должны открываться в приложении. Без этого файла Universal Links не работают, и ссылки домена просто открывают сайт.
Что внутри и как его отдавать
Главное в файле — блок applinks: ID приложения в формате TEAMID.com.example.app и правила paths или components, которые описывают, какие адреса открывают приложение. Файл отдают по HTTPS, без редиректов и без расширения .json в имени. Один файл может описывать несколько приложений и исключения: например, открывать в приложении всё, кроме раздела /blog.
Когда Apple его читает
Телефон не ходит за файлом на ваш сервер сам. Его забирает CDN Apple, когда приложение устанавливают или обновляют, и отдаёт устройству свою копию. Поэтому исправленный файл доходит до пользователей с задержкой, а старая версия с ошибкой какое-то время продолжает жить в кэше.
Частые ошибки
Редирект с example.com на www.example.com, файл за авторизацией или защитой от ботов, опечатка в JSON, неверный Team ID. Любая из этих ошибок молча выключает Universal Links: ссылки продолжают открываться, только уже на сайте. Проверяйте файл после каждого переезда сайта на новый хостинг или CDN — его легко потерять по дороге.
https://example.com/.well-known/apple-app-site-associationСвязанные термины
- Universal Links
Universal Links — обычные https-ссылки, которые на iPhone и iPad открывают установленное приложение вместо сайта. Apple ввела их в iOS 9. Нужны две части: entitlement Associated Domains в приложении (applinks:example.com) и файл apple-app-site-association на домене. Если приложения нет, по той же ссылке откроется сайт.
- Файл assetlinks.json
assetlinks.json — файл Digital Asset Links по адресу https://<домен>/.well-known/assetlinks.json. Он сообщает Android, какому приложению доверено открывать ссылки домена: в нём указаны отношение delegate_permission/common.handle_all_urls, имя пакета (package_name) и SHA-256-отпечатки сертификата подписи. Без этого файла Android App Links не пройдут проверку, и ссылки будут открываться в браузере.
Одна ссылка на App Store, Google Play и сайт
На бесплатном тарифе Appy — 4 ссылки с QR-кодами. Каждый телефон попадает в свой магазин: App Store, Google Play, AppGallery, Galaxy Store или GetApps, а компьютер — на сайт. Без рекламы и без банковской карты.