חשוב: החל מ-
1 במאי 2024,
נדרשות חתימות ומניפסטי פרטיות לאפליקציות ל-iOS שמשתמשות בערכות SDK נפוצות, כולל GoogleSignIn-iOS. צריך לשדרג ל-GoogleSignIn-iOS גרסה 7.1.0 ואילך לפני 1 במאי 2024. פועלים לפי ההוראות ב
מדריך השדרוג.
מדריך להעברה מהירה לכניסה באמצעות חשבון Google
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בדף הזה מפורטים השינויים העיקריים בגרסאות העיקריות של ה-SDK לכניסה באמצעות חשבון Google.
במדריך הזה מוסבר איך להעביר את האפליקציה לגרסה האחרונה של ה-SDK לכניסה באמצעות חשבון Google. שימו לב שהתיעוד מתייחס תמיד לגרסה העדכנית ביותר.
למידע נוסף, קראו גם את נתוני הגרסה ואת המאגר ב-GitHub.
SDK לכניסה באמצעות חשבון Google גרסה 7.0.0 ואילך
כדי להעביר את האפליקציה מגרסה של SDK לכניסה באמצעות חשבון Google שקודמת לגרסה 7.0.0, צריך לבצע את השינויים הבאים:
צריך לקבוע את ההגדרות האישיות של לקוח OAuth בקובץ Info.plist של האפליקציה.
אפשר להמשיך להגדיר אותה בזמן ריצה (באמצעות GIDConfiguration), אבל זה לא מומלץ יותר. דוגמאות ופרטים נוספים זמינים במדריך תחילת העבודה.
השיטה addScopes: הועברה אל GIDGoogleUser. במקום לבקש היקפי הרשאות נוספים מ-GIDSignIn, עליכם לבקש אותם מ-GIDGoogleUser אחרי שהאימות יסתיים.
אם מגדירים את serverClientID להפעלת גישה ל-API בצד השרת של האפליקציה, serverAuthCode יוחזר עכשיו עם GIDSignInResult בהשלמה.
נכסים מ-GIDAuthentication עברו אל GIDGoogleUser.
עדכון קריאות ל-method:
| v6.2.x |
גרסה 7.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 גרסה 6.0.0
כדי להעביר את האפליקציה מגרסה של SDK לכניסה באמצעות חשבון Google שקודמת לגרסה 6.0.0, צריך לבצע את השינויים הבאים:
מעדכנים את כל הקריאות של [GIDSignIn sharedInstance] לגישה של נכס GIDSignIn.sharedInstance.
מעבירים את כל הגדרות הלקוח (מזהי לקוח וכו') לאובייקט GIDConfiguration.
עדכון קריאות לשיטות שהוסרו לפונקציות המקבילות החדשות:
| v5.x.x |
v6.0.0 |
signIn |
signInWithConfiguration:presentingViewController:callback: |
restorePreviousSignIn |
restorePreviousSignInWithCallback: |
disconnect |
disconnectWithCallback: |
getTokensWithHandler: |
doWithFreshTokens: |
refreshTokensWithHandler: |
doWithFreshTokens: |
מסירים את כל ההפניות לפרוטוקול GIDSignInDelegate ולשיטות שלו.
מעבירים את הלוגיקה מ-signIn:didSignInForUser:withError: לבלוק של הקריאה החוזרת (callback) של signInWithConfiguration:presentingViewController:callback:.
מעבירים את הלוגיקה מ-signIn:didDisconnectWithUser:withError: לבלוק של הקריאה החוזרת (callback) של disconnectWithCallback:.
יש לחבר באופן ידני את GIDSignInButton לשיטה שקוראת ל-signInWithConfiguration:presentingViewController:callback: באמצעות IBAction או בסגנון דומה.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-31 (שעון UTC).
[null,null,["עדכון אחרון: 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."]]
