طرح محدودیت

این جدول تمام مصنوعات موجود در گروه androidx.constraintlayout را فهرست می‌کند.

اعلام وابستگی‌ها

برای افزودن وابستگی به ConstraintLayout، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Google's Maven را مطالعه کنید.

وابستگی‌های مربوط به مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

dependencies {
    implementation "androidx.constraintlayout:constraintlayout:2.2.1"
    // To use constraintlayout in compose
    implementation "androidx.constraintlayout:constraintlayout-compose:1.1.1"
}

dependencies {
    implementation("androidx.constraintlayout:constraintlayout:2.2.1")
    // To use constraintlayout in compose
    implementation("androidx.constraintlayout:constraintlayout-compose:1.1.1")
}

برای اطلاعات بیشتر در مورد وابستگی‌ها، به «افزودن وابستگی‌های ساخت» مراجعه کنید.

بازخورد

بازخورد شما به بهبود Jetpack کمک می‌کند. اگر مشکلات جدیدی کشف کردید یا ایده‌هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد یک کتابخانه جدید، نگاهی به مشکلات موجود در این کتابخانه بیندازید. می‌توانید با کلیک بر روی دکمه ستاره، رأی خود را به یک مشکل موجود اضافه کنید.

ایجاد یک مسئله جدید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

ConstraintLayout-compose و ConstraintLayout-Core 1.1

نسخه ۱.۱.۱

۲۶ فوریه ۲۰۲۵

androidx.constraintlayout:constraintlayout-compose:1.1.1 ، androidx.constraintlayout:constraintlayout-compose-android:1.1.1 و androidx.constraintlayout:constraintlayout-core:1.1.1 منتشر شده‌اند. نسخه ۱.۱.۱ شامل این کامیت‌ها است.

رفع اشکالات

• برخی از مشکلات طرح‌بندی که در برخی موارد منجر به عدم قرارگیری طرح‌بندی‌ها می‌شد، مانند تغییر وضعیت نمایش، برطرف شد. ( I34e68 ، b/299134793 )

نسخه ۱.۱.۰

۳۰ اکتبر ۲۰۲۴

androidx.constraintlayout:constraintlayout-compose:1.1.0 ، androidx.constraintlayout:constraintlayout-compose-android:1.1.0 و androidx.constraintlayout:constraintlayout-core:1.1.0 منتشر شده‌اند. نسخه ۱.۱.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۰.۰

• رفع تداخل با SharedTransitionLayout ( b/332898040 ).
• مشکلات طرح‌بندی مربوط به اندازه‌گیری به دلیل ترکیب‌بندی مجدد ( b/219091179 ، Ibfe8a ) برطرف شد.

نسخه ۱.۱.۰-rc01

۱۶ اکتبر ۲۰۲۴

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 منتشر شده‌اند. نسخه ۱.۱.۰-rc01 شامل این کامیت‌ها است.

نسخه ۱.۱.۰-بتا۰۱

۴ سپتامبر ۲۰۲۴

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 شامل این کامیت‌ها است.

نسخه ۱.۱.۰-آلفا۱۴

۷ آگوست ۲۰۲۴

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 غیر تهی نیاز دارد. onIncomingConstraints در InvalidationStrategy اکنون یک لامبدا معمولی است. fixedWidthRate به shouldInvalidateOnFixedWith تغییر نام داده شده است، و همین کار برای نوع Height نیز انجام شده است. ( Ie59cd ، b/332898040 ، b/336370035 )
• منابع NestedScroll Drag و Fling با UserInput و SideEffect جایگزین شده‌اند تا با تعریف گسترده‌تر این منابع که اکنون شامل انیمیشن‌ها (Side Effect) و چرخ ماوس و صفحه‌کلید (UserInput) می‌شود، سازگار باشند. ( I40579 )

نسخه ۱.۱.۰-آلفا۱۳

۴ اکتبر ۲۰۲۳

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 اجازه می‌دهد تا با آخرین نسخه‌های Compose سازگار باشند.

نسخه ۱.۱.۰-آلفا۱۲

۹ آگوست ۲۰۲۳

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 )

نسخه ۱.۱.۰-آلفا۱۱

۲۶ ژوئیه ۲۰۲۳

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 )
• اکنون می‌توانید هنگام استفاده از ConstraintLayout با اصلاح‌کننده درون‌خطی DSL ( Modifier.constrainAs ) animateChanges = true استفاده کنید، هر زمان که تغییری در محدودیت‌های 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 )

نسخه ۱.۱.۰-آلفا۱۰

۲۴ مه ۲۰۲۳

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

• رابط MotionLayout دیگر آزمایشی نیست، این نشان دهنده مجموعه اولیه رابط برنامه‌نویسی پایدار برای MotionLayout است. ( I288f4 )
• MotionLayoutState حذف شد. ( Id3ac1 )
• اکنون می‌توانید DebugFlags برای اشکال‌زدایی بصری استفاده کنید: DebugFlags(showBounds = true) . ( Ic714b )
• متغیر افزونه Dp.asDimension به یک متد تغییر یافت: Dp.asDimension() . ( I2d6ef )
• اکنون Staggered در MotionLayout DSL پشتیبانی می‌شود، حداکثر تأخیر را با TransitionScope.staggered تعریف کنید، همچنین می‌توانید ConstrainScope.staggeredWeight (درون MotionSceneScope ) برای دریافت یک ترتیب Staggered سفارشی استفاده کنید. ( I70275 )
• دو تغییر برای تابع کمکی Grid ایجاد شد: ۱. paddingLeft و paddingRight به ترتیب به paddingStart و paddingEnd ، و ۲. قالب gridSpans و gridSkip را به آرایه‌ای از اشیاء Span و Skip به‌روزرسانی کنید تا ساختارمندتر شود. ( Idd1eb )

نسخه ۱.۱.۰-آلفا۰۹

۲۲ مارس ۲۰۲۳

androidx.constraintlayout:constraintlayout-compose:1.1.0-alpha09 و androidx.constraintlayout:constraintlayout-core:1.1.0-alpha09 منتشر شدند. نسخه 1.1.0-alpha09 شامل این کامیت‌ها است.

تغییرات API

• Modifier.intermediateLayout اکنون به LookaheadScope صریح نیاز ندارد. بلوک اندازه‌گیری در intermediateLayout دارای IntermediateMeasureScope به عنوان گیرنده است که CoroutineScope ، LookaheadScope و MeasureScope را به راحتی فراهم می‌کند.
• LookaheadLayout با LookaheadScope جایگزین شده است که دیگر یک Layout نیست. این امر به محتوای فرزند در LookaheadScope اجازه می‌دهد تا مستقیماً توسط MeasurePolicy والد کنترل شود. ( Ibe2e5 )
• Easing.Cubic() اکنون می‌تواند پارامترهای overshoot را بپذیرد. ( I2d826 )

نسخه ۱.۱.۰-آلفا۰۸

۸ مارس ۲۰۲۳

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 Helper در Compose.
  1. ReverseSpanDirection : مشخصات عرض و ارتفاع را برای spanها/skips معکوس می‌کند.
  2. SpansOrderFirst : فاصله‌ها (spans) به ترتیب ویجت‌ها احترام می‌گذارند. ( I6ad50 )
• از Modifier.onStartEndBoundsChanged(...) برای بدست آوردن مرزهای محلی Composableها در MotionLayout که تحت تأثیر انیمیشن قرار نمی‌گیرند، استفاده کنید. برای هرگونه تعامل رابط کاربری که نیاز به اطلاعات طرح‌بندی دارد که ممکن است انیمیشن‌هایی مانند DragAndDrop را نیز فعال کند، مفید است. ( I6b5f9 )
• فعال کردن پرش‌ها و فواصل Grid Helper در Compose ( I917b6 )

رفع اشکالات

• اصلاح ویژگی‌های ترجمه که مقادیر مورد انتظار را اعمال نمی‌کردند. ( I961cd )

نسخه ۱.۱.۰-آلفا۰۷

۸ فوریه ۲۰۲۳

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 )
• رفع مشکل به‌روزرسانی نشدن ConstraintSet start هنگام تغییر Transition از طریق MotionLayout(motionScene: MotionScene, progress: Float, transitionName: String) . ( 17ffff1 )
• رفع مشکل عدم انعکاس برخی تغییرات ConstraintSet هنگام ارث‌بری از محدودیت‌ها از طریق ConstraintSet(extendConstraintSet: ConstraintSet, description: ConstraintSetScope.() -> Unit) .( 740804b )

نسخه ۱.۱.۰-alpha06

۲۵ ژانویه ۲۰۲۳

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 فعال کنید که امکان قرار دادن composable ها را در یک شبکه دوبعدی فراهم می کند. ( I968ad )

تغییرات API

• پشتیبانی از حالت‌های قوس رو به بالا و قوس رو به پایین، حالت‌های قوس مستقل از جهت Arc.Above و Arc.Below را به MotionLayout اضافه کنید ( 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 هنگام تغییر helperها، همیشه یک recomposition اضافی و غیرضروری ایجاد کند، برطرف شد. ( Id83ad ، b/222093277 )
• رفع مشکل هنگام استفاده از Intrinsics با ConstraintLayout و MotionLayout . ( I487ae ، b/220527863 )
• رفع مشکل عدم امکان اندازه‌گیری مجدد هنگام تغییر محتوا. ( Ibfe8a ، b/219091179 )

نسخه ۱.۱.۰-آلفا۰۵

۷ دسامبر ۲۰۲۲

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 )

نسخه ۱.۱.۰-آلفا۰۱

۲۰ مه ۲۰۲۲

androidx.constraintlayout:constraintlayout-compose:1.1.0-alpha01 منتشر شد.

لطفاً توجه داشته باشید که رابط برنامه‌نویسی کاربردی MotionLayout آزمایشی است و نیاز به ثبت‌نام دارد.

برای اطلاعات بیشتر، به موارد جدید در Compose 1.1.0-alpha01 در GitHub مراجعه کنید.

نسخه ۲.۲

نسخه ۲.۲.۱

۲۶ فوریه ۲۰۲۵

androidx.constraintlayout:constraintlayout:2.2.1 منتشر شد. نسخه 2.2.1 شامل این کامیت‌ها است.

مشارکت خارجی

• مشکل سازگاری دودویی از کتابخانه constraintlayout-core برطرف شد. با تشکر از کارلو ماریناگلی! ( I8952e ، b/376718273 )

نسخه ۲.۲.۰

۳۰ اکتبر ۲۰۲۴

androidx.constraintlayout:constraintlayout:2.2.0 منتشر شد. نسخه 2.2.0 شامل این کامیت‌ها است.

تغییرات مهم از زمان ۲.۱.۰

• انتشار Parity با کتابخانه‌ی constraintlayout-core زیربنایی.

نسخه ۲.۲.۰-rc01

۱۶ اکتبر ۲۰۲۴

androidx.constraintlayout:constraintlayout:2.2.0-rc01 منتشر شد. نسخه 2.2.0-rc01 شامل این کامیت‌ها است.

نسخه ۲.۲.۰-بتا۰۱

۴ سپتامبر ۲۰۲۴

androidx.constraintlayout:constraintlayout:2.2.0-beta01 منتشر شد. نسخه 2.2.0-beta01 شامل این کامیت‌ها است.

نسخه ۲.۲.۰-آلفا۱۴

۷ آگوست ۲۰۲۴

androidx.constraintlayout:constraintlayout:2.2.0-alpha14 منتشر شد. نسخه 2.2.0-alpha14 شامل این کامیت‌ها است.

نسخه ۲.۲.۰-آلفا۱۳

۴ اکتبر ۲۰۲۳

androidx.constraintlayout:constraintlayout:2.2.0-alpha13 بدون هیچ تغییری منتشر شده است. نسخه 2.2.0-alpha13 شامل این کامیت‌ها است.

نسخه ۲.۲.۰-آلفا۱۲

۹ آگوست ۲۰۲۳

androidx.constraintlayout:constraintlayout:2.2.0-alpha12 منتشر شد. نسخه 2.2.0-alpha12 شامل این کامیت‌ها است.

نسخه ۲.۲.۰-آلفا۱۱

۲۶ ژوئیه ۲۰۲۳

androidx.constraintlayout:constraintlayout:2.2.0-alpha11 منتشر شد. نسخه 2.2.0-alpha11 شامل این کامیت‌ها است.

تغییرات API

• یک متد setter اضافه کنید تا توسعه‌دهندگان بتوانند به صورت برنامه‌نویسی مقدار mInfiniteCarousel ( I0a8ca ) را تنظیم کنند.

نسخه ۲.۲.۰-آلفا۱۰

۲۴ مه ۲۰۲۳

androidx.constraintlayout:constraintlayout:2.2.0-alpha10 منتشر شد. نسخه 2.2.0-alpha10 شامل این کامیت‌ها است.

رفع اشکالات

• لینک خراب سند MotionLayout را اصلاح کنید. ( 51cbe88 )

نسخه ۲.۲.۰-آلفا۰۹

۲۲ مارس ۲۰۲۳

androidx.constraintlayout:constraintlayout:2.2.0-alpha09 منتشر شد. نسخه 2.2.0-alpha09 شامل این کامیت‌ها است.

نسخه ۲.۲.۰-آلفا۰۸

۸ مارس ۲۰۲۳

androidx.constraintlayout:constraintlayout:2.2.0-alpha08 منتشر شد. نسخه 2.2.0-alpha08 شامل این کامیت‌ها است.

نسخه ۲.۲.۰-آلفا۰۷

۸ فوریه ۲۰۲۳

androidx.constraintlayout:constraintlayout:2.2.0-alpha07 منتشر شد. نسخه 2.2.0-alpha07 شامل این کامیت‌ها است.

رفع اشکالات

• مشکل از دست رفتن محتوای صفحه ConstraintLayout را برطرف کنید. ( I82e25 )

نسخه ۲.۲.۰-آلفا۰۵

۷ دسامبر ۲۰۲۲

androidx.constraintlayout:constraintlayout:2.2.0-alpha05 منتشر شد. نسخه 2.2.0-alpha05 شامل این کامیت‌ها است.

• برای اطلاعات بیشتر در مورد تغییرات در نسخه قبلی، به صفحه ویکی گیت‌هاب مراجعه کنید.

رفع اشکالات

• رفع نشتی در View Carousel ( eb67b82 )

نسخه ۲.۲.۰-آلفا۰۱

۲۰ مه ۲۰۲۲

androidx.constraintlayout:constraintlayout:2.2.0-alpha01 منتشر شد.

شامل پیش‌نمایشی از ابزار کمکی جدید Grid است.

برای اطلاعات بیشتر، به بخش « جدیدترین‌های نسخه ۲.۲.۰-alpha01» در گیت‌هاب مراجعه کنید.

ConstraintLayout-compose 1.0

ConstraintLayout-compose 1.0 قابلیت‌های ConstraintLayout را در Jetpack Compose ارائه می‌دهد.

نسخه ۱.۰.۱

۲۰ مه ۲۰۲۲

androidx.constraintlayout:constraintlayout-compose:1.0.1 منتشر شد.

لطفاً توجه داشته باشید که رابط برنامه‌نویسی کاربردی MotionLayout آزمایشی است و نیاز به ثبت‌نام دارد.

برای اطلاعات بیشتر، به موارد جدید در Compose 1.0.1 در GitHub مراجعه کنید.

نسخه ۱.۰.۰

۱۳ ژانویه ۲۰۲۲

androidx.constraintlayout:constraintlayout-compose:1.0.0 منتشر شد.

لطفاً توجه داشته باشید که API MotionLayout اکنون آزمایشی است و نیاز به فعال‌سازی دارد.

برای اطلاعات بیشتر، به مقاله GitHub «چه چیزهایی در نسخه ۱.۰ جدید است (Compose)» مراجعه کنید.

نسخه ۱.۰.۰-rc02

۱۶ نوامبر ۲۰۲۱

androidx.constraintlayout:constraintlayout-compose:1.0.0-rc02 منتشر شد.

برای اطلاعات بیشتر، به مقاله GitHub «چه چیزهایی در نسخه ۱.۰ جدید است (Compose)» مراجعه کنید.

نسخه ۱.۰.۰-rc01

۲۷ سپتامبر ۲۰۲۱

androidx.constraintlayout:constraintlayout-compose:1.0.0-rc01 منتشر شد.

این نسخه، دومین نسخه بتا است. از نظر امکانات کامل در نظر گرفته می‌شود و ConstraintLayout و MotionLayout را برای Compose ارائه می‌دهد.

برای اطلاعات بیشتر، به مقاله GitHub «چه چیزهایی در نسخه ۱.۰ جدید است (Compose)» مراجعه کنید.

نسخه ۱.۰.۰-بتا۰۲

۳۰ ژوئیه ۲۰۲۱

androidx.constraintlayout:constraintlayout-compose:1.0.0-beta02 منتشر شد.

این نسخه، دومین نسخه بتا است. از نظر امکانات کامل در نظر گرفته می‌شود و ConstraintLayout و MotionLayout را برای Compose ارائه می‌دهد.

برای اطلاعات بیشتر، به مقاله GitHub «چه چیزهایی در نسخه ۱.۰ جدید است (Compose)» مراجعه کنید.

نسخه ۱.۰.۰-بتا۰۱

۲۲ ژوئیه ۲۰۲۱

androidx.constraintlayout:constraintlayout-compose:1.0.0-beta01 منتشر شد.

این نسخه، اولین نسخه بتا است. از نظر امکانات کامل در نظر گرفته می‌شود و ConstraintLayout و MotionLayout را برای Compose ارائه می‌دهد.

برای اطلاعات بیشتر، به مقاله GitHub «چه چیزهایی در نسخه ۱.۰ جدید است (Compose)» مراجعه کنید.

نسخه ۱.۰.۰-آلفا۰۷

۱۸ مه ۲۰۲۱

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha07 منتشر شد.

• برای سازگاری با Compose نسخه 1.0.0-beta07 به‌روزرسانی شد.

نسخه ۱.۰.۰-alpha06

۴ مه ۲۰۲۱

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha06 منتشر شد.

• بهینه‌سازی نوشتن: Constraintlayout درون‌خطی قابل ترکیب (#193)
• به حداقل رساندن اندازه گیری های مجدد در Compose (#210)

نسخه ۱.۰.۰-آلفا۰۵

۱۵ مارس ۲۰۲۱

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha05 منتشر شد.

• شامل رفع اشکال برای موتور بهینه‌سازی ( b/182657720 )
• یک پارامتر optimizationLevel به ConstraintLayout copmosable اضافه کنید

نسخه ۱.۰.۰-آلفا۰۴

۱۱ مارس ۲۰۲۱

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha04 منتشر شد.

برای استفاده از جدیدترین موتور constraintlayout-core به‌روزرسانی کنید

نسخه ۱.۰.۰-آلفا۰۳

۲۴ فوریه ۲۰۲۱

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha03 منتشر شد.

انتشار به‌روزرسانی برای نسخه بتای ۱ جت‌پک کامپوز

نسخه ۱.۰.۰-آلفا۰۲

۱۰ فوریه ۲۰۲۱

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha02 منتشر شد.

به‌روزرسانی انتشار برای نسخه آلفا۱۲ جت‌پک کامپوز

نسخه ۱.۰.۰-آلفا۰۱

۲ فوریه ۲۰۲۱

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha01 منتشر شد.

اولین انتشار کتابخانه، که DSL های درون خطی و خارجی را برای بیان محدودیت‌ها ارائه می‌دهد.

نسخه ۲.۱

ConstraintLayout 2.1.0 ویژگی‌های غنی‌تری در MotionLayout و helperهای جدید (Carousel و غیره) ارائه می‌دهد.

نسخه ۲.۱.۴

۲۰ مه ۲۰۲۲

androidx.constraintlayout:constraintlayout:2.1.4 منتشر شد.

برای اطلاعات بیشتر، به بخش « جدیدترین‌های نسخه ۲.۱.۴» در گیت‌هاب مراجعه کنید.

نسخه ۲.۱.۳

۱۳ ژانویه ۲۰۲۲

androidx.constraintlayout:constraintlayout:2.1.3 منتشر شد.

برای اطلاعات بیشتر، به مقاله GitHub «چه چیزهایی در نسخه ۲.۱ جدید است» مراجعه کنید.

نسخه ۲.۱.۲

۱۶ نوامبر ۲۰۲۱

androidx.constraintlayout:constraintlayout:2.1.2 منتشر شد.

برای اطلاعات بیشتر، به مقاله GitHub «چه چیزهایی در نسخه ۲.۱ جدید است» مراجعه کنید.

نسخه ۲.۱.۱

۲۷ سپتامبر ۲۰۲۱

androidx.constraintlayout:constraintlayout:2.1.1 منتشر شد.

این آخرین نسخه برای نسخه ۲.۱.۱ است.

برای اطلاعات بیشتر، به مقاله GitHub «چه چیزهایی در نسخه ۲.۱ جدید است» مراجعه کنید.

نسخه ۲.۱.۰

۳۰ ژوئیه ۲۰۲۱

androidx.constraintlayout:constraintlayout:2.1.0 منتشر شد.

این آخرین نسخه برای نسخه ۲.۱.۰ است.

برای اطلاعات بیشتر، به مقاله GitHub «چه چیزهایی در نسخه ۲.۱ جدید است» مراجعه کنید.

نسخه ۲.۱.۰-rc01

۲۲ ژوئیه ۲۰۲۱

androidx.constraintlayout:constraintlayout:2.1.0-rc01 منتشر شد.

این نسخه کاندید انتشار برای نسخه ۲.۱.۰ است که بهبودها و اصلاحات جزئی نسبت به آخرین نسخه بتا ارائه می‌دهد. برای اطلاعات بیشتر، به مقاله GitHub «چه چیزهایی در نسخه ۲.۱ جدید است » مراجعه کنید.

نسخه ۲.۱.۰-بتا۰۲

۴ مه ۲۰۲۱

androidx.constraintlayout:constraintlayout:2.1.0-beta02 منتشر شد.

چند ویژگی جدید در MotionLayout:

• بهبود OnSwipe شامل فنر (سختی، میرایی، جرم و غیره) و هرگز کامل نمی‌شود
• تابع jumpToState
• حالت ViewTransition downUp که با لمس Down، آهنگ به ۱۰۰ و با لمس Up، آهنگ به ۰ تغییر می‌کند.

اصلاحات مختلف، به ویژه:

• رفع مشکل در MotionLayout با اسکرول عمودی (#173)
• بهبودهای عالی در MotionLayout تو در تو (#189)
• انتقال سریع با NestedScrollView در MotionLayout (#189)
• ConstraintSet در MotionLayout حذف شده است (#189)
• پشتیبانی از انتقال‌های نمای پایین به بالا در MotionLayout (#190)
• رفع مشکل در ImageFilter هنگام استفاده مجدد از drawableها (#192)
• اضافه کردن تکیه‌گاه فنر در MotionLayout (#199)
• بهبود عملکرد CircularFlow (شماره ۲۰۰)
• رفع مشکلات در محدودیت‌های مشتق‌شده / لغو محدودیت (#212)

نسخه ۲.۱.۰-بتا۰۱

۱۱ مارس ۲۰۲۱

androidx.constraintlayout:constraintlayout:2.1.0-beta01 منتشر شد.

طرح محدودیت

به دلیل مشکلات سازگاری، android:layout_width و android:layout_height دوباره به حالت غیراختیاری برگشته‌اند.

طرح‌بندی حرکتی

• پشتیبانی برنامه‌نویسی‌شده برای درج و حذف انتقال‌های onSwipe و onClick
• پشتیبانی آزمایشی از انتقال‌ها از طریق چرخش صفحه
• پشتیبانی از آرگومان مدت زمان برای انتقال‌ها
• پشتیبانی بهتر از customAttributes که از نوع بولی یا ارجاعی هستند.

یاری‌رسانان

• راهی برای متحرک‌سازی یا پرش مستقیم به یک آیتم مشخص از Carousel اضافه شد
• یاور جدید CircularFlow

اطلاعات بیشتر در مورد این نسخه و اشکالات بسته شده را اینجا ببینید.

نسخه ۲.۱.۰-آلفا۲

۱۷ دسامبر ۲۰۲۰

androidx.constraintlayout:constraintlayout:2.1.0-alpha2 منتشر شد.

این نسخه آلفای دوم چندین ویژگی جدید اضافه می‌کند:

طرح محدودیت

• android:layout_width و android:layout_height اکنون اختیاری هستند و wrap_content به عنوان رفتار پیش‌فرض در نظر گرفته شده است.
• ویژگی‌های جدید layout_constraintWidth و layout_constraintHeight برای بیان محدودیت‌های ابعاد
• از حاشیه‌های منفی برای محدودیت‌ها پشتیبانی می‌کند
• محدودیت‌های خط پایه تا بالا و خط پایه تا پایین را پشتیبانی می‌کند.
• از محدودیت‌های حاشیه پایه پشتیبانی می‌کند
• SharedValues ​​امکان تزریق مقادیر خارجی به ConstraintLayout را فراهم می‌کند.

طرح‌بندی حرکتی

• پشتیبانی از درون‌یاب‌های overshoot (پیش‌بینی، overshoot)
• پشتیبانی پیشرفته از MotionHelper
• به‌روزرسانی انیمیشنی ConstraintSet را به MotionLayout اضافه کنید updateStateAnimate(id,cset,duration);
• ViewTransition مبتنی بر ارزش مشترک
• scheduleTransitonبه شما این امکان را می‌دهد که یک انتقال را برای اجرا در پایان انتقال فعلی در صف قرار دهید.

یاری‌رسانان

• چرخ فلک اکنون از حالت نامحدود (پیچیدن دور) پشتیبانی می‌کند
• ReactiveGuide: راهنمایی که هنگام تغییر SharedValue به طور خودکار موقعیت خود را تغییر می‌دهد.
• MotionEffect: فریم‌های کلیدی را به نماهای ارجاع‌شده که در جهت مشخصی حرکت می‌کنند، تزریق می‌کند.
• MotionLabel - نمایی برای متحرک‌سازی متن تک‌خطی

اطلاعات تکمیلی در مورد این نسخه را اینجا ببینید.

نسخه ۲.۱.۰-آلفا۱

۱۹ نوامبر ۲۰۲۰

androidx.constraintlayout:constraintlayout:2.1.0-alpha1 منتشر شد.

اولین نسخه آلفا از نسخه ۲.۱. پشتیبانی از موارد زیر را معرفی می‌کند:

• کمک‌کننده‌ی حرکت چرخ‌وفلک، برای ساخت نماهای چرخ‌وفلک سفارشی
• صحنه‌های MotionLayout از include و constraints override پشتیبانی می‌کنند.
• MotionLayout پشتیبانی غنی‌تری برای چرخش (ورودی و خروجی) اضافه می‌کند.
• MotionLayout قابلیت ViewTransitions را اضافه می‌کند که امکان انتقال از یک نما به نمای دیگر برای جهش در مجموعه محدودیت‌ها را فراهم می‌کند.

اطلاعات تکمیلی در مورد این نسخه را اینجا ببینید.

نسخه ۲.۰

ConstraintLayout 2.0 ویژگی‌های جدیدی برای طرح‌بندی‌ها (طرح‌بندی‌های مجازی و غیره) و یک کلاس جدید برای ساده‌سازی انیمیشن نماها، MotionLayout، اضافه می‌کند.

نسخه ۲.۰.۴

۲۹ اکتبر ۲۰۲۰

androidx.constraintlayout:constraintlayout:2.0.4 منتشر شد.

رفع اشکالات

این نسخه، یک NPE بالقوه را که ممکن است هنگام حذف یک نمای فرزند در زمان اجرا رخ دهد، برطرف می‌کند. توصیه می‌شود به این نسخه به‌روزرسانی کنید.

فهرست مسائل بسته‌شده را اینجا ببینید.

نسخه ۲.۰.۳

۲۷ اکتبر ۲۰۲۰

androidx.constraintlayout:constraintlayout:2.0.3 منتشر شد.

رفع اشکالات

این نسخه چند مشکل را برطرف می‌کند. توصیه می‌شود به این نسخه به‌روزرسانی کنید.

• مدیریت درج‌های ویندوز
• مدیریت نسبت ابعاد در برخی موقعیت‌ها
• خرابی با برخی از طرح‌بندی‌های RTL

فهرست مسائل بسته‌شده را اینجا ببینید.

نسخه ۲.۰.۲

۶ اکتبر ۲۰۲۰

androidx.constraintlayout:constraintlayout:2.0.2 منتشر شد.

رفع اشکالات

این نسخه عملکرد را بهبود می‌بخشد و همچنین چند مشکل را برطرف می‌کند. توصیه می‌شود به این نسخه به‌روزرسانی کنید.

• مدیریت view GONE visibility در ConstraintLayout در برخی شرایط نادرست بود.
• مدیریت زنجیره‌های فشرده در ConstraintLayout در برخی شرایط نادرست بود
• رفع مشکل استثنای تورم در API 15 برای کمک‌کننده‌ی طرح‌بندی مجازی Flow
• limitsBoundsTo در MotionLayout خراب بود
• پرش به انتها در MotionLayout در برخی موقعیت‌ها (انتقال زنجیره‌ای) با مشکل مواجه می‌شد.

فهرست مسائل بسته‌شده را اینجا ببینید.

نسخه ۲.۰.۱

۲۵ آگوست ۲۰۲۰

androidx.constraintlayout:constraintlayout:2.0.1 منتشر شد.

این یک به‌روزرسانی جزئی است که امکان استفاده از MotionEditor را در اندروید استودیو فراهم می‌کند.

نسخه ۲.۰.۰

۲۱ آگوست ۲۰۲۰

androidx.constraintlayout:constraintlayout:2.0.0 منتشر شد.

رفع اشکالات

فهرست مسائل بسته‌شده را اینجا ببینید.

اصلاحات قابل توجه عبارتند از:

• رفع تاخیرهای انتقال MotionLayout و TransitionListener
• جریان ConstraintLayout و رفع موانع

نسخه ۲.۰.۰-rc1

۲۹ ژوئیه ۲۰۲۰

androidx.constraintlayout:constraintlayout:2.0.0-rc1 منتشر شد.

رفع اشکالات

فهرست مسائل بسته‌شده را اینجا ببینید.

اصلاحات قابل توجه عبارتند از:

• رفع مشکلات جریان
• رفع مشکلات RecyclerView (توصیه می‌کنیم به recyclerview 1.2.0 alpha 5 یا بالاتر به‌روزرسانی کنید)
• رفع مشکلات مربوط به MotionLayout TransitionListener
• رفع نشت حافظه MotionLayout

نسخه ۲.۰.۰-بتا۸

۷ ژوئیه ۲۰۲۰

androidx.constraintlayout:constraintlayout:2.0.0-beta8 منتشر شد.

رفع اشکالات

فهرست مسائل بسته‌شده را اینجا ببینید.

اصلاحات قابل توجه عبارتند از:

• رفتار نگهدارنده مکان
• قابلیت مشاهده لایه
• جریان، رفع موانع
• رفع مشکلات TransitionListener

نسخه ۲.۰.۰-بتا۷

۱۲ ژوئن ۲۰۲۰

androidx.constraintlayout:constraintlayout:2.0.0-beta7 منتشر شد.

رفع اشکالات

فهرست مسائل بسته‌شده را اینجا ببینید.

اصلاحات قابل توجه عبارتند از:

• مشکلات نمای اسکرول تو در تو در MotionLayout
• مشکلات شنونده‌ی انتقال با MotionLayout
• نشت حافظه در MotionLayout
• مشکلات RecyclerView
• قابلیت مشاهده گروه
• مشکلات مربوط به لایه گذاری

نسخه ۲.۰.۰-بتا۶

۱۳ مه ۲۰۲۰

androidx.constraintlayout:constraintlayout:2.0.0-beta6 منتشر شد.

رفع اشکالات

فهرست مشکلات بسته‌شده را اینجا ببینید. رفع مشکلات قابل توجه، مشکلات مربوط به مدیریت قابلیت مشاهده گروه و محدودیت‌های مشتق‌شده در MotionLayout هستند.

نسخه ۲.۰.۰-بتا۵

۷ مه ۲۰۲۰

androidx.constraintlayout:constraintlayout:2.0.0-beta5 منتشر شد.

رفع اشکالات

فهرست مسائل بسته‌شده را اینجا ببینید

نسخه ۲.۰.۰-بتا۴

۱۶ دسامبر ۲۰۱۹

androidx.constraintlayout:constraintlayout:2.0.0-beta4 منتشر شد.

ویژگی‌های جدید

طرح‌بندی حرکتی

ویژگی‌های جدید در گذار:

• layoutDuringTransition: به شما امکان می‌دهد نحوه واکنش MotionLayout به فراخوانی‌های requestLayouts فرزند در طول یک گذار را پیکربندی کنید. مقادیر ممکن عبارتند از {ignoreRequest, honorRequest}
• pathMotionArc: مسیری که توسط عناصر در حال حرکت طی می‌شود از یک قوس استفاده می‌کند. مقادیر ممکن عبارتند از {startVertical | startHorizontal | flip | none }

اکنون می‌توان یک گذار پیش‌فرض تعریف کرد، به سادگی با حذف ConstraintSetهای شروع و پایان. اگر هیچ گذار موجود دیگری برای مطابقت با حالت‌های شروع/پایان فعلی پیدا نشود، از آن گذار پیش‌فرض استفاده خواهد شد.

رفع اشکالات

فهرست مسائل بسته‌شده را اینجا ببینید