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