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

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 Firebase Authentication per iOS 11.8.0 o versioni successive. Se la tua app utilizza Firebase Dynamic Links, devi eseguirne la migrazione al nuovo sistema basato su Firebase Hosting.

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 collegamento email sulle piattaforme Apple per aggiornare l'app in modo che utilizzi il nuovo dominio predefinito Firebase Hosting provisioning automaticamente.

Segui le istruzioni riportate di seguito per gestire i link dal nuovo dominio e per indicare a Firebase Authentication di iniziare a utilizzare il dominio Firebase Hosting 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 le istruzioni riportate nella sezione Personalizzare i link per il mobile e adatta i passaggi in base al dominio che vuoi utilizzare.

  1. Collega il dominio Firebase Hosting al dominio associato alla tua app.

    Dovrai configurare il dominio selezionato come dominio associato per i link alle app. Per configurare il diritto nell'app, apri la scheda Firma e funzionalità del target in Xcode e aggiungi i domini Firebase Hosting del passaggio precedente alla funzionalità Domini associati. Se utilizzi il dominio Firebase Hosting predefinito, sarà applinks:PROJECT_ID.firebaseapp.com.

    Per saperne di più, consulta Supportare i domini associati sul sito di documentazione di Apple.

    È stato implementato un file di dominio associato in tutti i tuoi domini Firebase Hosting. Per accedervi, vai a PROJECT_ID.firebaseapp.com/.well-known/apple-app-site-association. Questo file AASA può essere sovrascritto. Per ulteriori informazioni, consulta la sezione Creare e ospitare i file di configurazione dei link universali.

  2. Configura il progetto in modo da 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);
});
}

  3. Invia e utilizza il link dell'email.

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

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

  1. Segui la Firebase Hostingguida per configurare un dominio personalizzato.
  2. Collega il dominio personalizzato al dominio associato alla tua app.
  3. Invia un link di autenticazione all'indirizzo email dell'utente con un oggetto ActionCodeSettings aggiornato con un dominio personalizzato come linkDomain.
  1. 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 all'app store se l'app non è installata sul loro dispositivo).
  2. Invia un link di autenticazione all'indirizzo email dell'utente con un oggetto ActionCodeSettings aggiornato con un dominio personalizzato come linkDomain.