ملاحظات الإصدار

توضّح هذه الصفحة التغييرات التي تم إجراؤها على كل إصدار من مكتبات مجموعة أدوات Android Game Development Kit (AGDK). كان اسمه "حزمة تطوير البرامج (SDK) لألعاب Android" حتى إصدار الإصدار 1.2.4.

2 حزيران (يونيو) 2023 (بين 2 حزيران/يونيو 2023)

يتضمّن هذا الإصدار العديد من إصلاحات الأخطاء.

أنشطة الألعاب

ثابت	إصلاحات متعلقة بثبات النظام في GameActivityevents

مكتبة نصائح الذاكرة لنظام التشغيل Android

ميزة	تم تحديث نموذج التعلم الآلي الذي يقود المكتبة والذي يمكن أن يسمح بنتائج محسّنة للهواتف الأحدث.

أداة Android Performance Tuner

ثابت	تم إصلاح الخطأ الذي يتسبب في تعطل المكتبة إذا كان الحد الأقصى لمفاتيح المعدات أكثر من عدد المدرج التكراري.
ميزة	تم تحديث ميزات جمع بيانات القياس عن بُعد في المكتبة، ما يسمح بإعداد تقارير أكثر دقة عن أوقات عرض اللقطات.

27 نيسان (أبريل) 2023 (27 نيسان/أبريل 2023)

يتضمّن هذا الإصدار العديد من إصلاحات الأخطاء.

أنشطة الألعاب

ثابت	تم إصلاح الإخلاء المبكر للذاكرة باستخدام oldEventTimes.
ثابت	تم إصلاح المشكلة المتعلقة بتجاوز تسلسل حدثEventTimesNanos التجاوزي على أنظمة 32 بت.

مكتبة نصائح الذاكرة لنظام التشغيل Android

ثابت	تم إصلاح خطأ كان يمنع ربط الإصدار الثابت من المكتبة بشكل صحيح.
ثابت	تم إصلاح خطأ تعذُّر في المكتبة تحميل مواد عرض TensorFlow Lite المطلوبة بشكل صحيح.

15 آذار (مارس) 2023 (15 آذار/مارس 2023)

يتضمّن هذا الإصدار الرئيسي تحديثات للنظام لإنشاء المكتبات بشكل أسرع من المصدر.

أنشطة الألعاب

تم تغييره	تم تغيير واجهة أوقات الأحداث التاريخية للتغلب على قيد 32 بت.
ميزة	تم توفير إذن وصول المستخدم إلى تغييرات الإعدادات.
ميزة	تم تحسين معظم مكالمات JNI أثناء معالجة أحداث اللمس.
ثابت	تم إصلاح المعالجة التلقائية لنظام التشغيل لأحداث اللمس، مثل التعامل مع أزرار النظام.

وحدة تحكُّم في الألعاب

ميزة	تمت إضافة إمكانية اكتشاف حالة الاتصال للوحات المفاتيح الأجهزة.
ميزة	تمت إضافة إمكانية الإبلاغ عن بيانات الحركة (مقياس التسارع/الجيروسكوب) من الجهاز الرئيسي (أي الهاتف المحمول) وكذلك من وحدات التحكّم.
تم تغييره	تم تغيير واجهة برمجة التطبيقات والتنسيق لقاعدة بيانات تعريف وحدة التحكم لتقليل بصمة الذاكرة ودعم الميزات الإضافية.

مكتبة مستوى سرعة إطار إطارات Android

ميزة	تمت إضافة إحصاءات Frame Frame من Vulkan.
ميزة	تمت إضافة واجهة برمجة تطبيقات جديدة لمحو إحصاءات الإطار.
تم تغييره	تكون جميع السجلات صامتة في وضع الإصدار، ويمكن تفعيلها في وضع تصحيح الأخطاء.

2022.0.0 (15 آذار/مارس 2022)

يتضمّن هذا الإصدار الرئيسي مكتبة نصائح الذاكرة والعديد من الإصلاحات للمكتبات الأخرى.

أنشطة الألعاب

ميزة	تمت إضافة إمكانية معالجة الأجزاء الداخلية لتحديد موضع واجهة مستخدم اللعبة حول أداة IME والقواطع.
ميزة	إضافة فلاتر الأحداث الرئيسية والأحداث المتحركة
ثابت	إصلاحات لتجنُّب فقدان أحداث الإدخال ومنع استهلاك جميع أحداث الإدخال

أداة Android Performance Tuner

تم تغييره	أصبحت تقارير الذاكرة الآن متسلسلة زمنية بدلاً من مدرجات تكرارية
ميزة	السماح بضبط الفاصل الزمني للتحميل بشكل آلي
ثابت	تم إصلاح خطأ في مفتاح واجهة برمجة التطبيقات التالف

مكتبة مستوى سرعة إطار إطارات Android

ميزة	تحسينات على الوضع التلقائي
ميزة	إضافة دوال "uninjectTracer"

مكتبة نصائح استخدام الذاكرة على Android

ميزة	تمت إضافة مكتبة نصائح الذاكرة

2021.1.0 (12 تموز/يوليو 2021)

وعندما اعتدنا على الإشارة إلى هذا المنتج باسم "حزمة تطوير البرامج لألعاب Android"، يُشار إليه الآن باسم "مجموعة تطوير ألعاب Android". يتضمّن هذا الإصدار الرئيسي عدّة مكتبات جديدة، بالإضافة إلى إصلاحات طفيفة للأخطاء في مكتبَي Android Frame Pacing وAndroid Performance Tuner.

ميزة	GameActivity هو مكوّن جديد يحل محل NativeActivity في NDK ويحسّنه.
ميزة	GameTextInput هو مكوّن جديد يعمل على تحسين التفاعل مع لوحة المفاتيح الافتراضية في Android.
ميزة	وحدة التحكّم في الألعاب هي مكوّن جديد يتيح التفاعل بسهولة مع وحدات التحكّم الخارجية وإدارتها.

1.2.4 (21 نيسان/أبريل 2021)

هذا الإصدار هو إصدار لإصلاح الأخطاء في أداة Android Performance Tuner.

أداة Android Performance Tuner

ثابت	إصلاح وقت التحميل وتسجيل المدة على الأجهزة التي تتضمّن تباينًا في CLOCK_BOOTTIME

1.2.3 (10 آذار/مارس 2021)

يضيف هذا الإصدار Oboe إلى حزمة تطوير البرامج (SDK) للألعاب. ولم نجرِ أي تغييرات على مكتبة Android Frame Pacing وأداة Android Performance Tuner.

Oboe هي مكتبة C++ مفتوحة المصدر للمحتوى الصوتي العالي الأداء على Android. يوفر Oboe واجهة برمجة تطبيقات واحدة أصلية تعمل في الإصدار Android 4.1 (المستوى 16 من واجهة برمجة التطبيقات) والإصدارات الأحدث.

1.2.2 (12 شباط/فبراير 2021)

يتضمّن هذا الإصدار تحسينات على واجهة برمجة التطبيقات الخاصة بأوقات التحميل لأداة Android Performance Tuner وإصلاح بعض الأخطاء فيها. ولن تطرأ أي تغييرات على مكتبة "معدل سرعة الإطارات" في Android.

أداة Android Performance Tuner

ميزة	يجب الآن تجميع أحداث التحميل مع الاستدعاءات إلى TuningFork_startLoadingGroup وTuningFork_stopLoadingGroup.
ثابت	يؤدي طلب TuningFork_flush إلى تحميل البيانات على الفور بدلاً من وضعها في قائمة الانتظار لتحميلها لاحقًا.
ثابت	تعذّر التحميل المتقطّع بسبب تنسيق JSON للوقت.
ثابت	مشكلة في التحميلات على إصدارات الإصدار.

1.2.1 (16 كانون الأول/ديسمبر 2020)

هذا الإصدار هو إصدار ميزة داخلي لأداة Android Performance Tuner وإعلان ترويجي لمكتبات Jetpack من الإصدار الأولي إلى الإصدار التجريبي. ولن يتم إجراء أي تغييرات على واجهات برمجة التطبيقات لميزة "معدل سرعة الإطارات في Android" أو واجهات برمجة التطبيقات Android Performance Tuner.

يُرجى العلم أنّه يجب الآن الإشارة إلى مكتبات حزمة تطوير البرامج (SDK) للألعاب بشكل فردي عند الربط بها، بدلاً من الربط بمكتبة "gameSDK" العامة. راجِع إعدادات التصميم لكل من Android Frame Pacing: OpenGL وAndroid Frame Pacing: Vulkan وAndroid Performance Tuner.

أداة Android Performance Tuner

ميزة	عندما يخلفية أحد اللاعبين لعبة أثناء تحميلها، يتم إرسال حدث لإجراء تحليل لاحق حول معدّل المغادرة أثناء التحميل.

1.2.0 (29 تشرين الأول (أكتوبر) 2020)

يتمثل التغيير الرئيسي في هذا الإصدار في إضافة آلية لتسجيل أوقات التحميل. هناك أيضًا بعض إصلاحات الأخطاء. تجدر الإشارة إلى أنّ حزمة تطوير البرامج (SDK) للألعاب متوفّرة الآن عبر مكتبة AGDK Libraries Jetpack.

مكتبة مستوى سرعة إطار إطارات Android

ميزة	إتاحة التبديل بين معدّل التحديث في الوضع التلقائي يُرجى العِلم أنّه لإتاحة معدّلات التحديث المتعدّدة في Android 11، سواء كنت تستخدم الوضع التلقائي أم لا، يجب استدعاء SwappyGL_setWindow أو SwappyVk_setWindow.
ثابت	إصلاحات أخطاء الوضع التلقائي
ثابت	إصلاح أخطاء Vulkan.

أداة Android Performance Tuner

ميزة	أوقات التحميل يجب استدعاء الدالتَين الجديدتَين TuningFork_startRecordingLoadingTime وTuningFork_stopRecordingLoadingTime لتسجيل أحداث مدّة التحميل التي تتضمّن تعليقات توضيحية. يتم تلقائيًا تسجيل الوقت المستغرَق بين بدء تشغيل التطبيق وTuningFork_init
تم تغييره	إنّ الطريقة السابقة لضبط التعليق التوضيحي لوقت التحميل لن تعود صالحة.
ميزة	أحداث مراحل النشاط يجب استدعاء TuningFork_reportLifecycleEvent إلى لغة Java onCreate المناسبة وما إلى ذلك. يؤدي ذلك إلى تفعيل إعداد تقارير تفصيلية عن الأعطال من داخل أداة Android Performance Tuner.
تم تغييره	يتم الآن تسجيل المزيد من مقاييس الذاكرة عند طلب TuningFork_enableMemoryRecording(true).
تم تغييره	تغيير نموذج الذاكرة يتم الآن تحديد أقصى عدد من المقاييس من كل نوع عند بدء التشغيل، بدلاً من تخصيص مساحة لكل المجموعات المحتمَلة للتعليقات التوضيحية. يمكنك الاطّلاع على TuningFork_MetricLimits في tuningfork.h.
ثابت	لا يتم التحميل عبر الاتصالات التي تفرض تكلفة استخدام.

1.1.0 (10 حزيران (يونيو) 2020)

يشتمل هذا الإصدار من مكتبات AGDK على تقارير المقاييس Android Performance Tuner ومكتبة ضبط الجودة (المعروفة أيضًا باسم "الشوكة الرنانة"). تتوفّر هذه المكتبة لمحرّكات الألعاب الأصلية بالإضافة إلى Unity، وهي تتضمّن الميزات التالية:

ميزة	الدمج مع مكتبة سرعة عرض الإطارات في Android لتسجيل أوقات عرض اللقطات ومقاييس العرض الأخرى تلقائيًا
ميزة	يتم تسجيل معلومات توقيت الإطار في المدرجات التكرارية وتحميلها بشكل دوري.
ميزة	تعليق توضيحي لبيانات التوقيت مع حالة اللعبة الحالية
ميزة	يتم تحميل خصائص الجهاز والتعليقات التوضيحية وإعدادات الجودة مع بيانات التوقيت للسماح بتحليل المقاطع العرضية.
ميزة	تمثّل هذه السمة معالجة خاصة للتعليقات التوضيحية التي تشير إلى وقت التحميل في المستوى. لا يتم تسجيل بيانات مؤشر الإطار أثناء التحميل، ولكن يتم تسجيل مدة كل فترة تحميل.
ميزة	إمكانية تسجيل معلومات توقيت مخصّص (باستخدام startTrace وendTrace)

1.0.2 (30 آذار (مارس) 2020)

يتضمّن هذا الإصدار إصلاحات للأخطاء وتغييرات في سلوك الوضع التلقائي.

ثابت	إصلاح الأخطاء لإتلاف عملية التبديل وإعادة الإعداد
تم تغييره	تكون عملية مسارات التعلّم مفعَّلة الآن بشكل تلقائي. إذا كان التدفق التلقائي قيد التشغيل، لا يزال بإمكان Swappy أن يقرر إيقافه عندما يكون عبء العمل منخفضًا جدًا.
تم تغييره	عندما يكون الوضع التلقائي مفعَّلاً، لن يقرّر تطبيق Swappy تبديل فاصل التبديل إلا بعد أن يصبح% 15 من اللقطات خلال فترة ثانيتين أسرع أو أبطأ من المتوقّع. تجدر الإشارة إلى أنّ التبديل لن يكون أبطأ من فاصل التبديل الذي يحدده المستخدم.

1.0.1 (19 شباط (فبراير) 2020)

هذا الإصدار هو في الأساس إصدار لإصلاح الأخطاء.

ثابت	إخلاء الموارد على مسار الرمز SwappyFallback في Vulkan
ثابت	لن تتلف SwappyVk_destroySwapchain موارد الجهاز بعد الآن في حال توفُّر أكثر من سلسلة تبديل واحدة.
ثابت	تمت الآن طباعة نسخة التبديل إلى logcat.
ثابت	الأعطال والعوائق في Swappy_destroy للمستوى 24 من واجهة برمجة التطبيقات والمستويات الأدنى
ميزة	إتاحة مدراء سلاسل المحادثات المخصّصة (Swappy_setThreadFunctions)
ميزة	إتاحة ربط دوال Vulkan (SwappyVk_setFunctionProvider).

1.0.0 (5 كانون الأول/ديسمبر 2019)

يشمل هذا الإصدار الأولي من مكتبات AGDK مكتبة Android Frame Pacing.

ميزة	عرض مزامنة المخزن المؤقت
ميزة	وضع معدَّل إعادة التحميل التلقائي ودعم معالجة البيانات
ميزة	مجموعة من إحصاءات عرض اللقطات
ميزة	الاختيار السلس للسلوك في وقت التشغيل، استنادًا إلى توفُّر ميزات Android و OpenGL وVulkan التي تحتاج إليها Swappy.
ميزة	يشير ذلك المصطلح إلى الربط الثابت والديناميكي للمكتبة.
ميزة	دعم الأجهزة ذات معدلات التحديث المتعددة.