بدء استخدام خدمات ألعاب Play لـ C++ على Android

تنبيه: هذا الدليل مخصّص لاستخدام الإصدار 1 من "خدمات ألعاب Play". ستتوفّر قريبًا حزمة تطوير البرامج (SDK) المخصّصة للإصدار C2 من خدمات ألعاب Play الإصدار 2 وإرشاداتها. في هذه الأثناء، يمكنك العثور على مزيد من المعلومات حول الإصدار 2 في دليل تسجيل الدخول. إذا كنت تريد اختبار الإصدار الجديد من حزمة تطوير البرامج (SDK)، يُرجى التواصل مع جهة اتصال Google التي تتعامل معها للحصول على مزيد من المعلومات.

قبل البدء

سيوضح لك دليل المطوِّر هذا كيفية تجميع وتشغيل لعبة C++ على Android والتي تستخدم واجهة برمجة تطبيقات خدمات ألعاب Google Play. قبل البدء، يجب تنزيل المتطلبات التالية وإعدادها:

• Android NDK، الإصدار 14 أو الإصدارات الأحدث.
• Android SDK الإصدار 10 أو أحدث وأحدث إصدار من Eclipse ADT.
• يجب أن يعمل الجهاز بنظام التشغيل Android 4.0 (مستوى واجهة برمجة التطبيقات 14) أو إصدار أحدث.
• أحدث إصدار من حزمة SDK لخدمات Google Play.

يستخدم دليل المطوِّر هذا مجموعة أدوات التطوير المحلي (Android) وإذا لم تكن على علم بالاتفاقية، يُرجى الرجوع إلى مستندات ونماذج NDK قبل المتابعة.

الخطوة 1: إعداد بيئتك

1. نزّل Android SDK وAndroid NDK واستخرجهما إلى جهازك. في بيئتك، اضبط SDK_ROOT على موقع مجلد Android SDK وNDK_ROOT على موقع مجلد Android NDK.
2. نزّل نماذج ألعاب C++ . يشير دليل مطوّري البرامج هذا إلى موقع العيّنات على جهازك باسم SAMPLES_DIR.
3. تنزيل حزمة تطوير البرامج (SDK) لخدمات "ألعاب Google Play" استخرج SDK من جهاز التطوير. في بيئتك، اضبط المتغيّر NDK_MODULE_PATH للإشارة إلى الدليل أعلى الدليل gpg-cpp-sdk. يجب أن يكون لديك بنية الدليل التالية:

   NDK_MODULE_PATH/
   gpg-cpp-sdk/

4. افتح Eclipse. في حالة عدم إجراء ذلك من قبل، يمكنك إخبار Eclipse بمكان تثبيت NDK من خلال النقر على تفضيلات > Android > NDK.

5. يمكنك استيراد مشروع مكتبة خدمات Google Play إلى مساحة عمل Eclipse.

   1. في Eclipse، انقر على ملف > استيراد > Android > رمز Android الحالي إلى Workspace.
   2. اختَر SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib حيث يكون SDK_ROOT هو موقع حزمة تطوير البرامج (SDK) لنظام التشغيل Android.
   3. انقر على إنهاء.

6. استيراد نموذج المشروع البسيط إلى مساحة عمل Eclipse.

   1. في Eclipse، انقر على ملف > استيراد > Android > رمز Android الحالي إلى Workspace.
   2. اختَر SAMPLES_DIR/samples-android/minimalist.
   3. انقر على إنهاء.

7. انقر بزر الماوس الأيمن على مشروع MinimalistActivity وانقر على الخصائص. ضمن Android، مرِّر للأسفل وصولاً إلى قسم المكتبة وتأكّد من أنه تمت الإشارة إلى مشروع google-play-services_lib بشكلٍ صحيح. إذا لم يكن الأمر كذلك، عليك إزالة المرجع وإضافته مرة أخرى من مساحة العمل.

سيجمع Eclipse مصادر جافا وAndroid لمشروعك تلقائيًا، ولكن يجب تجميع الرمز الأصلي في المجلد jni بشكل منفصل. لإجراء ذلك يدويًا، انتقل إلى مجلد jni وشغّل ndk-build. تذكر إجراء ذلك بعد إجراء أي تغييرات في مجلد jni.

من المفترض أن يتم تجميع مشروعك الآن، على الرغم من أنه لن يعمل بعد. يجب أولاً تهيئة لعبتك في Google Play Console.

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

أنشئ مشاركة للعبتك في Google Play Console. يؤدي هذا إلى تمكين خدمات الألعاب لتطبيقك، وإنشاء معرّف عميل OAuth 2.0، إذا لم يكن لديك واحد بالفعل.

1. يمكنك إنشاء ملاحظة للعبتك من خلال اتباع الخطوات الموضحة في إعداد خدمات ألعاب Google Play.
2. في AndroidManifest.xml، غيّر السمة package للعلامة <manifest> إلى اسم الحزمة الذي اخترته عند إعداد Google Play Console. قد تحتاج إلى إصلاح بعض المراجع خلال المشروع بعد إجراء هذا التغيير (وبخاصة إلى الصف R الذي تم إنشاؤه).
3. افتح res/values/ids.xml وضع رقم تعريف التطبيق هناك. لاحظ أن رقم تعريف التطبيق ليس هو نفسه رقم تعريف العميل، فهو الرقم المجاور لاسم لعبتك في صفحة تفاصيل اللعبة في Google Play Console.

الخطوة 3: تشغيل النموذج

لتنفيذ النموذج، ستحتاج إلى جهاز فعلي يعمل بنظام التشغيل Android أو محاكي يتضمن خدمات Google Play مثبتة:

1. شغِّل ndk-build لتجميع الرمز الأصلي.
2. في Eclipse، انقر على Run > Run As > Android Application وشغّل النموذج على جهازك.
3. عندما يتم فتح النموذج، انقر في أي مكان على الشاشة. من المفترض أن يظهر لك شعار ألعاب Google Play. إذا تمت تهيئة التطبيق بشكل صحيح، فستتم مطالبتك بتسجيل الدخول.

ملاحظة مهمة: تأكَّد من توقيع ملف APK باستخدام الشهادة نفسها المستخدَمة في الملف المرجعي الذي تم إعداد ملف مرجعي له على Google Play Console. سيؤدي عدم إجراء ذلك إلى حدوث أخطاء.

ملاحظة مهمة: إذا كنت تختبر لعبة غير منشورة، تأكَّد من أن الحساب الذي تنوي تسجيل الدخول باستخدامه (عادةً ما يكون الحساب على جهاز الاختبار) مُدرَجًا كمختبِر في المشروع. افتح صفحة الاختبار في علامة التبويب الفرعية خدمات الألعاب في Google Play Console للتحقّق من القائمة البيضاء أو تنفيذها. يؤدي الإخفاق في تنفيذ هذه الخطوة إلى عمل الخادم كما لو أن مشروعك غير موجود، ويتم عرض أخطاء.

اختياري: الإنشاء تلقائيًا باستخدام Eclipse

توضّح لك الخطوات التالية كيفية ضبط إعدادات Eclipse لتشغيل ndk-build تلقائيًا عند إجراء تغييرات على الملفات في مجلد jni.

1. انقر بزر الماوس الأيمن على مشروع MinimalistActivity وانقر على الخصائص. في نافذة "الخصائص"، اختَر جزء المُنشئون.
2. انقر على جديد لإضافة أداة إنشاء جديدة، واختَر برنامج، ثم انقر على موافق.
3. في حقل الاسم، أدخل "NDK Builder".
4. ضمن الموقع، انقر على تصفُّح نظام الملفات وانتقِل إلى الدليل NDK_ROOT واختَر الأمر ndk-build.
5. ضمن دليل العمل، انقر على تصفُّح Workspace واختَر مجلد المشروع MinimalistActivity.
6. انقر على علامة التبويب تحديث. تأكد من تحديد مربع تحديث الموارد عند الانتهاء.
7. حدد زر الاختيار موارد محددة ثم انقر على تحديد الموارد. في مربع الحوار الناتج، حدد المجلد jni ضمن MinimalActivity.
8. انقر على تطبيق ثم موافق للانتهاء من إنشاء أداة الإنشاء.

في كل مرة تعدّل فيها ملفًا داخل مجلد jni، سيشغّل Eclipse ndk-build ويطبع الإخراج إلى وحدة تحكم Eclipse.

ملاحظة: في حال ظهور أخطاء أثناء تعديل ملفات C أو C++ في Eclipse تمنعك من إنشاء المشروع، قد تحتاج إلى إيقاف إعداد تقارير أخطاء C/C++ في Eclipse. في مواقع مشروعك، انتقل إلى C/C++ General > Code Code > Launching وتأكد من إلغاء تحديد كلا المربعين. ثم انقر على تطبيق وموافق. ويُعد هذا حلاً بديلاً لمنع Eclipse من التحقق من رمزك الأصلي، إلا أنه لا يؤدي إلى إصلاح أي أخطاء أساسية فعلية قد تواجهها.