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

Für die Authentifizierung von E-Mail-Links wurde bisher Firebase Dynamic Links verwendet, das am 25. August 2025 eingestellt wird. Wir haben eine alternative Lösung in den Firebase Authentication Android SDK-Versionen 23.2.0 und höher sowie in den Firebase BoM-Versionen 33.9.0 und höher veröffentlicht. Wenn Ihre App die alten Links verwendet und Sie eine alternative Methode zur Migration Ihrer App verwenden möchten, lesen Sie den Hilfeartikel Über den E-Mail-Link in Android mit Firebase 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-Vorgänge mit Firebase Authentication zu verwalten, müssen Sie auf die neueste Authentication SDK- oder BoM-Version (Authentication v20.0.0 oder höher oder BoM v26.0.0 oder höher) aktualisieren, um OAuth-Vorgänge weiterhin in Firebase Authentication zu verwalten.

Ihre verknüpfte Firebase Dynamic Links-Domain zu einer Firebase Hosting-Domain migrieren

Künftig verwendet Firebase Authentication anstelle einer Firebase Dynamic Links-Domain 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 auch Ihre App 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 Über E-Mail-Link in Android mit Firebase authentifizieren, um die Links Ihrer mobilen App so zu aktualisieren, dass die neue automatisch bereitgestellte Firebase Hosting-Standarddomain verwendet wird.

Folgen Sie der folgenden Anleitung, um Links von der neuen Domain zu verarbeiten und Firebase Authentication anzuweisen, ab sofort die neue Domain 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. Zum Erstellen von E-Mail-Links bleibt nur die Domain selbst übrig.

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 Projekteinstellungen der Firebase-Konsole 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 in Ihrer AndroidManifest.xml-Datei einen Intent-Filter 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-Verknüpfungslö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 Links für die neue Domain 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.
```
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 bei der Implementierung und dem Testen der Sicherungslösung zu Firebase Dynamic Links zurückkehren möchten, sollten Sie die Domain wieder auf FIREBASE_DYNAMIC_LINK zurücksetzen. Die Firebase Dynamic Links-Lösung ist bis zum 25. August 2025 verfügbar.
E-Mail-Link senden und einlösen

Senden Sie den Link zur Anmeldung 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.

Links für Mobilgeräte anpassen

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

Benutzerdefinierte Firebase Hosting-Domain verwenden

Folgen Sie der Firebase HostingAnleitung, um eine benutzerdefinierte Domain einzurichten.
Konfigurieren Sie Ihre Android-Anwendung für den Firebase Hosting-Link. (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 eine Ihrer Firebase Dynamic Links-Domains als benutzerdefinierte Domain wiederverwenden. Alle Firebase Dynamic Links-Funktionen werden jedoch nicht mehr unterstützt. Nutzer können beispielsweise nicht mehr zu einem App-Shop weitergeleitet werden, wenn die App nicht auf ihrem Gerät installiert ist.
Konfiguriere deine Android-Anwendung so, dass sie deinen 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.