ألعاب Android
لمزيد من المعلومات عن حزمة SDK لألعاب Android، راجِع مستندات حزمة SDK وملاحظات إصدار حزمة SDK.
يسرد هذا الجدول جميع العناصر في مجموعة androidx.games
.
العناصر | الإصدار الثابت | إصدار مرشح | الإصدار التجريبي | الإصدار التجريبي الأول |
---|---|---|---|---|
أنشطة الألعاب | 3.0.5 | - | 4.0.0-beta01 | - |
games-controller | 2.0.2 | - | - | - |
games-frame-pacing | 2.1.2 | - | - | - |
games-memory-advice | 2.0.1 | - | 2.1.0-beta01 | - |
games-text-input | 3.0.4 | - | 4.0.0-beta01 | - |
games-performance-tuner | 2.0.0 | - | - | - |
المتطلبات
games-memory-advice
تتطلّب واجهة برمجة التطبيقات MemoryAdvice API إنشاء تطبيقك باستخدام الإصدار r23.* من حزمة NDK أو إصدار أحدث.
الإعلان عن التبعيات
لإضافة تبعية على اللعبة، يجب إضافة مستودع Google Maven إلى مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.
أضِف الملحقات للعناصر التي تحتاج إليها في ملف build.gradle
ل
تطبيقك أو وحدتك. لقد دمجت مكتبة games-activity
الإصدار نفسه من مكتبة
game-text-input
، وبالتالي لا يمكن لتطبيقات GameActivity
تضمين الملحق
game-text-input
مرة أخرى:
Groovy
android { ... // To use the Android Frame Pacing or Android Performance Tuner libraries, enable // native dependencies to be imported. Libraries will be made available to your CMake build // as packages named "games-frame-pacing" and "games-performance-tuner". buildFeatures { prefab true } } dependencies { // To use the Android Frame Pacing library implementation "androidx.games:games-frame-pacing:2.1.2" // To use the Android Performance Tuner implementation "androidx.games:games-performance-tuner:2.0.0" // To use the Games Activity library implementation "androidx.games:games-activity:3.0.5" // To use the Games Controller Library implementation "androidx.games:games-controller:2.0.2" // To use the Games Text Input Library // Do not include this if games-activity has been included implementation "androidx.games:games-text-input:3.0.4" }
Kotlin
android { ... // To use the Android Frame Pacing or Android Performance Tuner libraries, enable // native dependencies to be imported. Libraries will be made available to your CMake build // as packages named "games-frame-pacing" and "games-performance-tuner". buildFeatures { prefab = true } } dependencies { // To use the Android Frame Pacing library implementation("androidx.games:games-frame-pacing:2.1.2") // To use the Android Performance Tuner implementation("androidx.games:games-performance-tuner:2.0.0") // To use the Games Activity library implementation("androidx.games:games-activity:3.0.5") // To use the Games Controller Library implementation("androidx.games:games-controller:2.0.2") // To use the Games Text Input Library // Do not include this if games-activity has been included implementation("androidx.games:games-text-input:3.0.4") } }
لمزيد من المعلومات عن العناصر الاعتمادية، راجِع مقالة إضافة عناصر الاعتماد الخاصة بالإصدار.
إضافة سمات Gradle
قد تحتاج إلى إضافة خصائص إلى ملف gradle.properties
في الدليل
نفسه الذي يتضمّن ملف build.gradle
الخاص بتطبيقك (أو الوحدة). إذا لم يكن ملف
gradle.properties
متوفّرًا، أنشئ هذا الملف.
إذا كنت تستخدم الإصدار 4.0 من Android Studio، تأكَّد من أنّ gradle.properties
يحتوي على
السطور التالية:
# Enables experimental Prefab
android.enablePrefab=true
# Tell Android Studio we are using AndroidX
android.useAndroidX=true
إذا كنت تستخدم الإصدار 4.1 من Android Studio أو إصدارًا أحدث، تأكَّد من أنّ gradle.properties
يتضمّن الأسطر التالية:
# Tell Android Studio we are using AndroidX
android.useAndroidX=true
إضافة الحِزم باستخدام CMake
لإتاحة حِزم تطوير البرامج (SDK) المستورَدة لألعاب Android، أضِف ما يلي إلىملف CMakeLists.txt
في تطبيقك الرئيسي:
# Add the packages from the Android Game SDK
find_package(games-frame-pacing REQUIRED CONFIG)
find_package(games-performance-tuner REQUIRED CONFIG)
سيتيح لك ذلك تضمين ملفات الرأس من حزمة SDK لألعاب Android في رمز اللعبة:
#include "swappy/swappyGL.h"
#include "tuningfork/tuningfork.h"
في ملف CMakeLists.txt
الخاص بالتطبيق الرئيسي، ابحث عن target_link_libraries
لملف
المكتبة المشترَكة الرئيسية. أضِف الإشارات إلى المكتبات الثابتة لمجموعة تطوير البرامج (SDK) لألعاب Android
لتضمينها في مكتبتك المشتركة:
target_link_libraries(...
games-frame-pacing::swappy_static
games-performance-tuner::tuningfork_static
...)
ملاحظات
تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا واجهت مشاكل جديدة أو كان لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.
اطّلِع على مستندات أداة تتبُّع المشاكل لمزيد من المعلومات.
الإصدار 2.1 من Games-Memory-Advice
الإصدار 2.1.0-beta01
29 تشرين الثاني (نوفمبر) 2023
تم تحرير androidx.games:games-memory-advice:2.1.0-beta01
. يحتوي الإصدار 2.1.0-beta01 على هذه المراجعات.
الإصدار 2.1.0-alpha01
15 تشرين الثاني (نوفمبر) 2023
تم تحرير androidx.games:games-memory-advice:2.1.0-alpha01
. يحتوي الإصدار 2.1.0-alpha01 على هذه المراجعات.
الميزات الجديدة
- تم تعديل نموذج الذاكرة في المكتبة لتقديم توقّعات أفضل.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة واجهة برمجة تطبيقات جديدة
getAvailableMemory()
تعرض تقديرًا لكمية الذاكرة التي يمكن تخصيصها بأمان، بالكيلوبايت.
الإصدار 2.1.0-alpha01
26 تموز (يوليو) 2023
تم تحرير androidx.games:games-memory-advice:2.1.0-alpha01
. يحتوي الإصدار 2.1.0-alpha01 على هذه المراجعات.
تغييرات واجهة برمجة التطبيقات
- إضافة دالة
GetAvailableMemory
إصلاح الأخطاء
- تعديل نموذج "نصائح بشأن الذاكرة"
- إصلاح استهداف الإصدار المشترك من
memory_advice
Games-Memory-Advice version 2.0
الإصدار 2.0.1
20 أيلول (سبتمبر) 2023
تم تحرير androidx.games:games-memory-advice:2.0.1
. يحتوي الإصدار 2.0.1 على هذه المراجعات.
إصلاح الأخطاء
- إصلاح العُطل الذي يحدث في سلسلة مراقِبي الحالة بسبب عدم إرفاق السلسلة بآلة Java الافتراضية
الإصدار 2.0.0
6 أيلول (سبتمبر) 2023
تم تحرير androidx.games:games-memory-advice:2.0.0
. يحتوي الإصدار 2.0.0 على هذه المراجعات.
الميزات الرئيسية في الإصدار 2.0.0
- تم تدريب نموذج تعلُّم آلي جديد وإصداره في هذا الإصدار.
- تمّ تنفيذ واجهة برمجة تطبيقات لتوقع مقدار الذاكرة المتوفّرة.
الإصدار 2.0.0-rc01
26 تموز (يوليو) 2023
تم تحرير androidx.games:games-memory-advice:2.0.0-rc01
. يحتوي الإصدار 2.0.0-rc01 على هذه المراجعات.
الميزات الجديدة
- تم تضمين نموذج جديد لتوقّع المساحة المتبقية في الذاكرة بشكل أفضل.
إصلاح الأخطاء
- لا تعمل نصائح الذاكرة الثابتة مع ملف STL مشترَك.
الإصدار 2.0.0-beta04
24 أيار (مايو) 2023
تم تحرير androidx.games:games-memory-advice:2.0.0-beta04
. يحتوي الإصدار 2.0.0-beta04 على هذه المراجعات.
الميزات الجديدة
- تم تعديل نموذج تعلُّم الآلة الذي يشغّل المكتبة، ما سيؤدي إلى تحسين النتائج على الهواتف الأحدث.
الإصدار 2.0.0-beta03
5 نيسان (أبريل) 2023
تم تحرير androidx.games:games-memory-advice:2.0.0-beta03
. يحتوي الإصدار 2.0.0-beta03 على هذه المراجعات.
إصلاح الأخطاء
- تم إصلاح خلل تعذّر فيه على المكتبة تحميل مواد عرض tensorflow lite المطلوبة بشكل صحيح.
الإصدار 2.0.0-beta02
22 آذار (مارس) 2023
تم تحرير androidx.games:games-memory-advice:2.0.0-beta02
. يحتوي الإصدار 2.0.0-beta02 على هذه المراجعات.
إصلاح الأخطاء
- تم إصلاح خلل كان يمنع ربط الإصدار الثابت من المكتبة بشكل صحيح.
الإصدار 2.0.0-beta01
22 شباط (فبراير) 2023
تم تحرير androidx.games:games-memory-advice:2.0.0-beta01
. يحتوي الإصدار 2.0.0-beta01 على هذه المراجعات.
الميزات الجديدة
- ما مِن تغييرات جديدة
الإصدار 2.0.0-alpha01
8 شباط (فبراير) 2023
تم تحرير androidx.games:games-memory-advice:2.0.0-alpha01
. يحتوي الإصدار 2.0.0-alpha01 على هذه المراجعات.
تغييرات واجهة برمجة التطبيقات
- زيادة كبيرة في الإصدار بسبب إعادة تنظيم ملفات التصميم
إصلاح الأخطاء
- يؤدي الآن ضبط إعدادات غير صحيحة لمواد عرض المكتبة إلى ظهور خطأ بدلاً من حدوث تعذّر.
الإصدار 1.0.0 من Games-Memory-Advice
الإصدار 1.0.0-beta03
9 تشرين الثاني (نوفمبر) 2022
تم تحرير androidx.games:games-memory-advice:1.0.0-beta03
. يحتوي الإصدار 1.0.0-beta03 على هذه المراجعات.
الميزات الجديدة
- ما مِن تغييرات جديدة
الإصدار 1.0.0-beta01
9 آذار (مارس) 2022
تم تحرير androidx.games:games-memory-advice:1.0.0-beta01
. يحتوي الإصدار 1.0.0-beta01 على هذه المراجعات.
- لم يتم إجراء أي تغييرات منذ الإصدار 1.0.0-alpha01.
الإصدار 1.0.0-alpha01
23 شباط (فبراير) 2022
تم تحرير androidx.games:games-memory-advice:1.0.0-alpha01
. يحتوي الإصدار 1.0.0-alpha01 على هذه المراجعات.
الميزات الجديدة
- توفّر مكتبة C هذه إمكانية الاستعلام عن التغييرات في حالة الذاكرة لجهاز يشغّل لعبة وتلقّي إشعارات بشأنها.
تغييرات واجهة برمجة التطبيقات
- هذا هو الإصدار الأولي من مكتبة نصائح الذاكرة. اطّلِع على العنوان في include/memory_advice/memory_advice.h للحصول على واجهة برمجة التطبيقات الكاملة.
المساهمة الخارجية
- تعتمد المكتبة على tensorflow، ويمكن العثور على ترخيصها وترخيص الموارد التابعة غير المباشرة على الرابط https://github.com/tensorflow/tensorflow.
الإصدار 3.0 من Games-Text-Input
الإصدار 3.0.4
7 آب (أغسطس) 2024
تم تحرير androidx.games:games-text-input:3.0.4
. يتضمّن الإصدار 3.0.4 عمليات الربط هذه.
إصلاح الأخطاء
- تم إصلاح وظيفة الحذف مع اختيار النص أو بدونه.
الإصدار 4.0 من أنشطة الألعاب
الإصدار 4.0.0-beta01
15 كانون الثاني (يناير) 2025
تم إصدار androidx.games:games-activity:4.0.0-beta01
وandroidx.games:games-text-input:4.0.0-beta01
. يتضمّن الإصدار 4.0.0-beta01 عمليات الربط هذه.
إصلاح الأخطاء
- تحسين مستندات الوظائف ذات الصلة باللغة التي تمت إضافتها حديثًا
- تمت إضافة أنواع العناصر الأساسية إلى جميع أنواع التعدادات.
الإصدار 4.0.0-alpha01
16 تشرين الأول (أكتوبر) 2024
تم إصدار androidx.games:games-activity:4.0.0-alpha01
وandroidx.games:games-text-input:4.0.0-alpha01
. يتضمّن الإصدار 4.0.0-alpha01 عمليات الربط هذه.
الميزات الجديدة
- يتيح
GameTextInput
الآن استخدام مفتاحَي السهمَين لليسار/اليمين.
تغييرات واجهة برمجة التطبيقات
- تمت إزالة واجهات Java القديمة من
GameTextInput
. - تتضمّن الآن التصاميم الجاهزة لكلٍّ من
GameActivity
وGameTextInput
جميع ملفات المصدر. لم تعُد#include <GameActivity.cpp>
مقترَحة بعد الآن. يُرجى الربط بمكتبة ثابتة أو ديناميكية مناسبة بدلاً من ذلك، مثلgame-activity::game-activity_static
فيCMake
. ويتم شحن هذه المكتبات في ملف AAR.
إصلاح الأخطاء
- تم إجراء العديد من الإصلاحات في
GameTextInput
. تم إصلاح وظيفة الكتابة والإزالة. - تم تحسين التوافق مع معظم لوحات المفاتيح البرمجية الرائجة.
- تم إصلاح مشكلة التعامل مع الأحرف الخاصة على لوحات المفاتيح الخارجية.
- تم إصلاح خطأ نادر في الوصول إلى مؤشر فارغ في
GameActivity
.
الإصدار 3.0 من أنشطة الألعاب
الإصدار 3.0.5
7 آب (أغسطس) 2024
تم تحرير androidx.games:games-activity:3.0.5
. يتضمّن الإصدار 3.0.5 عمليات الربط هذه.
إصلاح الأخطاء
- إصدار جديد من
GameActivity
لمطابقة الإصدار 3.0.4 منGameTextInput
(تم إصلاح وظيفة حذف النص في الإدخالات).
الإصدار 3.0.4
10 تموز (يوليو) 2024
تم تحرير androidx.games:games-activity:3.0.4
. يحتوي الإصدار 3.0.4 على عمليات الربط هذه.
إصلاح الأخطاء
- تم إصلاح معالجة المؤشرات غير الصالحة.
- تم إصلاح عدم توفّر تعديلات الحالة لبعض الحالات في طلب إعادة الاتصال
onConfiguration()
.
الإصدار 3.0.3
17 نيسان (أبريل) 2024
تم إصدار androidx.games:games-activity:3.0.3
وandroidx.games:games-text-input:3.0.3
. يحتوي الإصدار 3.0.3 على عمليات الربط هذه.
إصلاح الأخطاء
- تم إصلاح مشاكل التوافق مع بعض لوحات المفاتيح البرمجية.
الإصدار 3.0.2
3 نيسان (أبريل) 2024
تم إصدار androidx.games:games-activity:3.0.2
وandroidx.games:games-text-input:3.0.2
. يتضمّن الإصدار 3.0.2 عمليات الربط هذه.
إصلاح الأخطاء
- أجرينا العديد من الإصلاحات على
GamesTextInput
بهدف تحسين توافق لوحات المفاتيح البرمجية والأجهزة. تم أيضًا إصلاح خلل كان يمنع استخدامGameTextInput
بدونGameActivity
.
الإصدار 3.0.1
20 مارس 2024
تم إصدار androidx.games:games-activity:3.0.1
وandroidx.games:games-text-input:3.0.1
. يتضمّن الإصدار 3.0.1 عمليات الربط هذه.
إصلاح الأخطاء
- تم إصلاح مشكلة في الكتابة وعرض الأحرف الخاصة.
الإصدار 3.0.0
6 مارس 2024
تم إصدار androidx.games:games-activity:3.0.0
وandroidx.games:games-text-input:3.0.0
. يتضمّن الإصدار 3.0.0 عمليات الربط هذه.
الميزات الرئيسية في الإصدار 3.0.0
- تم تعديل
GameTextInput
ليصبح جاهزًا للاستخدام في الألعاب. - تم تغيير بعض الواجهات في كلتا المكتبتَين مقارنةً بالإصدار 2.0.0.
إصلاح الأخطاء
- تم إصلاح مشاكل التوافق مع حِزم NDK القديمة.
- تم إصلاح مشاكل تجميع نظام التشغيل Windows
الإصدار 3.0.0-rc01
21 شباط (فبراير) 2024
تم إصدار androidx.games:games-activity:3.0.0-rc01
وandroidx.games:games-text-input:3.0.0-rc01
. يحتوي الإصدار 3.0.0-rc01 على هذه المراجعات.
إصلاح الأخطاء
- تم إصلاح مشكلة التجميد التي كانت تحدث عندما لا يعالج أداة تكرار المحتوى أحداث لوحة المفاتيح بشكلٍ صحيح.
الإصدار 3.0.0-beta01
29 تشرين الثاني (نوفمبر) 2023
تم إصدار androidx.games:games-activity:3.0.0-beta01
وandroidx.games:games-text-input:3.0.0-beta01
. يحتوي الإصدار 3.0.0-beta01 على هذه المراجعات.
الإصدار 3.0.0-alpha01
15 تشرين الثاني (نوفمبر) 2023
تم إصدار androidx.games:games-activity:3.0.0-alpha01
وandroidx.games:games-text-input:3.0.0-alpha01
. يحتوي الإصدار 3.0.0-alpha01 على هذه المراجعات.
تغييرات واجهة برمجة التطبيقات
- تغيّرت أحجام العنصرَين
GameActivityMotionEvent
وGameActivityCallbacks
. - تغيّر
onEditorAction
نوع الإرجاع من منطقي إلى فارغ. - يقبل
setImeEditorInfo
الآن مَعلمات enum، وليس الأعداد الصحيحة. - يتم نقل الدوال الداخلية في
GameActivityEvents
إلىGameActivityEvents_internal.h
. - أنواع الإدخال في
GameTextInput
هي أيضًا تعدادات، وليست أعدادًا صحيحة.
الإصدار 2.1 من أنشطة الألعاب
الإصدار 2.1.0-alpha02
6 أيلول (سبتمبر) 2023
تم إصدار androidx.games:games-activity:2.1.0-alpha02
وandroidx.games:games-text-input:2.1.0-alpha02
. يحتوي الإصدار 2.1.0-alpha02 على هذه المراجعات.
إصلاح الأخطاء
- تم تحسين توافق الأجهزة التي تعمل بنظام 32 بت.
الإصدار 2.1.0-alpha01
26 تموز (يوليو) 2023
تم تحرير androidx.games:games-activity:2.1.0-alpha01
. يحتوي الإصدار 2.1.0-alpha01 على هذه المراجعات.
الميزات الجديدة
- توفير إمكانية إلغاء إنشاء مثيل
SurfaceView
- إضافة ميزة الإبلاغ عن إصدار حزمة SDK
تغييرات واجهة برمجة التطبيقات
- استخدِم
int64_t
بدلاً منlong
لـhistoricalEventTimes
لتجنُّب تجاوز الحدّ الأقصى المسموح به في الأنظمة التي تعمل بنظام 32 بت. - إضافة طريقة
GameActivity_restartInput
- إضافة دالة استدعاء أصلية للتعامل مع تغيير مستوى ظهور لوحة المفاتيح
إصلاح الأخطاء
- تحسين معالجة أحداث اللمس
- تصحيح عملية تدمير
GameActivityMotionEven
- تصحيح عملية احتساب مؤشر
GameActivityMotionEvent_getHistoricalAxisValue
- إصلاح أقنعة الوحدات لفلتر الحركة
الإصدار 2.0 من ميزة "أنشطة الألعاب"
الإصدار 2.0.2
24 أيار (مايو) 2023
تم تحرير androidx.games:games-activity:2.0.2
. يحتوي الإصدار 2.0.2 على هذه المراجعات.
إصلاح الأخطاء
- إصلاحات لتحسين الثبات في الإصدار
GameActivityEvents
(b/278017467)
الإصدار 2.0.1
5 نيسان (أبريل) 2023
تم تحرير androidx.games:games-activity:2.0.1
. يحتوي الإصدار 2.0.1 على هذه المراجعات.
إصلاح الأخطاء
- تم إصلاح مشكلة إخلاء الذاكرة مبكرًا باستخدام
historicalEventTimes
. - تم إصلاح مشكلة تدفّق
historicalEventTimesNanos
على الأنظمة التي تعمل بنظام 32 بت
الإصدار 2.0.0
8 آذار (مارس) 2023
تم تحرير androidx.games:games-activity:2.0.0
. يحتوي الإصدار 2.0.0 على هذه المراجعات.
الميزات الرئيسية في الإصدار 2.0.0
- تم تغيير واجهة أوقات الأحداث السابقة للتغلب على الحد الأقصى الذي يبلغ 32 بت.
- السماح للمستخدم بالوصول إلى تغييرات الضبط، مثل الاتجاه
- تقديم معلومات محدّثة في بنية
contentRect
- توفير طريقة أسهل لتخصيص
SurfaceView
التلقائي - تم إصلاح معالجة النظام التلقائية لأحداث اللمس، مثل معالجة أزرار النظام.
- تم تحسين معظم طلبات JNI في معالجة أحداث اللمس، وكان هذا يؤثر في الأداء.
الإصدار 2.0.0-rc01
22 شباط (فبراير) 2023
تم تحرير androidx.games:games-activity:2.0.0-rc01
. يحتوي الإصدار 2.0.0-rc01 على هذه المراجعات.
الإصدار 2.0.0-beta01
8 شباط (فبراير) 2023
تم تحرير androidx.games:games-activity:2.0.0-beta01
. يحتوي الإصدار 2.0.0-beta01 على هذه المراجعات.
إصلاح الأخطاء
- تم إصلاح معالجة أزرار النظام. (2a103e)
الإصدار 2.0.0-alpha01
11 كانون الثاني (يناير) 2023
تم طرح الإصدار androidx.games:games-activity:2.0.0-alpha01
بدون أي تغييرات. يحتوي الإصدار 2.0.0-alpha01 على هذه المراجعات.
الإصدار 1.2 من أنشطة الألعاب
الإصدار 1.2.2
7 كانون الأول (ديسمبر) 2022
تم تحرير androidx.games:games-activity:1.2.2
. يحتوي الإصدار 1.2.2 على عمليات الربط هذه.
إصلاح الأخطاء
- يمكن الآن ضبط الحد الأقصى لعدد أحداث الحركة أثناء التشغيل.
الإصدار 1.2.2-alpha01
9 تشرين الثاني (نوفمبر) 2022
تم تحرير androidx.games:games-activity:1.2.2-alpha01
. يحتوي الإصدار 1.2.2-alpha01 على هذه المراجعات.
تغييرات واجهة برمجة التطبيقات
- تحتوي واجهة برمجة التطبيقات الآن أيضًا على معلومات الإصدار في شكل
GAMEACTIVITY_PACKED_VERSION
. (I287e6) - تمت إضافة دالة الاستدعاء
onContentRectChanged
التي يتمّ استدعاؤها عند تغيير المستطيل في النافذة التي يجب وضع المحتوى فيها. (I81396)
إصلاح الأخطاء
- تم إصلاح مشكلة حصول حدث تدفّق بيانات في المخزن المؤقت. أصبح كلّ من
inputBuffer
->keyEvents
وmotionEvents
الآن ذاكرتَي تخزين مخصّصتَين ديناميكيًا. (Ic00f6) - تتوقف هذه العملية بشكل سلس في حال نفاذ الذاكرة. تمت إضافة معالجة أخطاء
realloc()
أثناء تغيير حجم المخزن المؤقت.
الإصدار 1.2.1
13 تموز (يوليو) 2022
تم تحرير androidx.games:games-activity:1.2.1
. يحتوي الإصدار 1.2.1 على عمليات الربط هذه.
إصلاح الأخطاء
- تم حلّ المشاكل المتعلّقة بملف .aar غير المتوفّر في الإصدار السابق.
الإصدار 1.2.0
15 حزيران (يونيو) 2022
تم تحرير androidx.games:games-activity:1.2.0
. يحتوي الإصدار 1.2.0 على هذه المراجعات.
التغييرات المهمة منذ الإصدار 1.1.0
- اسمح للفئات المشتقة من GameActivity بمعالجة تحميل المكتبة الأصلية.
- حمِّل المكتبة الأصلية دائمًا في GameActivity.onCreate.
- الرجوع إلى تحميل المكتبة التي تحمل الاسم "main" في حال عدم العثور على مكتبة أخرى
الإصدار 1.1 من الأنشطة في الألعاب
الإصدار 1.1.0
23 شباط (فبراير) 2022
تم إصدار androidx.games:games-activity:1.1.0
وandroidx.games:games-controller:1.1.0
. يحتوي الإصدار 1.1.0 على عمليات الربط هذه.
التغييرات المهمة منذ الإصدار 1.0.0
أنشطة الألعاب:
- الاستماع إلى WindowInsets وطلبات البحث عن الاستجابة للشاشة المُثقوبة ومحرِّر أسلوب الإدخال (IME)
- إضافة فلاتر أحداث الحركة والعناصر الرئيسية
- إصلاح الأخطاء:
- إضافة الرسائل غير المتوفّرة للتوافق مع NativeActivity
- إصلاح توقيع onNativeWindowResized
- إصلاح حالات فقدان أحداث الإدخال
الإصدار 1.1.0-rc01
9 شباط (فبراير) 2022
تم إصدار androidx.games:games-activity:1.1.0-rc01
وandroidx.games:games-controller:1.1.0-rc01
. يحتوي الإصدار 1.1.0-rc01 على هذه المراجعات.
الإصدار 1.1.0-beta03
26 كانون الثاني (يناير) 2022
تم تحرير androidx.games:games-activity:1.1.0-beta03
. يحتوي الإصدار 1.1.0-beta03 على هذه المراجعات.
إصلاح الأخطاء
- حلّ مشكلة توقيع
onNativeWindowResized
- الحفاظ على مقبض النافذة الأصلية في
onSurfaceChanged
الإصدار 1.1.0-beta02
15 كانون الأول (ديسمبر) 2021
تم تحرير androidx.games:games-activity:1.1.0-beta02
. يحتوي الإصدار 1.1.0-beta02 على هذه المراجعات.
إصلاح الأخطاء
- حلّ مشكلة تداخل المهام في إعداد فلتر الأحداث
الإصدار 1.1.0-beta01
17 تشرين الثاني (نوفمبر) 2021
تم تحرير androidx.games:games-activity:1.1.0-beta01
. يحتوي الإصدار 1.1.0-beta01 على هذه المراجعات.
الميزات الجديدة
- تمت إضافة إمكانية طلب معلومات عن الأجزاء المضمّنة في النوافذ والاستماع إلى التغييرات في هذه الأجزاء. يتيح ذلك للألعاب الاستجابة لظهور واجهة IME المنبثقة والتعامل مع العناصر المضمّنة في وضع "العرض بدون انقطاع" وفتحات الكاميرا.
تغييرات واجهة برمجة التطبيقات
void GameActivity_getWindowInsets(GameActivity* activity, enum GameCommonInsetsType type, GameCommonInsets* insets);
إصلاح الأخطاء
- تجنَّب استخدام جميع الأحداث الرئيسية: يتم الآن تمرير مستوى الصوت والكاميرا وما إلى ذلك إلى النظام.
الإصدار 1.1.0-alpha01
29 أيلول (سبتمبر) 2021
تم تحرير androidx.games:games-activity:1.1.0-alpha01
. يحتوي الإصدار 1.1.0-alpha01 على هذه المراجعات.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة طلب معاودة الاتصال من
onContentRectChanged
إلىGameActivityCallbacks
إصلاح الأخطاء
- تمّت إضافة رسائل مفقودة إلى android_native_app_glue.h:
APP_CMD_CONTENT_RECT_CHANGED
APP_CMD_WINDOW_REDRAW_NEEDED
أداة Games Performance Tuner 2.0
الإصدار 2.0.0
7 آب (أغسطس) 2024
تم تحرير androidx.games:games-performance-tuner:2.0.0
. يحتوي الإصدار 2.0.0 على عمليات الربط هذه.
الميزات الرئيسية في الإصدار 2.0.0
- لم يتم إجراء أي تغييرات كبيرة منذ الإصدار 2.0.0beta01، ونحن بصدد تصنيف هذا الإصدار على أنّه مستقر.
الإصدار 2.0.0-beta01
10 كانون الثاني (يناير) 2024
تم إصدار الإصدار androidx.games:games-performance-tuner:2.0.0-beta01
بدون أي تغييرات عن الإصدار التجريبي الأخير. يحتوي الإصدار 2.0.0-beta01 على هذه المراجعات.
الإصدار 2.0.0-alpha07
29 تشرين الثاني (نوفمبر) 2023
تم تحرير androidx.games:games-performance-tuner:2.0.0-alpha07
. يحتوي الإصدار 2.0.0-alpha07 على هذه المراجعات.
إصلاح الأخطاء
- إصلاح مشكلة ظهور قيم غير صحيحة في تقارير قياس أداء الذاكرة أحيانًا
الإصدار 2.0.0-alpha06
1 تشرين الثاني (نوفمبر) 2023
تم تحرير androidx.games:games-performance-tuner:2.0.0-alpha06
. يحتوي الإصدار 2.0.0-alpha06 على هذه المراجعات.
الإصدار 2.0.0-alpha05
23 آب (أغسطس) 2023
تم تحرير androidx.games:games-performance-tuner:2.0.0-alpha05
. يحتوي الإصدار 2.0.0-alpha05 على هذه المراجعات.
الميزات الجديدة
- تم نقل مكتبة Protobuf إلى Protobuf lite.
إصلاح الأخطاء
- تم إصلاح المشاكل المتعلّقة بالمؤشر المعلّق.
الإصدار 2.0.0-alpha04
19 نيسان (أبريل) 2023
تم تحرير androidx.games:games-performance-tuner:2.0.0-alpha04
. يحتوي الإصدار 2.0.0-alpha04 على هذه المراجعات.
الميزات الجديدة
- تم تعديل ميزات جمع بيانات القياس عن بُعد في المكتبة، ما يتيح إعداد تقارير أكثر تفصيلاً عن أوقات عرض اللقطات.
إصلاح الأخطاء
- تم إصلاح خطأ يؤدي إلى تعطُّل المكتبة إذا كان الحد الأقصى لمفاتيح القياس أكبر من عدد المخطّطات البيانية.
الإصدار 2.0.0-alpha03
22 شباط (فبراير) 2023
تم تحرير androidx.games:games-performance-tuner:2.0.0-alpha03
. يحتوي الإصدار 2.0.0-alpha03 على هذه المراجعات.
إصلاح الأخطاء
- تم نقل أداة Games-Performance-Tuner إلى عملية إصدار جديدة. من المفترض ألا يحدث أي تغييرات في السلوك.
الإصدار 2.0.0-alpha02
8 شباط (فبراير) 2023
تم تحرير androidx.games:games-performance-tuner:2.0.0-alpha02
. يحتوي الإصدار 2.0.0-alpha02 على هذه المراجعات.
تغييرات واجهة برمجة التطبيقات
TuningFork_predictQualityLevels
تمت إضافة واجهة برمجة التطبيقات التي ستساعد في توقّع مستوى الجودة أو مَعلمات الدقّة الصحيحة المطلوب استخدامها.
الإصدار 1.6 من أداة Games Performance Tuner
الإصدار 1.6.1-alpha01
9 تشرين الثاني (نوفمبر) 2022
تم تحرير androidx.games:games-performance-tuner:1.6.1-alpha01
. يحتوي الإصدار 1.6.1-alpha01 على هذه المراجعات.
الميزات الجديدة
- ما مِن تغييرات جديدة
الإصدار 1.6.0
15 حزيران (يونيو) 2022
تم تحرير androidx.games:games-performance-tuner:1.6.0
. يحتوي الإصدار 1.6.0 على هذه المراجعات.
التغييرات المهمة منذ الإصدار 1.5.0
- تم إصلاح مشكلة عرض getpid القيمة 0 أثناء محاولة الحصول على إحصاءات الذاكرة.
- تم إيقاف تنفيذ StopLoadingGroup بدون مجموعة تحميل نشطة.
الإصدار 1.5.0 من أداة Games Performance Tuner
الإصدار 1.5.0
9 شباط (فبراير) 2022
تم تحرير androidx.games:games-performance-tuner:1.5.0
. يحتوي الإصدار 1.5.0 على هذه المراجعات.
التغييرات المهمة منذ الإصدار 1.4.0
- تغيير الفاصل الزمني بين عمليات التحميل آليًا بدلاً من برمجته في الإعدادات الأولية
- الدالة التي تمّت إضافتها:
TuningFork_setAggregationStrategyInterval
- الدالة التي تمّت إضافتها:
- حلّ مشكلة تلف الذاكرة في مفتاح واجهة برمجة التطبيقات على
API<=23
الإصدار 1.5.0-rc01
26 كانون الثاني (يناير) 2022
تم تحرير androidx.games:games-performance-tuner:1.5.0-rc01
. يحتوي الإصدار 1.5.0-rc01 على هذه المراجعات.
إصلاح الأخطاء
- إصلاح مشكلة تلف الذاكرة في مفتاح واجهة برمجة التطبيقات على واجهة برمجة التطبيقات التي يقلّ إصدارها عن 23
الإصدار 1.5.0-beta02
15 كانون الأول (ديسمبر) 2021
تم تحرير androidx.games:games-performance-tuner:1.5.0-beta02
. يحتوي الإصدار 1.5.0-beta02 على هذه المراجعات.
تغييرات واجهة برمجة التطبيقات
- أزِل التغيير الذي يؤدي إلى إيقاف ABI من
TuningFork_Settings
.
الإصدار 1.5.0-beta01
29 أيلول (سبتمبر) 2021
تم تحرير androidx.games:games-performance-tuner:1.5.0-beta01
. يحتوي الإصدار 1.5.0-beta01 على هذه المراجعات.
الميزات الجديدة
- ما مِن تغييرات عن الإصدار التجريبي. كان هذا الإصدار يتضمّن ما يلي:
- تغيير الفاصل الزمني بين عمليات التحميل آليًا بدلاً من برمجته في الإعدادات الأولية
تغييرات واجهة برمجة التطبيقات
- ما مِن تغييرات عن الإصدار التجريبي. كان هذا الإصدار يتضمّن ما يلي:
- الدالة الجديدة:
TuningFork_setAggregationStrategyInterval
- حقل جديد في
TuningFork_Settings: aggregation_strategy_intervalms_or_count
- الدالة الجديدة:
الإصدار 1.5.0-alpha01
18 آب (أغسطس) 2021
تم تحرير androidx.games:games-performance-tuner:1.5.0-alpha01
. يحتوي الإصدار 1.5.0-alpha01 على هذه المراجعات.
الميزات الجديدة
- أصبح من الممكن الآن ضبط الفاصل الزمني بين عمليات تحميل APT آليًا، بدلاً من استخدام ملف الإعدادات.
تغييرات واجهة برمجة التطبيقات
- الدالة التي تمّت إضافتها:
TuningFork_setAggregationStrategyInterval
- حقل تمت إضافته إلى بنية TuningFork_Settings:
aggregation_strategy_intervalms_or_count
إصدار الأنشطة في الألعاب 1.0.0
الإصدار 1.0.0
4 آب (أغسطس) 2021
تم إصدار androidx.games:games-activity:1.0.0
وandroidx.games:games-controller:1.0.0
وandroidx.games:games-text-input:1.0.0
. يحتوي الإصدار 1.0.0 على عمليات الربط هذه.
الميزات الرئيسية في الإصدار 1.0.0
هذا هو الإصدار الأولي من واجهات برمجة التطبيقات Games-Activity وGames-Controller وGames-Text-Input المتوفّرة في الإصدار العلني. اطّلِع على صفحة AGDK الرئيسية للحصول على مزيد من المعلومات.
الإصدار 1.0.0-rc01
12 تموز (يوليو) 2021
تم تحرير androidx.games:games-activity:1.0.0-rc01
. يحتوي الإصدار 1.0.0-rc01 على هذه المراجعات.
إصلاح الأخطاء
- تصحيح نوع الإرجاع
GameActivityCallbacks::onSaveInstanceState
الإصدار 1.0.0-beta01
30 حزيران (يونيو) 2021
تم تحرير androidx.games:games-activity:1.0.0-beta01
. يحتوي الإصدار 1.0.0-beta01 على هذه المراجعات.
تغييرات واجهة برمجة التطبيقات
- أعِد تسمية
GameActivityInputInfo
إلىGameActivityPointerAxes
. - يقدّم الآن المرجع
onNativeWindowResized
عرض النافذة وارتفاعها. - تمت إزالة طلب معاودة الاتصال
onContentRectChanged
. - تمت إعادة تسمية
onLowMemory
إلىonTrimMemory
. - تمت إزالة "
GameActivity_setWindowFormat
". - نموذج ملكية محسّن لمؤشّري
GameActivityMotionEvents
وGameActivityMotionEvent
- تم تحسين نموذج الملكية لحالة المستخدم في دالة الاستدعاء
onSaveInstanceState
.
الإصدار 1.0.0-alpha01
16 حزيران (يونيو) 2021
تم تحرير androidx.games:games-activity:1.0.0-alpha01
.
الميزات الجديدة
- Games-Activity هي مكتبة جديدة تستبدل NativeActivity كطريقة مقترَحة لدمج لعبة C/C++ مع Android.
الإصدار 2.0 من أداة التحكّم في الألعاب
الإصدار 2.0.2
12 يونيو 2024
تم تحرير androidx.games:games-controller:2.0.2
. يحتوي الإصدار 2.0.2 على عمليات الربط هذه.
إصلاح الأخطاء
- تم إصلاح مشكلة عدم بدء وظائف الاستدعاء المرتبطة بوحدة التحكّم في وحدات التحكّم التي سبق ربطها قبل
Paddleboat_init
. - تم إصلاح مشكلة عدم تسجيل لوحات اللمس الخاصة بوحدة التحكّم في الألعاب لضغطات لوحة اللمس في
Paddleboat_processGameActivityMotionInputEvent
بدون تفعيل محور الضغط يدويًا. - تم إصلاح مشكلة عدم وضع علامة على أحداث لوحة اللمس الخاصة بوحدة التحكّم في الألعاب بأنّها مستخدَمة من قِبل
Paddleboat_processGameActivityMotionInputEvent
.
الإصدار 2.0.1
20 أيلول (سبتمبر) 2023
تم إصدار الإصدار `androidx.games:games-controller:2.0.1 '. يحتوي الإصدار 2.0.1 على هذه المراجعات.
إصلاحات أخطاء في وحدة تحكّم الألعاب:
- يجب إصلاح حالة
NullReferenceException
النادرة في معالِجonInputDeviceChanged
. - إصلاح لمنع بعض لوحات المفاتيح USB من التسجيل بشكل غير صحيح كأجهزة تحكّم في الألعاب
الإصدار 2.0.0
8 آذار (مارس) 2023
تم تحرير androidx.games:games-controller:2.0.0
. يحتوي الإصدار 2.0.0 على هذه المراجعات.
الميزات الرئيسية في الإصدار 2.0.0
- تمت إضافة إمكانية رصد حالة اتصال لوحات المفاتيح.
- تمت إضافة إمكانية الإبلاغ عن بيانات الحركة (مقياس السرعة/الجيروسكوب) من الجهاز الرئيسي (أي الهاتف الجوّال) بالإضافة إلى أجهزة التحكّم.
- تم تغيير واجهة برمجة التطبيقات وتنسيق قاعدة بيانات تعريف وحدة التحكّم لتقليل مساحة الذاكرة المُستخدَمة وتوفير ميزات إضافية.
الإصدار 2.0.0-alpha01
11 كانون الثاني (يناير) 2023
تم تحرير androidx.games:games-controller:2.0.0-alpha01
. يحتوي الإصدار 2.0.0-alpha01 على هذه المراجعات.
الميزات الجديدة
- رصد لوحة المفاتيح
- إتاحة إعداد تقارير بيانات حركة أجهزة الاستشعار المدمجة (أي تلقّي بيانات الجيروسكوب ومقياس التسارع من الهاتف نفسه)
- تنسيق جديد محسّن لبيانات تعيين وحدة التحكّم
تغييرات واجهة برمجة التطبيقات
- طلبات بيانات جديدة من واجهة برمجة التطبيقات للوحة المفاتيح المضمّنة:
Paddleboat_getPhysicalKeyboardStatus
وPaddleboat_setPhysicalKeyboardStatusCallback
- طلبات البيانات الجديدة من واجهة برمجة التطبيقات لإعداد تقارير بيانات حركة أجهزة الاستشعار المدمجة:
Paddleboat_getIntegratedMotionSensorFlags
وPaddleboat_setMotionDataCallbackWithIntegratedFlags
- طلبات البيانات الجديدة من واجهة برمجة التطبيقات لتنسيق بيانات تعيين وحدة التحكّم المعدَّلة:
Paddleboat_addControllerRemapDataFromFd
،Paddleboat_addControllerRemapDataFromFileBuffer
- طلبات البيانات القديمة من واجهة برمجة التطبيقات للربط التي تم إيقافها نهائيًا:
Paddleboat_addControllerRemapData
وPaddleboat_getControllerRemapTableData
إصلاح الأخطاء
- تم إصلاح مشكلة التوافق مع أحداث الحركة من GameActivity 1.2.2 والإصدارات الأحدث.
الإصدار 1.1.0 من أداة التحكّم في الألعاب
الإصدار 1.1.0
23 شباط (فبراير) 2022
تم إصدار androidx.games:games-activity:1.1.0
وandroidx.games:games-controller:1.1.0
. يحتوي الإصدار 1.1.0 على عمليات الربط هذه.
التغييرات المهمة منذ الإصدار 1.0.0
أنشطة الألعاب:
- الاستماع إلى WindowInsets وطلبات البحث عن الاستجابة للشاشة المُثقوبة ومحرِّر أسلوب الإدخال (IME)
- إضافة فلاتر أحداث الحركة والعناصر الرئيسية
- إصلاح الأخطاء:
- إضافة الرسائل غير المتوفّرة للتوافق مع NativeActivity
- إصلاح توقيع onNativeWindowResized
- إصلاح حالات فقدان أحداث الإدخال
الإصدار 1.1.0-rc01
9 شباط (فبراير) 2022
تم تحرير androidx.games:games-controller:1.1.0-rc01
. يحتوي الإصدار 1.1.0-rc01 على هذه المراجعات.
الإصدار 1.1.0-beta01
26 كانون الثاني (يناير) 2022
تم إصدار الإصدار androidx.games:games-controller:1.1.0-beta01
بدون أي تغييرات منذ 1.1.0-alpha01
. يحتوي الإصدار 1.1.0-beta01 على هذه المراجعات.
الإصدار 1.1.0-alpha01
15 كانون الأول (ديسمبر) 2021
تم تحرير androidx.games:games-controller:1.1.0-alpha01
. يحتوي الإصدار 1.1.0-alpha01 على هذه المراجعات.
الميزات الجديدة
تمت إضافة إمكانية عرض حالة البطارية والاهتزاز المزدوج للمحرك والتحكّم في الإضاءة وإعداد تقارير عن محور الحركة في أجهزة التحكّم المتوافقة عند تشغيلها على نظام التشغيل Android S أو الإصدارات الأحدث.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة الدالة
Paddleboat_setMotionDataCallback
لتسجيل عمليات تسجيل البيانات المتعلّقة بحركة وحدة التحكّم - تمت إضافة وظيفة
Paddleboat_setControllerLight
لتغيير إعدادات الإضاءة في وحدة التحكّم. - تمت إضافة بنية
Paddleboat_Controller_Battery
إلىPaddleboat_Controller_Data
- الهياكل الجديدة:
Paddleboat_Controller_Battery
Paddleboat_Motion_Data
- قوائم القيم المحدَّدة الجديدة:
Paddleboat_BatteryStatus
Paddleboat_LightType
Paddleboat_Motion_Type
- علامات التحكّم الجديدة:
PADDLEBOAT_CONTROLLER_FLAG_ACCELEROMETER
PADDLEBOAT_CONTROLLER_FLAG_GYROSCOPE
PADDLEBOAT_CONTROLLER_FLAG_LIGHT_PLAYER
PADDLEBOAT_CONTROLLER_FLAG_LIGHT_RGB
PADDLEBOAT_CONTROLLER_FLAG_BATTERY
إصلاح الأخطاء
- تمت إضافة إدخال بديل لقاعدة بيانات deviceId لوحدة تحكّم PS4
- تمت إضافة إدخال قاعدة بيانات لواجهة برمجة التطبيقات >=31 لوحدة تحكّم PS5
الإصدار 1.0.0 من أداة التحكّم بالألعاب
الإصدار 1.0.0
4 آب (أغسطس) 2021
تم إصدار androidx.games:games-activity:1.0.0
وandroidx.games:games-controller:1.0.0
وandroidx.games:games-text-input:1.0.0
. يحتوي الإصدار 1.0.0 على عمليات الربط هذه.
الميزات الرئيسية في الإصدار 1.0.0
هذا هو الإصدار الأولي من واجهات برمجة التطبيقات Games-Activity وGames-Controller وGames-Text-Input المتوفّرة في الإصدار العلني. يمكنك الاطّلاع على صفحة AGDK الرئيسية للحصول على مزيد من المعلومات.
الإصدار 1.0.0-rc02
21 تموز (يوليو) 2021
تم تحرير androidx.games:games-controller:1.0.0-rc02
. يحتوي الإصدار 1.0.0-rc02 على هذه المراجعات.
إصلاح الأخطاء
- تم إصلاح خطأ في الحزمة أدّى إلى تعذُّر استيراد Prefab في عمليات إعادة ترتيب الإصدار/البنية الفارغة وغير المستخدَمة.
الإصدار 1.0.0-rc01
12 تموز (يوليو) 2021
تم تحرير androidx.games:games-controller:1.0.0-rc01
. يحتوي الإصدار 1.0.0-rc01 على هذه المراجعات.
إصلاح الأخطاء
- تم حلّ مشكلة عدم التوافق مع أحدث إصدار من
GameActivity
الإصدار 1.0.0-beta01
30 حزيران (يونيو) 2021
تم تحرير androidx.games:games-controller:1.0.0-beta01
. يحتوي الإصدار 1.0.0-beta01 على هذه المراجعات.
تغييرات واجهة برمجة التطبيقات
- الدوالّ التي كانت تعرِض قيمة منطقية للنجاح أو الإخفاق تعرِض الآن
Paddleboat_Error_Code
enum. - تمت إعادة تسمية
Paddleboat_onPause
إلىPaddleboat_onStop
. - تمت إعادة تسمية
Paddleboat_onResume
إلىPaddleboat_onStart
. - تم تقسيم Paddleboat_processGameActivityEvent إلى دالتَين:
Paddleboat_processGameActivityKeyInputEvent
وPaddleboat_processGameActivityMotionInputEvent
- تمت إزالة ميزات وحدة التحكّم الموسّعة التي تتطلّب إنشاء الإصدار باستخدام حزمة تطوير البرامج (SDK) لإصدار Android S التجريبي.
- تمت إضافة الدالة
Paddleboat_getBackButtonConsumed
- تحتوي الآن وظائف معاودة الاتصال لحالة جهاز التحكّم والفأرة على مَعلمة اختيارية تشير إلى بيانات يحدّدها المستخدم.
- تم نقل سلسلة اسم وحدة التحكّم خارج بنية معلومات الجهاز، ويمكن الوصول إليها الآن من خلال دالة
Paddleboat_getControllerName
.
إصلاح الأخطاء
- تم إصلاح مشكلة عدم رصد جهاز تحكّم بشكلٍ صحيح على أنّه جهاز تحكّم، وذلك عندما لا يُبلغ عن نفسه في البداية على أنّه جهاز تحكّم، ولكن يُبلغ عن نفسه لاحقًا من خلال رسالة onInputDeviceChanged.
الإصدار 1.0.0-alpha01
16 حزيران (يونيو) 2021
تم تحرير androidx.games:games-controller:1.0.0-alpha01
.
الميزات الجديدة
- Games-Controller هي مكتبة جديدة توفّر واجهة برمجة تطبيقات C لرصد أجهزة وحدات التحكّم في الألعاب وقراءة الإدخال منها والتفاعل معها.
Games-Text-Input 2.1
الإصدار 2.1.0-alpha01
26 تموز (يوليو) 2023
تم تحرير androidx.games:games-text-input:2.1.0-alpha01
. يحتوي الإصدار 2.1.0-alpha01 على هذه المراجعات.
الميزات الجديدة
- إتاحة وضعَي "الخطوط المتعددة" و"الخط الواحد"
تغييرات واجهة برمجة التطبيقات
- إضافة دالة
isSoftwareKeyboardVisible
- إضافة تعريفات لسجلّ الأعداد الثنائية
GameActivity_setImeEditorInfo
- إضافة
onEditorAction
ردّ اتصال
إصلاح الأخطاء
- حلّ مشكلة عدم مزامنة لوحة المفاتيح في الجهاز والبرامج
- محو التركيز عند إخفاء لوحة المفاتيح الافتراضية
Games-Text-Input 2.0
الإصدار 2.0.0
8 آذار (مارس) 2023
تم تحرير androidx.games:games-text-input:2.0.0
. يحتوي الإصدار 2.0.0 على هذه المراجعات.
التغييرات المهمة منذ الإصدار 1.1.1
- تحديث الإصدار الرئيسي بسبب التغييرات في نظام الإنشاء، ما مِن تحديثات في المكتبة/واجهة برمجة التطبيقات نفسها.
Games-Text-Input Version 1.1
الإصدار 1.1.2-alpha01
9 تشرين الثاني (نوفمبر) 2022
تم تحرير androidx.games:games-text-input:1.1.2-alpha01
. يحتوي الإصدار 1.1.2-alpha01 على هذه المراجعات.
الميزات الجديدة
- ما مِن تغييرات جديدة
الإصدار 1.1.1
13 تموز (يوليو) 2022
تم تحرير androidx.games:games-text-input:1.1.1
. يحتوي الإصدار 1.1.1 على هذه المراجعات.
إصلاح الأخطاء
- تم إصلاح المشاكل المتعلّقة بملف .aar غير المتوفّر في الإصدار السابق.
الإصدار 1.1.0
9 شباط (فبراير) 2022
تم تحرير androidx.games:games-text-input:1.1.0
. يحتوي الإصدار 1.1.0 على عمليات الربط هذه.
التغييرات المهمة منذ الإصدار 1.0.0
- تمت إضافة وظيفة الاستماع إلى WindowInsets وطلبات البحث إليها في GameTextInput
- إضافة عنوان gamecommon.h
غير المتوفّر
الإصدار 1.1.0-rc01
26 كانون الثاني (يناير) 2022
تم تحرير androidx.games:games-text-input:1.1.0-rc01
. يحتوي الإصدار 1.1.0-rc01 على هذه المراجعات.
الإصدار 1.1.0-beta01
15 كانون الأول (ديسمبر) 2021
تم تحرير androidx.games:games-text-input:1.1.0-beta01
. يحتوي الإصدار 1.1.0-beta01 على هذه المراجعات.
إصلاح الأخطاء
- إصلاح مشكلة إدراجات IME وميزة "العرض بدون انقطاع"
- إضافة العنوان gamecommon.h غير المتوفّر
الإصدار 1.1.0-alpha01
13 تشرين الأول (أكتوبر) 2021
تم تحرير androidx.games:games-text-input:1.1.0-alpha01
. يحتوي الإصدار 1.1.0-alpha01 على هذه المراجعات.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة وظيفة إدراجات IME إلى GameTextInput
الإصدار 1.0 من Games-Text-Input
الإصدار 1.0.0
4 آب (أغسطس) 2021
تم إصدار androidx.games:games-activity:1.0.0
وandroidx.games:games-controller:1.0.0
وandroidx.games:games-text-input:1.0.0
. يحتوي الإصدار 1.0.0 على عمليات الربط هذه.
الميزات الرئيسية في الإصدار 1.0.0
هذا هو الإصدار الأولي من واجهات برمجة التطبيقات Games-Activity وGames-Controller وGames-Text-Input المتوفّرة في الإصدار العلني. يمكنك الاطّلاع على صفحة AGDK الرئيسية للحصول على مزيد من المعلومات.
الإصدار 1.0.0-rc01
12 تموز (يوليو) 2021
تم طرح الإصدار androidx.games:games-text-input:1.0.0-rc01
بدون أي تغييرات. يحتوي الإصدار 1.0.0-rc01 على هذه المراجعات.
الإصدار 1.0.0-beta01
30 حزيران (يونيو) 2021
تم تحرير androidx.games:games-text-input:1.0.0-beta01
. يحتوي الإصدار 1.0.0-beta01 على هذه المراجعات.
تغييرات واجهة برمجة التطبيقات
- نموذج ملكية محسَّن لعناصر GameTextInputState
- ترتيب الأنواع لتصبح متوافقة مع NDK
الإصدار 1.0.0-alpha01
16 حزيران (يونيو) 2021
تم تحرير androidx.games:games-text-input:1.0.0-alpha01
.
الميزات الجديدة
- Games-Text-Input هي مكتبة جديدة لمساعدة مطوّري الألعاب في استخدام إدخال لوحة المفاتيح المتوفّرة في Android من C/C++.
الإصدار 2.1 من ميزة "معدّل عرض اللقطات في الألعاب"
الإصدار 2.1.2
24 تموز (يوليو) 2024
تم تحرير androidx.games:games-frame-pacing:2.1.2
. يحتوي الإصدار 2.1.2 على عمليات الربط هذه.
إصلاح الأخطاء
- يستخدم Swappy الآن
AChoreographer_postVsyncCallback
من الإصدار 33 من واجهة برمجة التطبيقات لاحتساب وقت العرض بدقة أكبر. يعالج هذا الخلل على الأجهزة التي تعمل بمعدّل 120 هرتز والذي يؤدي إلى إسقاط اللقطات.
الإصدار 2.1.1
10 تموز (يوليو) 2024
تم تحرير androidx.games:games-frame-pacing:2.1.1
. يحتوي الإصدار 2.1.1 على عمليات الربط هذه.
إصلاح الأخطاء
- يجب إلغاء تسجيل مستمع العرض من Swappy بشكل صحيح لتجنُّب تعليق التطبيق.
- إصلاح عطل في
ChoreographerFilter::onSettingsChanged
باستخدام قفل مشترَك تم تدميره
الإصدار 2.1.0
15 تشرين الثاني (نوفمبر) 2023
تم تحرير androidx.games:games-frame-pacing:2.1.0
. يحتوي الإصدار 2.1.0 على هذه المراجعات.
الإصدار 2.1.0-rc01
20 أيلول (سبتمبر) 2023
تم تحرير androidx.games:games-frame-pacing:2.1.0-rc01
. يحتوي الإصدار 2.1.0-rc01 على هذه المراجعات.
الإصدار 2.1.0-beta01
24 أيار (مايو) 2023
تم تحرير androidx.games:games-frame-pacing:2.1.0-beta01
. يحتوي الإصدار 2.1.0-beta01 على هذه المراجعات.
إصلاح الأخطاء
- مهلة في حال تعذّر إعداد
NDKChoreographer
(ef466d) - عند استخدام
SwappyGL_getSupportedRefreshPeriodsNS
معدلات تحديث طلبات البحث صراحةً من النظام (c85235)
الإصدار 2.1.0-alpha01
5 نيسان (أبريل) 2023
تم تحرير androidx.games:games-frame-pacing:2.1.0-alpha01
. يحتوي الإصدار 2.1.0-alpha01 على هذه المراجعات.
الميزات الجديدة
- واجهة برمجة تطبيقات جديدة لإعادة ضبط حالة معدل عرض اللقطات
- واجهة برمجة تطبيقات جديدة لإيقاف تأثير "التبديل السريع" على معدل عرض اللقطات مع مواصلة مراقبة أوقات وحدة المعالجة المركزية ووحدة معالجة الرسومات
تغييرات واجهة برمجة التطبيقات
- يمكن الآن استخدام
SwappyGL_resetFramePacing/SwappyVk_resetFramePacing
لإعادة ضبط حالة معدل عرض اللقطات الداخلي. لن تأخذ ميزة "معدّل عرض اللقطات" في الاعتبار الآن سوى البيانات من النقطة التي يتم فيها استدعاء واجهة برمجة التطبيقات لإعادة الضبط. - يمكن الآن استخدام
SwappyGL_enableFramePacing/SwappyVk_enableFramePacing
لتفعيل/إيقاف معدل عرض اللقطات في أداة "التبديل السريع". عند إيقاف الميزة: - يمكن استخدام
SwappyGL_enableBlockingWait/SwappyVk_enableBlockingWait
للتحكّم في ما إذا كان سيتم حظر الانتظار لحين اكتمال عمل وحدة معالجة الرسومات في اللقطة الأخيرة عند إيقاف ميزة "مزامنة عرض اللقطات".
إصلاح الأخطاء
- تم إجراء تحسينات على الأداء في الحالات المرتبطة بوحدة معالجة الرسومات عند استخدام Swappy GL API.
الإصدار 2.0 من ميزة "معدّل عرض اللقطات في الألعاب"
الإصدار 2.0.0
8 آذار (مارس) 2023
تم تحرير androidx.games:games-frame-pacing:2.0.0
. يحتوي الإصدار 2.0.0 على هذه المراجعات.
التغييرات المهمة منذ الإصدار 1.10.1
- خضع نظام الإنشاء لتغييرات كبيرة أدّت إلى إنشاء مكتبة واحدة فقط بدلاً من عدة مكتبات لكل إصدار من حزمة SDK أو NDK.
- تمّت إضافة إحصاءات لقطات Vulkan.
- تمت إضافة واجهة برمجة تطبيقات جديدة لمحو إحصاءات اللقطات.
- تكون جميع السجلات صامتة في وضع الإصدار، ويمكن تفعيلها في وضع تصحيح الأخطاء.
الإصدار 2.0.0-rc01
22 شباط (فبراير) 2023
تم تحرير androidx.games:games-frame-pacing:2.0.0-rc01
. يحتوي الإصدار 2.0.0-rc01 على هذه المراجعات.
الميزات الجديدة
- أصبح التسجيل مخفيًا الآن خلف علامة تجميع. لا يتضمّن الإصدار العلني من المكتبة أيّ تسجيلات تلقائيًا، ويتم تفعيل جميع عمليات التسجيل في الإصدار المخصّص لتصحيح الأخطاء من المكتبة.
الإصدار 2.0.0-beta01
8 شباط (فبراير) 2023
تم تحرير androidx.games:games-frame-pacing:2.0.0-beta01
. يحتوي الإصدار 2.0.0-beta01 على هذه المراجعات.
الميزات الجديدة
- تمّت إضافة واجهة برمجة تطبيقات جديدة لحذف إحصاءات اللقطات.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة واجهات برمجة التطبيقات
SwappyGL_clearStats
وSwappyGL_clearStats
.
الإصدار 2.0.0-alpha01
11 كانون الثاني (يناير) 2023
تم تحرير androidx.games:games-frame-pacing:2.0.0-alpha01
. يحتوي الإصدار 2.0.0-alpha01 على هذه المراجعات.
الميزات الجديدة
- تمّت إضافة إحصاءات إطارات Vulkan
تغييرات واجهة برمجة التطبيقات
- زيادة كبيرة في الإصدار بسبب إعادة تنظيم ملفات الإنشاء
- تمت إضافة 3 واجهات برمجة تطبيقات جديدة :
SwappyVk_enableStats
وSwappyVk_recordFrameStart
وSwappyVk_getStats
.
إصلاح الأخطاء
- تطبيق الحدّ فقط في وضع التبديل التلقائي (Ic0786)
سرعة عرض اللقطات في الألعاب 1.10
الإصدار 1.10.2-alpha01
9 تشرين الثاني (نوفمبر) 2022
تم تحرير androidx.games:games-frame-pacing:1.10.2-alpha01
. يحتوي الإصدار 1.10.2-alpha01 على هذه المراجعات.
الميزات الجديدة
- ما مِن تغييرات جديدة
الإصدار 1.10.1
15 حزيران (يونيو) 2022
تم تحرير androidx.games:games-frame-pacing:1.10.1
. يحتوي الإصدار 1.10.1 على هذه المراجعات.
إصلاح الأخطاء
- إصلاح مشكلة عدم إنشاء swappy باستخدام ndk <23 و >17
- واجهة برمجة تطبيقات معروضة لاسترداد معدّلات إعادة التحميل المتوافقة مع الشاشة
الإصدار 1.10.0
23 شباط (فبراير) 2022
تم تحرير androidx.games:games-frame-pacing:1.10.0
. يحتوي الإصدار 1.10.0 على هذه المراجعات.
التغييرات المهمة منذ الإصدار 1.9.0
- تجاهل إدخالات فلاتر مصمّمي الرقصات التي تؤدي إلى حدوث مشاكل وتحسين الأداء أكثر لمنع حدوث تجمّد على المحاكي
- أضِف دوال *_uninjectTracer.
الإصدار 1.10.0-rc01
9 شباط (فبراير) 2022
تم تحرير androidx.games:games-frame-pacing:1.10.0-rc01
. يحتوي الإصدار 1.10.0-rc01 على هذه المراجعات.
الإصدار 1.10.0-beta01
26 كانون الثاني (يناير) 2022
تم تحرير androidx.games:games-frame-pacing:1.10.0-beta01
. يحتوي الإصدار 1.10.0-beta01 على هذه المراجعات.
الإصدار 1.10.0-alpha01
15 كانون الأول (ديسمبر) 2021
تم تحرير androidx.games:games-frame-pacing:1.10.0-alpha01
. يحتوي الإصدار 1.10.0-alpha01 على هذه المراجعات.
الميزات الجديدة
- إضافة الدالة
SwappyGL_uninjectTracer
تغييرات واجهة برمجة التطبيقات
- أزِل طلبات إعادة الاتصال التي تمت إضافتها سابقًا باستخدام
SwappyGL_injectTracer
باستخدام واجهة برمجة التطبيقاتSwappyGL_uninjectTracer(const SwappyTracer *t)
.
Games Frame Pacing 1.9
الإصدار 1.9.1
13 تشرين الأول (أكتوبر) 2021
تم تحرير androidx.games:games-frame-pacing:1.9.1
. يحتوي الإصدار 1.9.1 على هذه المراجعات.
إصلاح الأخطاء
- تم إصلاح b/199487756
الإصدار 1.9.0
12 تموز (يوليو) 2021
تم تحرير androidx.games:games-frame-pacing:1.9.0
. يحتوي الإصدار 1.9.0 على هذه المراجعات.
التغييرات المهمة منذ الإصدار 1.7.0
- تم تعديله ليتوافق مع مخطّط الإصدارات الداخلي.
Games Frame Pacing 1.7.0
الإصدار 1.7.0
30 حزيران (يونيو) 2021
تم تحرير androidx.games:games-frame-pacing:1.7.0
. يحتوي الإصدار 1.7.0 على هذه المراجعات.
الإصدار 1.7.0-rc01
2 حزيران (يونيو) 2021
تم تحرير androidx.games:games-frame-pacing:1.7.0-rc01
. يحتوي الإصدار 1.7.0-rc01 على هذه المراجعات.
الإصدار 1.7.0-beta02
24 شباط (فبراير) 2021
تم تحرير androidx.games:games-frame-pacing:1.7.0-beta02
.
الإصدار 1.7.0-beta01
16 كانون الأول (ديسمبر) 2020
تم تحرير androidx.games:games-frame-pacing:1.7.0-beta01
.
أداة تحسين أداء الألعاب 1.4.3
الإصدار 2.0.0-rc01
24 تموز (يوليو) 2024
تم تحرير androidx.games:games-performance-tuner:2.0.0-rc01
. يتضمّن الإصدار 2.0.0-rc01 عمليات الربط هذه.
الإصدار 1.4.3
12 تموز (يوليو) 2021
تم تحرير androidx.games:games-performance-tuner:1.4.3
. يحتوي الإصدار 1.4.3 على هذه المراجعات.
التغييرات المهمة منذ الإصدار 1.1.0
- تم تعديله ليتوافق مع مخطّط الإصدارات الداخلي.
أداة Games Performance Tuner 1.1.0
الإصدار 1.1.0
30 حزيران (يونيو) 2021
تم تحرير androidx.games:games-performance-tuner:1.1.0
. يحتوي الإصدار 1.1.0 على عمليات الربط هذه.
الإصدار 1.1.0-rc01
2 حزيران (يونيو) 2021
تم تحرير androidx.games:games-performance-tuner:1.1.0-rc01
. يتضمّن الإصدار 1.1.0-rc01 عمليات الربط هذه.
الإصدار 1.1.0-beta03
21 نيسان (أبريل) 2021
تم تحرير androidx.games:games-performance-tuner:1.1.0-beta03
.
الإصدار 1.1.0-beta02
24 شباط (فبراير) 2021
تم تحرير androidx.games:games-performance-tuner:1.1.0-beta02
.
الإصدار 1.1.0-beta01
16 كانون الأول (ديسمبر) 2020
تم تحرير androidx.games:games-performance-tuner:1.1.0-beta01
.
الإصدار 1.1.0-alpha01
تم إصدار الإصدار androidx.games:games-performance-tuner:1.1.0-alpha01.
الإصدار 1.0.0
الإصدار 1.0.0-alpha02
12 آب (أغسطس) 2020
تمت إعادة تسمية مكتبة ألعاب Android ليصبح اسمها "مكتبة ألعاب Android".
androidx.gaming -> androidx.games
الإصدار 1.0.0-alpha01
10 حزيران (يونيو) 2020
تم إصدار androidx.games:1.0.0-alpha01.