Перенесите вход по ссылке электронной почты из Firebase Dynamic Links (Android)

Аутентификация по ссылке электронной почты ранее основывалась на Firebase Dynamic Links , которая будет отключена 25 августа 2025 года . Мы опубликовали альтернативное решение в Firebase Authentication Android SDK версии 23.2.0+ и Firebase BoM версии 33.9.0+. Если в вашем приложении используются ссылки старого стиля и вы хотите использовать альтернативный метод переноса вашего приложения, см. раздел Аутентификация с помощью Firebase с помощью ссылки по электронной почте в Android , чтобы использовать новую систему на основе Firebase Hosting .

Кроме того, если вы используете Firebase Authentication Android SDK ниже версии 20.0.0 (или Firebase BoM ниже v26.0.0) для управления потоками OAuth с помощью Firebase Authentication , вам необходимо обновить его до последней версии Authentication SDK или BoM ( Authentication v20.0.0+ или BoM v26.0.0+), чтобы продолжить управление потоками OAuth в Firebase Authentication .

Перенесите связанный домен Firebase Dynamic Links в домен Firebase Hosting

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

Вы можете следовать инструкциям в разделе «Аутентификация с помощью Firebase с использованием ссылки по электронной почте» в Android, чтобы обновить ссылки вашего мобильного приложения для использования нового автоматически предоставляемого домена Firebase Hosting по умолчанию.

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

Если вы хотите продолжить использовать любой из своих пользовательских доменов Firebase Hosting или даже собственный домен Firebase Dynamic Links в качестве нового связанного домена, выполните действия, соответствующие предполагаемому домену, который вы хотите использовать. Обратите внимание, что после выполнения инструкций в следующем разделе функция глубоких ссылок в вашем личном домене Firebase Dynamic Links будет удалена; только сам домен останется для создания ссылок по электронной почте.

Настройте свое приложение Android для обработки вашей ссылки Firebase Hosting
1. Чтобы обрабатывать эти ссылки из вашего приложения Android, имя пакета вашего приложения необходимо указать в настройках проекта консоли Firebase . Кроме того, необходимо предоставить SHA-1 и SHA-256 сертификата приложения.
2. Если вы хотите, чтобы эти ссылки Firebase Hosting перенаправлялись на определенное действие, вам необходимо настроить фильтр намерений в файле AndroidManifest.xml . Фильтр намерений должен улавливать ссылки Firebase Hosting вашего домена. В AndroidManifest.xml :
```
<intent-filter android:autoVerify="true">
  <action android:name="android.intent.action.VIEW" />
  <category android:name="android.intent.category.BROWSABLE" />
  <category android:name="android.intent.category.DEFAULT" />
  <data
    android:scheme="https"
    android:host="PROJECT_ID.firebaseapp.com or a custom hosting domain"
    android:pathPrefix="/__/auth/links" />
</intent-filter>
```
Когда пользователи открывают ссылку на хостинг с путем «/__/auth/links» и указанной вами схемой и хостом, ваше приложение начнет действие с этим фильтром намерений для обработки ссылки.
Важно! Чтобы обеспечить плавный откат, мы рекомендуем сохранить существующий фильтр намерений, который обрабатывает Firebase Dynamic Links , пока пробуете решение для ссылок Firebase Hosting . Решение Firebase Dynamic Links будет доступно до 25 августа 2025 г.
Настройте свой проект для использования новых ссылок
Когда вы будете готовы обрабатывать новые ссылки на домен, вы можете использовать Firebase Admin SDK , чтобы обновить способ создания ссылок электронной почты и дать указание нашему серверу начать генерировать ссылки с использованием нового домена Firebase Hosting .
```
const updateRequest = {
  mobileLinksConfig: {
      domain: 'HOSTING_DOMAIN'
  }
}
const updateProjectConfig = () => {
  projectConfigManager.updateProjectConfig(updateRequest)
  .then((response) => {
      // updated project config
  }).catch((error) => {
      console.log('Error updating the project:', error);
  });
}
```
Важно! Чтобы вернуться к Firebase Dynamic Links при внедрении и тестировании решения для резервного копирования, вам следует снова установить домен на FIREBASE_DYNAMIC_LINK . Решение Firebase Dynamic Links будет доступно до 25 августа 2025 г.
Отправьте и активируйте ссылку по электронной почте
Отправьте ссылку для входа по электронной почте, как и раньше. Когда конечный пользователь щелкнет ссылку, он будет перенаправлен в приложение, если оно установлено, для завершения входа.

Настройте свои мобильные ссылки

Вы можете использовать собственный домен Firebase Hosting или повторно использовать свой собственный домен Firebase Dynamic Links в качестве нового домена мобильных ссылок.

Используйте собственный домен Firebase Hosting

Следуйте руководству Firebase Hosting чтобы настроить личный домен.
Настройте свое приложение Android для обработки вашей ссылки Firebase Hosting . (инструкции приведены в предыдущем разделе выше).
Отправьте ссылку аутентификации на адрес электронной почты пользователя с обновленным объектом ActionCodeSettings с личным доменом в качестве linkDomain .

Повторно используйте свой собственный домен Firebase Dynamic Links

Вы можете повторно использовать любой из ваших доменов Firebase Dynamic Links в качестве личного домена. Однако любые функции Firebase Dynamic Links больше не будут поддерживаться (например, пользователей нельзя будет перенаправить в магазин приложений, если приложение не установлено на их устройстве).
Настройте свое приложение Android для обработки вашей ссылки Firebase Hosting (инструкции приведены в предыдущем разделе выше).
Отправьте ссылку аутентификации на адрес электронной почты пользователя с обновленным объектом ActionCodeSettings с личным доменом в качестве linkDomain .