משחקים ל-Android

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

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

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

פריט מידע שנוצר בתהליך פיתוח (Artifact) גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
פעילות-משחקים 3.0.5 - - 4.0.0-alpha01
games-controller 2.0.2 - - -
קצב פריימים של משחקים 2.1.2 - - -
ייעוץ-משחקים 2.0.1 - 2.1.0-beta01 -
games-text-input 3.0.4 - - 4.0.0-alpha01
games-performance-tuner 2.0.0 - - -
הספרייה הזו עודכנה לאחרונה ב-16 באוקטובר 2024

הדרישות

משחקים-זיכרון-טיפים

כדי להשתמש ב-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

  • הוספת הפונקציה 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

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

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

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

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

  • כדי להימנע מחריגה במערכות של 32 ביט, צריך להשתמש ב-int64_t במקום ב-long ל-historicalEventTimes
  • הוספת אמצעי תשלום מסוג 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 כוללת את ההצהרות האלה על ביצוע שינויים (commits).

תיקוני באגים

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

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

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

Games Performance Tuner 1.6

גרסה 1.6.1-alpha01

9 בנובמבר 2022

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

תכונות חדשות

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

גרסה 1.6.0

15 ביוני 2022

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

שינויים חשובים מאז 1.5.0

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

Games Performance Tuner 1.5.0

גרסה 1.5.0

9 בפברואר 2022

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

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

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

גרסה 1.5.0-rc01

26 בינואר 2022

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

תיקוני באגים

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

גרסה 1.5.0-beta02

15 בדצמבר 2021

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

שינויים ב-API

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

גרסה 1.5.0-beta01

29 בספטמבר 2021

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

תכונות חדשות

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

שינויים ב-API

  • אין שינויים מהגרסה הקודמת. הגרסה הזו כללה:
    • פונקציה חדשה: TuningFork_setAggregationStrategyInterval
    • שדה חדש ב-TuningFork_Settings: aggregation_strategy_intervalms_or_count

גרסה 1.5.0-alpha01

18 באוגוסט 2021

androidx.games:games-performance-tuner:1.5.0-alpha01 משוחרר. גרסה 1.5.0-alpha01 כוללת את ההצהרות האלה.

תכונות חדשות

  • עכשיו אפשר להגדיר את המרווח בין העלאות APT באופן פרוגרמטי, במקום להשתמש בקובץ ההגדרות.

שינויים ב-API

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

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

תיקוני באגים

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

גרסה 1.1.0

23 בפברואר 2022

androidx.games:games-activity:1.1.0 ו-androidx.games:games-controller:1.1.0 משוחררים. גרסה 1.1.0 כוללת את ההצהרות האלה על ביצוע שינויים (commits).

שינויים חשובים מאז גרסה 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

גרסה 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, בקר משחקים ו-Game-Text-Input. מידע נוסף זמין בדף הבית של AGDK.

גרסה 1.0.0-rc02

21 ביולי 2021

androidx.games:games-controller:1.0.0-rc02 משוחרר. גרסה 1.0.0-rc02 כוללת את ההצהרות האלה.

תיקוני באגים

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

גרסה 1.0.0-rc01

12 ביולי 2021

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

תיקוני באגים

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

גרסה 1.0.0-beta01

30 ביוני 2021

androidx.games:games-controller:1.0.0-beta01 משוחרר. גרסה 1.0.0-beta01 כוללת את ההצהרות האלה.

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.0.0-alpha01

16 ביוני 2021

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

תכונות חדשות

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

Games-Text-Input 2.1

גרסה 2.1.0-alpha01

26 ביולי 2023

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

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

Games-Text-Input 2.0

גרסה 2.0.0

8 במרץ 2023

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

שינויים חשובים מאז 1.1.1

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

תיקוני באגים

  • תוקנו בעיות שבהן קובץ .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++‎.

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

גרסה

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 כוללת את ההתחייבויות האלה.

תיקוני באגים

  • תיקון במקרה של החלפה שלא נבנה עם 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

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

קצב פריימים של משחקים 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

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

טיונר ביצועים של משחקים 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.

androidx.gaming -> androidx.games

גרסה 1.0.0-alpha01

10 ביוני 2020

androidx.games:1.0.0-alpha01 מופץ.