البدء بدمج "تسجيل الدخول بحساب 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.2.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" في تطبيقك.