Устранение неполадок со ссылками на приложение

В этом руководстве описаны распространенные проблемы и способы их устранения. Вы также можете использовать инструменты устранения неполадок на странице "Ссылки на контент" в 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.com
  • example.com – www.example.com

Это необходимо для безопасности приложения.

Надежность сервера

Проверьте, могут ли клиентские приложения подключаться к серверу.

Непроверяемые ссылки

Для тестирования можно намеренно добавить непроверяемые ссылки. Помните, что на устройствах с Android 11 и более ранними версиями ОС такие ссылки не позволяют системе проверить все ссылки на ваше приложение для Android.

Неправильная подпись в файле assetlinks.json.

Убедитесь, что подпись верна и совпадает с той, которая использовалась для подписания приложения. Распространенные ошибки:

  • Приложение подписано сертификатом для отладки, а в assetlinks.json указана только подпись для выпуска.
  • Подпись в нижнем регистре в assetlinks.json. Подпись должна быть написана заглавными буквами.
  • Если вы используете функцию подписания приложений в Google Play, убедитесь, что вы используете подпись, которую Google использует для подписания каждого из ваших выпусков. Вы можете проверить эти данные, включая полный фрагмент JSON, следуя инструкциям по декларированию связей с сайтами.

Как создать отчет об ошибке

Если проблему сложно воспроизвести, создайте отчет об ошибке и проанализируйте его. Это может дать ценную информацию о процессе проверки и любых ошибках на уровне системы.