Migre o login por link de e-mail do Firebase Dynamic Links (Android)

A autenticação do link por e-mail dependia do Firebase Dynamic Links, que será desativado em 25 de agosto de 2025. Publicamos uma solução alternativa no SDK do Android Firebase Authentication versão 23.2.0+ e Firebase BoM versão 33.9.0+. Se o app usa os links antigos e você quer usar um método alternativo para migrar, consulte Fazer a autenticação com o Firebase usando o link de e-mail no Android para usar o novo sistema baseado em Firebase Hosting.

Além disso, se você estiver usando o SDK do Android Firebase Authentication abaixo da v20.0.0 (ou o Firebase BoM abaixo da v26.0.0) para gerenciar fluxos OAuth com Firebase Authentication, será necessário atualizar para a versão mais recente do SDK do Authentication ou do BoM (Authentication v20.0.0+ ou BoM v26.0.0+) para continuar gerenciando fluxos OAuth no Firebase Authentication.

Migrar seu domínio associado do Firebase Dynamic Links para um domínio Firebase Hosting

Em vez de usar um domínio Firebase Dynamic Links, o Firebase Authentication vai usar o domínio padrão do Firebase Hosting do projeto para criar links para e-mail e outras ações de links fora da banda em apps para dispositivos móveis. Isso significa que seu app também precisará ser atualizado para usar esse domínio padrão como o domínio associado aos links de autenticação de e-mail para o app móvel.

Siga as instruções em Autenticar com o Firebase usando link por e-mail no Android para atualizar os links do app para dispositivos móveis e usar o novo domínio padrão Firebase Hosting provisionado automaticamente.

Use as instruções abaixo para processar links do novo domínio e instruir Firebase Authentication a começar a usar o novo domínio para gerar links de apps para dispositivos móveis.

Se você quiser continuar usando qualquer um dos seus domínios Firebase Hosting personalizados ou até mesmo o domínio Firebase Dynamic Links personalizado como seu novo domínio associado, siga as etapas correspondentes ao domínio que você quer usar. Depois de seguir as instruções na seção a seguir, o recurso de vinculação profunda no seu domínio personalizado Firebase Dynamic Links será removido. Somente o domínio vai permanecer para criar links de e-mail.

1. Configurar o app Android para processar o link Firebase Hosting

   1. Para processar esses links do app Android, o nome do pacote do app precisa ser especificado nas configurações do projeto do console Firebase. Além disso, o SHA-1 e o SHA-256 do certificado do aplicativo precisam ser fornecidos.

   2. Se você quiser que esses links Firebase Hosting redirecionem para uma atividade específica, será necessário configurar um filtro de intent no arquivo AndroidManifest.xml. O filtro de intent precisa capturar links de Firebase Hosting do seu domínio. Em 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>
      

   Quando os usuários abrem um link de hospedagem com o caminho "/__/auth/links" e o esquema e o host especificados, o app inicia a atividade usando esse filtro de intent para processar o link.

   Importante: para garantir uma reversão perfeita, recomendamos manter o filtro de intent que processa Firebase Dynamic Links enquanto você testa a solução de vinculação Firebase Hosting. A solução Firebase Dynamic Links vai estar disponível até 25 de agosto de 2025.

2. Configurar seu projeto para usar as novas vinculações

   Quando estiver tudo pronto para processar os novos links de domínio, use o SDK Admin do Firebase para atualizar como você quer que os links de e-mail sejam gerados e instrua nosso back-end a começar a gerar links usando o novo domínio 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);
     });
   }
   

   Importante: para reverter para o Firebase Dynamic Links durante a implementação e o teste da solução de backup, defina o domínio de volta para FIREBASE_DYNAMIC_LINK. A solução Firebase Dynamic Links vai estar disponível até 25 de agosto de 2025.

3. Enviar e resgatar o link de e-mail

   Envie o link de login por e-mail como antes. Quando o usuário final clicar no link, ele será redirecionado para o app, se instalado, para concluir o login.

Personalização de links móveis

Você pode usar um domínio Firebase Hosting personalizado ou reutilizar o domínio Firebase Dynamic Links personalizado como o novo domínio de links para dispositivos móveis.

Usar um domínio personalizado de Firebase Hosting

1. Siga o guia do Firebase Hosting para configurar um domínio personalizado.
2. Configure o app Android para processar o link Firebase Hosting. (instruções na seção anterior acima).
3. Enviar um link de autenticação para o endereço de e-mail do usuário com um objeto ActionCodeSettings atualizado com um domínio personalizado como linkDomain.

Reutilizar seu domínio Firebase Dynamic Links personalizado

1. Você pode reutilizar qualquer um dos seus domínios Firebase Dynamic Links como domínio personalizado. No entanto, nenhuma funcionalidade Firebase Dynamic Links vai ser mais compatível. Por exemplo, os usuários não poderão ser redirecionados para uma app store se o app não estiver instalado no dispositivo.
2. Configure o app Android para processar o link Firebase Hosting (instruções na seção anterior acima).
3. Enviar um link de autenticação para o endereço de e-mail do usuário com um objeto ActionCodeSettings atualizado com um domínio personalizado como linkDomain.