نوشتن مطالب ۳ تطبیقی

از کتابخانه تطبیقی ​​Material 3 برای ایجاد رابط‌های کاربری تطبیقی ​​استفاده کنید که به طور خودکار با توجه به پیکربندی‌های فعلی پنجره مانند کلاس‌های اندازه پنجره یا موقعیت‌های دستگاه، خود را تطبیق می‌دهند. این کتابخانه هم پیاده‌سازی‌های پیش‌فرض scaffold و هم کامپوننت‌های بلوک سازنده لازم را برای ایجاد تجربیات سفارشی شما فراهم می‌کند.
آخرین به‌روزرسانی انتشار پایدار کاندیدای انتشار انتشار بتا انتشار آلفا
۸ اکتبر ۲۰۲۵ ۱.۱.۰ ۱.۲.۰-rc01 - ۱.۳.۰-آلفا۰۱

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

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

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

شیار

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

کاتلین

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

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

بازخورد

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

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

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

نوشتن متریال۳ ناوبری تطبیقی۳ نسخه ۱.۰

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

androidx.compose.material3.adaptive:adaptive-navigation3:1.0.0-alpha03 منتشر شد. نسخه 1.0.0-alpha03 شامل این کامیت‌ها است.

تغییرات API

  • استاب‌های KMP را اضافه کنید تا JetBrains بتواند این اهداف را برای فعال کردن CMP فورک و پر کند. ( I75714 )
  • برای فعال کردن قابلیت استفاده چند پلتفرمی، adaptive-navigation3 به commonMain منتقل کنید. ( I58aa9 )

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

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

۲۷ آگوست ۲۰۲۵

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، به راهنمای Navigation3 مراجعه کنید.

نوشتن متریال ۳ نسخه تطبیقی ​​۱.۳

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

۸ اکتبر ۲۰۲۵

androidx.compose.material3.adaptive:adaptive-*:1.3.0-alpha01 منتشر شد. نسخه 1.3.0-alpha01 شامل این کامیت‌ها است.

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

  • ListDetailPaneScaffold و SupportingPaneScaffold اکنون از حاشیه‌ها و لبه به لبه پشتیبانی می‌کنند.
  • کتابخانه یکپارچه‌سازی adaptive-navigation3 از این نسخه (قبلاً 1.0.0-alpha03) به عنوان 1.3.0-alpha01 منتشر می‌شود.

تغییرات API

  • حاشیه صفحه و پشتیبانی لبه به لبه را به ThreePaneScaffold معرفی کنید. ( If0794 ، b/333539848 )

نوشتن متریال ۳ نسخه تطبیقی ​​۱.۲

نسخه ۱.۲.۰-rc01

۸ اکتبر ۲۰۲۵

androidx.compose.material3.adaptive:adaptive-*:1.2.0-rc01 منتشر شد. نسخه 1.2.0-rc01 شامل این کامیت‌ها است.

رفع اشکالات

  • عنوان پیش‌فرض پنجره a11y را روی AnimatedPanes ( 012113 ، b/323387770 ) تنظیم کنید.
  • رفع مشکل لنگر انداختن مجدد نادرست در هنگام نشست ( ca45f9 ، b/442911758 )

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

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

androidx.compose.material3.adaptive:adaptive-*:1.2.0-beta03 منتشر شد. نسخه 1.2.0-beta03 شامل این کامیت‌ها است.

رفع اشکالات

  • رفع مشکل لنگر انداختن مجدد نادرست هنگام کشیدن ( 6453cb6 )

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

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

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() به عنوان تابع داخلی ( Ie7227 ، b/424442112 )

رفع اشکالات

  • استفاده از لنگر اولیه جدید هنگام تغییر لیست لنگرهای گسترش صفحه ( I91cd1 ، b/438829477 )

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

۲۷ آگوست ۲۰۲۵

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 )

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

۱۳ آگوست ۲۰۲۵

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 با محدوده‌های ۰ تا ۱ تغییر می‌دهد. ( Ib2de2 )

رفع اشکالات

  • رفع مشکل عدم رعایت لنگرهای اولیه ( I32f5d ، b/418296559 )

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

۳۰ ژوئیه ۲۰۲۵

androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha10 منتشر شد. نسخه 1.2.0-alpha10 شامل این کامیت‌ها است.

تغییرات API

  • از عرض/ارتفاع ترجیحی که به صورت تناسب نمایش داده می‌شود، پشتیبانی می‌کند. ( I63dda )
  • پارامترهای سازنده‌ی استراتژی‌های Reflow و Levitate را پنهان می‌کند؛ همچنین نام targetPane به reflowUnder تغییر می‌دهد. ( Ifa81b )

رفع اشکالات

  • رفع رگرسیون عملکرد ناشی از ثبت لحظه‌ای پیشرفت انتقال حالت داربست ( I3d555 ، b/417329258 )

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

۱۶ ژوئیه ۲۰۲۵

androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha09 منتشر شد. نسخه 1.2.0-alpha09 شامل این کامیت‌ها است.

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

۲ ژوئیه ۲۰۲۵

androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha08 منتشر شد. نسخه 1.2.0-alpha08 شامل این کامیت‌ها است.

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

۱۸ ژوئن ۲۰۲۵

androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha07 منتشر شد. نسخه 1.2.0-alpha07 شامل این کامیت‌ها است.

تغییرات API

  • تابع currentWindowAdaptiveInfo() را طوری تنظیم کنید که از کلاس‌های اندازه عرض پنجره بزرگ و خیلی بزرگ پشتیبانی کند و توابع calculatePosture() و currentWindowDpSize() را به حالت پایدار ارتقا دهید. ( I92e97 )

نسخه ۱.۲.۰-alpha06

۲۰ مه ۲۰۲۵

androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha06 منتشر شد. نسخه 1.2.0-alpha06 شامل این کامیت‌ها است.

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

  • توابع محاسبه‌ی پیش‌فرضِ دستورالعملِ داربستِ پنجره (pane scaffold) اکنون از کلاس‌های اندازه‌ی عرض پنجره‌ی L و XL پشتیبانی می‌کنند.

تغییرات API

  • کاری کنید که Modifier.paneExpansionDraggable معانی دسترسی پیش‌فرض را ارائه دهد و APIهای مربوطه را به حالت پایدار ارتقا دهد. ( Idb818 )
  • پشتیبانی از کشیدن و تغییر اندازه با پنل‌های معلق ( Idadd3 )
  • آسترهای نگهدارنده برای شیشه‌های معلق ( I9b091 )

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

۷ مه ۲۰۲۵

androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha05 منتشر شد. نسخه 1.2.0-alpha05 شامل این کامیت‌ها است.

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

  • طرح‌بندی‌های تطبیقی ​​Material3 اکنون از استراتژی‌های تطبیقی ​​Levitated پشتیبانی می‌کنند که می‌توانند یک صفحه را به یک پنجره شناور تبدیل کنند.

تغییرات API

  • توابع اندازه پنجره فعلی را طوری تنظیم کنید که از چند پلتفرمی پشتیبانی کنند ( Ie4172 )
  • معرفی حرکات پنجره برای پنجره‌های معلق ( Ic9dc3 )
  • معرفی استراتژی شناوری برای سازگاری ( I1ba7c )

رفع اشکالات

  • رفع مشکل استفاده از دامنه کوروتین در نمونه‌های تطبیقی ​​( 7631016 )

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

۲۳ آوریل ۲۰۲۵

androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha04 منتشر شد. نسخه 1.2.0-alpha04 شامل این کامیت‌ها است.

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

  • استراتژی‌های Reflow اکنون با ListDetailPaneScaffold و SupportingPaneScaffold در دسترس هستند که پنجره مربوطه را تحت یک تنظیم طرح‌بندی تک‌صفحه‌ای reflow می‌کنند.

تغییرات API

  • افزودن نگهدارنده وضعیت قابل ذخیره به PaneScaffoldScope ( شناسه ۹۲۹۹ )
  • معرفی استراتژی جریان مجدد برای سازگاری ( I75c6a )

رفع اشکالات

  • رفع اشکالی که باعث می‌شد پنل‌ها در اولین انتقال متحرک نباشند. ( Ib0415 )
  • رفع مشکل کار نکردن ارتفاع‌های دلخواه ( I1913b )
  • رفع اشکالی که باعث می‌شد دستورالعمل scaffold به درستی به‌روزرسانی نشود. ( 0403ab )

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

۹ آوریل ۲۰۲۵

androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha03 منتشر شد. نسخه 1.2.0-alpha03 شامل این کامیت‌ها است.

رفع اشکالات

  • رفع مشکل نمایش نادرست دسته کشیدن در طرح تک‌صفحه‌ای ( 806e443 )

به‌روزرسانی‌های وابستگی

  • این کتابخانه اکنون سطح زبان Kotlin 2.0 را هدف قرار می‌دهد و به KGP 2.0.0 یا جدیدتر نیاز دارد. ( Idb6b5 )

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

۲۶ مارس ۲۰۲۵

androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha02 منتشر شد. نسخه 1.2.0-alpha02 شامل این کامیت‌ها است.

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

۱۲ مارس ۲۰۲۵

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 )

نوشتن متریال ۳ نسخه تطبیقی ​​۱.۱

نسخه ۱.۱.۰

۱۲ مارس ۲۰۲۵

androidx.compose.material3.adaptive:adaptive-*:1.1.0 منتشر شد. نسخه ۱.۱.۰ شامل این کامیت‌ها است.

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

  • ListDetailPaneScaffold و SupportingPaneScaffold اکنون از ویژگی گسترش صفحه پشتیبانی می‌کنند - کاربران می‌توانند با کشیدن و رها کردن، تقسیم‌بندی پیش‌فرض صفحه در یک طرح‌بندی دوگانه را تغییر دهند، توسعه‌دهندگان همچنین می‌توانند تقسیم‌بندی صفحه را در زمان اجرا از طریق تغییر PaneExpansionState که به تازگی معرفی شده است، تغییر دهند.
  • پشتیبانی پیش‌فرض پیش‌بینی بازگشتی اکنون با NavigableListDetailPaneScaffold و NavigableSupportingPaneScaffold در دسترس است. همچنین می‌توانید از ThreePaneScaffoldPredictiveBackHandler برای ارائه پشتیبانی پیش‌بینی بازگشتی با پیاده‌سازی‌های داربست سه‌صفحه‌ای خود استفاده کنید.
  • اکنون می‌توانید با ارائه EnterTransition و ExitTransition مختلف به AnimatedPane ، حرکات پنجره خود را هنگام تعویض پنجره سفارشی کنید.

نسخه ۱.۱.۰-rc01

۲۶ فوریه ۲۰۲۵

androidx.compose.material3.adaptive:adaptive-*:1.1.0-rc01 منتشر شد. نسخه 1.1.0-rc01 شامل این کامیت‌ها است.

رفع اشکالات

  • مقیاس پشتی پیش‌بینی‌کننده داربست سه‌جداره ( ab6fd0b ) را غیرفعال کنید

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

۱۲ فوریه ۲۰۲۵

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 )

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

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

androidx.compose.material3.adaptive:adaptive-*:1.1.0-beta01 منتشر شد. نسخه 1.1.0-beta01 شامل این کامیت‌ها است.

تغییرات API

  • توابع کارخانه‌ای را برای ایجاد لنگرهای انبساط صفحه از نوع افست به ترتیب از ابتدا و انتها معرفی کنید. ( I2eb21 )
  • رابط PaneMotion را مهر و موم کنید و روش‌های انتقال پیش‌فرض آن را حذف کنید. ( Ifc4c7 )
  • معرفی APIهایی برای دریافت لنگر فعلی و متحرک‌سازی به سمت یک لنگر. ( ICF95d )
  • معرفی APIهای دسترسی برای گسترش پنجره ( Icc669 )
  • نوع PaneScaffoldParentData.preferredWidth را به DP تغییر دهید. ( ID98ee )

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

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

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 )
  • ایجاد مکانیزم overriding برای AnimatedPane جهت پشتیبانی از پیاده‌سازی‌های sideloading برای فرم‌فکتورهای مختلف. ( شناسه 7622 )

رفع اشکالات

  • مشکل را وقتی جهت نشست لنگر ندارد، حل کنید. ( df8257d )

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

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

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 و looping را برای دسترسی به داده‌ها فراهم کنید. ( Id8884 )
  • ایجاد مکانیزم overriding برای ThreePaneScaffold جهت پشتیبانی از پیاده‌سازی‌های sideloading برای فرم‌فاکتورهای مختلف. ( I5280f )
  • حالت بسط پنجره را به طور پیش‌فرض تهی می‌کند ( Ia65f8 , b/376394520 )

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

۱۳ نوامبر ۲۰۲۴

androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha07 منتشر شد. نسخه 1.1.0-alpha07 شامل این کامیت‌ها است.

تغییرات API

  • پیاده‌سازی دستگیره کشیدن (drag handle) را در کتابخانه تطبیقی ​​حذف کنید و افراد را به استفاده از نسخه M3 آن تشویق کنید. و همزمان یک اصلاح‌کننده (modifier) ​​معرفی کنید تا قابلیت کشیدن و گسترش صفحه (pane) را به یک دستگیره کشیدن (drag handle) ارائه شده برای ترکیب‌بندی، فراهم کند. همچنین DraggableState به عنوان جزئیات پیاده‌سازی پنهان کنید تا بتوانیم بعداً در صورت نیاز آن را تغییر دهیم. ( Ib50cd )
  • نقطه ورود سفارشی‌سازی حرکت صفحه را از توابع scaffold به AnimatedPane بر اساس بازخورد UXR منتقل می‌کند. ( I10f72 )
  • پشتیبانی از fling و مشخصات انیمیشن سفارشی برای گسترش صفحه را معرفی کنید. ( Ie207d ، b/362584341 )

رفع اشکالات

  • رفع مشکلات پیش‌بینی بازگشت در هنگام لغو. ( 36a3e0a )، ( b/369899645 )

نسخه ۱.۱.۰-alpha06

۳۰ اکتبر ۲۰۲۴

androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha06 منتشر شد. نسخه 1.1.0-alpha06 شامل این کامیت‌ها است.

تغییرات API

  • FloatRange به PaneScaffoldTransitionScope.motionProgress اضافه کنید. ( Iac0dd )
  • نوع پارامترهای ناوبری را در داربست‌های ناوبری به انواع عمومی تغییر دهید. ( I1da6e )

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

۱۶ اکتبر ۲۰۲۴

androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha05 منتشر شد. نسخه 1.1.0-alpha05 شامل این کامیت‌ها است.

تغییرات API

  • کلاس مشخصات انیمیشن را معرفی کنید تا رفتار حرکتی منسجم‌تر و قابلیت توسعه‌پذیری در آینده تضمین شود. ( I2d3cc )
  • نوع حرکت را مشخص کنید و currentXXXXXX را در PaneMotionData به originXXXX تغییر نام دهید. ( I7c61a )

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

۲ اکتبر ۲۰۲۴

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 برای کنترل انتقال بین مقادیر scaffold اضافه شد. ThreePaneScaffoldState موجود فقط خواندنی شده است. ( Idb3c6 )
  • پیاده‌سازی‌های حرکت پیش‌فرض پنجره را نمایش دهید ( I95a7b )
  • فعال کردن تنظیم لنگر اولیه حالت انبساط صفحه ( Ie41b3 ، b/362350560 )

رفع اشکالات

  • حداقل اندازه هدف لمسی ۴۸x۴۸dp را برای دسته کشیدن اعمال کنید ( 7ce6635 ، b/366018217 )
  • بازیابی موقعیت ثابت پس از تغییرات پیکربندی ( 3c9fc6b ، b/362353672 )

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

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

androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha03 منتشر شد. نسخه 1.1.0-alpha03 شامل این کامیت‌ها است.

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

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

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 )

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

۲۱ آگوست ۲۰۲۴

androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha01 منتشر شد. نسخه 1.1.0-alpha01 شامل این کامیت‌ها است.

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

  • پشتیبانی از گسترش صفحه برای داربست‌های تطبیقی ​​را معرفی کنید.

تغییرات API

  • معرفی APIهای توسعه‌ی پنجره به عموم ( I301d6 )
  • ThreePaneScaffoldState برای کنترل انتقال مقادیر پنجره معرفی شد. overloadهای ListDetailPaneScaffold و SupportingPaneScaffold که این حالت را می‌پذیرند، اضافه شد. ( I5db3b )
  • معرفی کلید گسترش پنجره و رابط ارائه دهنده کلید ( Id621f )

رفع اشکالات

  • رفع خطای محاسبه پارتیشن هنگام نمایش لولای مستثنی ( 9dfd483 )

نوشتن متریال ۳ نسخه تطبیقی ​​۱.۰

نسخه ۱.۰.۰

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

androidx.compose.material3.adaptive:adaptive-*:1.0.0 منتشر شد. نسخه 1.0.0 شامل این کامیت‌ها است.

ویژگی‌های اصلی نسخه ۱.۰.۰

  • توابع تک‌خطی composable به currentWindowSize() ، collectFoldingFeaturesAsState() و currentWindowAdaptiveInfo() برای دریافت اطلاعات مورد نیاز پنجره جهت تطبیق برنامه‌ها، مانند اندازه پنجره‌ها و ویژگی‌های تا شدن.
  • ListDetailPaneScaffold و SupportingPaneScaffold دو طرح‌بندی استاندارد Material3 را ارائه می‌دهند که خود را به طور خودکار با توجه به پیکربندی‌های مختلف پنجره تطبیق می‌دهند. این دو Scaffold همچنین کاملاً قابل تنظیم هستند تا با نیازهای مختلف سازندگان مطابقت داشته باشند.
  • ThreePaneScaffoldNavigator و توابع مربوط به آن، rememberListDetailPaneScaffoldNavigator() و rememberSupportingPaneScaffoldNavigator() به خاطر می‌سپارد تا راه‌حل‌های ناوبری را در یک scaffold تطبیقی ​​ارائه دهد، که می‌تواند چندین مقصد ناوبری را همزمان نشان دهد، در مقایسه با تنظیمات رایج one-destination-at-a-time در دنیای غیر تطبیقی.
  • انیمیشن‌های پیش‌فرض و داخلی Material3 هنگام تغییر حالت‌های داربست تطبیقی.

نسخه ۱.۰.۰-rc01

۲۱ آگوست ۲۰۲۴

androidx.compose.material3.adaptive:adaptive-*:1.0.0-rc01 منتشر شد. نسخه 1.0.0-rc01 شامل این کامیت‌ها است.

رفع اشکالات

  • رفع خطای محاسبه پارتیشن هنگام نمایش لولای مستثنی ( 9dfd483 )

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

۲۶ ژوئن ۲۰۲۴

androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta04 منتشر شد. نسخه 1.0.0-beta04 شامل این کامیت‌ها است.

رفع اشکالات

  • مشکلی که باعث می‌شد وقتی مرزهای لولا به‌روزرسانی می‌شوند، طرح‌بندی (layout) متناسب با آن به‌روزرسانی نشود، برطرف شد. ( 71e9cf1 )

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

۱۲ ژوئن ۲۰۲۴

androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta03 منتشر شد. نسخه 1.0.0-beta03 شامل این کامیت‌ها است.

رفع اشکالات

  • رفع کرش‌های ناشی از تفکیک‌پذیری نادرست وابستگی‌ها در نسخه بتای 02.

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

۲۹ مه ۲۰۲۴

androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta02 منتشر شد. نسخه 1.0.0-beta02 شامل این کامیت‌ها است.

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

۱۴ مه ۲۰۲۴

androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta01 منتشر شد. نسخه 1.0.0-beta01 شامل این کامیت‌ها است.

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

۱ مه ۲۰۲۴

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 به یک کلاس مقداری ( Id8757 )

رفع اشکالات

  • کسر انتقال را به لامبدا تغییر دهید ( I6f5a9 )
  • رفع مشکل وضعیت اولیه SizeTracker ( 18326a9 )
  • فهرست لولا را در بررسی برابری Posture ( 6687137 ) لحاظ کنید

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

۱۷ آوریل ۲۰۲۴

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 )

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

۳ آوریل ۲۰۲۴

androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha10 منتشر شد. نسخه 1.0.0-alpha10 شامل این کامیت‌ها است.

تغییرات API

  • عرض ترجیحی پیش‌فرض را تطبیقی ​​و قابل تنظیم کنید. ( Ic3abc )
  • تغییر نام توابع محاسبه دستورالعمل scaffold. ( I10855 )
  • پدینگ‌ها و اینستنت‌ها را از APIهای scaffold حذف کنید. ( I786f8 )
  • متدهای یادآوری ناوبری را بدون انواع ژنریک اضافه کنید. ( I607c3 )

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

۲۰ مارس ۲۰۲۴

androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha09 منتشر شد. نسخه 1.0.0-alpha09 شامل این کامیت‌ها است.

تغییرات API

  • فیلدهای انتقال حالت را به ThreePaneScaffoldScope اضافه کنید. ( I3d917 )
  • پارامترهای داربست را دوباره مرتب کنید. ( I4dff5 )
  • مقدار پیش‌فرض پارامتر اصلاح‌کننده AnimatedPane را ارائه دهید. ( I77dd7 )

رفع اشکالات

  • اندازه فاصله دهنده را در حرکات صفحه قرار دهید. ( a3174ca )

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

۶ مارس ۲۰۲۴

androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha08 منتشر شد. نسخه 1.0.0-alpha08 شامل این کامیت‌ها است.

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

  • هنگام تعویض پنل‌ها، قابلیت کشویی با تأخیر را پیاده‌سازی کنید. ( I1a38e )

تغییرات API

  • رابط ThreePaneScaffoldState حذف شد. ( I63f23 )

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

۲۱ فوریه ۲۰۲۴