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

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

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

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

  1. نزِّل حِزم SDK وNDK لنظام التشغيل Android وفُك ضغطها على جهازك. في البيئة، اضبط SDK_ROOT على الموقع الجغرافي لمجلد حزمة تطوير البرامج (SDK) لنظام التشغيل Android وNDK_ROOT على الموقع الجغرافي لمجلد Android NDK.
  2. نزِّل عيّنات الألعاب المكتوبة بلغة C++. يشير دليل المطوّر هذا إلى الموقع الجغرافي للعيّنات على جهازك باسم SAMPLES_DIR.
  3. نزِّل حزمة تطوير البرامج (SDK) لـ "خدمات ألعاب Google Play" التي تستخدم لغة C++‎. استخرِج IDE على جهاز التطوير. في بيئتك، اضبط المتغيّر 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 الحالي في مساحة العمل.
    2. اختَر SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib حيث يكون SDK_ROOT هو موقع حزمة تطوير البرامج (SDK) لنظام التشغيل Android.
    3. انقر على إنهاء.

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

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

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

سيُجمِّع Eclipse تلقائيًا مصادر Java و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 (تطبيق Android) وشغِّل العيّنة على جهازك.
  3. عند فتح العيّنة، انقر على أي مكان على الشاشة. من المفترض أن يظهر لك شعار "ألعاب Google Play". إذا كنت قد أعددت تطبيقك بشكل صحيح، سيُطلب منك تسجيل الدخول.

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

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

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

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