ألعاب Android

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

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

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

العناصر الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأولي
games-activity 4.4.2 - - -
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.3.1 - - -
games-performance-tuner 2.0.0 - - 2.3.0-alpha01
تم إجراء آخر تعديل على هذه المكتبة في: 06 مايو 2026

المتطلبات

games-memory-advice

تتطلّب واجهة برمجة التطبيقات MemoryAdvice إنشاء تطبيقك باستخدام الإصدار 23.* أو إصدار أحدث من حزمة تطوير البرامج الأصلية (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.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.4.2"

    // 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.3.1"
}

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

    // 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.3.1")
}
}

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

إضافة خصائص 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 أو إصدارًا أحدث، تأكَّد من أنّ 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

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

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

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

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

Games-Text-Input

الإصدار 4.3

الإصدار 4.3.1

‫6 مايو 2026

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

الإصدار 4.3.0

‫11 مارس 2026

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

الإصدار 4.3.0-rc01

‫28 يناير 2026

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

الإصدار 4.3.0-beta01

‫19 نوفمبر 2025

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

  • ينقل هذا الإصدار androidx.games:games-text-input من الإصدار الأوّلي إلى الإصدار التجريبي.

الإصدار ‎‏‎3.0

الإصدار 3.0.4

‫7 أغسطس 2024

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

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

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

الإصدار 2.1

الإصدار 2.1.0-alpha01

‏26 تموز (يوليو) 2023

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

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

  • إضافة دعم لوضعَي الأسطر المتعددة والسطر الواحد

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

  • إضافة دالة isSoftwareKeyboardVisible
  • إضافة تعريفات bitfield لـ GameActivity_setImeEditorInfo
  • إضافة onEditorAction معاودة الاتصال

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

  • إصلاح مشكلة عدم مزامنة لوحات المفاتيح الفعلية والبرامج
  • إزالة التركيز عند إخفاء لوحة المفاتيح الافتراضية

الإصدار ‎2.0

الإصدار 2.0.0

‫8 مارس 2023

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

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

  • تحديث رقم الإصدار الرئيسي بسبب التغييرات التي تم إجراؤها على نظام التصميم، ولم يتم إجراء أي تحديثات على المكتبة أو واجهة برمجة التطبيقات نفسها.

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

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

Games-Activity

الإصدار 4.4

الإصدار 4.4.2

‫6 مايو 2026

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

الإصدار 4.4.1

‫8 أبريل 2026

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

الإصدار 4.4.0

‫11 مارس 2026

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

الإصدار 4.4.0-rc01

‫28 يناير 2026

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

الإصدار 4.4.0-beta01

‫19 نوفمبر 2025

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

  • ينقل هذا الإصدار androidx.games:games-activity من الإصدار الأوّلي إلى الإصدار التجريبي.

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

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

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

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

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

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

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-rc01

‫24 يوليو 2024

تم طرح androidx.games:games-performance-tuner:2.0.0-rc01. يتضمّن الإصدار 2.0.0-rc01 هذه التعديلات.

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

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

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

الإصدار 1.4.3

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

تم طرح androidx.games:games-performance-tuner:1.4.3. يتضمّن الإصدار 1.4.3 هذه التعديلات.

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

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

الإصدار 1.1

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

Games-Controller

الإصدار 2.3

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

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

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

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

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

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

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

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

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

  • يمكن الآن استخدام SwappyGL_resetFramePacing/SwappyVk_resetFramePacing لإعادة ضبط حالة "مزامنة عرض اللقطات" الداخلية. لن تأخذ ميزة "مزامنة اللقطات" في الاعتبار سوى البيانات الواردة من النقطة التي تم فيها استدعاء واجهة برمجة التطبيقات لإعادة الضبط.
  • يمكن الآن استخدام SwappyGL_enableFramePacing/SwappyVk_enableFramePacing لتفعيل/إيقاف ميزة "مزامنة الإطارات" في swappy. عند إيقاف هذا الخيار،
  • يمكن استخدام SwappyGL_enableBlockingWait/SwappyVk_enableBlockingWait للتحكّم في ما إذا كان سيتم انتظار وحدة معالجة الرسومات بشكلٍ حاصر لآخر إطار عند إيقاف ميزة "مزامنة عرض اللقطات".

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

  • تم إجراء تحسينات على الأداء في حالات استخدام واجهة برمجة التطبيقات Swappy GL التي تتطلّب وحدة معالجة الرسومات.

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

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

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

الإصدار ‎1.0.0-alpha02

12 آب (أغسطس) 2020

تمت إعادة تسمية "مكتبة ألعاب Android" لتصبح "مكتبة ألعاب Android".

androidx.gaming -> androidx.games

الإصدار ‎1.0.0-alpha01

‫10 يونيو 2020

تم طرح الإصدار 1.0.0-alpha01 من androidx.games.