משחקים ל-Android

ספריית המשחקים ל-Android היא העתק של Android Game SDK, שזמין להורדה כקובץ בינארי. אפשר להשתמש בספריית androidx במקום להוריד ולשלב את ה-SDK למשחקי Android בגרסה שלכם באופן ידני.

מידע נוסף על Android Game SDK זמין במסמכי ה-SDK ובנתוני הגרסה של ה-SDK.

בטבלה הזו מפורטים כל פריטי המידע בקבוצה androidx.games.

פריט מידע שנוצר בתהליך פיתוח (Artifact) גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
games-activity ‫4.0.0 - - 4.2.0-alpha01
games-controller 2.0.2 - - 2.2.0-alpha01
games-frame-pacing 2.1.3 - - 2.3.0-alpha01
games-memory-advice ‫2.0.1 - 2.1.0-beta01 2.2.0-alpha01
games-text-input ‫4.0.0 - - 4.2.0-alpha01
games-performance-tuner 2.0.0 - - 2.2.0-alpha01
הספרייה הזו עודכנה לאחרונה ב-2 ביולי 2025

דרישות

games-memory-advice

כדי להשתמש ב-MemoryAdvice API, צריך לבנות את האפליקציה עם NDK בגרסה r23.* ומעלה.

הצהרה על יחסי תלות

כדי להוסיף תלות במשחק, צריך להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין במאמר בנושא מאגר Maven של Google.

מוסיפים את יחסי התלות של הארטיפקטים שדרושים בקובץ 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"
}

Kotlin

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

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

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

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

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

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

מידע נוסף על יחסי תלות זמין במאמר הוספת יחסי תלות ב-Build.

הוספה של מאפייני Gradle

יכול להיות שתצטרכו להוסיף מאפיינים לקובץ gradle.properties שנמצא באותה תיקייה שבה נמצא קובץ build.gradle של האפליקציה (או המודול). אם הקובץ gradle.properties לא קיים, צריך ליצור אותו.

אם אתם משתמשים ב-Android Studio 4.0, ודאו שהקובץ gradle.properties מכיל את השורות הבאות:

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

אם אתם משתמשים ב-Android Studio מגרסה 4.1 ואילך, ודאו שהקובץ 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)

כך תוכלו לכלול קובצי כותרת מ-Android Game 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. נשמח לשמוע מכם אם תגלו בעיות חדשות או אם יש לכם רעיונות לשיפור הספרייה הזו. לפני שיוצרים ספרייה חדשה, כדאי לעיין בבעיות הקיימות בספרייה הזו. כדי להוסיף את ההצבעה שלכם לבעיה קיימת, לוחצים על לחצן הכוכב.

יצירת בעיה חדשה

מידע נוסף זמין במאמרי העזרה בנושא כלי המעקב אחר בעיות.

Games-Memory-Advice version 2.1

גרסה 2.1.0-beta01

‫29 בנובמבר 2023

androidx.games:games-memory-advice:2.1.0-beta01 משוחרר. גרסה 2.1.0-beta01 מכילה את הקומיטים האלה.

גרסה 2.1.0-alpha01

‫15 בנובמבר 2023

androidx.games:games-memory-advice:2.1.0-alpha01 משוחרר. גרסה 2.1.0-alpha01 מכילה את הקומיטים האלה.

תכונות חדשות

  • מודל הזיכרון של הספרייה עודכן כדי לשפר את התחזיות.

שינויים ב-API

  • נוסף API חדש getAvailableMemory() שמחזיר הערכה של כמות הזיכרון שאפשר להקצות בבטחה, בבייטים.

גרסה 2.1.0-alpha01

‫26 ביולי 2023

androidx.games:games-memory-advice:2.1.0-alpha01 משוחרר. גרסה 2.1.0-alpha01 מכילה את הקומיטים האלה.

שינויים ב-API

  • הוספת פונקציית GetAvailableMemory

תיקוני באגים

  • עדכון המודל של Memory Advice
  • תיקון יעד בנייה משותף memory_advice

Games-Memory-Advice version 2.0

גרסה 2.0.1

‫20 בספטמבר 2023

androidx.games:games-memory-advice:2.0.1 משוחרר. גרסה 2.0.1 מכילה את הקומיטים האלה.

תיקוני באגים

  • צריך לתקן את הקריסה שמתרחשת בשרשור של מעקב אחר מצב, כי השרשור לא מצורף ל-JVM.

גרסה 2.0.0

‫6 בספטמבר 2023

androidx.games:games-memory-advice:2.0.0 משוחרר. גרסה 2.0.0 מכילה את הקומיטים האלה.

התכונות העיקריות של גרסה 2.0.0

  • בגרסה הזו, מודל ML חדש אומן והושק.
  • מיושם API לחיזוי כמות הזיכרון הפנוי.

גרסה 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 מכילה את הקומיטים האלה.

שינויים ב-API

  • עלייה בגרסה הראשית בעקבות שינוי מבנה של קובצי build.

תיקוני באגים

  • הגדרה שגויה של נכסים בספרייה גורמת עכשיו להצגת שגיאה במקום לקריסה.

Games-Memory-Advice version 1.0.0

גרסה 1.0.0-beta03

9 בנובמבר 2022

androidx.games:games-memory-advice:1.0.0-beta03 משוחרר. גרסה 1.0.0-beta03 מכילה את הקומיטים האלה.

תכונות חדשות

  • אין שינויים חדשים

גרסה 1.0.0-beta01

9 במרץ 2022

androidx.games:games-memory-advice:1.0.0-beta01 משוחרר. גרסה 1.0.0-beta01 מכילה את הקומיטים האלה.

  • אין שינויים מאז גרסה 1.0.0-alpha01.

גרסה 1.0.0-alpha01

23 בפברואר 2022

androidx.games:games-memory-advice:1.0.0-alpha01 משוחרר. גרסה 1.0.0-alpha01 מכילה את הקומיטים האלה.

תכונות חדשות

  • ספריית C הזו מאפשרת לשלוח שאילתות ולקבל קריאות חוזרות לגבי שינויים במצב הזיכרון של מכשיר שמופעל בו משחק.

שינויים ב-API

  • זו הגרסה הראשונית של ספריית העצות בנושא זיכרון. ממשק ה-API המלא מופיע בכותרת של include/memory_advice/memory_advice.h.

External Contribution

Games-Text-Input Version 3.0

גרסה 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 במקשי החצים שמאלה/ימינה.

שינויים ב-API

  • ממשקי Java מיושנים של GameTextInput הוסרו.
  • ה-Prefabs של GameActivity ושל GameTextInput כוללים עכשיו את כל קובצי המקור. לא מומלץ יותר להשתמש ב-#include <GameActivity.cpp>. במקום זאת, צריך לקשר לספרייה סטטית או דינמית מתאימה, כמו game-activity::game-activity_static ב-CMake. הספריות האלה נשלחות בקובץ AAR.

תיקוני באגים

  • בוצעו תיקונים רבים בGameTextInput. תוקנו בעיות בפונקציות של הקלדה והסרה.
  • שיפרנו את התאימות עם רוב המקלדות הפופולריות לתוכנות.
  • תוקן הטיפול בתווים מיוחדים במקלדות פיזיות.
  • תוקנה גישה נדירה למצביע null ב-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 מכילה את ההתחייבויות האלה.

תיקוני באגים

  • תוקן הטיפול במצבי null pointer.
  • תוקנה בעיה שגרמה לכך שעדכוני מצב מסוימים לא נכללו בקריאה החוזרת של 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 build

גרסה 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 כוללת את הקומיטים האלה.

תיקוני באגים

  • תוקן הקיפאון שקרה כשאירועי מקלדת לא טופלו כראוי על ידי ה-looper.

גרסה 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 מכילה את הקומיטים האלה.

שינויים ב-API

  • הגודל של מבני 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

שינויים ב-API

  • כדי למנוע חריגה במערכות 32 ביט, צריך להשתמש ב-int64_t במקום ב-long בשביל historicalEventTimes
  • הוספת אמצעי תשלום (GameActivity_restartInput)
  • הוספת קריאה חוזרת (callback) מקורית לטיפול בשינוי של נראות המקלדת הווירטואלית

תיקוני באגים

  • אופטימיזציה של הטיפול באירועי מגע
  • השמדה נכונה של 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 של Games-Activity

גרסה 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 מכילה את הקומיטים האלה.

שינויים ב-API

  • בנוסף, ממשק ה-API מכיל עכשיו פרטי גרסה בפורמט GAMEACTIVITY_PACKED_VERSION. (I287e6)
  • נוסף onContentRectChanged callback שמופעל כשהמלבן בחלון שבו התוכן אמור להיות מוצב משתנה. (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 לטפל בטעינה של ספריות מקוריות.
  • תמיד טוענים את ספריית Native ב-GameActivity.onCreate.
  • אם לא נמצאה ספרייה אחרת, המערכת תחזור לטעינת הספרייה עם השם 'main'.

Games-Activity Version 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 ולהתמודד עם חיתוך של המצלמה ועם תצוגה של חלון קטן בתוך חלון גדול.

שינויים ב-API

  • 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 מכילה את הקומיטים האלה.

שינויים ב-API

  • נוספה בקשה לקבלת שיחה חוזרת (onContentRectChanged) לGameActivityCallbacks

תיקוני באגים

  • הודעות חסרות נוספו אל android_native_app_glue.h:
    • APP_CMD_CONTENT_RECT_CHANGED
    • APP_CMD_WINDOW_REDRAW_NEEDED

Games Performance Tuner 2.0

גרסה 2.0.0

‫7 באוגוסט 2024

androidx.games:games-performance-tuner:2.0.0 משוחרר. גרסה 2.0.0 מכילה את הקומטים האלה.

התכונות העיקריות של גרסה 2.0.0

  • לא בוצעו שינויים משמעותיים מאז גרסה 2.0.0beta01, אנחנו רק מסמנים את הגרסה הזו כגרסה יציבה.

גרסה 2.0.0-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 מכילה את הקומיטים האלה.

שינויים ב-API

  • TuningFork_predictQualityLevels נוסף API שיעזור לחזות את הפרמטרים הנכונים של רמת האיכות או רמת הדיוק שבהם צריך להשתמש.

Games Performance Tuner 1.6

גרסה 1.6.1-alpha01

9 בנובמבר 2022

androidx.games:games-performance-tuner:1.6.1-alpha01 משוחרר. גרסה 1.6.1-alpha01 מכילה את הקומיטים האלה.

תכונות חדשות

  • אין שינויים חדשים

גרסה 1.6.0

‫15 ביוני 2022

androidx.games:games-performance-tuner:1.6.0 משוחרר. גרסה 1.6.0 כוללת את הקומיטים האלה.

שינויים חשובים מאז גרסה 1.5.0

  • תוקנה הבעיה שבה הפונקציה getpid החזירה 0 בזמן ניסיון לקבל טלמטריה של הזיכרון.
  • הופסקה ההרצה של StopLoadingGroup בלי קבוצת טעינה פעילה.

Games Performance Tuner 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 ב-API<=23

גרסה 1.5.0-rc01

‫26 בינואר 2022

androidx.games:games-performance-tuner:1.5.0-rc01 משוחרר. גרסה 1.5.0-rc01 מכילה את הקומיטים האלה.

תיקוני באגים

  • תיקון של השחתת זיכרון במפתח API ב-API<=23

גרסה 1.5.0-beta02

15 בדצמבר 2021

androidx.games:games-performance-tuner:1.5.0-beta02 משוחרר. גרסה 1.5.0-beta02 מכילה את הקומיטים האלה.

שינויים ב-API

  • הסרת שינוי שגורם לשבירת תאימות ABI מ-TuningFork_Settings.

גרסה 1.5.0-beta01

‫29 בספטמבר 2021

androidx.games:games-performance-tuner:1.5.0-beta01 משוחרר. גרסה 1.5.0-beta01 מכילה את הקומיטים האלה.

תכונות חדשות

  • אין שינויים בהשוואה לגרסת האלפא. הגרסה הזו כללה:
    • לשנות את המרווח בין ההעלאות באופן פרוגרמטי, במקום שהוא יהיה מוצפן בהגדרות הראשוניות.

שינויים ב-API

  • אין שינויים בהשוואה לגרסת האלפא. הגרסה הזו כללה:
    • פונקציה חדשה: 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 באופן פרוגרמטי, במקום להשתמש בקובץ ההגדרות.

שינויים ב-API

  • נוספה פונקציה: TuningFork_setAggregationStrategyInterval
  • הוספת שדה למבנה TuningFork_Settings: aggregation_strategy_intervalms_or_count

Games-Activity Version 1.0.0

גרסה 1.0.0

4 באוגוסט 2021

הגרסאות androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0 ו-androidx.games:games-text-input:1.0.0 יוצאות. גרסה 1.0.0 מכילה את הקומיטים האלה.

התכונות העיקריות של גרסה 1.0.0

זוהי הגרסה הראשונה של Games-Activity, ‏ Games-Controller ו-Games-Text-Input שזמינה כגרסה יציבה. מידע נוסף זמין בדף הבית של AGDK.

גרסה 1.0.0-rc01

12 ביולי 2021

androidx.games:games-activity:1.0.0-rc01 משוחרר. גרסה 1.0.0-rc01 כוללת את הקומיטים האלה.

תיקוני באגים

  • תיקון סוג ההחזרה של GameActivityCallbacks::onSaveInstanceState

גרסה 1.0.0-beta01

‫30 ביוני 2021

androidx.games:games-activity:1.0.0-beta01 משוחרר. גרסה 1.0.0-beta01 מכילה את הקומיטים האלה.

שינויים ב-API

  • שינוי השם של GameActivityInputInfo לGameActivityPointerAxes.
  • הפונקציה להחזרת קריאה onNativeWindowResized מחזירה עכשיו את הרוחב והגובה של החלון.
  • התקשרות חזרה אל onContentRectChanged הוסרה.
  • השם של onLowMemory שונה לonTrimMemory.
  • האפשרות GameActivity_setWindowFormat הוסרה.
  • שיפור מודל הבעלות עבור מצביעים מסוג GameActivityMotionEvents ו-GameActivityMotionEvent.
  • שיפור מודל הבעלות של מצב המשתמש ב-onSaveInstanceState callback.

גרסה 1.0.0-alpha01

‫16 ביוני 2021

androidx.games:games-activity:1.0.0-alpha01 משוחרר.

תכונות חדשות

  • ‫Games-Activity היא ספרייה חדשה שמחליפה את NativeActivity כדרך המומלצת לשילוב משחק C/C++‎ עם Android.

Games-Controller Version 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)

Games-Controller Version 2.0

גרסה 2.0.2

‫12 ביוני 2024

androidx.games:games-controller:2.0.2 משוחרר. גרסה 2.0.2 מכילה את הקומטים האלה.

תיקוני באגים

  • תוקנה בעיה שבה קריאות חוזרות (callback) של בקרים מחוברים לא הופעלו עבור בקרים שכבר היו מחוברים לפני Paddleboat_init.
  • תוקנה הבעיה שבה לוחות מגע של בקרי משחקים לא רשמו לחיצות על לוח המגע ב-Paddleboat_processGameActivityMotionInputEvent בלי להפעיל ידנית את ציר הלחץ.
  • תוקנה בעיה שבה אירועים של משטחי מגע בבקרי משחקים לא סומנו כאירועים שנצרכו על ידי Paddleboat_processGameActivityMotionInputEvent.

גרסה 2.0.1

‫20 בספטמבר 2023

‫`androidx.games:games-controller:2.0.1 ' is released. גרסה 2.0.1 מכילה את הקומיטים האלה.

תיקוני באגים בשלט למשחקים:

  • תיקון מצב נדיר של NullReferenceException ב-handler של onInputDeviceChanged.
  • תיקון שמונע ממקלדות USB מסוימות להירשם באופן שגוי כשלטים למשחקים.

גרסה 2.0.0

‫8 במרץ 2023

androidx.games:games-controller:2.0.0 משוחרר. גרסה 2.0.0 מכילה את הקומיטים האלה.

התכונות העיקריות של גרסה 2.0.0

  • הוספנו אפשרות לזהות את סטטוס החיבור של מקלדות חומרה.
  • נוספה האפשרות לדווח על נתוני תנועה (ממד תאוצה/ג'ירוסקופ) מהמכשיר הראשי (כלומר, הטלפון) וגם מהבקרים.
  • שינינו את ה-API והפורמט של מסד הנתונים של הגדרות הבקר כדי לצמצם את השימוש בזיכרון ולתמוך בתכונות נוספות.

גרסה 2.0.0-alpha01

‫11 בינואר 2023

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 ומגרסאות חדשות יותר

Games-Controller Version 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 ומעלה.

שינויים ב-API

  • נוספה הפונקציה Paddleboat_setMotionDataCallback לרישום של קריאות חוזרות (callback) לנתוני תנועה של בקרים
  • נוספה פונקציה 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

תיקוני באגים

  • נוספה רשומה חלופית במסד הנתונים של מזהי המכשירים עבור בקר PS4
  • נוספה רשומה במסד הנתונים של API >=31 לבקר PS5

Games-Controller Version 1.0.0

גרסה 1.0.0

4 באוגוסט 2021

הגרסאות androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0 ו-androidx.games:games-text-input:1.0.0 יוצאות. גרסה 1.0.0 מכילה את הקומיטים האלה.

התכונות העיקריות של גרסה 1.0.0

זוהי הגרסה הראשונה של Games-Activity, ‏ Games-Controller ו-Games-Text-Input שזמינה כגרסה יציבה. מידע נוסף זמין בדף הבית של AGDK.

גרסה 1.0.0-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 מכילה את הקומיטים האלה.

שינויים ב-API

  • פונקציות שהחזירו ערך בוליאני להצלחה או לכישלון מחזירות עכשיו enum של Paddleboat_Error_Code.
  • השם של המרחב שונה על ידי Paddleboat_onPause. השם החדש הוא Paddleboat_onStop
  • השם של המרחב שונה על ידי Paddleboat_onResume. השם החדש הוא Paddleboat_onStart
  • הפונקציה Paddleboat_processGameActivityEvent פוצלה לשתי פונקציות: Paddleboat_processGameActivityKeyInputEvent ו-Paddleboat_processGameActivityMotionInputEvent
  • הוסרו תכונות מתקדמות של בקרים שדרשו בנייה מול גרסת טרום-השקה של Android S SDK
  • נוספה הפונקציה Paddleboat_getBackButtonConsumed
  • לקריאות החוזרות (callback) של מצב הבקר והעכבר יש עכשיו פרמטר אופציונלי של מצביע לנתונים שהוגדרו על ידי המשתמש
  • העברנו את המחרוזת של שם הבקר מחוץ למבנה של פרטי המכשיר, ועכשיו אפשר לגשת אליה באמצעות הפונקציה Paddleboat_getControllerName

תיקוני באגים

  • תוקנה בעיה שבה בקר שלא מדווח על עצמו כבקר בהתחלה, אבל מדווח על עצמו כבקר בהמשך באמצעות הודעה מסוג onInputDeviceChanged, לא זוהה כראוי כחיבור בקר.

גרסה 1.0.0-alpha01

‫16 ביוני 2021

androidx.games:games-controller:1.0.0-alpha01 משוחרר.

תכונות חדשות

  • ‫Games-Controller היא ספרייה חדשה שמספקת C API לזיהוי מכשירים של שלטי גיימינג, לקריאת קלט מהם ולביצוע אינטראקציה איתם.

Games-Text-Input 2.1

גרסה 2.1.0-alpha01

‫26 ביולי 2023

androidx.games:games-text-input:2.1.0-alpha01 משוחרר. גרסה 2.1.0-alpha01 מכילה את הקומיטים האלה.

תכונות חדשות

  • הוספת תמיכה במצבים של שורות מרובות ושורה אחת

שינויים ב-API

  • הוספת הפונקציה isSoftwareKeyboardVisible
  • הוספת הגדרות של שדות סיביות עבור GameActivity_setImeEditorInfo
  • הוספת קריאה חוזרת (callback) onEditorAction

תיקוני באגים

  • תיקון של בעיה שגורמת למקלדות חומרה ותוכנה להיות לא מסונכרנות
  • ניקוי המיקוד כשהמקלדת הווירטואלית מוסתרת

Games-Text-Input 2.0

גרסה 2.0.0

‫8 במרץ 2023

androidx.games:games-text-input:2.0.0 משוחרר. גרסה 2.0.0 מכילה את הקומיטים האלה.

שינויים חשובים מאז גרסה 1.1.1

  • עדכון גרסה ראשי בגלל שינויים במערכת הבנייה, אין עדכונים בספרייה או בממשק ה-API עצמם.

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 מכילה את הקומיטים האלה.

תיקוני באגים

  • תיקון של חריגות ב-Waterfall וב-IME
  • הוספת הכותרת gamecommon.h החסרה

גרסה 1.1.0-alpha01

‫13 באוקטובר 2021

androidx.games:games-text-input:1.1.0-alpha01 משוחרר. גרסה 1.1.0-alpha01 מכילה את הקומיטים האלה.

שינויים ב-API

  • נוספה פונקציונליות של IME insets ל-GameTextInput

Games-Text-Input Version 1.0

גרסה 1.0.0

4 באוגוסט 2021

הגרסאות androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0 ו-androidx.games:games-text-input:1.0.0 יוצאות. גרסה 1.0.0 מכילה את הקומיטים האלה.

התכונות העיקריות של גרסה 1.0.0

זוהי הגרסה הראשונה של Games-Activity, ‏ Games-Controller ו-Games-Text-Input שזמינה כגרסה יציבה. מידע נוסף זמין בדף הבית של AGDK.

גרסה 1.0.0-rc01

12 ביולי 2021

הגרסה androidx.games:games-text-input:1.0.0-rc01 יוצאת ללא שינויים. גרסה 1.0.0-rc01 כוללת את הקומיטים האלה.

גרסה 1.0.0-beta01

‫30 ביוני 2021

androidx.games:games-text-input:1.0.0-beta01 משוחרר. גרסה 1.0.0-beta01 מכילה את הקומיטים האלה.

שינויים ב-API

  • שיפור מודל הבעלות של אובייקטים מסוג GameTextInputState.
  • שיפור הסוגים כדי שיהיו עקביים עם NDK.

גרסה 1.0.0-alpha01

‫16 ביוני 2021

androidx.games:games-text-input:1.0.0-alpha01 משוחרר.

תכונות חדשות

  • ‫Games-Text-Input היא ספרייה חדשה שעוזרת למפתחי משחקים להשתמש בקלט של המקלדת הרכה של Android מ-C/C++.

Games Frame Pacing Version 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)

תיקוני באגים

Games Frame Pacing Version 2.1

גרסה 2.1.3

‫2 ביולי 2025

androidx.games:games-frame-pacing:2.1.3 משוחרר. גרסה 2.1.3 מכילה את ההתחייבויות האלה.

תיקוני באגים

  • האפשרות הזו מאפשרת תמיכה בגודל דף של 16KB.

גרסה 2.1.2

‫24 ביולי 2024

androidx.games:games-frame-pacing:2.1.2 משוחרר. גרסה 2.1.2 מכילה את ההתחייבויות האלה.

תיקוני באגים

  • החל מעכשיו, Swappy משתמש ב-AChoreographer_postVsyncCallback מ-API 33 כדי לחשב את זמן ההצגה בצורה מדויקת יותר. תוקן באג במכשירים עם 120Hz שגרם להשמטת פריימים.

גרסה 2.1.1

‫10 ביולי 2024

androidx.games:games-frame-pacing:2.1.1 משוחרר. גרסה 2.1.1 מכילה את ההתחייבויות האלה.

תיקוני באגים

  • ביטול הרישום של מאזין התצוגה מ-Swappy בצורה תקינה כדי למנוע קריסה.
  • תיקון קריסה ב-ChoreographerFilter::onSettingsChanged באמצעות mutex שהושמד.

גרסה 2.1.0

‫15 בנובמבר 2023

androidx.games:games-frame-pacing:2.1.0 משוחרר. גרסה 2.1.0 מכילה את הקומיטים האלה.

גרסה 2.1.0-rc01

‫20 בספטמבר 2023

androidx.games:games-frame-pacing:2.1.0-rc01 משוחרר. גרסה 2.1.0-rc01 כוללת את הקומיטים האלה.

גרסה 2.1.0-beta01

‫24 במאי 2023

androidx.games:games-frame-pacing:2.1.0-beta01 משוחרר. גרסה 2.1.0-beta01 מכילה את הקומיטים האלה.

תיקוני באגים

  • פסק זמן במקרה שהאתחול של NDKChoreographer נכשל (ef466d)
  • כשמשתמשים בקצב ריענון של שאילתות SwappyGL_getSupportedRefreshPeriodsNS באופן מפורש מהמערכת (c85235)

גרסה 2.1.0-alpha01

‫5 באפריל 2023

androidx.games:games-frame-pacing:2.1.0-alpha01 משוחרר. גרסה 2.1.0-alpha01 מכילה את הקומיטים האלה.

תכונות חדשות

  • ממשק API חדש לאיפוס מצב קצב הפריימים.
  • ‫API חדש להשבתת ההשפעה של swappy על קצב הפריימים, תוך המשך מעקב אחר זמני השימוש ב-CPU וב-GPU.

שינויים ב-API

  • עכשיו אפשר להשתמש ב-SwappyGL_resetFramePacing/SwappyVk_resetFramePacing כדי לאפס את המצב הפנימי של קצב הפריימים. מעכשיו, קצב הפריימים יתבסס רק על נתונים מהנקודה שבה מופעל ה-API לאיפוס.
  • מעכשיו אפשר להשתמש ב-SwappyGL_enableFramePacing/SwappyVk_enableFramePacing כדי להפעיל או להשבית את קצב הפריימים של Swappy. כשההגדרה מושבתת,
  • אפשר להשתמש ב-SwappyGL_enableBlockingWait/SwappyVk_enableBlockingWait כדי לקבוע אם תהיה המתנה חוסמת של פעולת ה-GPU של הפריים האחרון כשמשביתים את קצב הפריימים.

תיקוני באגים

  • שיפורים בביצועים מתבצעים במקרים שבהם יש מגבלות של GPU כשמשתמשים ב-Swappy GL API.

Games Frame Pacing Version 2.0

גרסה 2.0.0

‫8 במרץ 2023

androidx.games:games-frame-pacing:2.0.0 משוחרר. גרסה 2.0.0 מכילה את הקומיטים האלה.

שינויים חשובים מאז גרסה 1.10.1

  • מערכת ה-build עברה שינויים משמעותיים, וכתוצאה מכך נוצרת רק ספרייה אחת במקום כמה ספריות לכל גרסה של SDK/NDK.
  • נוספה סטטיסטיקת פריימים של Vulkan.
  • נוסף API חדש למחיקת נתונים סטטיסטיים של פריימים.
  • היומנים שקטים במצב הפקה, ואפשר להפעיל אותם במצב ניפוי באגים.

גרסה 2.0.0-rc01

‫22 בפברואר 2023

androidx.games:games-frame-pacing:2.0.0-rc01 משוחרר. גרסה 2.0.0-rc01 כוללת את הקומיטים האלה.

תכונות חדשות

  • הרישום ביומן מוסתר עכשיו מאחורי דגל קומפילציה. כברירת מחדל, בגרסת ה-release של הספרייה אין רישום ביומן, ובגרסת ה-debug של הספרייה כל הרישום ביומן מופעל.

גרסה 2.0.0-beta01

‫8 בפברואר 2023

androidx.games:games-frame-pacing:2.0.0-beta01 משוחרר. גרסה 2.0.0-beta01 מכילה את הקומיטים האלה.

תכונות חדשות

  • הוספנו API חדש למחיקת נתוני סטטיסטיקה של מסגרות.

שינויים ב-API

  • הוספנו את ממשקי ה-API‏ SwappyGL_clearStats ו-SwappyGL_clearStats.

גרסה 2.0.0-alpha01

‫11 בינואר 2023

androidx.games:games-frame-pacing:2.0.0-alpha01 משוחרר. גרסה 2.0.0-alpha01 מכילה את הקומיטים האלה.

תכונות חדשות

  • נוספה סטטיסטיקת מסגרות של Vulkan

שינויים ב-API

  • עלייה בגרסה הראשית בגלל שינוי מבנה של קובצי build
  • נוספו 3 ממשקי API חדשים : SwappyVk_enableStats,‏ SwappyVk_recordFrameStart ו-SwappyVk_getStats

תיקוני באגים

  • החלת ערך הסף רק במצב החלפה אוטומטית (Ic0786)

Games Frame Pacing 1.10

גרסה 1.10.2-alpha01

9 בנובמבר 2022

androidx.games:games-frame-pacing:1.10.2-alpha01 משוחרר. גרסה 1.10.2-alpha01 מכילה את הקומיטים האלה.

תכונות חדשות

  • אין שינויים חדשים

גרסה 1.10.1

‫15 ביוני 2022

androidx.games:games-frame-pacing:1.10.1 משוחרר. גרסה 1.10.1 מכילה את הקומיטים האלה.

תיקוני באגים

  • תוקנה בעיה שגרמה לכך ש-swappy לא נוצר עם ndk <23 ו->17.
  • ‫API חשוף לאחזור קצב הרענון שהמסך תומך בו.

גרסה 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.

שינויים ב-API

  • כדי להסיר קריאות חוזרות שהוספתם קודם באמצעות SwappyGL_injectTracer, צריך להשתמש ב-API‏ 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 משוחרר.

Games Performance Tuner 1.4.3

גרסה 2.0.0-rc01

‫24 ביולי 2024

androidx.games:games-performance-tuner:2.0.0-rc01 משוחרר. גרסה 2.0.0-rc01 מכילה את ההתחייבויות האלה.

גרסה 1.4.3

12 ביולי 2021

androidx.games:games-performance-tuner:1.4.3 משוחרר. גרסה 1.4.3 מכילה את הקומיטים האלה.

שינויים חשובים מאז גרסה 1.1.0

  • העדכון בוצע בהתאם לשיטת ניהול הגרסאות הפנימית.

Games Performance Tuner 1.1.0

גרסה 1.1.0

‫30 ביוני 2021

androidx.games:games-performance-tuner:1.1.0 משוחרר. גרסה 1.1.0 מכילה את הקומיטים האלה.

גרסה 1.1.0-rc01

‫2 ביוני 2021

androidx.games:games-performance-tuner:1.1.0-rc01 משוחרר. גרסה 1.1.0-rc01 מכילה את הקומיטים האלה.

גרסה 1.1.0-beta03

21 באפריל 2021

androidx.games:games-performance-tuner:1.1.0-beta03 משוחרר.

גרסה 1.1.0-beta02

24 בפברואר 2021

androidx.games:games-performance-tuner:1.1.0-beta02 משוחרר.

גרסה 1.1.0-beta01

‫16 בדצמבר 2020

androidx.games:games-performance-tuner:1.1.0-beta01 משוחרר.

גרסה 1.1.0-alpha01

‫androidx.games:games-performance-tuner:1.1.0-alpha01 פורסם.

גרסה 1.0.0

גרסה 1.0.0-alpha02

‫12 באוגוסט 2020

השם של ספריית המשחקים של Android שונה ל'ספריית המשחקים של Android'.

androidx.gaming -> androidx.games

גרסה 1.0.0-alpha01

‫10 ביוני 2020

הגרסה androidx.games:1.0.0-alpha01 הושקה.