ألعاب Android

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

لمزيد من المعلومات عن حزمة SDK لألعاب Android، راجِع مستندات حزمة SDK وملاحظات إصدار حزمة SDK.

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

العناصر الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأولي
أنشطة الألعاب 4.0.0 - - 4.2.0-alpha01
games-controller 2.0.2 - - 2.2.0-alpha01
games-frame-pacing 2.1.2 - - 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
أداة تحسين أداء الألعاب 2.0.0 - - 2.2.0-alpha01
تاريخ آخر تعديل على هذه المكتبة: 26 آذار (مارس) 2025

المتطلبات

games-memory-advice

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

الإعلان عن التبعيات

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

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

Groovy

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

dependencies {
    // To use the Android Frame Pacing library
    implementation "androidx.games:games-frame-pacing:2.1.2"

    // To use the Android Performance Tuner
    implementation "androidx.games:games-performance-tuner:2.0.0"

    // To use the Games Activity library
    implementation "androidx.games:games-activity: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.2")

    // To use the Android Performance Tuner
    implementation("androidx.games:games-performance-tuner:2.0.0")

    // To use the Games Activity library
    implementation("androidx.games:games-activity:4.0.0")

    // To use the Games Controller Library
    implementation("androidx.games:games-controller:2.0.2")

    // To use the Games Text Input Library
    // Do not include this if games-activity has been included
    implementation("androidx.games:games-text-input:4.0.0")
}
}

لمزيد من المعلومات عن العناصر الاعتمادية، اطّلِع على مقالة إضافة عناصر الاعتماد الخاصة بالإصدار.

إضافة سمات Gradle

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

إذا كنت تستخدم الإصدار 4.0 من Android Studio، تأكَّد من أنّ gradle.properties يحتوي على السطور التالية:

# Enables experimental Prefab
android.enablePrefab=true
# Tell Android Studio we are using AndroidX
android.useAndroidX=true

إذا كنت تستخدم الإصدار 4.1 من Android Studio أو إصدارًا أحدث، تأكَّد من أنّ gradle.properties يتضمّن الأسطر التالية:

# Tell Android Studio we are using AndroidX
android.useAndroidX=true

إضافة الحِزم باستخدام CMake

لإتاحة حِزم تطوير البرامج (SDK) المستورَدة لألعاب Android، أضِف ما يلي إلىملف CMakeLists.txt في تطبيقك الرئيسي:

# Add the packages from the Android Game SDK
find_package(games-frame-pacing REQUIRED CONFIG)
find_package(games-performance-tuner REQUIRED CONFIG)

سيتيح لك ذلك تضمين ملفات الرأس من حزمة تطوير البرامج (SDK) لألعاب Android في رمز اللعبة:

#include "swappy/swappyGL.h"
#include "tuningfork/tuningfork.h"

في ملف CMakeLists.txt الخاص بالتطبيق الرئيسي، ابحث عن target_link_libraries لملف المكتبة المشترَكة الرئيسية. أضِف الإشارات إلى المكتبات الثابتة لمجموعة تطوير البرامج (SDK) لألعاب Android لتضمينها في مكتبتك المشتركة:

target_link_libraries(...
  games-frame-pacing::swappy_static
  games-performance-tuner::tuningfork_static
  ...)

الملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا واجهت مشاكل جديدة أو كان لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية عن طريق النقر على زرّ النجمة.

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

اطّلِع على مستندات أداة تتبُّع المشاكل لمزيد من المعلومات.

الإصدار 2.1 من Games-Memory-Advice

الإصدار 2.1.0-beta01

29 تشرين الثاني (نوفمبر) 2023

تم إصدار androidx.games:games-memory-advice:2.1.0-beta01. يحتوي الإصدار 2.1.0-beta01 على هذه المراجعات.

الإصدار 2.1.0-alpha01

15 تشرين الثاني (نوفمبر) 2023

تم إصدار androidx.games:games-memory-advice:2.1.0-alpha01. يحتوي الإصدار 2.1.0-alpha01 على هذه المراجعات.

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

  • تم تعديل نموذج الذاكرة في المكتبة لتقديم توقّعات أفضل.

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

  • تمت إضافة واجهة برمجة تطبيقات جديدة getAvailableMemory() تعرض تقديرًا لكمية الذاكرة التي يمكن تخصيصها بأمان، بالكيلوبايت.

الإصدار 2.1.0-alpha01

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

تم إصدار androidx.games:games-memory-advice:2.1.0-alpha01. يحتوي الإصدار 2.1.0-alpha01 على هذه المراجعات.

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

  • إضافة دالة GetAvailableMemory

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

  • تعديل نموذج "نصائح بشأن الذاكرة"
  • إصلاح استهداف الإصدار المشترك من memory_advice

Games-Memory-Advice version 2.0

الإصدار 2.0.1

20 أيلول (سبتمبر) 2023

تم إصدار androidx.games:games-memory-advice:2.0.1. يحتوي الإصدار 2.0.1 على هذه المراجعات.

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

  • إصلاح العُطل الذي يحدث في سلسلة مراقِبي الحالة بسبب عدم إرفاق السلسلة بآلة Java الافتراضية

الإصدار 2.0.0

6 أيلول (سبتمبر) 2023

تم إصدار androidx.games:games-memory-advice:2.0.0. يحتوي الإصدار 2.0.0 على هذه المراجعات.

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

  • تم تدريب نموذج تعلُّم آلي جديد وإصداره في هذا الإصدار.
  • تمّ تنفيذ واجهة برمجة تطبيقات لتوقع مقدار الذاكرة المتوفّرة.

الإصدار 2.0.0-rc01

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

تم إصدار androidx.games:games-memory-advice:2.0.0-rc01. يحتوي الإصدار 2.0.0-rc01 على هذه المراجعات.

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

  • تم تضمين نموذج جديد لتوقّع المساحة المتبقية في الذاكرة بشكل أفضل.

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

  • لا تعمل نصيحة الذاكرة الثابتة مع ملف STL مشترَك.

الإصدار 2.0.0-beta04

24 أيار (مايو) 2023

تم إصدار androidx.games:games-memory-advice:2.0.0-beta04. يحتوي الإصدار 2.0.0-beta04 على هذه المراجعات.

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

  • تم تعديل نموذج تعلُّم الآلة الذي يشغّل المكتبة، ما سيؤدي إلى تحسين النتائج على الهواتف الأحدث.

الإصدار 2.0.0-beta03

5 نيسان (أبريل) 2023

تم إصدار androidx.games:games-memory-advice:2.0.0-beta03. يحتوي الإصدار 2.0.0-beta03 على هذه المراجعات.

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

  • تم إصلاح خلل تعذّر فيه على المكتبة تحميل مواد عرض tensorflow lite المطلوبة بشكل صحيح.

الإصدار 2.0.0-beta02

22 آذار (مارس) 2023

تم إصدار androidx.games:games-memory-advice:2.0.0-beta02. يحتوي الإصدار 2.0.0-beta02 على هذه المراجعات.

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

  • تم إصلاح خلل كان يمنع ربط الإصدار الثابت من المكتبة بشكل صحيح.

الإصدار 2.0.0-beta01

22 شباط (فبراير) 2023

تم إصدار androidx.games:games-memory-advice:2.0.0-beta01. يحتوي الإصدار 2.0.0-beta01 على هذه المراجعات.

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

  • ما مِن تغييرات جديدة

الإصدار 2.0.0-alpha01

8 شباط (فبراير) 2023

تم إصدار androidx.games:games-memory-advice:2.0.0-alpha01. يحتوي الإصدار 2.0.0-alpha01 على هذه المراجعات.

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

  • زيادة كبيرة في الإصدار بسبب إعادة تنظيم ملفات التصميم

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

  • يؤدي الآن ضبط إعدادات غير صحيحة لمواد عرض المكتبة إلى ظهور خطأ بدلاً من حدوث تعذّر.

الإصدار 1.0.0 من Games-Memory-Advice

الإصدار 1.0.0-beta03

9 تشرين الثاني (نوفمبر) 2022

تم إصدار androidx.games:games-memory-advice:1.0.0-beta03. يحتوي الإصدار 1.0.0-beta03 على هذه المراجعات.

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

  • ما مِن تغييرات جديدة

الإصدار 1.0.0-beta01

9 آذار (مارس) 2022

تم إصدار androidx.games:games-memory-advice:1.0.0-beta01. يحتوي الإصدار 1.0.0-beta01 على هذه المراجعات.

  • لم يتم إجراء أي تغييرات منذ الإصدار 1.0.0-alpha01.

الإصدار 1.0.0-alpha01

23 شباط (فبراير) 2022

تم إصدار androidx.games:games-memory-advice:1.0.0-alpha01. يحتوي الإصدار 1.0.0-alpha01 على هذه المراجعات.

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

  • توفّر مكتبة C هذه إمكانية الاستعلام عن التغييرات في حالة الذاكرة لجهاز يشغّل لعبة وتلقّي إشعارات بشأنها.

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

  • هذا هو الإصدار الأولي من مكتبة نصائح الذاكرة. اطّلِع على العنوان في include/memory_advice/memory_advice.h للحصول على واجهة برمجة التطبيقات الكاملة.

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

  • تعتمد المكتبة على tensorflow، ويمكن العثور على ترخيصها وترخيص الموارد التابعة غير المباشرة على الرابط https://github.com/tensorflow/tensorflow.

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

الإصدار 3.0.4

7 آب (أغسطس) 2024

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

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

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

الإصدار 4.0 من أنشطة الألعاب

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

الإصدار 2.0.0

7 آب (أغسطس) 2024

تم إصدار androidx.games:games-performance-tuner:2.0.0. يحتوي الإصدار 2.0.0 على عمليات الربط هذه.

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

  • لم يتم إجراء أي تغييرات كبيرة منذ الإصدار 2.0.0beta01، ونحن بصدد تصنيف هذا الإصدار على أنّه مستقر.

الإصدار 2.0.0-beta01

10 كانون الثاني (يناير) 2024

تم إصدار الإصدار androidx.games:games-performance-tuner:2.0.0-beta01 بدون أي تغييرات عن الإصدار التجريبي الأخير. يحتوي الإصدار 2.0.0-beta01 على هذه المراجعات.

الإصدار 2.0.0-alpha07

29 تشرين الثاني (نوفمبر) 2023

تم إصدار androidx.games:games-performance-tuner:2.0.0-alpha07. يحتوي الإصدار 2.0.0-alpha07 على هذه المراجعات.

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

  • إصلاح مشكلة ظهور قيم غير صحيحة في تقارير قياس أداء الذاكرة في بعض الأحيان

الإصدار 2.0.0-alpha06

1 تشرين الثاني (نوفمبر) 2023

تم إصدار androidx.games:games-performance-tuner:2.0.0-alpha06. يحتوي الإصدار 2.0.0-alpha06 على هذه المراجعات.

الإصدار 2.0.0-alpha05

23 آب (أغسطس) 2023

تم إصدار androidx.games:games-performance-tuner:2.0.0-alpha05. يحتوي الإصدار 2.0.0-alpha05 على هذه المراجعات.

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

  • تم نقل مكتبة Protobuf إلى Protobuf lite.

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

  • تم إصلاح المشاكل المتعلّقة بالمؤشر المعلّق.

الإصدار 2.0.0-alpha04

19 نيسان (أبريل) 2023

تم إصدار androidx.games:games-performance-tuner:2.0.0-alpha04. يحتوي الإصدار 2.0.0-alpha04 على هذه المراجعات.

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

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

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

  • تم إصلاح خطأ كان يؤدي إلى تعطُّل المكتبة إذا كان الحد الأقصى لمفاتيح الأدوات أكبر من عدد المخططات البيانية.

الإصدار 2.0.0-alpha03

22 شباط (فبراير) 2023

تم إصدار androidx.games:games-performance-tuner:2.0.0-alpha03. يحتوي الإصدار 2.0.0-alpha03 على هذه المراجعات.

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

  • تم نقل أداة Games-Performance-Tuner إلى عملية إصدار جديدة. من المفترض ألا يحدث أي تغييرات في السلوك.

الإصدار 2.0.0-alpha02

8 شباط (فبراير) 2023

تم إصدار androidx.games:games-performance-tuner:2.0.0-alpha02. يحتوي الإصدار 2.0.0-alpha02 على هذه المراجعات.

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

  • TuningFork_predictQualityLevels تمت إضافة واجهة برمجة التطبيقات التي ستساعد في توقّع مَعلمات الدقّة أو مستوى الجودة الصحيحَين المطلوب استخدامهما.

أداة تحسين أداء الألعاب 1.6

الإصدار 1.6.1-alpha01

9 تشرين الثاني (نوفمبر) 2022

تم إصدار androidx.games:games-performance-tuner:1.6.1-alpha01. يحتوي الإصدار 1.6.1-alpha01 على هذه المراجعات.

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

  • ما مِن تغييرات جديدة

الإصدار 1.6.0

15 حزيران (يونيو) 2022

تم إصدار androidx.games:games-performance-tuner:1.6.0. يحتوي الإصدار 1.6.0 على هذه المراجعات.

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

  • تم إصلاح مشكلة عرض getpid القيمة 0 أثناء محاولة الحصول على إحصاءات الذاكرة.
  • تم إيقاف تنفيذ StopLoadingGroup بدون مجموعة تحميل نشطة.

الإصدار 1.5.0 من أداة تحسين أداء الألعاب

الإصدار 1.5.0

9 شباط (فبراير) 2022

تم إصدار androidx.games:games-performance-tuner:1.5.0. يحتوي الإصدار 1.5.0 على هذه المراجعات.

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

  • تغيير الفاصل الزمني بين عمليات التحميل آليًا بدلاً من برمجته في الإعدادات الأولية
    • الدالة التي تمت إضافتها: TuningFork_setAggregationStrategyInterval
  • حلّ مشكلة تلف الذاكرة في مفتاح واجهة برمجة التطبيقات على API<=23

الإصدار 1.5.0-rc01

26 كانون الثاني (يناير) 2022

تم إصدار androidx.games:games-performance-tuner:1.5.0-rc01. يحتوي الإصدار 1.5.0-rc01 على هذه المراجعات.

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

  • إصلاح مشكلة تلف الذاكرة في مفتاح واجهة برمجة التطبيقات على واجهة برمجة التطبيقات التي يقلّ إصدارها عن 23

الإصدار 1.5.0-beta02

15 كانون الأول (ديسمبر) 2021

تم إصدار androidx.games:games-performance-tuner:1.5.0-beta02. يحتوي الإصدار 1.5.0-beta02 على هذه المراجعات.

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

  • أزِل التغيير الذي يؤدي إلى إيقاف ABI من TuningFork_Settings.

الإصدار 1.5.0-beta01

29 أيلول (سبتمبر) 2021

تم إصدار androidx.games:games-performance-tuner:1.5.0-beta01. يحتوي الإصدار 1.5.0-beta01 على هذه المراجعات.

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

  • ما مِن تغييرات عن الإصدار التجريبي. كان هذا الإصدار يتضمّن ما يلي:
    • تغيير الفاصل الزمني بين عمليات التحميل آليًا بدلاً من برمجته في الإعدادات الأولية

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

  • ما مِن تغييرات عن الإصدار التجريبي. كان هذا الإصدار يتضمّن ما يلي:
    • الدالة الجديدة: TuningFork_setAggregationStrategyInterval
    • حقل جديد في TuningFork_Settings: aggregation_strategy_intervalms_or_count

الإصدار 1.5.0-alpha01

18 آب (أغسطس) 2021

تم إصدار androidx.games:games-performance-tuner:1.5.0-alpha01. يحتوي الإصدار 1.5.0-alpha01 على هذه المراجعات.

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

  • أصبح من الممكن الآن ضبط الفاصل الزمني بين عمليات تحميل APT آليًا، بدلاً من استخدام ملف الإعدادات.

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

  • الدالة التي تمّت إضافتها: TuningFork_setAggregationStrategyInterval
  • حقل تمت إضافته إلى بنية TuningFork_Settings: aggregation_strategy_intervalms_or_count

إصدار الأنشطة في الألعاب 1.0.0

الإصدار 1.0.0

4 آب (أغسطس) 2021

تم إصدار androidx.games:games-activity:1.0.0 وandroidx.games:games-controller:1.0.0 وandroidx.games:games-text-input:1.0.0. يحتوي الإصدار 1.0.0 على عمليات الربط هذه.

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

هذا هو الإصدار الأولي من واجهات برمجة التطبيقات Games-Activity وGames-Controller وGames-Text-Input المتوفّرة في الإصدار العلني. يُرجى الاطّلاع على صفحة AGDK الرئيسية للحصول على مزيد من المعلومات.

الإصدار 1.0.0-rc01

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

تم إصدار androidx.games:games-activity:1.0.0-rc01. يحتوي الإصدار 1.0.0-rc01 على هذه المراجعات.

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

  • تصحيح نوع الإرجاع GameActivityCallbacks::onSaveInstanceState

الإصدار 1.0.0-beta01

30 حزيران (يونيو) 2021

تم إصدار androidx.games:games-activity:1.0.0-beta01. يحتوي الإصدار 1.0.0-beta01 على هذه المراجعات.

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

  • أعِد تسمية GameActivityInputInfo إلى GameActivityPointerAxes.
  • يعرض الآن المرجع onNativeWindowResized عرض النافذة وارتفاعها.
  • تمّت إزالة طلب معاودة الاتصال onContentRectChanged.
  • تمت إعادة تسمية onLowMemory إلى onTrimMemory.
  • تمت إزالة "GameActivity_setWindowFormat".
  • نموذج ملكية محسّن لمؤشّرتي GameActivityMotionEvents وGameActivityMotionEvent
  • تم تحسين نموذج الملكية لحالة المستخدم في دالة الاستدعاء onSaveInstanceState.

الإصدار 1.0.0-alpha01

16 حزيران (يونيو) 2021

تم إصدار androidx.games:games-activity:1.0.0-alpha01.

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

  • ‫Games-Activity هي مكتبة جديدة تحلّ محل NativeActivity باعتبارها الطريقة المقترَحة لدمج لعبة C/C++ مع Android.

الإصدار 2.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.0 من أداة التحكّم في الألعاب

الإصدار 1.1.0

23 شباط (فبراير) 2022

تم إصدار androidx.games:games-activity:1.1.0 وandroidx.games:games-controller:1.1.0. يحتوي الإصدار 1.1.0 على عمليات الربط هذه.

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

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

  • الاستماع إلى WindowInsets وطلبات البحث عن الاستجابة للشاشة المُثقوبة ومحرِّر أسلوب الإدخال (IME)
  • إضافة فلاتر أحداث الحركة والأحداث الرئيسية
  • إصلاح الأخطاء:
    • إضافة الرسائل غير المتوفّرة للتوافق مع NativeActivity
    • إصلاح توقيع onNativeWindowResized
    • إصلاح حالات فقدان أحداث الإدخال

الإصدار 1.1.0-rc01

9 شباط (فبراير) 2022

تم إصدار androidx.games:games-controller:1.1.0-rc01. يحتوي الإصدار 1.1.0-rc01 على هذه المراجعات.

الإصدار 1.1.0-beta01

26 كانون الثاني (يناير) 2022

تم إصدار androidx.games:games-controller:1.1.0-beta01 بدون أي تغييرات منذ 1.1.0-alpha01. يحتوي الإصدار 1.1.0-beta01 على هذه المراجعات.

الإصدار 1.1.0-alpha01

15 كانون الأول (ديسمبر) 2021

تم إصدار androidx.games:games-controller:1.1.0-alpha01. يحتوي الإصدار 1.1.0-alpha01 على هذه المراجعات.

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

تمت إضافة إمكانية عرض حالة البطارية والاهتزاز المزدوج للمحرك والتحكّم في الإضاءة ومحور الحركة على أجهزة التحكّم المتوافقة عند تشغيلها على نظام التشغيل Android S أو الإصدارات الأحدث.

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

  • تمت إضافة الدالة Paddleboat_setMotionDataCallback لتسجيل عمليات تسجيل البيانات المتعلّقة بحركة وحدة التحكّم
  • تمت إضافة وظيفة Paddleboat_setControllerLight لتغيير إعدادات الإضاءة في وحدة التحكّم.
  • تمت إضافة بنية Paddleboat_Controller_Battery إلى Paddleboat_Controller_Data
  • الهياكل الجديدة:
    • Paddleboat_Controller_Battery
    • Paddleboat_Motion_Data
  • قوائم القيم المحدَّدة الجديدة:
    • Paddleboat_BatteryStatus
    • Paddleboat_LightType
    • Paddleboat_Motion_Type
  • علامات التحكّم الجديدة:
    • PADDLEBOAT_CONTROLLER_FLAG_ACCELEROMETER
    • PADDLEBOAT_CONTROLLER_FLAG_GYROSCOPE
    • PADDLEBOAT_CONTROLLER_FLAG_LIGHT_PLAYER
    • PADDLEBOAT_CONTROLLER_FLAG_LIGHT_RGB
    • PADDLEBOAT_CONTROLLER_FLAG_BATTERY

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

  • تمت إضافة إدخال بديل لقاعدة بيانات deviceId لوحدة تحكّم PS4
  • تمت إضافة إدخال قاعدة بيانات لواجهة برمجة التطبيقات >=31 لوحدة تحكّم PS5

الإصدار 1.0.0 من أداة التحكّم في الألعاب

الإصدار 1.0.0

4 آب (أغسطس) 2021

تم إصدار androidx.games:games-activity:1.0.0 وandroidx.games:games-controller:1.0.0 وandroidx.games:games-text-input:1.0.0. يحتوي الإصدار 1.0.0 على عمليات الربط هذه.

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

هذا هو الإصدار الأولي من واجهات برمجة التطبيقات Games-Activity وGames-Controller وGames-Text-Input المتوفّرة في الإصدار العلني. يُرجى الاطّلاع على صفحة AGDK الرئيسية للحصول على مزيد من المعلومات.

الإصدار 1.0.0-rc02

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

تم إصدار androidx.games:games-controller:1.0.0-rc02. يحتوي الإصدار 1.0.0-rc02 على هذه المراجعات.

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

  • تم إصلاح خطأ في الحزمة أدّى إلى تعذُّر استيراد Prefab في عمليات إعادة ترتيب الإصدار/البنية الفارغة وغير المستخدَمة.

الإصدار 1.0.0-rc01

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

تم إصدار androidx.games:games-controller:1.0.0-rc01. يحتوي الإصدار 1.0.0-rc01 على هذه المراجعات.

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

  • تم حلّ مشكلة عدم التوافق مع أحدث إصدار من GameActivity

الإصدار 1.0.0-beta01

30 حزيران (يونيو) 2021

تم إصدار androidx.games:games-controller:1.0.0-beta01. يحتوي الإصدار 1.0.0-beta01 على هذه المراجعات.

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

  • الدوالّ التي كانت تعرِض قيمة منطقية للنجاح أو الفشل تعرِض الآن Paddleboat_Error_Code enum.
  • تمت إعادة تسمية Paddleboat_onPause إلى Paddleboat_onStop.
  • تمت إعادة تسمية Paddleboat_onResume إلى Paddleboat_onStart.
  • تم تقسيم دالة Paddleboat_processGameActivityEvent إلى دالتَين: Paddleboat_processGameActivityKeyInputEvent وPaddleboat_processGameActivityMotionInputEvent.
  • تمت إزالة ميزات وحدة التحكّم الموسّعة التي تتطلّب إنشاء الإصدار باستخدام حزمة تطوير البرامج (SDK) لإصدار Android S في مرحلة المعاينة.
  • تمت إضافة دالة Paddleboat_getBackButtonConsumed
  • تحتوي الآن وظائف معاودة الاتصال لحالة جهاز التحكّم والفأرة على مَعلمة اختيارية تشير إلى بيانات يحدّدها المستخدم.
  • تم نقل سلسلة اسم وحدة التحكّم خارج بنية معلومات الجهاز، ويمكن الوصول إليها الآن من خلال الدالة Paddleboat_getControllerName.

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

  • تم إصلاح مشكلة عدم رصد وحدة تحكّم لا تُعرّف نفسها في البداية على أنّها وحدة تحكّم، ولكنّها تُعرّف نفسها على أنّها وحدة تحكّم لاحقًا من خلال رسالة onInputDeviceChanged.

الإصدار 1.0.0-alpha01

16 حزيران (يونيو) 2021

تم إصدار androidx.games:games-controller:1.0.0-alpha01.

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

  • ‫Games-Controller هي مكتبة جديدة توفّر واجهة برمجة تطبيقات C لرصد أجهزة وحدات التحكّم في الألعاب وقراءة الإدخال منها والتفاعل معها.

Games-Text-Input 2.1

الإصدار 2.1.0-alpha01

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

تم إصدار androidx.games:games-text-input:2.1.0-alpha01. يحتوي الإصدار 2.1.0-alpha01 على هذه المراجعات.

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

  • إتاحة وضعَي "الخطوط المتعددة" و"الخط الواحد"

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

  • إضافة دالة isSoftwareKeyboardVisible
  • إضافة تعريفات لسجلّ الأعداد الثنائية GameActivity_setImeEditorInfo
  • إضافة onEditorAction لمعاودة الاتصال

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

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

ألعاب-إدخال-النص 2.0

الإصدار 2.0.0

8 آذار (مارس) 2023

تم إصدار androidx.games:games-text-input:2.0.0. يحتوي الإصدار 2.0.0 على هذه المراجعات.

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

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

‫Games-Text-Input Version 1.1

الإصدار 1.1.2-alpha01

9 تشرين الثاني (نوفمبر) 2022

تم إصدار androidx.games:games-text-input:1.1.2-alpha01. يحتوي الإصدار 1.1.2-alpha01 على هذه المراجعات.

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

  • ما مِن تغييرات جديدة

الإصدار 1.1.1

13 تموز (يوليو) 2022

تم إصدار androidx.games:games-text-input:1.1.1. يحتوي الإصدار 1.1.1 على هذه المراجعات.

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

  • تم حلّ المشاكل المتعلّقة بملف ‎ .aar غير المتوفّر في الإصدار السابق.

الإصدار 1.1.0

9 شباط (فبراير) 2022

تم إصدار androidx.games:games-text-input:1.1.0. يحتوي الإصدار 1.1.0 على عمليات الربط هذه.

التغييرات المهمة منذ الإصدار 1.0.0 - تمت إضافة وظيفة الاستماع إلى WindowInsets وطلبات البحث إليها في GameTextInput - إضافة عنوان gamecommon.h غير المتوفّر

الإصدار 1.1.0-rc01

26 كانون الثاني (يناير) 2022

تم إصدار androidx.games:games-text-input:1.1.0-rc01. يحتوي الإصدار 1.1.0-rc01 على هذه المراجعات.

الإصدار 1.1.0-beta01

15 كانون الأول (ديسمبر) 2021

تم إصدار androidx.games:games-text-input:1.1.0-beta01. يحتوي الإصدار 1.1.0-beta01 على هذه المراجعات.

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

  • إصلاح مشكلة إدراجات IME وميزة "العرض بدون انقطاع"
  • إضافة الرأس gamecommon.h غير المتوفّر

الإصدار 1.1.0-alpha01

13 تشرين الأول (أكتوبر) 2021

تم إصدار androidx.games:games-text-input:1.1.0-alpha01. يحتوي الإصدار 1.1.0-alpha01 على هذه المراجعات.

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

  • تمت إضافة وظيفة إدراجات IME إلى GameTextInput

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

الإصدار 1.0.0

4 آب (أغسطس) 2021

تم إصدار androidx.games:games-activity:1.0.0 وandroidx.games:games-controller:1.0.0 وandroidx.games:games-text-input:1.0.0. يحتوي الإصدار 1.0.0 على عمليات الربط هذه.

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

هذا هو الإصدار الأولي من واجهات برمجة التطبيقات Games-Activity وGames-Controller وGames-Text-Input المتوفّرة في الإصدار العلني. يُرجى الاطّلاع على صفحة AGDK الرئيسية للحصول على مزيد من المعلومات.

الإصدار 1.0.0-rc01

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

تم طرح الإصدار androidx.games:games-text-input:1.0.0-rc01 بدون أي تغييرات. يحتوي الإصدار 1.0.0-rc01 على هذه المراجعات.

الإصدار 1.0.0-beta01

30 حزيران (يونيو) 2021

تم إصدار androidx.games:games-text-input:1.0.0-beta01. يحتوي الإصدار 1.0.0-beta01 على هذه المراجعات.

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

  • نموذج ملكية محسّن لعناصر GameTextInputState
  • ترتيب الأنواع لتصبح متوافقة مع NDK

الإصدار 1.0.0-alpha01

16 حزيران (يونيو) 2021

تم إصدار androidx.games:games-text-input:1.0.0-alpha01.

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

  • ‫Games-Text-Input هي مكتبة جديدة لمساعدة مطوّري الألعاب في استخدام إدخال لوحة المفاتيح المتوفّرة في Android من C/C++.

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

الإصدار 2.3.0-alpha01

26 آذار (مارس) 2025

تم إصدار androidx.games:games-frame-pacing:2.3.0-alpha01. يحتوي الإصدار 2.3.0-alpha01 على عمليات الربط هذه.

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

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

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

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

الإصدار 2.1.2

24 تموز (يوليو) 2024

تم إصدار androidx.games:games-frame-pacing:2.1.2. يحتوي الإصدار 2.1.2 على عمليات الربط هذه.

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

  • يستخدم Swappy الآن AChoreographer_postVsyncCallback من الإصدار 33 من واجهة برمجة التطبيقات لاحتساب وقت العرض بدقة أكبر. يعالج هذا الخطأ الذي كان يحدث على الأجهزة التي تعمل بمعدّل تكرار 120 لقطة في الثانية، والذي كان يؤدي إلى إسقاط اللقطات.

الإصدار 2.1.1

10 تموز (يوليو) 2024

تم إصدار androidx.games:games-frame-pacing:2.1.1. يحتوي الإصدار 2.1.1 على عمليات الربط هذه.

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

  • يجب إلغاء تسجيل مستمع العرض من Swappy بشكل صحيح لتجنُّب تعليق الجهاز.
  • إصلاح عطل في ChoreographerFilter::onSettingsChanged باستخدام قفل مشترَك تم تدميره

الإصدار 2.1.0

15 تشرين الثاني (نوفمبر) 2023

تم إصدار androidx.games:games-frame-pacing:2.1.0. يحتوي الإصدار 2.1.0 على هذه المراجعات.

الإصدار 2.1.0-rc01

20 أيلول (سبتمبر) 2023

تم إصدار androidx.games:games-frame-pacing:2.1.0-rc01. يحتوي الإصدار 2.1.0-rc01 على هذه المراجعات.

الإصدار 2.1.0-beta01

24 أيار (مايو) 2023

تم إصدار androidx.games:games-frame-pacing:2.1.0-beta01. يحتوي الإصدار 2.1.0-beta01 على هذه المراجعات.

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

  • مهلة في حال تعذّر إعداد NDKChoreographer (ef466d)
  • عند استخدام SwappyGL_getSupportedRefreshPeriodsNS معدلات تحديث طلبات البحث بشكل صريح من النظام (c85235)

الإصدار 2.1.0-alpha01

5 نيسان (أبريل) 2023

تم إصدار androidx.games:games-frame-pacing:2.1.0-alpha01. يحتوي الإصدار 2.1.0-alpha01 على هذه المراجعات.

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

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

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

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

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

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

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

الإصدار 2.0.0

8 آذار (مارس) 2023

تم إصدار androidx.games:games-frame-pacing:2.0.0. يحتوي الإصدار 2.0.0 على هذه المراجعات.

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

  • خضع نظام الإنشاء لتغييرات كبيرة أدّت إلى إنشاء مكتبة واحدة فقط بدلاً من عدة مكتبات لكل إصدار من حزمة SDK أو NDK.
  • تمت إضافة إحصاءات لقطات Vulkan.
  • تمت إضافة واجهة برمجة تطبيقات جديدة لمحو إحصاءات اللقطات.
  • تكون جميع السجلات صامتة في وضع الإصدار، ويمكن تفعيلها في وضع تصحيح الأخطاء.

الإصدار 2.0.0-rc01

22 شباط (فبراير) 2023

تم إصدار androidx.games:games-frame-pacing:2.0.0-rc01. يحتوي الإصدار 2.0.0-rc01 على هذه المراجعات.

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

  • أصبح التسجيل مخفيًا الآن خلف علامة تجميع. لا يتضمّن الإصدار العلني من المكتبة أيّ تسجيلات تلقائيًا، ويتم تفعيل جميع عمليات التسجيل في الإصدار المخصّص لتصحيح الأخطاء من المكتبة.

الإصدار 2.0.0-beta01

8 شباط (فبراير) 2023

تم إصدار androidx.games:games-frame-pacing:2.0.0-beta01. يحتوي الإصدار 2.0.0-beta01 على هذه المراجعات.

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

  • تمّت إضافة واجهة برمجة تطبيقات جديدة لحذف إحصاءات اللقطات.

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

  • تمت إضافة واجهات برمجة التطبيقات SwappyGL_clearStats وSwappyGL_clearStats.

الإصدار 2.0.0-alpha01

11 كانون الثاني (يناير) 2023

تم إصدار androidx.games:games-frame-pacing:2.0.0-alpha01. يحتوي الإصدار 2.0.0-alpha01 على هذه المراجعات.

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

  • تمّت إضافة إحصاءات إطارات Vulkan

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

  • زيادة كبيرة في الإصدار الرئيسي بسبب إعادة تنظيم ملفات الإنشاء
  • تمت إضافة 3 واجهات برمجة تطبيقات جديدة : SwappyVk_enableStats وSwappyVk_recordFrameStart وSwappyVk_getStats.

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

  • تطبيق الحدّ فقط في وضع التبديل التلقائي (Ic0786)

سرعة عرض اللقطات في الألعاب 1.10

الإصدار 1.10.2-alpha01

9 تشرين الثاني (نوفمبر) 2022

تم إصدار androidx.games:games-frame-pacing:1.10.2-alpha01. يحتوي الإصدار 1.10.2-alpha01 على هذه المراجعات.

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

  • ما مِن تغييرات جديدة

الإصدار 1.10.1

15 حزيران (يونيو) 2022

تم إصدار androidx.games:games-frame-pacing:1.10.1. يحتوي الإصدار 1.10.1 على هذه المراجعات.

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

  • إصلاح مشكلة عدم إنشاء swappy باستخدام ndk <23 و >17
  • واجهة برمجة تطبيقات معروضة لاسترداد معدّلات إعادة التحميل المتوافقة مع الشاشة

الإصدار 1.10.0

23 شباط (فبراير) 2022

تم إصدار androidx.games:games-frame-pacing:1.10.0. يحتوي الإصدار 1.10.0 على هذه المراجعات.

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

  • تجاهل إدخالات فلتر المصمّم الرقص الملوّث وتحسينها أكثر لمنع التجمّد في المحاكي
  • أضِف دوال *_uninjectTracer.

الإصدار 1.10.0-rc01

9 شباط (فبراير) 2022

تم إصدار androidx.games:games-frame-pacing:1.10.0-rc01. يحتوي الإصدار 1.10.0-rc01 على هذه المراجعات.

الإصدار 1.10.0-beta01

26 كانون الثاني (يناير) 2022

تم إصدار androidx.games:games-frame-pacing:1.10.0-beta01. يحتوي الإصدار 1.10.0-beta01 على هذه المراجعات.

الإصدار 1.10.0-alpha01

15 كانون الأول (ديسمبر) 2021

تم إصدار androidx.games:games-frame-pacing:1.10.0-alpha01. يحتوي الإصدار 1.10.0-alpha01 على هذه المراجعات.

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

  • إضافة الدالة SwappyGL_uninjectTracer

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

  • أزِل طلبات إعادة الاتصال التي تمت إضافتها سابقًا باستخدام SwappyGL_injectTracer باستخدام واجهة برمجة التطبيقات SwappyGL_uninjectTracer(const SwappyTracer *t).

‫Games Frame Pacing 1.9

الإصدار 1.9.1

13 تشرين الأول (أكتوبر) 2021

تم إصدار androidx.games:games-frame-pacing:1.9.1. يحتوي الإصدار 1.9.1 على هذه المراجعات.

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

الإصدار 1.9.0

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

تم إصدار androidx.games:games-frame-pacing:1.9.0. يحتوي الإصدار 1.9.0 على هذه المراجعات.

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

  • تم تعديله ليتوافق مع مخطّط الإصدارات الداخلي.

‫Games Frame Pacing 1.7.0

الإصدار 1.7.0

30 حزيران (يونيو) 2021

تم إصدار androidx.games:games-frame-pacing:1.7.0. يحتوي الإصدار 1.7.0 على هذه المراجعات.

الإصدار 1.7.0-rc01

2 حزيران (يونيو) 2021

تم إصدار androidx.games:games-frame-pacing:1.7.0-rc01. يحتوي الإصدار 1.7.0-rc01 على هذه المراجعات.

الإصدار 1.7.0-beta02

24 شباط (فبراير) 2021

تم إصدار androidx.games:games-frame-pacing:1.7.0-beta02.

الإصدار 1.7.0-beta01

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

تم إصدار androidx.games:games-frame-pacing:1.7.0-beta01.

أداة تحسين أداء الألعاب 1.4.3

الإصدار 2.0.0-rc01

24 تموز (يوليو) 2024

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

الإصدار 1.4.3

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

تم إصدار androidx.games:games-performance-tuner:1.4.3. يحتوي الإصدار 1.4.3 على هذه المراجعات.

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

  • تم تعديله ليتوافق مع مخطّط الإصدارات الداخلي.

أداة تحسين أداء الألعاب 1.1.0

الإصدار 1.1.0

30 حزيران (يونيو) 2021

تم إصدار androidx.games:games-performance-tuner:1.1.0. يحتوي الإصدار 1.1.0 على عمليات الربط هذه.

الإصدار 1.1.0-rc01

2 حزيران (يونيو) 2021

تم إصدار androidx.games:games-performance-tuner:1.1.0-rc01. يحتوي الإصدار 1.1.0-rc01 على عمليات الربط هذه.

الإصدار 1.1.0-beta03

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

تم إصدار androidx.games:games-performance-tuner:1.1.0-beta03.

الإصدار 1.1.0-beta02

24 شباط (فبراير) 2021

تم إصدار androidx.games:games-performance-tuner:1.1.0-beta02.

الإصدار 1.1.0-beta01

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

تم إصدار androidx.games:games-performance-tuner:1.1.0-beta01.

الإصدار 1.1.0-alpha01

تم إصدار الإصدار androidx.games:games-performance-tuner:1.1.0-alpha01.

الإصدار 1.0.0

الإصدار 1.0.0-alpha02

12 آب (أغسطس) 2020

تمت إعادة تسمية مكتبة ألعاب Android إلى مكتبة ألعاب Android.

androidx.gaming -> androidx.games

الإصدار 1.0.0-alpha01

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

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