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

Die E‑Mail-Link-Authentifizierung basierte bisher auf Firebase Dynamic Links, die am 25. August 2025 eingestellt werden. Wir haben eine alternative Lösung im Firebase Authentication Android SDK Version 23.2.0+ und Firebase BoM Version 33.9.0+ veröffentlicht. Wenn Ihre App die alten Linkstile verwendet und Sie eine alternative Methode für die Migration Ihrer App nutzen möchten, lesen Sie den Hilfeartikel Authentifizierung mit Firebase über einen E‑Mail-Link in Android, um das neue Firebase Hosting basierte System zu verwenden.

Wenn Sie außerdem das Firebase Authentication Android SDK unter Version 20.0.0 (oder die Firebase BoM unter 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 BoM Version 26.0.0+) aktualisieren, um OAuth Abläufe in Firebase Authentication weiterhin verwalten zu können.

Zugeordnete Firebase Dynamic Links Domain zu einer Firebase Hosting Domain migrieren

Anstelle einer Firebase Dynamic Links Domain verwendet Firebase Authentication künftig die Firebase Hosting Standarddomain für Ihr Projekt, um Links für E‑Mail-Links und andere Out-of-Band-Linkaktionen in mobilen Apps zu erstellen. Das bedeutet, dass Ihre App auch aktualisiert werden muss, um diese Standarddomain als zugeordnete Domain für E‑Mail-Authentifizierungslinks zu Ihrer mobilen App zu verwenden.

Folgen Sie der Anleitung unter Authentifizierung mit Firebase über einen E‑Mail-Link in Android, um die Links Ihrer mobiler App so zu aktualisieren, dass sie die neue automatisch bereitgestellte Firebase Hosting Standarddomain verwenden.

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

Wenn Sie eine Ihrer benutzerdefinierten Firebase Hosting Domains oder sogar Ihre benutzerdefinierte Firebase Dynamic Links Domain als neue zugeordnete Domain verwenden möchten, folgen Sie der Anleitung für die gewünschte Domain. Beachten Sie, dass nach Ausführung der Anleitung im folgenden Abschnitt die Deeplink-Funktion in Ihrer Firebase Dynamic Links benutzerdefinierten Domain entfernt wird. Nur die Domain selbst bleibt für das Erstellen von E‑Mail-Links erhalten.

Android-Anwendung für die Verarbeitung Ihres Firebase Hosting Links konfigurieren
1. Damit diese Links von Ihrer Android-Anwendung verarbeitet werden können, muss der Paketname Ihrer App in den Firebase Console Projekteinstellungen angegeben werden. Außerdem müssen der SHA‑1 und der SHA‑256 des Anwendungs zertifikats angegeben werden.
2. Wenn diese Firebase Hosting Links zu einer bestimmten Aktivität weiterleiten sollen, müssen Sie in Ihrer AndroidManifest.xml Datei einen Intent-Filter konfigurieren. Der Intent-Filter sollte Firebase Hosting Links Ihrer Domain abfangen. 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 nahtloses Rollback möglich ist, empfehlen wir, den vorhandenen Intent-Filter, der Firebase Dynamic Links verarbeitet, beizubehalten, während Sie die Firebase Hosting Linklösung testen. 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 festlegen, wie E‑Mail-Links generiert werden sollen, und unser Backend anweisen, Links mit der neuen Firebase Hosting Domain 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 E‑Mail-Anmeldelink wie bisher. Wenn der Endnutzer auf den Link klickt, wird er zur App weitergeleitet, falls 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-Anwendung für die Verarbeitung Ihres Firebase Hosting Links. (Anleitung im vorherigen Abschnitt)
Senden Sie einen Authentifizierungslink an die E‑Mail-Adresse des Nutzers. Verwenden Sie dazu ein aktualisiertes ActionCodeSettings Objekt mit einer benutzerdefinierten Domain als linkDomain.

Benutzerdefinierte Firebase Dynamic Links Domain wiederverwenden

Sie können eine Ihrer Firebase Dynamic Links Domains als benutzerdefinierte Domain wiederverwenden. Allerdings werden dann keine Firebase Dynamic Links Funktionen 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-Anwendung für die Verarbeitung Ihres Firebase Hosting Links (Anleitung im vorherigen Abschnitt).
Senden Sie einen Authentifizierungslink an die E‑Mail-Adresse des Nutzers. Verwenden Sie dazu ein aktualisiertes ActionCodeSettings Objekt mit einer benutzerdefinierten Domain als linkDomain.