Guide de migration rapide vers Google Sign-In

Cette page présente les principales modifications apportées aux versions majeures du SDK Google Sign-In.

Suivez ce guide pour migrer votre application vers la dernière version du SDK Google Sign-In. Notez que la documentation fait toujours référence à la version la plus récente.

Reportez-vous également aux notes de version et au dépôt sur GitHub pour plus d'informations.

SDK Google Sign-In 7.0.0+

Pour migrer votre application à partir d'une version du SDK Google Sign-In antérieure à la version 7.0.0, apportez les modifications suivantes:

• Définissez la configuration de votre client OAuth dans le fichier Info.plist de votre application. Vous pouvez continuer à le définir au moment de l'exécution (à l'aide d'un objet GIDConfiguration), mais cela n'est plus recommandé. Consultez le guide de démarrage pour obtenir des exemples et plus de détails.

  Info.plist clé	Description
  GIDClientID	ID client OAuth
  GIDServerClientID	ID client OAuth du serveur pour l'authentification du backend
  GIDHostedDomain	Domaine Google Workspace
  GIDOpenIDRealm	Domaine OpenID

• La méthode addScopes: a été déplacée vers GIDGoogleUser. Au lieu de demander des champs d'application d'autorisation supplémentaires à GIDSignIn, vous devez désormais les demander à GIDGoogleUser une fois l'authentification terminée.

• Si vous définissez serverClientID pour activer l'accès aux API côté serveur pour votre application, serverAuthCode sera désormais renvoyé avec GIDSignInResult dans la fin de l'opération.

• Les propriétés de GIDAuthentication ont été déplacées vers GIDGoogleUser.

• Appels de méthode de mise à jour:

v6.2.x	v7.0.0+
GIDSignIn signInWithConfiguration:presentingViewController:callback:	GIDSignIn signInWithPresentingViewController:completion:
GIDSignIn restorePreviousSignInWithCallback:	GIDSignIn restorePreviousSignInWithCompletion:
GIDSignIn disconnectWithCallback:	GIDSignIn disconnectWithCompletion:
GIDAuthentication doWithFreshTokens:	GIDGoogleUser refreshTokensIfNeededWithCompletion:
GIDSignIn addScopes:presentingViewController:callback:	GIDGoogleUser addScopes:presentingViewController:completion:

SDK Google Sign-In v6.0.0

Pour migrer votre application à partir d'une version du SDK Google Sign-In antérieure à la version 6.0.0, apportez les modifications suivantes:

• Mettez à jour tous les appels [GIDSignIn sharedInstance] vers les accès à la propriété GIDSignIn.sharedInstance.

• Déplacez toute la configuration client (ID client, etc.) vers un objet GIDConfiguration.

• Remplacez les appels des méthodes supprimées par leurs nouveaux équivalents:

  v5.x.x	v6.0.0
  signIn	signInWithConfiguration:presentingViewController:callback:
  restorePreviousSignIn	restorePreviousSignInWithCallback:
  disconnect	disconnectWithCallback:
  getTokensWithHandler:	doWithFreshTokens:
  refreshTokensWithHandler:	doWithFreshTokens:

• Supprimez toutes les références au protocole GIDSignInDelegate et à ses méthodes.

  • Déplacez la logique de signIn:didSignInForUser:withError: vers le bloc de rappel de signInWithConfiguration:presentingViewController:callback:.

  • Déplacez la logique de signIn:didDisconnectWithUser:withError: vers le bloc de rappel de disconnectWithCallback:.

• Connectez manuellement GIDSignInButton à une méthode qui appelle signInWithConfiguration:presentingViewController:callback: à l'aide d'un IBAction ou d'un objet similaire.