Kurzanleitung zur Migration von Google Log-in

Auf dieser Seite werden die wichtigsten Änderungen für die Hauptversionen des Google Log-in SDK beschrieben.

Folge dieser Anleitung, um deine App zur neuesten Version des Google Sign-In SDK zu migrieren. Beachten Sie, dass sich die Dokumentation immer auf die neueste Version bezieht.

Weitere Informationen finden Sie auch in den Versionshinweisen und im Repository auf GitHub.

Google Log-In SDK 7.0.0 oder höher

Wenn du deine App von einer früheren Version des Google Log-In SDK vor Version 7.0.0 migrieren möchtest, nimm die folgenden Änderungen vor:

• Legen Sie die OAuth-Clientkonfiguration in der Datei Info.plist Ihrer Anwendung fest. Sie können es zur Laufzeit weiterhin mit einem GIDConfiguration-Objekt festlegen. Dies wird jedoch nicht mehr empfohlen. Beispiele und weitere Informationen finden Sie im Startleitfaden.

  Info.plist Schlüssel	Beschreibung
  GIDClientID	OAuth-Client-ID
  GIDServerClientID	Server-OAuth-Client-ID für die Back-End-Authentifizierung
  GIDHostedDomain	Google Workspace-Domain
  GIDOpenIDRealm	OpenID-Bereich

• Die Methode addScopes: wurde zu GIDGoogleUser verschoben. Anstatt zusätzliche Autorisierungsbereiche von GIDSignIn anzufordern, sollten Sie sie jetzt nach Abschluss der Authentifizierung von GIDGoogleUser anfordern.

• Wenn Sie serverClientID festlegen, um den serverseitigen API-Zugriff für Ihre Anwendung zu aktivieren, wird serverAuthCode jetzt mit GIDSignInResult zurückgegeben.

• Unterkünfte aus GIDAuthentication sind in GIDGoogleUser umgezogen.

• Aktualisierungsmethodenaufrufe:

v6.2.x	v7.0.0 oder höher
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:

Google Log-In SDK 6.0.0

Wenn du deine App von einer früheren Version des Google Log-in SDK vor Version 6.0.0 migrieren möchtest, nimm die folgenden Änderungen vor:

• Alle [GIDSignIn sharedInstance]-Aufrufe für GIDSignIn.sharedInstance-Property-Zugriffe aktualisieren.

• Verschieben Sie alle Clientkonfigurationen (Client-IDs usw.) in ein GIDConfiguration-Objekt.

• Aktualisieren Sie Aufrufe entfernter Methoden auf die neuen Entsprechungen:

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

• Entfernen Sie alle Verweise auf das GIDSignInDelegate-Protokoll und seine Methoden.

  • Verschieben Sie die Logik von signIn:didSignInForUser:withError: in den Callback-Block von signInWithConfiguration:presentingViewController:callback:.

  • Verschieben Sie die Logik von signIn:didDisconnectWithUser:withError: in den Callback-Block von disconnectWithCallback:.

• Verbinden Sie GIDSignInButton manuell mit einer Methode, die signInWithConfiguration:presentingViewController:callback: mithilfe eines IBAction oder einer ähnlichen Methode aufruft.