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

Uwierzytelnianie za pomocą linku e-mail było wcześniej oparte na Firebase Dynamic Links, które zostanie wyłączone 25 sierpnia 2025 r. Opublikowaliśmy alternatywne rozwiązanie w pakiecie SDK Androida w wersji 23.2.0 lub nowszej (Firebase Authentication) oraz w pakiecie SDK Firebase BoM w wersji 33.9.0 lub nowszej. Jeśli Twoja aplikacja używa linków w starym formacie i chcesz użyć alternatywnej metody migracji, zapoznaj się z artykułem Uwierzytelnianie za pomocą Firebase przy użyciu linku e-mail na Androidzie, aby korzystać z nowego systemu opartego na Firebase Hosting.

Jeśli do zarządzania przepływami OAuth w Firebase Authentication używasz pakietu SDK Firebase Authentication na Androida w wersji niższej niż 20.0.0 (lub pakietu Firebase BoM w wersji niższej niż 26.0.0), musisz zaktualizować go do najnowszej wersji pakietu SDK 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 teraz zamiast domeny Firebase Dynamic Links usługa Firebase Authentication będzie używać domyślnej domeny Firebase Hosting Twojego projektu do tworzenia linków do e-maili i innych działań związanych z linkami spoza kanału w aplikacjach mobilnych. Oznacza to, że aplikacja musi zostać zaktualizowana, aby używać tej domyślnej domeny jako powiązanej domeny dla linków uwierzytelniania poczty e-mail w aplikacji mobilnej.

Aby zaktualizować linki aplikacji mobilnej, aby używać nowej domyślnej domeny Firebase Hosting, możesz wykonać instrukcje dotyczące uwierzytelniania za pomocą Firebase przy użyciu linku e-mail na Androidzie.

Wykonaj podane niżej instrukcje, aby obsługiwać linki z nowej domeny i poprosić Firebase Authentication o rozpoczęcie generowania linków do aplikacji mobilnej za pomocą nowej domeny.

Jeśli chcesz nadal używać dowolnej domeny niestandardowej Firebase Hosting lub nawet domeny niestandardowej Firebase Dynamic Links jako nowej domeny powiązanej, wykonaj czynności odpowiednie do domeny, której chcesz używać. Pamiętaj, że po wykonaniu instrukcji z następnej sekcji funkcja linkowania głębokiego w domenie niestandardowej Firebase Dynamic Links zostanie usunięta. Pozostanie tylko sama domena, która będzie służyć do tworzenia linków e-mail.

Skonfiguruj aplikację na Androida, aby obsługiwała link Firebase Hosting
1. Aby obsługiwać te linki z aplikacji na Androida, musisz podać nazwę pakietu aplikacji w ustawieniach projektu w konsoli Firebase. Dodatkowo należy podać odciski cyfrowe SHA-1 i SHA-256 certyfikatu aplikacji.
2. Jeśli chcesz, aby te linki Firebase Hosting przekierowywały do określonej aktywności, musisz skonfigurować filtr intencji w pliku AndroidManifest.xml. Filtr intencji powinien blokowaćFirebase Hosting linki w Twojej domenie. 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 otwierają link do hosta z ścieżką „/__/auth/links” oraz określonym przez Ciebie schematem i hostem, aplikacja uruchamia aktywność z tym filtrem intencji, aby obsłużyć link.

Ważne: aby mieć możliwość płynnego przywrócenia poprzedniej wersji, podczas testowania rozwiązania z użyciem linków Firebase Hosting zalecamy zachowanie dotychczasowego filtra intencji, który obsługuje Firebase Dynamic Links. Rozwiązanie Firebase Dynamic Links będzie dostępne do 25 sierpnia 2025 r.
Konfigurowanie projektu pod kątem korzystania z nowych linków

Gdy będziesz gotowy do obsługi linków do nowej domeny, możesz użyć pakietu Admin SDK Firebase, aby zmienić sposób generowania linków e-mail i poprosić nasz backend o generowanie linków za pomocą 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 cofnąć zmiany do wersji Firebase Dynamic Links podczas wdrażania i testowania rozwiązania kopii zapasowej, przywróć domenę do stanuFIREBASE_DYNAMIC_LINK. Rozwiązanie Firebase Dynamic Links będzie dostępne do 25 sierpnia 2025 r.
Wysyłanie i realizowanie linku e-mail

Wyślij e-maila z linkiem do logowania, jak poprzednio. Gdy użytkownik kliknie link, zostanie przekierowany do aplikacji (jeśli jest zainstalowana) w celu zalogowania się.

Dostosowywanie linków mobilnych

Możesz użyć domeny niestandardowej Firebase Hosting lub ponownie użyć domeny niestandardowej Firebase Dynamic Links jako domeny nowych linków mobilnych.

Używanie domeny niestandardowej Firebase Hosting

Aby skonfigurować domenę niestandardową, postępuj zgodnie z Firebase Hostingporadnikiem.
Skonfiguruj aplikację na Androida, aby obsługiwała link Firebase Hosting. (instrukcje znajdziesz w poprzedniej sekcji powyżej).
Wyślij użytkownikowi link uwierzytelniający na jego adres e-mail z zaktualizowanym obiektem ActionCodeSettings z domeną niestandardową jako linkDomain.

Ponowne użycie niestandardowej domeny Firebase Dynamic Links

Jako domeny niestandardowej możesz użyć dowolnej domeny Firebase Dynamic Links. Nie będzie jednak obsługiwana żadna funkcja Firebase Dynamic Links (na przykład użytkownicy nie mogą być przekierowywani do sklepu z aplikacjami, jeśli aplikacja nie jest zainstalowana na ich urządzeniu).
Skonfiguruj aplikację na Androida, aby obsługiwała link Firebase Hosting (instrukcje znajdziesz w poprzedniej sekcji).
Wyślij użytkownikowi link uwierzytelniający na jego adres e-mail z zaktualizowanym obiektem ActionCodeSettings z domeną niestandardową jako linkDomain.