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. La procédure à suivre sur cette page font exactement cela. Les étapes suivantes décrivent ensuite comment intégrer les fonctionnalités Google Sign-In dans votre application.

Avant de commencer

Installez une version actuelle de Xcode.

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

CocoaPods

  1. Si CocoaPods n'est pas encore installé, suivez les étapes décrites dans le Premiers pas CocoaPods .

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

  3. Si vous n'avez pas encore créé de Podfile pour votre application, créez-en un dès 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 la console avec Google" bouton: 

    pod 'GoogleSignInSwiftSupport'

  6. Enregistrez le fichier et exécutez : 

    pod install

  7. Ouvrez le fichier workspace .xcworkspace généré pour votre application dans Xcode. Utilisez ce fichier pour tout développement futur sur votre application. Notez que qu'il est différent du fichier de projet .xcodeproj inclus, qui entraînerait des erreurs de compilation lors de son ouverture.)

    Reportez-vous à l'exemple d'application Objective-C Fichier Pod à titre d'exemple.

Gestionnaire de paquets Swift

  1. Ouvrez votre projet dans Xcode.

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

    Dépôt https://github.com/google/GoogleSignIn-iOS
    Version 7.0.0
    Package produit GoogleSignIn

  3. Si vous utilisez SwiftUI, ajoutez également le produit de package d'extension suivant. pour l'option "Se connecter avec Google" bouton:

    Package produit GoogleSignInSwift

Obtenir un ID client OAuth

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

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

Créer un ID client OAuth

Une fois l'ID client OAuth créé, notez la chaîne correspondant. vous devez configurer Google Sign-In dans votre application. Vous pouvez aussi téléchargez le fichier de configuration, qui contient votre ID client et d'autres de configuration, pour référence ultérieure.

Si vous avez déjà créé un ID client OAuth, vous trouverez votre ID client OAuth existant en cliquant sur le bouton ci-dessous.

<ph type="x-smartling-placeholder"></ph> 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 d'une manière ou d'une autre. Pour transmettre de manière sécurisée l'identité des utilisateurs qui se sont connectés avec Google à votre backend, vous utilisez des jetons d'identification, comme indiqué dans la section S'authentifier auprès d'un serveur backend. La récupération d'un jeton d'ID utilisateur nécessite un deuxième ID client (votre serveur). qui représente votre backend.

Pour créer un ID client de serveur:

  1. Ouvrez votre projet dans le Console Cloud

  2. Créez un ID client OAuth de type application Web. Prenez note du d'ID client, dont vous aurez besoin pour configurer Google Sign-In dans votre l'application.

Configurer votre projet d'application

Pour utiliser Google Sign-In, vous devez configurer votre projet avec votre ID client OAuth et un schéma d'URL personnalisé. Vous pouvez également ajouter votre ID client de serveur pour authentification du backend ou optimiser votre application pour vos Workspace.

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

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

L'ID client inversé correspond à votre ID client, dans l'ordre des caractères délimités par un point sont inversés. Cette information figure également sous Schéma d'URL iOS. lorsque vous sélectionnez client OAuth iOS existant dans le cloud console. Par 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 du backend

Si vous avez besoin d'obtenir des jetons d'identification 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 processus 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>

Signer votre application

Votre application doit être signée à l'aide d'un certificat émis par Apple pour pouvoir s'exécuter nativement sur les appareils macOS et iOS afin de stocker les identifiants via porte-clés.

Étapes suivantes

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