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