‫Compose Material 3 Adaptive

  
אפשר להשתמש בספריית ההתאמה של Material 3 כדי ליצור ממשקי משתמש שמותאמים באופן אוטומטי בהתאם להגדרות החלון, כמו מחלקות גודל החלון או מצבי המכשיר. הספרייה מספקת יישומי scaffold שמוגדרים כברירת מחדל ורכיבי composable של אבני בניין כדי ליצור חוויות מותאמות אישית.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫9 בספטמבר 2026 1.3.0 - - ‎1.4.0-alpha02

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

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

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

Groovy

dependencies {
    implementation "androidx.compose.material3.adaptive:adaptive:1.3.0-rc01"
    implementation "androidx.compose.material3.adaptive:adaptive-layout:1.3.0-rc01"
    implementation "androidx.compose.material3.adaptive:adaptive-navigation:1.3.0-rc01"
    implementation "androidx.compose.material3.adaptive:adaptive-navigation3:1.3.0-rc01"
}

Kotlin

dependencies {
    implementation("androidx.compose.material3.adaptive:adaptive:1.3.0-rc01")
    implementation("androidx.compose.material3.adaptive:adaptive-layout:1.3.0-rc01")
    implementation("androidx.compose.material3.adaptive:adaptive-navigation:1.3.0-rc01")
    implementation("androidx.compose.material3.adaptive:adaptive-navigation3:1.3.0-rc01")
}

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

משוב

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

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

מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.

גרסה 1.4

גרסה ‎1.4.0-alpha02

‫9 בספטמבר 2026

‫androidx.compose.material3.adaptive:adaptive-*:1.4.0-alpha02 מופץ. גרסה ‎1.4.0-alpha02 מכילה את השמירות האלה.

גרסה ‎1.4.0-alpha01

‫26 באוגוסט 2026

‫androidx.compose.material3.adaptive:adaptive-*:1.4.0-alpha01 מופץ. גרסה ‎1.4.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

  • הסרת ממשקי Component Override API עבור NavigationSuiteScaffold (Ie6340)
  • הסרה של ממשקי Component Override API עבור ThreePaneScaffold (I9ceb5)
  • תמיכה בצורות ב-AnimatedPane (Ie7c60, ‏ b/470517507)

תיקוני באגים

  • תיקון סנכרון המצב של SupportingPaneScaffold בשינויים בהגדרות (e29596)

‫Compose Material3 Adaptive Version 1.3

גרסה 1.3.0

‫12 באוגוסט 2026

‫androidx.compose.material3.adaptive:adaptive-*:1.3.0 מופץ. גרסה 1.3.0 מכילה את השמירות האלה.

תכונות חדשות

  • אנחנו שמחים להודיע על השקת הספרייה adaptive-navigation3. הספרייה החדשה הזו, שהיא חלק מהמערכת האקולוגית של Material Adaptive ו-Navigation3, נועדה לעזור לכם ליצור ממשקי משתמש מותאמים של Material שמשולבים עם הספרייה Navigation3.

    אפשר להשתמש באסטרטגיות של סצנות כדי להטמיע פיגום של חלונית רשימה ופירוט קנונית (ListDetailSceneStrategy, rememberListDetailSceneStrategy) או פיגום של חלונית תומכת (SupportingPaneSceneStrategy, rememberSupportingPaneSceneStrategy). למידע נוסף על סצנות, אסטרטגיות של סצנות ומושגים חדשים אחרים שהוצגו ב-Navigation 3, אפשר לעיין במדריך ל-Navigation 3.

  • יש עכשיו תמיכה בשוליים ובפריסה מקצה לקצה ב-ListDetailPaneScaffold וב-SupportingPaneScaffold.

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

  • תמיכה ב-RTL באמצעות עוגנים להרחבת החלונית (I0770b)

גרסה ‎1.3.0-rc01

‫17 ביוני 2026

‫androidx.compose.material3.adaptive:adaptive-*:1.3.0-rc01 מופץ. גרסה ‎1.3.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.3.0-beta02

‫19 במאי 2026

‫androidx.compose.material3.adaptive:adaptive-*:1.3.0-beta02 מופץ. גרסה ‎1.3.0-beta02 מכילה את השמירות האלה.

גרסה ‎1.3.0-beta01

‫6 במאי 2026

‫androidx.compose.material3.adaptive:adaptive-*:1.3.0-beta01 מופץ. גרסה ‎1.3.0-beta01 מכילה את השמירות האלה.

שינויים ב-API

  • החזרת ממשקי API של הזמנות scaffold למצב ניסיוני (I01492, b/489424245)

גרסה ‎1.3.0-alpha10

‫8 באפריל 2026

‫androidx.compose.material3.adaptive:adaptive-*:1.3.0-alpha10 מופץ. גרסה ‎1.3.0-alpha10 מכילה את השמירות האלה.

שינויים ב-API

  • סימון ממשקי API‏ DragToResize ו-PaneMarginas כניסיוניים (I86c29)
  • הוצאה משימוש של currentWindowAdaptiveInfo והשקת גרסה 2 שלו (I40ecf, b/424442112)

גרסה ‎1.3.0-alpha09

‫25 בפברואר 2026

‫androidx.compose.material3.adaptive:adaptive-*:1.3.0-alpha09 מופץ. גרסה ‎1.3.0-alpha09 מכילה את השמירות האלה.

שינויים ב-API

  • הוצא משימוש NavDisplays שמקבל SceneStrategy בשרשור באמצעות then infix והוחלף ב-NavDisplay שמקבל List<SceneStrategy> (I78b2c, ‏ b/482108465)

תיקוני באגים

  • תוקנה הבעיה שבה צללים לא מוצגים בחלוניות מרחפות. (Ie6108, ‏ b/470517507)

גרסה ‎1.3.0-alpha08

‫11 בפברואר 2026

‫androidx.compose.material3.adaptive:adaptive-*:1.3.0-alpha08 מופץ. גרסה ‎1.3.0-alpha08 מכילה את השמירות האלה.

שינויים ב-API

  • אפשר להשתמש באסטרטגיות של סצנות Material כדי להוסיף אנימציות מותאמות אישית לחלונית. (I65e80)
  • אסטרטגיות של סצנות חומרי גלם תומכות במטא-נתונים להגדרת הרוחב והגובה המועדפים של חלונית כשהיא מוצגת בפיגום אדפטיבי. (If0c2a)
  • לסצנות של חומרים יש פרמטרים חדשים לתמיכה בהרחבת החלונית. ‫(Iea29b, ‏ b/437981137)

גרסה ‎1.3.0-alpha07

‫28 בינואר 2026

‫androidx.compose.material3.adaptive:adaptive-*:1.3.0-alpha07 מופץ. גרסה ‎1.3.0-alpha07 מכילה את השמירות האלה.

שינויים ב-API

  • נוסף קומפוזיציה מקומית כדי לשאול על היקף הסצנה המותאמת של Material. (I2e0d9, b/457721741)
  • מוסיפים דגל בוליאני ל-PaneScaffoldDirective כדי לבטל את ההתנהגות שמעבירה אוטומטית את המיקוד לחלונית היעד הנוכחית. ‫(I929f5, ‏ b/445720462)
  • מעכשיו, ListDetailSceneStrategy ו-SupportingPaneSceneStrategy יכולים להצטרף לטיפול בסצנות עם חלונית אחת בלבד. ‫(I79384, ‏ b/417475283)

גרסה ‎1.3.0-alpha06

‫14 בינואר 2026

‫androidx.compose.material3.adaptive:adaptive-*:1.3.0-alpha06 מופץ. גרסה ‎1.3.0-alpha06 מכילה את השמירות האלה.

תיקוני באגים

  • תמיכה ב-RTL עם עוגנים להרחבת חלונית (I0770b, ‏ b/467775639)
  • תוקנה הבעיה שבה הצללים של חלוניות צפות לא נחתכים (375cf1, b/470517507)

גרסה ‎1.3.0-alpha05

‫3 בדצמבר 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.3.0-alpha05 מופץ. גרסה ‎1.3.0-alpha05 מכילה את השמירות האלה.

גרסה ‎1.3.0-alpha04

‫19 בנובמבר 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.3.0-alpha04 מופץ. גרסה ‎1.3.0-alpha04 מכילה את השמירות האלה.

תיקוני באגים

  • תוקנו ThreePaneScaffold קריסות שמתרחשות כשמגדירים שוליים. (2df348)

גרסה ‎1.3.0-alpha03

‫5 בנובמבר 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.3.0-alpha03 מופץ. גרסה ‎1.3.0-alpha03 מכילה את השמירות האלה.

גרסה ‎1.3.0-alpha02

‫22 באוקטובר 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.3.0-alpha02 מופץ. גרסה ‎1.3.0-alpha02 מכילה את השמירות האלה.

שינויים ב-API

  • אסטרטגיות של סצנות אדפטיביות של Material מאפשרות עכשיו להעביר אסטרטגיות מותאמות אישית של חלוניות (Iae61d, ‏ b/437981298)
  • העברת ממשקי API של סדר אופקי של פיגומים של חלוניות לגרסה יציבה (I23ab3)
  • הוספת DragToResizeState לשיטת Levitate (I717bd)
  • הוצאה משימוש של ממשקי API של גודל חלון (I6749e, ‏ b/424442112)

גרסה ‎1.3.0-alpha01

‫8 באוקטובר 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.3.0-alpha01 מופץ. גרסה ‎1.3.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

  • יש עכשיו תמיכה בשוליים ובפריסה מקצה לקצה ב-ListDetailPaneScaffold וב-SupportingPaneScaffold.
  • ספריית השילוב adaptive-navigation3 יוצאת כגרסה 1.3.0-alpha01, כי הגרסה הזו (שנקראה בעבר 1.0.0-alpha03).

שינויים ב-API

  • הוספנו תמיכה בשוליים ובפריסה מקצה לקצה ב-ThreePaneScaffold. (If0794, ‏ b/333539848)

‫Compose Material3 Adaptive Version 1.2

גרסה 1.2.0

‫22 באוקטובר 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.2.0 מופץ. גרסה 1.2.0 מכילה את השמירות האלה.

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

  • הוספנו את משנה ה-PaneScaffoldScope.preferredHeight למפתחים כדי לספק גבהים מועדפים של חלוניות שיוחלו באמצעות אסטרטגיות התאמה חדשות שאנחנו מתכננים להשיק. (I957dd)
  • הוספת מחזיק מצב שניתן לשמירה אל PaneScaffoldScope (Id9299)
  • הוספת אסטרטגיית סידור מחדש להתאמה (I75c6a)
  • הוספת אסטרטגיית שיפור לשינוי (I1ba7c)
  • הוספת תמיכה בפונקציה currentWindowAdaptiveInfo() לרוחב חלון גדול וגדול במיוחד (I92e97)
  • תמיכה בהתנהגות גרירה בהתאמה אישית עם מצב הרחבת החלונית (If5c61)

גרסה ‎1.2.0-rc01

‫8 באוקטובר 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.2.0-rc01 מופץ. גרסה ‎1.2.0-rc01 מכילה את השמירות האלה.

תיקוני באגים

  • הגדרת כותרת ברירת המחדל של חלונית הנגישות ל-AnimatedPanes (012113, ‏ b/323387770)
  • תיקון של הצמדה מחדש שגויה במהלך ההתייצבות (ca45f9, b/442911758)

גרסה ‎1.2.0-beta03

‫24 בספטמבר 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.2.0-beta03 מופץ. גרסה ‎1.2.0-beta03 מכילה את השמירות האלה.

תיקוני באגים

  • תיקון של שינוי שגוי של מיקום העוגן במהלך גרירה. (6453cb6)

גרסה ‎1.2.0-beta02

‫10 בספטמבר 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.2.0-beta02 מופץ. גרסה ‎1.2.0-beta02 מכילה את השמירות האלה.

שינויים ב-API

  • הסרה של התכונה 'גרירה לשינוי גודל' מ-API ציבורי (Ic85ba, ‏ b/437953743, ‏ b/442636084)
  • שינוי השם של Scrim() ל-LevitatedPaneScrim() והסתרת המאפיינים של המחלקות Levitated ו-Reflowed. (I090e1, ‏ b/427953101)
  • הסתרה של calculatePosture() API כפנימי (Ie7227, b/424442112)

תיקוני באגים

  • שימוש בנקודת עיגון ראשונית חדשה כשמשנים את רשימת נקודות העיגון של הרחבת החלונית (I91cd1, b/438829477)

גרסה ‎1.2.0-beta01

‫27 באוגוסט 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.2.0-beta01 מופץ. גרסה ‎1.2.0-beta01 מכילה את השמירות האלה.

תכונות חדשות

  • תמיכה בשיטות קלט חלופיות לתכונה של שינוי גודל באמצעות גרירה (Id7796)

שינויים ב-API

  • תמיכה בהתנהגות גרירה בהתאמה אישית עם מצב הרחבת החלונית (If5c61)
  • מוסיף חיווי בממשק של היקף החלונית כדי לציין אם אפשר לבצע אינטראקציה עם החלונית או לא. האינדיקטור הזה משמש גם להשבתת הגישה לנגישות בחלוניות הבסיסיות כשחלונית צפה מוצגת עם מסך חצי שקוף. (If36f3)
  • החלפת הגדרת Scrim בביטויי למדה שניתנים להרכבה (I7d811)
  • סימון ממשקי API שקשורים לגודל החלון ולמיקום כניסיוניים (I4ee96)
  • חשיפת PaneScaffoldHorizontalOrder כ-API ציבורי חתום (Ia4ebe)

תיקוני באגים

  • פתרון עקיף לקריסה שנגרמת בגלל מידה מיותרת של התקרבות (I0a65a, ‏ b/418932957)

גרסה ‎1.2.0-alpha11

‫13 באוגוסט 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha11 מופץ. גרסה ‎1.2.0-alpha11 מכילה את השמירות האלה.

שינויים ב-API

  • הוספנו ממשק PaneScaffoldRole כללי כדי לשפר את הקריאות של ה-API (I1b757)
  • הסרת הכיתה AdaptStrategy.Levitated.Strategy (I6f798)
  • הפרמטר של הפרופורציה של Modifier.preferredWidth/Height השתנה מערכי אחוזים מסוג Int לטווח ערכים מסוג Float מ-0 עד 1. (Ib2de2)

תיקוני באגים

  • נפתרה הבעיה שגרמה לכך שלא נלקחו בחשבון עוגנים ראשוניים (I32f5d, b/418296559)

גרסה ‎1.2.0-alpha10

‫30 ביולי 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha10 מופץ. גרסה ‎1.2.0-alpha10 מכילה את השמירות האלה.

שינויים ב-API

  • תמיכה ברוחב או בגובה מועדפים שמיוצגים בפרופורציות. (I63dda)
  • הוסתרים פרמטרים של בנאי של אסטרטגיות Reflow ו-Levitate. בנוסף, השם של targetPane שונה ל-reflowUnder. (Ifa81b)

תיקוני באגים

  • תוקנה רגרסיה בביצועים שנגרמה כתוצאה מצילום מצב של התקדמות המעבר בין מצבי ה-scaffold ‏ (I3d555, ‏ b/417329258)

גרסה ‎1.2.0-alpha09

‫16 ביולי 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha09 מופץ. גרסה ‎1.2.0-alpha09 מכילה את השמירות האלה.

גרסה ‎1.2.0-alpha08

‫2 ביולי 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha08 מופץ. גרסה ‎1.2.0-alpha08 מכילה את השמירות האלה.

גרסה ‎1.2.0-alpha07

‫18 ביוני 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha07 מופץ. גרסה ‎1.2.0-alpha07 מכילה את השמירות האלה.

שינויים ב-API

  • הוספת תמיכה בפונקציה currentWindowAdaptiveInfo() לסיווגים של גדלי רוחב חלון גדולים וגדולים במיוחד, וקידום הפונקציות calculatePosture() ו-currentWindowDpSize() לגרסה יציבה. (I92e97)

גרסה ‎1.2.0-alpha06

‫20 במאי 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha06 מופץ. גרסה ‎1.2.0-alpha06 מכילה את השמירות האלה.

תכונות חדשות

  • פונקציות החישוב של הנחיית הפיגום של חלונית ברירת המחדל תומכות עכשיו בשיעורי גודל הרוחב של חלונות L ו-XL.

שינויים ב-API

  • הגדרת Modifier.paneExpansionDraggable כך שיספק סמנטיקה של נגישות כברירת מחדל, וקידום ממשקי API רלוונטיים לגרסה יציבה. (Idb818)
  • תמיכה בגרירה לשינוי גודל בחלוניות צפות (Idadd3)
  • תמיכה במסכי הצללה לחלונות צפים (I9b091)

גרסה ‎1.2.0-alpha05

‫7 במאי 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha05 מופץ. גרסה ‎1.2.0-alpha05 מכילה את השמירות האלה.

תכונות חדשות

  • פריסות מותאמות של Material3 תומכות עכשיו באסטרטגיות התאמה של Levitated, שיכולות להפוך חלונית לחלון קופץ צף.

שינויים ב-API

  • הוספת תמיכה בפונקציות של גודל החלון הנוכחי למספר פלטפורמות (Ie4172)
  • הוספת אנימציות לחלוניות צפות (Ic9dc3)
  • הוספת אסטרטגיית שיפור לשינוי (I1ba7c)

תיקוני באגים

  • תיקון השימוש בהיקף של שגרת המשך (coroutine) בדוגמאות דינמיות (7631016)

גרסה ‎1.2.0-alpha04

‫23 באפריל 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha04 מופץ. גרסה ‎1.2.0-alpha04 מכילה את השמירות האלה.

תכונות חדשות

  • מעכשיו אפשר להשתמש בשיטות לשינוי פריסה עם ListDetailPaneScaffold ו-SupportingPaneScaffold, שמשנות את הפריסה של החלונית המשויכת בהגדרה של פריסה עם חלונית אחת.

שינויים ב-API

  • הוספת מחזיק מצב שניתן לשמירה אל PaneScaffoldScope (Id9299)
  • הוספת אסטרטגיית סידור מחדש להתאמה (I75c6a)

תיקוני באגים

  • נפתרה בעיה שגרמה לכך שהחלוניות לא הונפשו במעבר הראשון. (Ib0415)
  • תיקון בעיה שבה הגבהים המועדפים לא פועלים. (I1913b)
  • תוקן הבאג שגורם לכך שההנחיה scaffold לא מתעדכנת בצורה נכונה. (0403ab)

גרסה ‎1.2.0-alpha03

‫9 באפריל 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha03 מופץ. גרסה ‎1.2.0-alpha03 מכילה את השמירות האלה.

תיקוני באגים

  • ​​תיקון של בעיה שגורמת להצגה שגויה של ידית הגרירה בפריסת חלונית יחידה. (806e443 )

עדכונים של תלות

  • הספרייה הזו מטרגטת עכשיו את רמת השפה Kotlin 2.0 ונדרשת KGP 2.0.0 או גרסה חדשה יותר. (Idb6b5)

גרסה ‎1.2.0-alpha02

‫26 במרץ 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha02 מופץ. גרסה ‎1.2.0-alpha02 מכילה את השמירות האלה.

גרסה ‎1.2.0-alpha01

‫12 במרץ 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha01 מופץ. גרסה ‎1.2.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

  • הוספנו את משנה ה-PaneScaffoldScope.preferredHeight למפתחים כדי לספק גבהים מועדפים של חלוניות שיוחלו באמצעות אסטרטגיות התאמה חדשות שאנחנו מתכננים להשיק. ‫(I957dd, ‏ b/220960090)
  • שינוי השם של סוגי ComponentOverride ל-Override, ושל סוגי ComponentOverrideContext ל-OverrideScope. (Id973c)
  • שינוי השם של חלק מהשיטות לביטול ברירת המחדל של רכיבים. (I222b3)

‫24 בספטמבר 2025

‫androidx.compose.material3.adaptive:adaptive-navigation3:1.0.0-alpha03 מופץ. גרסה ‎1.0.0-alpha03 מכילה את השמירות האלה.

שינויים ב-API

  • הוספת stub של KMP כדי ש-JetBrains יוכלו ליצור fork ולמלא את היעדים האלה כדי להפעיל את ה-CMP. (I75714)
  • מעבירים את adaptive-navigation3 אל commonMain כדי להפעיל שימוש מולטי-פלטפורמה. (I58aa9)

‫10 בספטמבר 2025

‫androidx.compose.material3.adaptive:adaptive-navigation3:1.0.0-alpha02 וגם androidx.compose.material3.adaptive:adaptive-navigation3-android:1.0.0-alpha02 מופצים. גרסה ‎1.0.0-alpha02 מכילה את השמירות האלה.

‫27 באוגוסט 2025

‫androidx.compose.material3.adaptive:adaptive-navigation3:1.0.0-alpha01 וגם androidx.compose.material3.adaptive:adaptive-navigation3-android:1.0.0-alpha01 מופצים. גרסה ‎1.0.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

אנחנו שמחים להודיע על השקת גרסת האלפא הראשונה של ספריית adaptive-navigation3. הספרייה החדשה הזו, שהיא חלק מהמערכת האקולוגית של Material Adaptive ו-Navigation3, נועדה לעזור לכם ליצור ממשקי משתמש מותאמים של Material שמשולבים עם הספרייה Navigation3.

אפשר להשתמש באסטרטגיות של סצנות כדי להטמיע פיגום של חלונית רשימה ופירוט קנונית (ListDetailSceneStrategy, rememberListDetailSceneStrategy) או פיגום של חלונית תומכת (SupportingPaneSceneStrategy, rememberSupportingPaneSceneStrategy). למידע נוסף על סצנות, אסטרטגיות של סצנות ומושגים חדשים אחרים שהוצגו ב-Navigation 3, אפשר לעיין במדריך ל-Navigation 3.

‫Compose Material3 Adaptive Version 1.1

גרסה 1.1.0

‫12 במרץ 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.1.0 מופץ. גרסה 1.1.0 מכילה את השמירות האלה.

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

  • ‫ListDetailPaneScaffold ו-SupportingPaneScaffold תומכים עכשיו בתכונת הרחבת החלונית – המשתמשים יכולים לגרור כדי לשנות את ברירת המחדל של חלוקת החלונית בפריסת שתי חלוניות, ומפתחים יכולים גם לשנות את חלוקת החלונית בזמן ריצה באמצעות שינוי של PaneExpansionState שהתווסף לאחרונה.
  • מעכשיו יש תמיכה בחיזוי של חזרה אחורה כברירת מחדל ב-NavigableListDetailPaneScaffold וב-NavigableSupportingPaneScaffold. אפשר גם להשתמש ב-ThreePaneScaffoldPredictiveBackHandler כדי לספק תמיכה בחיזוי חזרה עם יישומי פיגום משלכם עם שלושה חלונות.
  • עכשיו אפשר להתאים אישית את תנועות החלוניות במהלך המעבר בין חלוניות על ידי ציון ערכים שונים של EnterTransition ו-ExitTransition ל-AnimatedPane.

גרסה ‎1.1.0-rc01

‫26 בפברואר 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.1.0-rc01 מופץ. גרסה ‎1.1.0-rc01 מכילה את השמירות האלה.

תיקוני באגים

  • השבתת שינוי הגודל של חיזוי החזרה במבנה עם שלוש חלוניות (ab6fd0b)

גרסה ‎1.1.0-beta02

‫12 בפברואר 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.1.0-beta02 מופץ. גרסה ‎1.1.0-beta02 מכילה את השמירות האלה.

שינויים ב-API

  • בוצע שינוי באופן ההגדרה של isPredictiveBackInProgress בפונקציות האנימציה של MutableThreePaneScaffoldState כדי לשמור על עקביות המצב. (Idc97f)

תיקוני באגים

  • התנהגות ברירת המחדל של לחצן החזרה ב-NavigableListDetailPaneScaffold וב-NavigableSupportingPaneScaffold השתנתה ל-PopUntilScaffoldValueChange כדי לשמור על עקביות עם שאר הספרייה. (I873f0)
  • הגדרת סדר הניווט הנכון לנגישות של מסגרות חלוניות. (67d030)
  • פתרון הבעיה שבה מצבי התוכן בחלונית לא נשמרים. (88b0ff)
  • תמיכה בפעולות נגישות חלופיות במקום גרירה. (28266d)
  • הכרזה על פיצול החלונית הנוכחי אחרי שהוא משתנה. (0c3a80)

גרסה ‎1.1.0-beta01

‫29 בינואר 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.1.0-beta01 מופץ. גרסה ‎1.1.0-beta01 מכילה את השמירות האלה.

שינויים ב-API

  • הוספנו פונקציות ליצירת עוגנים להרחבת החלונית מסוג offset מההתחלה ומהסוף, בהתאמה. (I2eb21)
  • ממשק Seal PaneMotion והסרת שיטות המעבר שמוגדרות בו כברירת מחדל. (Ifc4c7)
  • הוספנו ממשקי API לקבלת העוגן הנוכחי ולהנפשה של עוגן. (Icf95d)
  • הוספת ממשקי API לנגישות להרחבת חלוניות (Icc669)
  • שינוי הסוג של PaneScaffoldParentData.preferredWidth ל-DP. (Id98ee)

גרסה ‎1.1.0-alpha09

‫15 בינואר 2025

‫androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha09 מופץ. גרסה ‎1.1.0-alpha09 מכילה את השמירות האלה.

שינויים ב-API

  • הוספה ושימוש בהערה ניסיונית חדשה ExperimentalMaterial3AdaptiveComponentOverrideApi. (Id45aa)
  • הסתרה של ThreePaneScaffoldHorizontalOrder.toLtrOrder. (I6f8d2)
  • הסרטון ThreePaneScaffoldPredictiveBackHandler הוגדר כגלוי לכולם. (I1a995, b/370543873)
  • נוספה מאפיין isPredictiveBackInProgress אל ThreePaneScaffoldState. (I1a995, b/370543873)
  • יצירת מנגנון עוקף ל-AnimatedPane כדי לתמוך בהטמעות של טעינה צדדית עבור גורמי צורה שונים. (Id7622)

תיקוני באגים

  • פתרון הבעיה שבה אין עוגנים לכיוון ההתייצבות. (df8257d)

גרסה ‎1.1.0-alpha08

‫12 בדצמבר 2024

‫androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha08 מופץ. גרסה ‎1.1.0-alpha08 מכילה את השמירות האלה.

שינויים ב-API

  • הצגת הפונקציה currentWindowDpSize. (I99125, ‏ b/296300441)
  • חשיפה של PaneScaffoldParentData ו-ThreePaneScaffoldHorizontalOrder.toLtrOrder() (I2d6b7)
  • מסירים את PaneScaffoldMotionScope והופכים אותו לשדה בקטע PaneScaffoldTransitionScope. בנוסף, צריך לשנות את השם ל-PaneScaffoldMotionDataProvider ולהסיר את הגישה למבנה הנתונים הבסיסי של PaneMotionData. במקום זאת, צריך לספק שיטות getter ושיטות לולאה לגישה לנתונים. (Id8884)
  • יצירת מנגנון עוקף ל-ThreePaneScaffold כדי לתמוך בהטמעות של טעינה צדדית עבור גורמי צורה שונים. (I5280f)
  • מגדיר כברירת מחדל את מצב ההרחבה של החלונית כ-null (Ia65f8, b/376394520)

גרסה ‎1.1.0-alpha07

‫13 בנובמבר 2024

‫androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha07 מופץ. גרסה ‎1.1.0-alpha07 מכילה את השמירות האלה.

שינויים ב-API

  • הסרנו את ההטמעה של ידית הגרירה בספרייה האדפטיבית, ואנחנו מעודדים אנשים להשתמש בגרסה M3 שלה. במקביל, מוסיפים משנה כדי לספק יכולת גרירה להרחבת החלונית לרכיב שאפשר להרכיב ממנו נקודת אחיזה לגרירה. כדאי גם להסתיר את DraggableState כפרט הטמעה, כדי שנוכל לשנות אותו בהמשך אם יהיה צורך. (Ib50cd)
  • העברנו את נקודת הכניסה להתאמה אישית של תנועת החלונית מפונקציות ה-scaffold אל AnimatedPane בהתאם למשוב של UXR. (I10f72)
  • הוספנו תמיכה בהטלה (fling) ומפרט של אנימציה מותאמת אישית להרחבת החלונית. (Ie207d, b/362584341)

תיקוני באגים

  • פתרון בעיות שקשורות לניווט חזוי בביטול. ‫(36a3e0a), (b/369899645)

גרסה ‎1.1.0-alpha06

‫30 באוקטובר 2024

‫androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha06 מופץ. גרסה ‎1.1.0-alpha06 מכילה את השמירות האלה.

שינויים ב-API

  • הוספת FloatRange אל PaneScaffoldTransitionScope.motionProgress. (Iac0dd)
  • שינוי הסוג של פרמטרים של רכיב הניווט לסוגים גנריים ב-scaffolds שניתן לנווט בהם. (I1da6e)

גרסה ‎1.1.0-alpha05

‫16 באוקטובר 2024

‫androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha05 מופץ. גרסה ‎1.1.0-alpha05 מכילה את השמירות האלה.

שינויים ב-API

  • הוספנו מחלקה של מפרטי אנימציה כדי להבטיח התנהגות תנועה עקבית יותר ואפשרות להרחבה בעתיד. (I2d3cc)
  • מציינים את סוג התנועה ומשנים את השם של currentXXXXX ב-PaneMotionData ל-originXXXX. (I7c61a)

גרסה ‎1.1.0-alpha04

‫2 באוקטובר 2024

‫androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha04 מופץ. גרסה ‎1.1.0-alpha04 מכילה את השמירות האלה.

תכונות חדשות

  • הוספנו תמיכה בחיזוי החזרה ל-NavigableListDetailPaneScaffold ול-NavigableSupportingPaneScaffold. (I4dc21, b/359616816)

שינויים ב-API

  • ThreePaneScaffoldState נוסף לרשימה ThreePaneScaffoldNavigator. שיטות הניווט שונו suspend כדי לתמוך בניווט עם אנימציה. נוסף seekBack לתמיכה במצבי ניווט חלקיים (לדוגמה, חיזוי החזרה). ‫(I5a651, ‏ b/359616816)
  • נוסף MutableThreePaneScaffoldState כדי לשלוט במעבר בין ערכי הפיגום. ה-ThreePaneScaffoldState הקיים הוגדר לקריאה בלבד. (Idb3c6)
  • הצגת הטמעות ברירת מחדל של תנועות בחלונית (I95a7b)
  • הפעלת ההגדרה של עוגן ראשוני של מצב הרחבת החלונית (Ie41b3, ‏ b/362350560)

תיקוני באגים

  • החלת גודל מינימלי של יעד מגע של 48x48dp עבור ידית הגרירה (7ce6635, ‏ b/366018217)
  • שחזור המיקום המעוגן אחרי שינויים בהגדרות (3c9fc6b, b/362353672)

גרסה ‎1.1.0-alpha03

‫18 בספטמבר 2024

‫androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha03 מופץ. גרסה ‎1.1.0-alpha03 מכילה את השמירות האלה.

גרסה ‎1.1.0-alpha02

‫4 בספטמבר 2024

‫androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha02 מופץ. גרסה ‎1.1.0-alpha02 מכילה את השמירות האלה.

תכונות חדשות

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

שינויים ב-API

  • הוספת ממשקי API להרחבת חלוניות שחסרים ב-scaffolds (Ic5bc0)
  • השם של ThreePaneScaffoldDestinationItem.content שונה לcontentKey. הארגומנט מסוג ברירת המחדל של rememberListDetailPaneScaffoldNavigator ושל rememberSupportingPaneScaffoldNavigator השתנה מ-Nothing ל-Any. (I58749)
  • סימון של ThreePaneScaffoldState כגרסה יציבה (I64aec)
  • הגדרת היקף לפרמטרים של נקודת אחיזה לגרירה (Ic0aa2)

גרסה ‎1.1.0-alpha01

‫21 באוגוסט 2024

‫androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha01 מופץ. גרסה ‎1.1.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

  • הוספת תמיכה בהרחבת חלוניות של מסגרות ניתנות להתאמה.

שינויים ב-API

  • הוספת ממשקי API להרחבת חלוניות לציבור (I301d6)
  • הוספנו ThreePaneScaffoldState כדי לשלוט במעברים של ערכים בחלונית הבקרה. נוספו עומסים עודפים של ListDetailPaneScaffold ו-SupportingPaneScaffold שמקבלים את המצב הזה. (I5db3b)
  • הוספנו מקש להרחבת החלונית וממשק לספק מפתחות (Id621f)

תיקוני באגים

  • תיקון חישוב שגוי של מחיצה כשציר מוחרג מוצג. (9dfd483)

‫Compose Material3 Adaptive Version 1.0

גרסה 1.0.0

‫4 בספטמבר 2024

‫androidx.compose.material3.adaptive:adaptive-*:1.0.0 מופץ. גרסה 1.0.0 מכילה את השמירות האלה.

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

  • פונקציות שאפשר להרכיב בשורה אחת currentWindowSize(),‏ collectFoldingFeaturesAsState() ו-currentWindowAdaptiveInfo() כדי לקבל את פרטי החלון הנדרשים להתאמת אפליקציות, כמו גדלי חלונות ותכונות קיפול.
  • ‫ListDetailPaneScaffold ו-SupportingPaneScaffold כדי לספק שני פריסות קנוניות של Material3 שיתאימו את עצמן באופן אוטומטי בהתאם להגדרות שונות של חלונות. אפשר גם להתאים אישית את שני השלדים האלה לצרכים השונים של היוצרים.
  • ‫ThreePaneScaffoldNavigator ופונקציות הזיכרון הרלוונטיות שלו, rememberListDetailPaneScaffoldNavigator() ו-rememberSupportingPaneScaffoldNavigator(), כדי לספק פתרונות ניווט בפיגום דינמי, שיכול להציג כמה יעדי ניווט בו-זמנית, בהשוואה להגדרה הנפוצה של יעד אחד בכל פעם בעולם הלא-דינמי.
  • אנימציות מובנות של Material3 שמופעלות כברירת מחדל כשמשנים את מצבי ה-scaffold האדפטיבי.

גרסה ‎1.0.0-rc01

‫21 באוגוסט 2024

‫androidx.compose.material3.adaptive:adaptive-*:1.0.0-rc01 מופץ. גרסה ‎1.0.0-rc01 מכילה את השמירות האלה.

תיקוני באגים

  • תיקון חישוב שגוי של מחיצה כשציר מוחרג מוצג. (9dfd483)

גרסה ‎1.0.0-beta04

‫26 ביוני 2024

‫androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta04 מופץ. גרסה ‎1.0.0-beta04 מכילה את השמירות האלה.

תיקוני באגים

  • תוקנה הבעיה שבה הפריסה לא מתעדכנת בהתאם לעדכון של גבולות הציר. (71e9cf1)

גרסה ‎1.0.0-beta03

‫12 ביוני 2024

‫androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta03 מופץ. גרסה ‎1.0.0-beta03 מכילה את השמירות האלה.

תיקוני באגים

  • תוקנו קריסות שנגרמו עקב רזולוציית תלות שגויה בגרסה beta02.

גרסה ‎1.0.0-beta02

‫29 במאי 2024

‫androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta02 מופץ. גרסה ‎1.0.0-beta02 מכילה את השמירות האלה.

גרסה ‎1.0.0-beta01

‫14 במאי 2024

‫androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta01 מופץ. גרסה ‎1.0.0-beta01 מכילה את השמירות האלה.

גרסה ‎1.0.0-alpha12

‫1 במאי 2024

‫androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha12 מופץ. גרסה ‎1.0.0-alpha12 מכילה את השמירות האלה.

שינויים ב-API

  • הוספת פרטים של isFlat אל HingeInfo (Ie0516, ‏ b/333784198)
  • הפיכת ממשקי API דינמיים ללא ניסיוניים (I1d038)
  • הפיכת ממשקי API של פריסה דינמית ללא ניסיוניים (Id23df)
  • הערך בשדה BackNavigationBehavior השתנה מסוג enum לסוג value class ‏ (Id8757)

תיקוני באגים

גרסה ‎1.0.0-alpha11

‫17 באפריל 2024

‫androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha11 מופץ. גרסה ‎1.0.0-alpha11 מכילה את השמירות האלה.

שינויים ב-API

  • הגדרת ממשקי היקף כסגורים. (Iefa57)
  • תציג את AnimatedPaneScope. (I62d73, ‏ b/332750742)
  • הקפידו שAdaptStrategy יהיה אטום ויציב. (Ia28b2)
  • הוספת שיטה ליצירת עותק של PaneScaffoldDirective. (I9291f)
  • סימון של ThreePaneScaffoldScope כניסיוני. (I9d527)
  • לספק ממשקי API פשוטים לשימוש עם תמיכה בניווט. (I263f0, b/321010778)

גרסה ‎1.0.0-alpha10

‫3 באפריל 2024

‫androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha10 מופץ. גרסה ‎1.0.0-alpha10 מכילה את השמירות האלה.

שינויים ב-API

  • הגדרת רוחב מועדף כברירת מחדל שניתן להתאמה אישית. (Ic3abc)
  • שינוי השם של פונקציות חישוב של תגי scaffold. (I10855)
  • הסרה של ריווח פנימי וריווח שוליים מממשקי API של scaffold. (I786f8)
  • הוספת שיטות לזכירת נתוני ניווט ללא סוגים גנריים. (I607c3)

גרסה ‎1.0.0-alpha09

‫20 במרץ 2024

‫androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha09 מופץ. גרסה ‎1.0.0-alpha09 מכילה את השמירות האלה.

שינויים ב-API

  • הוספת שדות של מעבר סטטוס ל-ThreePaneScaffoldScope. (I3d917)
  • שינוי הסדר של פרמטרים של פיגומים. (I4dff5)
  • צריך לספק ערך ברירת מחדל לפרמטר של משנה AnimatedPane. (I77dd7)

תיקוני באגים

  • האם לכלול את גודל הרווח בין החלוניות בתנועות של החלוניות. (a3174ca)

גרסה ‎1.0.0-alpha08

6 במרץ 2024

‫androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha08 מופץ. גרסה ‎1.0.0-alpha08 מכילה את השמירות האלה.

תכונות חדשות

  • הטמעה של החלקה מושהית פנימה כשעוברים בין חלוניות. (I1a38e)

שינויים ב-API

  • הוסר הממשק ThreePaneScaffoldState. (I63f23)

גרסה ‎1.0.0-alpha07

‫21 בפברואר 2024