بدء استخدام ميزة "تسجيل الدخول بحساب 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، أضِف أيضًا إضافة pod لزر "تسجيل الدخول باستخدام حساب Google":

   pod 'GoogleSignInSwiftSupport'

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

   pod install

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

   يمكنك الرجوع إلى ملف Podfile لنموذج تطبيق Objective-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 في وحدة تحكّم Cloud. على سبيل المثال: 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 الخاص بتطبيقك.

ملاحظة: هذا هو معرّف عميل OAuth لمشروعك في الخلفية، وليس رقم تعريف تطبيق iOS أو macOS. عليك الحصول على معرّف عميل خادم OAuth وحدده هنا.

<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.