Диплинки
Что такое отпечаток сертификата подписи приложения?
Коротко
Отпечаток сертификата подписи — это SHA-256-хеш сертификата, которым подписано Android-приложение. Его записывают как 32 пары шестнадцатеричных символов через двоеточие. По нему Android точно определяет, какая сборка вправе действовать от имени домена, поэтому в assetlinks.json он указан рядом с именем пакета.
Что он идентифицирует
Любое Android-приложение перед установкой подписывают сертификатом. Отпечаток — короткая сводка этого сертификата фиксированной длины. У двух сборок, подписанных одним ключом, отпечаток одинаковый, а у сборки, подписанной любым другим ключом, он другой.
Для Android App Links это удостоверение личности. Одно только имя пакета может скопировать кто угодно. Имя пакета вместе с отпечатком, опубликованные в assetlinks.json на вашем домене, говорят Android, что открывать ваши ссылки разрешено именно этому подписанному приложению. Поле принимает список, так что один файл может покрывать несколько ключей.
Ловушка Play App Signing
С Play App Signing ключей два. То, что вы загружаете, вы подписываете ключом загрузки. Затем Google Play подписывает приложение, которое попадает на телефоны, ключом подписи приложения — он хранится у Google. Отпечатки у этих двух ключей разные.
Это самая частая причина, по которой App Links работают при тестировании и не работают в продакшене. В документации Android об этом сказано прямо: если вы пользуетесь Play App Signing, отпечаток, который выдаёт keytool на вашем компьютере, обычно не совпадает с тем, что на устройствах пользователей. А отладочная сборка подписана ещё одним, третьим ключом. Если в файле указан только отпечаток с вашей машины, сборка из Play не проходит проверку и ссылки открываются в браузере.
Где взять правильный
Для сборки из Play откройте в Play Console страницу подписи приложения. Там показан сертификат ключа подписи приложения с отпечатком SHA-256 и, по документации Android, готовый фрагмент Digital Asset Links для приложения. Скопируйте все отпечатки, указанные для ключа подписи приложения.
Для ключа, который хранится у вас, выполните keytool -list -v -keystore с файлом хранилища ключей и найдите строку SHA256. Чтобы увидеть, что на самом деле установлено на тестовом телефоне, выполните adb shell pm get-app-links с именем пакета: команда выводит подписи приложения рядом со статусом проверки каждого домена. Сначала внесите в файл отпечаток из Play, а потом добавьте отпечаток ключа загрузки или отладочного ключа, если хотите, чтобы ссылки открывались и в тестовых сборках.
14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5Попробуйте здесь
Создайте файл для своего приложения
Укажите Team ID и bundle ID или имя пакета и отпечаток подписи. Получите готовый файл apple-app-site-association или assetlinks.json, который останется разместить на сервере.
Приложения
Добавьте каждое приложение, которое должно открывать ссылки этого домена. Каждое станет записью в appIDs.
- Приложение 1
10 символов, в аккаунте Apple Developer в разделе Membership details.
Из таргета приложения в Xcode, например com.example.app.
Пути, которые открывают приложение
Правила проверяются сверху вниз, и срабатывает первое совпадение, поэтому ставьте исключения выше общих правил. * означает любое количество символов, ? ровно один.
- Правило 1
пары имя=значение через &
Другие сервисы
Ваш файл
apple-app-site-association
Пример. Введите свои данные, и он заменится.
{
"applinks": {
"details": [
{
"appIDs": [
"ABCDE12345.com.example.app"
],
"components": [
{
"/": "/*"
}
]
}
]
}
}Создаётся в вашем браузере. Никуда не отправляется.
Где разместить файл
Где будет лежать файл
- Загрузите его по адресу
https://ваш-домен/.well-known/apple-app-site-association, без расширения.json. - Отдавайте по HTTPS с действующим сертификатом и сразу с кодом 200, без редиректов.
- Отправляйте заголовок
Content-Type: application/json. - Повторите для каждого хоста в ссылках:
example.comиwww.example.com— разные хосты, и каждому нужны файл и записьapplinks:. - CDN Apple забирает новый файл в течение 24 часов. До этого тестируйте с
?mode=developer.
Не хотите размещать файлы сами? Smart-ссылки бесплатны, а на Enterprise Appy отдаёт оба файла на домене ссылок вашего приложения.
Создать бесплатную ссылкуЧастые вопросы
Где найти отпечаток SHA-256 своего приложения?
Для сборки, которую люди скачивают из Google Play, — в Play Console на странице подписи приложения, в блоке сертификата ключа подписи приложения. Для хранилища ключей на своём компьютере выполните keytool -list -v -keystore с файлом хранилища. При включённом Play App Signing эти два значения различаются.
Чем ключ загрузки отличается от ключа подписи приложения?
Ключ загрузки — ваш. Им вы подписываете бандл, который отправляете в Play Console. Ключ подписи приложения хранится у Google Play, и им подписано приложение, которое доставляется на устройства. Android сверяет ссылки с доставленным приложением, поэтому в assetlinks.json нужен отпечаток ключа подписи приложения.
Может ли в assetlinks.json быть несколько отпечатков?
Да. sha256_cert_fingerprints — это массив, и в документации Android сказано, что несколько отпечатков позволяют поддерживать разные версии приложения, например отладочную и продакшен-сборку. Если указать ключ подписи приложения из Play и свой отладочный ключ, ссылки будут открываться в обеих.
Связанные термины
- Файл 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 не пройдут проверку, и ссылки будут открываться в браузере.
- Android App Links
Android App Links — https-ссылки, принадлежность которых вашему приложению проверил Android, поэтому нажатие открывает приложение сразу, без вопроса, чем открыть. Они работают на Android 6 и новее на устройствах с сервисами Google. Нужны intent filter с autoVerify и файл assetlinks.json на вашем домене.
- Bundle ID
Bundle ID — уникальная строка, которая обозначает приложение на iOS, например com.example.app. На Android ей соответствует application ID, который обычно называют именем пакета. Обе строки вы выбираете сами, обычно их записывают в виде перевёрнутого домена, и после публикации приложения менять их не стоит. Имя пакета используется в ссылках на Google Play и в assetlinks.json.
Одна ссылка на App Store, Google Play и сайт
На бесплатном тарифе Appy — 4 ссылки с QR-кодами. Каждый телефон попадает в свой магазин: App Store, Google Play, AppGallery, Galaxy Store или GetApps, а компьютер — на сайт. Без рекламы и без банковской карты.