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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

حتى تتمكن من بدء دمج تسجيل الدخول بحساب Google في تطبيقك، يجب تهيئة مشروع وحدة تحكم واجهة برمجة تطبيقات Google وإعداد مشروع Android Studio. تؤدي الخطوات الواردة في هذه الصفحة إلى إجراء ذلك تمامًا. وبعد ذلك، تصف الخطوات التالية كيفية دمج تسجيل الدخول بحساب Google في تطبيقك.

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

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

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

تم إعداد هذا الدليل لمستخدمي 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.4.1'
    }

تهيئة مشروع وحدة تحكم Google API

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

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

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

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

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

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

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

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