משחקים ל-Android

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

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

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

פריט מידע שנוצר בתהליך פיתוח (Artifact) גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסה אלפא
games-activity 3.0.5 - 4.0.0-beta01 -
games-controller 2.0.2 - - -
games-frame-pacing 2.1.2 - - -
games-memory-advice 2.0.1 - 2.1.0-beta01 -
games-text-input 3.0.4 - 4.0.0-beta01 -
games-performance-tuner 2.0.0 - - -
הספרייה עודכנה לאחרונה ב-15 בינואר 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.2"

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

    // To use the Games Activity library
    implementation "androidx.games:games-activity:3.0.5"

    // 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:3.0.4"
}

Kotlin

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

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

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

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

    // 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:3.0.4")
}
}

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

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

דיווח על בעיה חדשה

מידע נוסף זמין במסמכי התיעוד של 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

  • פונקציית AddGetAvailableMemory

תיקוני באגים

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

Games-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

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

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

תיקוני באגים

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

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

תרומה חיצונית

  • הספרייה תלויה ב-tensorflow, והרישיון שלה ורישיונות של יחסי התלות הטרנזיטיביים שלה זמינים בכתובת https://github.com/tensorflow/tensorflow.

Games-Text-Input גרסה 3.0

גרסה 3.0.4

7 באוגוסט 2024

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

תיקוני באגים

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

Games-Activity גרסה 4.0

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

תיקוני באגים

  • בוצעו מספר תיקונים ב-GameTextInput. תוקנה הפונקציונליות של ההקלדה וההסרה.
  • שיפור התאימות עם רוב מקלדות התוכנה הפופולריות.
  • תוקן הטיפול בתווים מיוחדים במקלדות חומרה.
  • תוקנה גישה נדירה של נקודת הצבעה לא חוקית (null) ב-GameActivity.

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

תיקוני באגים

  • תוקנה הבעיה שבה אירועי מקלדת לא טופלו כראוי על ידי ה-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 משתנה סוג ההחזרה שלו מבוליאני ל-void.
  • עכשיו setImeEditorInfo מצפה לפרמטרים של enum ולא למספרים שלמים.
  • הפונקציות הפנימיות של GameActivityEvents מועברות אל GameActivityEvents_internal.h.
  • סוגי הקלט של GameTextInput הם גם ספירה, ולא מספרים שלמים.

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

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

תיקוני באגים

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

Games-Activity גרסה 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.
  • תוקנה בעיה של זליגת נתונים (overflow) ב-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 כוללת את ההוספות האלה.

Games-Activity גרסה 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 לטפל בחיוב של ספריות מקוריות.
  • תמיד צריך לטעון את הספרייה המקורית ב-GameActivity.onCreate.
  • אם לא נמצאה ספרייה אחרת, המערכת תשתמש בספרייה בשם 'main'.

Games-Activity גרסה 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 כוללת את ההצהרות האלה על ביצוע שינויים (commits).

תכונות חדשות

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

שינויים ב-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 גרסה 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 פונקציית ה-callback מחזירה עכשיו את הרוחב והגובה של החלון.
  • הוסר onContentRectChanged חזרה.
  • השם של onLowMemory שונה לשם onTrimMemory.
  • האפשרות GameActivity_setWindowFormat הוסרה.
  • מודל בעלות משופר למצביעים GameActivityMotionEvents ו-GameActivityMotionEvent.
  • שיפור מודל הבעלות על מצב המשתמש בקריאה החוזרת (callback) של onSaveInstanceState.

גרסה 1.0.0-alpha01

16 ביוני 2021

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

תכונות חדשות

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

Games-Controller גרסה 2.0

גרסה 2.0.2

‫12 ביוני 2024

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

תיקוני באגים

  • תוקנה בעיה שבה קריאות חזרה (callbacks) של בקרי מחוברים לא הופעלו בבקרי מחוברים שכבר היו מחוברים לפני 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 ואילך

Games-Controller גרסה 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 לרישום קריאות חזרה של נתוני תנועה של בקר
  • נוספה הפונקציה Paddleboat_setControllerLight לשינוי הגדרות התאורה של הבקר.
  • הוספת המבנה Paddleboat_Controller_Battery אל Paddleboat_Controller_Data
  • מבנים חדשים:
    • Paddleboat_Controller_Battery
    • Paddleboat_Motion_Data
  • ערכים חדשים של enum:
    • Paddleboat_BatteryStatus
    • Paddleboat_LightType
    • Paddleboat_Motion_Type
  • דגלים חדשים של בקרי נתונים:
    • PADDLEBOAT_CONTROLLER_FLAG_ACCELEROMETER
    • PADDLEBOAT_CONTROLLER_FLAG_GYROSCOPE
    • PADDLEBOAT_CONTROLLER_FLAG_LIGHT_PLAYER
    • PADDLEBOAT_CONTROLLER_FLAG_LIGHT_RGB
    • PADDLEBOAT_CONTROLLER_FLAG_BATTERY

תיקוני באגים

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

Games-Controller גרסה 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
  • הוסרו תכונות מורחבות של בקר שדרשו פיתוח מול גרסת ה-preview של Android S SDK
  • נוספה הפונקציה Paddleboat_getBackButtonConsumed
  • לקריאות חוזרות (callbacks) של מצב בקר ועכבר יש עכשיו פרמטר אופציונלי של מצביע לנתונים מוגדרים על ידי משתמש
  • מחרוזת השם של הבקר הועברה מהמבנה של פרטי המכשיר, והגישה אליה מתבצעת עכשיו באמצעות הפונקציה Paddleboat_getControllerName

תיקוני באגים

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

גרסה 1.0.0-alpha01

16 ביוני 2021

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

תכונות חדשות

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

Games-Text-Input 2.1

גרסה 2.1.0-alpha01

26 ביולי 2023

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

תכונות חדשות

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

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

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

Games-Text-Input גרסה 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 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

תיקוני באגים

  • תוקנו בעיות שקשורות לקובץ ‎ .aar חסר בגרסה הקודמת.

גרסה 1.1.0

9 בפברואר 2022

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

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

Games-Text-Input גרסה 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 גרסה 2.1

גרסה 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 כדי לאפס את המצב הפנימי של קצב הפריימים. עכשיו, קצב הפריימים ייקח בחשבון רק נתונים מהנקודה שבה נקרא reset API.
  • עכשיו אפשר להשתמש ב-SwappyGL_enableFramePacing/SwappyVk_enableFramePacing כדי להפעיל או להשבית את קצב הפריימים של swappy. כשהיא מושבתת,
  • אפשר להשתמש ב-SwappyGL_enableBlockingWait/SwappyVk_enableBlockingWait כדי לקבוע אם תהיה המתנה חסומה של עבודת ה-GPU של הפריים האחרון כשקצב הפריימים יושבת.

תיקוני באגים

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

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

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

  • מסירים קריאות חזרה (callbacks) שנוספו בעבר באמצעות 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 Gaming השתנה לספריית Android Games.

androidx.gaming -> androidx.games

גרסה 1.0.0-alpha01

10 ביוני 2020

androidx.games:1.0.0-alpha01 פורסם.