Глубокая и Динамическая Ссылка

Поддержка Динамических Ссылок

25 августа 2025 года Firebase Dynamic Links будет закрыт. Рекомендуется начать исследование альтернативных решений для управления ссылками и глубокой ссылкой. Узнайте больше о объявлении здесь.

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

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

На рисунке ниже показана работа этой функциональности:

Поток глубокой и динамической ссылки

При нажатии на ссылку сначала происходит проверка установлено ли приложение. Если нет, ссылка открывает Playstore или Appstore (в зависимости от устройства) для установки приложения. После установки, если страница требует аутентификации, вы увидите страницу входа. После успешного входа вы можете получить доступ к контенту, который был с вами поделен.

Лучшее здесь то, что даже если в вашем приложении предусмотрен другой порядок доступа к контенту страницы (например, Главная страница -> Все посты -> Один пост), вы можете пройти этот порядок и сразу открыть конкретную страницу (например, Один пост).

Глубокая Ссылка

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

Структура URL-схемы

Глубокая ссылка состоит из трех частей. Она начинается с схемы, за которой следует хост и название страницы, например, designersapp://designersapp.com/profile.

Если название страницы не указано (т.е. designersapp://mydesignersapp.com/) то будет открыта главная страница приложения.

Добавление Глубокой Ссылки

Давайте создадим пример для обмена и открытия страницы профиля с использованием глубокой ссылки. Пример выглядит следующим образом:

Обмен и открытие глубокой ссылки

Шаги для добавления глубокой ссылки следующие:

1. Установите URL-схему
2. Настройте URL страницы
3. Отправка глубокой ссылки
4. Тестирование глубокой ссылки

1. Установите URL-схему

На этом шаге вы установите URL-схему. Для этого:

1. Перейдите в Настройки и Интеграции > Общее > Детали приложения.

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

3. В полях URL-схема по умолчанию мы добавляем значения на основе названия вашего проекта. Чтобы изменить это, введите имя схемы (перед "://") и имя хоста (после "://").

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

2. Настройка URL страницы

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

Для указания URL страницы:

1. Выберите страницу, которую вы хотите открыть по глубокой ссылке.

2. Переместите панель свойств справа и откройте раздел Настройки маршрута.

3. По умолчанию маршрут - название текущей страницы. Отредактируйте его, если вы хотите указать другое имя в URL страницы.

4. По умолчанию страница не требует аутентификации при открытии через глубокую ссылку. Однако, убедитесь, что установлен флажок Требуется аутентификация в случае, если ваше приложение работает только после входа в систему.

Настройка URL страницы

3. Отправка глубокой ссылки

Вы можете поделиться глубокой ссылкой текущей страницы, добавив действие поделиться.

Чтобы поделиться глубокой ссылкой текущей страницы:

1. Выберите страницу, которую вы хотите открыть через глубокую ссылку.

2. На этой странице выберите любой виджет (например, кнопку поделиться) из дерева виджетов или области холста.

3. Выберите Действия в панели свойств (правое меню) и нажмите Открыть. Это откроет Редактор Действий в новом всплывающем окне.

   1. Нажмите на + Добавить Действие.
   2. Справа найдите и выберите действие Поделиться.
   3. Установите Источник Значения в Из Переменной.
   4. Установите Источник в Глобальные Свойства.
   5. Установите Доступные Опции на Ссылка На Текущую Страницу и нажмите Закрыть.

Отправка глубокой ссылки

4. Тестирование глубокой ссылки

Глубокие ссылки нельзя протестировать в Режиме Запуска. Вместо этого, вам нужно протестировать их на реальном устройстве/эмуляторе.

Прежде чем протестировать глубокую ссылку, вам нужно получить ее. Самый простой способ - запустить приложение на устройстве/эмуляторе, нажать на кнопку поделиться и скопировать глубокую ссылку.

Теперь вы можете протестировать ссылку двумя способами:

Используя инструменты командной строки

Если у вас есть Android Studio с установленными SDK платформными инструментами, вы можете выполнить следующую команду в терминале, заменив ее на вашу глубокую ссылку.

Копировать

adb shell am start -a android.intent.action.VIEW \
    -c android.intent.category.BROWSABLE \
    -d "designersapp://designersapp.com/profile"

Используя мобильный браузер Firefox

Вы также можете протестировать глубокую ссылку в мобильном браузере Firefox. Для этого откройте браузер, вставьте URL в строку поиска, откройте меню и нажмите на Открыть в приложении.

Вот как это сделать:

Использование мобильного браузера Firefox для открытия глубокой ссылки

Динамическая Ссылка

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

Для работы динамической ссылки вам необходимо включить глубокую ссылку здесь. Вы можете рассматривать динамическую ссылку как дополнительное преимущество глубокой ссылки.

примечание

FlutterFlow использует Firebase Dynamic Link (продукт от Firebase) для создания динамических ссылок.

Добавление Динамической Ссылки

Давайте создадим пример для обмена и открытия страницы профиля с использованием динамической ссылки. Пример выглядит следующим образом:

Пример динамической ссылки

Шаги для добавления динамической ссылки следующие:

1. Настройка домена
2. Настройка iOS
3. Установить URL-схему
4. Настройка URL страницы
5. Отправка динамической ссылки
6. Тестирование динамической ссылки

1. Настройка домена

Для работы динамической ссылки необходимо указать доменное имя, которое будет использоваться в качестве префикса URL в ссылке.

Для настройки доменного имени пройдите следующие шаги:

1. Откройте Консоль Firebase и нажмите на **Dynamic Link ** (в левом меню).

2. Нажмите на кнопку Начнем. Это откроет всплывающее окно.

3. Введите доменное имя. Если у вас нет собственного домена, вы можете выбрать бесплатный Google Provided Domain, заканчивающийся на page.link. Чтобы настроить свой собственный домен, следуйте инструкции здесь.

4. Если вы выбрали Google Provided Domain, вы можете Завершить настройку.

Настройка домена для динамической ссылки

2. Настройка iOS

Для работы динамической ссылки на устройствах iOS необходимо выполнить дополнительную конфигурацию.

Настройка iOS включает в себя:

2.1 Добавление идентификатора App Store и команды в проект Firebase

Чтобы добавить идентификатор App Store и команду в проект Firebase:

1. Откройте Консоль Firebase и нажмите на Обзор проекта (в левом меню).

2. Выберите iOS проект и нажмите на значок настроек (шестеренку) внутри.

3. Прокрутите вниз, чтобы увидеть ваш выбранный проект iOS.

4. Найдите поле Идентификатор App Store, нажмите на значок редактирования (карандаш), введите ID и нажмите * Сохранить*.