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

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

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ć aplikację i 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 platformach Apple.

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

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

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

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

    Więcej informacji znajdziesz w artykule Obsługa powiązanych domen w dokumentacji Apple.

    Plik powiązanej domeny został wdrożony we wszystkich Twoich domenach Firebase Hosting. Aby uzyskać do niej dostęp, otwórz PROJECT_ID.firebaseapp.com/.well-known/apple-app-site-association. Ten plik AASA można zastąpić. Więcej informacji znajdziesz w artykule Tworzenie i hostowanie plików konfiguracyjnych uniwersalnych linków.

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

    Gdy będziesz gotowy 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);
});
}

  3. Wyślij i zrealizuj link 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.

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. Aby skonfigurować domenę niestandardową, postępuj zgodnie z Firebase Hostingtym przewodnikiem.
  2. Połącz domenę niestandardową z domeną powiązaną z aplikacją.
  3. Wysyłanie linku do uwierzytelniania na adres e-mail użytkownika z zaktualizowanym obiektem ActionCodeSettings z domeną niestandardową jako linkDomain.
  1. Możesz użyć dowolnej domeny Firebase Dynamic Links jako domeny niestandardowej. Jednak żadne Firebase Dynamic Links funkcje 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. Wysyłanie linku do uwierzytelniania na adres e-mail użytkownika z zaktualizowanym obiektem ActionCodeSettings z domeną niestandardową jako linkDomain.