ألعاب Android

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

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

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

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

المتطلبات

games-memory-advice

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

تعريف التبعيات

لإضافة تبعية للعبة، يجب إضافة مستودع Google Maven إلى مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف التبعيات الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle لتطبيقك أو وحدتك، لأنّ المكتبة games-activity تتضمّن الإصدار نفسه من المكتبة game-text-input، وبالتالي لا يمكن لتطبيقات GameActivity تضمين التبعية game-text-input مرة أخرى:

Groovy

android {
    ...
    // To use the Android Frame Pacing or Android Performance Tuner libraries, enable
    // native dependencies to be imported. Libraries will be made available to your CMake build
    // as packages named "games-frame-pacing" and "games-performance-tuner".
    buildFeatures {
        prefab true
    }
}

dependencies {
    // To use the Android Frame Pacing library
    implementation "androidx.games:games-frame-pacing:2.1.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 متوفّرًا، أنشِئ هذا الملف.

إذا كنت تستخدم Android Studio 4.0، تأكَّد من أنّ 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.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 الآن على مكتبات ثابتة مُنشأة مسبقًا. من المتوقّع الآن أن يستخدم رمز التطبيق هذه المكتبات من خلال العناصر الجاهزة وأن يتضمّن العناوين فقط (مثل #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

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

Games-Activity Version 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.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

Games-Text-Input Version 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++.

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

تم طرح 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 التي تتطلّب وحدة معالجة الرسومات.

الإصدار 2.0 من Games Frame Pacing

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

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

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

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