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

Die E‑Mail-Link-Authentifizierung basierte bisher auf Firebase Dynamic Links, das am 25. August 2025 eingestellt wird. 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 Links verwendet und Sie eine alternative Methode für die Migration Ihrer App nutzen möchten, lesen Sie den Artikel Mit E-Mail-Link in Android authentifizieren, um das neue Firebase Hosting-basierte System zu verwenden.

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

Zugehörige Firebase Dynamic Links-Domain zu einer Firebase Hosting-Domain migrieren

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

Folgen Sie der Anleitung unter Mit Firebase über E-Mail-Link in Android authentifizieren, um die Links Ihrer mobilen App so zu aktualisieren, dass die neue automatisch bereitgestellte Firebase Hosting-Standarddomain 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 Firebase Dynamic Links-Domain entfernt. Nur die Domain selbst bleibt zum Erstellen von E-Mail-Links erhalten.

Android-Anwendung für die Verarbeitung des Firebase Hosting-Links konfigurieren
1. Damit diese Links von Ihrer Android-Anwendung verarbeitet werden können, muss der Paketname Ihrer App in den Firebase-Konsolenprojekteinstellungen angegeben werden. Außerdem müssen der SHA‑1- und der SHA‑256-Fingerabdruck des Anwendungszertifikats 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 Hostinglink 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 das Rollback reibungslos funktioniert, empfehlen wir, den vorhandenen Intent-Filter, der Firebase Dynamic Links verarbeitet, beizubehalten, während Sie die Firebase Hosting-Linklösung testen. Die Lösung Firebase Dynamic Links 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 das Firebase Admin SDK verwenden, um festzulegen, wie E‑Mail-Links generiert werden sollen. Außerdem können Sie unser Backend anweisen, Links mit der neuen Firebase Hosting-Domain zu generieren.
```
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);
  });
}
```
Wichtig :Wenn Sie während der Implementierung und des Testens der Sicherungslösung ein Rollback auf Firebase Dynamic Links durchführen möchten, sollten Sie die Domain auf FIREBASE_DYNAMIC_LINK zurücksetzen. Die Lösung Firebase Dynamic Links ist bis zum 25. August 2025 verfügbar.
E‑Mail-Link senden und einlösen

Senden Sie den Anmeldelink per E-Mail wie bisher. 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-Anwendung für die Verarbeitung des Firebase Hosting-Links. Eine Anleitung dazu finden Sie im vorherigen Abschnitt.
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 z. B. nicht zu einem App-Shop weitergeleitet werden, wenn die App nicht auf ihrem Gerät installiert ist.
Konfigurieren Sie Ihre Android-Anwendung 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.