Constraintlayout

Constraintlayout

מדריך למשתמש  דוגמה לקוד

הפניית API
androidx.constraintlayout.widget

מיקום וגודל של ווידג'טים באופן גמיש באמצעות מיקום יחסי.

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

פריט מידע שנוצר בתהליך פיתוח (Artifact)	גרסה יציבה	גרסה מועמדת להפצה	גרסת בטא	גרסה אלפא
constraintlayout	2.2.1	-	-	-
constraintlayout-compose	1.1.1	-	-	-
constraintlayout-core	1.1.1	-	-	-

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

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

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

מגניב

dependencies {
    implementation "androidx.constraintlayout:constraintlayout:2.2.0-beta01"
    // To use constraintlayout in compose
    implementation "androidx.constraintlayout:constraintlayout-compose:1.1.0-beta01"
}

Kotlin

dependencies {
    implementation("androidx.constraintlayout:constraintlayout:2.2.0-beta01")
    // To use constraintlayout in compose
    implementation("androidx.constraintlayout:constraintlayout-compose:1.1.0-beta01")
}

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

משוב

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

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

מידע נוסף זמין במסמכי התיעוד של Issue Tracker.

ConstraintLayout-compose ו-ConstraintLayout-Core 1.1

גרסה 1.1.1

26 בפברואר 2025

התכונות androidx.constraintlayout:constraintlayout-compose:1.1.1, androidx.constraintlayout:constraintlayout-compose-android:1.1.1 וגם androidx.constraintlayout:constraintlayout-core:1.1.1 משוחררות. גרסה 1.1.1 מכילה את ההוספות האלה.

תיקוני באגים

• תוקנו בעיות מסוימות בפריסה, שבחלק מהמקרים גרמו לכך שפריסות לא הוצבו. למשל, החלפת מצב החשיפה. (I34e68, ‏ b/299134793)

גרסה 1.1.0

30 באוקטובר 2024

התכונות androidx.constraintlayout:constraintlayout-compose:1.1.0, androidx.constraintlayout:constraintlayout-compose-android:1.1.0 וגם androidx.constraintlayout:constraintlayout-core:1.1.0 משוחררות. גרסת 1.1.0 כוללת את ההוספות האלה.

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

• תיקון האינטראקציה עם SharedTransitionLayout‏ (b/332898040).
• תיקון בעיות שקשורות לפריסה שקשורות למדידה עקב יצירת קומפוזיציה מחדש (b/219091179, ‏ Ibfe8a).

גרסה 1.1.0-rc01

16 באוקטובר 2024

התכונות androidx.constraintlayout:constraintlayout-compose:1.1.0-rc01, androidx.constraintlayout:constraintlayout-compose-android:1.1.0-rc01 וגם androidx.constraintlayout:constraintlayout-core:1.1.0-rc01 משוחררות. גרסת 1.1.0-rc01 כוללת את ההוספות האלה.

גרסה 1.1.0-beta01

4 בספטמבר 2024

התכונות androidx.constraintlayout:constraintlayout-compose:1.1.0-beta01, androidx.constraintlayout:constraintlayout-compose-android:1.1.0-beta01 וגם androidx.constraintlayout:constraintlayout-core:1.1.0-beta01 משוחררות. גרסת 1.1.0-beta01 כוללת את ההוספות האלה.

גרסה 1.1.0-alpha14

7 באוגוסט 2024

התכונות androidx.constraintlayout:constraintlayout-compose:1.1.0-alpha14, androidx.constraintlayout:constraintlayout-compose-android:1.1.0-alpha14 וגם androidx.constraintlayout:constraintlayout-core:1.1.0-alpha14 משוחררות. גרסת 1.1.0-alpha14 מכילה את ההוספות האלה.

שינויים ב-API

• הדגלים ניתנים עכשיו בנפרד דרך האובייקט הנלווה, וניתן לשלב אותם עם האופרטור or. (I9df53)
• פונקציות עזר פשוטות יותר של createRow ו-createColumn. שמות פרמטרים משופרים של createGrid ומסמכים מפורטים יותר. (Iebc92)
• ממשק API פשוט יותר של animateChanges ב-ConstraintLayout, שבו נדרש רק AnimationSpec שאינו null. הפונקציה onIncomingConstraints ב-InvalidationStrategy היא עכשיו פונקציית lambda רגילה. השם של fixedWidthRate השתנה ל-shouldInvalidateOnFixedWith, ואותו הדבר לגבי הווריאנט 'גובה'. (Ie59cd, ‏ b/332898040, ‏ b/336370035)
• מקורות הנתונים NestedScroll 'גרירה' ו'השלכה' מוחלפים ב-UserInput וב-SideEffect כדי להתאים להגדרה המורחבת של המקורות האלה, שכוללת עכשיו אנימציות (Side Effect) גלגלת העכבר ומקלדת (UserInput). (I40579)

גרסה 1.1.0-alpha13

4 באוקטובר 2023

androidx.constraintlayout:constraintlayout-compose:1.1.0-alpha13, ‏androidx.constraintlayout:constraintlayout-compose-android:1.1.0-alpha13 ו-androidx.constraintlayout:constraintlayout-core:1.1.0-alpha13 פורסמו ללא שינויים. גרסה 1.1.0-alpha13 מכילה את ההצהרות האלה.

• הגרסה הזו מאפשרת לספריות androidx.constraintlayout להיות תואמות ל-ABI עם הגרסאות האחרונות של Compose.

גרסה 1.1.0-alpha12

9 באוגוסט 2023

התכונות androidx.constraintlayout:constraintlayout-compose:1.1.0-alpha12, androidx.constraintlayout:constraintlayout-compose-android:1.1.0-alpha12 וגם androidx.constraintlayout:constraintlayout-core:1.1.0-alpha12 משוחררות. גרסה 1.1.0-alpha12 מכילה את ההוספות האלה.

שינויים ב-API

• הוספת LayoutScopeMarker ל-Transition DSL. (If54ce)

גרסה 1.1.0-alpha11

26 ביולי 2023

התכונות androidx.constraintlayout:constraintlayout-compose:1.1.0-alpha11, androidx.constraintlayout:constraintlayout-compose-android:1.1.0-alpha11 וגם androidx.constraintlayout:constraintlayout-core:1.1.0-alpha11 משוחררות. גרסה 1.1.0-alpha11 מכילה את השמירות האלה.

תכונות חדשות

• עכשיו אפשר לספק InvalidationStrategy כדי לבצע אופטימיזציה של ביטולי התוקף ב-MotionLayout. בדרך כלל זהו המקור לירידה בביצועים. (Iada0c)
• עכשיו אפשר להשתמש ב-animateChanges = true כשמשתמשים ב-ConstraintLayout עם Modifier DSL בשורה (Modifier.constrainAs). בכל פעם שמתבצע שינוי ב-DSL של האילוצים, ConstraintLayout יתבצע אנימציה אוטומטית למצב החדש. (I9abf1)
• הפעלת הפונקציונליות של limitBoundsTo ב-OnSwipe. (I56522)

שינויים ב-API

• השם של TransitionScope.staggered השתנה ל-TransitionScope.maxStaggerDelay. (I0fd2d)

תיקוני באגים

• תוקן הפרמטר dragScale מ-OnSwipe שלא עבד. (8bef26)
• תוקנה בעיה ב-customColor ב-MotionScene שבה צבעים שקופים לא עובדים כמו שצריך. (81b2ac)
• תוקן הבאג שבו OnSwipe לא הודיע כראוי כשהוא עצר, וגם תוקן החישוב של המהירות ההתחלתית עבור touchUp. (Ia5f6f)
• עדכנו את KDoc עבור ConstraintLayout Composable ו-Constraintset. (3bfe63)

גרסה 1.1.0-alpha10

24 במאי 2023

התכונות androidx.constraintlayout:constraintlayout-compose:1.1.0-alpha10, androidx.constraintlayout:constraintlayout-compose-android:1.1.0-alpha10 וגם androidx.constraintlayout:constraintlayout-core:1.1.0-alpha10 משוחררות. גרסה 1.1.0-alpha10 מכילה את ההצהרות האלה.

שינויים ב-API

• ממשק ה-API של MotionLayout כבר לא נמצא בגרסת ניסיון. זוהי הקבוצה הראשונית של ממשקי ה-API היציבים של MotionLayout. (I288f4)
• בוצעה הסרה של MotionLayoutState. (Id3ac1)
• עכשיו אפשר להשתמש ב-DebugFlags לניפוי באגים חזותי: DebugFlags(showBounds = true). (Ic714b)
• משתנה התוסף Dp.asDimension השתנה לשיטה: Dp.asDimension(). (I2d6ef)
• עכשיו יש תמיכה בפריסה מדורגת ב-DSL של MotionLayout. אפשר להגדיר את העיכוב המקסימלי באמצעות TransitionScope.staggered. אפשר גם להשתמש ב-ConstrainScope.staggeredWeight (בתוך MotionSceneScope) כדי לקבל סדר מדורג בהתאמה אישית. (I70275)
• בוצעו שני שינויים בכלי העזר של התצוגה בתצוגת רשת: 1. paddingLeft ו-paddingRight ל-paddingStart ו-paddingEnd, בהתאמה, ו-2. מעדכנים את הפורמט של gridSpans ו-gridSkip למערך של אובייקטים מסוג Span ו-Skip כדי ליצור מבנה יותר. (Idd1eb)

גרסה 1.1.0-alpha09

22 במרץ 2023

androidx.constraintlayout:constraintlayout-compose:1.1.0-alpha09 ו-androidx.constraintlayout:constraintlayout-core:1.1.0-alpha09 משוחררים. גרסה 1.1.0-alpha09 מכילה את ההצהרות האלה.

שינויים ב-API

• עכשיו לא נדרש LookaheadScope מפורש ב-Modifier.intermediateLayout. בבלוק המדידה ב-intermediateLayout, IntermediateMeasureScope הוא המקלט, שמספק את הערכים הנוחים CoroutineScope,‏ LookaheadScope ו-MeasureScope.
• LookaheadLayout הוחלף ב-LookaheadScope, שכבר לא נחשב לפריסה. כך אפשר לשלוט ישירות בתוכן הצאצא ב-LookaheadScope באמצעות MeasurePolicy של ההורה. (Ibe2e5)
• עכשיו אפשר להשתמש ב-Easing.Cubic() עם פרמטרים של חריגה מהיעד. (I2d826)

גרסה 1.1.0-alpha08

8 במרץ 2023

androidx.constraintlayout:constraintlayout-compose:1.1.0-alpha08 ו-androidx.constraintlayout:constraintlayout-core:1.1.0-alpha08 משוחררים. גרסה 1.1.0-alpha08 מכילה את ההצהרות האלה.

תכונות חדשות

• נוספו בדיקות Lint כדי להציע שימוש ב-Dimension.percent(1f) וב-LayoutReference.withChainParams() במקרים שבהם הדפוסים הרגילים עלולים להוביל להתנהגות בלתי צפויה. (I62eb0, ‏ I03060)

שינויים ב-API

• מפעילים את הדגלים ReverseSpanDirection ו-SpansOrderFirst לכלי העזר של התצוגה בתצוגת רשת בחלונית הכתיבה.
  1. ReverseSpanDirection: היפוך של מפרט הרוחב והגובה של קטעי הקוד או הקפיצות.
  2. SpansOrderFirst: ה-spans יתייחסו לסדר של הווידג'טים. (I6ad50)
• משתמשים ב-Modifier.onStartEndBoundsChanged(...) כדי לקבל גבולות מקומיים של רכיבי Composables ב-MotionLayout שלא מושפעים מאנימציה. שימושי לכל אינטראקציה של ממשק משתמש שדורשת פרטי פריסה שעשויים גם להפעיל אנימציות כמו DragAndDrop. (I6b5f9)
• הפעלת דילוגים וחיבורים של הכלי לעיצוב התמונות בתצוגת רשת בזמן כתיבת אימייל (I917b6)

תיקוני באגים

• מאפייני תרגום קבועים שלא מחילים ערכים צפויים. (I961cd)

גרסה 1.1.0-alpha07

8 בפברואר 2023

androidx.constraintlayout:constraintlayout-compose:1.1.0-alpha07 ו-androidx.constraintlayout:constraintlayout-core:1.1.0-alpha07 משוחררים. גרסה 1.1.0-alpha07 מכילה את ההוספות האלה.

תכונות חדשות

• הוספת ממשקי API חדשים כדי להפעיל את Grid Helper ב-Compose באמצעות DSL (I1143b)

תיקוני באגים

• תוקן Wrap.Chain ל-Flow שלא פורס בצורה תקינה לפי הפרמטר maxElement הנתון. (e1f2ed3)
• תוקנה בעיה שבה start ConstraintSet לא מתעדכן כשמשנים את המעבר דרך MotionLayout(motionScene: MotionScene, progress: Float, transitionName: String). (17ffff1)
• תוקנה בעיה שבה השינויים מסוימים לא משתקפים ב-ConstraintSet כשמקבלים בירושה אילוצים דרך ConstraintSet(extendConstraintSet: ConstraintSet, description: ConstraintSetScope.() -> Unit).‏ (740804b)

גרסה 1.1.0-alpha06

25 בינואר 2023

androidx.constraintlayout:constraintlayout-compose:1.1.0-alpha06 ו-androidx.constraintlayout:constraintlayout-core:1.1.0-alpha06 משוחררים. גרסה 1.1.0-alpha06 מכילה את ההוספות האלה.

תכונות חדשות

• הוספת ממשקי API חדשים כדי להפעיל את הכלי Grid Helper ב-Compose עם ייצוג JSON, שמאפשר למקם רכיבים מורכבים (composables) בתצוגת רשת דו-מימדית. (I968ad)

שינויים ב-API

• הוספת תמיכה ב-MotionLayout למצבי קשת למעלה ולמטה Arc.Above ולמצבי קשת שאינם תלויים בכיוון Arc.Below (I184a9)
• עכשיו אפשר להגביל עוגן של קו בסיס לעוגנים בחלק העליון או התחתון של המסך, ולהפך. (I54628)
• השם של MotionLayoutScope#motionProperties (כולל נגזרות) השתנה ל-MotionLayoutScope#customProperties. יש להקפיד על עקביות כמו בהגדרת מאפיינים מותאמים אישית. (Ib34c9)
• עכשיו אפשר ליצור כמה הפניות ב-ConstraintSet וב-MotionScene: val (box, text, button) = createRefsFor("box", "text","button"). החלת אילוצים על כמה אלמנטים באמצעות constrain(box, button, text). עכשיו אפשר להגדיר באופן אינטואיטיבי מאפיין קבוע ב-ConstrainScope באמצעות Dp.asDimension: width = 10.dp.asDimension. (I021ec, ‏ Ia0960)
• השיטות MotionScene() ו-Transition() הן עכשיו פונקציות שלא ניתן לשלב. עכשיו אפשר להשוות בין האובייקטים מהפונקציות האלה (כולל ConstraintSet) בצורה תקינה. עכשיו אפשר להשתמש ב-animateChanges = true ב-ConstraintLayout עם קובץ עזר אחד בלבד של ConstraintSet, כל עוד אחד מהמאפיינים שלו השתנה במהלך הרכבת מחדש. (I7d22e)

תיקוני באגים

• תוקנה בעיה שבה ConstraintLayout תמיד גרמה ליצירה מחדש מיותרת נוספת כשהעזרות השתנו. (Id83ad, ‏ b/222093277)
• תיקון ההתנהגות כשמשתמשים ב-Intrinsics עם ConstraintLayout ו-MotionLayout. (I487ae, ‏ b/220527863)
• תיקון של הבעיה שבה לא ניתן למדוד מחדש כשהתוכן משתנה. (Ibfe8a, b/219091179)

גרסה 1.1.0-alpha05

7 בדצמבר 2022

androidx.constraintlayout:constraintlayout-compose:1.1.0-alpha05 ו-androidx.constraintlayout:constraintlayout-core:1.1.0-alpha05 משוחררים. גרסה 1.1.0-alpha05 מכילה את ההוספות האלה.

תכונות חדשות

• תמיכה ב-KeyAttributes בהתאמה אישית ב-DSL (b94e748)
• מאפייני הטיה של פלטפורמה ב-ConstrainScope‏ (32625d0)
• תמיכה בפרמטרים מותאמים אישית בשרשורים (72a2e9e)
• הוספת בדיקות Macrobenchmark ל-MotionLayout ב-Compose (36f43bc)
• מידע נוסף על השינויים בגרסה הקודמת של Compose זמין בדף הוויקי.

שינויים ב-API

• היפוך הפרמטרים addConstraintSet ו-addTransition (152facc)

תיקוני באגים

• תיקון רשתות אופקיות (ed5f56e)

גרסה 1.1.0-alpha01

20 במאי 2022

androidx.constraintlayout:constraintlayout-compose:1.1.0-alpha01 משוחרר.

חשוב לזכור ש-MotionLayout API הוא ניסיוני ונדרש אישור להשתמש בו.

מידע נוסף זמין במאמר מה חדש ב-Compose 1.1.0-alpha01 ב-GitHub.

גרסה 2.2

גרסה 2.2.1

26 בפברואר 2025

androidx.constraintlayout:constraintlayout:2.2.1 משוחרר. גרסת 2.2.1 כוללת את ההוספות האלה.

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

• תיקון בעיה בתאימות הבינארית של ספריית constraintlayout-core. תודה Carlo Marinangeli! (I8952e, ‏ b/376718273)

גרסה 2.2.0

30 באוקטובר 2024

androidx.constraintlayout:constraintlayout:2.2.0 משוחרר. גרסת 2.2.0 כוללת את ההוספות האלה.

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

• גרסה תואמת עם ספריית הליבה של constraintlayout.

גרסה 2.2.0-rc01

16 באוקטובר 2024

androidx.constraintlayout:constraintlayout:2.2.0-rc01 משוחרר. גרסת 2.2.0-rc01 כוללת את ההוספות האלה.

גרסה 2.2.0-beta01

4 בספטמבר 2024

androidx.constraintlayout:constraintlayout:2.2.0-beta01 משוחרר. גרסת 2.2.0-beta01 כוללת את ההוספות האלה.

גרסה 2.2.0-alpha14

7 באוגוסט 2024

androidx.constraintlayout:constraintlayout:2.2.0-alpha14 משוחרר. גרסת 2.2.0-alpha14 מכילה את ההוספות האלה.

גרסה 2.2.0-alpha13

4 באוקטובר 2023

androidx.constraintlayout:constraintlayout:2.2.0-alpha13 משוחרר ללא שינויים. גרסה 2.2.0-alpha13 מכילה את ההוספות האלה.

גרסה 2.2.0-alpha12

9 באוגוסט 2023

androidx.constraintlayout:constraintlayout:2.2.0-alpha12 משוחרר. גרסה 2.2.0-alpha12 מכילה את ההוספות האלה.

גרסה 2.2.0-alpha11

26 ביולי 2023

androidx.constraintlayout:constraintlayout:2.2.0-alpha11 משוחרר. גרסה 2.2.0-alpha11 מכילה את ההצהרות האלה.

שינויים ב-API

• מוסיפים שיטה להגדרת ערך (setter) כדי לאפשר למפתחים להגדיר את הערך של mInfiniteCarousel באופן פרוגרמטי (I0a8ca)

גרסה 2.2.0-alpha10

24 במאי 2023

androidx.constraintlayout:constraintlayout:2.2.0-alpha10 משוחרר. גרסה 2.2.0-alpha10 מכילה את ההצהרות האלה.

תיקוני באגים

• תיקון קישור פגום במסמך MotionLayout. (51cbe88)

גרסה 2.2.0-alpha09

22 במרץ 2023

androidx.constraintlayout:constraintlayout:2.2.0-alpha09 משוחרר. גרסה 2.2.0-alpha09 מכילה את ההוספות האלה.

גרסה 2.2.0-alpha08

8 במרץ 2023

androidx.constraintlayout:constraintlayout:2.2.0-alpha08 משוחרר. גרסה 2.2.0-alpha08 מכילה את ההוספות האלה.

גרסה 2.2.0-alpha07

8 בפברואר 2023

androidx.constraintlayout:constraintlayout:2.2.0-alpha07 משוחרר. גרסה 2.2.0-alpha07 מכילה את ההוספות האלה.

תיקוני באגים

• פותרים את הבעיה של התוכן החסר בדף ConstraintLayout. (I82e25)

גרסה 2.2.0-alpha05

7 בדצמבר 2022

androidx.constraintlayout:constraintlayout:2.2.0-alpha05 משוחרר. גרסה 2.2.0-alpha05 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

• מידע נוסף על השינויים בגרסה הקודמת זמין בדף הוויקי של GitHub.

תיקוני באגים

• תיקון דליפת נתונים ב'קרוסלה של צפיות' (eb67b82)

גרסה 2.2.0-alpha01

20 במאי 2022

androidx.constraintlayout:constraintlayout:2.2.0-alpha01 משוחרר.

כולל תצוגה מקדימה של העזרה החדשה של Grid.

מידע נוסף זמין במאמר מה חדש בגרסה 2.2.0-alpha01 ב-GitHub.

ConstraintLayout-compose 1.0

ConstraintLayout-compose 1.0 מספק את הפונקציונליות של ConstraintLayout ב-Jetpack Compose.

גרסה 1.0.1

20 במאי 2022

androidx.constraintlayout:constraintlayout-compose:1.0.1 משוחרר.

חשוב לזכור ש-MotionLayout API הוא ניסיוני ונדרש אישור להשתמש בו.

מידע נוסף זמין במאמר מה חדש ב-Compose 1.0.1 ב-GitHub.

גרסה 1.0.0

13 בינואר 2022

androidx.constraintlayout:constraintlayout-compose:1.0.0 משוחרר.

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

מידע נוסף זמין במאמר ב-GitHub מה חדש בגרסה 1.0 (Compose).

גרסה 1.0.0-rc02

16 בנובמבר 2021

androidx.constraintlayout:constraintlayout-compose:1.0.0-rc02 משוחרר.

מידע נוסף זמין במאמר ב-GitHub מה חדש בגרסה 1.0 (Compose).

גרסה 1.0.0-rc01

27 בספטמבר 2021

androidx.constraintlayout:constraintlayout-compose:1.0.0-rc01 משוחרר.

זוהי גרסת הבטא השנייה. הוא נחשב כתכונה מלאה, ומספק את הערכים ConstraintLayout ו-MotionLayout ל-Compose.

מידע נוסף זמין במאמר ב-GitHub מה חדש בגרסה 1.0 (Compose).

גרסה 1.0.0-beta02

30 ביולי 2021

androidx.constraintlayout:constraintlayout-compose:1.0.0-beta02 משוחרר.

זוהי גרסת הבטא השנייה. הוא נחשב כתכונה מלאה, ומספק את הערכים ConstraintLayout ו-MotionLayout ל-Compose.

מידע נוסף זמין במאמר ב-GitHub What's New in 1.0 (Compose).

גרסה 1.0.0-beta01

22 ביולי 2021

androidx.constraintlayout:constraintlayout-compose:1.0.0-beta01 משוחרר.

זוהי גרסת הבטא הראשונה. הוא נחשב כתכונה מלאה, ומספק את הערכים ConstraintLayout ו-MotionLayout ל-Compose.

מידע נוסף זמין במאמר ב-GitHub מה חדש בגרסה 1.0 (Compose).

גרסה 1.0.0-alpha07

18 במאי 2021

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha07 משוחרר.

• העדכון מותאם לגרסה 1.0.0-beta07 של Compose.

גרסה 1.0.0-alpha06

4 במאי 2021

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha06 משוחרר.

• אופטימיזציה של Compose: רכיב Constraintlayout בתוך שורת קוד (#193)
• צמצום של מדידות חוזרות ב-Compose‏ (#210)

גרסה 1.0.0-alpha05

15 במרץ 2021

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha05 משוחרר.

• כולל תיקון למנוע האופטימיזציה (b/182657720)
• מוסיפים פרמטר optimizationLevel לרכיב ה-ConstraintLayout.

גרסה 1.0.0-alpha04

11 במרץ 2021

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha04 משוחרר.

עדכון לשימוש במנוע constraintlayout-core העדכני ביותר

גרסה 1.0.0-alpha03

24 בפברואר 2021

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha03 משוחרר.

עדכון לגרסה beta01 של Jetpack Compose

גרסה 1.0.0-alpha02

10 בפברואר 2021

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha02 משוחרר.

עדכון לגבי גרסת האלפא 12 של Jetpack Compose

גרסה 1.0.0-alpha01

2 בפברואר 2021

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha01 משוחרר.

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

גרסה 2.1

ConstraintLayout 2.1.0 מספק תכונות עשירות יותר ב-MotionLayout וכלים חדשים (קרוסלה וכו')

גרסה 2.1.4

20 במאי 2022

androidx.constraintlayout:constraintlayout:2.1.4 משוחרר.

מידע נוסף זמין במאמר מה חדש בגרסה 2.1.4 ב-GitHub.

גרסה 2.1.3

13 בינואר 2022

androidx.constraintlayout:constraintlayout:2.1.3 משוחרר.

מידע נוסף זמין במאמר ב-GitHub What's New in 2.1.

גרסה 2.1.2

16 בנובמבר 2021

androidx.constraintlayout:constraintlayout:2.1.2 משוחרר.

מידע נוסף זמין במאמר ב-GitHub What's New in 2.1.

גרסה 2.1.1

27 בספטמבר 2021

androidx.constraintlayout:constraintlayout:2.1.1 משוחרר.

זוהי הגרסה האחרונה של 2.1.1.

מידע נוסף זמין במאמר ב-GitHub What's New in 2.1.

גרסה 2.1.0

30 ביולי 2021

androidx.constraintlayout:constraintlayout:2.1.0 משוחרר.

זוהי הגרסה הסופית של 2.1.0.

מידע נוסף זמין במאמר ב-GitHub What's New in 2.1.

גרסה 2.1.0-rc01

22 ביולי 2021

androidx.constraintlayout:constraintlayout:2.1.0-rc01 משוחרר.

זוהי גרסת המועמדת להשקה של 2.1.0, עם שיפורים ותיקונים קלים מהגרסת הבטא האחרונה. מידע נוסף זמין במאמר ב-GitHub What's New in 2.1.

גרסה 2.1.0-beta02

4 במאי 2021

androidx.constraintlayout:constraintlayout:2.1.0-beta02 משוחרר.

כמה תכונות חדשות ב-MotionLayout:

• שיפור OnSwipe שכולל קפיץ (קשיחות, דעיכה, מסה וכו') ואף פעם לא מסתיים
• פונקציית jumpToState
• מצב ViewTransition downUp שבו כשמקישים למטה, האנימציה פועלת עד 100, וכשמקישים למעלה, היא חוזרת ל-0

תיקונים שונים, במיוחד:

• תיקון בעיה ב-MotionLayout עם גלילה אנכית (#173)
• שיפורים בביצועים של MotionLayout בתצוגת עץ (#189)
• מעבר מהיר באמצעות NestedScrollView ב-MotionLayout‏ (#189)
• ConstraintSet לא קיים יותר ב-MotionLayout‏ (#189)
• תמיכה ב-ViewTransitions ב-MotionLayout בכיוון למטה למעלה (#190)
• תיקון ב-ImageFilter כשמשתמשים מחדש ב-drawables‏ (#192)
• הוספת תמיכה בתנועה קפיצית ב-MotionLayout‏ (#199)
• שיפור בביצועים של CircularFlow‏ (#200)
• תיקונים באילוצים נגזרים / שינוי של אילוצים (#212)

גרסה 2.1.0-beta01

11 במרץ 2021

androidx.constraintlayout:constraintlayout:2.1.0-beta01 משוחרר.

ConstraintLayout

עקב בעיות תאימות, הערכים android:layout_width ו-android:layout_height חוזרים להיות חובה.

MotionLayout

• תמיכה פרוגרמטית להוספה ולהסרה של onSwipe ו-onClick במעברים
• תמיכה ניסיונית במעברים באמצעות סיבוב המסך
• תמיכה בארגומנטים של משך זמן למעברים
• תמיכה משופרת ב-customAttributes שהם בוליאניים או הפניות

עזרה

• הוספנו דרך להוסיף אנימציה או לקפוץ ישירות לפריט נתון בקרוסלה
• הכלי החדש של CircularFlow

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

גרסה 2.1.0-alpha2

17 בדצמבר 2020

androidx.constraintlayout:constraintlayout:2.1.0-alpha2 משוחרר.

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

ConstraintLayout

• העמודות android:layout_width ו-android:layout_height הן עכשיו אופציונליות, וההתנהגות שמוגדרת כברירת מחדל היא wrap_content
• מאפיינים חדשים layout_constraintWidth ו-layout_constraintHeight להבעת אילוצים על מאפיינים
• תמיכה בשוליים שליליים באילוצים
• תמיכה באילוצים של קו בסיס לחלק העליון של המסך ושל קו בסיס לחלק התחתון של המסך
• תמיכה במגבלות של שולי הבסיס
• SharedValues מאפשרים להחדיר ערכים חיצוניים ל-ConstraintLayout

MotionLayout

• תמיכה באינטרפולטורים של חריגה מעבר ליעד (anticipate, overshoot)
• תמיכה משופרת ב-MotionHelper
• הוספת עדכון מונפש של ConstraintSet ל-MotionLayout updateStateAnimate(id,cset,duration);
• אירוע ViewTransition מבוסס-ערך משותף
• scheduleTransitonמאפשרת להוסיף מעבר לתור כדי שיופעל בסיום המעבר הנוכחי.

עזרה

• עכשיו יש תמיכה בקרוסלה במצב אינסופי (הצגה חוזרת)
• ReactiveGuide : קו מנחה שמיקום שלו משתנה באופן אוטומטי כשערך של SharedValue משתנה
• MotionEffect : הוספת פריימים מרכזיים לתצוגות שצוינו שזזות בכיוון נתון
• MotionLabel – תצוגה ליצירת אנימציה של טקסט בשורה אחת

מידע נוסף על הגרסה הזו זמין כאן.

גרסה 2.1.0-alpha1

19 בנובמבר 2020

androidx.constraintlayout:constraintlayout:2.1.0-alpha1 משוחרר.

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

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

מידע נוסף על הגרסה הזו זמין כאן.

גרסה 2.0

ב-ConstraintLayout 2.0 נוספו תכונות חדשות לפריסות (פריסות וירטואליות וכו') ושיעור חדש שמפשט את האנימציה של תצוגות, MotionLayout.

גרסה 2.0.4

29 באוקטובר 2020

androidx.constraintlayout:constraintlayout:2.0.4 משוחרר.

תיקוני באגים

במהדורות האלה תוקנה שגיאת NPE שעלולה להתרחש כשמוחקים תצוגת צאצא בזמן ריצה. מומלץ לעדכן לגרסה הזו.

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

גרסה 2.0.3

27 באוקטובר 2020

androidx.constraintlayout:constraintlayout:2.0.3 משוחרר.

תיקוני באגים

בגרסה הזו תוקנו כמה בעיות. מומלץ לעדכן לגרסה הזו.

• טיפול בהוספת חלונות
• טיפול ביחס גובה-רוחב בחלק מהמקרים
• קריסה בפריסות מסוימות מימין לשמאל

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

גרסה 2.0.2

6 באוקטובר 2020

androidx.constraintlayout:constraintlayout:2.0.2 משוחרר.

תיקוני באגים

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

• הטיפול בסטטוס החשיפה GONE של תצוגה ב-ConstraintLayout היה שגוי בחלק מהמקרים
• הטיפול ברשתות ארוכות ב-ConstraintLayout היה שגוי במקרים מסוימים
• תיקון חריגה של אינפלציה ב-API 15 לעזרה בפריסה הווירטואלית של Flow
• הבעיה ב-limitsBoundsTo נפתרה ב-MotionLayout
• האפשרות 'מעבר לסוף' לא פעלה ב-MotionLayout במצבים מסוימים (שרשור מעברים)

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

גרסה 2.0.1

25 באוגוסט 2020

androidx.constraintlayout:constraintlayout:2.0.1 משוחרר.

זהו עדכון קטן שמאפשר להשתמש ב-MotionEditor ב-Android Studio.

גרסה 2.0.0

21 באוגוסט 2020

androidx.constraintlayout:constraintlayout:2.0.0 משוחרר.

תיקוני באגים

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

בין התיקונים הבולטים:

• תיקונים של עיכובים במעברים ב-MotionLayout ושל TransitionListener
• תיקונים לבעיות ב-ConstraintLayout

גרסה 2.0.0-rc1

29 ביולי 2020

androidx.constraintlayout:constraintlayout:2.0.0-rc1 משוחרר.

תיקוני באגים

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

בין התיקונים הבולטים:

• תיקונים ב-Flow
• תיקונים ב-RecyclerView (מומלץ לעדכן ל-recyclerview 1.2.0 alpha 5 ואילך)
• תיקונים ב-MotionLayout TransitionListener
• תיקון דליפת זיכרון ב-MotionLayout

גרסה 2.0.0-beta8

7 ביולי 2020

androidx.constraintlayout:constraintlayout:2.0.0-beta8 משוחרר.

תיקוני באגים

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

בין התיקונים הבולטים:

• התנהגות של placeholder
• הצגה/הסתרה של שכבה
• תיקונים ל-Flow ול-Barrier
• תיקונים ל-TransitionListener

גרסה 2.0.0-beta7

12 ביוני 2020

androidx.constraintlayout:constraintlayout:2.0.0-beta7 משוחרר.

תיקוני באגים

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

בין התיקונים הבולטים:

• בעיות בתצוגת גלילה בתצוגת עץ ב-MotionLayout
• בעיות ב-Transition Listener עם MotionLayout
• דליפת זיכרון ב-MotionLayout
• בעיות ב-RecyclerView
• מצב החשיפה של הקבוצה
• בעיות שקשורות למרווחים

גרסה 2.0.0-beta6

13 במאי 2020

androidx.constraintlayout:constraintlayout:2.0.0-beta6 משוחרר.

תיקוני באגים

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

גרסה 2.0.0-beta5

7 במאי 2020

androidx.constraintlayout:constraintlayout:2.0.0-beta5 משוחרר.

תיקוני באגים

כאן אפשר לראות את רשימת הבעיות שנסגרו

גרסה 2.0.0-beta4

16 בדצמבר 2019

androidx.constraintlayout:constraintlayout:2.0.0-beta4 משוחרר.

תכונות חדשות

MotionLayout

מאפיינים חדשים במעבר:

• layoutDuringTransition : מאפשרת לכם להגדיר איך MotionLayout יגיב לקריאות של requestLayouts של ילדים במהלך מעבר. הערכים האפשריים הם {ignoreRequest, honorRequest}
• pathMotionArc : הנתיב שבו האלמנטים נעים יהיה בצורת קשת. הערכים האפשריים הם {startVertical | startHorizontal | flip | none }

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

תיקוני באגים

כאן אפשר לראות את רשימת הבעיות שנסגרו