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 Authenticationpakiecie Android SDK w wersji 23.2.0 lub nowszej i Firebase BoMw wersji 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 e-mailowego 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 SDK na Androida 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

W przyszłości zamiast domeny Firebase Dynamic Links usługa Firebase Authentication będzie używać Firebase Hosting domeny domyślnej projektu do tworzenia linków do linków w e-mailach 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 domeny powiązanej z linkami uwierzytelniania poczty e-mail do aplikacji mobilnej.

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

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

Jeśli chcesz nadal używać dowolnej z niestandardowych domen Firebase Hosting lub nawet używać niestandardowej domeny Firebase Dynamic Links jako nowej powiązanej domeny, wykonaj czynności odpowiednie dla domeny, której chcesz używać. Uwaga: po wykonaniu instrukcji w sekcji poniżej funkcja linków bezpośrednich w Twojej Firebase Dynamic Linksdomenie niestandardowej zostanie usunięta. Pozostanie tylko sama domena, która będzie służyć do tworzenia linków do e-maili.

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 ustawieniach projektu w konsoli Firebase. Dodatkowo należy podać SHA-1 i SHA-256 certyfikatu aplikacji.

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

   Ważne: aby zapewnić płynne wycofanie zmian, zalecamy zachowanie dotychczasowego filtra intencji, który obsługuje Firebase Dynamic Links, podczas testowania rozwiązania z linkiem Firebase Hosting. Rozwiązanie Firebase Dynamic Links będzie dostępne do 25 sierpnia 2025 r.

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

   Gdy będziesz gotowy(-a) na obsługę 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.

   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);
     });
   }
   

   Ważne: aby podczas wdrażania i testowania rozwiązania do tworzenia kopii zapasowych przywrócić domenę do stanu Firebase Dynamic Links, musisz ustawić ją z powrotem na FIREBASE_DYNAMIC_LINK. Rozwiązanie Firebase Dynamic Links będzie dostępne do 25 sierpnia 2025 r.

3. Wysyłanie i realizowanie linku w e-mailu

   Wyślij link do logowania się 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 Hostingtym przewodnikiem, 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 użyć dowolnej domeny 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.