משחקי Android

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

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

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

פריט מידע שנוצר בתהליך פיתוח (Artifact) גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסה אלפא
games-activity 3.0.5 - - 4.0.0-alpha01
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-alpha01
טיונר משחקים 2.0.0 - - -
הספרייה הזו עודכנה לאחרונה ב-16 באוקטובר 2024

הדרישות

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

כדי להשתמש ב-MemoryAdvisor API, צריך לפתח את האפליקציה באחת מהגרסאות הבאות של NDK:

  • r20.*
  • r21.*
  • 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)

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

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

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

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

משוב

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

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

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

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

תיקוני באגים

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

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

תיקוני באגים

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

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

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.
  • תוקנה בעיה של גלישה מסוג 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

  • 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 ללא קבוצת טעינה פעילה.

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

תיקוני באגים

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

גרסה 1.0.0-rc02

21 ביולי 2021

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

תיקוני באגים

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

גרסה 1.0.0-rc01

12 ביולי 2021

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

תיקוני באגים

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

גרסה 1.0.0-beta01

30 ביוני 2021

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

שינויים ב-API

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

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

גרסה 1.0.0-rc01

12 ביולי 2021

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

גרסה 1.0.0-beta01

30 ביוני 2021

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

שינויים ב-API

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

גרסה 1.0.0-alpha01

16 ביוני 2021

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

תכונות חדשות

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

Games Frame Pacing Version 2.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 כוללת את ההתחייבויות האלה.

תיקוני באגים

  • תיקון ל-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 באמצעות SwappyGL_uninjectTracer(const SwappyTracer *t) API.

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 משוחרר.

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

androidx.gaming -> androidx.games

גרסה 1.0.0-alpha01

10 ביוני 2020

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