قبل البدء
سيوضح لك دليل المطوِّر هذا كيفية تجميع وتشغيل لعبة 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: إعداد البيئة
- نزِّل حزمة تطوير البرامج (SDK) لنظام التشغيل Android وحزمة تطوير البرامج (NDK) الخاصة بنظام التشغيل Android واستخرجهما على جهازك. في
عليك ضبط
SDK_ROOT
على موقع مجلد حزمة تطوير البرامج (SDK) لنظام التشغيل Android وNDK_ROOT
على مكان مجلد Android NDK. - نزِّل نماذج ألعاب C++. هذا النمط
يشير دليل المطوِّر إلى مكان العيّنات على جهازك باسم "
SAMPLES_DIR
". - نزِّل حزمة SDK الخاصة بـ C++ في "خدمات ألعاب Google Play". استخراج ملف
حزمة SDK في جهاز التطوير. في بيئتك، اضبط المتغيّر
NDK_MODULE_PATH
على عليك الإشارة إلى الدليل أعلى دليلgpg-cpp-sdk
. يجب أن يتوفر لديك ما يلي: بنية الدليل:NDK_MODULE_PATH/ gpg-cpp-sdk/
- افتح Eclipse. أخبِر Eclipse بمكان تثبيت NDK إذا لم يسبق لك إجراء ذلك من خلال النقر على التفضيلات > Android > NDK.
يمكنك استيراد مشروع مكتبة "خدمات Google Play" إلى مساحة عمل Eclipse.
- في Eclipse، انقر على ملف > استيراد > Android > رمز Android الحالي في Workspace
- اختيار "
SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib
" حيثSDK_ROOT
هو موقع حزمة تطوير البرامج (SDK) لنظام التشغيل Android. - انقر على إنهاء.
قم باستيراد نموذج المشروع البسيط إلى مساحة عمل Eclipse.
- في Eclipse، انقر على ملف > استيراد > Android > رمز Android الحالي في Workspace
- اختَر
SAMPLES_DIR/samples-android/minimalist
. - انقر على إنهاء.
انقر بزر الماوس الأيمن على مشروع 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، إذا لم يكن لديك واحد بالفعل.
- أنشئ إدخالاً للعبتك باتّباع الخطوات الموضّحة في إعداد "خدمات ألعاب Google Play":
- في
AndroidManifest.xml
، غيِّر السمةpackage
للعلامة<manifest>
إلى اسم الحزمة الذي اخترته عند إعداد Google Play Console. قد تضطر إلى إصلاح بعض المراجع خلال المشروع بعد إجراء هذا التغيير (لا سيما في فئةR
التي تم إنشاؤها). - يُرجى فتح "
res/values/ids.xml
" ووضع رقم تعريف التطبيق هناك. لاحظ أن معرّف التطبيق ليس هو نفسه ومعرف العميل؛ هو الرقم بجانب اسم اللعبة في صفحة تفاصيل اللعبة Google Play Console.
الخطوة 3: تنفيذ النموذج
لتشغيل العينة، ستحتاج إلى جهاز Android فعلي أو محاكي به خدمات Google Play المثبَّتة:
- شغِّل
ndk-build
لتجميع الرمز الأصلي. - في Eclipse، انقر على Run (تشغيل) > تشغيل كـ > تطبيق Android وشغِّل النموذج على جهازك.
- عند فتح النموذج، انقر في أي مكان على الشاشة. من المفترض أن يظهر لك شعار "ألعاب Google Play". موضع الإعلان. إذا كنت قد أعددت تطبيقك بشكل صحيح، سيُطلب منك تسجيل الدخول.
اختياري: الإنشاء تلقائيًا باستخدام Eclipse
توضّح لك الخطوات التالية كيفية ضبط Eclipse لتشغيل ndk-build
تلقائيًا عند:
إجراء التغييرات على الملفات في مجلد jni
- انقر بزر الماوس الأيمن على مشروع MinimalistActivity، ثم انقر على Properties (الخصائص). في نافذة "Properties" (الخصائص)، اختَر لوحة المنشئون.
- انقر على جديد لإضافة أداة إنشاء جديدة واختَر برنامج، ثم انقر على حسنًا.
- في حقل الاسم، أدخِل "NDK Builder".
- ضمن الموقع الجغرافي، انقر على تصفّح نظام الملفات وانتقِل إلى الدليل
NDK_ROOT
. حدد الأمرndk-build
. - ضمن دليل العمل، انقر على تصفُّح مساحة العمل واختَر MinimalistActivity. مشروع جديد.
- انقر على علامة التبويب إعادة التحميل. تأكّد من وضع علامة في المربّع إعادة تحميل الموارد عند الاكتمال.
- حدِّد زر الاختيار موارد محددة، ثم انقر على تحديد الموارد. في جلسة المعمل،
الذي سيظهر لك، اختَر المجلد
jni
ضمن MinimalActivity. - انقر على تطبيق، ثم على حسنًا للانتهاء من إنشاء أداة الإنشاء.
الآن في كل مرة تعدّل فيها ملفًا داخل مجلد "jni
"، سيشغِّل Eclipse ndk-build
ويطبع
إلى وحدة تحكم Eclipse.