Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Eseguire la migrazione dell'accesso tramite link email da Firebase Dynamic Links (Android)

In precedenza, l'autenticazione tramite link via email si basava su Firebase Dynamic Links, che verrà disattivato il 25 agosto 2025. Abbiamo pubblicato una soluzione alternativa nell'Firebase Authentication SDK Android versione 23.2.0 e successive e nell'Firebase BoM versione 33.9.0 e successive. Se la tua app utilizza i link di vecchio stile e vuoi utilizzare un metodo alternativo per eseguire la migrazione dell'app, consulta Esegui l'autenticazione con Firebase utilizzando il link email in Android per utilizzare il nuovo sistema basato su Firebase Hosting.

Inoltre, se utilizzi l'SDK Android Firebase Authentication precedente alla versione 20.0.0 (o Firebase BoM precedente alla versione 26.0.0) per gestire i flussi OAuth con Firebase Authentication, dovrai eseguire l'aggiornamento all'ultima versione dell'SDK Authentication o BoM (Authentication versione 20.0.0 o successive o BoM versione 26.0.0 o successive) per continuare a gestire i flussi OAuth in Firebase Authentication.

Esegui la migrazione del dominio Firebase Dynamic Links associato a un dominio Firebase Hosting

In futuro, anziché utilizzare un dominio Firebase Dynamic Links, Firebase Authentication utilizzerà il dominio predefinito Firebase Hosting per il tuo progetto per creare link per i link email e altre azioni di link out-of-band nelle app mobile. Ciò significa che anche la tua app dovrà essere aggiornata per utilizzare questo dominio predefinito come dominio associato per i link di autenticazione email alla tua app mobile.

Puoi seguire le istruzioni riportate in Esegui l'autenticazione con Firebase utilizzando il link email in Android per aggiornare i link dell'app mobile in modo che utilizzino il nuovo dominio predefinito Firebase Hosting di cui è stato eseguito il provisioning automatico.

Segui le istruzioni riportate di seguito per gestire i link dal nuovo dominio e per indicare a Firebase Authentication di iniziare a utilizzare il nuovo dominio per generare link alle app mobile in futuro.

Se vuoi continuare a utilizzare uno dei tuoi domini Firebase Hosting personalizzati o anche il tuo dominio Firebase Dynamic Links personalizzato come nuovo dominio associato, segui i passaggi corrispondenti al dominio che vuoi utilizzare. Tieni presente che, dopo aver completato le istruzioni riportate nella sezione seguente, la funzionalità di deep linking sul tuo dominio personalizzato Firebase Dynamic Links verrà rimossa; rimarrà solo il dominio stesso per la creazione di link email.

Configura la tua app per Android per gestire il link Firebase Hosting
1. Per gestire questi link dalla tua app per Android, il nome del pacchetto dell'app deve essere specificato nelle impostazioni progetto della console Firebase. Inoltre, è necessario fornire gli SHA-1 e SHA-256 del certificato dell'applicazione.
2. Se vuoi che questi link Firebase Hosting reindirizzino a un'attività specifica, devi configurare un filtro per intent nel file AndroidManifest.xml. Il filtro per intent deve intercettare i link Firebase Hosting del tuo dominio. 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>
```
Quando gli utenti aprono un link di hosting con il percorso "/__/auth/links" e lo schema e l'host che specifichi, la tua app avvierà l'attività con questo filtro per intent per gestire il link.

Importante: per garantire un rollback senza problemi, ti consigliamo di mantenere il filtro per intent esistente che gestisce Firebase Dynamic Links mentre provi la soluzione per i link Firebase Hosting. La soluzione Firebase Dynamic Links sarà disponibile fino al 25 agosto 2025.

Configura il progetto per utilizzare i nuovi link

Quando è tutto pronto per gestire i nuovi link di dominio, puoi utilizzare l'SDK Firebase Admin per aggiornare la modalità di generazione dei link email e indicare al nostro backend di iniziare a generare link utilizzando il nuovo dominio Firebase Hosting.

import { getAuth } from 'firebase-admin/auth';

const updateEmailAuthDomain = async () => {
  const updateRequest = {
    mobileLinksConfig: {
      domain: 'HOSTING_DOMAIN',
    },
  };

  const projectConfigManager = getAuth().projectConfigManager();

  try {
    const response = await projectConfigManager.updateProjectConfig(updateRequest);
    // Updated project config
    console.log('Project configuration updated successfully:', response);
  } catch (error) {
    console.error('Error updating the project:', error);
  }
};

Invia e utilizza il link via email

Invia il link di accesso via email come prima. Quando l'utente finale fa clic sul link, viene reindirizzato all'app, se installata, per completare l'accesso.

Personalizza i link mobile

Puoi utilizzare un dominio Firebase Hosting personalizzato o riutilizzare il tuo dominio Firebase Dynamic Links personalizzato come nuovo dominio dei link mobile.

Utilizza un dominio Firebase Hosting personalizzato

Segui la guida di Firebase Hosting per configurare un dominio personalizzato.
Configura la tua app per Android in modo che gestisca il link Firebase Hosting. (istruzioni nella sezione precedente).
Invia un link di autenticazione all'indirizzo email dell'utente con un oggetto ActionCodeSettings aggiornato con un dominio personalizzato come linkDomain.

Riutilizza il tuo dominio personalizzato Firebase Dynamic Links

Puoi riutilizzare uno qualsiasi dei tuoi domini Firebase Dynamic Links come dominio personalizzato. Tuttavia, le funzionalità di Firebase Dynamic Links non saranno più supportate (ad esempio, gli utenti non possono essere reindirizzati a uno store se l'app non è installata sul loro dispositivo).
Configura l'app per Android in modo che gestisca il link Firebase Hosting (istruzioni nella sezione precedente).
Invia un link di autenticazione all'indirizzo email dell'utente con un oggetto ActionCodeSettings aggiornato con un dominio personalizzato come linkDomain.