Перенесите вход по ссылке электронной почты из 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 ниже версии 26.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 будет удалена; останется только сам домен для создания ссылок электронной почты.

1. Настройте приложение 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» и указанной вами схемой и хостом, ваше приложение начинает действие с этим фильтром намерений для обработки ссылки.

2. Настройте свой проект для использования новых ссылок

   Когда вы будете готовы обрабатывать новые доменные ссылки, вы можете использовать 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);
     });
   }
   

3. Отправьте и активируйте ссылку по электронной почте

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

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

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

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

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

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

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