بدء استخدام ميزة "تسجيل الدخول بحساب Google" على نظامَي التشغيل iOS وmacOS

قبل البدء في دمج تطبيق iOS أو macOS مع مكوّنات تسجيل الدخول بحساب Google، عليك تنزيل التبعيات وإعداد مشروع Xcode. الخطوات في هذه الصفحة تفعل ذلك بالضبط. بعد ذلك، يمكنك توضيح كيفية دمج ميزات تسجيل الدخول بحساب Google في تطبيقك.

قبل البدء

ثبِّت إصدارًا حاليًا من Xcode.

تثبيت تبعيات "تسجيل الدخول بحساب Google" في مشروعك

CocoaPods

  1. إذا لم يكن تطبيق CocoaPods مثبّتًا على جهازك، اتّبِع الخطوات الواردة في دليل دليل البدء في CocoaPods.

  2. افتح نافذة طرفية وانتقل إلى موقع مشروع Xcode للتطبيق.

  3. إذا لم تكن قد أنشأت ملف Podfile من قبل لتطبيقك، فأنشئ واحدًا الآن:

    pod init

  4. افتح Podfile الذي تم إنشاؤه لتطبيقك وأضِف ما يلي:

    pod 'GoogleSignIn'

  5. إذا كنت تستخدم SwiftUI، ثبِّت أيضًا إضافة لوحة الإعلانات المتسلسلة لزر "تسجيل الدخول باستخدام Google":

    pod 'GoogleSignInSwiftSupport'

  6. احفظ الملف وشغِّل:

    pod install

  7. افتح ملف workspace .xcworkspace الذي تم إنشاؤه لتطبيقك في Xcode. استخدم هذا الملف لكل عمليات التطوير المستقبلية في تطبيقك. (ملاحظة: يختلف هذا الملف عن ملف مشروع .xcodeproj المضمّن، والذي قد يؤدي إلى حدوث أخطاء في الإصدار عند فتحه.)

    يمكنك الرجوع إلى نموذج ملف Podfile التابع لـ FALSE-C للحصول على مثال.

مدير حزم Swift

  1. افتح مشروعك في Xcode.

  2. أضف تبعيات تسجيل الدخول بحساب Google إلى تطبيقك (وثائق Xcode):

    المستودع https://github.com/google/GoogleSignIn-iOS
    الإصدار 7.0.0
    منتج الحزمة GoogleSignIn
  3. إذا كنت تستخدم SwiftUI، أضِف أيضًا منتج حزمة الإضافات التالي للزر "تسجيل الدخول باستخدام حساب Google":

    منتج الحزمة GoogleSignInSwift

الحصول على معرِّف عميل بروتوكول OAuth

يحتاج تطبيقك إلى معرِّف عميل OAuth حتى يعرِّف نفسه لواجهة مصادقة Google. بالنسبة إلى تطبيقات iOS وmacOS، يجب ضبط نوع تطبيق معرِّف عميل OAuth على أنّه iOS.

إذا لم تكن قد أنشأت معرِّف عميل OAuth من قبل، انقر على الزر أدناه لإجراء ذلك.

إنشاء معرِّف عميل OAuth

بعد إنشاء معرِّف عميل OAuth، دوِّن سلسلة معرِّف العميل التي ستحتاج إلى إعداد "تسجيل الدخول بحساب Google" في تطبيقك. يمكنك اختياريًا تنزيل ملف الإعداد، الذي يحتوي على معرِّف العميل وبيانات الضبط الأخرى، للرجوع إليها في المستقبل.

إذا سبق لك إنشاء معرِّف عميل OAuth، يمكنك الاطّلاع على معلومات OAuth الحالية عن طريق النقر على الزر أدناه.

الحصول على معرِّف عميل OAuth حالي

الحصول على معرِّف عميل خادم OAuth

ستحتاج معظم التطبيقات إلى تمرير هوية المستخدمين الذين سجّلوا الدخول إلى إحدى خدمات الخلفية من نوع ما. لتمرير هوية المستخدمين الذين سجلوا الدخول باستخدام حساب Google إلى الخلفية بشكل آمن، يمكنك استخدام الرموز المميّزة لرقم التعريف على النحو الموضّح في قسم المصادقة باستخدام خادم خلفية. يتطلب استرداد الرمز المميز لمعرّف المستخدم معرّف عميل ثانٍ، وهو معرّف عميل الخادم، الذي يمثّل الخادم الخلفي.

لإنشاء معرِّف عميل للخادم:

  1. افتح مشروعك في Cloud Console.

  2. أنشئ معرِّف عميل OAuth جديدًا من نوع تطبيق ويب. دوِّن سلسلة معرّف العميل، التي ستحتاج إليها لإعداد تسجيل الدخول بحساب Google في تطبيقك.

ضبط مشروع التطبيق

تتطلب ميزة "تسجيل الدخول بحساب Google" إعداد مشروعك باستخدام معرِّف عميل OAuth ومخطط عنوان URL مخصّص. يمكنك اختياريًا إضافة معرِّف العميل للخادم للمصادقة الخلفية أو تحسين تطبيقك لنطاقك في Google Workspace.

إضافة معرِّف عميل OAuth ونظام عنوان URL المخصَّص

عدِّل ملف Info.plist لتطبيقك لإضافة معرِّف عميل OAuth ومخطط عنوان URL مخصَّص استنادًا إلى معرِّف العميل المعكوس.

معرِّف العميل المعكوس هو معرِّف العميل الخاص بك بترتيب الحقول المحددة بنقاط معكوسة. يظهر هذا أيضًا ضمن مخطط عنوان URL لنظام التشغيل iOS عند اختيار عميل OAuth حالي على iOS في وحدة تحكُّم السحابة الإلكترونية. مثلاً: com.googleusercontent.apps.1234567890-abcdefg

<key>GIDClientID</key>
<string>YOUR_IOS_CLIENT_ID</string>
<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>YOUR_DOT_REVERSED_IOS_CLIENT_ID</string>
    </array>
  </dict>
</array>

اختياري: ضبط مصادقة الخلفية

إذا أردت الحصول على الرموز المميّزة للمعرّفات الخاصة بالمستخدمين من أجل مصادقة الواجهة الخلفية، عليك أيضًا ضبط المفتاح GIDServerClientID في ملف Info.plist الخاص بتطبيقك.

<key>GIDServerClientID</key>
<string>YOUR_SERVER_CLIENT_ID</string>

اختياري: التحسين لنطاق Google Workspace أو نطاق OpenID

يمكنك استخدام المَعلمة GIDHostedDomain إذا كنت تريد تحسين عملية تسجيل الدخول لنطاق على Google Workspace.

<key>GIDHostedDomain</key>
<string>YOUR_HOSTED_DOMAIN</string>

يمكنك استخدام المَعلمة GIDOpenIDRealm إذا كنت تريد تحديد نطاق OpenID.

<key>GIDOpenIDRealm</key>
<string>YOUR_OPENID_REALM</string>

توقيع طلبك

يجب توقيع تطبيقك باستخدام شهادة صادرة عن Apple لتشغيله محليًا على أجهزة macOS وiOS من أجل تخزين بيانات الاعتماد عبر سلسلة المفاتيح.

الخطوات التالية

الآن وبعد أن قمت بتنزيل تبعيات المشروع وإعداد مشروع Xcode الخاص بك، يمكنك إضافة تسجيل الدخول باستخدام حساب Google إلى تطبيق iOS الخاص بك.