Connexion utilisateur iOS avec ParseSwift SDK - Tutoriel

11min
Connexion et déconnexion de l'utilisateur
Introduction
Dans le guide d'inscription des utilisateurs nous avons appris comment intégrer une option d'inscription dans une application iOS en utilisant la plateforme Back4App et le ParseSwift SDK. Une fois qu'un utilisateur s'est inscrit avec succès dans votre application, les actions de connexion et de déconnexion sont des fonctionnalités clés dans le flux de l'application.
Le ParseSwift SDK nous permettra d'intégrer ces fonctionnalités de manière transparente dans n'importe quelle application iOS.
Prérequis
Pour compléter ce guide rapide, vous avez besoin de :
Xcode.
Une application créée sur Back4App.
Suivez le tutoriel sur la création d'une nouvelle application Parse pour apprendre à créer une application Parse sur Back4App.
Remarque : Suivez le tutoriel d'installation du SDK Parse (Swift) pour créer un projet Xcode connecté à Back4App.
Objectif
Implémenter une fonctionnalité de connexion et de déconnexion des utilisateurs en utilisant le ParseSwift SDK et la plateforme Back4App.
- Configuration des fonctionnalités de connexion et de déconnexion
Avant de commencer à implémenter toute fonctionnalité de connexion, nous devons créer l'objet qui représentera l'utilisateur. Pour simplifier, nous allons réutiliser la même Utilisateur structure (qui conforme au ParseUser protocole) que nous avons introduite dans le guide d'enregistrement des utilisateurs:
Swift
import Foundation
import ParseSwift

struct User: ParseUser {
  ...
    
  var username: String?
  var email: String?
  var emailVerified: Bool?
  var password: String?
    
  var age: Int?
}
import Foundation
import ParseSwift

struct User: ParseUser {
  ...
    
  var username: String?
  var email: String?
  var emailVerified: Bool?
  var password: String?
    
  var age: Int?
}
﻿
Nous recommandons de suivre le guide d'enregistrement des utilisateurs et d'enregistrer au moins un utilisateur pour l'utiliser comme exemple pour ce guide.
Tout comme le processus d'inscription, la connexion nécessite un formulaire où l'utilisateur saisit son nom d'utilisateur et mot de passe. Ensuite, nous effectuons une demande de connexion en utilisant les méthodes correspondantes fournies par le ParseSwift SDK. À son tour, Back4App traite la demande et renvoie une réponse contenant les informations de connexion. Lorsqu'une erreur se produit, la réponse renvoie des informations pour identifier et gérer cette erreur.
Le processus de déconnexion est simple. Le ParseSwift SDK nous permet de l'implémenter en une seule ligne de code.
- Configuration de l'application
Une fois que vous connecté votre projet Xcode à votre Back4App application, l'étape suivante consiste à configurer l'interface utilisateur de l'application.
Pour le processus de connexion, nous allons implémenter un contrôleur simple contenant les champs de saisie correspondants et un bouton de connexion :
﻿
La classe responsable de ce formulaire s'appelle LogInController et c'est une sous-classe de UIViewController. Les composants clés à intégrer dans ce contrôleur sont deux UITextField et un UIButton. L'extrait suivant montre l'implémentation de la classe LogInController :
Swift
 import UIKit
 import ParseSwift
3
 class LogInController: UIViewController {
   private let usernameTextField: UITextField = {
     let textField = UITextField()
     textField.borderStyle = .roundedRect
     textField.placeholder = "Username *"
     textField.autocapitalizationType = .none
    textField.textAlignment = .center
    return textField
  }()
  
  private let passwordTextField: UITextField = {
    let textField = UITextField()
    textField.borderStyle = .roundedRect
    textField.isSecureTextEntry = true
    textField.placeholder = "Password *"
    textField.textAlignment = .center
    return textField
  }()
  
  private let logInButton: UIButton = {
    let button = UIButton(type: .roundedRect)
    button.setTitle("Log in", for: .normal)
    return button
  }()
  
  override func viewDidLoad() {
  super.viewDidLoad()
      
    navigationItem.title = "Back4App Log In"
        
    // Lays out the login form
    let stackView = UIStackView(arrangedSubviews: [usernameTextField, passwordTextField, logInButton])
    stackView.translatesAutoresizingMaskIntoConstraints = false
    stackView.spacing = 8
    stackView.axis = .vertical
    stackView.distribution = .fillEqually
      
    let stackViewHeight = CGFloat(stackView.arrangedSubviews.count) * (44 + stackView.spacing) - stackView.spacing
      
    view.addSubview(stackView)
    stackView.centerXAnchor.constraint(equalTo: view.safeAreaLayoutGuide.centerXAnchor).isActive = true
    stackView.centerYAnchor.constraint(equalTo: view.safeAreaLayoutGuide.centerYAnchor).isActive = true
    stackView.widthAnchor.constraint(equalTo: view.safeAreaLayoutGuide.widthAnchor, multiplier: 0.7).isActive = true
    stackView.heightAnchor.constraint(equalToConstant: stackViewHeight).isActive = true
      
    // Adds the method that will be called when the user taps the login button
    logInButton.addTarget(self, action: #selector(handleLogIn), for: .touchUpInside)
      
    // If the user is already logged in, we redirect them to the HomeController
    guard let user = User.current else { return }
    let homeController = HomeController()
    homeController.user = user
      
    navigationController?.pushViewController(homeController, animated: true)
  }
    
  /// Called when the user taps on the logInButton button
  @objc private func handleLogIn() {
    guard let username = usernameTextField.text, !username.isEmpty,
          let password = passwordTextField.text, !password.isEmpty else {
      // Shows an alert with the appropriate title and message.
      return showMessage(title: "Error", message: "Invalid credentials.")
    }
      
    logIn(with: username, password: password)
  }
  
  /// Logs in the user and presents the app's home screen (HomeController)
  /// - Parameters:
  ///   - username: User's username
  ///   - password: User's password
  private func logIn(with username: String, password: String) {
    // TODO: Here we will implement the login process
  }
}
 import UIKit
 import ParseSwift
3
 class LogInController: UIViewController {
   private let usernameTextField: UITextField = {
     let textField = UITextField()
     textField.borderStyle = .roundedRect
     textField.placeholder = "Username *"
     textField.autocapitalizationType = .none
    textField.textAlignment = .center
    return textField
  }()
  
  private let passwordTextField: UITextField = {
    let textField = UITextField()
    textField.borderStyle = .roundedRect
    textField.isSecureTextEntry = true
    textField.placeholder = "Password *"
    textField.textAlignment = .center
    return textField
  }()
  
  private let logInButton: UIButton = {
    let button = UIButton(type: .roundedRect)
    button.setTitle("Log in", for: .normal)
    return button
  }()
  
  override func viewDidLoad() {
  super.viewDidLoad()
      
    navigationItem.title = "Back4App Log In"
        
    // Lays out the login form
    let stackView = UIStackView(arrangedSubviews: [usernameTextField, passwordTextField, logInButton])
    stackView.translatesAutoresizingMaskIntoConstraints = false
    stackView.spacing = 8
    stackView.axis = .vertical
    stackView.distribution = .fillEqually
      
    let stackViewHeight = CGFloat(stackView.arrangedSubviews.count) * (44 + stackView.spacing) - stackView.spacing
      
    view.addSubview(stackView)
    stackView.centerXAnchor.constraint(equalTo: view.safeAreaLayoutGuide.centerXAnchor).isActive = true
    stackView.centerYAnchor.constraint(equalTo: view.safeAreaLayoutGuide.centerYAnchor).isActive = true
    stackView.widthAnchor.constraint(equalTo: view.safeAreaLayoutGuide.widthAnchor, multiplier: 0.7).isActive = true
    stackView.heightAnchor.constraint(equalToConstant: stackViewHeight).isActive = true
      
    // Adds the method that will be called when the user taps the login button
    logInButton.addTarget(self, action: #selector(handleLogIn), for: .touchUpInside)
      
    // If the user is already logged in, we redirect them to the HomeController
    guard let user = User.current else { return }
    let homeController = HomeController()
    homeController.user = user
      
    navigationController?.pushViewController(homeController, animated: true)
  }
    
  /// Called when the user taps on the logInButton button
  @objc private func handleLogIn() {
    guard let username = usernameTextField.text, !username.isEmpty,
          let password = passwordTextField.text, !password.isEmpty else {
      // Shows an alert with the appropriate title and message.
      return showMessage(title: "Error", message: "Invalid credentials.")
    }
      
    logIn(with: username, password: password)
  }
  
  /// Logs in the user and presents the app's home screen (HomeController)
  /// - Parameters:
  ///   - username: User's username
  ///   - password: User's password
  private func logIn(with username: String, password: String) {
    // TODO: Here we will implement the login process
  }
}
﻿
De plus, la fonction d'aide showMessage(title:message:) est implémentée dans une extension de UIViewController:
Swift
 extension UIViewController {
2
     /// Presents an alert with a title, a message and a back button.
     /// - Parameters:
     ///   - title: Title for the alert
     ///   - message: Shor message for the alert
     func showMessage(title: String, message: String) {
         let alertController = UIAlertController(title: title, message: message, preferredStyle: .alert)
         
        alertController.addAction(UIAlertAction(title: "Back", style: .cancel))
      
        present(alertController, animated: true)
    }
}
 extension UIViewController {
2
     /// Presents an alert with a title, a message and a back button.
     /// - Parameters:
     ///   - title: Title for the alert
     ///   - message: Shor message for the alert
     func showMessage(title: String, message: String) {
         let alertController = UIAlertController(title: title, message: message, preferredStyle: .alert)
         
        alertController.addAction(UIAlertAction(title: "Back", style: .cancel))
      
        present(alertController, animated: true)
    }
}
﻿
Pour le processus de déconnexion, nous insérons un bouton dans le contrôleur d'accueil, c'est-à-dire, HomeController. Ce contrôleur de vue ne contiendra que le bouton de déconnexion et une étiquette affichant le nom d'utilisateur de l'utilisateur:
﻿
L'implémentation de ce contrôleur de vue est simple :
Swift
 import UIKit
 import ParseSwift
3
 class HomeController: UIViewController {
  
   /// When set, it updates the usernameLabel's text with the user's username.
   var user: User? {
     didSet {
       usernameLabel.text = "Hello \(user?.username ?? "N/A")!"
    }
  }
  
  private let usernameLabel: UILabel = {
    let label = UILabel()
    label.textAlignment = .center
    label.font = .boldSystemFont(ofSize: 18)
    label.translatesAutoresizingMaskIntoConstraints = false
    return label
  }()
  
  private let logOutButton: UIButton = {
    let button = UIButton(type: .roundedRect)
    button.setTitle("Log out", for: .normal)
    button.translatesAutoresizingMaskIntoConstraints = false
    return button
  }()
  
  override func viewDidLoad() {
    super.viewDidLoad()
      
    // Sets up the layout (usernameLabel and logOutButton)
    view.backgroundColor = .systemBackground
    navigationItem.hidesBackButton = true
    navigationItem.title = "Back4App"
    view.addSubview(usernameLabel)
    view.addSubview(logOutButton)
      
    usernameLabel.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor, constant: 8).isActive = true
    usernameLabel.centerXAnchor.constraint(equalTo: view.safeAreaLayoutGuide.centerXAnchor).isActive = true
      
    logOutButton.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor, constant: 8).isActive = true
    logOutButton.centerXAnchor.constraint(equalTo: view.safeAreaLayoutGuide.centerXAnchor).isActive = true
      
    // Adds the method that will be called when the user taps the logout button
    logOutButton.addTarget(self, action: #selector(handleLogOut), for: .touchUpInside)
  }
  
  /// Called when the user taps the logout button.
  @objc private func handleLogOut() {
    // TODO: Here we will implement the logout process
  }
}
 import UIKit
 import ParseSwift
3
 class HomeController: UIViewController {
  
   /// When set, it updates the usernameLabel's text with the user's username.
   var user: User? {
     didSet {
       usernameLabel.text = "Hello \(user?.username ?? "N/A")!"
    }
  }
  
  private let usernameLabel: UILabel = {
    let label = UILabel()
    label.textAlignment = .center
    label.font = .boldSystemFont(ofSize: 18)
    label.translatesAutoresizingMaskIntoConstraints = false
    return label
  }()
  
  private let logOutButton: UIButton = {
    let button = UIButton(type: .roundedRect)
    button.setTitle("Log out", for: .normal)
    button.translatesAutoresizingMaskIntoConstraints = false
    return button
  }()
  
  override func viewDidLoad() {
    super.viewDidLoad()
      
    // Sets up the layout (usernameLabel and logOutButton)
    view.backgroundColor = .systemBackground
    navigationItem.hidesBackButton = true
    navigationItem.title = "Back4App"
    view.addSubview(usernameLabel)
    view.addSubview(logOutButton)
      
    usernameLabel.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor, constant: 8).isActive = true
    usernameLabel.centerXAnchor.constraint(equalTo: view.safeAreaLayoutGuide.centerXAnchor).isActive = true
      
    logOutButton.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor, constant: 8).isActive = true
    logOutButton.centerXAnchor.constraint(equalTo: view.safeAreaLayoutGuide.centerXAnchor).isActive = true
      
    // Adds the method that will be called when the user taps the logout button
    logOutButton.addTarget(self, action: #selector(handleLogOut), for: .touchUpInside)
  }
  
  /// Called when the user taps the logout button.
  @objc private func handleLogOut() {
    // TODO: Here we will implement the logout process
  }
}
﻿
- Demande de connexion
Nous procédons maintenant à l'implémentation de la logIn(with:password) méthode dans la LogInController classe. Le ParseUser protocole donne à l'objet User la méthode statique login(username:password). Cette méthode prépare et envoie la demande de connexion à votre Back4App application. Selon le cas d'utilisation, on peut utiliser l'une des nombreuses implémentations de la login(...) méthode. Nous complétons maintenant la logIn(with:password) méthode dans LogInController:
Swift
 class HomeController: UIViewController {
  ...
3
   /// Logs in the user and presents the app's home screen (HomeController)
   /// - Parameters:
   ///   - username: User's username
   ///   - password: User's password
   private func logIn(with username: String, password: String) {
     // WARNING: Use only one of the following implementations, the synchronous or asynchronous option
10
    // Logs in the user synchronously, it throws a ParseError error if something happened. 
    // This should be executed in a background thread!
    do {
      let loggedInUser = try User.login(username: username, password: password)
15
      // After the login success we send the user to the home screen
      let homeController = HomeController()
      homeController.user = loggedInUser
19
      navigationController?.pushViewController(homeController, animated: true)
    } catch let error as ParseError {
      showMessage(title: "Error", message: "Failed to log in: \(error.message)")
    } catch {
      showMessage(title: "Error", message: "Failed to log in: \(error.localizedDescription)")
    }
  
    // Logs in the user asynchronously
    User.login(username: username, password: password) { [weak self] result in // Handle the result (of type Result<User, ParseError>)
      switch result {
      case .success(let loggedInUser):
        self?.usernameTextField.text = nil
        self?.passwordTextField.text = nil
33
        // After the login success we send the user to the home screen
        let homeController = HomeController()
        homeController.user = loggedInUser

        self?.navigationController?.pushViewController(homeController, animated: true)
      case .failure(let error):
        self?.showMessage(title: "Error", message: "Failed to log in: \(error.message)")
      }
    }
  }
}
 class HomeController: UIViewController {
  ...
3
   /// Logs in the user and presents the app's home screen (HomeController)
   /// - Parameters:
   ///   - username: User's username
   ///   - password: User's password
   private func logIn(with username: String, password: String) {
     // WARNING: Use only one of the following implementations, the synchronous or asynchronous option
10
    // Logs in the user synchronously, it throws a ParseError error if something happened. 
    // This should be executed in a background thread!
    do {
      let loggedInUser = try User.login(username: username, password: password)
15
      // After the login success we send the user to the home screen
      let homeController = HomeController()
      homeController.user = loggedInUser
19
      navigationController?.pushViewController(homeController, animated: true)
    } catch let error as ParseError {
      showMessage(title: "Error", message: "Failed to log in: \(error.message)")
    } catch {
      showMessage(title: "Error", message: "Failed to log in: \(error.localizedDescription)")
    }
  
    // Logs in the user asynchronously
    User.login(username: username, password: password) { [weak self] result in // Handle the result (of type Result<User, ParseError>)
      switch result {
      case .success(let loggedInUser):
        self?.usernameTextField.text = nil
        self?.passwordTextField.text = nil
33
        // After the login success we send the user to the home screen
        let homeController = HomeController()
        homeController.user = loggedInUser

        self?.navigationController?.pushViewController(homeController, animated: true)
      case .failure(let error):
        self?.showMessage(title: "Error", message: "Failed to log in: \(error.message)")
      }
    }
  }
}
﻿
- Demande de déconnexion
La demande de déconnexion est aussi simple que la demande de connexion. Encore une fois, le ParseUser protocole fournit le User avec la méthode statique logout(...). En appelant cette méthode, l'utilisateur actuel (accédé via User.current) se déconnecte de votre Back4App application. Nous appellerons cette méthode lorsque l'utilisateur appuie sur le bouton de déconnexion situé sur l'écran d'accueil, c'est-à-dire, dans la handleLogOut() méthode de la HomeController classe, nous ajoutons ce qui suit:
Swift
 class HomeController: UIViewController {
   ...
3
   /// Called when the user taps the logout button.
   @objc private func handleLogOut() {
     // WARNING: Use only one of the following implementations, the synchronous or asynchronous option
7
     // Logs out the user synchronously, it throws a ParseError error if something happened.
     // This should be executed in a background thread!
    do {
      try User.logout()
12
      // After the logout succeeded we dismiss the home screen
      navigationController?.popViewController(animated: true)
    } catch let error as ParseError {
      showMessage(title: "Error", message: "Failed to log out: \(error.message)")
    } catch {
      showMessage(title: "Error", message: "Failed to log out: \(error.localizedDescription)")
    }
  
    // Logs out the user asynchronously
    User.logout { [weak self] result in // Handle the result (of type Result<Void, ParseError>)
      switch result {
      case .success:
        // After the logout succeeded we dismiss the home screen
        self?.navigationController?.popViewController(animated: true)
      case .failure(let error):
        self?.showMessage(title: "Error", message: "Failed to log out: \(error.message)")
      }
    }
  }
}
 class HomeController: UIViewController {
   ...
3
   /// Called when the user taps the logout button.
   @objc private func handleLogOut() {
     // WARNING: Use only one of the following implementations, the synchronous or asynchronous option
7
     // Logs out the user synchronously, it throws a ParseError error if something happened.
     // This should be executed in a background thread!
    do {
      try User.logout()
12
      // After the logout succeeded we dismiss the home screen
      navigationController?.popViewController(animated: true)
    } catch let error as ParseError {
      showMessage(title: "Error", message: "Failed to log out: \(error.message)")
    } catch {
      showMessage(title: "Error", message: "Failed to log out: \(error.localizedDescription)")
    }
  
    // Logs out the user asynchronously
    User.logout { [weak self] result in // Handle the result (of type Result<Void, ParseError>)
      switch result {
      case .success:
        // After the logout succeeded we dismiss the home screen
        self?.navigationController?.popViewController(animated: true)
      case .failure(let error):
        self?.showMessage(title: "Error", message: "Failed to log out: \(error.message)")
      }
    }
  }
}
﻿
- Exécutez l'application !
Dans ce dépôt, vous trouverez un projet Xcode contenant les processus de connexion et de déconnexion que nous avons décrits ci-dessus. Avant d'exécuter l'application, assurez-vous d'avoir connecté le projet Xcode à votre Back4App application.
Conclusion
Le Back4App et le ParseSwift SDK nous permettent d'intégrer des fonctionnalités de connexion et de déconnexion dans les applications iOS de manière rapide. Après avoir connecté votre Back4App application à votre projet Xcode, le processus de connexion (ou de déconnexion) nécessite simplement d'appeler une seule méthode.
Mis à jour 27 Jan 2025
Cette page vous a-t-elle aidée?
Inscription utilisateur avec ParseSwift SDK sur iOS
Intégration Google Sign-In avec ParseSwift sur iOS
Connexion utilisateur iOS avec ParseSwift SDK - Tutoriel

Connexion et déconnexion de l'utilisateur

Introduction

Prérequis

Objectif

1 - Configuration des fonctionnalités de connexion et de déconnexion

2 - Configuration de l'application

3 - Demande de connexion

4 - Demande de déconnexion

5 - Exécutez l'application !

Conclusion
