بدء استخدام "خدمات ألعاب Play" لنظام التشغيل Android

مرحبًا بك في تطوير ألعاب Android من خلال "خدمات ألعاب Google Play".

توفِّر حزمة تطوير البرامج (SDK) لـ "ألعاب Play" خدمات ألعاب Google Play من عدّة منصات، ما يتيح لك بسهولة دمج ميزات الألعاب الرائجة مثل الإنجازات وقوائم الصدارة والألعاب المحفوظة في ألعابك على الأجهزة الجوّالة والأجهزة اللوحية.

سترشدك هذه الدورة التدريبية إلى كيفية تثبيت نموذج من تطبيق لعبة على Android والبدء بسرعة في إنشاء لعبة Android الخاصة بك. يوضح نموذج تطبيق تحدي كتابة رقم كيف يمكنك دمج الإنجازات وقوائم الصدارة في لعبتك.

قبل البدء

لإعداد تطبيقك، أكمِل الخطوات الواردة في الأقسام التالية.

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

تأكَّد من أنّ ملف إصدار تطبيقك يستخدم القيم التالية:

  • minSdkVersion بقيمة 19 بدرجة أعلى
  • compileSdkVersion بقيمة 28 أو أعلى

إعداد لعبتك في Google Play Console

أداة Google Play Console هي المكان الذي تدير فيه "خدمات ألعاب Google Play" للعبتك، وتضبط البيانات الوصفية لتفويض لعبتك ومصادقتها. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد "خدمات ألعاب Google Play".

ضبط إعدادات تطبيقك

في ملف build.gradle على مستوى المشروع، ضمِّن مستودع Maven من Google ومستودع Maven المركزي في كل من القسمَين buildscript وallprojects:

  buildscript {
    repositories {
      google()
      mavenCentral()
    }
  }

  allprojects {
    repositories {
      google()
      mavenCentral()
    }
  }

أضِف الاعتمادية لخدمات Google Play لحزمة تطوير البرامج (SDK) الخاصة بـ "ألعاب Play" إلى ملف إصدار Gradle الخاص بالوحدة، وهو عادةً app/build.gradle:

  dependencies {
    implementation 'com.google.android.gms:play-services-games:23.1.0'
  }

نموذج دليل التطبيق

سترشدك هذه الدورة التدريبية إلى كيفية تثبيت نموذج لعبة على Android وبدء إنشاء لعبة على Android بسرعة. يوضح نموذج تطبيق تحدي كتابة رقم كيف يمكنك دمج الإنجازات وقوائم الصدارة في لعبتك.

الخطوة 1: تنزيل نموذج التطبيق

بالنسبة إلى دليل المطوِّر هذا، ستحتاج إلى تنزيل نموذج تحدي كتابة رقم ضمن تطبيق Android.

لتنزيل نموذج التطبيق وإعداده في "استوديو Android"، اتّبِع الخطوات التالية:

  1. يمكنك تنزيل نماذج Android من صفحة تنزيل النماذج.
  2. استيراد مشروع "android-basic-samples" يتضمّن هذا المشروع لعبة "TypeANumber" وعيّنات أخرى من ألعاب Android. لإجراء ذلك في "استوديو Android"، اتّبِع الخطوات التالية:
    1. انقر على ملف > استيراد مشروع.
    2. انتقِل إلى الدليل الذي نزّلت فيه android-basic-samples على جهاز التطوير. اختَر الملف android-basic-samples/build.gradle وانقر على حسنًا.
  3. في وحدة TypeANumber، افتح AndroidManifest.xml وغيِّر اسم الحزمة من com.google.example.games.tanc إلى اسم حزمة مختلف خاص بك. يجب ألا يبدأ اسم الحزمة الجديدة بـ com.google أو com.example أو com.android.

الخطوة 2: إعداد اللعبة في Google Play Console

أداة Google Play Console هي المكان الذي يمكنك فيه إدارة "خدمات ألعاب Google Play" للعبتك، وتضبط البيانات الوصفية لتفويض لعبتك ومصادقتها.

لإعداد نموذج اللعبة في Google Play Console:

  1. وجِّه متصفح الويب إلى Google Play Console وسجِّل الدخول. إذا لم يسبق لك التسجيل في Google Play Console، سيُطلب منك إجراء ذلك.
  2. اتّبِع هذه التعليمات لإضافة لعبتك إلى Google Play Console.
    1. عند سؤالك عمّا إذا كنت تستخدم Google APIs في تطبيقك، اختَر لا أستخدم أيًا من Google APIs في لعبتي حتى الآن.
    2. لأغراض دليل المطوّر هذا، يمكنك ملء النموذج بتفاصيل اللعبة الخاصة بك. لتسهيل الأمر، يمكنك استخدام رموز العناصر النائبة ولقطات الشاشة المتوفّرة في صفحة عمليات التنزيل.
  3. اتّبِع التعليمات التالية لإنشاء معرِّف عميل OAuth 2.0 لتطبيق Android.
    1. عند ربط تطبيق Android، تأكد من تحديد اسم الحزمة الدقيق الذي استخدمته سابقًا عند إعادة تسمية نموذج الحزمة.
    2. يمكنك استخدام "معالج حِزم APK الموقَّعة" في "استوديو Android" لإنشاء ملف تخزين مفاتيح جديد وشهادة موقَّعة إذا لم يسبق لك إجراء ذلك. للتعرّف على كيفية تشغيل معالج إنشاء حِزم APK مُوقَّعة، يمكنك الاطّلاع على توقيع تطبيقك في "استوديو Android".
  4. احرص على تسجيل المعلومات التالية لاستخدامها في وقت لاحق:
    1. رقم تعريف الطلب: عبارة عن سلسلة تتألّف فقط من أرقام (عادةً 12 أو أكثر) في بداية معرِّف العميل.
    2. شهادة التوقيع: يُرجى الاطّلاع على الشهادة التي استخدمتها عند إعداد دخولك إلى واجهة برمجة التطبيقات (الشهادة التي قدَّمت ملف SHA1 المرجعي الخاص بها). يجب عليك استخدام الشهادة نفسها لتوقيع تطبيقك عند اختباره أو إصداره.
  5. ضبط الإنجازات في تحدّي كتابة رقم:
    1. اختَر علامة التبويب الإنجازات في Google Play Console.
    2. أضِف نماذج الإنجازات التالية:
      الاسم الوصف تعليمات خاصة
      الرئيسية احصل على نتيجة رقم أولي. بدون قفل
      Humble اطلب النتيجة 0. بدون قفل
      لا تضحك يا طفل اطلب درجة 9,999 في أي من الوضعين. بدون قفل
      رائع. الحصول على النتيجة 1337. اجعل هذا إنجازًا مخفيًا.
      ملل تشغيل اللعبة 10 مرات حقِّق إنجازًا إضافيًا باستخدام 10 خطوات.
      بالملل الحقيقي شغِّل اللعبة 100 مرة. حقِّق إنجازًا إضافيًا من خلال تنفيذ 100 خطوة لتحقيق الفوز.
    3. سجل المعرفات (سلاسل أبجدية رقمية طويلة) لكل إنجاز قمت بإنشائه.
    4. يمكنك ضبط الإنجازات المناسبة للعبتك. لمزيد من المعلومات، يمكنك الاطّلاع على المفاهيم المتعلقة بالإنجازات وكيفية تنفيذ الإنجازات في Android.
  6. اضبط لوحات الصدارة لتحدي كتابة رقم:
    1. اختَر علامة التبويب لوحات الصدارة في Google Play Console.
    2. أضف نموذجين من لوحات الصدارة: إحداهما باسم "الدرجات العالية السهلة" والأخرى باسم "النتائج العالية الثابتة". ويجب أن تستخدم كلا اللوحتين تنسيق نتيجة العدد الصحيح بدون خانات عشرية، ونوع الترتيب كبيرًا أفضل.
    3. سجِّل أرقام التعريف (سلاسل أبجدية رقمية طويلة) لكل لوحة صدارة أنشأتها.
    4. يمكنك إعداد لوحات الصدارة المناسبة للعبتك. لمزيد من المعلومات، يمكنك الاطّلاع على المفاهيم المتعلقة بميزة "لوحات الصدارة" وكيفية تنفيذها في Android.
  7. أضِف حسابات تجريبية للعبتك. هذه الخطوة مطلوبة فقط للتطبيقات التي لم يتم نشرها بعد في Google Play Console. قبل نشر التطبيق، لا يمكن تسجيل الدخول إلا للحسابات التجريبية المدرجة في Google Play Console. ومع ذلك، بعد نشر التطبيق، يُسمح للجميع بتسجيل الدخول.

الخطوة 3: تعديل الرمز البرمجي

لتشغيل اللعبة، يجب إعداد رقم تعريف التطبيق كمورد في مشروع Android. يجب أيضًا إضافة البيانات الوصفية للألعاب في "AndroidManifest.xml".

  1. افتح res/values/ids.xml واستبدل أرقام تعريف العناصر النائبة. إذا كنت تنشئ لعبة Android من نقطة الصفر، فستحتاج إلى إنشاء هذا الملف أولاً.
    1. حدِّد رقم تعريف التطبيق في مورد app_id.
    2. حدِّد كل رقم تعريف إنجاز أنشأته في وقت سابق في مورد achievement_* المقابل.
    3. حدِّد كل رقم تعريف للوحة الصدارة أنشأته في وقت سابق في مورد leaderboard_* المقابل.
  2. افتح AndroidManifest.xml وأدخِل اسم الحزمة في السمة package للعنصر <manifest>. إذا كنت تنشئ لعبة Android من البداية، احرص على إضافة الرمز التالي داخل العنصر <application>: 
    <meta-data android:name="com.google.android.gms.games.APP_ID"
    android:value="@string/app_id" />
<meta-data android:name="com.google.android.gms.version"
   android:value="@integer/google_play_services_version"/>

الخطوة 4: اختبار لعبتك

للتأكّد من عمل "خدمات ألعاب Google Play" بشكل صحيح في لعبتك، يمكنك اختبار التطبيق قبل نشره على Google Play.

لتشغيل اللعبة على جهاز الاختبار الفعلي:

  1. تأكَّد من أنك أعددت الحساب التجريبي الذي تستخدمه لتسجيل الدخول إلى التطبيق (كما هو موضّح في الخطوة 2).
  2. تصدير ملف APK وتوقيعه باستخدام الشهادة نفسها التي استخدمتها لإعداد المشروع في Google Play Console لتصدير حِزمة APK موقَّعة في "استوديو Android"، انقر على إنشاء > إنشاء حِزمة APK موقَّعة.
  3. ثبِّت حزمة APK الموقَّعة على جهاز الاختبار الفعلي باستخدام أداة adb. لمعرفة كيفية تثبيت تطبيق، يُرجى الاطّلاع على مقالة التشغيل على جهاز.