Przenoszenie logowania przez link e-mail z Linków dynamicznych Firebase (iOS)

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 Firebase Authentication na iOS w wersji 11.8.0 lub nowszej. Jeśli Twoja aplikacja korzysta z Firebase Dynamic Links, musisz ją przenieść do nowego systemu opartego na Firebase Hosting.

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ć aplikację, aby używała nowej domyślnej domeny Firebase Hosting, która została automatycznie utworzona, możesz wykonać instrukcje podane w artykule Uwierzytelnianie za pomocą Firebase przy użyciu linku e-mail na platformach Apple.

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

Jeśli chcesz nadal używać dowolnej domeny Firebase Hosting lub nawet domeny Firebase Dynamic Links jako nowej domeny powiązanej, postępuj zgodnie z instrukcjami w sekcji Dostosowywanie linków mobilnych, dostosowując je do domeny, której chcesz używać.

  1. Połącz domenę Firebase Hosting z domeną powiązaną z Twoją aplikacją.

    Wybraną domenę musisz skonfigurować jako domenę powiązaną dla linków w aplikacji. Aby skonfigurować uprawnienia w aplikacji, otwórz w Xcode kartę Podpisywanie i możliwości dla docelowego projektu i dodaj do możliwości Powiązane domeny domeny Firebase Hosting z poprzedniego kroku. Jeśli używasz domyślnej domeny Firebase Hosting, będzie to applinks:PROJECT_ID.firebaseapp.com.

    Więcej informacji znajdziesz w dokumentacji Apple dotyczącej obsługi powiązanych domen.

    Powiązany plik domeny został wdrożony we wszystkich domenach Firebase Hosting. Aby uzyskać do niego dostęp, otwórz PROJECT_ID.firebaseapp.com/.well-known/apple-app-site-association. Ten plik AASA może zostać zastąpiony. Więcej informacji znajdziesz w artykule Tworzenie i hostowanie plików konfiguracji uniwersalnych linków.

  2. Skonfiguruj projekt 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 Firebase Admin SDK, aby zaktualizować 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);
});
}

  3. Wyślij i wykorzystaj link e-maila.

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

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

  1. Aby skonfigurować domenę niestandardową, postępuj zgodnie z instrukcjami podanymi w artykule Firebase Hosting.
  2. Połącz domenę niestandardową z domeną powiązaną z aplikacją.
  3. Wyślij link uwierzytelniający na adres e-mail użytkownika z aktualizowanym obiektem ActionCodeSettings z domeną niestandardową jako linkDomain.
  1. 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).
  2. Wyślij link uwierzytelniający na adres e-mail użytkownika z aktualizowanym obiektem ActionCodeSettings z domeną niestandardową jako linkDomain.