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

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

قبل البدء

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

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

CocoaPods

  1. إذا لم يكن CocoaPods مثبّتًا على جهازك، اتّبِع الخطوات الواردة في بدء استخدام CocoaPods الدليل.

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

  3. إذا لم تكن قد أنشأت ملف Podfile من قبل لتطبيقك، فأنشئ واحدًا الآن: 

    pod init

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

    pod 'GoogleSignIn'

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

    pod 'GoogleSignInSwiftSupport'

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

    pod install

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

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

مدير حزم Swift

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

  2. إضافة الموارد التابعة لتسجيل الدخول باستخدام حساب Google إلى تطبيقك (وثائق Xcode):

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

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

    حزمة المنتج GoogleSignInSwift

الحصول على معرِّف عميل OAuth

يحتاج تطبيقك إلى معرِّف عميل OAuth لتعريف نفسه لمصادقة Google. الخلفية. نوع تطبيق معرِّف عميل OAuth بالنسبة إلى تطبيقات iOS وmacOS أن يتم إعداده على نظام التشغيل 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 في السحابة الإلكترونية وحدة التحكم. مثل: 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.