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

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

قبل البدء

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

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

كوكاو بود

1. إذا لم يسبق لك تثبيت CocoaPods، اتّبِع الخطوات الواردة في دليل بدء استخدام CocoaPods.

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

3. إذا لم يسبق لك إنشاء ملف Podfile لتطبيقك، يمكنك إنشاء ملف الآن:

   pod init

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

   pod 'GoogleSignIn'

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

   pod 'GoogleSignInSwiftSupport'

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

   pod install

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

   يمكنك الرجوع إلى نموذج Podfile لتطبيق نموذج الهدف للحصول على مثال.

مدير الحزم Swift

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

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

   المستودع	https://github.com/google/GoogleSignIn-iOS
   الإصدار	6.0.2
   حزمة المنتجات	تسجيل الدخول إلى Google

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 من أجل تخزين بيانات الاعتماد عبر keychain.

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

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