Inizia con l'autenticazione Firebase su Flutter

Collega la tua app a Firebase

Installa e inizializza gli SDK Firebase per Flutter se non lo hai già fatto.

Aggiungi l'autenticazione Firebase alla tua app

  1. Dalla radice del tuo progetto Flutter, esegui il comando seguente per installare il plugin:

    flutter pub add firebase_auth
    
  2. Una volta completato, ricostruisci la tua applicazione Flutter:

    flutter run
    
  3. Importa il plugin nel tuo codice Dart:

    import 'package:firebase_auth/firebase_auth.dart';
    

Per utilizzare un provider di autenticazione, devi abilitarlo nella console Firebase . Vai alla pagina Metodo di accesso nella sezione Autenticazione Firebase per abilitare l'accesso tramite email/password e qualsiasi altro provider di identità che desideri per la tua app.

(Facoltativo) Prototipa e testa con Firebase Local Emulator Suite

Prima di parlare di come la tua app autentica gli utenti, introduciamo una serie di strumenti che puoi utilizzare per prototipare e testare la funzionalità di autenticazione: Firebase Local Emulator Suite. Se stai decidendo tra tecniche e fornitori di autenticazione, provando diversi modelli di dati con dati pubblici e privati ​​utilizzando l'autenticazione e le regole di sicurezza Firebase o prototipando progetti di interfaccia utente di accesso, poter lavorare localmente senza distribuire servizi live può essere un'ottima idea .

Un emulatore di autenticazione fa parte di Local Emulator Suite, che consente alla tua app di interagire con il contenuto e la configurazione del database emulato, nonché facoltativamente con le risorse del progetto emulato (funzioni, altri database e regole di sicurezza).

L'utilizzo dell'emulatore di autenticazione prevede solo pochi passaggi:

  1. Aggiunta di una riga di codice alla configurazione di test della tua app per connettersi all'emulatore.

  2. Dalla radice della directory del progetto locale, eseguendo firebase emulators:start .

  3. Utilizzando l'interfaccia utente di Local Emulator Suite per la prototipazione interattiva o l'API REST dell'emulatore di autenticazione per test non interattivi.

  4. Chiama useAuthEmulator() per specificare l'indirizzo e la porta dell'emulatore:

    Future<void> main() async {
    WidgetsFlutterBinding.ensureInitialized();
    await Firebase.initializeApp();
    
    // Ideal time to initialize
    await FirebaseAuth.instance.useAuthEmulator('localhost', 9099);
    //...
    }
    

Una guida dettagliata è disponibile in Connetti la tua app all'emulatore di autenticazione . Per ulteriori informazioni, vedere l' introduzione alla Local Emulator Suite .

Ora continuiamo con come autenticare gli utenti.

Controlla lo stato di autenticazione corrente

Firebase Auth fornisce numerosi metodi e utilità per consentirti di integrare l'autenticazione sicura nella tua applicazione Flutter nuova o esistente. In molti casi, dovrai conoscere lo stato di autenticazione del tuo utente, ad esempio se ha effettuato l'accesso o meno.

Firebase Auth ti consente di iscriverti in tempo reale a questo stato tramite uno Stream . Una volta chiamato, il flusso fornisce un evento immediato relativo allo stato di autenticazione corrente dell'utente, quindi fornisce eventi successivi ogni volta che lo stato di autenticazione cambia.

Esistono tre metodi per ascoltare le modifiche dello stato di autenticazione:

authStateChanges()

Per sottoscrivere queste modifiche, chiama il metodo authStateChanges() sulla tua istanza FirebaseAuth :

FirebaseAuth.instance
  .authStateChanges()
  .listen((User? user) {
    if (user == null) {
      print('User is currently signed out!');
    } else {
      print('User is signed in!');
    }
  });

Gli eventi vengono attivati ​​quando si verifica quanto segue:

  • Subito dopo che l'ascoltatore è stato registrato.
  • Quando un utente ha effettuato l'accesso.
  • Quando l'utente corrente è disconnesso.

idTokenChanges()

Per sottoscrivere queste modifiche, chiama il metodo idTokenChanges() sulla tua istanza FirebaseAuth :

FirebaseAuth.instance
  .idTokenChanges()
  .listen((User? user) {
    if (user == null) {
      print('User is currently signed out!');
    } else {
      print('User is signed in!');
    }
  });

Gli eventi vengono attivati ​​quando si verifica quanto segue:

  • Subito dopo che l'ascoltatore è stato registrato.
  • Quando un utente ha effettuato l'accesso.
  • Quando l'utente corrente è disconnesso.
  • Quando si verifica una modifica nel token dell'utente corrente.

userChanges()

Per sottoscrivere queste modifiche, chiama il metodo userChanges() sulla tua istanza FirebaseAuth :

FirebaseAuth.instance
  .userChanges()
  .listen((User? user) {
    if (user == null) {
      print('User is currently signed out!');
    } else {
      print('User is signed in!');
    }
  });

Gli eventi vengono attivati ​​quando si verifica quanto segue:

  • Subito dopo che l'ascoltatore è stato registrato.
  • Quando un utente ha effettuato l'accesso.
  • Quando l'utente corrente è disconnesso.
  • Quando si verifica una modifica nel token dell'utente corrente.
  • Quando vengono chiamati i seguenti metodi forniti da FirebaseAuth.instance.currentUser :
    • reload()
    • unlink()
    • updateEmail()
    • updatePassword()
    • updatePhoneNumber()
    • updateProfile()

Stato di autenticazione persistente

Gli SDK Firebase per tutte le piattaforme forniscono supporto immediato per garantire che lo stato di autenticazione dell'utente venga mantenuto durante i riavvii delle app o i ricaricamenti della pagina.

Nelle piattaforme native come Android e iOS, questo comportamento non è configurabile e lo stato di autenticazione dell'utente verrà mantenuto sul dispositivo tra i riavvii dell'app. L'utente può cancellare i dati memorizzati nella cache delle app utilizzando le impostazioni del dispositivo, che cancelleranno qualsiasi stato esistente memorizzato.

Sulle piattaforme Web, lo stato di autenticazione dell'utente è archiviato in IndexedDB . È possibile modificare la persistenza per archiviare i dati nella memoria locale utilizzando Persistence.LOCAL . Se necessario, è possibile modificare questo comportamento predefinito per mantenere solo lo stato di autenticazione per la sessione corrente o per niente. Per configurare queste impostazioni, chiama il seguente metodo FirebaseAuth.instanceFor(app: Firebase.app(), persistence: Persistence.LOCAL); . È comunque possibile aggiornare la persistenza per ciascuna istanza di Auth utilizzando setPersistence(Persistence.NONE) .

// Disable persistence on web platforms. Must be called on initialization:
final auth = FirebaseAuth.instanceFor(app: Firebase.app(), persistence: Persistence.NONE);
// To change it after initialization, use `setPersistence()`:
await auth.setPersistence(Persistence.LOCAL);

Prossimi passi

Esplora le guide sull'accesso e sulla registrazione degli utenti con i servizi di identità e autenticazione supportati.