Обработка ссылок на приложения Android

Глубокие ссылки обрабатывают URI контента. Веб-ссылки обрабатывают схемы HTTP и HTTPS. Ссылки приложений Android обрабатывают атрибут autoVerify.
Рисунок 1. Возможности глубоких ссылок, веб-ссылок и ссылок приложений Android.

Пользователи, переходящие по ссылкам на устройствах, преследуют одну цель: получить желаемый контент. Как разработчик, вы можете настроить ссылки приложений Android, чтобы перенаправлять пользователей к определенному контенту ссылки непосредственно в вашем приложении, минуя диалог выбора приложения, также известный как диалог устранения неоднозначности. Поскольку ссылки приложений Android используют HTTP URL и связь с веб-сайтом, пользователи, у которых не установлено ваше приложение, переходят напрямую к контенту на вашем сайте.

Прежде чем внедрять ссылки приложений Android, важно понимать различные типы ссылок, которые вы можете создать в своем приложении Android: глубокие ссылки, веб-ссылки и ссылки приложений Android. На рисунке 1 показана взаимосвязь между этими типами ссылок, а в следующих разделах каждый тип ссылки описывается более подробно.

Глубокие ссылки — это URI любой схемы, которые перенаправляют пользователей непосредственно в определенную часть вашего приложения. Чтобы создать глубокие ссылки, добавьте фильтры намерений , чтобы направить пользователей к нужному действию в вашем приложении, как показано в следующем фрагменте кода:

<activity
    android:name=".MyMapActivity"
    android:exported="true"
    ...>
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="geo" />
    </intent-filter>
</activity>

Когда пользователь нажимает на глубокую ссылку, может появиться диалоговое окно устранения неоднозначности. Это диалоговое окно позволяет пользователю выбрать одно из нескольких приложений, включая ваше приложение, которое может обрабатывать данную глубокую ссылку. На рисунке 2 показано диалоговое окно после того, как пользователь нажимает на ссылку карты, с вопросом, следует ли открыть ссылку в Картах или Chrome.

Рисунок 2. Диалоговое окно разрешения неоднозначности

Веб-ссылки — это глубокие ссылки, которые используют схемы HTTP и HTTPS. На Android 12 и выше нажатие на веб-ссылку (которая не является ссылкой на приложение Android ) всегда показывает контент в веб-браузере. На устройствах под управлением предыдущих версий Android, если ваше приложение или другие приложения, установленные на устройстве пользователя, также могут обрабатывать веб-ссылку, пользователи могут не переходить напрямую в браузер. Вместо этого они увидят диалоговое окно устранения неоднозначности, похожее на то, что показано на рисунке 2.

В следующем фрагменте кода показан пример фильтра веб-ссылок:

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />

    <data android:scheme="http" />
    <data android:host="myownpersonaldomain.com" />
</intent-filter>

Ссылки приложений Android , доступные на Android 6.0 (уровень API 23) и выше, представляют собой веб-ссылки, которые используют схемы HTTP и HTTPS и содержат атрибут autoVerify . Этот атрибут позволяет вашему приложению назначить себя обработчиком по умолчанию для данного типа ссылки. Таким образом, когда пользователь нажимает на ссылку приложения Android, ваше приложение открывается немедленно, если оно установлено — диалоговое окно устранения неоднозначности не появляется.

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

В следующем фрагменте кода показан пример фильтра ссылок на приложения Android:

<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" />

    <!-- Do not include other schemes. -->
    <data android:scheme="http" />
    <data android:scheme="https" />

    <data android:host="myownpersonaldomain.com" />
</intent-filter>

Ссылки на приложения Android предлагают следующие преимущества:

  • Безопасный и конкретный: Android App Links использует HTTP URL-адреса, которые ссылаются на домен веб-сайта, которым вы владеете, поэтому никакое другое приложение не может использовать ваши ссылки. Одним из требований для Android App Links является подтверждение права собственности на ваш домен с помощью одного из наших методов ассоциации веб-сайта.
  • Удобный пользовательский интерфейс: поскольку ссылки приложений Android используют один и тот же HTTP-URL для одного и того же контента на вашем веб-сайте и в вашем приложении, пользователи, у которых не установлено приложение, просто переходят на ваш веб-сайт вместо приложения — без ошибок 404 и без ошибок.
  • Поддержка Android Instant Apps: С Android Instant Apps ваши пользователи могут запускать ваше приложение Android без его установки. Чтобы добавить поддержку Instant App в ваше приложение Android, настройте Android App Links и посетите g.co/InstantApps .
  • Привлекайте пользователей из поиска Google: пользователи напрямую открывают определенный контент в вашем приложении, нажимая URL-адрес из Google в мобильном браузере, в приложении поиска Google , в поиске на экране Android или через Google Assistant.

Общие шаги по созданию ссылок на приложения Android следующие:

  1. Создайте глубокие ссылки на определенный контент в вашем приложении: в манифесте приложения создайте фильтры намерений для URI вашего веб-сайта и настройте приложение на использование данных из намерений для отправки пользователей на нужный контент в вашем приложении. Узнайте больше в разделе Создание глубоких ссылок на контент приложения .
  2. Добавьте проверку для своих глубоких ссылок: настройте свое приложение для запроса проверки ссылок приложений. Затем опубликуйте файл JSON Digital Asset Links на своих веб-сайтах для проверки права собственности через Google Search Console . Узнайте больше в разделе Проверка ссылок приложений .

В качестве альтернативы документации, ссылка на которую приведена выше, можно использовать Android App Links Assistant — это инструмент в Android Studio, который проведет вас через все этапы, необходимые для создания ссылок на приложения Android.

Дополнительную информацию можно найти на следующих ресурсах:

Управление и проверка ссылок на приложения Android

Вы можете управлять и проверять глубокие ссылки через Play Console . После успешной загрузки приложения на панели управления (расположенной в разделе Grow > Deep links) отображается обзор глубоких ссылок и ошибок конфигурации.

Рисунок 3. Глубокие ссылки на панели инструментов Play Console

Панель инструментов содержит следующие разделы:

  • Основные моменты общей конфигурации глубоких ссылок
  • Все домены, объявленные в файле манифеста
  • Веб-ссылки, сгруппированные по пути
  • Ссылки, которые имеют пользовательские схемы
В каждом из этих разделов отображается статус глубокой ссылки и способ ее исправления в случае возникновения ошибки.

Более подробную информацию о панели управления можно найти в этом руководстве .