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

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

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

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

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

تم إعداد هذا الدليل لمستخدمي "استوديو 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.3.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 Console وإعداد مشروعك على Android Studio، يمكنك دمج ميزة "تسجيل الدخول باستخدام حساب Google" في تطبيقك.