بدء استخدام "خدمات ألعاب Play" لأجهزة Android

بعد إيقاف Google Sign-In API نهائيًا، سنزيل الإصدار v1 من حزمة تطوير البرامج (SDK) الخاصة بـ "خدمات ألعاب Play". في عام 2026. بعد فبراير 2025، لن يكون بإمكانك نشر الألعاب التي تتكامل مع الإصدار v2 من حزمة SDK الخاصة بـ "خدمات ألعاب Play". ننصحك باستخدام الإصدار v2 حزمة SDK الخاصة بـ "خدمات ألعاب Play". بدلاً من ذلك.
مع أنّ التطبيقات الحالية التي تتكامل مع الإصدار v1 من حزمة SDK الخاصة بـ "خدمات ألعاب Play" ستستمر في العمل لعدّة سنوات، ننصحك بالانتقال إلى الإصدار v2 بدءًا من يونيو 2025.
هذا الدليل مخصّص لاستخدام الإصدار v1 من حزمة SDK الخاصة بـ "خدمات ألعاب Play". للحصول على معلومات حول أحدث إصدار من حزمة SDK، يمكنك الاطّلاع على مستندات الإصدار 2.

مرحبًا بك في عالم تطوير ألعاب 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 على مستوى المشروع، أدرِج مستودع Google Maven ومستودع 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 Studio، اتّبِع الخطوات التالية:

1. يمكنك تنزيل نماذج Android من صفحة تنزيل النماذج.
2. استورِد مشروع android-basic-samples. يتضمّن هذا المشروع TypeANumber وعيّنات أخرى من ألعاب Android. لإجراء ذلك في "استوديو Android"، اتّبِع الخطوات التالية:
   1. انقر على ملف (File) > استيراد مشروع (Import Project).
   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. أضِف الإنجازات النموذجية التالية:

      الاسم	الوصف	تعليمات خاصة
      رئيسي	الحصول على نتيجة عددها أولي	بدون إشعارات
      متواضع	طلب الحصول على النتيجة 0	بدون إشعارات
      لا تتفاخر يا فتى	طلب الحصول على نتيجة 9999 في أي من الوضعين	بدون إشعارات
      OMG U R TEH UBER LEET!	الحصول على النتيجة 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: اختبار لعبتك

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

لتشغيل لعبتك على جهاز الاختبار الفعلي، اتّبِع الخطوات التالية:

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