משחקים ל-Android

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

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

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

פריט מידע שנוצר בתהליך פיתוח (Artifact) גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
games-activity 4.4.0 - - -
games-controller 2.0.2 - - ‎2.3.0-alpha01
games-frame-pacing 2.1.3 - - ‎2.3.0-alpha01
games-memory-advice 2.0.1 - ‎2.1.0-beta01 ‎2.3.0-alpha01
games-text-input 4.3.0 - - -
games-performance-tuner 2.0.0 - - ‎2.3.0-alpha01
הספרייה הזו עודכנה לאחרונה בתאריך: 11 במרץ 2026

דרישות

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.4.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.3.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.4.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.3.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)

כך תוכלו לכלול קובצי כותרת מ-SDK למשחק ב-Android בקוד המשחק:

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

בקובץ CMakeLists.txt של האפליקציה הראשית, מחפשים את target_link_libraries של הספרייה המשותפת הראשית. מוסיפים את ההפניות לספריות הסטטיות של SDK למשחק ב-Android כדי לכלול אותן בספרייה המשותפת:

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

משוב

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

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

מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.

Games-Memory-Advice version 2.1

גרסה ‎2.1.0-beta01

‫29 בנובמבר 2023

androidx.games:games-memory-advice:2.1.0-beta01 מופץ. גרסה ‎2.1.0-beta01 מכילה את השמירות האלה.

גרסה ‎2.1.0-alpha01

‫15 בנובמבר 2023

androidx.games:games-memory-advice:2.1.0-alpha01 מופץ. גרסה ‎2.1.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

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

שינויים ב-API

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

גרסה ‎2.1.0-alpha01

‫26 ביולי 2023

androidx.games:games-memory-advice:2.1.0-alpha01 מופץ. גרסה ‎2.1.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

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

תיקוני באגים

  • עדכון המודל של ההמלצות לשיפור הזיכרון
  • תיקון יעד build משותף memory_advice

גרסה 2.0 של Games-Memory-Advice

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

תיקוני באגים

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

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

שינויים ב-API

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

External Contribution

Games-Text-Input Version 4.3

גרסה 4.3.0

‫11 במרץ 2026

androidx.games:games-text-input:4.3.0 מופץ. גרסה 4.3.0 מכילה את השמירות האלה.

גרסה ‎4.3.0-rc01

‫28 בינואר 2026

androidx.games:games-text-input:4.3.0-rc01 מופץ. גרסה ‎4.3.0-rc01 מכילה את השמירות האלה.

גרסה ‎4.3.0-beta01

‫19 בנובמבר 2025

androidx.games:games-text-input:4.3.0-beta01 מופץ. גרסה ‎4.3.0-beta01 מכילה את השמירות האלה.

  • בגרסה הזו, androidx.games:games-text-input עובר מאלפא לבטא.

גרסה 3.0 של Games-Text-Input

גרסה 3.0.4

‫7 באוגוסט 2024

androidx.games:games-text-input:3.0.4 מופץ. גרסה 3.0.4 מכילה את השמירות האלה.

תיקוני באגים

  • תוקנה הפונקציונליות של מחיקה עם ובלי בחירת טקסט.

Games-Activity Version 4

גרסה 4.4.0

‫11 במרץ 2026

androidx.games:games-activity:4.4.0 מופץ. גרסה 4.4.0 מכילה את השמירות האלה.

גרסה ‎4.4.0-rc01

‫28 בינואר 2026

androidx.games:games-activity:4.4.0-rc01 מופץ. גרסה ‎4.4.0-rc01 מכילה את השמירות האלה.

גרסה ‎4.4.0-beta01

‫19 בנובמבר 2025

androidx.games:games-activity:4.4.0-beta01 מופץ. גרסה ‎4.4.0-beta01 מכילה את השמירות האלה.

  • בגרסה הזו, androidx.games:games-activity עובר מאלפא לבטא.

גרסה ‎4.4.0-alpha01

‫22 באוקטובר 2025

androidx.games:games-activity:4.4.0-alpha01 מופץ. גרסה ‎4.4.0-alpha01 מכילה את השמירות האלה.

תיקוני באגים

  • הגנה משופרת מפני שגיאות ANR ב-native_app_glue.
  • הועבר מ-ALooper_pollAll שהוצא משימוש אל ALooper_pollOnce.

גרסה ‎4.3.0-alpha01

‫13 באוגוסט 2025

androidx.games:games-activity:4.3.0-alpha01 וגם androidx.games:games-text-input:4.3.0-alpha01 מופצים. גרסה ‎4.3.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

  • תמיכה בגודל דף של 16KB כברירת מחדל.
  • תמיכה בעכבר ב-GameActivity.

תיקוני באגים

  • תוקן מצב מירוץ בין אירועים במחזור החיים onDestroy לבין onCreate.
  • נפתרה בעיה שבה היה צורך לשמור סמל באופן ידני באפליקציות כדי לאתחל קוד Native.
  • שיפרנו את הטיפול במגע GameActivity.
  • תוקן באג שגרם ליצירה של GameTextInput כספרייה משותפת באופן שגוי.

גרסה ‎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 זמינים עכשיו לקוד Native שמשתמש ב-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 של Games-Activity

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

שינויים ב-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)
  • נוסף קריאה חוזרת (callback) ‏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 לטפל בטעינה של ספריית Native.
  • תמיד טוענים את ספריית 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

  • נוספה בקשה לחזרה לשיחה (callback) אל onContentRectChangedGameActivityCallbacks

תיקוני באגים

  • הודעות חסרות נוספו אל 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

גרסה 1.0.0 של Games-Activity

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

גרסה ‎2.3.0-alpha01

‫13 באוגוסט 2025

הגרסאות androidx.games:games-controller:2.3.0-alpha01, androidx.games:games-memory-advice:2.3.0-alpha01 ו-androidx.games:games-performance-tuner:2.3.0-alpha01 יוצאות. גרסה ‎2.3.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

  • תמיכה בגודלי דפים של 16KB כברירת מחדל.

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 ' יצאה לאור. גרסה 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 ומגרסאות חדשות יותר

גרסה 1.1.0 של Games-Controller

גרסה 1.1.0

23 בפברואר 2022

androidx.games:games-activity:1.1.0 וגם androidx.games:games-controller:1.1.0 מופצים. גרסה 1.1.0 מכילה את השמירות האלה.

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

פעילות משחקים:

  • האזנה ל-WindowInsets ושאילתות לגבי תגובת חריץ ומקלדת IME
  • הוספת מסננים של אירועים מרכזיים ואירועי תנועה
  • תיקוני באגים:
    • הוספת הודעות חסרות לצורך תאימות ל-NativeActivity
    • תיקון החתימה של onNativeWindowResized
    • תיקון של אובדן אירועי קלט

גרסה ‎1.1.0-rc01

‫9 בפברואר 2022

androidx.games:games-controller:1.1.0-rc01 מופץ. גרסה ‎1.1.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.1.0-beta01

‫26 בינואר 2022

הגרסה androidx.games:games-controller:1.1.0-beta01 פורסמה ללא שינויים מאז 1.1.0-alpha01. גרסה ‎1.1.0-beta01 מכילה את השמירות האלה.

גרסה ‎1.1.0-alpha01

15 בדצמבר 2021

androidx.games:games-controller:1.1.0-alpha01 מופץ. גרסה ‎1.1.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

נוספה תמיכה בסטטוס הסוללה, ברטט של שני מנועים, בשליטה בתאורה ובדיווח על ציר התנועה בבקרים נתמכים כשמריצים אותם ב-Android S ומעלה.

שינויים ב-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

גרסה 1.0.0 של Games-Controller

גרסה 1.0.0

4 באוגוסט 2021

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

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

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

גרסה ‎1.0.0-rc02

21 ביולי 2021

androidx.games:games-controller:1.0.0-rc02 מופץ. גרסה ‎1.0.0-rc02 מכילה את השמירות האלה.

תיקוני באגים

  • תוקנה שגיאת אריזה שגרמה לייבוא של Prefab להיכשל בפרמוטציות ריקות ולא בשימוש של ארכיטקטורה/גרסה.

גרסה ‎1.0.0-rc01

12 ביולי 2021

androidx.games:games-controller:1.0.0-rc01 מופץ. גרסה ‎1.0.0-rc01 מכילה את השמירות האלה.

תיקוני באגים

  • תוקנה בעיית תאימות עם הגרסה האחרונה של GameActivity

גרסה ‎1.0.0-beta01

‫30 ביוני 2021

androidx.games:games-controller:1.0.0-beta01 מופץ. גרסה ‎1.0.0-beta01 מכילה את השמירות האלה.

שינויים ב-API

  • פונקציות שהחזירו ערך בוליאני להצלחה או לכישלון מחזירות עכשיו enum של Paddleboat_Error_Code.
  • השם של המרחב שונה על ידי Paddleboat_onPause. השם החדש הוא Paddleboat_onStop
  • השם של המרחב שונה על ידי Paddleboat_onResume. השם החדש הוא Paddleboat_onStart
  • הפונקציה Paddleboat_processGameActivityEvent פוצלה לשתי פונקציות: Paddleboat_processGameActivityKeyInputEvent ו-Paddleboat_processGameActivityMotionInputEvent
  • הוסרו תכונות של בקרים מתקדמים שדרשו בנייה מול גרסת Preview של 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
  • הוספת 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

  • עדכון גרסה ראשי בגלל שינויים במערכת build, אין עדכונים בספרייה או בממשק ה-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

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

שינויים ב-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 מכילה את השמירות האלה.

תיקוני באגים

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

גרסה 2.1.1

‫10 ביולי 2024

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

תיקוני באגים

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

גרסה 2.1.0

‫15 בנובמבר 2023

androidx.games:games-frame-pacing:2.1.0 מופץ. גרסה 2.1.0 מכילה את השמירות האלה.

גרסה ‎2.1.0-rc01

‫20 בספטמבר 2023

androidx.games:games-frame-pacing:2.1.0-rc01 מופץ. גרסה ‎2.1.0-rc01 מכילה את השמירות האלה.

גרסה ‎2.1.0-beta01

‫24 במאי 2023

androidx.games:games-frame-pacing:2.1.0-beta01 מופץ. גרסה ‎2.1.0-beta01 מכילה את השמירות האלה.

תיקוני באגים

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

גרסה ‎2.1.0-alpha01

‫5 באפריל 2023

androidx.games:games-frame-pacing:2.1.0-alpha01 מופץ. גרסה ‎2.1.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

  • 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 מכילה את השמירות האלה.

תכונות חדשות

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