قبل البدء في دمج تطبيق iOS أو macOS مع مكوّنات تسجيل الدخول بحساب Google، عليك تنزيل التبعيات وإعداد مشروع Xcode. الخطوات في هذه الصفحة تفعل ذلك بالضبط. بعد ذلك، يمكنك توضيح كيفية دمج ميزات تسجيل الدخول بحساب Google في تطبيقك.
قبل البدء
ثبِّت إصدارًا حاليًا من Xcode.
تثبيت تبعيات "تسجيل الدخول بحساب Google" في مشروعك
CocoaPods
إذا لم يكن تطبيق CocoaPods مثبّتًا على جهازك، اتّبِع الخطوات الواردة في دليل دليل البدء في CocoaPods.
افتح نافذة طرفية وانتقل إلى موقع مشروع Xcode للتطبيق.
إذا لم تكن قد أنشأت ملف Podfile من قبل لتطبيقك، فأنشئ واحدًا الآن:
pod init
افتح Podfile الذي تم إنشاؤه لتطبيقك وأضِف ما يلي:
pod 'GoogleSignIn'
إذا كنت تستخدم SwiftUI، ثبِّت أيضًا إضافة لوحة الإعلانات المتسلسلة لزر "تسجيل الدخول باستخدام Google":
pod 'GoogleSignInSwiftSupport'
احفظ الملف وشغِّل:
pod install
افتح ملف workspace
.xcworkspace
الذي تم إنشاؤه لتطبيقك في Xcode. استخدم هذا الملف لكل عمليات التطوير المستقبلية في تطبيقك. (ملاحظة: يختلف هذا الملف عن ملف مشروع.xcodeproj
المضمّن، والذي قد يؤدي إلى حدوث أخطاء في الإصدار عند فتحه.)يمكنك الرجوع إلى نموذج ملف Podfile التابع لـ FALSE-C للحصول على مثال.
مدير حزم Swift
افتح مشروعك في Xcode.
أضف تبعيات تسجيل الدخول بحساب Google إلى تطبيقك (وثائق Xcode):
المستودع https://github.com/google/GoogleSignIn-iOS
الإصدار 7.0.0 منتج الحزمة GoogleSignIn إذا كنت تستخدم SwiftUI، أضِف أيضًا منتج حزمة الإضافات التالي للزر "تسجيل الدخول باستخدام حساب Google":
منتج الحزمة GoogleSignInSwift
الحصول على معرِّف عميل بروتوكول OAuth
يحتاج تطبيقك إلى معرِّف عميل OAuth حتى يعرِّف نفسه لواجهة مصادقة Google. بالنسبة إلى تطبيقات iOS وmacOS، يجب ضبط نوع تطبيق معرِّف عميل OAuth على أنّه iOS.
إذا لم تكن قد أنشأت معرِّف عميل OAuth من قبل، انقر على الزر أدناه لإجراء ذلك.
بعد إنشاء معرِّف عميل OAuth، دوِّن سلسلة معرِّف العميل التي ستحتاج إلى إعداد "تسجيل الدخول بحساب Google" في تطبيقك. يمكنك اختياريًا تنزيل ملف الإعداد، الذي يحتوي على معرِّف العميل وبيانات الضبط الأخرى، للرجوع إليها في المستقبل.
إذا سبق لك إنشاء معرِّف عميل OAuth، يمكنك الاطّلاع على معلومات OAuth الحالية عن طريق النقر على الزر أدناه.
الحصول على معرِّف عميل OAuth حالي
الحصول على معرِّف عميل خادم OAuth
ستحتاج معظم التطبيقات إلى تمرير هوية المستخدمين الذين سجّلوا الدخول إلى إحدى خدمات الخلفية من نوع ما. لتمرير هوية المستخدمين الذين سجلوا الدخول باستخدام حساب Google إلى الخلفية بشكل آمن، يمكنك استخدام الرموز المميّزة لرقم التعريف على النحو الموضّح في قسم المصادقة باستخدام خادم خلفية. يتطلب استرداد الرمز المميز لمعرّف المستخدم معرّف عميل ثانٍ، وهو معرّف عميل الخادم، الذي يمثّل الخادم الخلفي.
لإنشاء معرِّف عميل للخادم:
افتح مشروعك في Cloud Console.
أنشئ معرِّف عميل 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 الخاص بك.