Passer au contenu

Google Login sur iOS

GitHub

Dans ce guide, vous apprendrez à configurer l'authentification Google avec Capgo Social Login pour iOS. Je suppose que vous avez déjà lu le guide de configuration générale. guide de configuration général.

Dans cette partie, vous apprendrez à configurer l'authentification Google sur iOS.

  1. Créer un ID client iOS dans le console Google

    1. Cliquez sur la barre de recherche

      Barre de recherche de la console Google
    2. Recherchez credentials et cliquez sur le APIs and Services un (le numéro 2 sur l'écran d'aperçu)

      Résultats de recherche montrant l'option de credenciaux avec APIs et Services mis en surbrillance
    3. Cliquez sur le create credentials

      Bouton de création de credenciaux dans le Console Google
    4. Sélectionnez OAuth client ID

      L'option d'ID client OAuth dans le menu de création de credenciaux
    5. Sélectionnez le Application type Application iOS

      Sélection de type d'application avec l'option iOS mise en surbrillance
    6. Trouvez l'ID de la boutique

      1. Ouvrez Xcode

      2. Double-cliquez sur App

        Cible d'application dans le navigateur de projet Xcode
      3. Assurez-vous d'être sur Targets -> App

        Section Cible dans Xcode avec l'application sélectionnée
      4. Trouvez votre Bundle Identifier

        Champ Identifiant de Bundle dans les paramètres de projet Xcode
      5. Retournez à la console Google et collez votre Bundle Identifier en Bundle ID

        Champ Identifiant de Bundle dans la forme de création de client iOS de la console Google
    7. Optionnellement, ajoutez votre App Store ID ou Team ID context

    8. en le client ID si vous avez publié votre application sur l'App Store create

      Après avoir rempli tous les détails, cliquez sur le bouton Créer en bas de la forme de création de client iOS
    9. Cliquez OK

      OK sur le dialogue de confirmation de création de l'ID client
    10. Ouvrez le client iOS créé récemment

      Client iOS créé récemment dans la liste des identifiants
    11. Copiez les données suivantes

      Détails de l'ID client affichant l'ID client et l'ID client inversé à copier
  2. Modifiez le fichier Info.plist de votre application

    1. Ouvrez Xcode et trouvez le Info.plist fichier

      fichier Info.plist dans le navigateur de projet Xcode
    2. Cliquez avec le bouton droit sur ce fichier et ouvrez-l’en tant que source code

      Menu contextuel montrant l'option Ouvrir en tant que source Code
    3. En bas de votre Plist fichier, vous verrez une </dict> balise

      Balise de fin de dictionnaire dans le fichier Info.plist
    4. Insérer le fragment suivant juste avant la fermeture </dict> tag

      Info.plist avec les schémas de URL code insérés avant la fermeture de la balise dict
      <key>CFBundleURLTypes</key>
      <array>
      <dict>
      <key>CFBundleURLSchemes</key>
      <array>
      <string>YOUR_DOT_REVERSED_IOS_CLIENT_ID</string>
      </array>
      </dict>
      </array>
    5. Changer le YOUR_DOT_REVERSED_IOS_CLIENT_ID à la valeur copiée dans l'étape précédente

      Info.plist avec le client ID réel inséré dans les schémas de URL
    6. Enregistrez le fichier avec Command + S

  3. Modifier le AppDelegate.swift

    1. Ouvrez l’AppDelegate

      Le fichier AppDelegate.swift dans le navigateur de projet Xcode
    2. Insérer import GoogleSignIn À la tête du fichier

      Le fichier AppDelegate.swift avec l'import GoogleSignIn ajouté
    3. Trouvez la func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) Fonction

      La fonction d'ouverture d'application openURL dans AppDelegate
    4. Modifier la fonction pour qu'elle ressemble à ceci

      func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
      // Called when the app was launched with a url. Feel free to add additional processing here,
      // but if you want the App API to support tracking app url opens, make sure to keep this call
      var handled: Bool
      handled = GIDSignIn.sharedInstance.handle(url)
      if handled {
      return true
      }
      return ApplicationDelegateProxy.shared.application(app, open: url, options: options)
      }
      Fonction d'ouverture de l'application modifiée avec prise en charge de GoogleSignIn
    5. Enregistrez le fichier avec Command + S

  4. Configurer le login Google dans votre code JavaScript/TypeScript

    1. Importer SocialLogin et Capacitor

      import { SocialLogin } from '@capgo/capacitor-social-login';
      import { Capacitor } from '@capacitor/core';
    2. Appeler la méthode d'initialisation (ceci doit être appelé qu'une seule fois)

      Configuration de base (mode en ligne - recommandé pour la plupart des applications) :

      // onMounted is Vue specific
      onMounted(() => {
      SocialLogin.initialize({
      google: {
      iOSClientId: '673324426943-redacted.apps.googleusercontent.com',
      mode: 'online' // Default mode
      }
      })
      })

      Configuration avancée avec des identifiants de client supplémentaires :

      onMounted(() => {
      SocialLogin.initialize({
      google: {
      webClientId: 'YOUR_WEB_CLIENT_ID', // Optional: for web platform support
      iOSClientId: 'YOUR_IOS_CLIENT_ID', // Required: from step 1
      iOSServerClientId: 'YOUR_WEB_CLIENT_ID', // Optional: same as webClientId, needed for some advanced features
      mode: 'online' // 'online' or 'offline'
      }
      })
      })
    3. Implémentez la fonction de connexion. Créez un bouton et exécutez le code suivant code lors du clic

      Pour le mode en ligne :

      const res = await SocialLogin.login({
      provider: 'google',
      options: {}
      })
      // handle the response - contains user data
      console.log(JSON.stringify(res))

      Pour le mode hors ligne :

      const res = await SocialLogin.login({
      provider: 'google',
      options: {
      forceRefreshToken: true // Recommended for offline mode
      }
      })
      // res contains serverAuthCode, not user data
      // Send serverAuthCode to your backend to get user information
      // Do not call SocialLogin.refresh() in offline mode
      console.log('Server auth code:', res.result.serverAuthCode)
  5. Testez votre application

    1. Construisez votre application et exécutez-la cap sync

    2. Si vous avez fait tout correctement, vous devriez voir le flux de connexion Google fonctionner correctement

      Démonstration du flux de connexion Google sur iOS montrant le processus de connexion et l'authentification réussie

Problèmes connus

Problèmes connus

Incompatibilité de l'écran de confidentialité du plugin

Incompatibilité de l'écran de confidentialité avec le plugin

Le plugin de connexion Google est incompatible avec @capacitor/écran de vie privéeLorsque vous utilisez les deux plugins ensemble, la vue de connexion Google sera interrompue par l'écran de confidentialité.

Travail de contournement : Appeler await PrivacyScreen.disable(); avant d'appeler la fonction de connexion :

import { PrivacyScreen } from '@capacitor/privacy-screen';
import { SocialLogin } from '@capgo/capacitor-social-login';
await PrivacyScreen.disable();
await SocialLogin.login({
provider: 'google',
options: {}
});

Si vous utilisez Google Login sur iOS pour planifier l'authentification et les flux de compte, connectez-l’à En utilisant @capgo/capacitor-social-login pour la capacité native dans En utilisant @capgo/capacitor-social-login @capgo/capacitor-social-login pour le détail d'implémentation dans @capgo/capacitor-social-login @capgo/capacitor-passkey pour le détail d'implémentation dans @capgo/capacitor-passkey @capgo/capacitor-native-biometric pour le détail d'implémentation dans @capgo/capacitor-native-biometric, et Authentification à deux facteurs pour les détails d'implémentation de l'authentification à deux facteurs.