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

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

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

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

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

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

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

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

لإنشاء معرِّف عميل لخادمك:

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

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

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

الآن بعد أن ضبطت مشروع وحدة تحكم واجهة برمجة تطبيقات Google وأعددت مشروع استوديو Android، يمكنك دمج تسجيل الدخول بحساب Google في تطبيقك.