البدء بدمج "تسجيل الدخول بحساب Google" في تطبيق Android

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

المتطلبات الأساسية

يتطلب تسجيل الدخول بحساب Google على أجهزة Android المتطلبات التالية:

  • يجب أن يكون لديك جهاز Android متوافق يعمل بالإصدار 5.0 من نظام التشغيل Android أو إصدار أحدث ويتضمن "متجر Google Play" أو محاكيًا بنظام "متوسّط مدة المشاهدة" يشغّل النظام الأساسي لـ Google APIs الذي يعمل بالإصدار 4.2.2 أو إصدار أحدث من نظام التشغيل Android ويتضمّن الإصدار 15.0.0 من "خدمات Google Play" أو إصدار أحدث.
  • أحدث إصدار من حزمة تطوير البرامج (SDK) لنظام التشغيل Android، بما في ذلك مكوّن أدوات حزمة تطوير البرامج (SDK) وتتوفّر حزمة تطوير البرامج (SDK) في Android SDK Manager في "استوديو Android".
  • مشروع تم إعداده للتجميع استنادًا إلى Android 5.0 (Lollipop) أو الإصدارات الأحدث.

هذا الدليل موجّه لمستخدمي "استوديو Android"، وهو بيئة التطوير المقترَحة.

إضافة خدمات Google Play

في ملف build.gradle ذي المستوى الأعلى لمشروعك، تأكَّد من تضمين مستودع Maven من Google:

allprojects {
    repositories {
        google()

        // If you're using a version of Gradle lower than 4.1, you must instead use:
        // maven {
        //     url 'https://maven.google.com'
        // }
    }
}

بعد ذلك، في ملف build.gradle على مستوى التطبيق، يجب تعريف خدمات Google Play كتبعية:

apply plugin: 'com.android.application'
    ...

    dependencies {
        implementation 'com.google.android.gms:play-services-auth:21.0.0'
    }

ضبط مشروع على Google API Console

  1. افتح مشروعك في وحدة تحكم واجهة برمجة التطبيقات أو أنشئ مشروعًا إذا لم يكن لديك مشروع من قبل.
  2. في صفحة شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth، تأكَّد من أنّ جميع المعلومات كاملة ودقيقة.
  3. في صفحة "بيانات الاعتماد"، أنشئ معرِّف عميل من النوع Android لتطبيقك إذا لم يكن لديك معرِّف عميل حاليًا. ستحتاج إلى تحديد اسم حزمة تطبيقك والملف المرجعي لشهادة SHA-1. راجع مصادقة عميلك للحصول على مزيد من المعلومات.

الحصول على معرِّف عميل OAuth 2.0 لخادم الخلفية

إذا كان تطبيقك يصادق على خادم خلفية أو وصل إلى Google APIs من خادم الخلفية، ستحتاج إلى الحصول على معرّف عميل OAuth 2.0 الذي يمثّل خادم الخلفية.

لإنشاء معرِّف عميل لخادمك، يُرجى اتّباع الخطوات التالية:

  1. افتح مشروعك في وحدة تحكم واجهة برمجة التطبيقات.

  2. في صفحة "بيانات الاعتماد"، أنشئ معرِّف عميل من نوع تطبيق ويب. دوِّن سلسلة معرّف العميل التي ستحتاج إلى تمريرها إلى الطريقة requestIdToken أو requestServerAuthCode عند إنشاء العنصر GoogleSignInOptions.

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

بعد أن انتهيت من إعداد مشروع وحدة التحكم في واجهة Google API وإعداد مشروعك على "استوديو Android"، يمكنك دمج ميزة "تسجيل الدخول باستخدام حساب Google" في تطبيقك.