GameActivity جزء من حزمة تطوير ألعاب Android.
GameActivity هي مكتبة في Jetpack مصمَّمة لمساعدة ألعاب Android في معالجة أوامر دورة التطبيق وأحداث الإدخال وإدخال النصوص في رمز C/C++ الخاص بالتطبيق. GameActivity هو سليل مباشر لـ NativeActivity ويشترك معه في بنية مشابهة:

كما هو موضّح في المخطّط البياني السابق، يؤدي GameActivity الوظائف التالية:
- التفاعل مع إطار عمل Android من خلال مكوّن Java
- تمرير أوامر دورة التطبيق وأحداث الإدخال ونص الإدخال إلى الجانب الأصلي
- نمذجة الرمز المصدر لـ C/C++ إلى ثلاثة مكوّنات منطقية:
- دوال JNI في GameActivity، والتي تتيح استخدام وظائف Java في GameActivity مباشرةً وتضع الأحداث في قائمة انتظار
native_app_glue. native_app_glue، والذي يعمل في الغالب في سلسلة التعليمات الأصلية الخاصة به (تختلف عن سلسلة التعليمات الرئيسية للتطبيق)، وينفّذ المهام باستخدام الحلقة الخاصة به.- رمز اللعبة في التطبيق، والذي يستطلع الأحداث في قائمة الانتظار داخل
native_app_glueويعالجها وينفّذ رمز اللعبة ضمن سلسلة التعليمات البرمجيةnative_app_glue.
- دوال JNI في GameActivity، والتي تتيح استخدام وظائف Java في GameActivity مباشرةً وتضع الأحداث في قائمة انتظار
باستخدام GameActivity، يمكنك التركيز على تطوير لعبتك الأساسية وتجنُّب
قضاء وقت طويل في التعامل مع رمز JNI.
إذا كنت على دراية بـ NativeActivity، إليك الاختلافات الرئيسية
بين GameActivity وNativeActivity:
- يتم عرض
GameActivityفيSurfaceView، ما يسهّل على الألعاب التفاعل مع مكوّنات واجهة المستخدم الأخرى. - بالنسبة إلى أحداث الإدخال باللمس والمفاتيح، يتضمّن
GameActivityتنفيذًا جديدًا تمامًا مع واجهةandroid_input_buffer، بشكل منفصل عنInputQueueالتي يستخدمهاNativeActivity. -
GameActivityهي فئة مشتقة منAppCompatActivity، وتتيح لك استخدام مكوّنات Jetpack الأخرى بسلاسة.ActionBarوFragmentوغيرها متاحة الآن. - يضيف
GameActivityوظيفة إدخال النص من خلال دمج مكتبة GameTextInput. - من المتوقّع أن تنشئ التطبيقات المستمَدة من
GameActivityجميع الأجزاء الثلاثة من رمز C/C++ في مكتبة واحدة. من ناحية أخرى، دوال JNI فيNativeActivityهي جزء من إطار العمل (يتم تحميلها دائمًا بواسطة نظام التشغيل). وبالتالي، من المتوقّع أن يتم إنشاءnative_app_glueورمز C/C++ الخاص بالتطبيق فقط في مكتبة واحدة. -
NativeActivityهو جزء من إطار عمل Android ويتّبع دورة إصداره (عادةً ما تكون سنوية).GameActivityهي جزء من مكتبة Jetpack، التي تتضمّن دورة إصدار أكثر تكرارًا (عادةً كل أسبوعين)، ويمكن أن تصل الميزات الجديدة وإصلاحات الأخطاء بسرعة أكبر.
مواقع الإصدارات
تتوفّر مكتبة GameActivity في القنوات التالية:
- كجزء من مكتبة Android Jetpack (يُنصح به)
- كرمز مصدر AOSP
يتم توفير رمز C/C++ البرمجي كرمز مصدر في جميع قنوات الإصدار، باستخدام تنسيق Prefab. يضيف الإصدار 1.2.2 من GameActivity مكتبة ثابتة إلى عملية التوزيع. بدءًا من هذا الإصدار والإصدارات الأحدث، ننصحك باستخدام المكتبة الثابتة بدلاً من الرمز المصدر.
محتوى مكتبة Jetpack
باستخدام مكتبة Jetpack، يتم إصدار GameActivity مع ملف AAR. يحتوي ملف AAR هذا على المكوّنات الرئيسية التالية:
- ملف JAR لرمز Java
- يتم تضمين مكتبة C/C++ الثابتة
game-activity_staticفي الإصدار 1.2.2 من GameActivity والإصدارات الأحدث. - الرمز المصدر C/C++ (ضمن المجلد
/prefab)
تفترض تعليمات الدمج المرتبطة بهذه الصفحة أنّه يمكنك استخدام Prefab في نظام الإصدار، وإلا يمكنك نسخ الرمز المصدر المُجمَّع ضمن المجلد prefab/modules/game-activity/include إلى نظام الإصدار وتنفيذ خطوات الدمج اللازمة. تتوفّر بنية ملفات مشابهة للإصدارات ضمن androidx لمكتبة Android Jetpack. وبشكل تلقائي، يفكّ Gradle حِزم AAR في دليل ذاكرة التخزين المؤقت (~/.gradle/caches/...). يمكنك العثور على الرمز المصدر للغة C/C++ من خلال البحث عن prefab/modules/game-activity/include واختيار الموقع الجغرافي ضمن نسخة الإصدار المطلوبة.
للحصول على تعليمات حول الدمج باستخدام مكتبة Jetpack، يُرجى الاطّلاع على بدء استخدام GameActivity.
محتوى الرمز المصدر لمشروع Android المفتوح المصدر (AOSP)
يحتوي مشروع AOSP دائمًا على أحدث رمز مصدر. اتّبِع تعليمات الإصدار لإنشاء إصداراتك الخاصة أو دمج المصدر مباشرةً في بيئة الإصدار. يتم حفظ الرمز المصدر بلغة C/C++ في بنية ملفات مشابهة لمكتبة Jetpack.
أدلة الدمج
اتّبِع هذه الأدلة لدمج GameActivity في تطبيقاتك:
مراجع إضافية
لمزيد من المعلومات حول "GameActivity"، يُرجى الاطّلاع على ما يلي:
- ملاحظات إصدار GameActivity وAGDK
- استخدام GameTextInput في GameActivity
- دليل نقل بيانات NativeActivity
- المستندات المرجعية لـ GameActivity
- تنفيذ GameActivity:
الملاحظات
للإبلاغ عن الأخطاء أو طلب ميزات جديدة في GameActivity، استخدِم أداة تتبُّع مشاكل GameActivity.