بازی‌های اندروید

کتابخانه بازی‌های اندروید، کیت توسعه نرم‌افزاری بازی اندروید (Android Game SDK) را که به صورت باینری قابل دانلود است، منعکس می‌کند. می‌توانید به جای دانلود دستی و ادغام کیت توسعه نرم‌افزاری بازی اندروید (Android Game SDK) در ساخت خود، از کتابخانه androidx استفاده کنید.

برای اطلاعات بیشتر در مورد SDK بازی اندروید، به مستندات SDK و یادداشت‌های انتشار SDK مراجعه کنید.

این جدول تمام مصنوعات موجود در گروه androidx.games را فهرست می‌کند.

مصنوع انتشار پایدار کاندیدای انتشار انتشار بتا انتشار آلفا
بازی‌ها-فعالیت ۴.۰.۰ - - ۴.۴.۰-آلفا۰۱
دسته بازی ۲.۰.۲ - - ۲.۳.۰-آلفا۰۱
سرعت فریم در بازی‌ها ۲.۱.۳ - - ۲.۳.۰-آلفا۰۱
بازی‌ها-حافظه-نصیحت ۲.۰.۱ - ۲.۱.۰-بتا۰۱ ۲.۳.۰-آلفا۰۱
ورودی متن بازی‌ها ۴.۰.۰ - - ۴.۳.۰-آلفا۰۱
تیونر عملکرد بازی‌ها ۲.۰.۰ - - ۲.۳.۰-آلفا۰۱
این کتابخانه آخرین بار در تاریخ ۲۲ اکتبر ۲۰۲۵ به‌روزرسانی شده است.

الزامات

بازی‌ها-حافظه-نصیحت

رابط برنامه‌نویسی کاربردی MemoryAdvice ایجاب می‌کند که برنامه شما با نسخه NDK r23.* یا جدیدتر ساخته شده باشد.

اعلام وابستگی‌ها

برای افزودن وابستگی به بازی، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Maven گوگل را مطالعه کنید.

وابستگی‌های مربوط به مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید؛ کتابخانه games-activity همان نسخه کتابخانه game-text-input ادغام کرده است، از این رو برنامه‌های GameActivity نمی‌توانند وابستگی game-text-input دوباره شامل کنند:

شیار

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"
}

کاتلین

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 وجود ندارد، این فایل را ایجاد کنید.

اگر از اندروید استودیو ۴.۰ استفاده می‌کنید، مطمئن شوید که gradle.properties شامل خطوط زیر باشد:

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

اگر از اندروید استودیو ۴.۱ یا بالاتر استفاده می‌کنید، مطمئن شوید که 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 بازی اندروید در کد بازی خود وارد کنید:

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

در فایل CMakeLists.txt برنامه اصلی خود، target_link_libraries برای کتابخانه مشترک اصلی پیدا کنید. ارجاعات به کتابخانه‌های استاتیک Android Game SDK را اضافه کنید تا آنها را در کتابخانه مشترک خود بگنجانید:

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

بازخورد

بازخورد شما به بهبود Jetpack کمک می‌کند. اگر مشکلات جدیدی کشف کردید یا ایده‌هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد یک کتابخانه جدید، نگاهی به مشکلات موجود در این کتابخانه بیندازید. می‌توانید با کلیک بر روی دکمه ستاره، رأی خود را به یک مشکل موجود اضافه کنید.

ایجاد یک مسئله جدید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

بازی‌ها-حافظه-توصیه‌ها نسخه ۲.۱

نسخه ۲.۱.۰-بتا۰۱

۲۹ نوامبر ۲۰۲۳

androidx.games:games-memory-advice:2.1.0-beta01 منتشر شد. نسخه 2.1.0-beta01 شامل این کامیت‌ها است.

نسخه ۲.۱.۰-آلفا۰۱

۱۵ نوامبر ۲۰۲۳

androidx.games:games-memory-advice:2.1.0-alpha01 منتشر شد. نسخه 2.1.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • مدل حافظه کتابخانه برای پیش‌بینی‌های بهتر به‌روزرسانی شد.

تغییرات API

  • یک API جدید getAvailableMemory() اضافه شده است که تخمینی از میزان حافظه‌ای که می‌توان با خیال راحت اختصاص داد، بر حسب بایت، برمی‌گرداند.

نسخه ۲.۱.۰-آلفا۰۱

۲۶ ژوئیه ۲۰۲۳

androidx.games:games-memory-advice:2.1.0-alpha01 منتشر شد. نسخه 2.1.0-alpha01 شامل این کامیت‌ها است.

تغییرات API

  • تابع GetAvailableMemory را اضافه کنید

رفع اشکالات

  • مدل Memory Advice را به‌روزرسانی کنید
  • رفع مشکل هدف ساخت memory_advice مشترک

بازی‌ها-حافظه-توصیه‌ها نسخه ۲.۰

نسخه ۲.۰.۱

۲۰ سپتامبر ۲۰۲۳

androidx.games:games-memory-advice:2.0.1 منتشر شد. نسخه 2.0.1 شامل این کامیت‌ها است.

رفع اشکالات

  • مشکل از کار افتادن thread مربوط به state watcher که به دلیل عدم اتصال thread به JVM رخ می‌داد را برطرف کنید.

نسخه ۲.۰.۰

۶ سپتامبر ۲۰۲۳

androidx.games:games-memory-advice:2.0.0 منتشر شد. نسخه 2.0.0 شامل این کامیت‌ها است.

ویژگی‌های اصلی نسخه ۲.۰.۰

  • یک مدل یادگیری ماشین جدید در این نسخه آموزش داده شده و منتشر شده است.
  • یک API برای پیش‌بینی میزان حافظه آزاد پیاده‌سازی شده است.

نسخه ۲.۰.۰-rc01

۲۶ ژوئیه ۲۰۲۳

androidx.games:games-memory-advice:2.0.0-rc01 منتشر شد. نسخه 2.0.0-rc01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • شامل یک مدل جدید برای پیش‌بینی بهتر حافظه باقی‌مانده.

رفع اشکالات

  • رفع مشکل عدم کارکرد Memory Advice با STL مشترک.

نسخه ۲.۰.۰-بتا۰۴

۲۴ مه ۲۰۲۳

androidx.games:games-memory-advice:2.0.0-beta04 منتشر شد. نسخه 2.0.0-beta04 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • مدل یادگیری ماشینی که کتابخانه را پشتیبانی می‌کند، به‌روزرسانی شده است که نتایج بهبود یافته‌ای را برای گوشی‌های جدیدتر فراهم می‌کند.

نسخه ۲.۰.۰-بتا۰۳

۵ آوریل ۲۰۲۳

androidx.games:games-memory-advice:2.0.0-beta03 منتشر شد. نسخه 2.0.0-beta03 شامل این کامیت‌ها است.

رفع اشکالات

  • اشکالی که باعث می‌شد کتابخانه نتواند فایل‌های مورد نیاز tensorflow lite را به درستی بارگذاری کند، برطرف شد.

نسخه ۲.۰.۰-بتا۰۲

۲۲ مارس ۲۰۲۳

androidx.games:games-memory-advice:2.0.0-beta02 منتشر شد. نسخه 2.0.0-beta02 شامل این کامیت‌ها است.

رفع اشکالات

  • اشکالی که مانع از اتصال صحیح نسخه استاتیک کتابخانه می‌شد، برطرف شد.

نسخه ۲.۰.۰-بتا۰۱

۲۲ فوریه ۲۰۲۳

androidx.games:games-memory-advice:2.0.0-beta01 منتشر شد. نسخه 2.0.0-beta01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • بدون تغییرات جدید

نسخه ۲.۰.۰-alpha01

۸ فوریه ۲۰۲۳

androidx.games:games-memory-advice:2.0.0-alpha01 منتشر شد. نسخه 2.0.0-alpha01 شامل این کامیت‌ها است.

تغییرات API

  • افزایش نسخه اصلی به دلیل بازسازی فایل‌های ساخت.

رفع اشکالات

  • پیکربندی نادرست دارایی‌های کتابخانه اکنون به جای خرابی، خطا می‌دهد.

بازی‌ها-توصیه‌های حافظه نسخه ۱.۰.۰

نسخه ۱.۰.۰-بتا۰۳

۹ نوامبر ۲۰۲۲

androidx.games:games-memory-advice:1.0.0-beta03 منتشر شد. نسخه 1.0.0-beta03 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • بدون تغییرات جدید

نسخه ۱.۰.۰-بتا۰۱

۹ مارس ۲۰۲۲

androidx.games:games-memory-advice:1.0.0-beta01 منتشر شد. نسخه 1.0.0-beta01 شامل این کامیت‌ها است.

  • از زمان ۱.۰.۰-alpha01 هیچ تغییری نکرده است.

نسخه ۱.۰.۰-آلفا۰۱

۲۳ فوریه ۲۰۲۲

androidx.games:games-memory-advice:1.0.0-alpha01 منتشر شد. نسخه 1.0.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • این کتابخانه C امکان پرس‌وجو و دریافت فراخوانی‌های مجدد برای تغییرات در وضعیت حافظه دستگاهی که در حال اجرای یک بازی است را فراهم می‌کند.

تغییرات API

  • این نسخه اولیه کتابخانه توصیه‌های حافظه است. برای مشاهده API کامل، به سربرگ include/memory_advice/memory_advice.h مراجعه کنید.

مشارکت خارجی

  • این کتابخانه به tensorflow وابسته است که مجوز آن و مجوزهای وابستگی‌های انتقالی را می‌توانید در https://github.com/tensorflow/tensorflow بیابید.

بازی‌ها-ورودی متن نسخه ۳.۰

نسخه ۳.۰.۴

۷ آگوست ۲۰۲۴

androidx.games:games-text-input:3.0.4 منتشر شد. نسخه 3.0.4 شامل این کامیت‌ها است.

رفع اشکالات

  • قابلیت حذف با و بدون انتخاب متن برطرف شد.

بازی‌ها-فعالیت نسخه ۴.۰

نسخه ۴.۴.۰-آلفا۰۱

۲۲ اکتبر ۲۰۲۵

androidx.games:games-activity:4.4.0-alpha01 منتشر شد. نسخه 4.4.0-alpha01 شامل این کامیت‌ها است.

رفع اشکالات

  • بهبود محافظت ANR در native_app_glue .
  • از ALooper_pollAll منسوخ شده به ALooper_pollOnce مهاجرت کرد.

نسخه ۴.۳.۰-آلفا۰۱

۱۳ آگوست ۲۰۲۵

androidx.games:games-activity:4.3.0-alpha01 و androidx.games:games-text-input:4.3.0-alpha01 منتشر شدند. نسخه 4.3.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • به طور پیش‌فرض از اندازه صفحات ۱۶ کیلوبایتی پشتیبانی می‌کند.
  • پشتیبانی از ماوس برای GameActivity.

رفع اشکالات

  • مشکل رقابتی بین رویدادهای چرخه عمر onDestroy و onCreate برطرف شد.
  • مشکلی که باعث می‌شد برنامه‌ها برای مقداردهی اولیه کد بومی، نیاز به حفظ دستی یک نماد داشته باشند، برطرف شد.
  • بهبود کنترل لمسی GameActivity .
  • مشکل تولید نادرست GameTextInput به عنوان یک کتابخانه مشترک برطرف شد.

نسخه ۴.۲.۰-آلفا۰۱

۲۶ مارس ۲۰۲۵

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 )
  • ارتقا به جاوا ۱۷ ( 1ed0153 )

رفع اشکالات

  • رفع اشکالی در GameActivity که در آن getLocaleScript ، getLocaleCountry و getLocaleVariant به جای مقدار درخواستی، زبان محلی را گزارش می‌کردند ( 1198bb0 )
  • رفع اشکالی در GameActivity که باعث می‌شد رویدادهای باز و بسته شدن صفحه کلید نرم‌افزاری را اشتباه گزارش کنیم. ( a63ecca )
  • رفع اشکال در GameTextInput با مدیریت ایموجی‌های چند بایتی ( 9d54c68 )

نسخه ۴.۰.۰

۱۲ فوریه ۲۰۲۵

androidx.games:games-activity:4.0.0 و androidx.games:games-text-input:4.0.0 منتشر شدند. نسخه ۴.۰.۰ شامل این کامیت‌ها است.

ویژگی‌های اصلی نسخه ۴.۰.۰

  • فایل‌های AAR اکنون حاوی کتابخانه‌های استاتیک از پیش ساخته شده هستند. اکنون انتظار می‌رود کد برنامه از طریق prefabها از این کتابخانه‌ها استفاده کند و فقط هدرها (مانند #include "GameActivity.h" ) را به جای پیاده‌سازی (مانند #include "GameActivity.cpp" ) شامل شود.
  • همچنین اطلاعات محلی اندروید اکنون برای کد بومی که از GameActivity استفاده می‌کند، در دسترس است.

رفع اشکالات

  • اشکالات متعدد در GameTextInput برطرف شده است. این کتابخانه اکنون پایدارتر است و با بسیاری از صفحه کلیدهای نرم‌افزاری و سخت‌افزاری محبوب کار می‌کند.

نسخه ۴.۰.۰-rc01

۲۹ ژانویه ۲۰۲۵

androidx.games:games-activity:4.0.0-rc01 و androidx.games:games-text-input:4.0.0-rc01 منتشر شدند. نسخه 4.0.0-rc01 شامل این کامیت‌ها است.

نسخه ۴.۰.۰-بتا۰۱

۱۵ ژانویه ۲۰۲۵

androidx.games:games-activity:4.0.0-beta01 و androidx.games:games-text-input:4.0.0-beta01 منتشر شدند. نسخه 4.0.0-beta01 شامل این کامیت‌ها است.

رفع اشکالات

  • مستندسازی بهتر قابلیت‌های مرتبط با زبان که اخیراً اضافه شده‌اند.
  • انواع پشتیبان به همه انواع شمارش اضافه شد.

نسخه ۴.۰.۰-آلفا۰۱

۱۶ اکتبر ۲۰۲۴

androidx.games:games-activity:4.0.0-alpha01 و androidx.games:games-text-input:4.0.0-alpha01 منتشر شدند. نسخه 4.0.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • GameTextInput اکنون از کلیدهای چپ/راست پشتیبانی می‌کند.

تغییرات API

  • رابط‌های جاوای منسوخ‌شده‌ی GameTextInput حذف شده‌اند.
  • پیش‌ساخته‌ها برای هر دو GameActivity و GameTextInput اکنون شامل تمام فایل‌های منبع می‌شوند. #include <GameActivity.cpp> دیگر توصیه نمی‌شود. لطفاً به جای آن به یک کتابخانه استاتیک یا دینامیک مناسب، مانند game-activity::game-activity_static در CMake ، لینک دهید. این کتابخانه‌ها در فایل AAR قرار دارند.

رفع اشکالات

  • اصلاحات متعددی در GameTextInput انجام شده است. عملکرد تایپ و حذف برطرف شده است.
  • سازگاری با اکثر کیبوردهای نرم‌افزاری محبوب بهبود یافته است.
  • مشکل مدیریت کاراکترهای ویژه در کیبوردهای سخت‌افزاری برطرف شد.
  • مشکل نادر دسترسی به اشاره‌گر تهی در GameActivity برطرف شد.

بازی‌ها-فعالیت نسخه ۳.۰

نسخه ۳.۰.۵

۷ آگوست ۲۰۲۴

androidx.games:games-activity:3.0.5 منتشر شد. نسخه 3.0.5 شامل این کامیت‌ها است.

رفع اشکالات

  • نسخه جدید GameActivity برای مطابقت با نسخه ۳.۰.۴ GameTextInput (رفع مشکل حذف متن در ورودی‌ها).

نسخه ۳.۰.۴

۱۰ ژوئیه ۲۰۲۴

androidx.games:games-activity:3.0.4 منتشر شد. نسخه 3.0.4 شامل این کامیت‌ها است.

رفع اشکالات

  • مدیریت اشاره‌گرهای تهی اصلاح شد.
  • به‌روزرسانی‌های وضعیت از دست رفته برای برخی از وضعیت‌ها در فراخوانی onConfiguration() برطرف شد.

نسخه ۳.۰.۳

۱۷ آوریل ۲۰۲۴

androidx.games:games-activity:3.0.3 و androidx.games:games-text-input:3.0.3 منتشر شدند. نسخه 3.0.3 شامل این کامیت‌ها است.

رفع اشکالات

  • مشکلات سازگاری با برخی از صفحه کلیدهای نرم‌افزاری برطرف شد.

نسخه ۳.۰.۲

۳ آوریل ۲۰۲۴

androidx.games:games-activity:3.0.2 و androidx.games:games-text-input:3.0.2 منتشر شدند. نسخه 3.0.2 شامل این کامیت‌ها است.

رفع اشکالات

  • ما چندین اصلاحیه برای GamesTextInput انجام داده‌ایم که هدف آنها بهبود پشتیبانی از صفحه‌کلیدهای نرم‌افزاری و سخت‌افزاری است. همچنین اشکالی که مانع از استفاده GameTextInput بدون GameActivity می‌شد، برطرف شده است.

نسخه ۳.۰.۱

۲۰ مارس ۲۰۲۴

androidx.games:games-activity:3.0.1 و androidx.games:games-text-input:3.0.1 منتشر شدند. نسخه 3.0.1 شامل این کامیت‌ها است.

رفع اشکالات

  • مشکل تایپ و نمایش کاراکترهای ویژه برطرف شد.

نسخه ۳.۰.۰

۶ مارس ۲۰۲۴

androidx.games:games-activity:3.0.0 و androidx.games:games-text-input:3.0.0 منتشر شدند. نسخه 3.0.0 شامل این کامیت‌ها است.

ویژگی‌های اصلی نسخه ۳.۰.۰

  • GameTextInput برای استفاده در بازی‌ها بازسازی شده است.
  • برخی از رابط‌ها در هر دو کتابخانه نسبت به نسخه ۲.۰.۰ تغییر یافته‌اند.

رفع اشکالات

  • مشکلات سازگاری با NDK های قدیمی برطرف شد
  • مشکلات ساخت ویندوز برطرف شد

نسخه ۳.۰.۰-rc01

۲۱ فوریه ۲۰۲۴

androidx.games:games-activity:3.0.0-rc01 و androidx.games:games-text-input:3.0.0-rc01 منتشر شدند. نسخه 3.0.0-rc01 شامل این کامیت‌ها است.

رفع اشکالات

  • مشکل هنگ کردن برنامه در جایی که رویدادهای کیبورد به درستی توسط لوپر مدیریت نمی‌شدند، برطرف شد.

نسخه ۳.۰.۰-بتا۰۱

۲۹ نوامبر ۲۰۲۳

androidx.games:games-activity:3.0.0-beta01 و androidx.games:games-text-input:3.0.0-beta01 منتشر شدند. نسخه 3.0.0-beta01 شامل این کامیت‌ها است.

نسخه ۳.۰.۰-آلفا۰۱

۱۵ نوامبر ۲۰۲۳

androidx.games:games-activity:3.0.0-alpha01 و androidx.games:games-text-input:3.0.0-alpha01 منتشر شدند. نسخه 3.0.0-alpha01 شامل این کامیت‌ها است.

تغییرات API

  • اندازه ساختارهای GameActivityMotionEvent و GameActivityCallbacks تغییر کرد.
  • onEditorAction نوع بازگشتی خود را از boolean به void تغییر می‌دهد.
  • setImeEditorInfo اکنون پارامترهای شمارشی را می‌پذیرد، نه اعداد صحیح.
  • توابع داخلی GameActivityEvents به GameActivityEvents_internal.h منتقل می‌شوند.
  • انواع ورودی GameTextInput نیز از نوع شمارشی هستند، نه عدد صحیح.

بازی‌ها-فعالیت نسخه ۲.۱

نسخه ۲.۱.۰-آلفا۰۲

۶ سپتامبر ۲۰۲۳

androidx.games:games-activity:2.1.0-alpha02 و androidx.games:games-text-input:2.1.0-alpha02 منتشر شدند. نسخه 2.1.0-alpha02 شامل این کامیت‌ها است.

رفع اشکالات

  • سازگاری دستگاه‌های ۳۲ بیتی بهبود یافته است.

نسخه ۲.۱.۰-آلفا۰۱

۲۶ ژوئیه ۲۰۲۳

androidx.games:games-activity:2.1.0-alpha01 منتشر شد. نسخه 2.1.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • امکانی را فراهم کنید که بتوانید ایجاد نمونه SurfaceView را لغو کنید.
  • گزارش نسخه SDK را اضافه کنید

تغییرات API

  • برای جلوگیری از overrun شدن در سیستم‌های ۳۲ بیتی، به جای long از int64_t برای historicalEventTimes استفاده کنید.
  • متد GameActivity_restartInput را اضافه کنید
  • اضافه کردن یک فراخوانی بومی برای مدیریت تغییر قابلیت مشاهده صفحه کلید نرم‌افزار

رفع اشکالات

  • بهینه‌سازی مدیریت رویدادهای لمسی
  • تخریب صحیح یک GameActivityMotionEven
  • رفع مشکل محاسبه شاخص GameActivityMotionEvent_getHistoricalAxisValue
  • رفع مشکل ماسک‌های بیتی برای فیلتر حرکت

بازی‌ها-فعالیت نسخه ۲.۰

نسخه ۲.۰.۲

۲۴ مه ۲۰۲۳

androidx.games:games-activity:2.0.2 منتشر شد. نسخه 2.0.2 شامل این کامیت‌ها است.

رفع اشکالات

  • رفع مشکلات پایداری در GameActivityEvents ( b/278017467 )

نسخه ۲.۰.۱

۵ آوریل ۲۰۲۳

androidx.games:games-activity:2.0.1 منتشر شد. نسخه 2.0.1 شامل این کامیت‌ها است.

رفع اشکالات

  • رفع مشکل آزادسازی زودهنگام حافظه با historicalEventTimes .
  • مشکل سرریز شدن historicalEventTimesNanos در سیستم‌های ۳۲ بیتی برطرف شد

نسخه ۲.۰.۰

۸ مارس ۲۰۲۳

androidx.games:games-activity:2.0.0 منتشر شد. نسخه 2.0.0 شامل این کامیت‌ها است.

ویژگی‌های اصلی نسخه ۲.۰.۰

  • رابط کاربری برای زمان رویدادهای تاریخی تغییر کرد تا بر محدودیت ۳۲ بیتی غلبه شود.
  • دسترسی کاربر به تغییرات پیکربندی، مانند جهت‌گیری، فراهم شد.
  • اطلاعات به‌روز در ساختار contentRect ارائه شده است.
  • روشی آسان‌تر برای سفارشی‌سازی SurfaceView پیش‌فرض ارائه شد.
  • مدیریت پیش‌فرض سیستم‌عامل در قبال رویدادهای لمسی، مانند مدیریت دکمه‌های سیستم، اصلاح شد.
  • اکثر فراخوانی‌های JNI در مدیریت رویدادهای لمسی بهینه شده‌اند؛ این موضوع قبلاً بر عملکرد تأثیر می‌گذاشت.

نسخه ۲.۰.۰-rc01

۲۲ فوریه ۲۰۲۳

androidx.games:games-activity:2.0.0-rc01 منتشر شد. نسخه 2.0.0-rc01 شامل این کامیت‌ها است.

نسخه ۲.۰.۰-بتا۰۱

۸ فوریه ۲۰۲۳

androidx.games:games-activity:2.0.0-beta01 منتشر شد. نسخه 2.0.0-beta01 شامل این کامیت‌ها است.

رفع اشکالات

  • مشکل کار با دکمه‌های سیستم برطرف شد. ( 2a103e )

نسخه ۲.۰.۰-آلفا۰۱

۱۱ ژانویه ۲۰۲۳

androidx.games:games-activity:2.0.0-alpha01 بدون هیچ تغییری منتشر شده است. نسخه 2.0.0-alpha01 شامل این کامیت‌ها است.

بازی‌ها-فعالیت نسخه ۱.۲

نسخه ۱.۲.۲

۷ دسامبر ۲۰۲۲

androidx.games:games-activity:1.2.2 منتشر شد. نسخه ۱.۲.۲ شامل این کامیت‌ها است.

رفع اشکالات

  • اکنون می‌توان حداکثر تعداد رویدادهای حرکتی را در زمان اجرا تنظیم کرد.

نسخه ۱.۲.۲-آلفا۰۱

۹ نوامبر ۲۰۲۲

androidx.games:games-activity:1.2.2-alpha01 منتشر شد. نسخه 1.2.2-alpha01 شامل این کامیت‌ها است.

تغییرات API

  • API اکنون شامل اطلاعات نسخه نیز به شکل GAMEACTIVITY_PACKED_VERSION ( I287e6 ) است.
  • تابع فراخوانی onContentRectChanged اضافه شد که وقتی مستطیل پنجره‌ای که محتوا باید در آن قرار گیرد تغییر می‌کند، فراخوانی می‌شود ( I81396 )

رفع اشکالات

  • سرریز بافر رویدادها برطرف شد. هم inputBuffer -> keyEvents و هم motionEvents اکنون بافرهایی با تخصیص پویا هستند. ( Ic00f6 )
  • در صورت کمبود حافظه، به خوبی اجرا نمی‌شود. مدیریت خطاهای realloc() هنگام تغییر اندازه بافرها اضافه شد.

نسخه ۱.۲.۱

۱۳ ژوئیه ۲۰۲۲

androidx.games:games-activity:1.2.1 منتشر شد. نسخه ۱.۲.۱ شامل این کامیت‌ها است.

رفع اشکالات

  • مشکلات مربوط به گم شدن فایل .aar در نسخه قبلی برطرف شد.

نسخه ۱.۲.۰

۱۵ ژوئن ۲۰۲۲

androidx.games:games-activity:1.2.0 منتشر شد. نسخه ۱.۲.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۱.۰

  • به کلاس‌های مشتق‌شده از GameActivity اجازه دهید بارگذاری کتابخانه‌های بومی را مدیریت کنند.
  • همیشه کتابخانه بومی را در GameActivity.onCreate بارگذاری کنید.
  • اگر کتابخانه دیگری پیدا نشد، به بارگذاری کتابخانه با نام "main" بازگشت داده می‌شود.

بازی‌ها-فعالیت نسخه ۱.۱

نسخه ۱.۱.۰

۲۳ فوریه ۲۰۲۲

androidx.games:games-activity:1.1.0 و androidx.games:games-controller:1.1.0 منتشر شدند. نسخه ۱.۱.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۰.۰

فعالیت بازی‌ها:

  • WindowInsets در حال گوش دادن و پرس و جو برای پاسخ notch و IME است.
  • فیلترهای رویداد کلید و حرکت را اضافه کنید
  • رفع اشکالات:
    • پیام‌های از دست رفته را برای سازگاری با NativeActivity اضافه کنید
    • رفع امضای onNativeWindowResized
    • رفع تلفات رویداد ورودی

نسخه ۱.۱.۰-rc01

۹ فوریه ۲۰۲۲

androidx.games:games-activity:1.1.0-rc01 و androidx.games:games-controller:1.1.0-rc01 منتشر شدند. نسخه 1.1.0-rc01 شامل این کامیت‌ها است.

نسخه ۱.۱.۰-بتا۰۳

۲۶ ژانویه ۲۰۲۲

androidx.games:games-activity:1.1.0-beta03 منتشر شد. نسخه 1.1.0-beta03 شامل این کامیت‌ها است.

رفع اشکالات

  • رفع امضای onNativeWindowResized
  • نگه داشتن هندل کردن پنجره بومی در onSurfaceChanged

نسخه ۱.۱.۰-بتا۰۲

۱۵ دسامبر ۲۰۲۱

androidx.games:games-activity:1.1.0-beta02 منتشر شد. نسخه 1.1.0-beta02 شامل این کامیت‌ها است.

رفع اشکالات

  • رفع مشکل شرایط مسابقه در تنظیم فیلتر رویداد.

نسخه ۱.۱.۰-بتا۰۱

۱۷ نوامبر ۲۰۲۱

androidx.games:games-activity:1.1.0-beta01 منتشر شد. نسخه 1.1.0-beta01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • پشتیبانی از کوئری گرفتن از پنجره‌های داخلی و گوش دادن به تغییرات داخلی اضافه شده است. این به بازی‌ها اجازه می‌دهد تا به ظاهر شدن IME واکنش نشان دهند و با داخلی‌های برش آبشاری و دوربین کنار بیایند.

تغییرات API

  • void GameActivity_getWindowInsets(GameActivity* activity, enum GameCommonInsetsType type, GameCommonInsets* insets);

رفع اشکالات

  • از مصرف تمام رویدادهای کلیدی خودداری کنید: اکنون صدا، دوربین و غیره به سیستم منتقل می‌شوند.

نسخه ۱.۱.۰-آلفا۰۱

۲۹ سپتامبر ۲۰۲۱

androidx.games:games-activity:1.1.0-alpha01 منتشر شد. نسخه 1.1.0-alpha01 شامل این کامیت‌ها است.

تغییرات API

  • فراخوانی onContentRectChanged به GameActivityCallbacks اضافه شد

رفع اشکالات

  • پیام‌های از دست رفته به android_native_app_glue.h اضافه شدند:
    • APP_CMD_CONTENT_RECT_CHANGED
    • APP_CMD_WINDOW_REDRAW_NEEDED

تنظیم‌کننده عملکرد بازی‌ها ۲.۰

نسخه ۲.۰.۰

۷ آگوست ۲۰۲۴

androidx.games:games-performance-tuner:2.0.0 منتشر شد. نسخه 2.0.0 شامل این کامیت‌ها است.

ویژگی‌های اصلی نسخه ۲.۰.۰

  • از زمان نسخه ۲.۰.۰ بتا۰۱ هیچ تغییر عمده‌ای رخ نداده است، ما فقط این نسخه را به عنوان پایدار علامت‌گذاری می‌کنیم.

نسخه ۲.۰.۰-بتا۰۱

۱۰ ژانویه ۲۰۲۴

androidx.games:games-performance-tuner:2.0.0-beta01 بدون هیچ تغییری نسبت به آخرین نسخه آلفا منتشر شده است. نسخه 2.0.0-beta01 شامل این کامیت‌ها است.

نسخه ۲.۰.۰-آلفا۰۷

۲۹ نوامبر ۲۰۲۳

androidx.games:games-performance-tuner:2.0.0-alpha07 منتشر شد. نسخه 2.0.0-alpha07 شامل این کامیت‌ها است.

رفع اشکالات

  • رفع مشکل گزارش تله‌متری حافظه که گاهی اوقات مقادیر اشتباه را نشان می‌داد

نسخه ۲.۰.۰-alpha06

۱ نوامبر ۲۰۲۳

androidx.games:games-performance-tuner:2.0.0-alpha06 منتشر شد. نسخه 2.0.0-alpha06 شامل این کامیت‌ها است.

نسخه ۲.۰.۰-آلفا۰۵

۲۳ آگوست ۲۰۲۳

androidx.games:games-performance-tuner:2.0.0-alpha05 منتشر شد. نسخه 2.0.0-alpha05 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • کتابخانه Protobuf به Protobuf lite منتقل شد.

رفع اشکالات

  • مشکلات مربوط به اشاره‌گر آویزان برطرف شد.

نسخه ۲.۰.۰-آلفا۰۴

۱۹ آوریل ۲۰۲۳

androidx.games:games-performance-tuner:2.0.0-alpha04 منتشر شد. نسخه 2.0.0-alpha04 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • ویژگی‌های جمع‌آوری تله‌متری در کتابخانه به‌روزرسانی شد و امکان گزارش دقیق‌تر زمان رندر فریم فراهم شد.

رفع اشکالات

  • اشکالی که باعث می‌شد اگر حداکثر کلیدهای ابزار دقیق بیشتر از تعداد هیستوگرام باشند، کتابخانه از کار بیفتد، برطرف شد.

نسخه ۲.۰.۰-alpha03

۲۲ فوریه ۲۰۲۳

androidx.games:games-performance-tuner:2.0.0-alpha03 منتشر شد. نسخه 2.0.0-alpha03 شامل این کامیت‌ها است.

رفع اشکالات

  • Games-Performance-Tuner به فرآیند انتشار جدیدی منتقل شده است. نباید هیچ تغییر رفتاری ایجاد شود.

نسخه ۲.۰.۰-آلفا۰۲

۸ فوریه ۲۰۲۳

androidx.games:games-performance-tuner:2.0.0-alpha02 منتشر شد. نسخه 2.0.0-alpha02 شامل این کامیت‌ها است.

تغییرات API

  • رابط برنامه‌نویسی کاربردی TuningFork_predictQualityLevels اضافه شد؛ که به پیش‌بینی پارامترهای صحیح سطح کیفیت/وفاداری مورد استفاده کمک می‌کند.

تنظیم‌کننده عملکرد بازی‌ها ۱.۶

نسخه ۱.۶.۱-آلفا۰۱

۹ نوامبر ۲۰۲۲

androidx.games:games-performance-tuner:1.6.1-alpha01 منتشر شد. نسخه 1.6.1-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • بدون تغییرات جدید

نسخه ۱.۶.۰

۱۵ ژوئن ۲۰۲۲

androidx.games:games-performance-tuner:1.6.0 منتشر شد. نسخه ۱.۶.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۵.۰

  • مشکل برگرداندن عدد صفر توسط getpid هنگام تلاش برای دریافت تله‌متری حافظه برطرف شد.
  • اجرای StopLoadingGroup بدون یک گروه بارگذاری فعال متوقف شد.

تنظیم‌کننده عملکرد بازی‌ها ۱.۵.۰

نسخه ۱.۵.۰

۹ فوریه ۲۰۲۲

androidx.games:games-performance-tuner:1.5.0 منتشر شد. نسخه ۱.۵.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۴.۰

  • فاصله بین آپلودها را به صورت برنامه‌نویسی تغییر دهید، نه اینکه در تنظیمات اولیه به صورت پیش‌فرض تنظیم شود.
    • تابع اضافه شده: TuningFork_setAggregationStrategyInterval
  • رفع مشکل خرابی حافظه در کلید API در API<=23

نسخه ۱.۵.۰-rc01

۲۶ ژانویه ۲۰۲۲

androidx.games:games-performance-tuner:1.5.0-rc01 منتشر شد. نسخه 1.5.0-rc01 شامل این کامیت‌ها است.

رفع اشکالات

  • رفع مشکل خرابی حافظه در کلید API در API<=23

نسخه ۱.۵.۰-بتا۰۲

۱۵ دسامبر ۲۰۲۱

androidx.games:games-performance-tuner:1.5.0-beta02 منتشر شد. نسخه 1.5.0-beta02 شامل این کامیت‌ها است.

تغییرات API

  • تغییر مخرب ABI را از TuningFork_Settings حذف کنید.

نسخه ۱.۵.۰-بتا۰۱

۲۹ سپتامبر ۲۰۲۱

androidx.games:games-performance-tuner:1.5.0-beta01 منتشر شد. نسخه 1.5.0-beta01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • هیچ تغییری نسبت به نسخه آلفا وجود نداشت. آن نسخه شامل موارد زیر بود:
    • فاصله بین آپلودها را به صورت برنامه‌نویسی تغییر دهید، نه اینکه در تنظیمات اولیه به صورت پیش‌فرض تنظیم شود.

تغییرات API

  • هیچ تغییری نسبت به نسخه آلفا وجود نداشت. آن نسخه شامل موارد زیر بود:
    • تابع جدید: TuningFork_setAggregationStrategyInterval
    • فیلد جدید در TuningFork_Settings: aggregation_strategy_intervalms_or_count

نسخه ۱.۵.۰-آلفا۰۱

۱۸ آگوست ۲۰۲۱

androidx.games:games-performance-tuner:1.5.0-alpha01 منتشر شد. نسخه 1.5.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • اکنون می‌توان فاصله بین آپلودهای APT را به صورت برنامه‌نویسی تنظیم کرد، نه با استفاده از فایل تنظیمات.

تغییرات API

  • تابع اضافه شده: TuningFork_setAggregationStrategyInterval
  • فیلد به ساختار TuningFork_Settings اضافه شد: aggregation_strategy_intervalms_or_count

بازی‌ها-فعالیت نسخه ۱.۰.۰

نسخه ۱.۰.۰

۴ آگوست ۲۰۲۱

androidx.games:games-activity:1.0.0 ، androidx.games:games-controller:1.0.0 و androidx.games:games-text-input:1.0.0 منتشر شدند. نسخه ۱.۰.۰ شامل این کامیت‌ها است.

ویژگی‌های اصلی نسخه ۱.۰.۰

این نسخه اولیه و پایدار از Games-Activity، Games-Controller و Games-Text-Input است. برای اطلاعات بیشتر به صفحه اصلی AGDK مراجعه کنید.

نسخه ۱.۰.۰-rc01

۱۲ ژوئیه ۲۰۲۱

androidx.games:games-activity:1.0.0-rc01 منتشر شد. نسخه 1.0.0-rc01 شامل این کامیت‌ها است.

رفع اشکالات

  • رفع مشکل نوع بازگشتی GameActivityCallbacks::onSaveInstanceState

نسخه ۱.۰.۰-بتا۰۱

۳۰ ژوئن ۲۰۲۱

androidx.games:games-activity:1.0.0-beta01 منتشر شد. نسخه 1.0.0-beta01 شامل این کامیت‌ها است.

تغییرات API

  • نام GameActivityInputInfo را به GameActivityPointerAxes تغییر دهید.
  • تابع فراخوانی onNativeWindowResized اکنون عرض و ارتفاع پنجره را ارائه می‌دهد.
  • تابع فراخوانی onContentRectChanged حذف شده است.
  • onLowMemory به onTrimMemory تغییر نام داد.
  • GameActivity_setWindowFormat حذف شد.
  • مدل مالکیت بهبود یافته برای اشاره‌گرهای GameActivityMotionEvents و GameActivityMotionEvent .
  • مدل مالکیت وضعیت کاربر در فراخوانی onSaveInstanceState بهبود یافته است.

نسخه ۱.۰.۰-آلفا۰۱

۱۶ ژوئن ۲۰۲۱

androidx.games:games-activity:1.0.0-alpha01 منتشر شد.

ویژگی‌های جدید

  • Games-Activity یک کتابخانه جدید است که جایگزین NativeActivity به عنوان روش پیشنهادی برای ادغام یک بازی C/C++ با اندروید شده است.

نسخه ۲.۳ کنترلر بازی‌ها

نسخه ۲.۳.۰-آلفا۰۱

۱۳ آگوست ۲۰۲۵

androidx.games:games-controller:2.3.0-alpha01 ، androidx.games:games-memory-advice:2.3.0-alpha01 و androidx.games:games-performance-tuner:2.3.0-alpha01 منتشر شدند. نسخه 2.3.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • به طور پیش‌فرض از اندازه صفحات ۱۶ کیلوبایتی پشتیبانی می‌کند.

نسخه ۲.۲ کنترلر بازی‌ها

نسخه ۲.۲.۰-آلفا۰۱

۲۶ مارس ۲۰۲۵

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 )
  • ارتقا به جاوا ۱۷ ( 1ed0153 )
  • targetSdk به ۳۵ تغییر دهید ( eddf605 )

نسخه ۲.۰ کنترلر بازی‌ها

نسخه ۲.۰.۲

۱۲ ژوئن ۲۰۲۴

androidx.games:games-controller:2.0.2 منتشر شد. نسخه 2.0.2 شامل این کامیت‌ها است.

رفع اشکالات

  • مشکلی که باعث می‌شد فراخوانی‌های برگشتی متصل به کنترلر برای کنترلرهایی که قبل از Paddleboat_init متصل بودند، اجرا نشوند، برطرف شد.
  • مشکلی که باعث می‌شد تاچ‌پدهای کنترلر بازی، بدون فعال کردن دستی محور فشار، فشار دادن تاچ‌پد را در Paddleboat_processGameActivityMotionInputEvent ثبت نکنند، برطرف شد.
  • مشکلی که باعث می‌شد رویدادهای تاچ‌پد کنترلر بازی به عنوان رویدادهای مصرف‌شده توسط Paddleboat_processGameActivityMotionInputEvent علامت‌گذاری نشوند، برطرف شد.

نسخه ۲.۰.۱

۲۰ سپتامبر ۲۰۲۳

`androidx.games:games-controller:2.0.1` منتشر شد. نسخه 2.0.1 شامل این کامیت‌ها است.

رفع اشکالات کنترلر بازی:

  • شرط نادر NullReferenceException در کنترل‌کننده onInputDeviceChanged برطرف کرد.
  • رفع مشکل جلوگیری از ثبت نادرست برخی از کیبوردهای USB به عنوان دسته بازی.

نسخه ۲.۰.۰

۸ مارس ۲۰۲۳

androidx.games:games-controller:2.0.0 منتشر شد. نسخه 2.0.0 شامل این کامیت‌ها است.

ویژگی‌های اصلی نسخه ۲.۰.۰

  • قابلیت تشخیص وضعیت اتصال کیبوردهای سخت‌افزاری اضافه شد.
  • قابلیت گزارش داده‌های حرکتی (شتاب‌سنج/ژیروسکوپ) از دستگاه اصلی (یعنی گوشی) و همچنین کنترلرها اضافه شده است.
  • API و قالب پایگاه داده تعریف کنترلر تغییر داده شد تا فضای اشغال شده توسط حافظه کاهش یابد و از ویژگی‌های اضافی پشتیبانی شود.

نسخه ۲.۰.۰-alpha01

۱۱ ژانویه ۲۰۲۳

androidx.games:games-controller:2.0.0-alpha01 منتشر شد. نسخه 2.0.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • تشخیص کیبورد سخت‌افزاری
  • پشتیبانی از گزارش داده‌های حرکتی حسگر یکپارچه (یعنی دریافت داده‌های ژیروسکوپ و شتاب‌سنج از خود گوشی)
  • فرمت داده نگاشت کنترلر بهینه‌شده جدید

تغییرات API

  • API جدید، کیبورد سخت‌افزاری را فراخوانی می‌کند: Paddleboat_getPhysicalKeyboardStatus و Paddleboat_setPhysicalKeyboardStatusCallback
  • API جدید، گزارش یکپارچه داده‌های حرکتی حسگر را فراخوانی می‌کند: Paddleboat_getIntegratedMotionSensorFlags و Paddleboat_setMotionDataCallbackWithIntegratedFlags
  • API جدید، فرمت داده‌های نگاشت کنترلر اصلاح‌شده را فراخوانی می‌کند: Paddleboat_addControllerRemapDataFromFd ، Paddleboat_addControllerRemapDataFromFileBuffer
  • فراخوانی‌های قدیمی API نگاشت منسوخ شده: Paddleboat_addControllerRemapData و Paddleboat_getControllerRemapTableData

رفع اشکالات

  • مشکل سازگاری با رویدادهای حرکتی از GameActivity 1.2.2 و بالاتر برطرف شد

نسخه ۱.۱.۰ کنترلر بازی‌ها

نسخه ۱.۱.۰

۲۳ فوریه ۲۰۲۲

androidx.games:games-activity:1.1.0 و androidx.games:games-controller:1.1.0 منتشر شدند. نسخه ۱.۱.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۰.۰

فعالیت بازی‌ها:

  • WindowInsets در حال گوش دادن و پرس و جو برای پاسخ notch و IME است.
  • فیلترهای رویداد کلید و حرکت را اضافه کنید
  • رفع اشکالات:
    • پیام‌های از دست رفته را برای سازگاری با NativeActivity اضافه کنید
    • رفع امضای onNativeWindowResized
    • رفع تلفات رویداد ورودی

نسخه ۱.۱.۰-rc01

۹ فوریه ۲۰۲۲

androidx.games:games-controller:1.1.0-rc01 منتشر شد. نسخه 1.1.0-rc01 شامل این کامیت‌ها است.

نسخه ۱.۱.۰-بتا۰۱

۲۶ ژانویه ۲۰۲۲

androidx.games:games-controller:1.1.0-beta01 بدون هیچ تغییری از زمان 1.1.0-alpha01 منتشر شده است. نسخه 1.1.0-beta01 شامل این کامیت‌ها است.

نسخه ۱.۱.۰-آلفا۰۱

۱۵ دسامبر ۲۰۲۱

androidx.games:games-controller:1.1.0-alpha01 منتشر شد. نسخه 1.1.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

پشتیبانی از وضعیت باتری، لرزش دو موتوره، کنترل نور و گزارش محور حرکت در کنترلرهای پشتیبانی‌شده هنگام اجرا روی اندروید S یا بالاتر اضافه شد.

تغییرات API

  • تابع Paddleboat_setMotionDataCallback برای ثبت فراخوانی‌های داده‌های حرکتی کنترلر اضافه شد.
  • تابع Paddleboat_setControllerLight برای تغییر تنظیمات نور کنترلر اضافه شد.
  • ساختار Paddleboat_Controller_Battery به Paddleboat_Controller_Data اضافه شد
  • ساختارهای جدید:
    • Paddleboat_Controller_Battery
    • Paddleboat_Motion_Data
  • enum های جدید:
    • 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 اضافه شد

نسخه ۱.۰.۰ کنترلر بازی‌ها

نسخه ۱.۰.۰

۴ آگوست ۲۰۲۱

androidx.games:games-activity:1.0.0 ، androidx.games:games-controller:1.0.0 و androidx.games:games-text-input:1.0.0 منتشر شدند. نسخه ۱.۰.۰ شامل این کامیت‌ها است.

ویژگی‌های اصلی نسخه ۱.۰.۰

این نسخه اولیه و پایدار از Games-Activity، Games-Controller و Games-Text-Input است. برای اطلاعات بیشتر به صفحه اصلی AGDK مراجعه کنید.

نسخه ۱.۰.۰-rc02

۲۱ ژوئیه ۲۰۲۱

androidx.games:games-controller:1.0.0-rc02 منتشر شد. نسخه 1.0.0-rc02 شامل این کامیت‌ها است.

رفع اشکالات

  • خطای بسته‌بندی که باعث می‌شد ایمپورت Prefab در جایگشت‌های معماری/نسخه خالی و بلااستفاده با شکست مواجه شود، برطرف شد.

نسخه ۱.۰.۰-rc01

۱۲ ژوئیه ۲۰۲۱

androidx.games:games-controller:1.0.0-rc01 منتشر شد. نسخه 1.0.0-rc01 شامل این کامیت‌ها است.

رفع اشکالات

  • مشکل ناسازگاری با آخرین GameActivity برطرف شد.

نسخه ۱.۰.۰-بتا۰۱

۳۰ ژوئن ۲۰۲۱

androidx.games:games-controller:1.0.0-beta01 منتشر شد. نسخه 1.0.0-beta01 شامل این کامیت‌ها است.

تغییرات API

  • توابعی که برای موفقیت یا شکست یک مقدار بولی برمی‌گرداندند، اکنون یک enum از نوع Paddleboat_Error_Code برمی‌گردانند.
  • تغییر نام Paddleboat_onPause به Paddleboat_onStop
  • Paddleboat_onResume به Paddleboat_onStart تغییر نام داد
  • رویداد Paddleboat_processGameActivityEvent به دو تابع تقسیم می‌شود: Paddleboat_processGameActivityKeyInputEvent و Paddleboat_processGameActivityMotionInputEvent
  • ویژگی‌های توسعه‌یافته کنترلر که نیاز به ساخت بر اساس پیش‌نمایش Android S SDK داشتند، حذف شدند.
  • تابع Paddleboat_getBackButtonConsumed اضافه شد
  • فراخوانی‌های وضعیت کنترلر و ماوس اکنون یک پارامتر اختیاری از یک اشاره‌گر به داده‌های تعریف‌شده توسط کاربر دارند
  • رشته نام کنترلر از ساختار اطلاعات دستگاه خارج شد، اکنون از طریق تابع Paddleboat_getControllerName قابل دسترسی است.

رفع اشکالات

  • مشکلی که باعث می‌شد کنترلری که در ابتدا خود را به عنوان کنترلر معرفی نمی‌کرد، اما بعداً از طریق پیام onInputDeviceChanged این کار را انجام می‌داد، به درستی به عنوان اتصال کنترلر شناسایی نمی‌شد، برطرف شد.

نسخه ۱.۰.۰-آلفا۰۱

۱۶ ژوئن ۲۰۲۱

androidx.games:games-controller:1.0.0-alpha01 منتشر شد.

ویژگی‌های جدید

  • Games-Controller یک کتابخانه جدید است که یک API به زبان C برای تشخیص، خواندن ورودی از و تعامل با دستگاه‌های کنترل‌کننده بازی ارائه می‌دهد.

بازی‌ها-ورودی متن ۲.۱

نسخه ۲.۱.۰-آلفا۰۱

۲۶ ژوئیه ۲۰۲۳

androidx.games:games-text-input:2.1.0-alpha01 منتشر شد. نسخه 2.1.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • پشتیبانی از حالت‌های چند خطی و تک خطی را اضافه کنید

تغییرات API

  • تابع isSoftwareKeyboardVisible اضافه کنید
  • اضافه کردن تعاریف فیلد بیتی برای GameActivity_setImeEditorInfo
  • افزودن فراخوانی onEditorAction

رفع اشکالات

  • رفع مشکل همگام نبودن کیبوردهای سخت‌افزاری و نرم‌افزاری
  • فوکوس واضح هنگام پنهان شدن صفحه‌کلید نرم‌افزاری

بازی‌ها-ورودی متن ۲.۰

نسخه ۲.۰.۰

۸ مارس ۲۰۲۳

androidx.games:games-text-input:2.0.0 منتشر شد. نسخه 2.0.0 شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۱.۱

  • به‌روزرسانی عمده نسخه به دلیل تغییرات در سیستم ساخت، هیچ به‌روزرسانی در خود کتابخانه/API وجود ندارد.

بازی‌ها-ورودی متن نسخه ۱.۱

نسخه ۱.۱.۲-آلفا۰۱

۹ نوامبر ۲۰۲۲

androidx.games:games-text-input:1.1.2-alpha01 منتشر شد. نسخه 1.1.2-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • بدون تغییرات جدید

نسخه ۱.۱.۱

۱۳ ژوئیه ۲۰۲۲

androidx.games:games-text-input:1.1.1 منتشر شد. نسخه ۱.۱.۱ شامل این کامیت‌ها است.

رفع اشکالات

  • مشکلات مربوط به گم شدن فایل .aar در نسخه قبلی برطرف شد.

نسخه ۱.۱.۰

۹ فوریه ۲۰۲۲

androidx.games:games-text-input:1.1.0 منتشر شد. نسخه ۱.۱.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان انتشار نسخه ۱.۰.۰ - قابلیت شنود و پرس‌وجوی WindowInsets به GameTextInput اضافه شد - هدر gamecommon.h که وجود ندارد اضافه شد

نسخه ۱.۱.۰-rc01

۲۶ ژانویه ۲۰۲۲

androidx.games:games-text-input:1.1.0-rc01 منتشر شد. نسخه 1.1.0-rc01 شامل این کامیت‌ها است.

نسخه ۱.۱.۰-بتا۰۱

۱۵ دسامبر ۲۰۲۱

androidx.games:games-text-input:1.1.0-beta01 منتشر شد. نسخه 1.1.0-beta01 شامل این کامیت‌ها است.

رفع اشکالات

  • رفع مشکل درج آبشاری و IME
  • هدر gamecommon.h که وجود ندارد را اضافه کنید

نسخه ۱.۱.۰-آلفا۰۱

۱۳ اکتبر ۲۰۲۱

androidx.games:games-text-input:1.1.0-alpha01 منتشر شد. نسخه 1.1.0-alpha01 شامل این کامیت‌ها است.

تغییرات API

  • قابلیت درج IME به GameTextInput اضافه شد

بازی‌ها-ورودی متن نسخه ۱.۰

نسخه ۱.۰.۰

۴ آگوست ۲۰۲۱

androidx.games:games-activity:1.0.0 ، androidx.games:games-controller:1.0.0 و androidx.games:games-text-input:1.0.0 منتشر شدند. نسخه ۱.۰.۰ شامل این کامیت‌ها است.

ویژگی‌های اصلی نسخه ۱.۰.۰

این نسخه اولیه و پایدار از Games-Activity، Games-Controller و Games-Text-Input است. برای اطلاعات بیشتر به صفحه اصلی AGDK مراجعه کنید.

نسخه ۱.۰.۰-rc01

۱۲ ژوئیه ۲۰۲۱

androidx.games:games-text-input:1.0.0-rc01 بدون هیچ تغییری منتشر شده است. نسخه 1.0.0-rc01 شامل این کامیت‌ها است.

نسخه ۱.۰.۰-بتا۰۱

۳۰ ژوئن ۲۰۲۱

androidx.games:games-text-input:1.0.0-beta01 منتشر شد. نسخه 1.0.0-beta01 شامل این کامیت‌ها است.

تغییرات API

  • مدل مالکیت بهبود یافته اشیاء GameTextInputState.
  • مرتب‌سازی انواع داده برای سازگاری با NDK.

نسخه ۱.۰.۰-آلفا۰۱

۱۶ ژوئن ۲۰۲۱

androidx.games:games-text-input:1.0.0-alpha01 منتشر شد.

ویژگی‌های جدید

  • Games-Text-Input یک کتابخانه جدید است که به توسعه‌دهندگان بازی کمک می‌کند تا از ورودی صفحه‌کلید نرم‌افزاری اندروید از C/C++ استفاده کنند.

بازی‌ها فریم ریت نسخه ۲.۳

نسخه ۲.۳.۰-آلفا۰۱

۲۶ مارس ۲۰۲۵

androidx.games:games-frame-pacing:2.3.0-alpha01 منتشر شد. نسخه 2.3.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • ارتقا به Gradle 8.8.1 ( 1ed0153 )
  • ارتقا به جاوا ۱۷ ( 1ed0153 )
  • targetSdk به ۳۵ تغییر دهید ( eddf605 )

رفع اشکالات

بازی‌ها با ریتم فریم نسخه ۲.۱

نسخه ۲.۱.۳

۲ ژوئیه ۲۰۲۵

androidx.games:games-frame-pacing:2.1.3 منتشر شد. نسخه 2.1.3 شامل این کامیت‌ها است.

رفع اشکالات

  • پشتیبانی از اندازه صفحه ۱۶ کیلوبایت را فعال می‌کند.

نسخه ۲.۱.۲

۲۴ ژوئیه ۲۰۲۴

androidx.games:games-frame-pacing:2.1.2 منتشر شد. نسخه 2.1.2 شامل این کامیت‌ها است.

رفع اشکالات

  • Swappy اکنون از AChoreographer_postVsyncCallback از API 33 برای محاسبه دقیق‌تر زمان ارائه استفاده می‌کند. این مورد اشکالی را که در دستگاه‌های ۱۲۰ هرتزی باعث افت فریم‌ها می‌شد، برطرف می‌کند.

نسخه ۲.۱.۱

۱۰ ژوئیه ۲۰۲۴

androidx.games:games-frame-pacing:2.1.1 منتشر شد. نسخه 2.1.1 شامل این کامیت‌ها است.

رفع اشکالات

  • برای جلوگیری از هنگ کردن، شنونده نمایش (display listener) را به درستی از swappy لغو ثبت کنید.
  • رفع مشکل کرش در ChoreographerFilter::onSettingsChanged با استفاده از mutex نابود شده.

نسخه ۲.۱.۰

۱۵ نوامبر ۲۰۲۳

androidx.games:games-frame-pacing:2.1.0 منتشر شد. نسخه 2.1.0 شامل این کامیت‌ها است.

نسخه ۲.۱.۰-rc01

۲۰ سپتامبر ۲۰۲۳

androidx.games:games-frame-pacing:2.1.0-rc01 is released. Version 2.1.0-rc01 contains these commits.

Version 2.1.0-beta01

May 24, 2023

androidx.games:games-frame-pacing:2.1.0-beta01 is released. Version 2.1.0-beta01 contains these commits.

رفع اشکالات

  • Timeout in case NDKChoreographer initialization fails ( ef466d )
  • When using SwappyGL_getSupportedRefreshPeriodsNS query refresh rates explicitly from the system ( c85235 )

Version 2.1.0-alpha01

۵ آوریل ۲۰۲۳

androidx.games:games-frame-pacing:2.1.0-alpha01 is released. Version 2.1.0-alpha01 contains these commits.

ویژگی‌های جدید

  • New API to reset the frame-pacing state.
  • New API to disable swappy's frame-pacing impact while still observing the CPU & GPU times.

تغییرات API

  • SwappyGL_resetFramePacing/SwappyVk_resetFramePacing can now be used to reset the internal frame-pacing state. The frame pacing will now only consider data from the point when the reset API is called.
  • SwappyGL_enableFramePacing/SwappyVk_enableFramePacing can now be used to enable/disable swappy's frame pacing. When disabled,
  • SwappyGL_enableBlockingWait/SwappyVk_enableBlockingWait can be used to control whether a blocking wait of the last frame's GPU work happens when frame-pacing is disabled.

رفع اشکالات

  • Performance improvements are made for GPU bound cases when using Swappy GL API.

Games Frame Pacing Version 2.0

نسخه ۲.۰.۰

۸ مارس ۲۰۲۳

androidx.games:games-frame-pacing:2.0.0 is released. Version 2.0.0 contains these commits.

Important changes since 1.10.1

  • The build system went through major changes leading to only one library generated instead of multiple per SDK/NDK version.
  • Vulkan Frame Statistics are added.
  • A new API for clearing frame statistics is added.
  • The logs are all silent in release mode, they can be enabled in debug mode.

Version 2.0.0-rc01

۲۲ فوریه ۲۰۲۳

androidx.games:games-frame-pacing:2.0.0-rc01 is released. Version 2.0.0-rc01 contains these commits.

ویژگی‌های جدید

  • Logging is now hidden behind a compile flag. By default release build of the library has no logging, and debug release of the library has all the logging turned on.

Version 2.0.0-beta01

February 8, 2023

androidx.games:games-frame-pacing:2.0.0-beta01 is released. Version 2.0.0-beta01 contains these commits.

ویژگی‌های جدید

  • New API introduced to clear frame statistics.

تغییرات API

  • Added SwappyGL_clearStats and SwappyGL_clearStats APIs.

Version 2.0.0-alpha01

۱۱ ژانویه ۲۰۲۳

androidx.games:games-frame-pacing:2.0.0-alpha01 is released. Version 2.0.0-alpha01 contains these commits.

ویژگی‌های جدید

  • Added vulkan frame statistics

تغییرات API

  • Major version increase due to build files refactoring
  • Added 3 new APIs : SwappyVk_enableStats , SwappyVk_recordFrameStart , and SwappyVk_getStats

رفع اشکالات

  • Apply threshold only in auto swap mode ( Ic0786 )

Games Frame Pacing 1.10

Version 1.10.2-alpha01

۹ نوامبر ۲۰۲۲

androidx.games:games-frame-pacing:1.10.2-alpha01 is released. Version 1.10.2-alpha01 contains these commits.

ویژگی‌های جدید

  • No new changes

Version 1.10.1

June 15, 2022

androidx.games:games-frame-pacing:1.10.1 is released. Version 1.10.1 contains these commits.

رفع اشکالات

  • Fix for swappy not building with ndk <23 and >17.
  • Exposed API to retrieve the refresh rates supported by the display.

Version 1.10.0

۲۳ فوریه ۲۰۲۲

androidx.games:games-frame-pacing:1.10.0 is released. Version 1.10.0 contains these commits.

Important changes since 1.9.0

  • Ignore polluting choreographer filter inputs and smooth more to prevent freezes on emulator
  • Add *_uninjectTracer functions.

Version 1.10.0-rc01

۹ فوریه ۲۰۲۲

androidx.games:games-frame-pacing:1.10.0-rc01 is released. Version 1.10.0-rc01 contains these commits.

Version 1.10.0-beta01

۲۶ ژانویه ۲۰۲۲

androidx.games:games-frame-pacing:1.10.0-beta01 is released. Version 1.10.0-beta01 contains these commits.

Version 1.10.0-alpha01

۱۵ دسامبر ۲۰۲۱

androidx.games:games-frame-pacing:1.10.0-alpha01 is released. Version 1.10.0-alpha01 contains these commits.

ویژگی‌های جدید

  • Addition of SwappyGL_uninjectTracer function.

تغییرات API

  • Remove callbacks that were previously added using SwappyGL_injectTracer by using SwappyGL_uninjectTracer(const SwappyTracer *t) API.

Games Frame Pacing 1.9

Version 1.9.1

۱۳ اکتبر ۲۰۲۱

androidx.games:games-frame-pacing:1.9.1 is released. Version 1.9.1 contains these commits.

رفع اشکالات

Version 1.9.0

July 12, 2021

androidx.games:games-frame-pacing:1.9.0 is released. Version 1.9.0 contains these commits.

Important changes since 1.7.0

  • Updated to match internal versioning scheme.

Games Frame Pacing 1.7.0

Version 1.7.0

۳۰ ژوئن ۲۰۲۱

androidx.games:games-frame-pacing:1.7.0 is released. Version 1.7.0 contains these commits.

Version 1.7.0-rc01

۲ ژوئن ۲۰۲۱

androidx.games:games-frame-pacing:1.7.0-rc01 is released. Version 1.7.0-rc01 contains these commits.

Version 1.7.0-beta02

۲۴ فوریه ۲۰۲۱

androidx.games:games-frame-pacing:1.7.0-beta02 is released.

Version 1.7.0-beta01

۱۶ دسامبر ۲۰۲۰

androidx.games:games-frame-pacing:1.7.0-beta01 is released.

Games Performance Tuner 1.4.3

Version 2.0.0-rc01

۲۴ ژوئیه ۲۰۲۴

androidx.games:games-performance-tuner:2.0.0-rc01 is released. Version 2.0.0-rc01 contains these commits .

Version 1.4.3

July 12, 2021

androidx.games:games-performance-tuner:1.4.3 is released. Version 1.4.3 contains these commits.

تغییرات مهم از زمان ۱.۱.۰

  • Updated to match internal versioning scheme.

Games Performance Tuner 1.1.0

نسخه ۱.۱.۰

۳۰ ژوئن ۲۰۲۱

androidx.games:games-performance-tuner:1.1.0 is released. Version 1.1.0 contains these commits.

نسخه ۱.۱.۰-rc01

۲ ژوئن ۲۰۲۱

androidx.games:games-performance-tuner:1.1.0-rc01 is released. Version 1.1.0-rc01 contains these commits.

Version 1.1.0-beta03

۲۱ آوریل ۲۰۲۱

androidx.games:games-performance-tuner:1.1.0-beta03 is released.

نسخه ۱.۱.۰-بتا۰۲

۲۴ فوریه ۲۰۲۱

androidx.games:games-performance-tuner:1.1.0-beta02 is released.

نسخه ۱.۱.۰-بتا۰۱

۱۶ دسامبر ۲۰۲۰

androidx.games:games-performance-tuner:1.1.0-beta01 is released.

نسخه ۱.۱.۰-آلفا۰۱

androidx.games:games-performance-tuner:1.1.0-alpha01 is released.

نسخه ۱.۰.۰

نسخه ۱.۰.۰-آلفا۰۲

۱۲ آگوست ۲۰۲۰

The Android Gaming library was renamed to the Android Games library.

androidx.gaming -> androidx.games

نسخه ۱.۰.۰-آلفا۰۱

June 10, 2020

androidx.games:1.0.0-alpha01 is released.