דף זה תורגם על ידי Cloud Translation API.

מדריך להעברה מהירה לכניסה באמצעות חשבון Google

בדף הזה מפורטים השינויים העיקריים בגרסאות העיקריות של ה-SDK לכניסה באמצעות חשבון Google.

במדריך הזה מוסבר איך להעביר את האפליקציה לגרסה האחרונה של ה-SDK לכניסה באמצעות חשבון Google. שימו לב שהתיעוד מתייחס תמיד לגרסה העדכנית ביותר.

למידע נוסף, קראו גם את נתוני הגרסה ואת המאגר ב-GitHub.

SDK לכניסה באמצעות חשבון Google גרסה 7.0.0 ואילך

כדי להעביר את האפליקציה מגרסה של SDK לכניסה באמצעות חשבון Google שקודמת לגרסה 7.0.0, צריך לבצע את השינויים הבאים:

צריך לקבוע את ההגדרות האישיות של לקוח OAuth בקובץ Info.plist של האפליקציה. אפשר להמשיך להגדיר אותה בזמן ריצה (באמצעות GIDConfiguration), אבל זה לא מומלץ יותר. דוגמאות ופרטים נוספים זמינים במדריך תחילת העבודה.

מפתח אחד (`Info.plist`)	תיאור
`GIDClientID`	מזהה לקוח OAuth
`GIDServerClientID`	מזהה לקוח OAuth של השרת לצורך אימות קצה עורפי
`GIDHostedDomain`	דומיין ב-Google Workspace
`GIDOpenIDRealm`	תחום OpenID

השיטה 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 או בסגנון דומה.