راهنمای مهاجرت سریع Google Sign-In

این صفحه تغییرات کلیدی را برای نسخه‌های اصلی Google Sign-In SDK توضیح می‌دهد.

این راهنما را دنبال کنید تا برنامه خود را به آخرین نسخه Google Sign-In SDK منتقل کنید. توجه داشته باشید که اسناد همیشه به آخرین نسخه اشاره دارد.

همچنین برای اطلاعات بیشتر به یادداشت های انتشار و مخزن GitHub مراجعه کنید.

Google Sign-In SDK نسخه 7.0.0+

برای انتقال برنامه خود از نسخه Google Sign-In SDK قبل از نسخه 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 منتقل شده‌اند.

• به روز رسانی فراخوانی روش:

نسخه 6.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:

Google Sign-In SDK نسخه 6.0.0

برای انتقال برنامه خود از نسخه Google Sign-In SDK قبل از نسخه 6.0.0، تغییرات زیر را اعمال کنید:

• همه تماس‌های [GIDSignIn sharedInstance] را به دسترسی‌های ویژگی GIDSignIn.sharedInstance به‌روزرسانی کنید.

• تمام پیکربندی مشتری (شناسه های مشتری و غیره) را به یک شی GIDConfiguration منتقل کنید.

• تماس‌های روش‌های حذف‌شده را به معادل‌های جدید خود به‌روزرسانی کنید:

  v5.xx	نسخه 6.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 یا مشابه فراخوانی می کند.