משחקי Android

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

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

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

פריט מידע שנוצר בתהליך פיתוח (Artifact) גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
games-activity 4.4.2 - - -
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.1 - - -
games-performance-tuner 2.0.0 - - ‎2.3.0-alpha01
הספרייה הזו עודכנה לאחרונה בתאריך: 6 במאי 2026

דרישות

games-memory-advice

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

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

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

    // 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.1"
}

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.2")

    // 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.1")
}
}

מידע נוסף זמין במאמר הוספת יחסי תלות ב-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

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

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

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

גרסה 4.3

גרסה 4.3.1

‫6 במאי 2026

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

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

גרסה 3.0.4

‫7 באוגוסט 2024

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

תיקוני באגים

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

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

תיקוני באגים

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

גרסה 2.0

גרסה 2.0.0

‫8 במרץ 2023

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

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

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

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

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

גרסה 4.4

גרסה 4.4.2

‫6 במאי 2026

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

גרסה 4.4.1

‫8 באפריל 2026

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

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

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

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

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

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

תיקוני באגים

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

תיקוני באגים

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

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

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

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

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

‫24 ביולי 2024

‫androidx.games:games-performance-tuner:2.0.0-rc01 מופץ. גרסה ‎2.0.0-rc01 מכילה את השמירות האלה.

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

גרסה 1.6

גרסה ‎1.6.1-alpha01

9 בנובמבר 2022

‫androidx.games:games-performance-tuner:1.6.1-alpha01 מופץ. גרסה ‎1.6.1-alpha01 מכילה את השמירות האלה.

תכונות חדשות

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

גרסה 1.6.0

‫15 ביוני 2022

‫androidx.games:games-performance-tuner:1.6.0 מופץ. גרסה 1.6.0 מכילה את השמירות האלה.

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

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

גרסה 1.5.0

גרסה 1.5.0

‫9 בפברואר 2022

‫androidx.games:games-performance-tuner:1.5.0 מופץ. גרסה 1.5.0 מכילה את השמירות האלה.

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

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

גרסה 1.4.3

12 ביולי 2021

‫androidx.games:games-performance-tuner:1.4.3 מופץ. גרסה 1.4.3 מכילה את השמירות האלה.

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

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

גרסה 1.1

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

בקר משחקים

גרסה 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 כברירת מחדל.

גרסה 2.2

גרסה ‎2.2.0-alpha01

‫26 במרץ 2025

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

תכונות חדשות

  • שדרוג ל-Gradle 8.8.1 ‏ (1ed0153)
  • שדרוג ל-Java 17 ‏ (1ed0153)
  • שינוי של targetSdk ל-35 (eddf605)

גרסה 2.0

גרסה 2.0.2

‫12 ביוני 2024

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

תיקוני באגים

  • תוקנה בעיה שבה קריאות חוזרות (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

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

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

גרסה 2.3

גרסה ‎2.3.0-alpha01

‫26 במרץ 2025

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

תכונות חדשות

  • שדרוג ל-Gradle 8.8.1 ‏ (1ed0153)
  • שדרוג ל-Java 17 ‏ (1ed0153)
  • שינוי של targetSdk ל-35 (eddf605)

תיקוני באגים

גרסה 2.1

גרסה 2.1.3

‫2 ביולי 2025

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

תיקוני באגים

  • האפשרות הזו מאפשרת תמיכה בגודל דף של 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.

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

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

  • כדי להסיר קריאות חוזרות (callback) שנוספו קודם באמצעות SwappyGL_injectTracer, משתמשים ב-API‏ SwappyGL_uninjectTracer(const SwappyTracer *t).

גרסה 1.9

גרסה 1.9.1

‫13 באוקטובר 2021

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

תיקוני באגים

גרסה 1.9.0

12 ביולי 2021

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

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

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

גרסה 1.7

גרסה 1.7.0

‫30 ביוני 2021

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

גרסה ‎1.7.0-rc01

‫2 ביוני 2021

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

גרסה ‎1.7.0-beta02

24 בפברואר 2021

‫androidx.games:games-frame-pacing:1.7.0-beta02 מופץ.

גרסה ‎1.7.0-beta01

‫16 בדצמבר 2020

‫androidx.games:games-frame-pacing:1.7.0-beta01 מופץ.

גרסה 1.0.0

גרסה ‎1.0.0-alpha02

12 באוגוסט 2020

הספרייה Android Gaming קיבלה את השם החדש Android Games.

androidx.gaming -> androidx.games

גרסה ‎1.0.0-alpha01

‫10 ביוני 2020

‫androidx.games:1.0.0-alpha01 מופצת.