این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Wear Compose Material 3

مرجع API
androidx.wear.compose.material3

برنامه‌های Jetpack Compose را برای دستگاه‌های Wear OS با ارائه قابلیت‌هایی برای پشتیبانی از اندازه‌های مختلف دستگاه و حرکات ناوبری با استفاده از سیستم طراحی Material 3 Expressive بنویسید.

آخرین به روز رسانی	انتشار پایدار	کاندید را آزاد کنید	نسخه بتا	انتشار آلفا
27 آگوست 2025	1.5.0	-	-	-

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

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

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

شیار

dependencies {
    implementation "androidx.wear.compose:compose-foundation:1.5.0"

    // For Wear Material Design UX guidelines and specifications
    implementation "androidx.wear.compose:compose-material3:1.5.0"

    // For integration between Wear Compose and Androidx Navigation libraries
    implementation "androidx.wear.compose:compose-navigation:1.5.0"

    // For Wear preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.5.0")
    
    // NOTE: DO NOT INCLUDE dependencies on androidx.wear.compose:compose-material
    // or androidx.compose.material:material.
    // androidx.wear.compose:compose-material3 is designed as a replacement,
    // not an addition, to both of these other libraries.
    // If there are features from that you feel are missing from
    // androidx.wear.compose:compose-material3, please raise a bug to let us know.
}

کاتلین

dependencies {
    implementation("androidx.wear.compose:compose-foundation:1.5.0")

    // For Wear Material Design UX guidelines and specifications
    implementation("androidx.wear.compose:compose-material3:1.5.0")

    // For integration between Wear Compose and Androidx Navigation libraries
    implementation("androidx.wear.compose:compose-navigation:1.5.0")
    
    // For Wear preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.5.0")

    // NOTE: DO NOT INCLUDE dependencies on androidx.wear.compose:compose-material
    // or androidx.compose.material:material.
    // androidx.wear.compose:compose-material3 is designed as a replacement,
    // not an addition, to both of these other libraries.
    // If there are features from that you feel are missing from
    // androidx.wear.compose:compose-material3, please raise a bug to let us know.
}

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

بازخورد

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

یک شماره جدید ایجاد کنید

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

Wear Compose Material3 نسخه 1.5

نسخه 1.5.0

27 آگوست 2025

androidx.wear.compose:compose-*:1.5.0 منتشر شد. نسخه 1.5.0 شامل این commit ها است.

تغییرات مهم از 1.4.0

اولین نسخه از کتابخانه Wear Compose Material 3 که از سیستم طراحی جدید Material 3 Expressive پشتیبانی می کند. این نسخه شامل:

MaterialTheme به روز شده و تم رنگی پویا.
اجزای AppScaffold, ScreenScaffold ، HorizontalPagerScaffold ، و VerticalPagerScaffold برای چیدمان ساختار صفحه و هماهنگ کردن انیمیشن‌های ScrollIndicator ، TimeText ، HorizontalPageIndicator و VerticalPageIndicator .
شکل‌بندی IconButton ، TextButton ، IconToggleButton ، و TextToggleButton ، با تغییراتی که با فشار دادن یا علامت زدن، متحرک می‌شوند.
EdgeButton که شکل خاصی برای پایین صفحه طراحی شده است.
ButtonGroup یک گروه گویا از دکمه‌ها را در یک ردیف پیاده‌سازی می‌کند که با لمس کردن شکل می‌دهند.
AlertDialog و ConfirmationDialog با تغییراتی برای محتوای گفتگوی اضافی.
اجزای TimePicker و DatePicker .
شاخص‌های پیشرفت عبارتند از CircularProgressIndicator (با تغییرات تقسیم‌بندی شده)، ArcProgressIndicator و LinearProgressIndicator .

علاوه بر این، Wear Compose Foundation 1.5.0 شامل موارد زیر است:

TransformingLazyColumn ، فهرستی تنبل و با پیمایش عمودی که از مقیاس‌بندی و شکل‌گیری انیمیشن‌ها پشتیبانی می‌کند.
پشتیبانی از صفحه‌بندی در Wear Compose Foundation با HorizontalPager و VerticalPager .
گروه های کانونی سلسله مراتبی - برای حاشیه نویسی اجزای ترکیبی در یک برنامه کاربردی برای پیگیری بخش فعال ترکیب و هماهنگ کردن فوکوس استفاده می شود.

درباره ( Material 3 Expressive for Wear OS ) بیشتر بخوانید

نسخه 1.5.0-rc02

13 آگوست 2025

androidx.wear.compose:compose-*:1.5.0-rc02 منتشر شد. نسخه 1.5.0-rc02 حاوی این commit ها است.

رفع اشکال

یک اشکال در TimePicker که در آن رشته‌های طولانی و بین‌المللی برای دوره (AM/PM) می‌توانند طرح‌بندی را بشکنند، رفع شد. ( I0fa81 )

نسخه 1.5.0-rc01

30 جولای 2025

androidx.wear.compose:compose-*:1.5.0-rc01 منتشر شد. نسخه 1.5.0-rc01 حاوی این commit ها است.

رفع اشکال

TimePicker اکنون به طور کامل توسط محلی کاربر هدایت می شود و از DateFormat.getBestDateTimePattern برای تعیین ترتیب و محتوای انتخاب کننده ها و جداکننده های آن استفاده می کند. این ترتیب نادرست ستون‌ها را برای زبان‌های CJK برطرف می‌کند، مشکلات طرح‌بندی RTL را در زبان‌هایی مانند عربی حل می‌کند، از جداکننده‌های محلی‌سازی شده استفاده می‌کند، و از هر دو فرمت 0-11 و 1-12 ساعت بر اساس محلی پشتیبانی می‌کند ( I5d543 )
DatePicker اکنون یک ماه عددی را در برخی از مناطق، مانند CJK، نمایش می‌دهد تا از اختلاط قالب‌های عددی و زبانی جلوگیری کند (به عنوان مثال، 2025 | 07 | 02 به جای 2025 | 7月 | 02). این تغییر یک اکتشافی را اعمال می‌کند که بررسی می‌کند آیا منطقه از پسوندهای زبانی برای سال استفاده می‌کند یا خیر، و اگر چنین است، قالب ماه را از متنی (MMM) به عددی (MM) برای سازگاری تغییر می‌دهد. ( Ia93fe )
فضای عمودی برای عنوان در مؤلفه Picker اکنون ثابت است و از تغییر قابل مشاهده در هنگام انتخاب یک ستون انتخابگر، به ویژه در حالت Talkback جلوگیری می کند. ( I7f8b7 )
رفع اشکال دسترسی ناشی از ترسیم تمام صفحه HorizontalPageIndicator و VerticalPageIndicator . نشانگرهای صفحه دیگر تمام صفحه نیستند و در صورت استفاده با HorizontalPagerScaffold یا VerticalPagerScaffold به صورت خودکار قرار می گیرند. هنگامی که از داربست پیجر استفاده نمی کنید، تراز را به صراحت با استفاده از modifier = Modifier.align(Alignment.BottomCenter) با HorizontalPageIndicator و modifier =Modifier.align(Alignment.CenterEnd) با VerticalPageIndicator مشخص کنید. ( I3a0ad )
جهت کش رفتن در SwipeToReveal اکنون برای LTR و RTL LayoutDirections سازگار است. ( I6d427 )
مرکز عمودی SwipeToReveal برای اقدامات بازیابی کرد. اگر hasPartiallyRevealedState = true ، RevealState باید به RevealValue.Covered بازنشانی شود. هنگامی که پیمایش رخ می دهد توسط تماس گیرنده پوشش داده می شود. ( I6473d )
SwipeDismissableNavHost اکنون محتوا را برای API 36 به بعد به درستی کلیپ می کند. ( Ib9a44 )

نسخه 1.5.0-beta06

16 جولای 2025

androidx.wear.compose:compose-*:1.5.0-beta06 منتشر شد. نسخه 1.5.0-beta06 حاوی این تعهدات است.

رفع اشکال

هنگامی که LazyColumn یا ScalingLazyColumn دارای reverseLayout = true هستند، انیمیشن EdgeButton برطرف کنید. ( I46a1a )
رفع اشکالی در ScreenScaffold که در آن در صورت ارائه ScrollIndicator/PageIndicator لمس برای کاوش در Talkback کار نمی کرد. ( I6dcee )
TransformingLazyColumn اکنون با خواندن مقدار itemHeight ارائه شده توسط TransformationSpec در پس‌زمینه، امکان شکل‌گیری سفارشی از TransformationSpec را می‌دهد. ( I6a599 )
انتقال رنگ فعال/غیرفعال متحرک برای IconButton ، برای سازگاری با IconToggleButton . ( Ife10a )
برای جلوگیری از پرش محسوس به حداقل اندازه نقطه در هنگام متحرک سازی، حداقل گیره بخش را در CircularProgressIndicator حذف کرد. به عنوان بخشی از این تغییر، پارامتر targetProgress در drawCircularProgressIndicator اکنون استفاده نشده است. ( I33309 )
Picker اکنون نقش معنایی ValuePicker را دارد که می‌تواند توسط صفحه‌خوان‌ها برای دسترسی بیشتر انتخاب‌کننده‌ها استفاده شود. Picker همچنین دارای برچسب‌های کلیک دسترسی به روز شده است که بین تنظیم مقدار در حالت فقط خواندنی و انتخاب مقدار فعلی در غیر این صورت تفاوت قائل می‌شود. ( I33309 )

نسخه 1.5.0-beta05

2 ژوئیه 2025

androidx.wear.compose:compose-*:1.5.0-beta05 منتشر شد. نسخه 1.5.0-beta05 حاوی این تعهدات است.

رفع اشکال

برای روشن شدن استفاده از Modifier.edgeSwipeToDismiss ( I78cb5 ) اسناد را به روز کرد.
اشکال رفع شد که در آن چندین مورد فاش شده می‌توانست با SwipeToReveal در لیست‌های تنبل نشان داده شود ( I1d4f6 )
اشکال کانتینر در TransformingLazyColumn اکنون به منظور جلوگیری از برش محتویات، مقیاس بندی شده اند. ( I9221a )
برچسب TimePicker و DatePicker برای ساعت/دقیقه/ثانیه یا سال/ماه/روز اکنون دارای معانی سرفصل برای صفحه‌خوان‌ها است ( I77d8b )
مکث بین حلقه‌ها در CircularProgressIndicator نامشخص ( Iaf0bb ) حذف شد
رفع اشکال انیمیشن در TransformingLazyColumn هنگام حذف موارد. ( I73034 )
هنگام حذف موارد، مدیریت موارد لنگر در TransformingLazyColumn اصلاح شد. ( I841a8 )
PickerGroup اکنون هنگامی که مرکز خودکار روشن است و انتخابگر انتخاب شده (مرکز) تغییر می کند، Pickers را به صورت افقی متحرک می کند. ( IC82c4 )

نسخه 1.5.0-beta04

18 ژوئن 2025

androidx.wear.compose:compose-*:1.5.0-beta04 منتشر شد. نسخه 1.5.0-beta04 حاوی این تعهدات است.

رفع اشکال

رفع اشکال طرح‌بندی در TransformingLazyColumn ، جایی که محتوایی که درون صفحه قرار می‌گیرد اکنون به درستی از بالای صفحه تراز شده است ( I80115 )
مشکلی در TransformingLazyColumn که در آن آیتم پایینی هنگام پیمایش به انتهای لیست با EdgeButton به اشتباه مقیاس بندی شده بود، برطرف شد. اکنون هنگام بازیابی طرح‌بندی، پیشرفت پیمایش از شیب نزولی پیروی می‌کند. ( Iea375 )
TransformingLazyColumn اکنون ارتفاع آیتم را در پس‌زمینه نقاش می‌خواند، که به TransformationSpecs سفارشی اجازه می‌دهد تا شکل‌بندی را پیاده‌سازی کند. ( I022f0 )
SwipeToReveal اکنون به صورت عمودی اقدامات آشکار شده را به درستی در مرکز قرار می دهد. ( I4419b )
اشکالی در SwipeToReveal رفع شد که مانع از کارکرد صحیح آن با کشیدن انگشت برای رد کردن در صورت استفاده از نمایش و نوشتن بر روی صفحه نمایش می‌شد. ( I5dc0e )
رفع اشکالی که در آن اقدامات SwipeToReveal با افست عمودی هنگام پیمایش ترسیم می‌شدند. ( I29444 )
AlertDialog ، ConfirmationDialog ، OpenOnPhoneDialog و SwipeToReveal اکنون بالشتک‌ها و اندازه‌هایی را جمع می‌کنند که به صورت درصدی از اندازه صفحه محاسبه می‌شوند. ( I76367 )
ButtonDefaults.outlinedButtonBorder اکنون پس از تغییر اندازه حالت فعال/غیرفعال به روز می شود ( If2ddd )
رفع اشکال در ارتفاع EdgeButton که در صفحه‌های پیچیده با پیجر و ScreenScaffold رخ می‌داد. ( I946e3 )
یک وضعیت مسابقه که می‌تواند باعث توقف انیمیشن‌های Placeholder شود، رفع شد. ( I53530 )
بهبود عملکرد HorizontalPageIndicator و VerticalPageIndicator با کشیدن روی بوم. ( Ifae1e )
شکل EdgeButton را برای صاف کردن انتقال بین بیضی و دایره‌هایی که طرح کلی را تشکیل می‌دهند، اصلاح کرد. ( I7721e )
یک اشکال در LevelIndicator که باعث توقف انیمیشن‌ها به دلیل ترکیب‌بندی‌های غیرضروری می‌شد، برطرف شد. ( I45d08 )

نسخه 1.5.0-beta03

4 ژوئن 2025

androidx.wear.compose:compose-*:1.5.0-beta03 منتشر شد. نسخه 1.5.0-beta03 حاوی این تعهدات است.

تغییرات API

OpenOnPhoneDialog اکنون فقط متن پیام را در زیر TalkBack اعلام می‌کند و معنای نمادها را نادیده می‌گیرد. OpenOnPhoneDialogDefaults برای حذف iconContentDescription و پارامتر contentDescription از icon() به روز شده است. همچنین ConfirmationDialogDefaults اکنون دارای پارامترهای اصلاح کننده در SuccessIcon و FailureIcon composable است. ( ID2ae2 )

رفع اشکال

ترتیب اعمال تأثیر پارامترهای SurfaceTransformation را تغییر داد. پیش از این، تبدیل‌های اعمال شده به اجزای Wear Material3 به شرح زیر انجام می‌شد: نقاش پس‌زمینه، تبدیل ظرف، تبدیل محتوا. اکنون 2 مورد اول معکوس شده‌اند و هر اصلاح‌کننده‌ای را بین آنها اعمال می‌کنیم، بنابراین تحت تأثیر تبدیل‌های ظرف قرار می‌گیرد. این موارد مواردی مانند استفاده از جلوه درخشش نگهدارنده مکان با عناصر موجود در TLC با استفاده از پارامتر تبدیل را برطرف می کند. ( I786cf )
RevealState.Saver اضافه شد تا برای بازیابی وضعیت SwipeToReveal هنگام ایجاد فعالیت یا فرآیند دوباره استفاده شود. تابع rememberRevealState اکنون از این Saver به طور پیش فرض استفاده می کند. ( Ie0ecb )
دکمه‌های اقدامات اولیه و ثانویه SwipeToReveal باید به‌طور پیش‌فرض روی ButtonDefault.Height باشند (اشکال رفع شده در جایی که این دکمه‌ها حداکثر ارتفاع را برای دکمه‌های بلندتر پر می‌کردند). ( Ibfba1 )
SwipeToReveal برای بازنشانی آخرین مؤلفه ای که با آن تعامل داشتید، زمانی که حرکت حرکت تند کشیدن به سمت راست انجام شد، تغییر داد. ( Ia8450 )
SwipeToReveal به حالت Revealing تغییر کرد که موقعیت انتهایی کشیدن انگشت بین لنگرهای آشکار و آشکار و نزدیک‌تر به لنگر آشکار شود. ( If4458 )
اکنون محتوای ButtonGroup به درستی در یک طرح RTL معکوس شده است ( Ib378d )
AnimatedText اکنون جهت متن RTL را پشتیبانی می کند ( I4533c )
TransformingLazyColumn اکنون هنگامی که مورد پایینی حذف می شود، اندازه موارد را به درستی تغییر می دهد ( Idacab )
TransformingLazyColumn اکنون فقط یک پاس اندازه گیری می کند که با کاهش زمان فریم عملکرد را بهبود می بخشد. ( I501a1 )

نسخه 1.5.0-beta02

20 مه 2025

androidx.wear.compose:compose-*:1.5.0-beta02 منتشر شد. نسخه 1.5.0-beta02 حاوی این تعهدات است.

رفع اشکال

نمایه های پایه به روز شده برای کتابخانه های بنیاد، مواد و مواد3. ( I53f06 )
یک اشکال در TransformingLazyColumn رفع شد، که در آن اندازه موارد با حذف آیتم پایینی تغییر کرد. ( ایداکاب )
هنگامی که لیست در بالا یا پایین لیست گیر کرده بود، یک اشکال با TransformingLazyColumn برطرف شد. ( I49d00 )
OpenOnPhoneDialog در زیر TalkBack باید متن منحنی را به جای توضیح محتوای نماد اعلام کند. ( I4efe8 )
اشکالی در SwipeToReveal برطرف شد که در RevealState.currentValue ، لنگر اشتباه را گزارش می‌کرد، وقتی hasPartiallyRevealedState روی false تنظیم شود. ( I9c7cf )
دکمه‌های لغو SwipeToReveal اکنون به صورت پیش‌فرض ButtonDefaults.Height هستند. ( I1f6c8 )
عملکرد BasicSwipeToDismissBox با حذف استفاده از Canvas برای ترسیم اسکریم بهبود یافته است. ( I68f2c )
رفع اشکال دسترسی در اسلایدر، که در آن درصد اعلام شده با مقدار پس از به‌روزرسانی مطابقت نداشت ( I91146 )
رفع اشکال در اجرای placeholderShimmer . ( Iee39b
عملکرد TransformingLazyColumn با بهینه سازی محاسبه ScrollProgress تا 30% بهبود یافته است. ( I4c4cb )

نسخه 1.5.0-beta01

7 مه 2025

androidx.wear.compose:compose-*:1.5.0-beta01 منتشر شد. نسخه 1.5.0-beta01 حاوی این تعهدات است.

نسخه 1.5.0-beta01 Compose for Wear OS نشان می دهد که این نسخه از کتابخانه کامل شده است و API قفل شده است (به جز مواردی که به عنوان آزمایشی علامت گذاری شده است).

Wear Compose 1.5.0-beta01 شامل کتابخانه Wear Compose Material3 است که از سیستم طراحی رابط کاربری جدید به نام Material 3 Expressive پشتیبانی می کند. برای استفاده از طراحی بصری جدید در برنامه ها و بهره مندی از اجزای جدید به شرح زیر توصیه می شود از Material به Material3 ارتقا دهید:

MaterialTheme برای طرح‌های رنگی، تایپوگرافی و اشکال به‌روز و توسعه‌یافته برای ایجاد عمق و تنوع به طرح‌های شما.
طرح زمینه رنگی پویا که به طور خودکار یک طرح رنگی برای برنامه شما ایجاد می کند تا با رنگ های صفحه ساعت مطابقت داشته باشد.
اجزای جدید به طور خودکار با اندازه های صفحه نمایش بزرگتر به طور پیش فرض سازگار می شوند
شکل‌گیری شکل - اجزای دکمه‌های گرد مانند IconButton ، TextButton ، IconToggleButton و TextToggleButton از تغییراتی پشتیبانی می‌کنند که با فشار دادن یا علامت زدن، متحرک می‌شوند.
EdgeButton - یک دکمه جدید در آغوش گرفتن لبه با شکل خاصی که برای پایین صفحه طراحی شده است.
Scaffolds - معرفی AppScaffold و ScreenScaffold برای چیدمان ساختار صفحه و هماهنگ کردن انیمیشن های ScrollIndicator و TimeText .
دکمه ها - دکمه های متعددی به شکل استادیوم با ظروف منعطف تک شکافی و تغییرات چند شیار برای دکمه های دارای نمادها و برچسب ها پشتیبانی می شوند. CheckboxButton و SwitchButton در صورت نیاز به دکمه‌های جابه‌جایی ارائه می‌شوند، در حالی که RadioButton دکمه انتخاب در دسترس است (تغییرهای 'Split' دکمه‌های تغییر و انتخاب نیز ارائه شده است).
ButtonGroup - یک گروه گویا از دکمه‌ها را در یک ردیف پیاده‌سازی می‌کند که با لمس کردن شکل می‌دهند.
تغییرات AlertDialog از دکمه‌های ok/cancel یا EdgeButton پشتیبانی می‌کنند.
ConfirmationDialog برای نمایش پیامی با مهلت زمانی در دسترس است و از انیمیشن های ویژه برای موفقیت، شکست و تغییرات باز روی تلفن پشتیبانی می کند.
Pickers - تغییرات TimePicker و DatePicker و همچنین مؤلفه‌های Picker و PickerGroup برای ساخت صفحه‌نمایش انتخاب‌کننده خود پشتیبانی می‌شوند.
ProgressIndicators - شاخص‌های پیشرفت دایره‌ای و خطی پشتیبانی می‌شوند ( CircularProgressIndicator دارای تغییرات تقسیم‌بندی شده و نامشخص است).
کارت - تعدادی از انواع کارت موجود است، از جمله TitleCard که طرح‌بندی‌های خاصی را برای کارت‌ها با عنوان، زمان، زیرنویس یا اسلات محتوا ارائه می‌دهد. TitleCard همچنین می‌تواند یک پس‌زمینه تصویر برای تقویت معنای اطلاعات موجود در کارت داده شود.
پیجرها - اجزای HorizontalPagerScaffold ، VerticalPagerScaffold و AnimatedPage انیمیشن های HorizontalPageIndicator و VerticalPagerIndicator را هماهنگ می کنند. HorizontalPager و VerticalPager در کتابخانه Wear Compose Foundation منتشر شده اند.
Placeholders - یک شکل اسکلت روی یک جزء ترسیم می کند، برای موقعیت هایی که هیچ محتوای موقتی در دسترس نیست.
لغزنده ها و پله ها - هر دو لغزنده و استپر به کاربران اجازه می دهند از طیف وسیعی از مقادیر انتخاب کنند. لغزنده‌ها فشرده‌تر هستند و می‌توانند بخش‌بندی شوند، در حالی که Stepper یک جزء تمام صفحه است که معمولاً با StepperLevelIndicator جفت می‌شود.
SwipeToReveal - برای افزودن اقدامات اضافی به یک composable زمانی که از راست به چپ کشیده می شود استفاده می شود.

علاوه بر این، Wear Compose Foundation 1.5.0-beta01 شامل این اجزای جدید است:

TransformingLazyColumn - فهرستی تنبل و با پیمایش عمودی که از مقیاس‌بندی و شکل‌گیری انیمیشن‌ها پشتیبانی می‌کند.
گروه های کانونی سلسله مراتبی - برای حاشیه نویسی اجزای ترکیبی در یک برنامه کاربردی، برای پیگیری بخش فعال ترکیب و هماهنگ کردن فوکوس استفاده می شود.
پیجرها - اجزای HorizontalPager و VerticalPager که بر اساس اجزای Compose Foundation با پیشرفت‌های مخصوص Wear برای بهبود عملکرد و پیروی از دستورالعمل‌های Wear OS ساخته شده‌اند.

تغییرات API

API Hierarchical Focus را به روز کرد - Modifier.hierarchicalFocus به Modifier.hierarchicalFocusGroup تغییر نام داد و پارامتر callback را حذف کرد. اضافه بار Modifier.hierarchicalFocusRequester را با پارامتر FocusRequester حذف کرد. یک CompositionLocal جدید، LocalScreenIsActive ایجاد کرد تا کامپوننت ها بتوانند اطلاع دهند و بررسی کنند که کدام صفحه نمایش فعال است. ( I5ff7c ).
SwipeToReveal از بنیاد Wear Compose به نفع APIهای SwipeToReveal در Wear Compose Material و Wear Compose Material3 منسوخ شد. لطفاً برای ادامه استفاده از APIها، واردات Wear Foundation SwipeToReveal را با Wear Compose Material/ Wear Compose Material3 وارد کنید. ( Ia147d ).
وابستگی‌های Wear Compose Material3 SwipeToReveal به Foundation به بسته material3 منتقل شدند، به عنوان مثال RevealValue ، RevealDirection ، RevealActionType ، RevealState ، rememberRevealState . توسعه دهندگان باید واردات خود از این کلاس ها و توابع را از androidx.wear.compose.foundation به androidx.wear.compose.material3 تغییر دهند. ( I640e6 ).
Wear Compose Material3 SwipeToReveal API را به شرح زیر به‌روزرسانی کرد: پارامترهای primaryAction ، onFullSwipe ، secondaryAction ، undoPrimaryAction ، undoSecondaryAction و hasPartiallyRevealedState را به SwipeToReveal composable اضافه کرد. قابلیت شخصی سازی positionalThreshold و animationSpec از RevealState حذف کرد. lastActionType , revealThreshold و width از RevealState حذف شد . سازنده RevealState را تغییر داد تا RevealDirection به جای لنگرها بپذیرد. توابع createRevealAnchors ، لنگرها و bidirectionalAnchors را حذف کرد. توابع SwipeToRevealScope primaryAction ، secondaryAction ، undoPrimaryAction و undoSecondaryAction به PrimaryActionButton ، SecondaryActionButton ، UndoActionButton تغییر نام داده و به توابع Composable تبدیل شدند. RevealActionType به عنوان داخلی علامت گذاری کرد. ( I885d0 ).
SwipeToReveal API به‌صورت زیر به‌روزرسانی شد: onFullSwipe به onSwipePrimaryAction تغییر نام داد. تغییر نام SwipeToRevealNonAnchoredSample برای نشان دادن استفاده از پارامتر hasPartiallyRevealedState . actionButtonHeight حذف شد، زیرا پیش‌فرض ارتفاع پیش‌فرض دکمه است و ارتفاع بزرگ‌تر را می‌توان با استفاده از یک اصلاح‌کننده تنظیم کرد. SmallActionButtonHeight از SwipeToRevealDefaults حذف کرد. پارامتر مقدار را در سازنده RevealValue و RevealDirection خصوصی کرد. ( I465ce ).

رفع اشکال

کنترل EdgeButton ScreenScaffold را ثابت کرد تا پس از حذف یک آیتم TransformingLazyColumn ، EdgeButton در جای خود متحرک شود. ( I6d366 ).
وابستگی های Wear Compose را در کتابخانه های Compose به نسخه 1.8.0 به روز کرد. ( I2ef3f ).
حرکت CircularProgressIndicator نامشخص را به روز کرد تا دیگر به طور موقت پسرفت نکند. ( Ieddb1 ).
رفع یک اشکال SwipeDismissableNavHost - پس از کشیدن انگشت به عقب، فوکوس به درستی تغییر نمی کرد و باعث می شد ورودی چرخشی از کار بیفتد (این برای API 36+ بود که از برگشت پیش بینی کننده استفاده می کند). ( Ieddb1 ).
اسناد اصلاح شده برای API تمرکز سلسله مراتبی ( Idf2ff ).
اسناد را برای Button و Card به‌روزرسانی کرد تا بیان کند که چگونه containerPainter و disabledContainerPainter containerColor و disabledContainerColor را لغو می‌کنند ( I4a453 ).
تغییری را به TimeText در نسخه قبلی برگرداند که BroadcastReceiver به یک رشته کاری منتقل کرد، زیرا باعث ایجاد مشکلاتی برای برنامه‌هایی شد که رشته‌های خود را در طول پیمایش مدیریت می‌کنند. ( I34d02 ).
نمونه‌های Picker را به‌روزرسانی کرد تا تماس‌های به خاطر سپردن غیرضروری را حذف کند و در عوض rememberUpdatedState در Picker برای به خاطر سپردن آخرین تابع لامبدا contentDescription استفاده کنید. ( ICb5b1 ).
سبک های متن را در TimePicker و DatePicker به روز کرد تا تغییرات فونت دیگر منجر به برش نشود. ( I26194 ).
ListHeader و ListSubHeader اکنون ترازبندی متن پیش‌فرض به ترتیب به تراز وسط و تراز شروع می‌شوند. ( I78339 ).
به‌روزرسانی بنیاد و Material Swipe to Reveal نمونه‌ها و نسخه‌های نمایشی برای اعلام کنش‌های دسترسی سفارشی (عملکردهای سفارشی باید به‌عنوان معناشناسی در محتوا اضافه شوند، نه در خود SwipeToReveal قابل ترکیب). ( Ie92a3 ).
مجموعه MaxLines پیش‌فرض روی محتوای EdgeButton را با توجه به اندازه آن به‌روزرسانی کرد - اکنون 1 برای خیلی کوچک، 2 برای کوچک و متوسط و 3 برای بزرگ است. ( Ie35f6 ).
LocalReduceMotion ساده شده به طوری که مشاهده گر فقط یک بار ثبت می شود تا عملکرد را بهبود بخشد. ( Ib1979 ).
برای بهبود عملکرد، تعداد ترسیم مجدد را در ScrollIndicator به حداقل رساند. ( IA7A67 ).
یک اشکال در TransformingLazyColumn برطرف شد، که در آن آیتم قابل مشاهده بالای لیست زمانی که EdgeButton به ارتفاع کامل خود رسید مقیاس درستی نداشت. ( I30580 ).

Wear Compose Material3 نسخه 1.0

نسخه 1.0.0-alpha37

23 آوریل 2025

androidx.wear.compose:compose-material3:1.0.0-alpha37 منتشر شد. نسخه 1.0.0-alpha37 حاوی این تعهدات است.

تغییرات API

scrollTransform از سطح عمومی API حذف شد. اگر نیاز دارید که عملکرد مشابهی داشته باشید، از ترکیب تغییر دهنده های transformedHeight و graphicsLayer استفاده کنید. ( Ie181d )
جایگزین‌های ImageButton و ImageCard به ترتیب با اضافه‌بارهای Button و Card/TitleCard . imageButtonColors به buttonWithContainerPainterColors و imageCardColors به cardWithContainerPainterColors تغییر نام داد. ButtonDefaults.scrimBrush و CardDefaults.scrimBrush عمومی اضافه شد. تغییر نام دکمه imageBackgroundGradientStartColor و imageBackgroundGradientEndColor به scrimGradientStartColor و scrimGradientEndColor . تغییر نام CardDefaults.ImageContentPadding به CardDefaults.CardWithContainerPainterContentPadding ( I7b8b6 )
Picker و PickerGroup اکنون contentDescription به صورت لامبدا می گیرند تا از ترکیب مجدد غیرضروری جلوگیری کنند. ( I002dd )

رفع اشکال

اگر عرض با ارتفاع برابر نباشد، مشکلی که در آن CircularProgressIndicator نامشخص در طول انیمیشن تکان می خورد، برطرف شد. ( I76bfe )
مشکل طرح دکمه لبه در اندازه نامعتبر برطرف شد. اکنون از به روز رسانی طرح دکمه لبه هنگامی که ارتفاع NaN است جلوگیری می کند. ( I32b93 )
حداکثر زاویه رفت و برگشت را در OpenOnPhoneDialog افزایش داد تا متن پیش‌فرض «تلفن خود را بررسی کنید» با بزرگ‌ترین اندازه فونت بریده نشود. ( I90af9 )

نسخه 1.0.0-alpha36

9 آوریل 2025

androidx.wear.compose:compose-material3:1.0.0-alpha36 منتشر شد. نسخه 1.0.0-alpha36 حاوی این تعهدات است.

تغییرات API

ButtonDefaults.imageBackgroundButtonColors با ImageButton ، ButtonDefaults.imageButtonColors ، ButtonDefaults.containerPainter و ButtonDefaults.disabledContainerPainter جایگزین شد. و تغییرات مشابه برای کارت. نقاشان از ButtonColors و CardColors حذف شده اند. ( I8c6a1 )
متغیرهای به روز شده برای ساده کردن API. ما اکنون دو Modifier ارائه می‌دهیم، Modifier.placeholderShimmer برای اعمال افکت shimmer در سطح مؤلفه، و Modifier.placeholder برای اعمال یک ماسک در بالای محتوای بارگیری نشده ( Iaee7a )

رفع اشکال

overscroll در ScrollIndicator یکپارچه شده است. ( ICfb7f )
هنگام راه اندازی دیالوگ های material3، پس زمینه های خالی و دیالوگ های از دست رفته را آدرس دهید. ( Ice597 )
رفع مشکلات در FadingExpandingLabel هنگامی که متن چندین خط را در بر می گیرد. ( I04eb7 )
به‌روزرسانی شده بین برچسب‌های اولیه و ثانویه روی دکمه‌ها. ( I99b7b )
ArcLarge از 20sp به 18sp کاهش یافته است و فاصله حروف در ArcLarge و ArcSmall به روز شده است. ConfirmationDialog / OpenOnPhoneDialog اکنون از ArcLarge پیش‌فرض به جای رد کردن آن روی 18sp استفاده می‌کند. ( ID39a8 )

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

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

نسخه 1.0.0-alpha35

26 مارس 2025

androidx.wear.compose:compose-material3:1.0.0-alpha35 منتشر شد. نسخه 1.0.0-alpha35 حاوی این تعهدات است.

تغییرات API

هنگامی که یک نماد ارائه می شود، لایه بالایی AlertDialog اکنون به طور پیش فرض کاهش می یابد - این باعث می شود بهترین استفاده از اندازه صفحه نمایش در دسترس باشد. ( Ief06c )
PagerScaffoldDefaults.FadeOutAnimation به PagerScaffoldDefaults.FadeOutAnimationSpec تغییر نام داده است. پارامتر صفحه در AnimatedPage به pageIndex تغییر نام داده است. ( I701f2 )
نامگذاری به روز شده برای TransformingLazyColumn 's SurfaceTransformation - applyTransformation به applyContainerTransformation و applyContentTransformation تقسیم شد و نام createBackgroundPainter را به createContainerPainter تغییر داد. به‌روزرسانی‌های نام‌گذاری بیشتر برای TransformationSpec و ResponsiveTransformationSpec . ( I1c534 )
AppScaffold backgroundColor به containerColor تغییر نام داده است. ( I4e63f )

رفع اشکال

مشکلی در FadingExpandingLabel که در آن متن همیشه به درستی گسترش نمی یافت، رفع شد. ( I0e773 )
ArcLarge از 20sp به 18sp کاهش یافته است و فاصله حروف در ArcLarge و ArcSmall به روز شده است. ConfirmationDialog/OpenOnPhoneDialog اکنون از ArcLarge پیش‌فرض به جای رد کردن آن روی 18sp استفاده می‌کند. ( ID39a8 )
انیمیشن عنوان را برای DatePicker و TimePicker به‌روزرسانی کرد، به طوری که انیمیشن محو و محو شده به عنوان یک انیمیشن Spring عمل می‌کند. ( I68963 )
با اجتناب از خواندن currentPageOffsetFraction در AnimatedPage composable، PagerScaffold را بهینه کرد. ( I433ef )
همه مقیاس‌های نوع به‌طور پیش‌فرض به‌روزرسانی شده‌اند تا اعداد متناسبی داشته باشند، زیرا این مورد به عنوان رایج‌ترین مورد استفاده در نظر گرفته می‌شود و پیش‌فرض به جدول باعث ایجاد فاصله بیش از حد بین زوج‌های اعداد خاص می‌شود. TimePicker و DatePicker همچنان به اعمال FontFeatureSetting=tnum برای اعداد جدولی ادامه می دهند. ( I88929 )
فوکوس اولیه ورودی RSB را برای TimePicker و DatePicker تصحیح کرد. ( I1c773 )
متن پیش‌فرض در OpenOnPhoneDialog را به «تلفن خود را بررسی کنید» به‌روزرسانی کرد. ( I00a3f )
وزن‌های ArcLarge و ArcMedium از 600 تا 599 به‌روزرسانی شد تا مشکلی را حل کند که در آن وزن 600 به عنوان پررنگ در نظر گرفته می‌شود ( I2a51d )
بالشتک های SwipeToReveal را بین دکمه های محتوا و اکشن و همچنین بالشتک بین نماد و متن دکمه های عمل به روز کنید. ( IC46cb )

نسخه 1.0.0-alpha34

12 مارس 2025

androidx.wear.compose:compose-material3:1.0.0-alpha34 منتشر شد. نسخه 1.0.0-alpha34 حاوی این تعهدات است.

تغییرات API

PagerScaffold دیگر یک جزء Pager را منتشر نمی کند - در عوض باید از طریق content Composable ارائه شود. AnimatedPage و snapWithSpringFlingBehaviour اکنون عمومی هستند و می توانند همراه با Wear Foundation Pager برای دستیابی به رفتار قبلی M3 PagerScaffold استفاده شوند. (نمونه های به روز شده را ببینید). ( Ia4724 )
PagerState را به روز کرد، Compose Foundation PagerState به عنوان کلاس پایه حذف کرد و ویژگی های currentPage ، currentPageOffsetFraction و pageCount اضافه کرد. رابط GestureInclusion را به روز کرد و نام روش را به ignoreGestureStart تغییر داد. ( I4ae07 )
پارامترهای زاویه رفت و برگشت LevelIndicator اکنون با FloatRange(0, 360) ( I7e636 ) حاشیه نویسی شده اند.
ما CurvedModifier.clearAndSetSemantics اضافه کرده‌ایم تا وسیله‌ای برای خاموش کردن معناهای منحنی فراهم کنیم. CurvedText به پیش‌فرض توضیحات محتوا برای متن ادامه می‌دهد، اما timeTextCurvedText و timeTextSeparator اکنون محتوای خود را اعلام نمی‌کنند. ( I4b568 )
یک پس‌زمینه و پارامترهای رنگ محتوای پیش‌فرض به AppScaffold اضافه شد. ( I56652 )
مدیریت پیش‌فرض HorizontalPager برای حرکات کشیدن انگشت به PagerDefaults.gestureInclusion تغییر نام داده است. رفتار پیش‌فرض اکنون صرفاً نادیده گرفتن حرکات تند کشیدن است که از لبه چپ صفحه اول شروع می‌شوند و تنها پس از آن وقتی Talkback خاموش است. در موارد دیگر، رفتار پیش‌فرض این است که ژست‌های تند کشیدن توسط پیجر نادیده گرفته نمی‌شوند، بنابراین برای کنترل‌کننده‌های تند کشیدن برای رد کردن در دسترس نخواهند بود. ( Iee486 )
یک پارامتر SurfaceTransformation را به اجزای هدر دکمه، کارت و فهرست اضافه کرد تا بتوانند پس‌زمینه و تبدیل‌های محتوا را هنگام استفاده در کانتینرهایی اعمال کنند که ظاهر آیتم‌ها را بر اساس موقعیت آنها تغییر می‌دهند، مانند TransformingLazyColumn . ( Iabe3f )
ما ویژگی‌های 'const val' عمومی را در Wear Compose Material3 API خود به 'public val' به‌روزرسانی کرده‌ایم تا از درج شدن مقادیر جلوگیری کنیم. ( Ib0f32 )
به SwipeToReveal پشتیبانی از ناحیه لبه‌کشی اضافه شد. رفتار پیش‌فرض Foundation SwipeToReveal اکنون این است که وقتی حرکت از لبه شروع می‌شود، کشیدن انگشت را مجاز نمی‌داند. رفتار پیش‌فرض Material3 SwipeToReveal' اکنون این است که وقتی حرکت حرکتی از لبه شروع می‌شود، وقتی SwipeDirection روی یک جهت تنظیم شده است، کشیدن انگشت را ممنوع می‌کند. ( I32ef0 )
اضافه شده FadingExpandingLabel composable، که به آن اجازه می دهد در متن با انیمیشن خط به خط محو شود. ( IC60fa )
TransformingLazyColumn اکنون به‌جای قرار دادن اولین و آخرین موارد در مرکز، به‌طور پیش‌فرض contentPadding خالی از Padding استفاده می‌کند. ( I77ab7 )
SwipeToReveal 's rememberRevealState از کتابخانه Wear Compose Material3 حذف شد. ( I8c0e0 )

رفع اشکال

کتابخانه های Wear Compose به کامپایلر Kotlin 2.0 به روز شده است. ( I2de79 )
پشتیبانی از ScrollIndicator و PageIndicator غیر گرد از Material3 حذف شده است. پشتیبانی از صفحه نمایش مربعی نیز دیگر بخشی از الزامات Wear OS نیست، برای اطلاعات بیشتر به راهنمای شروع کار مراجعه کنید. ( I9a852 )
CurvedTextStyle مورد استفاده در ConfirmationDialogDefaults و OpenOnPhoneDialogDefaults برای استفاده از تایپوگرافی ArcLarge با اندازه 18sp و فاصله حروف 1.8sp به روز شده است. ( IC9ced )
Card , ListHeader , RadioButton , CheckboxButton , SwitchButton دیگر ارتفاع محتویات آن را به طور پیش فرض محدود نمی کند. در صورت لزوم، از Modifier.height(IntrinsicSize.Min) برای بازیابی رفتار قبلی در صورت نیاز استفاده کنید. ( I80bb8 )
ما رنگ‌های پیش‌فرض TimeText و ScrollIndicator را به‌روزرسانی کرده‌ایم تا رنگ‌های خاکستری بیشتری را شامل شود، زیرا استفاده از OnBackground (سفید) هنگام رقابت با محتوای دیگر روی صفحه مانند عناوین، مستقیماً وزن بصری زیادی داشت. ( I8b36f )
مدت زمان متحرک سازی TimeText و ScrollIndicator در اجزای داربست را به 2 ثانیه کاهش داده ایم. ( I52021 )
ما حرکت Dialog را به‌روزرسانی کرده‌ایم تا مقیاس پس‌زمینه Dialog با کشیدن انگشت برای رد کردن همگام شود. ( I925a9 )
نسخه ی نمایشی M3 SwipeToReveal با استفاده از اصلاح کننده edgeSwipeToDismiss اضافه کنید. ( I02b07 )
ما یک عنوان به DatePicker و TimePicker در TalkBack اضافه کرده‌ایم تا به کاربر اطلاع داده شود که برای تنظیم تاریخ/زمان پیمایش کند. ( ID738d )
AnimatedText اکنون از تنظیمات کاهش حرکت پیروی می کند. ( Ib6578 )
بهینه سازی استفاده از AppScaffold برای نمایش محتوای گفتگو بهبود یافته است تا امکان نمایش چندین گفتگو روی هم را فراهم کند ( I1209c )

نسخه 1.0.0-alpha33

26 فوریه 2025

androidx.wear.compose:compose-material3:1.0.0-alpha33 منتشر شد. نسخه 1.0.0-alpha33 حاوی این تعهدات است.

تغییرات API

ما پارامتر برچسب را از SwipeToRevealScope primaryAction و secondaryAction حذف کرده ایم. معنای اکشن سفارشی باید مستقیماً توسط توسعه دهنده به محتوای مؤلفه SwipeToReveal اضافه شود. ( Ia67f3 )
ما پیشوندهای "Button" را از اندازه‌ها، سبک‌های متن و توابع رنگ در IconToggleButtonDefaults و TextToggleButtonDefaults حذف کرده‌ایم ( I5471d )
ما LocalMinimumInteractiveComponentEnforcement آزمایشی ( I4ad8a ) را حذف کردیم
ما PickerGroupScope DSL را با یک composable جایگزین کرده ایم. به این ترتیب، ما متد pickerGroupItem از PickerGroupScope حذف کردیم و به جای آن @Composable PickerGroupItem اضافه کردیم که باید برای افزودن یک Picker به PickerGroup استفاده شود. ما همچنین نوع پارامتر 'content' PickerGroup به @Composable PickerGroupScope.() -> Unit به روز کردیم. ( IC6aec )
ما یک اضافه بار LevelIndicator برای مقادیر کسری اضافه کرده‌ایم و یک پیشوند Stepper به آن اضافه‌بارهایی اضافه کرده‌ایم که شامل یک پارامتر محدوده (که برای استفاده با مولفه Stepper مناسب هستند) است. ( If4234 )
TransformationSpec TransformingLazyColumn را به API اضافه کرده‌ایم، که اجازه می‌دهد تا تغییرات دقیقی را که برای آیتم‌ها در حال پیمایش در TLC اتفاق می‌افتد، تعریف کنیم. ( I21856 )
ما IconButtonShapes ، IconToggleButtonShapes ، TextButtonShapes و TextToggleButtonShapes را به‌روزرسانی کرده‌ایم تا با کلاس‌های compose/material3 سازگار باشد ( I5a081 )
ما یک پارامتر overscrollEffect به ScalingLazyColumn ، TransformingLazyColumn و ScreenScaffold اضافه کرده ایم. ( I0cee8 )
ما پارامتر swipeDirection در rememberRevealState به revealDirection تغییر نام دادیم. ( I7472f )
Wear Pager اکنون به جای استفاده از Compose PagerScope PagerScope خود را دارد. ( I9195b )
ما LinearProgressIndicatorContent قابل ترکیب را حذف کرده ایم، لطفاً مستقیماً از LinearProgressIndicator استفاده کنید تا تغییرات مقادیر به طور پیش فرض متحرک شوند. ( I2c4ad )
ما ترکیب CircularProgressIndicatorStatic را حذف کرده ایم و یک عملکرد عمومی DrawScope drawCircularProgressIndicator با همان عملکرد اضافه کرده ایم. لطفاً مستقیماً از CircularProgressIndicator استفاده کنید تا تغییرات به طور پیش فرض متحرک شوند ، اما در صورت نیاز به انیمیشن های سفارشی ، ترکیب خود را از drawCircularProgressIndicator بسازید. ( IE762F )
ما پارامترهای موجود در DrawScope.drawCircularProgressIndicator را دوباره مرتب کرده ایم تا پارامتر targetProgress بالا ببریم. ( i8ab92 )
API OpenOnPhoneDialog برای وضوح بهتر و سازگاری با سایر گفت و گوها به روز شد. پارامتر show به جای داشتن مقدار پیش فرض توسط visible گیرنده توسط curvedText گیرنده تغییر نام داده شده است. ( idec2d )
ما به openOnPhoneCurvedText به openOnPhoneDialogCurvedText تغییر نام داده ایم ( I65BDD )
ما برای تهیه رنگهای سفارشی برای ScrollIndicator ScrollIndicatorColors را اضافه کرده ایم. ( i9eb8c )
پیکربندی رنگ مورد استفاده برای ترسیم پس زمینه در پشت TimeText را فراهم می کند. ( i9f5d9 )
Typographies ArcLarge ، ArcMedium و ArcSmall به روز شده به صورت CurvedTextStyle ( IFFC41 )
ما ScreenScaffoldDefaults.contentPaddingWithEdgeButton را حذف کرده ایم. ( IA923E )
ما برای خطاهای اولویت بالا یا اقدامات اضطراری مانند هشدارهای ایمنی ، پوشش های گفتگوی ناموفق یا دکمه های توقف ، errorDim به ColorScheme اضافه کرده ایم. ( i70998 )

رفع اشکال

ما wear.compose.material3 به نسخه 1.15.0 androidx.core.core ( I132E9 ) پین کرده ایم.
ما با استفاده از AppScaffold به گفتگوی لایه بر روی سایر محتوای صفحه نمایش ، عملکرد گفتگو را بهبود بخشیم ( I1B9A4 )
کاهش عمودی داخلی EdgeButton . ( i1a5bb )
ما به دکمه های کشویی معانی دکمه اضافه کرده ایم. ( i80cc6 )

نسخه 1.0.0-alpha32

29 ژانویه 2025

androidx.wear.compose:compose-material3:1.0.0-alpha32 منتشر شده است. نسخه 1.0.0-alpha32 شامل این تعهدات است.

تغییرات API

در CurvedTextStyle ، ما فاصله حرف را به فاصله حرف در جهت عقربه های ساعت و فاصله حروف ضد عقربه های ساعت داریم. این مورد نیاز است زیرا حروف در جهت عقربه های ساعت از پایه قرار می گیرند در حالی که فن حروف خلاف جهت عقربه های
ما IconButtonShapes ، IconToggleButtonShapes ، TextButtonShapes و TextToggleButtonShapes را به روز کرده ایم تا بتوانیم سازگاری را در کتابخانه های Material3 بهبود بخشیم. این تغییر همچنین حافظه نهان را برای کاهش تعداد تخصیص ها معرفی می کند. ( i049fc )
ما پارامتر pressedShapeCornerSizeFraction را از روش variantAnimatedShape در IconToggleButton و TextToggleButton حذف کرده ایم ( i58a65 )
We are introducing improvements to curved text rendering (including TimeText ) that are incompatible with non-round screens. پشتیبانی از صفحه نمایش غیر دور نیز دیگر بخشی از الزامات سیستم عامل Wear نیست ، برای اطلاعات بیشتر به راهنمای شروع کار مراجعه کنید. ( i1cc1c )
ما ButtonGroupScope ButtonGroup را به روز کرده ایم و ButtonGroupItem مبتنی بر DSL را با Modifier.weight ، Modifier.minWidth و Modifier.enlargeOnPress جایگزین می کنیم. ( i16c3c )
در API ButtonGroup ، ما ButtonGroupScope مبتنی بر اصلاح کننده جدید را به روز کرده ایم: enlargeOnPress اکنون animateWidth نامیده می شود ، و به جای MutableInteractionSource ، یک InteractionSource می گیرد زیرا برای جهش آن لازم نیست. ما همچنین ButtonGroupDefaults.DefaultMinWidth ، حداقل عرض پیش فرض دکمه ها را در یک ButtonGroup اضافه کرده ایم. ( IE27ec )
ما ListHeaderDefaults.contentColor به روز کرده ایم تا با یک حرف کوچک شروع کنیم زیرا این یک ویژگی آهنگساز است ( I125A5 )
ما یک پارامتر توضیحات محتوا را به SliderDefaults.DecreaseIcon و SliderDefaults.IncreaseIcon اضافه کرده ایم ، با مقادیر پیش فرض مناسب ( I2E1A7 )
ما پارامتر spacing در Picker و PickerGroup به verticalSpacing تغییر نام داده ایم ( IB75CC )
failureText ConfirmationDialogDefaults.successText ConfirmationDialog کرده ایم. همچنین به تأیید confirmationCurvedText به confirmationDialogCurvedText . سرانجام ، برای سازگاری با سایر به روزرسانی های اخیر در گفتگوها ، پارامتر show گفتگوی را به قابل مشاهده تغییر نام داد. ( I10074 )
IconButton با نام disabledImageOpacity به DisabledImageOpacity تغییر نام داد. ( i5f94a )

رفع اشکال

ما در انیمیشن EdgeButton یک اشکال را برطرف کرده ایم تا از اندازه صحیح در هر فریم استفاده شود ( ID3B58 )
مسئله ای را برطرف کرد که animateContentSize با Button کار نمی کند. ( ib18a0 )
ما عنوان مقیاس بزرگ را تغییر داده ایم تا اندازه فونت 18dp داشته باشیم ( IC9D52 )
ما فاصله AlertDialog و اندازه نماد را به روز کرده ایم ( IAC28C )
ما ناسازگاری های ثابت را در نقاط بزرگ صفحه نمایش ثابت داریم (صفحه نمایش در و بالاتر از 225dp صفحه بزرگ است) ( I36474 )
رفع اشکال جزئی در موقعیت یابی دکمه ( I952C2 )

نسخه 1.0.0-alpha31

15 ژانویه 2025

androidx.wear.compose:compose-material3:1.0.0-alpha31 منتشر شده است. نسخه 1.0.0-alpha31 شامل این تعهدات است.

تغییرات API

ما تمام کتابخانه های آهنگسازی Wear را به حالت "API صریح" به روز کرده ایم. ( IEBF9F )
ما API های ScreenScaffold و EdgeButton را به روز کرده ایم ، به طوری که مشخص کردن بالشتک های محتوا روی صفحه هایی که شامل یک EdgeButton است ، آسان تر است. در API جدید ، size EdgeButton فقط به EdgeButton منتقل می شود ، و ScreenScaffold یک پارامتر edgeButtonSpacing برای فاصله بین EdgeButton و محتوای لیست می گیرد. ( i424fd )
در DatePicker ، ما به Parameters minDate به maxDate و minValidDate به maxValidDate تغییر نام داده ایم. در DatePickerColors ، ما به پارامترهای selectedPickerContentColor به activePickerContentColor ، و unselectedPickerContentColor به inactivePickerContentColor تغییر نام داده ایم ( IBA17B )
ما پیش فرض های ArcProgressIndicator را به strokeWidth=6dp و diameter = 81.24% از ارتفاع صفحه ( I6F248 ) به روز کرده ایم.
ما API تأیید را به روز کرده ایم تا استفاده از آن به عنوان یک گفتگو را منعکس کنیم. این ترکیب در حال حاضر با به روزرسانی های مرتبط با نامگذاری رنگ ها و کلاس های پیش فرض ، به ConfirmationDialog نامیده می شود. ما همچنین برای visible با سایر API های انیمیشن آهنگسازی به پارامتر show تغییر نام داده ایم. علاوه بر این ، ما ConfirmationDialogContent ، SuccessConfirmationDialogContent ، FailureConfirmationDialogContent را برای موقعیت هایی که توسعه دهندگان نیاز به سفارشی کردن انیمیشن های گفتگوی مقدماتی/OUTRO دارند ، ساخته ایم. ( iaeb33 )
ما CircularProgressIndicatorContent به CircularProgressIndicatorStatic (تنوع غیر محرک CircularProgressIndicator ) به روز کرده ایم تا اکنون از آن برای ساخت CircularProgressIndicator با انیمیشن های سفارشی استفاده شود. ( i1346f )
ما سفارش پارامتر را بر روی ArcProgressIndicator ثابت کرده ایم ، و پارامتر اصلاح کننده را در ابتدا قرار داده ایم ( I4656A )
API SwipeToReveal برای دریافت یک پارامتر شکاف متن برای برچسب های اقدامات (به جز اقدام ثانویه) بهبود بخشید و پارامترهای برچسب را از عمل خنثیسازی حذف کنید ( I5B3DB )

رفع اشکال

ما یک اشکال را برطرف کرده ایم که در آن هاپتیک های LongPress بیش از یک بار در Button ، Card ، IconButton ، TextButton ( IA8B0F ) ایجاد شده است
تغییر در UX از AlertDialog - در صفحه های بزرگ دکمه های تأیید و برکناری اکنون کوچکتر هستند. همچنین در زیر دکمه های تأیید و برکناری فاصله افزایش یافته است. ( i4f066 )
ما مشخصات انیمیشن برچسب دکمه اکشن از مؤلفه SwipeToReveal را تغییر داده ایم. ( IB87FB )
SwipeToReveal تغییر داده تا در همان زمان نمایش متن ، ظرف را گسترش دهد. ( i44cf8 )
SwipeToReveal بهبود یافته برای انجام بازخورد هاپتیک هنگام کش رفتن از آستانه که در آن عمل اولیه انجام می شود. ( i23efe )
ما SwipeToReveal برای نمایش بیضوی در مورد سرریز متن به طور پیش فرض ، برای اقدامات اولیه و خنثی کردن به روز کرده ایم. ( i71f5a )
ما مسئله ای را برطرف کرده ایم که باعث ایجاد لرزش در انیمیشن های ButtonGroup می شود. ( i63f8f )
ما معانی متن را به AnimatedText اضافه کرده ایم ( i6063c )
گفتگو اکنون هنگام حذف گفتگو از ترکیب ، مقیاس بندی پس زمینه را مجدداً تنظیم می کند (بدون این رفع ، صفحه پرتاب ممکن است در یک حالت کوچک باقی مانده باشد) ( ID24AC )
ما یک انیمیشن شکل MORPH را به دکمه های موجود در مؤلفه Stepper اضافه کرده ایم ( ID6ED3 )

نسخه 1.0.0-alpha30

11 دسامبر 2024

androidx.wear.compose:compose-material3:1.0.0-alpha30 منتشر شده است. نسخه 1.0.0-alpha30 شامل این تعهدات است.

تغییرات API

اصلاح کننده scrollTransform برای TransformingLazyColumn دوباره تغییر یافت که باعث تغییر API شد. ( i0c6dc )
ما IconToggleButtonShapes و TextToggleButtonShapes به روز کرده ایم تا دو پارامتر شکل متفاوت uncheckedPressed و checkedPressed ( I85DBD )
گزینه های ماه/روز نامعتبر اکنون در هنگام استفاده از minDate یا maxDate ، در DatePicker ، با یک invalidPickerContentColor جدید قابل مشاهده است. ( IF4541 )
ما API Stepper برای ارائه اسلات های increaseIcon و decreaseIcon به روز کرده ایم - محتوای این موارد را می توان طبق معمول از ساختار نماد ساخته شد. ( id35da )
ما dynamicColorScheme با حذف پارامتر defaultColorScheme اختیاری و اکنون بازگرداندن ColorScheme قابل برگشت به روز کرده ایم. این بدان معنی است که تماس گیرنده باید در صورت ارائه یک طرح رنگ پویا ، به صراحت پرونده بازگشت را کنترل کند. ( i6d62e )
ما اندازه نماد را در ButtonDefaults برای استفاده با CompactButton به روز کرده ایم. یک CompactButton فقط شامل یک نماد است باید از ButtonDefaults.SmallIconSize = 24.dp استفاده کند ، در حالی که یک CompactButton حاوی هر دو نماد و متن باید از ButtonDefaults.ExtraSmallIconSize = 20.dp استفاده کند. توصیه می شود که CompactButton محتوای خود را (به جای پر کردن عرض حداکثر) بسته بندی کند و نمونه ها برای نشان دادن آن به روز شده اند. ( I0582C )
ما EdgeButtonDefaults با اندازه نماد توصیه شده برای 4 EdgeButtonSizes مختلف اضافه کرده ایم. همچنین ، طرح EdgeButton را به روز کرد به طوری که دارای بالشتک کمی بزرگتر از بالشتک برتر است ، که باعث افزایش ظاهر برای هر دو نماد و متن می شود. ( id772a )
ما حرکتی را به LinearProgressIndicator و LinearProgressIndicatorContent در معرض قرار داده ایم که محتوای بصری را بدون انیمیشن فراهم می کند. ( idee99 )
ما برای نمایش محتوای بصری CircularProgressIndicator بدون انیمیشن ، یک ترکیب جدید CircularProgressIndicatorContent را اضافه کرده ایم. ( IE33D4 )
TransformingLazyColumn به تازگی ترکیب LocalTransformingLazyColumnItemScope transforminglazycolumnitemscope را فراهم می کند که Card S ، Button S و ListHeader S اکنون در هنگام قرار دادن در داخل یک TransformingLazyColumn به طور خودکار از آن استفاده می کنند. تماس گیرندگان می توانند با استفاده از بسته بندی جدید TransformExclusion ، مورفین اتوماتیک را غیرفعال کنند. ( i1652f )
ما نوع ButtonDefaults.shape به RoundedCornerShape ( ICCDF2 ) به روز کرده ایم

رفع اشکال

ما یک اشکال را برای احترام به آلفا موجود در پس زمینه برای TimeText بندی کرده ایم ( I1EB60 )
ما TextMotion به طور پیش فرض در تایپوگرافی خود به Animated تنظیم کرده ایم تا از گوش دادن به متن به دلیل گرفتن گلیف های نامه به مرزهای پیکسل در حین عملیات مقیاس پذیر جلوگیری کنیم. ( i626fa )
ما با افزایش عرض و اندازه شکاف ، ظاهر ScrollIndicator را به روز کرده ایم تا دید را بهبود بخشیم. ( ied7cb )
ما هنگام افزودن/حذف/جابجایی موارد ، یک اشکال را بر روی Modifier.scrollTransform حل کرده ایم. ( i6830f )
ما یک مسئله انیمیشن دکمه دور را برای شیرهای کوتاه برطرف کرده ایم (قبلاً حداقل مدت زمان انیمیشن همیشه مشاهده نشده بود). ( i757a7 )
ما زاویه جارو برای LevelIndicator را به 20 ٪ (یعنی 72 درجه) به روز کرده ایم. ( idde5c )
ما در هنگام استفاده از ScalingLazyColumn با AutoCenteringParams ، موقعیت ScrollIndicator را ثابت کرده ایم. ( i387DD )
ما رنگ ها و تایپوگرافی ها را برای ListHeader و ListSubHeader به روز کرده ایم. همچنین رنگ های کنترل کننده ضامن در CheckboxButton و SwitchButton . ( i39817 )
ما موقعیت ScrollIndicator را در LazyColumn و ScalingLazyColumn با ContentPadding ثابت کرده ایم. ( I2BC51 )
ما با استفاده از New CircularProgressIndicatorContent یک اشکال دیده شده در انیمیشن پیشرفت OpenOnPhoneDialog را برطرف کرده ایم. ( i3e443 )
ما در هنگام فعال کردن حرکت ، انیمیشن ها HorizontalPagerScaffold غیرفعال کرده ایم تا انیمیشن ها را غیرفعال کنیم ( IAAF68 ) انیمیشن ها VerticalPagerScaffold کرده ایم.
ما هنگامی که پیشرفت به بیش از 100 ٪ برسد ، یک انیمیشن جداگانه برای شاخص های پیشرفت دایره ای پیاده سازی کرده ایم. ( i47135 )
ما یک اشکال را برطرف کرده ایم که در آن EdgeButton با یک شکل نادرست در اجزای پیجر ترسیم شود ( I91DB9 )

نسخه 1.0.0-alpha29

13 نوامبر 2024

androidx.wear.compose:compose-material3:1.0.0-alpha29 منتشر شده است. نسخه 1.0.0-alpha29 شامل این تعهدات است.

تغییرات API

ما TimeText به روز کرده ایم تا محتوای پیش فرض را ارائه دهیم که زمان را نشان می دهد. ( id23b3 )
ما با از بین بردن پارامتر orientation ، که دیگر نیازی به آن نیست ، ScrollInfoProvider برای PagerState ساده کرده ایم. رفتار جدید برای این است که TimeText برای صفحه بندی افقی و عمودی باقی بماند. ( I71767 )
LocalHapticFeedback اکنون هنگامی که API ویبراتور نشان می دهد که از هاپتیک پشتیبانی می شود ، اجرای پیش فرض HapticFeedback را ارائه می دهد. موارد زیر به HapticFeedbackType اضافه شده است - Confirm ، ContextClick ، GestureEnd ، GestureThresholdActivate ، Reject ، SegmentFrequentTick ، SegmentTick ، ToggleOn ، ToggleOff ، VirtualKey . پوشیدن اجزای قابل کلیک مانند Button ، IconButton ، TextButton و Card اکنون هنگام تهیه یک کنترل کننده طولانی با کلیک طولانی ، Haptic LONG_PRESS را انجام می دهند. ( I5083D )

رفع اشکال

ما حرکت را برای تأیید به روز کرده ایم. ( i04bff )
ما حداقل وابستگی API را به 1.7.4 برای کتابخانه های آهنگسازی به روز کرده ایم. ( i88b46 )
حرکت جدید برای گفتگوی OpenOnPhone اضافه شد. ( i1e10a )
ما یک اشکال را در LevelIndicator رفع کرده ایم تا اکنون به درستی با سطح صفر نمایش داده شود. ( IE95A4 )
ما انیمیشن های HorizontalPageIndicator و VerticalPageIndicator را به روز کرده ایم. ( i5c8f3 )
ما یک انیمیشن کوچک به نقطه را به ArcProgressIndicator نامشخص اضافه کرده ایم. ( i9fd51 )

نسخه 1.0.0-alpha28

30 اکتبر 2024

androidx.wear.compose:compose-material3:1.0.0-alpha28 منتشر شده است. نسخه 1.0.0-alpha28 شامل این تعهدات است.

تغییرات API

ما یک تغییر قوس در شاخص پیشرفت دایره نامشخص ( I2EFC1 ) اضافه کرده ایم
ما مجموعه های AlertDialogContent و Dialog را که AlertDialog API را تشکیل می دهند ، عمومی کرده ایم ، به طوری که در صورت لزوم امکان اضافه کردن سفارشی سازی (مانند سفارشی سازی انیمیشن AlertDialog در حالی که نگه داشتن طرح محتوای توصیه شده) وجود دارد. علاوه بر این ، ما پارامترهای Modifier و Color را به EdgeButton ، ConfirmButton و اعضای DismissButton از AlertDialogDefaults اضافه کرده ایم. ( i4eb71 )
ما API Placeholder به شرح زیر به روز کرده ایم: تغییر نام به PlaceholderState.startPlaceholderAnimation به PlaceholderState.animatePlaceholder ، PlaceholderState.isShowContent به PlaceholderState.isHidden ، و PlaceholderDefaults.shape to PlaceholderDefaults.Shape ؛ تغییر نام پارامتر painter در painterWithPlaceholderOverlayBackgroundBrush به originalPainter ؛ تغییر دیدگاه PlaceholderState.placeholderProgression از عموم به داخلی و تغییر نام آن به placeholderShimmerProgression ؛ اضافه کردن ثابت مدت زمان انیمیشن نگهدارنده به PlaceholderDefaults . ( IE5A59 )
ما API EdgeButton به شرح زیر به روز کرده ایم: تغییر نام پارامتر در ScreenScaffold از bottomButton به edgeButton ؛ ساخته شده EdgeButtonSize یک کلاس ارزش. ( IEEF15 )
ما دید copy() را در کلاسهای لباس پوشیدنی (I0287F) به عموم تغییر داده ایم ( I0287F )

رفع اشکال

حداقل مدت زمان انیمیشن اضافه شده برای IconToggleButton و TextToggleButton در کلیک ( IEB333 )
حداقل مدت زمان اضافه شده در انیمیشن IconButton و TextButton Shape ( IEBCEE )
گزینه تکرار حالت DatePicker را اصلاح کرد. ( i3587c )
حرکات اضافه شده برای گفتگوی هشدار و تأیید. ( i173b1 )

نسخه 1.0.0-alpha27

16 اکتبر 2024

androidx.wear.compose:compose-material3:1.0.0-alpha27 منتشر شده است. نسخه 1.0.0-alpha27 شامل این تعهدات است.

تغییرات API

ما به دنبال تغییر نام در Foundation Foundation LazyColumn to TransformingLazyColumn ScreenScaffold و ScrollIndicator را به روز کرده ایم. ( i0608b )
پارامتر preferredHeight EdgeButton به buttonSize تغییر نام داده شده است و مقدار آن فقط از 4 ثابت در کلاس ارزش EdgeButtonSize تازه معرفی شده قابل انتخاب است. ( ICDD70 )
ما نامگذاری ListSubheader را به ListSubHeader تغییر داده ایم و مقادیر پیش فرض قابل دسترسی عمومی را برای ListHeader و ListSubHeader اضافه کرده ایم. ( i96730 )
ما اجزای جدید New HorizontalPagerScaffold و VerticalPagerScaffold را برای سایش اضافه کرده ایم که انیمیشن های جدید و هماهنگی بین اجزای نشانگر زمان و صفحه را ارائه می دهد. ( iff7d0 )
ما پشتیبانی چرخشی را به HorizontalPagerScaffold و VerticalPagerScaffold اضافه کرده ایم و به کاربران این امکان را می دهد تا با استفاده از دستگاه های ورودی چرخشی ، صفرا را حرکت دهند. ( i9770d )
ما برای ساده سازی استفاده و بهبود قوام ، تغییرات API MotionScheme را ایجاد کرده ایم. توابع را به یاد داشته باشید که به یاد داشته باشید و طرح های حرکتی داخلی را به یک شیء اختصاصی همراهی منتقل کنید. تغییر نام با standardMotionScheme و expressiveMotionScheme به استاندارد و بیانگر. ( i5fd45 )
ما پشتیبانی از یک طرح رنگی پویا را بر اساس رنگ های سیستم اضافه کرده ایم. ( I073E9 )
ما پله را به آخرین مشخصات UX به روز کرده ایم. ( i622bb )

رفع اشکال

ما تایپوگرافی و بالشتک را برای اجزای کارت به روز کرده ایم. ( i3ae48 )
ما بالشتک را در AlertDialog بین دکمه های تأیید/برکناری و بقیه محتوا از 8DP به 12DP مطابق مشخصات UX تغییر داده ایم ( IE55F0 )
ما کدورت رنگ را برای مؤلفه کشویی به روز کرده ایم. ( IDB383 )

نسخه 1.0.0-alpha26

2 اکتبر 2024

androidx.wear.compose:compose-material3:1.0.0-alpha26 منتشر شده است. نسخه 1.0.0-alpha26 شامل این تعهدات است.

تغییرات API

ما API و ظاهر HorizontalPageIndicator به روز کرده ایم و برای استفاده با VerticalPager ( IC9309 ) به صورت عمودی VerticalPageIndicator اضافه کرده ایم
AlertDialog اکنون از توانایی حذف دکمه پیش فرض پایین از تنوع پشته دکمه ، برای طرح بندی های سفارشی که در آن Edgebutton لازم نیست ، پشتیبانی می کند. ( i34fa9 )
ما یک مؤلفه SwipeToReveal برای مواد سایش 3 اضافه کرده ایم ( IC38B2 )
ما برای موارد نادر که صفحه نمایش فعلی از کشش برای عزل پشتیبانی نمی کند ، پشتیبانی از جابجایی دو جهته در SwipeToReveal را اضافه کرده ایم. این پیش فرض هنوز هم فقط در سوپ های راست به سمت راست به سمت راست می کشد و به شدت توصیه می شود که به رفتار پیش فرض احترام بگذارید تا از درگیری با کشش برای برکناری جلوگیری کنید. ( IFAC04 )
ما پارامترهای buttonHeight EdgeButton به preferredHeight تغییر نام داده ایم. ( i4fab3 )
نسخه Kotlin به 1.9 ( I1A14C ) به روز شده است
ما به OpenOnPhoneDialogDefaults.Icon به OpenOnPhoneDialogDefaults.OpenOnPhoneIcon تغییر نام دادیم تا از برخورد با Icon جلوگیری کنیم ( I0F391 )
ما پشتیبانی از ScrollIndicator را در LazyColumn اضافه کرده ایم. ( ia546a )
ما مقادیر پیش فرض را برای TextToggleButton و IconToggleButton به روز کرده ایم. ( i7aaa9 )
ما Picker و PickerGroup API را ساده تر کرده ایم. ( id0653 )
ما CardDefaults.Shape و CardDefaults.Height را اضافه کرده ایم ، که (توکن بودن) در غیر این صورت برای توسعه دهندگان با استفاده از کتابخانه خصوصی بودند. ( i1594a ، b/347649765 )
ما پارامتر پیشرفت را برای شاخص پیشرفت دایره ای باینری تقسیم شده به segmentValue تغییر نام داده ایم. ( IB72D9 )
ما رنگ ها و چیدمان را برای کشویی به روز کرده ایم. ( IC3EEC )

رفع اشکال

ما انیمیشن نماد openOnPhone ( i66f85 ) را به روز کرده ایم
اکنون ما از نمادهای Google Symbols در Slider ، TimePicker و DatePicker استفاده می کنیم. ( i46c7c )
ما در Confirmation و OpenOnPhoneDialog ، بالشتک ها را به روز کرده ایم. ( Iaa82e )

نسخه 1.0.0-alpha25

18 سپتامبر 2024

androidx.wear.compose:compose-material3:1.0.0-alpha25 منتشر شده است. نسخه 1.0.0-alpha25 شامل این تعهدات است.

تغییرات API

ما یک شاخص پیشرفت دایره ای نامشخص اضافه کرده ایم. ( i427a7 )
ما پشتیبانی از سرریز پیشرفت (> 100 ٪ پیشرفت) را برای هر دو CircularProgressIndicator و SegmentedCircularProgressIndicator اضافه کرده ایم. هنگامی که پیشرفت بیش از 1.0 باشد ، این با رنگ جدید overflowTrack نشان داده می شود. ( IAAA3D )
IconToggleButton و TextToggleButton Round اکنون از یک تنوع انیمیشن شکل جدید پشتیبانی می کنند ، که در آن اشکال مختلف نمایانگر حالت های بررسی شده ، بدون کنترل و فشرده شده است. تغییر شکل متحرک قبلی برای حالت تازه فشرده همچنان پشتیبانی می شود. ( I29F03 )
ما به دلیل نیاز به مشخص کردن ارتفاع EdgeButton به صراحت در ScreenScaffold ، پشتیبانی را برای استفاده از EdgeButton با Column حذف کرده ایم. ( IE353D )
ما پشتیبانی از Wear Compose LazyColumn با ScreenScaffold خود اضافه کرده ایم (و اجرای ScrollInfoProvider را برای LazyColumnState اضافه کرده ایم). ( IB8D29 )
ما LocalTextMaxLines ، LocalTextAlign ، LocalTextOverflow به یک ترکیب محلی LocalTextConfiguration محلی ترکیب کرده ایم تا یک راه حل مقیاس پذیر تر را به جلو ارائه دهیم. ( i5edbc )
ما Arc-Large را به عنوان یک نوع اضافی اضافی اضافه کرده ایم که برای رشته های متن کوتاه در قسمت های بسیار بالا یا پایین صفحه نمایش داده شده است ، مانند پوشش های تأیید. ( i60e3e )
ما به صورت پیش فرض برای اندازه های بزرگ و فوق العاده بزرگ نماد و بالشتک محتوا به دکمه اضافه کرده ایم. ( i84675 )

رفع اشکال

ما رنگ های IconButton و TextButton به روز کرده ایم. ( i48324 )
ما اضافه بار دکمه پایه را تغییر داده ایم تا به صورت عمودی در مرکز هماهنگ با سایر اضافه بار قرار بگیریم. برای بازگرداندن رفتار قبلی ، از RowScope Modifier.align استفاده کنید. ( i66e57 )

نسخه 1.0.0-alpha24

4 سپتامبر 2024

androidx.wear.compose:compose-material3:1.0.0-alpha24 منتشر شده است. نسخه 1.0.0-alpha24 شامل این تعهدات است.

تغییرات API

ما یک طرح حرکتی را به موضوع Material3 اضافه کرده ایم. این مورد توسط مؤلفه های موجود در سراسر کتابخانه برای استفاده از مشخصات انیمیشن مانند چشمه ها برای حرکت بیانگر استفاده می شود. ( i54ff3 )
ما اجزای AppScaffold و ScreenScaffold به کتابخانه Material3 اضافه کرده ایم ، که شامل عملکردی برای هماهنگی لایه بندی و انتقال TimeText و ScrollIndicator است. AppScaffold سطح بالایی از اجزای داربست را ارائه می دهد که در بالای تمام صفحه ها قرار دارند. به این ترتیب ، اضافه کردن TimeText به AppScaffold اجازه می دهد تا در هنگام جابجایی بین صفحه ها ، در جای خود باقی بماند. صفحه نمایش ها می توانند متن زمان را نادیده بگیرند یا پنهان کنند. ScreenScaffold شکافی را برای ScrollIndicator فراهم می کند و به طور خودکار نشانگر پیمایش را هنگام پیمایش ، از جمله زمان بندی برای پنهان کردن نشانگر پیمایش پس از عدم تحرک ، متحرک می کند. ( I047D6 )
ما ScrollIndicator با طراحی جدید Material3 اضافه کرده ایم. برای جلوگیری از تغییر اندازه در هنگام بارگیری محتوای تنبل در لیست ، دارای اندازه انگشت شست ثابت است. ( IC228D )
ما API ScrollAway به گونه ای تغییر داده ایم که ScreenStage یک کلاس ارزش به جای یک کلاس Enum است ، تا بتواند مراحل اضافی را در صورت نیاز به جلو اضافه کند. ( i48c93 )
ما EdgeButton اضافه کرده ایم ، یک دکمه مخصوص سایش خاص با شکلی که از انحنای پایین صفحه استفاده می کند ( I16369 )
ما برای یک دکمه پایین (مانند EdgeButton ) یک شکاف جدید به ScreenScaffold اضافه کرده ایم که بسته به محتوای پیمایش ( I032EB ) نشان داده می شود و تغییر اندازه می شود.
ما برای افزودن اثرات حرکتی مواد 3 به موارد موجود در LazyColumn Modifier.scrollTransform . scrolltransform و Modifier.targetMorphingHeight اضافه کرده ایم. ( IE229a )
ما به عنوان یک تغییر در CircularProgressIndicator SegmentedCircularProgressIndicator اضافه کرده ایم. تنوع تقسیم بندی شده یا یک مقدار پیشرفت واحد را در تمام بخش ها نشان می دهد یا هر بخش را روشن/خاموش می کند. ( i6e059 )
ما به عنوان گزینه ای برای CircularProgressIndicator موجود ، LinearProgressIndicator اضافه کرده ایم. ( i89182 )
ما AlertDialog اضافه کرده ایم و طرح هایی را برای ارائه درخواست های مهم به کاربر ارائه می دهیم. تغییرات برای یک جفت دکمه تأیید/رد یا یک دکمه پایین (به طور معمول یک لبه) در زیر یک پشته از گزینه ها گنجانده شده است. هر دو تنوع دارای شکاف هایی برای نماد ، عنوان و متن اضافی برای ارائه جزئیات بیشتر هستند. ( IEB873 )
ما OpenOnPhoneDialog اضافه کرده ایم که باید برای نشان دادن عملی که از طریق تلفن کاربر ادامه خواهد یافت ، استفاده شود. OpenOnPhoneDialog پس از یک زمان مشخص شده رد می شود. ( i978fd )
ما Confirmation اضافه کرده ایم ، یک مؤلفه گفتگو که دارای شکاف هایی برای یک نماد و متن خمیده یا خطی است. تغییرات خاص برای پیام های موفقیت/شکست ارائه شده است. تأییدیه ها به طور خودکار پس از مدت زمان بندی رد می شوند. ( ib43e8 )
ما پیش زمینه ای به TimeText اضافه کرده ایم تا مواردی را که محتوای زیرین و TimeText با هم همپوشانی دارند ، کاهش دهیم و زمان را مبهم کنیم. ( ia11fd )
ما LevelIndicator اضافه کرده ایم ، که مقدار تنظیماتی مانند حجم را نشان می دهد و می تواند با مؤلفه Stepper موجود برای ساخت صفحه نمایش حجم استفاده شود. LevelIndicator شبیه به ScrollIndicator است ، اما در طرف مقابل صفحه نمایش داده می شود و به طور پیش فرض از عرض سکته مغزی گسترده تر و رنگ نشانگر مختلف برخوردار است. ( i8a4ac )
ما TimePicker اضافه کرده ایم ، با طرح بندی به مدت 24 ساعت (با یا بدون ثانیه) یا 12 ساعت با انتخاب AM/PM. ( IA5124 )
ما DatePicker با پیکربندی برای سفارش ستون (یعنی ماهانه روز ، ماه-روز یا روز-ماه) و تاریخ های حداقل/حداکثر اختیاری اضافه کرده ایم. ( IBF13B )
ما یک پارامتر وزن را به عملکرد text TimeText اضافه کرده ایم. در مواردی که متن زمان بندی شده از بیش از یک عنصر متن تشکیل شده است ، این امکان کنترل نحوه توزیع فضا را فراهم می کند. ( i36700 )
ما RadioButton و SplitRadioButton را اضافه کرده ایم - این مؤلفه ها API قبلی را با ترکیب هر دو (تقسیم) SelectableButton و کنترل رادیو کودک ساده می کنند ( IF7AE8 )
ما CheckboxButton و SplitCheckboxButton اضافه کرده ایم - این مؤلفه ها API قبلی را با ترکیب هر دو (تقسیم) ToggleButton و کنترل کادر انتخاب کودک ساده می کنند ( IA8F70 )
ما SwitchButton و SplitSwitchButton را اضافه کرده ایم - این مؤلفه ها API قبلی را با ترکیب هر دو (Split)ToggleButton و کنترل سوئیچ کودک ( I0D349 ) ساده می کنند.
ما مستندات AnimatedText را برای توضیح رفتار بیش از حد به روز کرده ایم. ( iff30a )
ما ButtonGroup برای ترکیب 2 یا 3 دکمه اضافه کرده ایم به گونه ای که فشار دکمه ها یک انیمیشن هماهنگ تولید می کنند. ( IE27DB )
ما هنگام فشار دادن انیمیشن شکل اختیاری برای IconButton و TextButton اضافه کرده ایم. ( IFFCA5 )
ما یک تغییر رنگ اضافی ، FilledVariant ، به Button ، IconButton ، TextButton ، CompactButton و EdgeButton اضافه کرده ایم ( I65FC3 )
ما پارامتر forcedSize را به ImageWithScrimPainter اضافه کرده ایم ، به طوری که پس زمینه های تصویر دکمه اکنون اندازه مؤلفه خود را به طور پیش فرض حفظ می کنند. تنظیم forcedSize = null به جای Painter.instrinsicSize تصویب می کند. ( IC57AF )
ما کلیک طولانی به دکمه ها اضافه کرده ایم ( IB613D )
پشتیبانی طولانی کلیک نیز به IconButton و TextButton اضافه شده است. ( i38891 )
پشتیبانی طولانی کلیک به کارت ها اضافه شده است. ( I305D5 )
ما LocalTextMaxLines ، LocalTextAlign ، LocalTextOverflow به عنوان CompositionLocals به عنوان ترکیبات اضافه کرده ایم و از آنها به عنوان پیش فرض پارامتر در Text استفاده کرده ایم. این ترکیب محلی اکنون می تواند توسط مؤلفه هایی مانند CheckboxButton ، SwitchButton ، RadioButton برای اجرای راهنمایی UX استفاده شود ، اما در صورت لزوم پارامترها را می توان از بین برد. ( IAB841 )
ما برای کمک به پوشش محتوای مؤلفه هایی مانند دکمه ها و کارت ها تا زمان بارگیری داده ها ، Placeholder اضافه کرده ایم. ( i1a532 )
ما IconToggleButtonColors و TextToggleButtonColors را اضافه کرده ایم تا تعویض ToggleButtonColors اکنون حذف شده باشد. ( IE0BF1 )

رفع اشکال

ما Button ، FilledTonalButton ، OutlinedButton ، ChildButton ، CompactButton برای استفاده از CompositionLocals LocalTextMaxLines ، LocalTextAlign ، LocalTextOverflow برای اجرای راهنمایی UX به روز کرده ایم - این پارامترها در صورت لزوم توسط برنامه نویسان بر روی متن می توانند بیش از حد ریخته شوند ( IE51F7 )
ما عرض پیش فرض سکته مغزی LevelIndicator را به 6dp تغییر داده ایم تا آن را از ScrollIndicator که دارای عرض سکته مغزی 4dp است ، متمایز کنیم. ( if6f63 )
ما یک مسئله را در TimeText برطرف کرده ایم تا زاویه های جارو بزرگتر پشتیبانی شود. ( IE489F )
مسئله ای را در هنگام بازآفرینی EdgeButton برطرف کرد. ( i4cdca )
چیدمان های تصحیح شده از دکمه های ضامن تقسیم شده در هنگام تهیه بالشتک محتوای سفارشی. ( IA33D3 )
مقادیر پیشرفت کوچک را تا حداقل عرض خط نشانگر پیشرفت گرد کنید. ( i3bd84 )

نسخه 1.0.0-alpha23

14 مه 2024

androidx.wear.compose:compose-material3:1.0.0-alpha23 منتشر شده است. نسخه 1.0.0-alpha23 شامل این تعهدات است.

تغییرات API

ما API های ToggleButton و RadioButton را به روز کرده ایم به گونه ای که می توان رنگ های غیرفعال را پیکربندی کرد. ( if13a7 )
ما یک CircularProgressIndicator جدید را برای Material3 اضافه کرده ایم. ( ib3bd7 )

رفع اشکال

ما یک اشکال را برطرف کرده ایم که دکمه های قابل انتخاب اعلام شده Double Tap را برای جابجایی در هنگام انتخاب. ( i7ed88 )

نسخه 1.0.0-alpha22

1 مه 2024

androidx.wear.compose:compose-material3:1.0.0-alpha22 منتشر شده است. نسخه 1.0.0-alpha22 شامل این تعهدات است.

تغییرات API

ما Material3 ColorScheme به روز کرده ایم. ( i7b2b8 )
ما سوئیچ Material3 را به روز کرده ایم - و همچنین برخی از تغییرات رنگی ، اکنون کنه مطابقت دارد که برای کادر انتخاب استفاده می شود. ( ICAC7B )

رفع اشکال

برای استفاده از اصلاح کننده جدید rotaryScrollable تمام نسخه های نمایشی ادغام را به روز کنید. ( I25090 )

نسخه 1.0.0-alpha21

17 آوریل 2024

androidx.wear.compose:compose-material3:1.0.0-alpha21 منتشر شده است. نسخه 1.0.0-alpha21 شامل این تعهدات است.

این نسخه به دلیل مسئله فنی در نسخه قبلی که منجر به از دست دادن کوزه های منبع شد ، آغاز شد. در این نسخه هیچ تعهد جدیدی وجود ندارد.

نسخه 1.0.0-alpha20

3 آوریل 2024

androidx.wear.compose:compose-material3:1.0.0-alpha20 منتشر شده است. نسخه 1.0.0-alpha20 شامل این تعهدات است.

رفع اشکال

ما برای کنتراست ، آلفا حالت فشرده شده و متمرکز را تنظیم کرده ایم. ( i59f0a )
We have added spacing between primary and secondary labels in Button , ToggleButton and RadioButton , following the latest changes to typography styles and line heights. ( i2c0ba )

نسخه 1.0.0-alpha19

6 مارس 2024

androidx.wear.compose:compose-material3:1.0.0-alpha19 منتشر شده است. نسخه 1.0.0-alpha19 شامل این تعهدات است.

تغییرات API

ما به کتابخانه Wear Compose Material3 TimeText اضافه کرده ایم. این مؤلفه زمان فعلی (و وضعیت اضافی) را در بالای صفحه نشان می دهد. API جدید و مختصر Materive 3 از تکثیر بین محتوای خطی و منحنی جلوگیری می کند. ( i4d7c3 )
ما نام پارامترها را از onSelected به onSelect برای RadioButton به روز کرده ایم. ( i1a971 )
Tokenize RadioButton و SplitRadioButton و همچنین روش های موجود برای کاهش میزان جستجوی CompositionLocal با اضافه کردن موارد ذخیره شده از رنگ ها ، و ساخت روش های RadioButtonColors و SplitRadioButtonColors داخلی. ( I02B33 )

نسخه 1.0.0-alpha18

21 فوریه 2024

androidx.wear.compose:compose-material3:1.0.0-alpha18 منتشر شده است. نسخه 1.0.0-alpha18 شامل این تعهدات است.

تغییرات API

ما با ایجاد نمونه های ذخیره شده در داخل و کاهش استفاده از CompositionLocal ، الگوی پیش فرض را برای CardColors ، ToggleButtonColors و SplitToggleButtonColors اصلاح کرده ایم. ( if3fec )

نسخه 1.0.0-alpha17

7 فوریه 2024

androidx.wear.compose:compose-material3:1.0.0-alpha17 منتشر شده است. نسخه 1.0.0-alpha17 شامل این تعهدات است.

تغییرات API

ما API دکمه را به روز کرده ایم تا به طور پیش فرض از buttonColors استفاده کنیم و کپی filledButtonColors حذف کنیم. ( i4fe3b )
ما با ایجاد یک نمونه ذخیره شده در داخل و کاهش استفاده از CompositionLocal ، الگوهای پیش فرض را برای ButtonColors ، IconButtonColors و TextButtonColors اصلاح کرده ایم. ( i5f51c )
ما در کلاسهای رنگی خاص مؤلفه و روشهای دسترسی مشخص در داخل کلاسهای رنگی به عنوان داخلی ، سربار rememberUpdatedState را حذف کرده ایم. ( IF6571 )

رفع اشکال

ما برای استفاده از Modifier.node Modifier.minimumInteractiveComponentSize به روز کرده ایم. ( IBA6B7 )

نسخه 1.0.0-alpha16

24 ژانویه 2024

androidx.wear.compose:compose-material3:1.0.0-alpha16 منتشر شده است. نسخه 1.0.0-alpha16 شامل این تعهدات است.

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

ما CompactButton اضافه کرده ایم ، که می تواند از همان رنگ های پر ، پر شده و پر شده به عنوان دکمه استفاده کند. ( I05DF0 )

تغییرات API

ما RadioButton / SplitRadioButton به عنوان ظروف برای کنترل انتخاب ، مانند کنترل رادیو اضافه کرده ایم. این متفاوت از ToggleButton موجود است که RadioButton قابل انتخاب است (و در یک گروه انتخاب عمل می کند) در حالی که ToggleButton قابل جابجایی است (و مستقل است). ( i61275 )
ما در حال حذف LocalContentAlpha از کتابخانه Wear Compose Material3 برای سازگاری با کتابخانه Compose Material3 هستیم. ( i49a0a )
مواد سایش و سایش مواد 3 اجزای در معرض MutableInteractionSource در API خود به روز شده اند تا در حال حاضر یک MutableInteractionSource قابل تهی را که به طور پیش فرض برای تهی است ، در معرض دید قرار دهند. There are no semantic changes here: passing null means that you do not wish to hoist the MutableInteractionSource , and it will be created inside the component if needed. Changing to null allows for some components to never allocate a MutableInteractionSource , and allows for other components to only lazily create an instance when they need to, which improves performance across these components. If you are not using the MutableInteractionSource you pass to these components, it is recommended that you pass null instead. It is also recommended that you make similar changes in your own components. ( Ib90fc , b/298048146 )
Adds new ripple API in wear:compose-material and wear:compose-material3 libraries which replaces the deprecated rememberRipple . Also adds a temporary CompositionLocal , LocalUseFallbackRippleImplementation , to revert Material components to using the deprecated rememberRipple/RippleTheme APIs. This will be removed in the next stable release, and is only intended to be a temporary migration aid for cases where you are providing a custom RippleTheme . See developer.android.com for migration information and more background information behind this change. ( af92b21 )
We have made minor improvements to the HorizontalPageIndicator api and its documentation. ( I60efc )
We have updated ColorScheme to be immutable, making individual color updates less efficient, but making more common usage of colors more efficient. The reasoning behind this change is that the majority of apps wouldn't have updating individual colors as a main use case. This is still possible but it will recompose more than before, in turn we significantly decrease the amount of state subscriptions through all of material code and will impact initialization and runtime cost of more standard use cases. ( Ibc2d6 )
Updated ToggleButton and SplitToggleButton APIs to allow disabled colors to be customized. In addition, Material Design tokens are now used for color and typography values. ( If087c )
Updated Button image background colors to use Material Design tokens. ( Iba215 )
We have changed the Checkbox , Switch and RadioButton components to be display-only, by removing the click handling. These components are expected to be used in (Split)ToggleButton which handles the click, so the components are now more clearly indicated as display-only (and are not intended for standalone use on Wear). ( I2322e )

رفع اشکال

We have added tokens for motion values of durations and easings in Wear Compose Material 3. ( I437cd )
We have fixed a bug in the ToggleButton , SplitToggleButton , Checkbox , Switch and RadioButton so that accessibility announcements are not repeated (previously, semantic roles were duplicated). ( Ica281 )
We have removed the materialcore layer for CompactButton to improve performance. ( 7902858 )

نسخه 1.0.0-alpha15

15 نوامبر 2023

androidx.wear.compose:compose-material3:1.0.0-alpha15 is released. نسخه 1.0.0-alpha15 شامل این تعهدات است.

تغییرات API

We have renamed the Foundation level SwipeToDismissBox to BasicSwipeToDismissBox . This makes the distinction clearer between the Foundation level component and the Material3 level SwipeToDismissBox . The latter pulls colors from the MaterialTheme to be used in scrims and delegates the remaining implementation to the BasicSwipeToDismissBox . ( Ibecfc )

رفع اشکال

We have removed the material-core layer for Material3 Button to improve performance. ( I55555 )

Version 1.0.0-alpha14

18 اکتبر 2023

androidx.wear.compose:compose-material3:1.0.0-alpha14 is released. نسخه 1.0.0-alpha14 شامل این تعهدات است.

تغییرات API

We have removed the indicatorStyle parameter from the Material3 HorizontalPageIndicator - instead, it will follow the device screen shape (linear or round). ( I83728 )
We have separated the colors for SplitToggleButton from those for ToggleButton , by adding a new SplitToggleButtonColors class. ( I78bee )

نسخه 1.0.0-alpha13

4 اکتبر 2023

androidx.wear.compose:compose-material3:1.0.0-alpha13 is released. نسخه 1.0.0-alpha13 شامل این تعهدات است.

تغییرات API

We have added an optional Subtitle field to TitleCard . ( Ifc45a )
We have added Material Design color tokens for TextButton . ( I769dc )

نسخه 1.0.0-alpha12

20 سپتامبر 2023

androidx.wear.compose:compose-material3:1.0.0-alpha12 is released. Version 1.0.0-alpha12 contains these commits.

تغییرات API

We have updated IconButton to use Material Design tokens. ( I3f137 )
We have updated IconToggleButton to use Material Design tokens. ( I7d263 )
We have made public the constructors of CheckboxColors , RadioButtonColors , SwitchColors . ( I82b73 )

Version 1.0.0-alpha11

6 سپتامبر 2023

androidx.wear.compose:compose-material3:1.0.0-alpha11 is released. نسخه 1.0.0-alpha11 شامل این تعهدات است.

رفع اشکال

We update updated the typography for Material3 Cards to TitleMedium . ( I597bd )
We have updated the typography and alignment for our Material3 ListHeader and ListSubheader . ( Ib5ceb )

Version 1.0.0-alpha10

23 آگوست 2023

androidx.wear.compose:compose-material3:1.0.0-alpha10 is released. نسخه 1.0.0-alpha10 شامل این تعهدات است.

New Features

Add HorizontalPageIndicator in Wear Material3 library. ( Ifee99 )

تغییرات API

Update Buttons code to use Material3 design tokens. ( I92fe4 )
Declaring Wear Material 3 Stepper and Slider APIs as experimental as the details of the user interface are still being finalized. ( I84d54 )
We have removed the ExtraSmall sizes from the round TextButton and TextToggleButton as that size only applies to the IconButton . ( Ibc7d5 )

رفع اشکال

We have updated the guidance on typography for TextToggleButton to use LabelLarge for LargeButtonSize ( Ib10fa )
We have updated the guidance on typography for TextButton to use LabelLarge for LargeButtonSize ( I8f3a7 )
We have set the Card's minimum touch target to be 48dp for accessibility. ( Ieb9b1 )
Add AppCard with image demo, removing AppCard with Background demo ( Id735f )
Fix a bug in round buttons where modifiers were not chained correctly. ( I5e162 )

نسخه 1.0.0-alpha09

9 آگوست 2023

androidx.wear.compose:compose-material3:1.0.0-alpha09 is released. نسخه 1.0.0-alpha09 شامل این تعهدات است.

New Features

We have added ToggleButton for material3 ( I6bed6 )

تغییرات API

We have turned on the FloatRange annotation as API constraints , which were previously stated in comments. ( Icb401 )
We have updated the typography for Wear Material3 to adhere to the latest Material3 guidelines. ( I1bad6 )

رفع اشکال

We have updated the colors for Button , IconButton and TextButton in line with Material3 design. ( Ib2495 )
We have fixed checkbox tick visibility in disabled states. ( Ib25bf )

Version 1.0.0-alpha08

26 جولای 2023

androidx.wear.compose:compose-material3:1.0.0-alpha08 is released. نسخه 1.0.0-alpha08 شامل این تعهدات است.

New Features

We have added the following selection controls for Material3 - Switch , Checkbox , RadioButton . ( Ib918c )
We have added IconToggleButton and TextToggleButton to Material3, a circular toggle button with a single slot for icon and text respectively. For different sizes of ToggleButton , we recommend using Modifier.touchTargetAwareSize with the sizes provided in respective toggle buttons. ( I9f015 )
We have added ListHeader and ListSubheader to our Material3 components. ( Ibaefe )
We have added Material3 SwipeToDismissBox , which calls the new Foundation SwipeToDismissBox and supplies default color values from its theme. ( I275fb )
We have added the Material3 InlineSlider to Wear Compose. It allows users to make a selection from a range of values. The range of selections is shown as a bar between the minimum and maximum values of the range, from which users may select a single value. InlineSlider is ideal for adjusting settings such as volume or brightness. ( I7085f )

تغییرات API

We have updated the Shapes in Wear Material 3 theme to use RoundedCornerShape based instead of Shape. ( Idb133 )
We have made the height constants for Button public ( Idbfde )
Updated API files to annotate compatibility suppression ( I8e87a , b/287516207 )
We have updated InlineSliderColors in Wear Compose Material 3 to have public constructor and public properties. ( I6b632 )
We have updated all color classes in Wear Compose Material 3 to have public constructors and public properties. ( I17702 )
We have made Button horizontal and vertical padding constants public. ( Ieeaf7 )

رفع اشکال

Button will now adjust its height to accommodate content that has grown due to large fonts for accessibility, when required ( Iaf302 )
We have updated a number of Button demos to address accessibility issues. ( I61ce9 )
Stepper and InlineSlider now support repeated clicks on long press so that you can quickly increase/decrease value of Stepper and InlineSlider by holding the + or - buttons ( I27359 )

نسخه 1.0.0-alpha07

21 ژوئن 2023

androidx.wear.compose:compose-material3:1.0.0-alpha07 is released. Version 1.0.0-alpha07 contains these commits.

New Features

We have added the Stepper component to our Compose for Wear OS Material 3 library. This is similar to the previous Material version, but omits range semantics by default, following developer feedback. We provide Modifier.rangeSemantics the cases where range semantics are required. ( Ic39fd )
We have added curvedText to our Compose for Wear OS Material 3 library. ( Ia8ae3 )

رفع اشکال

We have update wear.compose.foundation to be an API dependency of wear.compose.material3 ( I72004 , b/285404743 )

نسخه 1.0.0-alpha06

7 ژوئن 2023

androidx.wear.compose:compose-material3:1.0.0-alpha06 is released. Version 1.0.0-alpha06 contains these commits.

رفع اشکال

We have updated TextButton to use the toDisabledColor extension function for correct disabled alpha values. ( I814c8 )

Version 1.0.0-alpha05

May 24, 2023

androidx.wear.compose:compose-material3:1.0.0-alpha05 is released. نسخه 1.0.0-alpha05 شامل این تعهدات است.

New Features

We have added TextButton to Material3, a circular button with a single slot for text. For different sizes of TextButton , we recommend using Modifier.touchTargetAwareSize and ExtraSmallButtonSize , SmallButtonSize , DefaultButtonSize and LargeButtonSizeIcon provided in TextButtonDefaults . The default TextButton has no border and a transparent background for low emphasis actions. For actions that require high emphasis, use filledTextButtonColors ; for a medium-emphasis, outlined TextButton , set the border to ButtonDefaults.outlinedButtonBorder ; for a middle ground between outlined and filled, use filledTonalTextButtonColors . ( I667e4 )
We have added Card , OutlinedCard , AppCard and TitleCard into the Wear Compose Material3 library. AppCard and TitleCard can also be given the outlined appearance using CardDefaults.outlinedCardColors and CardDefaults.outlinedCardBorder ( I80e72 )

تغییرات API

We have moved the Button label parameter to the end to support trailing lambda syntax and removed the role parameter (as this can be overridden using Modifier.semantics ). ButtonColors constructors are now public. ( Ie1b6d )

Version 1.0.0-alpha04

10 مه 2023

androidx.wear.compose:compose-material3:1.0.0-alpha04 is released. نسخه 1.0.0-alpha04 شامل این تعهدات است.

New Features

We have added IconButton to Material3, a circular button with a single slot for icon/image. There are four variations: IconButton , FilledIconButton , FilledTonalIconButton and OutlinedIconButton . For different sizes of IconButton , we recommend using Modifier.touchTargetAwareSize and ExtraSmallButtonSize , SmallButtonSize , DefaultButtonSize and LargeButtonSizeIcon provided in IconButtonDefaults . We also provide IconButtonDefaults.iconSizeFor to determine the recommended icon size for a given button size. ( I721d4 )

Version 1.0.0-alpha03

19 آوریل 2023

androidx.wear.compose:compose-material3:1.0.0-alpha03 is released. Version 1.0.0-alpha03 contains these commits.

تغییرات API

We have added the Material 3 Button component - this is our stadium-shaped button and was formerly named Chip in the Wear Compose Material library (it has been renamed to Button for consistency with the Compose Material 3 library). The default Button has a filled background and there are button variations for FilledTonal (muted background), Outlined (transparent with a thin border) and Child (transparent background and no border, used for supplementary actions with the lowest amount of prominence). Round buttons for simple icon and text content will follow in a future release.( Ia6942 )

Version 1.0.0-alpha02

5 آوریل 2023

androidx.wear.compose:compose-material3:1.0.0-alpha02 is released. نسخه 1.0.0-alpha02 شامل این تعهدات است.

رفع اشکال

We have added a DefaultTextStyle to Wear Compose Material 3 which defaults the PlatformTextStyle.includeFontPadding to true (the current setting). This will allow us to synchronize turning off font padding by default with the Compose libraries in the future (see Fix font padding in Compose for background ). ( I7e461 )

Version 1.0.0-alpha01

22 مارس 2023

androidx.wear.compose:compose-material3:1.0.0-alpha01 is released. Version 1.0.0-alpha01 contains these commits.

New Features

Material 3 is the next evolution of Material Design and includes updated theming and redesigned components. Material 3 on Wear Compose is designed to be cohesive with the Material 3 Compose library on Android. This first alpha release contains early, functional implementations of the following:
- Material theme - configures the color scheme, typography and shapes consistently across components in the library. The Material3 theme has revised colors which support accessible contrast. ( I84005 )
- Text/Icon - building blocks for Wear Compose apps ( I8e06a )
We will continue to develop Wear Material ( androidx.wear.compose:compose-material ) and Wear Material 3 ( androidx.wear.compose:compose-material3 ) in parallel. Future material3 releases will extend the widget set to include other familiar components from Compose for Wear OS, such as buttons, pickers, and sliders.
The Wear Material and Wear Material 3 libraries are mutually exclusive and should not be mixed in the same app, primarily because they reference different themes which would lead to unexpected inconsistencies.

Wear Compose Material 3

مرجع API
androidx.wear.compose.material3

Write Jetpack Compose applications for Wear OS devices by providing functionality to support different device sizes and navigation gestures using the Material 3 Expressive design system.

Latest Update	انتشار پایدار	کاندید را آزاد کنید	نسخه بتا	Alpha Release
27 آگوست 2025	1.5.0	-	-	-

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

To add a dependency on Wear, you must add the Google Maven repository to your project. برای اطلاعات بیشتر، مخزن Maven Google را بخوانید.

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

شیار

dependencies {
    implementation "androidx.wear.compose:compose-foundation:1.5.0"

    // For Wear Material Design UX guidelines and specifications
    implementation "androidx.wear.compose:compose-material3:1.5.0"

    // For integration between Wear Compose and Androidx Navigation libraries
    implementation "androidx.wear.compose:compose-navigation:1.5.0"

    // For Wear preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.5.0")
    
    // NOTE: DO NOT INCLUDE dependencies on androidx.wear.compose:compose-material
    // or androidx.compose.material:material.
    // androidx.wear.compose:compose-material3 is designed as a replacement,
    // not an addition, to both of these other libraries.
    // If there are features from that you feel are missing from
    // androidx.wear.compose:compose-material3, please raise a bug to let us know.
}

کاتلین

dependencies {
    implementation("androidx.wear.compose:compose-foundation:1.5.0")

    // For Wear Material Design UX guidelines and specifications
    implementation("androidx.wear.compose:compose-material3:1.5.0")

    // For integration between Wear Compose and Androidx Navigation libraries
    implementation("androidx.wear.compose:compose-navigation:1.5.0")
    
    // For Wear preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.5.0")

    // NOTE: DO NOT INCLUDE dependencies on androidx.wear.compose:compose-material
    // or androidx.compose.material:material.
    // androidx.wear.compose:compose-material3 is designed as a replacement,
    // not an addition, to both of these other libraries.
    // If there are features from that you feel are missing from
    // androidx.wear.compose:compose-material3, please raise a bug to let us know.
}

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

بازخورد

بازخورد شما به بهتر شدن Jetpack کمک می کند. اگر مسائل جدیدی کشف کردید یا ایده هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد کتابخانه جدید، به مسائل موجود در این کتابخانه نگاهی بیندازید. You can add your vote to an existing issue by clicking the star button.

یک شماره جدید ایجاد کنید

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

Wear Compose Material3 Version 1.5

نسخه 1.5.0

27 آگوست 2025

androidx.wear.compose:compose-*:1.5.0 is released. Version 1.5.0 contains these commits .

Important changes since 1.4.0

First release of the Wear Compose Material 3 library, which supports the new Material 3 Expressive design system. This release includes:

Updated MaterialTheme and dynamic color theming.
New AppScaffold, ScreenScaffold , HorizontalPagerScaffold , and VerticalPagerScaffold components to lay out the structure of the screen and coordinate ScrollIndicator , TimeText , HorizontalPageIndicator , and VerticalPageIndicator animations.
Shape morphing IconButton , TextButton , IconToggleButton , and TextToggleButton , with variations that animate when pressed or checked.
EdgeButton , which has a special shape designed for the bottom of the screen.
ButtonGroup implements an expressive group of buttons, in a row that shape-morphs when touched.
AlertDialog and ConfirmationDialog with variations for additional dialog content.
TimePicker and DatePicker components.
Progress indicators include CircularProgressIndicator (with segmented variation), ArcProgressIndicator , and LinearProgressIndicator .

In addition, Wear Compose Foundation 1.5.0 includes the following:

TransformingLazyColumn , a lazy, vertically scrolling list that supports scaling and morphing animations.
Support for paging in Wear Compose Foundation with HorizontalPager and VerticalPager .
Hierarchical Focus Groups - used to annotate composables in an application to keep track of the active part of the composition and coordinate focus.

Read about more about ( Material 3 Expressive for Wear OS )

Version 1.5.0-rc02

13 آگوست 2025

androidx.wear.compose:compose-*:1.5.0-rc02 is released. Version 1.5.0-rc02 contains these commits .

رفع اشکال

Fixed a bug in TimePicker where long, internationalised strings for the period (AM/PM) could break the layout. ( I0fa81 )

Version 1.5.0-rc01

30 جولای 2025

androidx.wear.compose:compose-*:1.5.0-rc01 is released. Version 1.5.0-rc01 contains these commits .

رفع اشکال

TimePicker is now fully driven by the user's locale, using DateFormat.getBestDateTimePattern to determine the order and content of its pickers and separators. This fixes incorrect column ordering for CJK languages, resolves RTL layout issues in languages like Arabic, uses localized separators, and supports both 0-11 and 1-12 hour formats based on the locale ( I5d543 )
DatePicker now displays a numeric month in some locales, such as CJK, to avoid mixing numeric and linguistic formats (eg, 2025 | 07 | 02 instead of 2025 | 7月 | 02). This change applies a heuristic that checks if the locale uses linguistic suffixes for the year and, if so, switches the month format from textual (MMM) to numeric (MM) for consistency. ( Ia93fe )
The vertical space for the heading in the Picker component is now constant, preventing a visible shift when a picker column is selected, especially in Talkback mode. ( I7f8b7 )
Fixed an accessibility bug caused by HorizontalPageIndicator and VerticalPageIndicator being drawn full screen. The page indicators are no longer full-screen, and will be positioned automatically when used with HorizontalPagerScaffold or VerticalPagerScaffold . When not using a pager scaffold, specify the alignment explicitly using modifier = Modifier.align(Alignment.BottomCenter) with HorizontalPageIndicator and modifier =Modifier.align(Alignment.CenterEnd) with VerticalPageIndicator . ( I3a0ad )
The swipe direction in SwipeToReveal is now consistent for both LTR and RTL LayoutDirections . ( I6d427 )
Reinstated SwipeToReveal vertical centering for actions. If hasPartiallyRevealedState = true , RevealState should be reset to RevealValue.Covered by the caller when scrolling occurs. ( I6473d )
SwipeDismissableNavHost now correctly clips content for API 36 onwards. ( Ib9a44 )

Version 1.5.0-beta06

16 جولای 2025

androidx.wear.compose:compose-*:1.5.0-beta06 is released. Version 1.5.0-beta06 contains these commits .

رفع اشکال

Fix EdgeButton animation when LazyColumn or ScalingLazyColumn have reverseLayout = true . ( I46a1a )
Fixed a bug in ScreenScaffold where touch-to-explore was not working under Talkback if a ScrollIndicator/PageIndicator was provided. ( I6dcee )
TransformingLazyColumn now allows for custom morphing from TransformationSpec by reading itemHeight value provided by TransformationSpec in the background painter. ( I6a599 )
Animated enabled/disabled color transitions for IconButton , to be consistent with IconToggleButton . ( Ife10a )
Removed the minimum section clamping in CircularProgressIndicator to avoid a noticeable jump to the minimum dot size when animating. As part of this change, the targetProgress parameter in drawCircularProgressIndicator is now unused. ( I33309 )
Picker now has the semantic role ValuePicker which can be used by screen readers to make pickers more accessible. Picker also has updated accessibility click labels which differentiate between adjusting the value in read-only mode and selecting the current value otherwise. ( I33309 )

Version 1.5.0-beta05

2 ژوئیه 2025

androidx.wear.compose:compose-*:1.5.0-beta05 is released. Version 1.5.0-beta05 contains these commits .

رفع اشکال

Updated the documentation to clarify usage of Modifier.edgeSwipeToDismiss ( I78cb5 )
Addressed bug where multiple revealed items could be shown with SwipeToReveal in lazy lists ( I1d4f6 )
Container shapes in TransformingLazyColumn are now scaled, in order to avoid clipping the contents. ( I9221a )
The TimePicker and DatePicker label for hour/minute/second or year/month/day now has heading semantics for screen readers ( I77d8b )
Removed the pause between loops in the indeterminate CircularProgressIndicator ( Iaf0bb )
Fixed an animation bug in TransformingLazyColumn when items are removed. ( I73034 )
Corrected handling of anchor items in TransformingLazyColumn when items are removed. ( I841a8 )
PickerGroup now animates the Pickers horizontally when autocentering is turned on and the selected (centered) picker is changed. ( Ic82c4 )

Version 1.5.0-beta04

18 ژوئن 2025

androidx.wear.compose:compose-*:1.5.0-beta04 is released. Version 1.5.0-beta04 contains these commits .

رفع اشکال

Fix layout bug in TransformingLazyColumn , where content that fits within the screen is now aligned correctly from the top of the screen ( I80115 )
Fixed an issue with TransformingLazyColumn where the bottom item was incorrectly scaled when scrolling to the very bottom of a list with an EdgeButton . The scroll progress now follows a gradient descent when restoring the layout. ( Iea375 )
TransformingLazyColumn now reads the item height inside the background painter, which allows custom TransformationSpecs to implement morphing. ( I022f0 )
SwipeToReveal now vertically centers the revealed actions correctly. ( I4419b )
Fixed a bug in SwipeToReveal that prevented it working correctly with swipe-to-dismiss if both views and compose were in use on the screen. ( I5dc0e )
Fixed a bug where SwipeToReveal actions were drawn with a vertical offset when scrolling. ( I29444 )
AlertDialog , ConfirmationDialog , OpenOnPhoneDialog and SwipeToReveal now round up paddings and sizes that are calculated as a percentage of the screen size. ( I76367 )
ButtonDefaults.outlinedButtonBorder now updates following enabled/disabled state changes size( If2ddd )
Fixed a bug in EdgeButton height that occurred on complex screens with Pager and ScreenScaffold . ( I946e3 )
Fixed a race condition that could cause Placeholder animations to stop. ( I53530 )
Improved HorizontalPageIndicator and VerticalPageIndicator performance by drawing to Canvas. ( Ifae1e )
Refined the shape of EdgeButton to smooth the transitions between the ellipsis and circles that make up the outline. ( I7721e )
Fixed a bug in LevelIndicator that caused animations to stop, due to unnecessary recompositions. ( I45d08 )

Version 1.5.0-beta03

June 4, 2025

androidx.wear.compose:compose-*:1.5.0-beta03 is released. Version 1.5.0-beta03 contains these commits .

تغییرات API

OpenOnPhoneDialog now announces only the message text under TalkBack, and skips the icon semantics. The OpenOnPhoneDialogDefaults have been updated to remove the iconContentDescription and the contentDescription parameter from icon() . Also, ConfirmationDialogDefaults now has modifier parameters on SuccessIcon and FailureIcon composables. ( Id2ae2 )

رفع اشکال

Changed the order in which we apply the effect of SurfaceTransformation parameters. Before, the transformations applied to Wear Material3 components were done as follows: background painter, container transformation, content transformation. Now, the first 2 are inverted, and we apply any passed in modifier between them, so it is affected by container transformations. This fixes cases like using a placeholder shimmer effect with elements in a TLC using the transformation parameter. ( I786cf )
RevealState.Saver was added to be used to restore the state of SwipeToReveal when activity or process is recreated. rememberRevealState function now uses this Saver by default. ( Ie0ecb )
SwipeToReveal primary and secondary actions buttons should default to ButtonDefault.Height (fixed bug where these were filling the maximum height for taller buttons). ( Ibfba1 )
Changed SwipeToReveal to reset the last component interacted with, when the swipe right gesture is performed. ( Ia8450 )
SwipeToReveal was changed to settle on the Revealing state when the end position of the swipe is in between the revealing and revealed anchors, and is closer to the Revealing anchor. ( If4458 )
Now ButtonGroup 's content is properly inverted in a RTL layout ( Ib378d )
AnimatedText now supports RTL text direction ( I4533c )
TransformingLazyColumn now resizes items correctly when the bottom item is removed ( Idacab )
TransformingLazyColumn now makes just one measuring pass, which improves performance by reducing frame times. ( I501a1 )

Version 1.5.0-beta02

20 مه 2025

androidx.wear.compose:compose-*:1.5.0-beta02 is released. Version 1.5.0-beta02 contains these commits .

رفع اشکال

Updated baseline profiles for foundation, material & material3 libraries. ( I53f06 )
Fixed a bug in TransformingLazyColumn , where items resized when the bottom item was removed. ( Idacab )
Fixed a bug with TransformingLazyColumn , when the list got stuck at the top or bottom of the list. ( I49d00 )
OpenOnPhoneDialog under TalkBack should announce the curved text, rather than the icon content description. ( I4efe8 )
Fixed a bug in SwipeToReveal that would report the wrong anchor in RevealState.currentValue when hasPartiallyRevealedState is set to false. ( I9c7cf )
SwipeToReveal undo buttons are now ButtonDefaults.Height by default. ( I1f6c8 )
BasicSwipeToDismissBox performance has been improved by eliminating use of Canvas for drawing scrims. ( I68f2c )
Fixed an accessibility bug in Slider, where the announced percentage did not match the value after updates ( I91146 )
Fixed a bug on placeholderShimmer implementation. ( Iee39b
TransformingLazyColumn performance has been improved, by optimizing ScrollProgress calculation by 30%. ( I4c4cb )

Version 1.5.0-beta01

7 مه 2025

androidx.wear.compose:compose-*:1.5.0-beta01 is released. Version 1.5.0-beta01 contains these commits .

The 1.5.0-beta01 release of Compose for Wear OS indicates that this release of the library is feature complete and the API is locked (except where marked as experimental).

Wear Compose 1.5.0-beta01 includes the Wear Compose Material3 library, which supports the new UI design system called Material 3 Expressive. It is recommended to upgrade from Material to Material3 to embrace the new visual design in apps, and to benefit from the new components as follows:

MaterialTheme for updated and extended color schemes, typography, and shapes to bring both depth and variety to your designs.
Dynamic Color Theming which automatically generates a color scheme for your app to match the watch face colors.
New components automatically adapt to larger screen sizes by default
Shape Morphing - round button components like IconButton , TextButton , IconToggleButton and TextToggleButton support variations that animate when pressed or checked.
EdgeButton - a new edge-hugging button with a special shape designed for the bottom of the screen.
Scaffolds - introducing AppScaffold and ScreenScaffold to lay out the structure of the screen and coordinate ScrollIndicator and TimeText animations.
Buttons - numerous stadium-shaped buttons are supported with flexible, single-slot containers and multi-slot variations for buttons with icons and labels. CheckboxButton and SwitchButton are provided when toggle buttons are needed, whilst RadioButton is the available selection button ('Split' variations of the toggle and selection buttons are also provided).
ButtonGroup - implements an expressive group of buttons in a row that shape-morph when touched.
AlertDialog variations support ok/cancel buttons or an EdgeButton .
ConfirmationDialog is available to display a message with a timeout, supporting special animations for success, failure and open-on-phone variations.
Pickers - TimePicker and DatePicker variations are supported as well as the Picker and PickerGroup components for building your own picker screens.
ProgressIndicators - circular, and linear progress indicators are supported (the CircularProgressIndicator has segmented and indeterminate variations).
Cards - a number of card variations are available, including TitleCard which offers specific layouts for cards with title, time, subtitle or content slots. TitleCard can also be given an image background to reinforce the meaning of the information in a card.
Pagers - HorizontalPagerScaffold , VerticalPagerScaffold and AnimatedPage components coordinate HorizontalPageIndicator and VerticalPagerIndicator animations. HorizontalPager and VerticalPager are released in the Wear Compose Foundation library.
Placeholders - draws a skeleton shape over a component, for situations where no provisional content is available.
Sliders and Steppers - both sliders and steppers allow users to make a selection from a range of values. Sliders are more compact and can be segmented, whereas Stepper is a full screen component typically paired with a StepperLevelIndicator .
SwipeToReveal - used to add additional actions to a composable when it is swiped right-to-left.

In addition, Wear Compose Foundation 1.5.0-beta01 includes these new components:

TransformingLazyColumn - a lazy, vertically scrolling list the supports scaling and morphing animations
Hierarchical Focus Groups - used to annotate composables in an application, to keep track of the active part of the composition and coordinate focus.
Pagers - HorizontalPager and VerticalPager components, built on the Compose Foundation components with Wear-specific enhancements to improve performance and adherence to Wear OS guidelines.

تغییرات API

Updated the Hierarchical Focus API - renamed Modifier.hierarchicalFocus to Modifier.hierarchicalFocusGroup and removed the callback parameter; removed the overload of Modifier.hierarchicalFocusRequester with a FocusRequester parameter; created a new CompositionLocal , LocalScreenIsActive so that components can inform and check which screen is the active one. ( I5ff7c ).
Deprecated SwipeToReveal from Wear Compose Foundation in favor of SwipeToReveal APIs in Wear Compose Material and Wear Compose Material3. Please replace Wear Foundation SwipeToReveal imports with Wear Compose Material/ Wear Compose Material3 imports to continue using the APIs. ( Ia147d ).
Wear Compose Material3 SwipeToReveal dependencies on Foundation were moved to the material3 package, eg RevealValue , RevealDirection , RevealActionType , RevealState , rememberRevealState . Developers should change their imports of these classes and functions from androidx.wear.compose.foundation to androidx.wear.compose.material3 . ( I640e6 ).
Updated the Wear Compose Material3 SwipeToReveal API as follows: added primaryAction , onFullSwipe , secondaryAction , undoPrimaryAction , undoSecondaryAction and hasPartiallyRevealedState parameters to the SwipeToReveal composable; removed the ability to customize positionalThreshold and animationSpec from RevealState ; removed lastActionType , revealThreshold and width from RevealState ; changed the RevealState constructor to accept a RevealDirection instead of anchors; removed createRevealAnchors , anchors, and bidirectionalAnchors functions; SwipeToRevealScope functions primaryAction , secondaryAction , undoPrimaryAction and undoSecondaryAction were renamed to PrimaryActionButton , SecondaryActionButton , UndoActionButton and made into Composable functions; marked RevealActionType as internal. ( I885d0 ).
Further updated SwipeToReveal API as follows: renamed onFullSwipe to onSwipePrimaryAction ; renamed SwipeToRevealNonAnchoredSample to indicate the use of the hasPartiallyRevealedState parameter; removed actionButtonHeight , since the default is the Button's default height and the larger height can be set using a modifier; removed the SmallActionButtonHeight from SwipeToRevealDefaults ; made the value parameter in RevealValue and RevealDirection constructors private. ( I465ce ).

رفع اشکال

Fixed ScreenScaffold 's EdgeButton handling so that, after a TransformingLazyColumn item is removed, the EdgeButton is animated into place. ( I6d366 ).
Updated Wear Compose dependencies on Compose libraries to version 1.8.0. ( I2ef3f ).
Updated the motion of the indeterminate CircularProgressIndicator so that it no longer regresses temporarily. ( Ieddb1 ).
Fixed a SwipeDismissableNavHost bug - the focus was not switching correctly after swiping back, causing rotary input to fail (this was for API 36+, which uses predictive back). ( Ieddb1 ).
Amended documentation for the Hierarchical Focus API ( Idf2ff ).
Updated the documentation for Button and Card to state how containerPainter and disabledContainerPainter override containerColor and disabledContainerColor ( I4a453 ).
Reverted a change to TimeText in the previous release which moved the BroadcastReceiver to a worker thread, because it caused issues for apps that manage their own threading during navigation. ( I34d02 ).
Updated the Picker samples to remove unnecessary remember calls and instead use rememberUpdatedState in Picker to remember the latest contentDescription lambda function. ( Icb5b1 ).
Updated text styles in TimePicker and DatePicker so that font changes no longer result in truncation. ( I26194 ).
ListHeader and ListSubHeader now default text alignment to center-aligned and start-aligned respectively. ( I78339 ).
Updated Foundation and Material Swipe to Reveal samples and demos to announce custom accessibility actions (the custom actions must be added as semantics on the content, not on the SwipeToReveal composable itself). ( Ie92a3 ).
Updated the default MaxLines set on the EdgeButton content according to its size - it is now 1 for extra small, 2 for small and medium, and 3 for large. ( Ie35f6 ).
Simplified LocalReduceMotion so that the observer is only registered once, to improve performance. ( Ib1979 ).
Minimized the number of redraws in ScrollIndicator , to improve performance. ( Ia7a67 ).
Fixed a bug in TransformingLazyColumn , where the top visible item in the list did not scale correctly when EdgeButton achieved its full height. ( I30580 ).

Wear Compose Material3 Version 1.0

Version 1.0.0-alpha37

23 آوریل 2025

androidx.wear.compose:compose-material3:1.0.0-alpha37 is released. Version 1.0.0-alpha37 contains these commits .

تغییرات API

Removed scrollTransform from the public API surface. Use the combination of transformedHeight and graphicsLayer modifiers if you need to get the same functionality. ( Ie181d )
Replaced ImageButton and ImageCard composables with Button and Card/TitleCard overloads respectively. Renamed imageButtonColors to buttonWithContainerPainterColors and imageCardColors to cardWithContainerPainterColors . Added public ButtonDefaults.scrimBrush and CardDefaults.scrimBrush . Renamed button imageBackgroundGradientStartColor and imageBackgroundGradientEndColor to scrimGradientStartColor and scrimGradientEndColor . Renamed CardDefaults.ImageContentPadding to CardDefaults.CardWithContainerPainterContentPadding ( I7b8b6 )
Picker and PickerGroup now take the contentDescription as a lambda to avoid unnecessary recompositions. ( I002dd )

رفع اشکال

Fixed an issue where indeterminate CircularProgressIndicator would wobble during animation if width is not equal to height. ( I76bfe )
Fixed an issue with edge button layout on invalid size. Now prevents updating the layout of the edge button when the height is NaN. ( I32b93 )
Increased the max sweep angle in OpenOnPhoneDialog so that the default 'Check your phone' text is not clipped with the largest font size. ( I90af9 )

Version 1.0.0-alpha36

April 9, 2025

androidx.wear.compose:compose-material3:1.0.0-alpha36 is released. Version 1.0.0-alpha36 contains these commits .

تغییرات API

Replaced ButtonDefaults.imageBackgroundButtonColors with ImageButton , ButtonDefaults.imageButtonColors , ButtonDefaults.containerPainter and ButtonDefaults.disabledContainerPainter . And similar changes for Card. The painters are removed from ButtonColors and CardColors . ( I8c6a1 )
Updated placeholders to simplify the API. We now provide two Modifiers, Modifier.placeholderShimmer to apply a shimmer effect at the component level, and Modifier.placeholder to apply a mask on top of unloaded content ( Iaee7a )

رفع اشکال

Integrated overscroll into the ScrollIndicator . ( Icfb7f )
Address blank backgrounds and missing dialogs when launching material3 dialogs. ( Ice597 )
Fixed issues in FadingExpandingLabel when text spans multiple lines. ( I04eb7 )
Updated padding between primary and secondary labels on buttons. ( I99b7b )
ArcLarge has been reduced from 20sp to 18sp , and letter spacings on ArcLarge and ArcSmall have been updated. ConfirmationDialog / OpenOnPhoneDialog now use the default ArcLarge instead of overriding it to 18sp . ( Id39a8 )

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

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

Version 1.0.0-alpha35

26 مارس 2025

androidx.wear.compose:compose-material3:1.0.0-alpha35 is released. Version 1.0.0-alpha35 contains these commits .

تغییرات API

AlertDialog top padding is now reduced by default when an icon is provided - this makes best use of the screen size available. ( Ief06c )
PagerScaffoldDefaults.FadeOutAnimation has been renamed to PagerScaffoldDefaults.FadeOutAnimationSpec . The page parameter on AnimatedPage has been renamed to pageIndex . ( I701f2 )
Updated naming for TransformingLazyColumn 's SurfaceTransformation - applyTransformation split into applyContainerTransformation and applyContentTransformation , and renamed createBackgroundPainter to createContainerPainter . Further naming updates to TransformationSpec and ResponsiveTransformationSpec . ( I1c534 )
The AppScaffold backgroundColor has been renamed to containerColor . ( I4e63f )

رفع اشکال

Fixed an issue in FadingExpandingLabel where the text did not always expand correctly. ( I0e773 )
ArcLarge has been reduced from 20sp to 18sp, and letter spacings on ArcLarge and ArcSmall have been updated. ConfirmationDialog/OpenOnPhoneDialog now use the default ArcLarge instead of overriding it to 18sp. ( Id39a8 )
Updated the heading animation for DatePicker and TimePicker based, so that the fade-out and fade-in animation act as one Spring animation. ( I68963 )
Optimized PagerScaffold by avoiding the reading of currentPageOffsetFraction in the AnimatedPage composable. ( I433ef )
All type scales have been updated to have proportional numerals by default, because that is seen as the most frequent use case and defaulting to tabular resulted in too much spacing between certain number pairings. TimePicker and DatePicker continue to apply FontFeatureSetting=tnum for tabular numerals. ( I88929 )
Corrected the initial RSB input focus for TimePicker and DatePicker . ( I1c773 )
Updated the default text on OpenOnPhoneDialog to "Check your phone". ( I00a3f )
Updated weights for ArcLarge and ArcMedium from 600 to 599 to workaround an issue where weight 600 is treated as bold ( I2a51d )
Update SwipeToReveal paddings between content and action buttons, and also the padding between the icon and text of the action buttons. ( Ic46cb )

Version 1.0.0-alpha34

12 مارس 2025

androidx.wear.compose:compose-material3:1.0.0-alpha34 is released. Version 1.0.0-alpha34 contains these commits .

تغییرات API

PagerScaffold no longer emits a Pager component - instead this must be provided via the content Composable. AnimatedPage and snapWithSpringFlingBehaviour are now public and can be used along with Wear Foundation Pager to achieve previous M3 PagerScaffold behaviour. (See updated samples). ( Ia4724 )
Updated PagerState , removing the Compose Foundation PagerState as the base class and adding currentPage , currentPageOffsetFraction and pageCount properties. Updated the GestureInclusion interface, renaming the method to ignoreGestureStart . ( I4ae07 )
LevelIndicator sweep angle parameters are now annotated with FloatRange(0, 360) ( I7e636 )
We have added CurvedModifier.clearAndSetSemantics to provide a means by which curved semantics can be turned off. CurvedText continues to default the content description to the text, but timeTextCurvedText and timeTextSeparator do not now announce their contents. ( I4b568 )
Added a background and default content color parameters to AppScaffold . ( I56652 )
HorizontalPager 's default handling of swipe gestures has been renamed to PagerDefaults.gestureInclusion . The default behavior is now to only ignore swipe gestures that start on the left edge of the first page, and only then when Talkback is turned off. In other cases, the default behavior is that swipe gestures will not be ignored by the pager, so they will not be available to swipe-to-dismiss handlers. ( Iee486 )
Added a SurfaceTransformation parameter to button, card and list header components, so that they can apply different background and content transformations when used in containers that change items appearance based on their position, such as TransformingLazyColumn . ( Iabe3f )
We have updated 'public const val' properties in our Wear Compose Material3 API to 'public val', to avoid the values being inlined. ( Ib0f32 )
Added support for an edge-swipe zone to SwipeToReveal . Foundation SwipeToReveal 's default behavior is now to disallow swiping when the gesture starts from the edge. Material3 SwipeToReveal' s default behavior is now to disallow swiping when the gesture starts from the edge, when the SwipeDirection is set to single direction. ( I32ef0 )
Added FadingExpandingLabel composable, which allows it to fade in text with animation line by line. ( Ic60fa )
TransformingLazyColumn now uses empty contentPadding by default instead of putting first and last items into center. ( I77ab7 )
Removed SwipeToReveal 's rememberRevealState from the Wear Compose Material3 library. ( I8c0e0 )

رفع اشکال

Wear Compose libraries have been updated to the Kotlin 2.0 compiler. ( I2de79 )
Support for non-round ScrollIndicator and PageIndicator has been removed from Material3. Square screen support is also no longer part of the Wear OS requirements, see the Getting Started guide for more information. ( I9a852 )
The CurvedTextStyle used in ConfirmationDialogDefaults and OpenOnPhoneDialogDefaults has been updated to use ArcLarge typography with size 18sp and letter spacing 1.8sp . ( Ic9ced )
Card , ListHeader , RadioButton , CheckboxButton , SwitchButton no longer constrain the height of its contents by default. Where necessary, use Modifier.height(IntrinsicSize.Min) to restore the previous behavior if needed. ( I80bb8 )
We have updated the default TimeText and ScrollIndicator colors to include more gray tones, because using OnBackground (white) directly carried too much visual weight when competing with other content on screen like titles. ( I8b36f )
We have reduced the timeout for animating the TimeText and ScrollIndicator in scaffold components to 2 seconds. ( I52021 )
We have updated the motion of Dialog so that the scale of the background of the Dialog is synchronised with swiping to dismiss. ( I925a9 )
Add demo of M3 SwipeToReveal using edgeSwipeToDismiss modifier. ( I02b07 )
We have added a heading to DatePicker and TimePicker under TalkBack so that the user is informed to scroll to set date/time. ( Id738d )
AnimatedText now follows the reduce motion setting. ( Ib6578 )
The optimisation to use AppScaffold for display Dialog content has been improved to allow multiple dialogs to be displayed on top of each other ( I1209c )

Version 1.0.0-alpha33

26 فوریه 2025

androidx.wear.compose:compose-material3:1.0.0-alpha33 is released. Version 1.0.0-alpha33 contains these commits .

تغییرات API

We have removed the label parameter from SwipeToRevealScope 's primaryAction and secondaryAction . Custom action semantics should be added to the content of the SwipeToReveal component directly, by the developer. ( Ia67f3 )
We have removed the 'Button' prefixes from sizes, text styles and color functions in IconToggleButtonDefaults and TextToggleButtonDefaults ( I5471d )
We have removed the experimental LocalMinimumInteractiveComponentEnforcement ( I4ad8a )
We have replaced the PickerGroupScope DSL with a composable. As such, we removed the pickerGroupItem method from PickerGroupScope , and instead added @Composable PickerGroupItem that should be used to add a Picker to PickerGroup . We also updated the type of PickerGroup 'content' parameter to @Composable PickerGroupScope.() -> Unit . ( Ic6aec )
We have added a LevelIndicator overload for fractional values and added a Stepper prefix to those overloads that include a range parameter (which are suitable for use with the Stepper component). ( If4234 )
We have added TransformingLazyColumn 's TransformationSpec to the API, which allows the definition of the exact transformations happening to the items as they are being scrolled through the TLC. ( I21856 )
We have updated IconButtonShapes , IconToggleButtonShapes , TextButtonShapes and TextToggleButtonShapes to be consistent with the compose/material3 classes ( I5a081 )
We have added an overscrollEffect parameter added to ScalingLazyColumn , TransformingLazyColumn and ScreenScaffold . ( I0cee8 )
We have renamed the swipeDirection parameter to revealDirection in rememberRevealState . ( I7472f )
Wear Pager now has its own PagerScope instead of using Compose PagerScope . ( I9195b )
We have removed the LinearProgressIndicatorContent composable, please use LinearProgressIndicator directly so that changes to values are animated by default. ( I2c4ad )
We have removed the CircularProgressIndicatorStatic composable and added a public DrawScope function drawCircularProgressIndicator with the same functionality. Please use CircularProgressIndicator directly so that changes are animated by default, but build your own composable from drawCircularProgressIndicator if custom animations are needed. ( Ie762f )
We have reordered the parameters in DrawScope.drawCircularProgressIndicator to move up the targetProgress parameter. ( I8ab92 )
The OpenOnPhoneDialog api was updated for better clarity and consistency with other Dialogs. The show parameter was renamed to visible and curvedText is now provided by the caller instead of having a default value. ( Idec2d )
We have renamed openOnPhoneCurvedText to openOnPhoneDialogCurvedText ( I65bdd )
We have added ScrollIndicatorColors for providing custom colors to ScrollIndicator . ( I9eb8c )
Allow the configuration of the color used to draw a background behind TimeText . ( I9f5d9 )
Updated ArcLarge , ArcMedium and ArcSmall typographies to be CurvedTextStyle ( Iffc41 )
We have removed ScreenScaffoldDefaults.contentPaddingWithEdgeButton . ( Ia923e )
We have added errorDim to the ColorScheme , for high priority errors or emergency actions such as safety alerts, failed dialog overlays or stop buttons. ( I70998 )

رفع اشکال

We have pinned wear.compose.material3 to version 1.15.0 of androidx.core.core ( I132e9 )
We have improved Dialog's performance by using the AppScaffold to layer dialogs over other screen content ( I1b9a4 )
Reduced EdgeButton 's internal vertical padding. ( I1a5bb )
We have added Button semantics to Slider buttons. ( I80cc6 )

Version 1.0.0-alpha32

29 ژانویه 2025

androidx.wear.compose:compose-material3:1.0.0-alpha32 is released. Version 1.0.0-alpha32 contains these commits .

تغییرات API

On CurvedTextStyle , we have split letter spacing into clockwise letter spacing and counter clockwise letter spacing. This is required because clockwise letters fan out from the baseline whereas counter-clockwise letters fan in (so larger letter spacing is needed) ( I4b848 )
We have updated IconButtonShapes , IconToggleButtonShapes , TextButtonShapes and TextToggleButtonShapes to improve consistency across Material3 libraries. This change also introduces shape caching to reduce the number of allocations. ( I049fc )
We have removed the pressedShapeCornerSizeFraction parameter from the variantAnimatedShape method in IconToggleButton and TextToggleButton ( I58a65 )
We are introducing improvements to curved text rendering (including TimeText ) that are incompatible with non-round screens. Non-round screen support is also no longer part of the Wear OS requirements, see the Getting Started guide for more information. ( I1cc1c )
We have updated ButtonGroup 's ButtonGroupScope , replacing the DSL-based ButtonGroupItem with Modifier.weight , Modifier.minWidth and Modifier.enlargeOnPress . ( I16c3c )
In the ButtonGroup API, we have updated the new modifier-based ButtonGroupScope : enlargeOnPress is now called animateWidth , and it takes an InteractionSource , rather than MutableInteractionSource because it is not necessary to mutate it. We have also added public constant ButtonGroupDefaults.DefaultMinWidth , the default minimum width of buttons in a ButtonGroup . ( Ie27ec )
We have updated ListHeaderDefaults.contentColor to start with a lowercase letter as it is a composable property ( I125a5 )
We have added a content description parameter to SliderDefaults.DecreaseIcon and SliderDefaults.IncreaseIcon , with suitable default values ( I2e1a7 )
We have renamed the spacing parameter in Picker and PickerGroup to verticalSpacing ( Ib75cc )
We have removed ConfirmationDialogDefaults.successText and failureText because it is expected that callers of ConfirmationDialog will provide strings with more context. Also renamed confirmationCurvedText to confirmationDialogCurvedText . Finally, renamed the Dialog show parameter to visible for consistency with other recent updates to dialogs. ( I10074 )
IconButton renamed disabledImageOpacity to DisabledImageOpacity . ( I5f94a )

رفع اشکال

We have fixed a bug in EdgeButton animation so that the correct size is used in each frame ( Id3b58 )
Fixed an issue with animateContentSize not working with Button . ( Ib18a0 )
We have changed the Title Large type scale to have font size 18dp ( Ic9d52 )
We have updated AlertDialog spacing and icon size ( Iac28c )
We have fixed inconsistencies in large screen breakpoints (screens at and above 225dp are large screen) ( I36474 )
Fixed a minor bug in button positioning ( I952c2 )

Version 1.0.0-alpha31

15 ژانویه 2025

androidx.wear.compose:compose-material3:1.0.0-alpha31 is released. Version 1.0.0-alpha31 contains these commits .

تغییرات API

We have updated all Wear Compose libraries to 'explicit API' mode. ( Iebf9f )
We have updated the ScreenScaffold and EdgeButton APIs, so that it is easier to specify content paddings on screens that include an EdgeButton . In the new API the EdgeButton 's size is only passed to the EdgeButton , and the ScreenScaffold takes an edgeButtonSpacing parameter for the spacing between EdgeButton and list content. ( I424fd )
In DatePicker , we have renamed parameters minDate to maxDate , and minValidDate to maxValidDate . In DatePickerColors , we have renamed parameter selectedPickerContentColor to activePickerContentColor , and unselectedPickerContentColor to inactivePickerContentColor ( Iba17b )
We have updated the ArcProgressIndicator defaults to strokeWidth=6dp and recommended diameter = 81.24% of screen height ( I6f248 )
We have updated the Confirmation API to reflect its usage as a dialog. The composable is now called ConfirmationDialog , with associated updates to the naming of colors and defaults classes. We have also renamed the show parameter to visible for compatibility with other Compose animation APIs. In addition, we have made ConfirmationDialogContent , SuccessConfirmationDialogContent , FailureConfirmationDialogContent available for situations where developers need to customize the intro/outro dialog animations. ( Iaeb33 )
We have updated CircularProgressIndicatorContent to CircularProgressIndicatorStatic (the non-animated variation of CircularProgressIndicator ) so that it can now be used to build CircularProgressIndicator with custom animations. ( I1346f )
We have fixed the parameter ordering on the ArcProgressIndicator , putting the modifier parameter first ( I4656a )
Improved the SwipeToReveal API to receive a text slot parameter for the labels of the actions (except secondary action) and to remove label parameters from undo action ( I5b3db )

رفع اشکال

We have fixed a bug where LongPress haptics were triggered more than once in Button , Card , IconButton , TextButton ( Ia8b0f )
Changes to the UX of AlertDialog - on large screens the confirm and dismiss buttons are now smaller. There is also increased spacing below the confirm and dismiss buttons. ( I4f066 )
We have changed the animation specs of the action button label of the SwipeToReveal component. ( Ib87fb )
Changed SwipeToReveal to expand the container at the same time that the text is displayed. ( I44cf8 )
Improved SwipeToReveal to perform haptic feedback when the swipe passes the threshold where the primary action is committed. ( I23efe )
We have updated SwipeToReveal to display ellipsis on text overflow by default, for primary and undo actions. ( I71f5a )
We have fixed an issue causing jitter on ButtonGroup animations. ( I63f8f )
We have added text semantics to AnimatedText ( I6063c )
Dialog now resets background scaling when the dialog is removed from the composition (without this fix, the launching screen may have been left in a scaled down state) ( Id24ac )
We have added a shape morph animation to the buttons in the Stepper component ( Id6ed3 )

Version 1.0.0-alpha30

11 دسامبر 2024

androidx.wear.compose:compose-material3:1.0.0-alpha30 is released. Version 1.0.0-alpha30 contains these commits .

تغییرات API

The scrollTransform modifier for TransformingLazyColumn was refactored which triggered an API change. ( I0c6dc )
We have updated IconToggleButtonShapes and TextToggleButtonShapes to have two different shape parameters uncheckedPressed and checkedPressed ( I85dbd )
Invalid month/day options are now visible in the DatePicker , with a new invalidPickerContentColor , when using minDate or maxDate . ( If4541 )
We have updated the Stepper API to provide increaseIcon and decreaseIcon slots - the content for these can be built as usual from the Icon composable. ( Id35da )
We have updated dynamicColorScheme by removing the optional defaultColorScheme parameter and now returning nullable ColorScheme . This means that the caller must explicitly handle the fallback case when a dynamic color scheme is not provided. ( I6d62e )
We have updated the icon sizes in ButtonDefaults for use with CompactButton . A CompactButton containing only an icon should use ButtonDefaults.SmallIconSize = 24.dp , whereas a CompactButton containing both icon and text should use ButtonDefaults.ExtraSmallIconSize = 20.dp . It is recommended that CompactButton wrap its content (rather than filling the max width) and samples have been updated to show that. ( I0582c )
We have added EdgeButtonDefaults with recommended icon sizes for the 4 different EdgeButtonSizes . Also, updated the EdgeButton layout so that it has slightly larger bottom padding than top padding, which improves appearance for both Icon and Text content. ( Id772a )
We have added motion to LinearProgressIndicator and exposed LinearProgressIndicatorContent which provides the visual content without animations. ( Idee99 )
We have added a new CircularProgressIndicatorContent composable to display the visual content of CircularProgressIndicator without animations. ( Ie33d4 )
TransformingLazyColumn newly provides the composition local LocalTransformingLazyColumnItemScope which Card s, Button s and ListHeader s now use to automatically morph when placed inside a TransformingLazyColumn . Callers can disable automatic morphing using the new TransformExclusion wrapper. ( I1652f )
We have updated the type of ButtonDefaults.shape to RoundedCornerShape ( Iccdf2 )

رفع اشکال

We have fixed a bug to respect existing alpha on background for TimeText ( I1eb60 )
We have set TextMotion to Animated by default in our typography, to avoid text jitter due to snapping letter glyphs to pixel boundaries during scaling operations. ( I626fa )
We have updated the appearance of the ScrollIndicator by increasing width and gap size, to improve visibility. ( Ied7cb )
We have fixed a bug on Modifier.scrollTransform when adding/removing/moving items. ( I6830f )
We have fixed a round button animation issue for short taps (previously, the minimum animation duration was not always observed). ( I757a7 )
We have updated the sweep angle for LevelIndicator to 20% (ie 72 degrees). ( Idde5c )
We have fixed ScrollIndicator positioning when ScalingLazyColumn was used with AutoCenteringParams . ( I387dd )
We have updated the colors and typography for ListHeader and ListSubHeader . Also the colors for the toggle controls on CheckboxButton and SwitchButton . ( I39817 )
We have fixed ScrollIndicator positioning in LazyColumn and ScalingLazyColumn with ContentPadding . ( I2bc51 )
We have fixed a bug seen in OpenOnPhoneDialog progress animation by using the new CircularProgressIndicatorContent . ( I3e443 )
We have updated the HorizontalPagerScaffold and VerticalPagerScaffold to disable animations when reduce motion is enabled ( Iaaf68 )
We have implemented a separate animation for circular progress indicators when progress reaches over 100%. ( I47135 )
We have fixed a bug where EdgeButton could be drawn with an incorrect shape in Pager components ( I91db9 )

Version 1.0.0-alpha29

13 نوامبر 2024

androidx.wear.compose:compose-material3:1.0.0-alpha29 is released. Version 1.0.0-alpha29 contains these commits .

تغییرات API

We have updated TimeText to provide default content that shows the time. ( Id23b3 )
We have simplified the ScrollInfoProvider for PagerState by removing the orientation parameter, which is no longer needed. The new behavior is for TimeText to remain in place for both horizontal and vertical paging. ( I71767 )
LocalHapticFeedback now provides a default HapticFeedback implementation when the Vibrator API indicates that haptics are supported. The following have been added to the HapticFeedbackType - Confirm , ContextClick , GestureEnd , GestureThresholdActivate , Reject , SegmentFrequentTick , SegmentTick , ToggleOn , ToggleOff , VirtualKey . Wear Compose long-clickable components such as Button , IconButton , TextButton , and Card now perform the LONG_PRESS haptic when a long-click handler has been supplied. ( I5083d )

رفع اشکال

We have updated the motion for Confirmations. ( I04bff )
We have updated the minimum API dependency to 1.7.4 for Compose libraries. ( I88b46 )
New motion was added for the OpenOnPhone dialog. ( I1e10a )
We have fixed a bug in the LevelIndicator so that it is now correctly displayed with the level is zero. ( Ie95a4 )
We have updated the HorizontalPageIndicator and VerticalPageIndicator animations. ( I5c8f3 )
We have added a shrink-to-dot animation to the indeterminate ArcProgressIndicator . ( I9fd51 )

Version 1.0.0-alpha28

30 اکتبر 2024

androidx.wear.compose:compose-material3:1.0.0-alpha28 is released. Version 1.0.0-alpha28 contains these commits .

تغییرات API

We have added an arc variation on the indeterminate circular progress indicator ( I2efc1 )
We have made public the AlertDialogContent and Dialog composables that make up the AlertDialog API, so that it is possible to add customization if necessary (such as customizing AlertDialog animation whilst keeping the recommended content layout). In addition, we have added Modifier and Color parameters to the EdgeButton , ConfirmButton and DismissButton members of AlertDialogDefaults . ( I4eb71 )
We have updated the Placeholder API as follows: renamed PlaceholderState.startPlaceholderAnimation to PlaceholderState.animatePlaceholder , PlaceholderState.isShowContent to PlaceholderState.isHidden , and PlaceholderDefaults.shape to PlaceholderDefaults.Shape ; renamed the painter parameter in painterWithPlaceholderOverlayBackgroundBrush to originalPainter ; changed visibility of PlaceholderState.placeholderProgression from public to internal and renamed it to placeholderShimmerProgression ; added placeholder animation duration constants to PlaceholderDefaults . ( Ie5a59 )
We have updated the EdgeButton API as follows: renamed the parameter on ScreenScaffold from bottomButton to edgeButton ; made EdgeButtonSize a value class. ( Ieef15 )
We have changed the visibility of copy() to public in wear material3 Colors classes ( I0287f )

رفع اشکال

Added minimum animation duration for IconToggleButton and TextToggleButton on click ( Ieb333 )
Added minimum duration on IconButton and TextButton shape animation ( Iebcee )
Corrected the repeat option state of DatePicker . ( I3587c )
Added motion for Alert and Confirmation dialogs. ( I173b1 )

Version 1.0.0-alpha27

16 اکتبر 2024

androidx.wear.compose:compose-material3:1.0.0-alpha27 is released. Version 1.0.0-alpha27 contains these commits .

تغییرات API

We have updated the ScreenScaffold and ScrollIndicator following the renaming of Wear Compose Foundation LazyColumn to TransformingLazyColumn . ( I0608b )
EdgeButton 's preferredHeight parameter has been renamed to buttonSize and its value can only be chosen from 4 constants in the newly introduced EdgeButtonSize value class. ( Icdd70 )
We have changed the naming of ListSubheader to ListSubHeader and added publicly accessible default values for ListHeader and ListSubHeader . ( I96730 )
We have added new HorizontalPagerScaffold and VerticalPagerScaffold components for Wear which provide new animations and coordination between time text and page indicator components. ( Iff7d0 )
We have added rotary support to HorizontalPagerScaffold and VerticalPagerScaffold , enabling users to navigate pagers using rotary input devices. ( I9770d )
We have made MotionScheme API changes to simplify the usage and improve consistency. Removed inlined remember functions and moved the built-in Motion Schemes to a dedicated MotionScheme companion object. Renamed the standardMotionScheme and the expressiveMotionScheme to standard and expressive. ( I5fd45 )
We have added support for a dynamic color scheme based on system colors. ( I073e9 )
We have updated the Stepper to the latest UX specs. ( I622bb )

رفع اشکال

We have updated typography and paddings for Card components. ( I3ae48 )
We have changed the padding in AlertDialog between Confirm/Dismiss buttons and the rest of the content from 8dp to 12dp according to UX specs ( Ie55f0 )
We have updated the color opacity for the Slider component. ( Idb383 )

Version 1.0.0-alpha26

2 اکتبر 2024

androidx.wear.compose:compose-material3:1.0.0-alpha26 is released. Version 1.0.0-alpha26 contains these commits .

تغییرات API

We have updated the API and appearance of HorizontalPageIndicator and added VerticalPageIndicator for use with VerticalPager ( Ic9309 )
AlertDialog now supports the ability to omit the default bottom button from the button stack variation, for custom layouts in which EdgeButton is not required. ( I34fa9 )
We have added a SwipeToReveal component for Wear Material 3 ( Ic38b2 )
We have added support for bi-directional swiping in SwipeToReveal , for rare cases where the current screen does not support swipe to dismiss. The default is still to swipe-to-reveal only on right-to-left swipes and it is strongly advised to respect the default behavior to avoid conflict with swipe to dismiss. ( Ifac04 )
We have renamed EdgeButton 's buttonHeight parameter to preferredHeight . ( I4fab3 )
The Kotlin version has been updated to 1.9 ( I1a14c )
We have renamed OpenOnPhoneDialogDefaults.Icon to OpenOnPhoneDialogDefaults.OpenOnPhoneIcon to avoid clashing with Icon ( I0f391 )
We have added support for ScrollIndicator in LazyColumn . ( Ia546a )
We have updated default values for TextToggleButton and IconToggleButton . ( I7aaa9 )
We have simplified the Picker and PickerGroup API. ( Id0653 )
We have added CardDefaults.Shape and CardDefaults.Height , which (being tokens) were otherwise private to developers using the library. ( I1594a , b/347649765 )
We have renamed the progress parameter for the binary segmented circular progress indicator to segmentValue . ( Ib72d9 )
We have updated the colors and layout for Slider. ( Ic3eec )

رفع اشکال

We have updated the openOnPhone icon animation ( I66f85 )
We are now using Google Symbols icons in Slider , TimePicker and DatePicker . ( I46c7c )
We have updated the paddings in Confirmation and OpenOnPhoneDialog . ( Iaa82e )

Version 1.0.0-alpha25

18 سپتامبر 2024

androidx.wear.compose:compose-material3:1.0.0-alpha25 is released. Version 1.0.0-alpha25 contains these commits .

تغییرات API

We have added an Indeterminate circular progress indicator. ( I427a7 )
We have added support for progress overflow (>100% progress) for both the CircularProgressIndicator and the SegmentedCircularProgressIndicator . When the progress exceeds 1.0, this will be indicated by the new overflowTrack color. ( Iaaa3d )
The round IconToggleButton and TextToggleButton now support a new shape animation variation, in which different shapes represent checked, unchecked and pressed states. The earlier animated shape variation for the just pressed state continues to be supported. ( I29f03 )
We have removed support for using EdgeButton with Column , due to the need to specify the EdgeButton height explicitly in ScreenScaffold . ( Ie353d )
We have added support for the Wear Compose LazyColumn with our ScreenScaffold (and added an implementation of ScrollInfoProvider for LazyColumnState ). ( Ib8d29 )
We have combined LocalTextMaxLines , LocalTextAlign , LocalTextOverflow into a single LocalTextConfiguration composition local to provide a more scalable solution going forwards. ( I5edbc )
We have added arc-large as an additional typescale, reserved for short header text strings at the very top or bottom of the screen, like in Confirmation overlays. ( I60e3e )
We have added defaults to Button for recommended large and extra large icon sizes and content padding. ( I84675 )

رفع اشکال

We have updated the colors for IconButton and TextButton . ( I48324 )
We have changed the base Button overloads to be vertically center-aligned for consistency with other overloads. To restore the previous behavior, use Modifier.align from the RowScope . ( I66e57 )

Version 1.0.0-alpha24

4 سپتامبر 2024

androidx.wear.compose:compose-material3:1.0.0-alpha24 is released. Version 1.0.0-alpha24 contains these commits .

تغییرات API

We have added a Motion scheme into the Material3 theme. This will be used by components across the library to apply animation specifications such as springs for expressive motion. ( I54ff3 )
We have added AppScaffold and ScreenScaffold components to the Material3 library, which include functionality to coordinate layering and transitions of TimeText and ScrollIndicator . AppScaffold provides a top level of scaffold components that sit on top of all screens. As such, adding TimeText to the AppScaffold allows it to remain in place while swiping between screens. Screens can themselves override or hide the time text. ScreenScaffold provides a slot for the ScrollIndicator and automatically animates the scroll indicator when scrolling, including timeout to hide the scroll indicator after inactivity. ( I047d6 )
We have added ScrollIndicator featuring the new Material3 design. It has a fixed thumb size based on initial list contents, in order to avoid size variations when lazy content is loaded into the list. ( Ic228d )
We have changed the ScrollAway API such that ScreenStage is a value class instead of an enum class, to allow for additional stages to be added as needed going forwards. ( I48c93 )
We have added EdgeButton , a distinctive Wear-specific button with a shape that follows the curvature of the bottom of the screen ( I16369 )
We have added a new slot to the ScreenScaffold for a bottom button (such as EdgeButton ), that will be shown and resized depending on the scrolling content ( I032eb )
We have added Modifier.scrollTransform and Modifier.targetMorphingHeight to add Material3 motion effects to items in LazyColumn . ( Ie229a )
We have added SegmentedCircularProgressIndicator as a variation on CircularProgressIndicator . The segmented variation either shows a single progress value across all segments or shows each segment as being on/off. ( I6e059 )
We have added LinearProgressIndicator as an alternative to the existing CircularProgressIndicator . ( I89182 )
We have added AlertDialog , providing layouts for presenting important prompts to the user. Variations are included for either a pair of confirm/dismiss buttons or a single bottom button (typically an EdgeButton) below a stack of options. Both variations have slots for icon, title and additional text to provide further details. ( Ieb873 )
We have added OpenOnPhoneDialog , which should be used to indicate an action that will continue on the user's phone. OpenOnPhoneDialog is dismissed after a specified timeout. ( I978fd )
We have added Confirmation , a dialog component that has slots for an icon and either curved or linear text. Specific variations are provided for success/failure messages. Confirmations are automatically dismissed after a timeout. ( Ib43e8 )
We have added a background to TimeText to mitigate issues where the underlying content and the TimeText overlapped, and obscured the time. ( Ia11fd )
We have added LevelIndicator , which shows the value of a setting such as volume, and can be used with the existing Stepper component to construct a volume screen. LevelIndicator is similar to ScrollIndicator , but is displayed on the opposite side of the screen and has a wider stroke width and different indicator color by default. ( I8a4ac )
We have added TimePicker , with layouts for 24 hour time (with or without seconds), or 12 hour time with am/pm selection. ( Ia5124 )
We have added DatePicker , with configuration for column ordering (ie day-month-year, month-day-year or year-month-day) and optional min/max dates. ( Ibf13b )
We have added a weight parameter to the TimeText 's text function. In cases where TimeText is made up of more than one text element, this allows control over how the space is distributed. ( I36700 )
We have added RadioButton and SplitRadioButton - these components simplify the previous API by combining both the (Split) SelectableButton and the child radio control ( If7ae8 )
We have added CheckboxButton and SplitCheckboxButton - these components simplify the previous API by combining both the (Split) ToggleButton and the child Checkbox control ( Ia8f70 )
We have added SwitchButton and SplitSwitchButton - these components simplify the previous API by combining both the (Split)ToggleButton and the child Switch control ( I0d349 )
We have updated AnimatedText documentation to explain overshooting behavior. ( Iff30a )
We have added ButtonGroup to combine 2 or 3 buttons such that button presses produce a coordinated animation. ( Ie27db )
We have added optional shape animation for IconButton and TextButton when pressed. ( Iffca5 )
We have added an additional color variation, FilledVariant , to Button , IconButton , TextButton , CompactButton and EdgeButton ( I65fc3 )
We have added the forcedSize parameter to ImageWithScrimPainter , such that Button image backgrounds now maintain their component size by default. Setting the forcedSize = null adopts the Painter.instrinsicSize instead. ( Ic57af )
We have added long-click to Buttons ( Ib613d )
Long click support has also been added to IconButton and TextButton . ( I38891 )
Long click support has been added to Cards. ( I305d5 )
We have added LocalTextMaxLines , LocalTextAlign , LocalTextOverflow as CompositionLocals and used them as parameter defaults on Text . The composition locals can now be used by components such as CheckboxButton , SwitchButton , RadioButton to implement UX guidance, but the parameters can be overridden by developers if necessary. ( Iab841 )
We have added Placeholder to help in masking the content of components like buttons & cards until the data is loaded. ( I1a532 )
We have added IconToggleButtonColors and TextToggleButtonColors to replace the now removed ToggleButtonColors . ( Ie0bf1 )

رفع اشکال

We have updated Button , FilledTonalButton , OutlinedButton , ChildButton , CompactButton to use the new CompositionLocals LocalTextMaxLines , LocalTextAlign , LocalTextOverflow to implement UX guidance - these parameters can be overridden by developers on Text directly if necessary ( Ie51f7 )
We have changed the default stroke width of the LevelIndicator to 6dp to differentiate it from the ScrollIndicator which has a stroke width of 4dp . ( If6f63 )
We have fixed an issue in TimeText so that larger sweep angles are supported. ( Ie489f )
Fixed an issue during EdgeButton recomposition. ( I4cdca )
Corrected layouts of split toggle buttons when customized content padding is provided. ( Ia33d3 )
Rounded up small progress values to at least the line width of the progress indicator. ( I3bd84 )

Version 1.0.0-alpha23

14 مه 2024

androidx.wear.compose:compose-material3:1.0.0-alpha23 is released. Version 1.0.0-alpha23 contains these commits .

تغییرات API

We have updated ToggleButton and RadioButton APIs such that disabled colors can be configured. ( If13a7 )
We have added a new CircularProgressIndicator for Material3. ( Ib3bd7 )

رفع اشکال

We have fixed a bug where selectable buttons announced double tap to toggle when already selected. ( I7ed88 )

Version 1.0.0-alpha22

1 مه 2024

androidx.wear.compose:compose-material3:1.0.0-alpha22 is released. Version 1.0.0-alpha22 contains these commits .

تغییرات API

We have updated the Material3 ColorScheme . ( I7b2b8 )
We have updated the Material3 Switch - as well as some color changes, the tick now matches that used for the Checkbox. ( Icac7b )

رفع اشکال

Update all integration demos to use new rotaryScrollable modifier. ( I25090 )

Version 1.0.0-alpha21

17 آوریل 2024

androidx.wear.compose:compose-material3:1.0.0-alpha21 is released. Version 1.0.0-alpha21 contains these commits .

This release was triggered due to a technical issue in the previous release that resulted in missing source jars. There are no new commits in this release.

Version 1.0.0-alpha20

3 آوریل 2024

androidx.wear.compose:compose-material3:1.0.0-alpha20 is released. Version 1.0.0-alpha20 contains these commits .

رفع اشکال

We have adjusted the Ripple pressed and focused state alphas for contrast. ( I59f0a )
We have added spacing between primary and secondary labels in Button , ToggleButton and RadioButton , following the latest changes to typography styles and line heights. ( I2c0ba )

نسخه 1.0.0-alpha19

6 مارس 2024

androidx.wear.compose:compose-material3:1.0.0-alpha19 is released. Version 1.0.0-alpha19 contains these commits .

تغییرات API

We have added TimeText to the Wear Compose Material3 library. This component shows the current time (and additional status) at the top of the screen. The new, concise Material3 API avoids duplication between linear and curved content. ( I4d7c3 )
We have updated parameter names from onSelected to onSelect for RadioButton . ( I1a971 )
Tokenize RadioButton and SplitRadioButton and also refactor the existing methods to reduce the amount of CompositionLocal lookup by adding cached instances of colors, and making methods of RadioButtonColors and SplitRadioButtonColors internal. ( I02b33 )

Version 1.0.0-alpha18

21 فوریه 2024

androidx.wear.compose:compose-material3:1.0.0-alpha18 is released. Version 1.0.0-alpha18 contains these commits.

تغییرات API

We have refactored the defaults pattern for CardColors , ToggleButtonColors and SplitToggleButtonColors by creating cached instances internally and reducing the usage of CompositionLocal . ( If3fec )

نسخه 1.0.0-alpha17

7 فوریه 2024

androidx.wear.compose:compose-material3:1.0.0-alpha17 is released. Version 1.0.0-alpha17 contains these commits.

تغییرات API

We have updated the Button API to use buttonColors by default and removed the duplicate filledButtonColors . ( I4fe3b )
We have refactored default patterns for ButtonColors , IconButtonColors and TextButtonColors by creating a cached instance internally and reducing the usage of CompositionLocal . ( I5f51c )
We have removed the overhead of rememberUpdatedState in Component specific color classes and marked accessor methods inside color classes as internal. ( If6571 )

رفع اشکال

We have updated Modifier.minimumInteractiveComponentSize to use Modifier.node . ( Iba6b7 )

نسخه 1.0.0-alpha16

24 ژانویه 2024

androidx.wear.compose:compose-material3:1.0.0-alpha16 is released. نسخه 1.0.0-alpha16 شامل این تعهدات است.

New Features

We have added CompactButton , which can use the same filled, filled tonal and outlined colors as Button.( I05df0 )

تغییرات API

We have added RadioButton / SplitRadioButton as containers for selection controls, such as the Radio control. This differs from the existing ToggleButton in that RadioButton is selectable (and operates within a selection group) whereas ToggleButton is toggleable (and is independent). ( I61275 )
We are removing LocalContentAlpha from the Wear Compose Material3 library for consistency with the Compose Material3 library. ( I49a0a )
Wear material and wear material3 components exposing a MutableInteractionSource in their API have been updated to now expose a nullable MutableInteractionSource that defaults to null. There are no semantic changes here: passing null means that you do not wish to hoist the MutableInteractionSource , and it will be created inside the component if needed. Changing to null allows for some components to never allocate a MutableInteractionSource , and allows for other components to only lazily create an instance when they need to, which improves performance across these components. If you are not using the MutableInteractionSource you pass to these components, it is recommended that you pass null instead. It is also recommended that you make similar changes in your own components. ( Ib90fc , b/298048146 )
Adds new ripple API in wear:compose-material and wear:compose-material3 libraries which replaces the deprecated rememberRipple . Also adds a temporary CompositionLocal , LocalUseFallbackRippleImplementation , to revert Material components to using the deprecated rememberRipple/RippleTheme APIs. This will be removed in the next stable release, and is only intended to be a temporary migration aid for cases where you are providing a custom RippleTheme . See developer.android.com for migration information and more background information behind this change. ( af92b21 )
We have made minor improvements to the HorizontalPageIndicator api and its documentation. ( I60efc )
We have updated ColorScheme to be immutable, making individual color updates less efficient, but making more common usage of colors more efficient. The reasoning behind this change is that the majority of apps wouldn't have updating individual colors as a main use case. This is still possible but it will recompose more than before, in turn we significantly decrease the amount of state subscriptions through all of material code and will impact initialization and runtime cost of more standard use cases. ( Ibc2d6 )
Updated ToggleButton and SplitToggleButton APIs to allow disabled colors to be customized. In addition, Material Design tokens are now used for color and typography values. ( If087c )
Updated Button image background colors to use Material Design tokens. ( Iba215 )
We have changed the Checkbox , Switch and RadioButton components to be display-only, by removing the click handling. These components are expected to be used in (Split)ToggleButton which handles the click, so the components are now more clearly indicated as display-only (and are not intended for standalone use on Wear). ( I2322e )

رفع اشکال

We have added tokens for motion values of durations and easings in Wear Compose Material 3. ( I437cd )
We have fixed a bug in the ToggleButton , SplitToggleButton , Checkbox , Switch and RadioButton so that accessibility announcements are not repeated (previously, semantic roles were duplicated). ( Ica281 )
We have removed the materialcore layer for CompactButton to improve performance. ( 7902858 )

نسخه 1.0.0-alpha15

15 نوامبر 2023

androidx.wear.compose:compose-material3:1.0.0-alpha15 is released. نسخه 1.0.0-alpha15 شامل این تعهدات است.

تغییرات API

We have renamed the Foundation level SwipeToDismissBox to BasicSwipeToDismissBox . This makes the distinction clearer between the Foundation level component and the Material3 level SwipeToDismissBox . The latter pulls colors from the MaterialTheme to be used in scrims and delegates the remaining implementation to the BasicSwipeToDismissBox . ( Ibecfc )

رفع اشکال

We have removed the material-core layer for Material3 Button to improve performance. ( I55555 )

Version 1.0.0-alpha14

18 اکتبر 2023

androidx.wear.compose:compose-material3:1.0.0-alpha14 is released. نسخه 1.0.0-alpha14 شامل این تعهدات است.

تغییرات API

We have removed the indicatorStyle parameter from the Material3 HorizontalPageIndicator - instead, it will follow the device screen shape (linear or round). ( I83728 )
We have separated the colors for SplitToggleButton from those for ToggleButton , by adding a new SplitToggleButtonColors class. ( I78bee )

نسخه 1.0.0-alpha13

4 اکتبر 2023

androidx.wear.compose:compose-material3:1.0.0-alpha13 is released. نسخه 1.0.0-alpha13 شامل این تعهدات است.

تغییرات API

We have added an optional Subtitle field to TitleCard . ( Ifc45a )
We have added Material Design color tokens for TextButton . ( I769dc )

نسخه 1.0.0-alpha12

20 سپتامبر 2023

androidx.wear.compose:compose-material3:1.0.0-alpha12 is released. Version 1.0.0-alpha12 contains these commits.

تغییرات API

We have updated IconButton to use Material Design tokens. ( I3f137 )
We have updated IconToggleButton to use Material Design tokens. ( I7d263 )
We have made public the constructors of CheckboxColors , RadioButtonColors , SwitchColors . ( I82b73 )

Version 1.0.0-alpha11

6 سپتامبر 2023

androidx.wear.compose:compose-material3:1.0.0-alpha11 is released. نسخه 1.0.0-alpha11 شامل این تعهدات است.

رفع اشکال

We update updated the typography for Material3 Cards to TitleMedium . ( I597bd )
We have updated the typography and alignment for our Material3 ListHeader and ListSubheader . ( Ib5ceb )

Version 1.0.0-alpha10

23 آگوست 2023

androidx.wear.compose:compose-material3:1.0.0-alpha10 is released. نسخه 1.0.0-alpha10 شامل این تعهدات است.

New Features

Add HorizontalPageIndicator in Wear Material3 library. ( Ifee99 )

تغییرات API

Update Buttons code to use Material3 design tokens. ( I92fe4 )
Declaring Wear Material 3 Stepper and Slider APIs as experimental as the details of the user interface are still being finalized. ( I84d54 )
We have removed the ExtraSmall sizes from the round TextButton and TextToggleButton as that size only applies to the IconButton . ( Ibc7d5 )

رفع اشکال

We have updated the guidance on typography for TextToggleButton to use LabelLarge for LargeButtonSize ( Ib10fa )
We have updated the guidance on typography for TextButton to use LabelLarge for LargeButtonSize ( I8f3a7 )
We have set the Card's minimum touch target to be 48dp for accessibility. ( Ieb9b1 )
Add AppCard with image demo, removing AppCard with Background demo ( Id735f )
Fix a bug in round buttons where modifiers were not chained correctly. ( I5e162 )

نسخه 1.0.0-alpha09

9 آگوست 2023

androidx.wear.compose:compose-material3:1.0.0-alpha09 is released. نسخه 1.0.0-alpha09 شامل این تعهدات است.

New Features

We have added ToggleButton for material3 ( I6bed6 )

تغییرات API

We have turned on the FloatRange annotation as API constraints , which were previously stated in comments. ( Icb401 )
We have updated the typography for Wear Material3 to adhere to the latest Material3 guidelines. ( I1bad6 )

رفع اشکال

We have updated the colors for Button , IconButton and TextButton in line with Material3 design. ( Ib2495 )
We have fixed checkbox tick visibility in disabled states. ( Ib25bf )

Version 1.0.0-alpha08

26 جولای 2023

androidx.wear.compose:compose-material3:1.0.0-alpha08 is released. نسخه 1.0.0-alpha08 شامل این تعهدات است.

New Features

We have added the following selection controls for Material3 - Switch , Checkbox , RadioButton . ( Ib918c )
We have added IconToggleButton and TextToggleButton to Material3, a circular toggle button with a single slot for icon and text respectively. For different sizes of ToggleButton , we recommend using Modifier.touchTargetAwareSize with the sizes provided in respective toggle buttons. ( I9f015 )
We have added ListHeader and ListSubheader to our Material3 components. ( Ibaefe )
We have added Material3 SwipeToDismissBox , which calls the new Foundation SwipeToDismissBox and supplies default color values from its theme. ( I275fb )
We have added the Material3 InlineSlider to Wear Compose. It allows users to make a selection from a range of values. The range of selections is shown as a bar between the minimum and maximum values of the range, from which users may select a single value. InlineSlider is ideal for adjusting settings such as volume or brightness. ( I7085f )

تغییرات API

We have updated the Shapes in Wear Material 3 theme to use RoundedCornerShape based instead of Shape. ( Idb133 )
We have made the height constants for Button public ( Idbfde )
Updated API files to annotate compatibility suppression ( I8e87a , b/287516207 )
We have updated InlineSliderColors in Wear Compose Material 3 to have public constructor and public properties. ( I6b632 )
We have updated all color classes in Wear Compose Material 3 to have public constructors and public properties. ( I17702 )
We have made Button horizontal and vertical padding constants public. ( Ieeaf7 )

رفع اشکال

Button will now adjust its height to accommodate content that has grown due to large fonts for accessibility, when required ( Iaf302 )
We have updated a number of Button demos to address accessibility issues. ( I61ce9 )
Stepper and InlineSlider now support repeated clicks on long press so that you can quickly increase/decrease value of Stepper and InlineSlider by holding the + or - buttons ( I27359 )

نسخه 1.0.0-alpha07

21 ژوئن 2023

androidx.wear.compose:compose-material3:1.0.0-alpha07 is released. Version 1.0.0-alpha07 contains these commits.

New Features

We have added the Stepper component to our Compose for Wear OS Material 3 library. This is similar to the previous Material version, but omits range semantics by default, following developer feedback. We provide Modifier.rangeSemantics the cases where range semantics are required. ( Ic39fd )
We have added curvedText to our Compose for Wear OS Material 3 library. ( Ia8ae3 )

رفع اشکال

We have update wear.compose.foundation to be an API dependency of wear.compose.material3 ( I72004 , b/285404743 )

نسخه 1.0.0-alpha06

7 ژوئن 2023

androidx.wear.compose:compose-material3:1.0.0-alpha06 is released. Version 1.0.0-alpha06 contains these commits.

رفع اشکال

We have updated TextButton to use the toDisabledColor extension function for correct disabled alpha values. ( I814c8 )

Version 1.0.0-alpha05

May 24, 2023

androidx.wear.compose:compose-material3:1.0.0-alpha05 is released. نسخه 1.0.0-alpha05 شامل این تعهدات است.

New Features

We have added TextButton to Material3, a circular button with a single slot for text. For different sizes of TextButton , we recommend using Modifier.touchTargetAwareSize and ExtraSmallButtonSize , SmallButtonSize , DefaultButtonSize and LargeButtonSizeIcon provided in TextButtonDefaults . The default TextButton has no border and a transparent background for low emphasis actions. For actions that require high emphasis, use filledTextButtonColors ; for a medium-emphasis, outlined TextButton , set the border to ButtonDefaults.outlinedButtonBorder ; for a middle ground between outlined and filled, use filledTonalTextButtonColors . ( I667e4 )
We have added Card , OutlinedCard , AppCard and TitleCard into the Wear Compose Material3 library. AppCard and TitleCard can also be given the outlined appearance using CardDefaults.outlinedCardColors and CardDefaults.outlinedCardBorder ( I80e72 )

تغییرات API

We have moved the Button label parameter to the end to support trailing lambda syntax and removed the role parameter (as this can be overridden using Modifier.semantics ). ButtonColors constructors are now public. ( Ie1b6d )

Version 1.0.0-alpha04

10 مه 2023

androidx.wear.compose:compose-material3:1.0.0-alpha04 is released. نسخه 1.0.0-alpha04 شامل این تعهدات است.

New Features

We have added IconButton to Material3, a circular button with a single slot for icon/image. There are four variations: IconButton , FilledIconButton , FilledTonalIconButton and OutlinedIconButton . For different sizes of IconButton , we recommend using Modifier.touchTargetAwareSize and ExtraSmallButtonSize , SmallButtonSize , DefaultButtonSize and LargeButtonSizeIcon provided in IconButtonDefaults . We also provide IconButtonDefaults.iconSizeFor to determine the recommended icon size for a given button size. ( I721d4 )

Version 1.0.0-alpha03

19 آوریل 2023

androidx.wear.compose:compose-material3:1.0.0-alpha03 is released. Version 1.0.0-alpha03 contains these commits.

تغییرات API

We have added the Material 3 Button component - this is our stadium-shaped button and was formerly named Chip in the Wear Compose Material library (it has been renamed to Button for consistency with the Compose Material 3 library). The default Button has a filled background and there are button variations for FilledTonal (muted background), Outlined (transparent with a thin border) and Child (transparent background and no border, used for supplementary actions with the lowest amount of prominence). Round buttons for simple icon and text content will follow in a future release.( Ia6942 )

Version 1.0.0-alpha02

5 آوریل 2023

androidx.wear.compose:compose-material3:1.0.0-alpha02 is released. نسخه 1.0.0-alpha02 شامل این تعهدات است.

رفع اشکال

We have added a DefaultTextStyle to Wear Compose Material 3 which defaults the PlatformTextStyle.includeFontPadding to true (the current setting). This will allow us to synchronize turning off font padding by default with the Compose libraries in the future (see Fix font padding in Compose for background ). ( I7e461 )

Version 1.0.0-alpha01

22 مارس 2023

androidx.wear.compose:compose-material3:1.0.0-alpha01 is released. Version 1.0.0-alpha01 contains these commits.

New Features

Material 3 is the next evolution of Material Design and includes updated theming and redesigned components. Material 3 on Wear Compose is designed to be cohesive with the Material 3 Compose library on Android. This first alpha release contains early, functional implementations of the following:
- Material theme - configures the color scheme, typography and shapes consistently across components in the library. The Material3 theme has revised colors which support accessible contrast. ( I84005 )
- Text/Icon - building blocks for Wear Compose apps ( I8e06a )
We will continue to develop Wear Material ( androidx.wear.compose:compose-material ) and Wear Material 3 ( androidx.wear.compose:compose-material3 ) in parallel. Future material3 releases will extend the widget set to include other familiar components from Compose for Wear OS, such as buttons, pickers, and sliders.
The Wear Material and Wear Material 3 libraries are mutually exclusive and should not be mixed in the same app, primarily because they reference different themes which would lead to unexpected inconsistencies.