גרפיקה

  
שימוש ביכולות גרפיות בכמה גרסאות של פלטפורמת Android

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

פריט מידע שנוצר בתהליך פיתוח (Artifact) גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
ליבת גרפיקה 1.0.4 - - -
graphics-path 1.0.1 - - ‎1.1.0-alpha01
graphics-shapes 1.1.0 - - -
העדכון האחרון של הספרייה הזו בוצע ב-3 בדצמבר 2025

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

כדי להוסיף תלות ב-Graphics, צריך להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין במאמר בנושא מאגר Maven של Google.

מוסיפים את יחסי התלות של הארטיפקטים שאתם צריכים בקובץ build.gradle של האפליקציה או המודול:

Groovy

dependencies {
    implementation "androidx.graphics:graphics-core:1.0.4"
    implementation "androidx.graphics:graphics-path:1.1.0-alpha01"
    implementation "androidx.graphics:graphics-shapes:1.1.0"
}

Kotlin

dependencies {
    implementation("androidx.graphics:graphics-core:1.0.4")
    implementation("androidx.graphics:graphics-path:1.1.0-alpha01")
    implementation("androidx.graphics:graphics-shapes:1.1.0")
}

מידע נוסף על יחסי תלות זמין במאמר הוספת יחסי תלות ב-build.

משוב

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

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

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

אין הערות לגבי הגרסה של הארטיפקט הזה.

גרפיקה גרסה 1.1

גרסה 1.1.0

‫22 באוקטובר 2025

androidx.graphics:graphics-*:1.1.0 משוחרר. גרסה 1.1.0 מכילה את ההתחייבויות האלה.

גרסה ‎1.1.0-rc01

‫10 בספטמבר 2025

androidx.graphics:graphics-*:1.1.0-rc01 משוחרר. גרסה 1.1.0-rc01 מכילה את הקומטים האלה.

גרסה ‎1.1.0-beta01

‫30 ביולי 2025

androidx.graphics:graphics-*:1.1.0-beta01 משוחרר. גרסה 1.1.0-beta01 מכילה את ההתחייבויות האלה.

שינויים ב-API

  • כדי להשתמש בפרויקטים שפורסמו עם Kotlin 2.0, צריך KGP 2.0.0 או גרסה חדשה יותר (Idb6b5)
  • הוספה של יעדי קומפילציה של mingwX64, ‏ js ו-wasm. (I2c46a)

גרסה ‎1.1.0-alpha01

‫11 בדצמבר 2024

androidx.graphics:graphics-*:1.1.0-alpha01 משוחרר. גרסה ‎1.1.0-alpha01 מכילה את הקומטים האלה.

תכונות חדשות

  • שינינו את ההדגמה הראשית לכלי כללי לעריכת צורות. כך אפשר לייבא צורות מנתיב SVG, לערוך ידנית את התכונות שזוהו במקרה של פספוסים בתהליך האוטומטי, ולייצא את התוצאה לקוד שאפשר להשתמש בו בקוד ייצור. (I1ac13)
  • החלפנו את מדידות הזווית של התקדמות המתאר של הצורה במדידות של אורך העקומה, כדי לאפשר שימוש בצורות מורכבות יותר לצורך מורפינג. ‪(I75478) , I390dd
  • שיפרנו את האלגוריתם של מיפוי התכונות, כך שיותר שינויים צריכים להיראות טבעיים יותר. (I83287)

שינויים ב-API

  • הוספת ייבוא של נתיבי SVG וסריאליזציה של תכונות. התהליך הרגיל הוא:
    • משתמשים במאפיין החדש SvgPathParser.parseFeatures() כדי להמיר נתיב SVG (הערך של המאפיין d ברכיב path של SVG) ל-List<Feature>.
    • אפשר לשנות את הערך הזה, ואז להפוך אותו למחרוזת באמצעות FeatureSerializer.serialize().
    • אפשר להשתמש במחרוזת שמתקבלת בקוד ייצור, על ידי ייבוא שלה באמצעות FeatureSerializer.parse()
    • הערה: השלבים 1 ו-2 מתבצעים פעם אחת, ואפשר לבצע אותם באמצעות האפליקציה החדשה. קוד הייצור צריך לבצע רק את שלב 3. (I9bd00, b/371196190), (Ic3842), (If68ed), (I10251)
  • חשיפת ישויות של פוליגונים וסוגי ישויות. עכשיו אפשר ליצור עוד RoundedPolygons כלליים באמצעות בנאי הבסיס שמקבל List<Features>. התכונות הן בעיקר רשימה של עקומות בזייה מעוקבות, אבל הן מתויגות כדי לעזור לאלגוריתם המורפינג להתאים בין הצורות של ההתחלה והסיום (פינות קמורות ממופות לפינות קמורות ופינות קעורות ממופות לפינות קעורות). (I61e76), (I1fc5c)
  • הוספת תמיכה ב-watchosDeviceArm64 KMP target וב-target kotlin 1.9. ‫(Icf15d, ‏ b/364652024)

תיקוני באגים

  • תוקן מקרה קצה שבו התכונה האחרונה הייתה ריקה. (I390dd)
  • יצירת RoundedPolygon חזקה יותר. ‫(Ib862c, ‏ b/360888486)
  • תוקן באג באתחול של RoundedPolygon. (I83ddb)
  • תיקון שגיאה באלגוריתם להערכת מרכז הפוליגון. (Ida147)

צורות גרפיות גרסה 1.0

גרסה 1.0.1

‫4 בספטמבר 2024

האפליקציות androidx.graphics:graphics-shapes:1.0.1, androidx.graphics:graphics-shapes-android:1.0.1 וגם androidx.graphics:graphics-shapes-desktop:1.0.1 מושקות. גרסה 1.0.1 מכילה את הקומטים האלה.

גרסה 1.0.0

‫21 באוגוסט 2024

האפליקציות androidx.graphics:graphics-shapes:1.0.0, androidx.graphics:graphics-shapes-android:1.0.0 וגם androidx.graphics:graphics-shapes-desktop:1.0.0 מושקות. גרסה 1.0.0 מכילה את ההתחייבויות האלה.

גרסה 1.0.0-rc01

‫24 ביולי 2024

האפליקציות androidx.graphics:graphics-shapes:1.0.0-rc01, androidx.graphics:graphics-shapes-android:1.0.0-rc01 וגם androidx.graphics:graphics-shapes-desktop:1.0.0-rc01 מושקות. גרסה 1.0.0-rc01 מכילה את הקומטים האלה.

גרסה ‎1.0.0-beta01

‫1 במאי 2024

האפליקציות androidx.graphics:graphics-shapes:1.0.0-beta01, androidx.graphics:graphics-shapes-android:1.0.0-beta01 וגם androidx.graphics:graphics-shapes-desktop:1.0.0-beta01 מושקות. גרסה 1.0.0-beta01 מכילה את הקומטים האלה.

שינויים ב-API

  • מאפשרים לסובב מראש צורות כדי להתחיל בנקודה אחרת. השינוי הזה מאפשר לpillStarצורות להתחיל את העיקולים שלהן מנקודה לא מוגדרת מראש בהיקף. האפשרות הזו שימושית כשמנפישים את המשיכות של נתיב הצורה, כדי להתחיל לצייר ממיקום ספציפי בקו המתאר של הצורה. (Ifbb4d, ‏ b/324303807)
  • נוספו פונקציות calculateBounds() ל-Morph, שדומות לפונקציות ב-RoundedPolygon. (I8a3b6, ‏ b/325463575)

גרסה ‎1.0.0-alpha05

‫7 בפברואר 2024

האפליקציות androidx.graphics:graphics-shapes:1.0.0-alpha05, androidx.graphics:graphics-shapes-android:1.0.0-alpha05 וגם androidx.graphics:graphics-shapes-desktop:1.0.0-alpha05 מושקות. גרסה ‎1.0.0-alpha05 מכילה את הקומיטים האלה.

תכונות חדשות

  • בספרייה יש עכשיו פונקציות חדשות, pill() ו-pillStar(), שמאפשרות ליצור בקלות צורות מעוגלות או צורות עם כוכבים. יש גם ממשקי API חדשים לחישוב הגבולות המדויקים הנדרשים לצורה (הגבולות הקודמים היו רק הערכה שמבוססת על נקודות העיגון והבקרה של עקומת בזייה הבסיסית), וגם הגבולות המקסימליים האפשריים, שיכולים לעזור לקבוע את הגודל של מאגר התוכן שמכיל את הצורה אם היא תסתובב בתוך המאגר. (I71827)

שינויים ב-API

  • עכשיו יש יותר אפשרויות לאחזור גבולות מדויקים ומקסימליים. (I6d49f, b/317286450)

תיקוני באגים

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

גרסה 1.0.0-alpha04

‫13 בדצמבר 2023

האפליקציות androidx.graphics:graphics-shapes:1.0.0-alpha04, androidx.graphics:graphics-shapes-android:1.0.0-alpha04 וגם androidx.graphics:graphics-shapes-desktop:1.0.0-alpha04 מושקות. גרסה ‎1.0.0-alpha04 מכילה את הקומיטים האלה.

תכונות חדשות

  • הגרסה הזו כוללת כמה שינויים ב-API, וגם תיקוני באגים.
  • הרבה מהשינויים ב-API הופכים את ספריית הצורות לידידותית ל-KMP. כך קל יותר להתקשר מקוד שאינו קוד Android (למשל קוד Compose שאינו ספציפי ל-Android). לדוגמה, אין סוגי Android ב-API, כמו הסוגים הקודמים PointF,‏ Matrix ו-Path.
  • בנוסף, בוצעו כמה שינויים בממשקי API וביישום מסיבות שקשורות לביצועים, במיוחד כדי לצמצם את הקצאת האובייקטים (ואת האיסוף שלהם). לדוגמה, המעבר מ-PointF לפרמטרים נפרדים של Float מונע הקצאה של הרבה מבני PointF זמניים כדי להכיל את הקודקודים האלה.

שינויים ב-API

  • הוחלף Morph.asMutableCubics בפונקציה שחוזרת על עצמה ב-MutableCubics. ממשק הפונקציות PointTransformer השתנה. עכשיו הוא מקבל קואורדינטות x ו-y של Point ומחזיר TransformedResult (שנוצר עם קואורדינטות x ו-y שעברו טרנספורמציה) (I6719e)
  • הסרנו את ה-constructor הציבורי Cubic והפכנו אותו לפונקציית factory. (I409ce)
  • הוספת ממשקי API לציור ולשינוי של Android (‏I079f6, ‏b/292289543)
  • הסרת יחסי תלות ב-Android ‏ (Iadc1c, ‏ b/292289543)
  • שמות המאפיינים של העוגן והבקרה הגיוניים יותר עכשיו (If13bd, ‏ b/294562941)
  • הפרמטרים של PointF השתנו לזוגות של Float (Id4705, ‏ b/276466399, ‏ b/290254314)
  • ‫progress מועבר עכשיו ישירות לפקודות השרטוט של Morph (Icdca2)

תיקוני באגים

  • תוקן באג שקרה כשיוצרים צורות גדולות. (I4fd66, b/313497325)

גרסה 1.0.0-alpha03

‫7 ביוני 2023

androidx.graphics:graphics-shapes:1.0.0-alpha03 משוחרר. גרסה ‎1.0.0-alpha03 מכילה את הקומיטים האלה.

שינויים ב-API

  • נוספה פונקציה חדשה RoundedPolygon.rectangle() (I78e7e, ‏ b/280322189)
  • הפונקציות Star ו-Circle לא מתחילות יותר באות גדולה, והן נקראות דרך אובייקט נלווה של RoundedPolygon: למשל, RoundedPolygon.star(...)(I14735)

תיקוני באגים

  • תיקון באג בהחלקה (Ibf894)
  • תוקן באג שהתרחש כשהצורה של ההתחלה והסיום היו זהות. לשפר את חלוקת המקום הפנוי בצד לחיתוכים, קודם להשתמש במקום הפנוי לעיגול ואז להחלקה אם נשאר מקום. ‫(Ibd320, ‏ b/277936300)

גרסה ‎1.0.0-alpha02

‫19 באפריל 2023

androidx.graphics:graphics-shapes:1.0.0-alpha02 משוחרר. גרסה ‎1.0.0-alpha02 מכילה את הקומיטים האלה.

שינויים ב-API

  • מחלקת העל Polygon מוזגה עם מחלקת המשנה שלה, RoundedPolygon. כל המצולעים הם עכשיו מצולעים מעוגלים [אופציונלית].
  • הפונקציה Star (שעדיין מחזירה RoundedPolygon, כמו קודם) מקבלת עכשיו ערך innerRadius, במקום הפרמטר innerRadiusRatio הקודם. היחידות זהות ליחידות של פרמטר הרדיוס הקיים, כך שהשימוש פשוט ועקבי יותר. בנוסף, הפרמטר numOuterVertices שונה ל-numVerticesPerRadius כדי להבהיר שאותו מספר מוחל על הרדיוסים הפנימי והחיצוני.
  • בעבר, הפרמטר CornerRounding.radius תועד כערך יחסי לגודל המצולע, אבל הוא היה (ועדיין) ערך מוחלט, ולא יחסי. המסמכים עודכנו וההערה שהגבילה את הערך המקסימלי ל-1.0 תוקנה.

גרסה ‎1.0.0-alpha01

‫5 באפריל 2023

‫Graphics-Shapes היא ספרייה חדשה שמאפשרת ליצור ולעבד בקלות צורות רב-צלעיות מעוגלות, וגם לבצע מורפינג (אנימציה) פשוט ואוטומטי בין צורות שונות.

androidx.graphics:graphics-shapes:1.0.0-alpha01 משוחרר. הגרסה הזו הופצה מענף פנימי.

תכונות חדשות

  • אפשר להשתמש ב-Polygon API כדי ליצור מצולעים משוכללים ומצולעים בצורת כוכב עם מספר הקודקודים הרצוי.
  • אפשר להשתמש בפרמטרים אופציונליים של CornerRounding כדי לציין את רדיוס העיגול ואת פרמטרי ההחלקה של הפינות, וכך ליצור צורות מצולעות עם פינות מעוגלות.
  • אפשר להשתמש ב-API החדש Morph(Polygon, Polygon) כדי לחשב באופן אוטומטי צורת 'מורף' שההתקדמות שלה יכולה להיות מוגדרת מ-0 עד 1, כדי ליצור אנימציה בין צורת ההתחלה לצורת הסיום. מנפישים את ההתקדמות הזו לאורך זמן, ומשרטטים את התוצאה בכל פריים כדי ליצור אנימציה חלקה בין הצורות המעוגלות החדשות האלה.

גרסה 1.0 של נתיב הגרפיקה

גרסה ‎1.1.0-alpha01

‫13 באוגוסט 2025

androidx.graphics:graphics-path:1.1.0-alpha01 משוחרר. גרסה ‎1.1.0-alpha01 מכילה את הקומטים האלה.

תיקוני באגים

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

גרסה 1.0.1

‫1 במאי 2024

androidx.graphics:graphics-path:1.0.1 משוחרר. גרסה 1.0.1 מכילה את הקומטים האלה.

תיקוני באגים

  • שיפורים בדגלי קומפילציה.

גרסה 1.0.0

‫6 במרץ 2024

androidx.graphics:graphics-path:1.0.0 משוחרר.

גרסה 1.0.0-rc01

‫21 בפברואר 2024

androidx.graphics:graphics-path:1.0.0-rc01 משוחרר. גרסה 1.0.0-rc01 כוללת את הקומיטים האלה.

תיקוני באגים

  • שיפור הביצועים של PathIterator ב-API < 34 (Id4629)

גרסה ‎1.0.0-beta02

‫10 בינואר 2024

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

androidx.graphics:graphics-path:1.0.0-beta02 משוחרר. גרסה ‎1.0.0-beta02 מכילה את הקומיטים האלה.

תיקוני באגים

  • הגודל של libandroidx.graphics.path.so הוקטן ב-96%. (I71397)
  • הקטנת הגודל של libandroidx.graphics.path.so ב-5%. (I2da7c)
  • הקטנו את הרכיבים המקוריים של androidx.graphics:graphics-path ב-43%. (I8e40d)

גרסה ‎1.0.0-beta01

‫29 בנובמבר 2023

androidx.graphics:graphics-path:1.0.0-beta01 משוחרר. גרסה 1.0.0-beta01 מכילה את הקומיטים האלה.

שינויים ב-API

  • הוסרו שימושים ב-API הניסיוני isAtLeastU() (Ie9117, ‏ b/289269026)

תיקוני באגים

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

גרסה ‎1.0.0-alpha02

‫7 ביוני 2023

androidx.graphics:graphics-path:1.0.0-alpha02 משוחרר. הגרסה הזו פותחה בענף פנימי.

תכונות חדשות

  • תוקנה בעיה בבדיקת גרסת הפלטפורמה הפנימית שגרמה לבעיות בהרצה בתצוגות מקדימות של Android 14 (בדיקת הגרסה נכשלה, אבל המנגנון לביצוע פעולות בגרסאות קודמות לא פועל בצורה תקינה ב-Android 14).

גרסה ‎1.0.0-alpha01

‫22 במרץ 2023

androidx.graphics:graphics-path:1.0.0-alpha01 משוחרר. גרסה ‎1.0.0-alpha01 מכילה את הקומיטים האלה.

תכונות חדשות

  • הספרייה החדשה הזו מאפשרת להריץ שאילתות על נתוני נתיב באמצעות PathIterator API החדש. באמצעות ה-API הזה, המתקשרים יכולים לחזור על כל הפלחים של אובייקט Path כדי לקבוע את הפעולה והנתונים של הפלחים האלה.
  • הספרייה משתמשת בממשקי API דומים שהוצגו בגרסת הטרום-הפצה של Android 14, אבל גרסת AndroidX של ה-API הזו פועלת גם בגרסאות עד API 21.

גרסת ליבת הגרפיקה 1.0

גרסה 1.0.4

‫3 בדצמבר 2025

androidx.graphics:graphics-core:1.0.4 משוחרר. גרסה 1.0.4 מכילה את הקומטים האלה.

תיקוני באגים

  • שיפור התאימות והביצועים במכשירים מסוימים.

גרסה 1.0.3

‫26 במרץ 2025

androidx.graphics:graphics-core:1.0.3 משוחרר. גרסה 1.0.3 מכילה את הקומטים האלה.

תיקוני באגים

  • תוקנה בעיה של הבהובים במסך מלא בזמן ציור במכשירים מסוימים עם API<33.

גרסה 1.0.2

‫16 באוקטובר 2024

androidx.graphics:graphics-core:1.0.2 משוחרר. גרסה 1.0.2 מכילה את הקומטים האלה.

תיקוני באגים

  • תוקנה בעיה שבה מופעי SurfaceControl עדיין נוהלו על ידי מערכת ההרכבה, גם אחרי שהם שוחררו.
  • תוקנה בעיה שבה מופע HardwareBuffer שמוצג כרגע לא שוחרר אחרי שבוטלו תלויות של השהיה נמוכה
  • תוקנה בעיית הבהוב במכשירי Android 14 ומעלה מסוימים שלא תמכו בדגל השימוש במאגר הקדמי

גרסה 1.0.1

‫4 בספטמבר 2024

androidx.graphics:graphics-core:1.0.1 משוחרר. גרסה 1.0.1 מכילה את הקומטים האלה.

תיקוני באגים

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

גרסה 1.0.0

‫29 במאי 2024

androidx.graphics:graphics-core:1.0.0 משוחרר. גרסה 1.0.0 מכילה את ההתחייבויות האלה.

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

  • גרסה יציבה רשמית של ספריית graphics-core. כולל תיקוני באגים קלים ושיפורי ביצועים מגרסה 1.0.0-rc01

גרסה 1.0.0-rc01

‫17 באפריל 2024

androidx.graphics:graphics-core:1.0.0-rc01 משוחרר. הגרסה הזו פותחה בענף פנימי.

תיקוני באגים

  • תוקנה בעיה שעלולה לגרום לסגירה כפולה של מתארים של קבצים עם CanvasBufferedRendererAPI במכשירי Android מסוימים שפועלת בהם Android 14.
  • תוקנה בעיה שבה FrameBuffer לא מחק כראוי מופעים של framebuffer.

גרסה ‎1.0.0-beta01

‫13 בדצמבר 2023

androidx.graphics:graphics-core:1.0.0-beta01 משוחרר. גרסה 1.0.0-beta01 מכילה את הקומיטים האלה.

תכונות חדשות

  • הוספנו LowLatencyCanvasViewAPI חדש לתמיכה בעיבוד עם זמן אחזור נמוך באמצעות ממשקי ה-API של גרפיקה דו-ממדית של Android‏ (Canvas + Paint) בהיררכיית התצוגה.
  • הוספנו את API‏ CanvasBufferedRenderer כדי לתמוך בעיבוד מואץ של Canvas באמצעות חומרה ל-HardwareBuffer. אפשר להשתמש בזה כדי לצייר חלק מממשק משתמש לתוך מאגר שאפשר להמיר ל-Bitmap באמצעות Bitmap.wrapHardwareBuffer API.

שינויים ב-API

  • עדכנו את CanvasBufferRenderer#releaseBuffer API כך שיכלול פרמטר אופציונלי של גדר וירטואלית. עדכנו את התיעוד כדי לתאר מתי מוחזר הערך RenderResult#fence. (If1ea7)
  • הוספת שיטה draw ל-RenderRequest כדי לתמוך בשימוש בקורוטינות לתזמון בקשות לציור. שינינו את השם של שיטת הציור הקודמת שצרכה רכיב Executor ל-drawAsync. השיטה isClosed() עברה רפקטורינג לנכס. (I5bff6)
  • הוספנו פרמטר של פורמט מאגר ל-CanvasFrontBufferRenderer כדי למפות ישירות ל-CanvasBufferedRenderer.Builder#setBufferFormat (I0f272)
  • נוצר API‏ CanvasBufferedRenderer לטיפול בעיבוד מואץ של חומרה של קנבס לתוך HardwareBuffer. ההגדרה הזו מספקת הטמעה של backport ל-Android Q לצד הגדרה של עומק swapchain של HardwareBuffers. ההגדרה של ColorSpace עדיין מוגבלת ל-Android U ומעלה, אבל הטמעת התאימות מספקת התנהגות של no-op בשם המפתחים. (I9b1d8)
  • מוסיפים ממשקי API של setFrameRate/clearFrameRate ל-SurfaceControlCompat.Transaction כדי לשלוט בקצב הפריימים לצד אסטרטגיית השינוי למעברים חלקים או למעברים שמוגדרים כברירת מחדל. (I6045c)
  • הורדנו את רמת ה-API הנדרשת ל-setDataSpace מ-Android T ל-Android Q. (I59c34)
  • נוספה קריאה חוזרת (callback) onBufferReleased ל-API‏ GLFrameBufferRenderer כדי לתת לצרכנים הזדמנות לנקות את הסטטוס כשמאגר נתונים זמני לא מוצג יותר (I8a4e2)
  • יוצרים LowLatencyCanvasView כדי לתמוך בתרחיש שימוש פשוט של עיבוד תוכן עם זמן אחזור נמוך, שמסונכרן עם עיבוד היררכיית התצוגה. הפתרון הזה מפשט את המורכבות שקשורה לניהול של SurfaceView, כי הוא מנהל באופן פנימי את מופע SurfaceView שמתורגם במסך או מחוצה לו, בהתאמה, לצורך עיבוד מסונכרן עם זמן אחזור נמוך. (I9253b)
  • הוספנו תמיכה בהגדרת מרחב צבעים ל-CanvasFrontBufferedRenderer API. עודכנו קריאות חוזרות (callback) עם מספר מאגרי נתונים זמניים כך שיכללו גם את מאגר הנתונים הזמני האחורי SurfaceControl (I24bd9)

גרסה ‎1.0.0-alpha05

‫6 בספטמבר 2023

androidx.graphics:graphics-core:1.0.0-alpha05 משוחרר. גרסה ‎1.0.0-alpha05 מכילה את הקומיטים האלה.

תכונות חדשות

  • השקנו את GLFrameBufferRenderer API. ההגדרה הזו מספקת שילוב של יחסי תלות ב-OpenGL, הגדרת שרשרת החלפה, פורמטים של פיקסלים והגדרת SurfaceControl. (Ic775b)

שינויים ב-API

  • נוספו פרמטרים של רוחב וגובה לממשקי API שונים של קריאות חוזרות (callback) כדי להעביר מידות מ-SurfaceHolder#Callbacks. (I7f9fc)
  • נוסף API ברור למחיקה של שכבות עם מאגר כפול ושכבות עם מאגר מרובה. (Ic1f95)
  • הוספנו תמיכה בהגדרת סוג המאגר הבסיסי של שרשראות החלפה שמשמשות ב-GLFrontBufferedRenderer. (I07a13)
  • נוספו מאפייני Kotlin לשיטות get ב-GLFrameBufferRenderer, הערה IntRange לגבי ערכי מאגר מקסימליים והערות HardwareBufferFormart ו-HardwareBufferUsage לגבי setFormat/setUsage בהתאמה. (Ief89e)
  • בוצע עדכון של setBuffer API בעסקאות מ-SurfaceControl כדי לספק גדר שחרור. (Ice1bb)
  • הוספנו ממשקי API של SurfaceControlCompat.Transaction להגדרת מרחב הנתונים ולקביעת טווח הבהירות המורחב. (Ic378d)

גרסה 1.0.0-alpha04

‫7 ביוני 2023

androidx.graphics:graphics-core:1.0.0-alpha04 משוחרר. גרסה ‎1.0.0-alpha04 מכילה את הקומיטים האלה.

תכונות חדשות

  • השקנו את CanvasFrontBufferedRenderer כדי לתמוך בגרפיקה עם זמן אחזור קצר באמצעות android.graphics.Canvas API לצד הטמעה קיימת של OpenGL

שינויים ב-API

  • ‫SurfaceControlCompat.Transaction#setBuffer API מעודכן כדי לאפשר מקרים של HardwareBuffer שניתן להגדיר כ-nullable, כך שישקפו את ה-API המתאים של הפלטפורמה (I173d7)
  • צריך לשנות את השם של שיטות שמתייחסות לרינדור עם מאגר נתונים זמני כפול לרינדור עם מאגר נתונים זמני מרובה, כי יכול להיות ששרשרת ההחלפה של הגיבוי תכיל יותר מ-2 מאגרי נתונים זמניים. (I830d7)
  • ‫Create CanvasFrontBufferedRenderer API כדי לאפשר לצדדים שלישיים להשתמש במערכת עיבוד עם מאגר קדמי באמצעות Canvas API. (Ibfc29)

תיקוני באגים

  • תוקנה הבעיה שבה התוכן של GLFrontBufferedRenderer לא הוצג אחרי חידוש הפעילות המתאימה.
  • תוקנה בעיה שבה תוכן שמאוחסן בזיכרון המטמון הקדמי נמחק לפני הזמן.
  • תוקנה הבעיה שבה SurfaceHolder.Callbacks לא הוסר אחרי שפורסמו ממשקי API של גרפיקה עם השהיה נמוכה.

גרסה 1.0.0-alpha03

‫22 במרץ 2023

androidx.graphics:graphics-core:1.0.0-alpha03 משוחרר. גרסה ‎1.0.0-alpha03 מכילה את הקומיטים האלה.

שינויים ב-API

  • עדכנו את ההטמעה של הקריאה החוזרת GLFrontBufferedRenderer כדי לספק אובייקט BufferInfo שמכיל את הרוחב והגובה של המאגר, יחד עם מזהה של מאגר מסגרות שאפשר להשתמש בו כדי לשנות את היעד המקורי אחרי העיבוד למאגר זמני. (I7fe20)
  • איחדנו את יצירת SyncFence לשיטת יצירה סטטית ב-SyncFenceCompat.
  • הוסרה שיטת תאימות ציבורית ל-eglDupNativeFenceFDANDROID לטובת שיטת factory ל-SyncFenceCompat ליצירת SyncFence. הסיבה לכך היא לוודא שכל ממשקי ה-API יקבלו את ההטמעה הנכונה של SyncFence, ללא קשר לרמת ה-API. (I849bb)
  • נוספה תיעוד ל-FrameBufferRenderer ול-SyncStrategy.
    • הועברו FrameBufferRenderer + FrameBuffer + FrameBufferPool לחבילה androidx.graphics.opengl
    • הועבר אל חבילת androidx.graphics.openglSyncStrategy
    • RenderCallback#onDraw מסמכים עודכנו
    • עדכון התיעוד של RenderCallback#obtainFrameBuffer שהמטמיע של ה-API אחראי להפעיל FrameBuffer.close
    • עדכון של onDrawComplete כדי לציין שהצרכנים אחראים לשליחת התוכן להצגה
    • הועברו SyncFence ממשקי תאימות/מחלקות תאימות לחבילה androidx.hardware כדי לשקף את המסגרת
    • שינינו את השם של SyncFence API ל-SyncFenceV19 והגדרנו אותו כפרטי כדי לאחד את השימושים ב-SyncFenceCompat, שמסתמך על SyncFence API של המסגרת בכל מקום שאפשר. (I5149c)
  • נוספו ה-methods‏ GLFrontBufferedRenderer#cancel ו-GLFrontBufferedRenderer#execute. האפשרות הראשונה שימושית בתרחישים של מניעת הפעלה בטעות של מסך המגע, שבהם צריך לבטל את הרינדור למאגר הקדמי ולהסתיר אותו. האפשרות השנייה שימושית בתרחישים שבהם רוצים לשנות אובייקטים בשרשור GL בלי לתזמן עיבוד. (If0b7f)
  • הוספת API לעיבוד ישירות לשכבה עם מאגר כפול. התכונה הזו עוזרת לעבד מחדש סצנה אחרי הפסקה, וגם מאפשרת לצרכנים לקבוע באופן סלקטיבי מתי להשתמש בעיבוד דינמי של מאגר קדמי על סמך הסצנה הרצויה לעיבוד. (Ied56c)
  • הוספנו ל-SurfaceControlCompat.Builder API חדש כדי לתמוך בהגדרת SurfaceControl האב ממופע אחר של SurfaceControl, בנוסף למנגנון הקיים מ-SurfaceView. (I1d1b6)
  • הוספת אפשרות להחזרת ערך null לסוגים נוספים של פונקציות שהוצאו משימוש ומוסתרות (Ibf7b0)
  • נוספה קבוע EGL_ANDROID_get_native_client_buffer של תוסף לשאילתה אם מכשיר Android תומך בייבוא של מופעי HardwareBuffer לאובייקטים של EGLClientBuffer שאפשר להשתמש בהם כמופע EGLImage. (Iad767)
  • הוספת הערה @JvmDefaultWithCompatibility ‏ (I8f206)

גרסה ‎1.0.0-alpha02

9 בנובמבר 2022

androidx.graphics:graphics-core:1.0.0-alpha02 משוחרר. גרסה ‎1.0.0-alpha02 מכילה את הקומיטים האלה.

שינויים ב-API

  • תוקנה בעיה שגרמה להשמטת ההערה RequiresApi עבור addTransactionCommitListener, שהוצגה ב-Android S ‏ (I0a035)
  • עדכנו את onDraw<Front/Double> Buffer callbacks כדי לספק מטריצת טרנספורמציה שצרכנים יכולים להעביר ל-vertex shaders שלהם בנוסף לרוחב ולגובה הנוכחיים של המאגר. הצרכנים אחראים לשימוש בפרמטרים האלה כדי לבצע סיבוב מראש של קוד העיבוד של OpenGL. (I82f9e)

תיקוני באגים

  • שיפור השהייה של הגרפיקה על ידי סיבוב מראש של מאגרי נתונים לפני הנפקת עסקאות SurfaceControl.
  • תוקנה בעיה שבה ביומני השגיאות הוצגה שגיאה 300d ‏ (EGL_BAD_SURFACE).
  • תוקנה הבעיה שבה GLFrontBufferedRenderer היה לא תקין אחרי שהופעלה מחדש הפעילות התואמת שבה נעשה בו שימוש.
  • שיפור התמיכה באמולטורים ובמכשירי ChromeOS.
  • נפתרה בעיה שבה יכול להיות שהשכבה הקדמית של המאגר הוסתרה מוקדם מדי.

גרסה ‎1.0.0-alpha01

24 באוקטובר 2022

androidx.graphics:graphics-core:1.0.0-alpha01 משוחרר. גרסה ‎1.0.0-alpha01 מכילה את הקומיטים האלה.

תכונות חדשות

  • גרסה ראשונית של ספריית AndroidX של ליבת הגרפיקה. הם כוללים ממשקי API לתמיכה בתרחישי שימוש עם זמן אחזור קצר, כמו קלט של עט סטיילוס. בנוסף, יש כאן כמה ממשקי API מסייעים לשימוש ב-OpenGL.

שינויים ב-API

  • הוספנו את GLFrontBufferedRenderer כדי לעזור בטכניקות רינדור שונות, במטרה להשיג גם זמן אחזור נמוך וגם פלט רינדור באיכות גבוהה.
  • הוספנו את GLRenderer API כדי לסייע בעיבוד OpenGL עבור ספקי Surface שונים, כמו SurfaceView,‏ TextureView ועוד.