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

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

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

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

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

هذا الدليل مخصّص لمستخدمي "استوديو 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. افتح مشروعك في وحدة تحكّم API.

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

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

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