Pierwsze kroki z Uwierzytelnianiem Firebase na platformach Apple

Możesz używać uwierzytelniania Firebase, aby zezwolić użytkownikom na logowanie się w aplikacji za pomocą jednego lub więcej metod logowania, w tym logowanie za pomocą adresu e-mail i hasła, dostawców tożsamości sfederowanych, takich jak Logowanie przez Google i Logowanie przez Facebooka. Ten pokazuje, jak zacząć korzystać z Uwierzytelniania Firebase. Pokażemy, jak dodać adres e-mail i hasło, aby zalogować się w aplikacji.

Łączenie aplikacji z Firebase

1. Zainstaluj pakiet SDK Firebase.
2. W konsoli Firebase dodaj swoją aplikację do projektu Firebase.

Dodaj Uwierzytelnianie Firebase do swojej aplikacji

Użyj menedżera pakietów Swift, aby zainstalować zależności Firebase i nimi zarządzać.

1. W Xcode po otwarciu projektu aplikacji przejdź do File > Dodaj pakiety.
2. Gdy pojawi się prośba, dodaj repozytorium SDK platform Apple Platform SDK Firebase:

  https://github.com/firebase/firebase-ios-sdk.git

3. Wybierz bibliotekę uwierzytelniania Firebase.
4. Dodaj flagę -ObjC do sekcji Inne flagi łączące w ustawieniach kompilacji celu.
5. Po zakończeniu Xcode automatycznie rozpocznie rozpoznawanie i pobieranie lub zależności w tle.

(Opcjonalnie) Prototypowanie i testowanie w Pakiecie emulatorów lokalnych Firebase

Zanim przejdziemy do omówienia sposobu uwierzytelniania użytkowników przez Twoją aplikację, narzędzia służące do prototypowania i testowania funkcji uwierzytelniania: Pakiet emulatorów lokalnych Firebase. Jeśli zastanawiasz się nad techniką uwierzytelniania i usługodawcom, testując różne modele danych z wykorzystaniem danych publicznych i prywatnych za pomocą uwierzytelniania i reguł zabezpieczeń Firebase lub prototypowania interfejsu logowania, pracować lokalnie bez wdrażania usług w czasie rzeczywistym.

Emulator uwierzytelniania jest częścią Pakietu emulatorów lokalnych, umożliwia aplikacji interakcję z emulowaną treścią i konfiguracją bazy danych a także opcjonalnie emulowane zasoby projektu (funkcje, inne bazy danych, i reguły zabezpieczeń).

Aby zacząć korzystać z emulatora uwierzytelniania, wystarczy kilka kroków:

1. Dodajesz wiersz kodu do konfiguracji testowej aplikacji, aby połączyć się z emulatorem.
2. Uruchomienie firebase emulators:start w katalogu głównym projektu lokalnego.
3. przy użyciu interfejsu użytkownika Pakietu emulatorów lokalnych do interaktywnego prototypowania; Interfejs API typu REST emulatora uwierzytelniania do testowania nieinteraktywnego.

Szczegółowy przewodnik znajdziesz w artykule Łączenie aplikacji z emulatorem uwierzytelniania. Więcej informacji znajdziesz we wprowadzeniu do Pakietu emulatorów lokalnych.

Teraz przejdźmy do uwierzytelniania użytkowników.

Inicjowanie pakietu SDK Firebase

Najpierw zaimportuj pakiet SDK Firebase na koncie delegata aplikacji:

import FirebaseCore
AppDelegate.swift

@import FirebaseCore;
AppDelegate.m

Następnie w metodzie application:didFinishLaunchingWithOptions: zainicjuj Obiekt FirebaseApp:

// Use Firebase library to configure APIs
FirebaseApp.configure()
AppDelegate.swift

// Use Firebase library to configure APIs
[FIRApp configure];
AppDelegate.m

Wykrywaj stan uwierzytelniania

W przypadku każdego widoku aplikacji, który wymaga informacji o zalogowanym użytkowniku, dołączysz detektor do obiektu FIRAuth. Ten detektor jest wywoływany za każdym razem, zmieni się stan logowania użytkownika.

Podłącz detektor w metodzie viewWillAppear kontrolera widoku danych:

handle = Auth.auth().addStateDidChangeListener { auth, user in
  // ...
}
MainViewController.swift

self.handle = [[FIRAuth auth]
    addAuthStateDidChangeListener:^(FIRAuth *_Nonnull auth, FIRUser *_Nullable user) {
      // ...
    }];
MainViewController.m

I odłącz detektor w metodzie viewWillDisappear kontrolera widoku:

Auth.auth().removeStateDidChangeListener(handle!)
MainViewController.swift

[[FIRAuth auth] removeAuthStateDidChangeListener:_handle];
MainViewController.m

Zarejestruj nowych użytkowników

Utwórz formularz, który pozwala nowym użytkownikom zarejestrować się w aplikacji za pomocą adresu e-mail adresu e-mail i hasła. Gdy użytkownik wypełni formularz, potwierdź adres e-mail adresu i hasła podanych przez użytkownika, a następnie przekaż je do createUser :

Auth.auth().createUser(withEmail: email, password: password) { authResult, error in
  // ...
}
EmailViewController.swift

[[FIRAuth auth] createUserWithEmail:email
                           password:password
                         completion:^(FIRAuthDataResult * _Nullable authResult,
                                      NSError * _Nullable error) {
  // ...
}];
EmailViewController.m

Logowanie istniejących użytkowników

Utwórz formularz, który umożliwia dotychczasowym użytkownikom logowanie się za pomocą ich adresów e-mail i hasło. Gdy użytkownik wypełni formularz, wywołaj metodę signIn:

Auth.auth().signIn(withEmail: email, password: password) { [weak self] authResult, error in
  guard let strongSelf = self else { return }
  // ...
}
EmailViewController.swift

[[FIRAuth auth] signInWithEmail:self->_emailField.text
                       password:self->_passwordField.text
                     completion:^(FIRAuthDataResult * _Nullable authResult,
                                  NSError * _Nullable error) {
  // ...
}];
EmailViewController.m

Uzyskiwanie informacji o użytkowniku

Gdy użytkownik się zaloguje, możesz uzyskać informacje o nim. Dla: na przykład w detektorze stanu uwierzytelniania:

if let user = user {
  // The user's ID, unique to the Firebase project.
  // Do NOT use this value to authenticate with your backend server,
  // if you have one. Use getTokenWithCompletion:completion: instead.
  let uid = user.uid
  let email = user.email
  let photoURL = user.photoURL
  var multiFactorString = "MultiFactor: "
  for info in user.multiFactor.enrolledFactors {
    multiFactorString += info.displayName ?? "[DispayName]"
    multiFactorString += " "
  }
  // ...
}
MainViewController.swift

if (user) {
  // The user's ID, unique to the Firebase project.
  // Do NOT use this value to authenticate with your backend server,
  // if you have one. Use getTokenWithCompletion:completion: instead.
  NSString *email = user.email;
  NSString *uid = user.uid;
  NSMutableString *multiFactorString = [NSMutableString stringWithFormat:@"MultiFactor: "];
  for (FIRMultiFactorInfo *info in user.multiFactor.enrolledFactors) {
    [multiFactorString appendString:info.displayName];
    [multiFactorString appendString:@" "];
  }
  NSURL *photoURL = user.photoURL;
  // ...
}
MainViewController.m

Dalsze kroki

Dowiedz się, jak dodać obsługę innych dostawców tożsamości i anonimowych gości konta:

• Logowanie przez Google
• Logowanie do Facebooka
• Logowanie na Twitterze
• Logowanie w GitHub
• Logowanie anonimowe