Migrer la connexion par lien e-mail depuis Firebase Dynamic Links (Android)

L'authentification des liens par e-mail reposait auparavant sur Firebase Dynamic Links, qui sera arrêtée le 25 août 2025. Nous avons publié une autre solution dans les versions 23.2.0 et ultérieures du SDK Android Firebase Authentication et dans les versions 33.9.0 et ultérieures de Firebase BoM. Si votre application utilise les anciens liens et que vous souhaitez utiliser une autre méthode pour migrer votre application, consultez S'authentifier avec Firebase à l'aide d'un lien par e-mail sur Android pour utiliser le nouveau système basé sur Firebase Hosting.

De plus, si vous utilisez le SDK Android Firebase Authentication version antérieure à 20.0.0 (ou la version Firebase BoM antérieure à 26.0.0) pour gérer les flux OAuth avec Firebase Authentication, vous devez passer à la dernière version du SDK Authentication ou de BoM (Authentication 20.0.0 ou version ultérieure ou BoM 26.0.0 ou version ultérieure) pour continuer à gérer les flux OAuth dans Firebase Authentication.

Migrer votre domaine Firebase Dynamic Links associé vers un domaine Firebase Hosting

À l'avenir, au lieu d'utiliser un domaine Firebase Dynamic Links, Firebase Authentication utilisera le domaine par défaut Firebase Hosting de votre projet pour créer des liens pour le lien e-mail et d'autres actions de lien hors bande dans les applications mobiles. Cela signifie que votre application devra également être mise à jour pour utiliser ce domaine par défaut comme domaine associé aux liens d'authentification des e-mails vers votre application mobile.

Vous pouvez suivre les instructions de la section S'authentifier avec Firebase à l'aide d'un lien de messagerie sur Android pour mettre à jour les liens de votre application mobile afin d'utiliser le nouveau domaine par défaut Firebase Hosting provisionné automatiquement.

Suivez les instructions ci-dessous pour gérer les liens du nouveau domaine et demander à Firebase Authentication de commencer à utiliser le nouveau domaine pour générer des liens vers des applications mobiles à l'avenir.

Si vous souhaitez continuer à utiliser l'un de vos domaines Firebase Hosting personnalisés ou même votre domaine Firebase Dynamic Links personnalisé comme nouveau domaine associé, suivez les étapes correspondant au domaine que vous souhaitez utiliser. Notez qu'une fois que vous aurez suivi les instructions de la section suivante, la fonctionnalité de liens profonds de votre domaine personnalisé Firebase Dynamic Links sera supprimée. Seul le domaine lui-même restera pour créer des liens vers des e-mails.

  1. Configurer votre application Android pour gérer votre lien Firebase Hosting

    1. Pour gérer ces liens à partir de votre application Android, le nom de package de votre application doit être spécifié dans les paramètres du projet de la console Firebase. De plus, les valeurs SHA-1 et SHA-256 du certificat de l'application doivent être fournies.
    2. Si vous souhaitez que ces liens Firebase Hosting redirigent vers une activité spécifique, vous devez configurer un filtre d'intent dans votre fichier AndroidManifest.xml. Le filtre d'intent doit détecter les liens Firebase Hosting de votre domaine. Dans 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>
      

    Lorsque les utilisateurs ouvrent un lien d'hébergement avec le chemin "/__/auth/links", ainsi que le schéma et l'hôte que vous spécifiez, votre application démarre l'activité avec ce filtre d'intent pour gérer le lien.

Vous pouvez utiliser un domaine Firebase Hosting personnalisé ou réutiliser votre domaine Firebase Dynamic Links personnalisé comme nouveau domaine de liens mobiles.

Utiliser un domaine Firebase Hosting personnalisé

  1. Suivez le guide Firebase Hosting pour configurer un domaine personnalisé.
  2. Configurez votre application Android pour qu'elle gère votre lien Firebase Hosting. (instructions dans la section précédente ci-dessus).
  3. Envoyez un lien d'authentification à l'adresse e-mail de l'utilisateur avec un objet ActionCodeSettings mis à jour avec un domaine personnalisé en tant que linkDomain.
  1. Vous pouvez réutiliser n'importe lequel de vos domaines Firebase Dynamic Links comme domaine personnalisé. Toutefois, aucune fonctionnalité Firebase Dynamic Links ne sera plus prise en charge (par exemple, les utilisateurs ne pourront plus être redirigés vers une plate-forme de téléchargement d'applications si l'application n'est pas installée sur leur appareil).
  2. Configurez votre application Android pour gérer votre lien Firebase Hosting (instructions dans la section précédente ci-dessus).
  3. Envoyez un lien d'authentification à l'adresse e-mail de l'utilisateur avec un objet ActionCodeSettings mis à jour avec un domaine personnalisé en tant que linkDomain.