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

L'authentification des liens d'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.

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.

Important :Pour garantir un rollback fluide, nous vous recommandons de conserver votre filtre d'intent existant qui gère Firebase Dynamic Links lorsque vous testez la solution de liaison Firebase Hosting. La solution Firebase Dynamic Links sera disponible jusqu'au 25 août 2025.
Configurer votre projet pour utiliser les nouveaux liens

Lorsque vous serez prêt à gérer les liens vers le nouveau domaine, vous pourrez utiliser le SDK Admin Firebase pour modifier la manière dont les liens vers les e-mails doivent être générés et demander à notre backend de commencer à générer des liens à l'aide du nouveau domaine Firebase Hosting.
```
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);
  });
}
```
Important :Pour revenir à Firebase Dynamic Links lors de l'implémentation et du test de la solution de sauvegarde, vous devez rétablir le domaine sur FIREBASE_DYNAMIC_LINK. La solution Firebase Dynamic Links sera disponible jusqu'au 25 août 2025.
Envoyer et utiliser le lien de l'e-mail

Envoyez le lien de connexion par e-mail comme précédemment. Lorsque l'utilisateur final clique sur le lien, il est redirigé vers l'application si elle est installée pour finaliser la connexion.

Personnaliser vos liens mobiles

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é

Suivez le guide Firebase Hosting pour configurer un domaine personnalisé.
Configurez votre application Android pour qu'elle gère votre lien Firebase Hosting. (instructions dans la section précédente ci-dessus).
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.

Réutiliser votre domaine Firebase Dynamic Links personnalisé

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).
Configurez votre application Android pour gérer votre lien Firebase Hosting (instructions dans la section précédente ci-dessus).
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.