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

L'autenticazione tramite link via email si basava in precedenza su Firebase Dynamic Links, che verrà ritirato il 25 agosto 2025. Abbiamo pubblicato una soluzione alternativa nella Firebase Authentication versione 23.2.0 o successive dell'SDK Android e nella Firebase BoM versione 33.9.0 o successive. Se la tua app utilizza i link in stile precedente e vuoi utilizzare un metodo alternativo per la migrazione, consulta Autenticarsi con Firebase utilizzando il link via 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 v20.0.0+ o BoM v26.0.0+) per continuare a gestire i flussi OAuth in Firebase Authentication.

Eseguire 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 delle email alla tua app mobile.

Puoi seguire le istruzioni riportate in Autenticarsi con Firebase utilizzando il link email in Android per aggiornare i link della tua app mobile in modo da utilizzare il nuovo dominio predefinito Firebase Hosting di cui è stato eseguito il provisioning automatico.

Segui queste istruzioni per gestire i link del nuovo dominio e per indicare a Firebase Authentication di iniziare a utilizzare il nuovo dominio per generare link per 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. Nota: dopo aver completato le istruzioni nella sezione seguente, la funzionalità di deep linking sul tuo dominio personalizzato Firebase Dynamic Links verrà rimossa; rimarrà solo il dominio per la creazione di link email.

Configurare l'applicazione Android per gestire il link Firebase Hosting
1. Per gestire questi link dalla tua applicazione Android, il nome del pacchetto dell'app deve essere specificato nelle impostazioni del progetto della console Firebase. Inoltre, devono essere forniti 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 di link Firebase Hosting. La soluzione Firebase Dynamic Links sarà disponibile fino al 25 agosto 2025.
Configurare il progetto in modo da 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.
```
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: per eseguire il rollback a Firebase Dynamic Links durante l'implementazione e il test della soluzione di backup, devi impostare di nuovo il dominio su FIREBASE_DYNAMIC_LINK. La soluzione Firebase Dynamic Links sarà disponibile fino al 25 agosto 2025.
Inviare e utilizzare il link nell'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.

Personalizzare i link per il mobile

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

Utilizzare un dominio Firebase Hosting personalizzato

Segui la Firebase Hosting guida per configurare un dominio personalizzato.
Configura l'applicazione Android per gestire 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.

Riutilizzare il dominio personalizzato Firebase Dynamic Links

Puoi riutilizzare uno qualsiasi dei tuoi domini Firebase Dynamic Links come dominio personalizzato. Tuttavia, qualsiasi funzionalità Firebase Dynamic Links non sarà più supportata (ad esempio, gli utenti non potranno essere reindirizzati a un app store se l'app non è installata sul loro dispositivo).
Configura l'applicazione Android per gestire 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.