В этом руководстве описаны распространенные проблемы и способы их устранения. Вы также можете использовать инструменты устранения неполадок на странице "Ссылки на контент" в Play Console или App Links Assistant в Android Studio. Подробнее об инструментах разработчика для ссылок на приложения…
Ссылка на приложение открывается в браузере, а не в приложении
- Проблема. Вы нажимаете на ссылку, которая должна открывать приложение, но она открывается в браузере или появляется диалоговое окно с вопросом о том, как открыть ссылку.
- Решение
- Проверьте файл
assetlinks.json. Это должен быть действительный файл JSON, доступный по путиhttps://<your-domain>/.well-known/assetlinks.jsonи передаваемый через HTTPS без переадресаций. Используйте онлайн-валидатор. - Проверьте цифровой отпечаток SHA-256. Убедитесь, что цифровые отпечатки
sha256_cert_fingerprintsв файлеassetlinks.jsonточно соответствуют цифровым отпечаткам ключа подписи для выпуска приложения (если вы используете функцию подписания приложений в Google Play, возьмите цифровой отпечаток из Play Console). Подпись должна быть написана заглавными буквами. - Проверьте
autoVerify. Фильтр<intent-filter>в файлеAndroidManifest.xmlдолжен содержатьandroid:autoVerify="true. - Проверьте, нет ли переадресации на стороне сервера. Переадресация с
httpнаhttpsили с домена без www наwwwможет привести к ошибке подтверждения. - Принудительная повторная проверка: Запустите команды adb в руководстве Протестируйте ссылки на приложение, чтобы получить новые результаты проверки.
- Диагностика разрешения ссылок (Android 17 и более поздние версии). Выполните команду
adb shell am start --debug-link -a android.intent.action.VIEW -d "<URL>", чтобы проверить, какие приложения-кандидаты, фильтры intent в манифесте и правила динамических ссылок на приложение соответствуют URL. Подробнее о том, как диагностировать проблемы с разрешением ссылок с помощью флага debug-link…
- Проверьте файл
Не обновляются динамические правила на Android 15 и более поздних версий
- Проблема. Вы обновили правила в файле
assetlinks.json, но новые ссылки не обрабатываются приложением. - Решение
- Выполните принудительную проверку повторно. Выполните повторное извлечение с помощью команды
adb shell pm verify-app-links --re-verify <your-package-name>. - Убедитесь, что в правилах нет ошибок. Тщательно проверьте синтаксис сопоставителей шаблонов в правилах.
- Проверьте правила фильтрации манифеста. Проверьте правила фильтра интентов в манифесте приложения, чтобы убедиться, что путь ссылки не отфильтровывается. Если ссылка отфильтровывается, сделайте фильтр интентов в манифесте приложения менее строгим.
- Диагностика правил сопоставления (Android 17 и более поздние версии). Выполните команду
adb shell am start --debug-link -a android.intent.action.VIEW -d "<URL>", чтобы проверить, какие правила были оценены, и определить, помешало ли правило исключения (allow = 1) открыть приложение. Подробнее о том, как диагностировать разрешение ссылок с помощью флага debug-link…
- Выполните принудительную проверку повторно. Выполните повторное извлечение с помощью команды
Как устранить распространенные ошибки реализации
Если вы не можете подтвердить ссылки на приложение для Android, проверьте, нет ли у вас следующих распространенных ошибок. В этом разделе в качестве доменного имени-плейсхолдера используется example.com. При выполнении этих проверок замените example.com на фактическое доменное имя вашего сервера.
- Неправильная настройка фильтра интентов
- Проверьте, не указан ли в элементе
<intent-filter>URL, который не принадлежит вашему приложению. - Неправильная конфигурация сервера
Проверьте конфигурацию JSON на сервере и убедитесь, что значение SHA указано правильно.
Также убедитесь, что на странице
example.com.(с точкой в конце) размещен тот же контент, что и на страницеexample.com.- Серверная переадресация
Если вы настроите переадресацию, как показано ниже, система не будет проверять никакие ссылки на приложение для Android.
http://example.com–https://example.comexample.com–www.example.com
Это необходимо для безопасности приложения.
- Надежность сервера
Проверьте, могут ли клиентские приложения подключаться к серверу.
- Непроверяемые ссылки
Для тестирования можно намеренно добавить непроверяемые ссылки. Помните, что на устройствах с Android 11 и более ранними версиями ОС такие ссылки не позволяют системе проверить все ссылки на ваше приложение для Android.
- Неправильная подпись в файле assetlinks.json.
Убедитесь, что подпись верна и совпадает с той, которая использовалась для подписания приложения. Распространенные ошибки:
- Приложение подписано сертификатом для отладки, а в
assetlinks.jsonуказана только подпись для выпуска. - Подпись в нижнем регистре в
assetlinks.json. Подпись должна быть написана заглавными буквами. - Если вы используете функцию подписания приложений в Google Play, убедитесь, что вы используете подпись, которую Google использует для подписания каждого из ваших выпусков. Вы можете проверить эти данные, включая полный фрагмент JSON, следуя инструкциям по декларированию связей с сайтами.
- Приложение подписано сертификатом для отладки, а в
Как создать отчет об ошибке
Если проблему сложно воспроизвести, создайте отчет об ошибке и проанализируйте его. Это может дать ценную информацию о процессе проверки и любых ошибках на уровне системы.