Wichtig: Ab dem
1. Mai 2024 benötigt Apple Privacy Manifeste und Signaturen für iOS-Apps, die gängige SDKs verwenden, einschließlich GoogleSignIn-iOS. Führe vor dem 1. Mai 2024 ein Upgrade auf GoogleSignIn-iOS 7.1.0 oder höher durch. Folgen Sie
unserem Upgrade-Leitfaden.
Kurzanleitung zur Migration von Google Log-in
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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.
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.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-31 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-31 (UTC)."],[[["\u003cp\u003eThis page provides migration guides for updating your app to the latest Google Sign-In SDK versions (v7.0.0+ and v6.0.0).\u003c/p\u003e\n"],["\u003cp\u003eFor v7.0.0+, OAuth client configuration should be set in \u003ccode\u003eInfo.plist\u003c/code\u003e, additional scopes are requested from \u003ccode\u003eGIDGoogleUser\u003c/code\u003e, and various properties and methods have been moved or updated.\u003c/p\u003e\n"],["\u003cp\u003eMigrating to v6.0.0 involves using \u003ccode\u003eGIDConfiguration\u003c/code\u003e for client configuration, updating method calls, and replacing \u003ccode\u003eGIDSignInDelegate\u003c/code\u003e with callback blocks.\u003c/p\u003e\n"],["\u003cp\u003eDetailed information and examples are available in linked resources like release notes, GitHub repository, and the "Get Started" guide.\u003c/p\u003e\n"]]],[],null,["# Google Sign-In quick migration guide\n\nThis page details key changes for major versions of the Google Sign-In SDK.\n\nFollow this guide to migrate your app to the latest version of the Google\nSign-In SDK. Note that the documentation always refers to the most recent\nversion.\n\nAlso refer to the [release notes](/identity/sign-in/ios/release) and the\n[repository on GitHub](https://github.com/google/GoogleSignIn-iOS)\nfor more information.\n\nGoogle Sign-In SDK v7.0.0+\n--------------------------\n\nTo migrate your app from a version of the Google Sign-In SDK prior to v7.0.0,\nmake the following changes:\n\n- Set your OAuth client configuration in your application's `Info.plist` file.\n You can continue to set it at runtime (using a `GIDConfiguration`) object,\n but this is no longer recommended. See the [get\n started](/identity/sign-in/ios/start-integrating#configure_app_project) guide for\n examples and more details.\n\n | `Info.plist` key | Description |\n |---------------------|-------------------------------------------------------------------------------------------------------------------|\n | `GIDClientID` | [OAuth client ID](/identity/sign-in/ios/start-integrating#add_client_id) |\n | `GIDServerClientID` | [Server OAuth client ID for backend authentication](/identity/sign-in/ios/start-integrating#add_server_client_id) |\n | `GIDHostedDomain` | [Google Workspace domain](/identity/sign-in/ios/start-integrating#add_domain_realm) |\n | `GIDOpenIDRealm` | [OpenID realm](/identity/sign-in/ios/start-integrating#add_domain_realm) |\n\n- The `addScopes:` method has been moved to GIDGoogleUser. Instead of\n requesting additional authorization scopes from GIDSignIn, you should now\n [request them from GIDGoogleUser after authentication](/identity/sign-in/ios/api-access#2_request_additional_scopes)\n has completed.\n\n- If you are setting `serverClientID` to [enable server-side API access for\n your app](/identity/sign-in/ios/offline-access), `serverAuthCode` will now be\n returned with `GIDSignInResult` in your completion.\n\n- Properties from `GIDAuthentication` have moved into `GIDGoogleUser`.\n\n- Update method calls:\n\n| v6.2.x | v7.0.0+ |\n|--------------------------------------------------------------------------|------------------------------------------------------------------|\n| `GIDSignIn` `signInWithConfiguration:presentingViewController:callback:` | `GIDSignIn` `signInWithPresentingViewController:completion:` |\n| `GIDSignIn` `restorePreviousSignInWithCallback:` | `GIDSignIn` `restorePreviousSignInWithCompletion:` |\n| `GIDSignIn` `disconnectWithCallback:` | `GIDSignIn` `disconnectWithCompletion:` |\n| `GIDAuthentication` `doWithFreshTokens:` | `GIDGoogleUser` `refreshTokensIfNeededWithCompletion:` |\n| `GIDSignIn` `addScopes:presentingViewController:callback:` | `GIDGoogleUser` `addScopes:presentingViewController:completion:` |\n\nGoogle Sign-In SDK v6.0.0\n-------------------------\n\nTo migrate your app from a version of the Google Sign-In SDK prior to v6.0.0,\nmake the following changes:\n\n- Update all `[GIDSignIn sharedInstance]` calls to `GIDSignIn.sharedInstance`\n property accesses.\n\n- Move all client configuration (client IDs, etc.) to a `GIDConfiguration`\n object.\n\n- Update calls to removed methods to their new equivalents:\n\n | v5.x.x | v6.0.0 |\n |-----------------------------|--------------------------------------------------------------|\n | `signIn` | `signInWithConfiguration:presentingViewController:callback:` |\n | `restorePreviousSignIn` | `restorePreviousSignInWithCallback:` |\n | `disconnect` | `disconnectWithCallback:` |\n | `getTokensWithHandler:` | `doWithFreshTokens:` |\n | `refreshTokensWithHandler:` | `doWithFreshTokens:` |\n\n- Remove all references to the `GIDSignInDelegate` protocol and its methods.\n\n - Move the logic from `signIn:didSignInForUser:withError:` to the callback\n block of `signInWithConfiguration:presentingViewController:callback:`.\n\n - Move the logic from `signIn:didDisconnectWithUser:withError:` to the\n callback block of `disconnectWithCallback:`.\n\n- Manually connect `GIDSignInButton` to a method that calls\n `signInWithConfiguration:presentingViewController:callback:` using an\n `IBAction` or similar."]]
