Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Anmeldung über E-Mail-Link von Firebase Dynamic Links migrieren (Android)

Die Authentifizierung per E-Mail-Link basierte bisher auf Firebase Dynamic Links, das am 25. August 2025 eingestellt wird. Wir haben eine alternative Lösung in der Firebase Authentication Android SDK-Version 23.2.0 oder höher und der Firebase BoM-Version 33.9.0 oder höher veröffentlicht. Wenn Ihre App die alten Links verwendet und Sie eine alternative Methode zur Migration Ihrer App verwenden möchten, finden Sie unter Mit E‑Mail-Link in Android bei Firebase authentifizieren Informationen zur Verwendung des neuen Firebase Hosting-basierten Systems.

Wenn Sie das Firebase Authentication Android SDK vor Version 20.0.0 (oder das Firebase BoM vor Version 26.0.0) verwenden, um OAuth-Abläufe mit Firebase Authentication zu verwalten, müssen Sie auf die neueste Authentication SDK- oder BoM-Version (Authentication Version 20.0.0 oder höher oder BoM Version 26.0.0 oder höher) aktualisieren, um OAuth-Abläufe in Firebase Authentication weiterhin verwalten zu können.

Verknüpfte Firebase Dynamic Links-Domain zu einer Firebase Hosting-Domain migrieren

In Zukunft wird Firebase Authentication anstelle einer Firebase Dynamic Links-Domain die Standarddomain Firebase Hosting für Ihr Projekt verwenden, um Links für E-Mail-Links und andere Out-of-Band-Linkaktionen in mobilen Apps zu erstellen. Das bedeutet, dass Ihre App ebenfalls aktualisiert werden muss, damit diese Standarddomain als verknüpfte Domain für E‑Mail-Authentifizierungslinks zu Ihrer mobilen App verwendet wird.

Folgen Sie der Anleitung unter Mit E-Mail-Link in Android bei Firebase authentifizieren, um Ihre Links zu mobilen Apps so zu aktualisieren, dass die neue, automatisch bereitgestellte Standarddomain Firebase Hosting verwendet wird.

Folgen Sie der Anleitung unten, um Links von der neuen Domain zu verarbeiten und Firebase Authentication anzuweisen, die neue Domain künftig zum Generieren von Links für mobile Apps zu verwenden.

Wenn Sie eine Ihrer benutzerdefinierten Firebase Hosting-Domains oder sogar Ihre benutzerdefinierte Firebase Dynamic Links-Domain als neue verknüpfte Domain verwenden möchten, folgen Sie der Anleitung für die gewünschte Domain. Hinweis: Nachdem Sie die Anleitung im folgenden Abschnitt ausgeführt haben, wird die Deeplink-Funktion für Ihre benutzerdefinierte Domain Firebase Dynamic Links entfernt. Nur die Domain selbst bleibt zum Erstellen von E‑Mail-Links erhalten.

Android-App für die Verarbeitung des Firebase Hosting-Links konfigurieren
1. Damit diese Links von Ihrer Android-App verarbeitet werden können, muss der Paketname Ihrer App in den Projekteinstellungen der Firebase Console angegeben werden. Außerdem müssen die SHA-1- und SHA-256-Werte des Anwendungszertifikats angegeben werden.
2. Wenn diese Firebase Hosting-Links zu einer bestimmten Aktivität weiterleiten sollen, müssen Sie einen Intent-Filter in Ihrer AndroidManifest.xml-Datei konfigurieren. Der Intent-Filter sollte Firebase Hosting-Links Ihrer Domain erfassen. In 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>
```
Wenn Nutzer einen Hosting-Link mit dem Pfad „/__/auth/links“ und dem von Ihnen angegebenen Schema und Host öffnen, startet Ihre App die Aktivität mit diesem Intent-Filter, um den Link zu verarbeiten.

Wichtig: Damit ein reibungsloser Rollback möglich ist, empfehlen wir, den vorhandenen Intent-Filter für Firebase Dynamic Links beizubehalten, während Sie die Firebase Hosting-Link-Lösung ausprobieren. Die Firebase Dynamic Links-Lösung ist bis zum 25. August 2025 verfügbar.

Projekt für die Verwendung der neuen Links konfigurieren

Wenn Sie bereit sind, die neuen Domainlinks zu verarbeiten, können Sie mit dem Firebase Admin SDK die Generierung von E‑Mail-Links aktualisieren und unser Backend anweisen, Links mit der neuen Domain Firebase Hosting zu generieren.

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

E‑Mail-Link senden und einlösen

Senden Sie den Anmeldelink per E‑Mail wie zuvor. Wenn der Endnutzer auf den Link klickt, wird er zur App weitergeleitet, sofern sie installiert ist, um die Anmeldung abzuschließen.

Mobile Links anpassen

Sie können eine benutzerdefinierte Firebase Hosting-Domain verwenden oder Ihre benutzerdefinierte Firebase Dynamic Links-Domain als neue Domain für mobile Links wiederverwenden.

Benutzerdefinierte Firebase Hosting-Domain verwenden

Folgen Sie der Firebase Hosting-Anleitung, um eine benutzerdefinierte Domain einzurichten.
Konfigurieren Sie Ihre Android-App so, dass sie den Firebase Hosting-Link verarbeiten kann. (Anleitung im vorherigen Abschnitt oben).
Senden Sie einen Authentifizierungslink an die E-Mail-Adresse des Nutzers mit einem aktualisierten ActionCodeSettings-Objekt mit einer benutzerdefinierten Domain als linkDomain.

Benutzerdefinierte Firebase Dynamic Links-Domain wiederverwenden

Sie können jede Ihrer Firebase Dynamic Links-Domains als benutzerdefinierte Domain wiederverwenden. Firebase Dynamic Links-Funktionen werden jedoch nicht mehr unterstützt. Nutzer können beispielsweise nicht zu einem App-Shop weitergeleitet werden, wenn die App nicht auf ihrem Gerät installiert ist.
Konfigurieren Sie Ihre Android-App so, dass sie Ihren Firebase Hosting-Link verarbeitet (Anleitung im vorherigen Abschnitt oben).
Senden Sie einen Authentifizierungslink an die E-Mail-Adresse des Nutzers mit einem aktualisierten ActionCodeSettings-Objekt mit einer benutzerdefinierten Domain als linkDomain.