Przejście z logowania przez link e-mail na Linki dynamiczne Firebase (Android)

Uwierzytelnianie za pomocą linku w e-mailu korzystało wcześniej z Firebase Dynamic Links, które zostanie wyłączone 25 sierpnia 2025 r. Opublikowaliśmy alternatywne rozwiązanie w Firebase AuthenticationAndroid SDK w wersji 23.2.0 lub nowszej i Firebase BoMwersji 33.9.0 lub nowszej. Jeśli Twoja aplikacja używa linków w starym stylu i chcesz zastosować alternatywną metodę migracji, zapoznaj się z artykułem Uwierzytelnianie w Firebase za pomocą linku w e-mailu na Androidzie, aby używać nowego systemu opartego na Firebase Hosting.

Jeśli do zarządzania przepływami OAuth w Firebase Authentication używasz Firebase Authentication pakietu Android SDK w wersji starszej niż 20.0.0 (lub Firebase BoM w wersji starszej niż 26.0.0), musisz zaktualizować pakiet SDK do najnowszej wersji Authentication lub BoM (Authentication w wersji 20.0.0 lub nowszej albo BoM w wersji 26.0.0 lub nowszej), aby nadal zarządzać przepływami OAuth w Firebase Authentication.

Migracja powiązanej domeny Firebase Dynamic Links do domeny Firebase Hosting

Od tej pory zamiast domeny Firebase Dynamic Links usługa Firebase Authentication będzie używać Firebase Hosting domyślnej domeny projektu do tworzenia linków do poczty e-mail i innych działań związanych z linkami poza pasmem w aplikacjach mobilnych. Oznacza to, że aplikacja będzie musiała zostać zaktualizowana, aby używać tej domyślnej domeny jako powiązanej domeny w przypadku linków do uwierzytelniania poczty e-mail w aplikacji mobilnej.

Aby zaktualizować linki do aplikacji mobilnej i zacząć używać nowej domeny domyślnej Firebase Hosting, która jest udostępniana automatycznie, postępuj zgodnie z instrukcjami w artykule Uwierzytelnianie w Firebase za pomocą linku w e-mailu na Androidzie.

Postępuj zgodnie z instrukcjami poniżej, aby obsługiwać linki z nowej domeny i poinstruować Firebase Authentication, aby od tej pory używał nowej domeny do generowania linków do aplikacji mobilnej.

Jeśli chcesz nadal używać dowolnej z domen niestandardowych Firebase Hosting lub nawet domeny niestandardowej Firebase Dynamic Links jako nowej powiązanej domeny, wykonaj czynności odpowiednie dla domeny, której chcesz używać. Pamiętaj, że po wykonaniu instrukcji w następnej sekcji funkcja linkowania bezpośredniego w Twojej Firebase Dynamic Links domenie niestandardowej zostanie usunięta. Pozostanie tylko sama domena, której będzie można używać do tworzenia linków w e-mailach.

1. Skonfiguruj aplikację na Androida, aby obsługiwała link Firebase Hosting

   1. Aby obsługiwać te linki w aplikacji na Androida, musisz podać nazwę pakietu aplikacji w Firebaseustawieniach projektu w konsoli. Dodatkowo należy podać SHA-1 i SHA-256 certyfikatu aplikacji.

   2. Jeśli chcesz, aby te linki Firebase Hosting przekierowywały do konkretnego działania, musisz skonfigurować filtr intencji w pliku AndroidManifest.xml. Filtr intencji powinien przechwytywać linki Firebase Hosting z Twojej domeny. W 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>
      

   Gdy użytkownicy otworzą link do hostingu ze ścieżką „/__/auth/links” oraz schematem i hostem, które określisz, aplikacja rozpocznie działanie z tym filtrem intencji, aby obsłużyć link.

2. Skonfiguruj projekt, aby używać nowych linków

   Gdy będziesz gotowy(-a) do obsługi nowych linków do domeny, możesz użyć pakietu Firebase Admin SDK, aby zaktualizować sposób generowania linków w e-mailach i poinstruować nasz backend, aby zaczął generować linki przy użyciu nowej domeny 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. Wysyłanie i wykorzystywanie linku w e-mailu

   Wyślij link do logowania przez e-maila tak jak wcześniej. Gdy użytkownik kliknie link, zostanie przekierowany do aplikacji (jeśli jest zainstalowana), aby dokończyć logowanie.

Dostosowywanie linków mobilnych

Możesz użyć niestandardowej domeny Firebase Hosting lub ponownie wykorzystać swoją niestandardową domenę Firebase Dynamic Links jako nową domenę linków mobilnych.

Używanie domeny niestandardowej Firebase Hosting

1. Postępuj zgodnie z Firebase Hostingprzewodnikiem, aby skonfigurować domenę niestandardową.
2. Skonfiguruj aplikację na Androida tak, aby obsługiwała link Firebase Hosting. (instrukcje w poprzedniej sekcji powyżej).
3. Wyślij link uwierzytelniający na adres e-mail użytkownika z zaktualizowanym obiektem ActionCodeSettings z domeną niestandardową jako linkDomain.

Ponowne użycie domeny niestandardowej Firebase Dynamic Links

1. Możesz ponownie użyć dowolnej z domen Firebase Dynamic Links jako domeny niestandardowej. Jednak żadne funkcje Firebase Dynamic Links nie będą już obsługiwane (na przykład użytkownicy nie będą mogli być przekierowywani do sklepu z aplikacjami, jeśli aplikacja nie jest zainstalowana na ich urządzeniu).
2. Skonfiguruj aplikację na Androida tak, aby obsługiwała link Firebase Hosting (instrukcje w poprzedniej sekcji).
3. Wyślij link uwierzytelniający na adres e-mail użytkownika z zaktualizowanym obiektem ActionCodeSettings z domeną niestandardową jako linkDomain.