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

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

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

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

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

تم تصميم هذا الدليل لمستخدمي Android Studio، وهي بيئة التطوير المُقترَحة.

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

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

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:20.5.0'
    }

إعداد مشروع وحدة تحكم Google API

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

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

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

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

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

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

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

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