ألعاب Android

تتطابق مكتبة ألعاب Android مع "حزمة تطوير البرامج" (SDK) الخاصة بألعاب Android، وهي متاحة للتنزيل كملف ثنائي. يمكنك استخدام مكتبة androidx بدلاً من تنزيل حزمة تطوير البرامج (SDK) الخاصة بألعاب Android ودمجها يدويًا في الإصدار.

لمزيد من المعلومات حول حزمة تطوير البرامج (SDK) الخاصة بألعاب Android، يمكنك الاطّلاع على مستندات حزمة تطوير البرامج وملاحظات إصدار حزمة تطوير البرامج.

يسرد هذا الجدول جميع العناصر في المجموعة androidx.games.

العناصر الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأوّلي
games-activity 4.0.0 - - 4.4.0-alpha01
games-controller 2.0.2 - - 2.3.0-alpha01
games-frame-pacing 2.1.3 - - 2.3.0-alpha01
games-memory-advice 2.0.1 - 2.1.0-beta01 2.3.0-alpha01
games-text-input 4.0.0 - - 4.3.0-alpha01
games-performance-tuner 2.0.0 - - 2.3.0-alpha01
تم إجراء آخر تعديل على هذه المكتبة في: 22 أكتوبر 2025

المتطلبات

games-memory-advice

تتطلّب واجهة برمجة التطبيقات MemoryAdvice إنشاء تطبيقك باستخدام الإصدار 23.* أو إصدار أحدث من حزمة تطوير البرامج الأصلية (NDK).

تحديد الاعتماديات

لإضافة اعتمادية على game، يجب تضمين مستودع 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.3"

    // 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:4.0.0"

    // 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:4.0.0"
}

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.3")

    // 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:4.0.0")

    // 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:4.0.0")
}
}

لمزيد من المعلومات حول الاعتماديات، يُرجى الاطّلاع على إضافة اعتماديات البناء.

إضافة خصائص Gradle

قد تحتاج إلى إضافة خصائص إلى ملف gradle.properties الموجود في الدليل نفسه الذي يتضمّن ملف build.gradle الخاص بتطبيقك (أو وحدتك). إذا لم يكن الملف gradle.properties متوفّرًا، أنشِئ هذا الملف.

إذا كنت تستخدم الإصدار 4.0 من "استوديو Android"، تأكَّد من أنّ الملف 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

لإتاحة حِزم Game SDK التي تم استيرادها، أضِف ما يلي إلى ملف 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. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.

إنشاء مشكلة جديدة

يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.

Games-Memory-Advice version 2.1

الإصدار 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 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • دالة AddGetAvailableMemory

إصلاح الأخطاء

  • تعديل نموذج "اقتراحات الذكريات"
  • إصلاح هدف الإنشاء المشترَك 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 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • زيادة في الإصدار الرئيسي بسبب إعادة تصميم ملفات الإنشاء.

إصلاح الأخطاء

  • عند ضبط إعدادات غير صحيحة لمواد عرض المكتبة، سيظهر الآن خطأ بدلاً من تعذُّر تشغيل التطبيق.

Games-Memory-Advice version 1.0.0

الإصدار 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 للحصول على واجهة برمجة التطبيقات الكاملة.

المساهمة الخارجية

الإصدار 3.0 من Games-Text-Input

الإصدار 3.0.4

‫7 أغسطس 2024

تم طرح androidx.games:games-text-input:3.0.4. يتضمّن الإصدار 3.0.4 هذه التعديلات.

إصلاح الأخطاء

  • تم إصلاح وظيفة الحذف مع تحديد النص وبدونه.

ألعاب الإصدار 4.0

الإصدار 4.4.0-alpha01

‫22 أكتوبر 2025

تم طرح androidx.games:games-activity:4.4.0-alpha01. يتضمّن الإصدار 4.4.0-alpha01 هذه التعديلات.

إصلاح الأخطاء

  • تحسين ميزة "الحماية من أخطاء ANR" في native_app_glue
  • تم نقل البيانات من ALooper_pollAll المتوقّف نهائيًا إلى ALooper_pollOnce.

الإصدار 4.3.0-alpha01

‫13 أغسطس 2025

تم طرح androidx.games:games-activity:4.3.0-alpha01 وandroidx.games:games-text-input:4.3.0-alpha01. يتضمّن الإصدار 4.3.0-alpha01 هذه التعديلات.

الميزات الجديدة

  • توفير صفحات بحجم 16 كيلوبايت تلقائيًا
  • تتيح هذه السمة استخدام الماوس مع GameActivity.

إصلاح الأخطاء

  • تم إصلاح مشكلة التزامن بين أحداث دورة الحياة onDestroy وonCreate.
  • تم إصلاح مشكلة كانت تتطلّب من التطبيقات الحفاظ على رمز يدويًا لتهيئة الرمز البرمجي الأصلي.
  • تحسين معالجة اللمس GameActivity
  • تم إصلاح مشكلة إنشاء GameTextInput كمكتبة مشتركة بشكلٍ غير صحيح.

الإصدار 4.2.0-alpha01

‫26 مارس 2025

تم طرح androidx.games:games-activity:4.2.0-alpha01 وandroidx.games:games-text-input:4.2.0-alpha01. يتضمّن الإصدار 4.2.0-alpha01 هذه التعديلات.

الميزات الجديدة

  • الترقية إلى Gradle 8.8.1 (1ed0153)
  • الترقية إلى Java 17 (1ed0153)

إصلاح الأخطاء

  • إصلاح خطأ في GameActivity كان يؤدي إلى عرض getLocaleScript وgetLocaleCountry وgetLocaleVariant للغة المحلية بدلاً من القيمة المطلوبة (1198bb0)
  • تم إصلاح خطأ في GameActivity تسبّب في إعداد تقارير غير صحيحة عن أحداث فتح وإغلاق لوحة المفاتيح البرمجية. (a63ecca)
  • إصلاح خطأ في GameTextInput يتعلق بمعالجة رموز الإيموجي المتعددة البايتات (9d54c68)

الإصدار 4.0.0

‫12 فبراير 2025

تم طرح androidx.games:games-activity:4.0.0 وandroidx.games:games-text-input:4.0.0. يتضمّن الإصدار 4.0.0 هذه التعديلات.

الميزات الرئيسية في الإصدار 4.0.0

  • تحتوي ملفات AAR الآن على مكتبات ثابتة مُنشأة مسبقًا. من المتوقّع الآن أن يستخدم رمز التطبيق هذه المكتبات من خلال حِزم Prefab وأن يتضمّن العناوين فقط (مثل #include "GameActivity.h") بدلاً من تضمين التنفيذ (مثل #include "GameActivity.cpp").
  • تتوفّر الآن أيضًا معلومات لغة Android للرمز البرمجي الأصلي الذي يستخدم GameActivity.

إصلاح الأخطاء

  • تم إصلاح العديد من الأخطاء في GameTextInput. أصبحت المكتبة الآن أكثر ثباتًا وتعمل مع العديد من لوحات المفاتيح البرمجية ولوحات المفاتيح الخارجية الشائعة.

الإصدار 4.0.0-rc01

‫29 يناير 2025

تم طرح androidx.games:games-activity:4.0.0-rc01 وandroidx.games:games-text-input:4.0.0-rc01. يتضمّن الإصدار 4.0.0-rc01 هذه التعديلات.

الإصدار 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 من Games-Activity

الإصدار 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

الإصدار 2.0 من أداة Games Performance Tuner

الإصدار 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 تمت إضافة واجهة برمجة تطبيقات ستساعد في توقّع مستوى الجودة/مَعلَمات الدقّة الصحيحة التي يجب استخدامها.

‫Games Performance Tuner 1.6

الإصدار 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

  • تم إصلاح الخطأ الذي كان يتسبّب في عرض القيمة 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.3 من Games-Controller

الإصدار 2.3.0-alpha01

‫13 أغسطس 2025

تم إصدار androidx.games:games-controller:2.3.0-alpha01 وandroidx.games:games-memory-advice:2.3.0-alpha01 وandroidx.games:games-performance-tuner:2.3.0-alpha01. يتضمّن الإصدار 2.3.0-alpha01 هذه التعديلات.

الميزات الجديدة

  • توفير صفحات بحجم 16 كيلوبايت تلقائيًا

الإصدار 2.2 من Games-Controller

الإصدار 2.2.0-alpha01

‫26 مارس 2025

تم إصدار androidx.games:games-controller:2.2.0-alpha01 وandroidx.games:games-memory-advice:2.2.0-alpha01 وandroidx.games:games-performance-tuner:2.2.0-alpha01. يتضمّن الإصدار 2.2.0-alpha01 هذه التعديلات.

الميزات الجديدة

  • الترقية إلى Gradle 8.8.1 (1ed0153)
  • الترقية إلى Java 17 (1ed0153)
  • تغيير targetSdk إلى 35 (eddf605)

الإصدار 2.0 من Games-Controller

الإصدار 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 من Games-Controller

الإصدار 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
  • تمت إضافة إدخال قاعدة بيانات API >=31 لوحدة تحكّم PS5

الإصدار 1.0.0 من Games-Controller

الإصدار 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.
  • تمت إعادة تسمية 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.3 من أداة "مزامنة عرض اللقطات في الألعاب"

الإصدار 2.3.0-alpha01

‫26 مارس 2025

تم طرح androidx.games:games-frame-pacing:2.3.0-alpha01. يتضمّن الإصدار 2.3.0-alpha01 هذه التعديلات.

الميزات الجديدة

  • الترقية إلى Gradle 8.8.1 (1ed0153)
  • الترقية إلى Java 17 (1ed0153)
  • تغيير targetSdk إلى 35 (eddf605)

إصلاح الأخطاء

الإصدار 2.1 من ميزة "تحديد سرعة عرض اللقطات في الألعاب"

الإصدار 2.1.3

‫2 يوليو 2022

تم طرح androidx.games:games-frame-pacing:2.1.3. يتضمّن الإصدار 2.1.3 هذه التعديلات.

إصلاح الأخطاء

  • تفعيل التوافق مع حجم الصفحة البالغ 16 كيلوبايت

الإصدار 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 باستخدام mutex تم إتلافه

الإصدار 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 هذه التعديلات.

الميزات الجديدة

  • واجهة برمجة تطبيقات جديدة لإعادة ضبط حالة "مزامنة اللقطات مع الشاشة"
  • واجهة برمجة تطبيقات جديدة لإيقاف تأثير swappy في تحديد عدد اللقطات في الثانية مع الاستمرار في مراقبة أوقات وحدة المعالجة المركزية ووحدة معالجة الرسومات

تغييرات واجهة برمجة التطبيقات

  • يمكن الآن استخدام SwappyGL_resetFramePacing/SwappyVk_resetFramePacing لإعادة ضبط حالة "مزامنة عرض اللقطات" الداخلية. لن يأخذ إيقاع عرض اللقطات في الاعتبار سوى البيانات الواردة من النقطة التي تم فيها استدعاء واجهة برمجة التطبيقات لإعادة الضبط.
  • يمكن الآن استخدام SwappyGL_enableFramePacing/SwappyVk_enableFramePacing لتفعيل/إيقاف ميزة "مزامنة الإطارات" في swappy. عند إيقاف هذا الخيار،
  • يمكن استخدام 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)

Games Frame Pacing 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 هذه التعديلات.

إصلاح الأخطاء

الإصدار 1.9.0

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

تم طرح androidx.games:games-frame-pacing:1.9.0. يتضمّن الإصدار 1.9.0 هذه التعديلات.

التغييرات المهمة منذ الإصدار 1.7.0

  • تم تعديلها لتتوافق مع نظام تحديد الإصدارات الداخلية.

الإصدار 1.7.0 من واجهة برمجة التطبيقات Frame Pacing API للألعاب

الإصدار 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.

‫Games Performance Tuner 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.