Constraintlayout

Constraintlayout

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

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

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

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

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

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

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

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

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

ConstraintLayout-compose ו-ConstraintLayout-Core 1.1

גרסה 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 עם ה-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 ל-Grid Assistant בכתיבה.
  1. ReverseSpanDirection: היפוך של מפרט הרוחב והגובה של קטעי הקוד או הקפיצות.
  2. SpansOrderFirst: הרווח בין הווידג'טים יהיה בהתאם לסדר שלהם. (I6ad50)
• משתמשים ב-Modifier.onStartEndBoundsChanged(...) כדי לקבל גבולות מקומיים של רכיבי Composables ב-MotionLayout שלא מושפעים מאנימציה. שימושי לכל אינטראקציה של ממשק משתמש שדורשת פרטי פריסה שעשויים גם להפעיל אנימציות כמו DragAndDrop. (I6b5f9)
• הפעלת דילוגים ו-spans של Gridassistant בכתיבה (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 חדשים כדי להפעיל את Gridassistant בכתיבה באמצעות DSL (I1143b)

תיקוני באגים

• בוצע תיקון של Wrap.Chain ל-זרימה שלא נפרסה כראוי לפרמטר 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 מכילה את ההוספות האלה.

תכונות חדשות

• אפשר להוסיף ממשקי Apis חדשים כדי להפעיל את Gridassistant ב-Compose באמצעות ייצוג JSON שמאפשר מיקום של תכנים קומפוזביליים ברשת דו-ממדית. (I968ad)

שינויים ב-API

• הוספת תמיכה ב-MotionLayout למצבי arc up ו-arc down ‏Arc.Above ולמצבי arc שאינם תלויים בכיוון ‏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

גרסה

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 מכילה את ההצהרות האלה.

• למידע נוסף על השינויים בגרסה הקודמת, אפשר לעיין בדף ה-wiki של 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 הוא ניסיוני, וצריך להביע הסכמה לכך.

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

גרסה 1.0.0

13 בינואר 2022

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

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

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

גרסה 1.0.0-rc02

16 בנובמבר 2021

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

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

גרסה 1.0.0-rc01

27 בספטמבר 2021

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

זוהי גרסת הבטא השנייה. מדובר בפיצ'ר שהושלמו, והוא מספק ConstraintLayout ו-MotionLayout לכתיבה.

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

גרסה 1.0.0-beta02

30 ביולי 2021

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

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

מידע נוסף זמין במאמר ב-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 What's New in 1.0 (Compose).

גרסה 1.0.0-alpha07

18 במאי 2021

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

• עודכנה להתאמה לגרסה 1.0.0-beta07 של 'כתיבה'.

גרסה 1.0.0-alpha06

4 במאי 2021

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

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

גרסה 1.0.0-alpha05

15 במרץ 2021

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

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

גרסה 1.0.0-alpha04

11 במרץ 2021

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

צריך לעדכן כדי להשתמש במנוע בליבת האילוצים החדשים ביותר

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

עדכון גרסה לגרסת alpha12 של 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 משוחרר.

למידע נוסף, עיינו במאמר מה חדש בגרסה 2.1 של GitHub.

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

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

פריסת תנועה

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

עזרה

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

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

גרסה 2.1.0-alpha2

17 בדצמבר 2020

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

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

פריסת אילוצים

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

MotionLayout

• תמיכה באינטרפולטורים חריגים (צפוי, חריג מדי)
• תמיכה משופרת ב-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 תמיכה עשירה יותר בכיוון (קלט ופלט)
• MotionLayout מוסיף את ViewTransitions, שמאפשר מעבר תצוגה יחיד לצורך מוטציה של קבוצות אילוצים

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

גרסה 2.0

הוספנו תכונות חדשות לפריסות (פריסות וירטואליות וכו') ב-ConstraintLayout2.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 משוחרר.

תיקוני באגים

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

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

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

גרסה 2.0.2

6 באוקטובר 2020

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

תיקוני באגים

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

• הטיפול בסטטוס החשיפה GONE של תצוגה ב-ConstraintLayout היה שגוי במקרים מסוימים
• הטיפול ברשתות ארוכות ב-ConstraintLayout היה שגוי במקרים מסוימים
• תיקון חריגה של ניפוח ב-API 15 לעזרה ביצירת פריסה וירטואלית ב-Flow
• מגבלות BoundsTo היו מנותקות ב-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-בטא4

16 בדצמבר 2019

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

תכונות חדשות

פריסת תנועה

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

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

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

תיקוני באגים

כאן מוצגת רשימת הבעיות הסגורות