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

In precedenza, l'autenticazione dei link email si basava su Firebase Dynamic Links, che verrà ritirato il 25 agosto 2025. Abbiamo pubblicato una soluzione alternativa nell'SDK Android Firebase Authentication versione 23.2.0 o successiva e Firebase BoM versione 33.9.0 o successiva. Se la tua app utilizza i link di tipo precedente e vuoi utilizzare un metodo alternativo per eseguirne la migrazione, consulta Eseguire 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, devi eseguire l'aggiornamento all'SDK Authentication o alla versione BoM più recente (Authentication v20.0.0 o successiva o BoM v26.0.0 o successiva) per continuare a gestire i flussi OAuth in Firebase Authentication.

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

In futuro, anziché utilizzare un dominio Firebase Dynamic Links, Firebase Authentication userà il dominio predefinito Firebase Hosting per il tuo progetto per creare link per il link email e altre azioni di collegamento 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 delle app mobile in modo da utilizzare 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 i 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 collegamento diretto nel tuo dominio personalizzato Firebase Dynamic Links verrà rimossa. Per la creazione dei link email rimarrà solo il dominio stesso.

Configurare l'applicazione per Android in modo che gestisca 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 gli hash SHA-1 e SHA-256 del certificato dell'applicazione.
2. Se vuoi che questi link Firebase Hosting reindirizzino a un'attività specifica, dovrai configurare un filtro intent nel file AndroidManifest.xml. Il filtro intent deve rilevare i linkFirebase 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 specificati, la tua app avvia l'attività con questo filtro intent per gestire il link.

Importante: per garantire un rollback senza problemi, ti consigliamo di mantenere il filtro intent esistente che gestisce Firebase Dynamic Links durante la prova della soluzione di collegamento Firebase Hosting. La soluzione Firebase Dynamic Links sarà disponibile fino al 25 agosto 2025.
Configurare il progetto per utilizzare i nuovi link

Quando è tutto pronto per gestire i link del nuovo 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 i 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 alla versione Firebase Dynamic Links durante l'implementazione e il test della soluzione di backup, devi ripristinare il dominio su FIREBASE_DYNAMIC_LINK. La soluzione Firebase Dynamic Links sarà disponibile fino al 25 agosto 2025.
Inviare e utilizzare il link dell'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 per Android in modo che gestisca il link Firebase Hosting. (istruzioni nella sezione precedente qui sopra).
Invia un link di autenticazione all'indirizzo email dell'utente con un oggetto ActionCodeSettings aggiornato con un dominio personalizzato come linkDomain.

Riutilizzare il dominio Firebase Dynamic Links personalizzato

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