‫GameActivity   جزء من حزمة تطوير ألعاب Android.

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

alt_text

كما هو موضّح في المخطّط البياني السابق، يؤدي GameActivity الوظائف التالية:

  • التفاعل مع إطار عمل Android من خلال مكوّن Java
  • تمرير أوامر دورة التطبيق وأحداث الإدخال ونص الإدخال إلى الجانب الأصلي
  • نمذجة الرمز المصدر لـ C/C++‎ إلى ثلاثة مكوّنات منطقية:
    • دوال JNI في GameActivity، والتي تتيح استخدام وظائف Java في GameActivity مباشرةً وتضع الأحداث في قائمة انتظار native_app_glue.
    • native_app_glue، والذي يعمل في الغالب في سلسلة التعليمات الأصلية الخاصة به (تختلف عن سلسلة التعليمات الرئيسية للتطبيق)، وينفّذ المهام باستخدام الحلقة الخاصة به.
    • رمز اللعبة في التطبيق، والذي يستطلع الأحداث في قائمة الانتظار داخل native_app_glue ويعالجها وينفّذ رمز اللعبة ضمن سلسلة التعليمات البرمجية native_app_glue.

باستخدام 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 في القنوات التالية:

يتم توفير رمز 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، استخدِم أداة تتبُّع مشاكل GameActivity.