دليل نقل البيانات السريع لتسجيل الدخول بحساب Google

تعرض هذه الصفحة بالتفصيل التغييرات الأساسية في الإصدارات الرئيسية من حزمة تطوير البرامج (SDK) لتسجيل الدخول بحساب Google.

يُرجى اتّباع التعليمات الواردة في هذا الدليل لنقل تطبيقك إلى أحدث إصدار من حزمة تطوير البرامج (SDK) الخاصة بتسجيل الدخول بحساب Google. لاحظ أن الوثائق تشير دائمًا إلى أحدث إصدار.

يمكنك أيضًا الرجوع إلى ملاحظات الإصدار والمستودع على GitHub للاطّلاع على مزيد من المعلومات.

الإصدار 7.0.0 من حزمة SDK لتسجيل الدخول باستخدام Google أو إصدار أحدث

لنقل تطبيقك من أحد إصدارات حزمة تطوير البرامج (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 لتفعيل وصول تطبيقك إلى واجهة برمجة التطبيقات من جهة الخادم، سيتم الآن إرجاع serverAuthCode مع إكمال GIDSignInResult.

• تم نقل المواقع من GIDAuthentication إلى GIDGoogleUser.

• استدعاء طريقة التحديث:

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:

الإصدار 6.0.0 من حزمة تطوير البرامج (SDK) لتسجيل الدخول بحساب Google

لنقل تطبيقك من أحد إصدارات حزمة تطوير البرامج (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: إلى مجموعة معاودة الاتصال في signInWithConfiguration:presentingViewController:callback:.

  • انقل المنطق من signIn:didDisconnectWithUser:withError: إلى مجموعة معاودة الاتصال في disconnectWithCallback:.

• ربط GIDSignInButton يدويًا بطريقة تستدعي signInWithConfiguration:presentingViewController:callback: باستخدام IBAction أو ما شابه ذلك.