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

Email link authentication previously relied on Firebase Dynamic Links , which will be shut down on August 25, 2025 . We've published an alternative solution in the Firebase Authentication Android SDK version 23.2.0+ and Firebase BoM version 33.9.0+. If your app uses the old style links and you want to use an alternative method for migrating your app, see Authenticate with Firebase using Email Link in Android to use the new Firebase Hosting based system.

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

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

Moving forward, rather than using a Firebase Dynamic Links domain, Firebase Authentication will use the Firebase Hosting default domain for your project to create links for email link and other out-of-band link actions in mobile apps. This means that your app will also need to be updated to use this default domain as the associated domain for email authentication links to your mobile app.

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

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

If you'd like to continue using any of your custom Firebase Hosting domains or even your custom Firebase Dynamic Links domain to be your new associated domain, follow the steps that match the intended domain you'd like to use. Note that after completing the instructions in the following section, the deep linking feature on your Firebase Dynamic Links custom domain will be removed; only the domain itself will remain for creating email 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 .

   import { getAuth } from 'firebase-admin/auth';
   
   const updateEmailAuthDomain = async () => {
     const updateRequest = {
       mobileLinksConfig: {
         domain: 'HOSTING_DOMAIN',
       },
     };
   
     const projectConfigManager = getAuth().projectConfigManager();
   
     try {
       const response = await projectConfigManager.updateProjectConfig(updateRequest);
       // Updated project config
       console.log('Project configuration updated successfully:', response);
     } catch (error) {
       console.error('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 .