Premiers pas avec Google Sign-In pour iOS et macOS

Avant de commencer à intégrer votre application iOS ou macOS aux composants Google Sign-In, vous devez télécharger les dépendances et configurer votre projet Xcode. C'est exactement ce que les étapes de cette page font. Les étapes suivantes décrivent ensuite comment intégrer les fonctionnalités Google Sign-In à votre application.

Avant de commencer

Installez une version actuelle de Xcode.

Installer les dépendances Google Sign-In dans votre projet

CocoaPods

  1. Si vous n'avez pas encore installé CocoaPods, suivez les étapes décrites dans le guide de démarrage de CocoaPods.

  2. Ouvrez une fenêtre de terminal et accédez à l'emplacement du projet Xcode de votre application.

  3. Si vous n'avez pas encore créé de Podfile pour votre application, créez-en un maintenant:

    pod init

  4. Ouvrez le Podfile créé pour votre application et ajoutez les éléments suivants :

    pod 'GoogleSignIn'

  5. Si vous utilisez SwiftUI, ajoutez également l'extension de pod pour le bouton "Sign in with Google" (Se connecter avec Google) :

    pod 'GoogleSignInSwiftSupport'

  6. Enregistrez le fichier et exécutez la commande suivante :

    pod install

  7. Ouvrez le fichier workspace .xcworkspace généré pour votre application dans Xcode. Utilisez ce fichier pour tous les développements futurs de votre application. Notez que ce fichier est différent du fichier de projet .xcodeproj inclus, qui entraîne des erreurs de compilation lorsqu'il est ouvert.

    Reportez-vous au Podfile de l'application exemple Objectif-C pour obtenir un exemple.

Gestionnaire de packages Swift

  1. Ouvrez votre projet dans Xcode.

  2. Ajoutez les dépendances Google Sign-In à votre application (documentation Xcode):

    Dépôt https://github.com/google/GoogleSignIn-iOS
    Version 7.0.0
    Produit du package GoogleSignIn
  3. Si vous utilisez SwiftUI, ajoutez également le produit de package d'extension suivant pour le bouton "Se connecter avec Google" :

    Produit du package GoogleSignInSwift

Obtenir un ID client OAuth

Votre application a besoin d'un ID client OAuth pour s'identifier auprès du backend d'authentification de Google. Pour les applications iOS et macOS, le type d'application d'ID client OAuth doit être configuré sur iOS.

Si vous n'avez pas encore créé d'ID client OAuth, cliquez sur le bouton ci-dessous pour le faire.

Créer un ID client OAuth

Après avoir créé l'ID client OAuth, notez la chaîne d'ID client, dont vous aurez besoin pour configurer Google Sign-In dans votre application. Vous pouvez éventuellement télécharger le fichier de configuration, qui contient votre ID client et d'autres données de configuration, pour référence ultérieure.

Si vous avez déjà créé un ID client OAuth, vous pouvez trouver les informations OAuth existantes en cliquant sur le bouton ci-dessous.

Obtenir un ID client OAuth existant

Obtenir un ID client de serveur OAuth

La plupart des applications doivent transmettre l'identité des utilisateurs connectés à un service de backend. Pour transmettre de manière sécurisée l'identité des utilisateurs qui se sont connectés avec Google à votre backend, vous devez utiliser des jetons d'identification, comme indiqué dans la section S'authentifier avec un serveur backend. La récupération du jeton d'ID d'un utilisateur nécessite un deuxième ID client (votre ID client de serveur) qui représente votre backend.

Pour créer un ID client de serveur:

  1. Ouvrez votre projet dans la console Cloud.

  2. Créez un ID client OAuth de type Application Web. Notez la chaîne d'ID client, dont vous aurez besoin pour configurer Google Sign-In dans votre application.

Configurer votre projet d'application

Pour utiliser Google Sign-In, votre projet doit être configuré avec votre ID client OAuth et un schéma d'URL personnalisé. Vous pouvez également ajouter votre ID client de serveur pour l'authentification du backend ou optimiser votre application pour votre domaine Google Workspace.

Ajoutez votre ID client OAuth et votre schéma d'URL personnalisé

Mettez à jour le fichier Info.plist de votre application pour ajouter votre ID client OAuth et un schéma d'URL personnalisé basé sur l'ID client inversé.

L'ID client inversé correspond à votre ID client avec l'ordre des champs délimités par des points inversé. Cette information s'affiche également sous Schéma d'URL iOS lorsque vous sélectionnez un client OAuth iOS existant dans la console Cloud. Exemple : com.googleusercontent.apps.1234567890-abcdefg

<key>GIDClientID</key>
<string>YOUR_IOS_CLIENT_ID</string>
<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>YOUR_DOT_REVERSED_IOS_CLIENT_ID</string>
    </array>
  </dict>
</array>

Facultatif: Configurer l'authentification backend

Si vous devez obtenir des jetons d'ID utilisateur pour l'authentification du backend, définissez également la clé GIDServerClientID dans le fichier Info.plist de votre application.

<key>GIDServerClientID</key>
<string>YOUR_SERVER_CLIENT_ID</string>

Facultatif: optimiser pour un domaine Google Workspace ou OpenID

Utilisez le paramètre GIDHostedDomain si vous souhaitez optimiser le flux de connexion pour un domaine Google Workspace.

<key>GIDHostedDomain</key>
<string>YOUR_HOSTED_DOMAIN</string>

Utilisez le paramètre GIDOpenIDRealm si vous souhaitez spécifier un domaine OpenID.

<key>GIDOpenIDRealm</key>
<string>YOUR_OPENID_REALM</string>

Signature de votre application

Votre application doit être signée avec un certificat émis par Apple pour s'exécuter en natif sur des appareils macOS et iOS afin de stocker des identifiants via le trousseau.

Étapes suivantes

Maintenant que vous avez téléchargé les dépendances du projet et configuré votre projet Xcode, vous pouvez ajouter Google Sign-In à votre application iOS.