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

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

قبل البدء

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

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

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

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

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

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

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

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

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

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

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

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