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

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

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

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

قبل البدء

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

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

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

  • درجة 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.2.0'
  }

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

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

الخطوة 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. بدون قفل
      لا تكن مغرورًا يا طفلي اطلب النتيجة 9999 في أي من الوضعين. بدون قفل
      يا للعجب! احصل على النتيجة 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. لمعرفة كيفية تثبيت تطبيق، راجع التشغيل على جهاز.