Wear Compose Material 3

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

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

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

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

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

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

    // For Wear preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.5.0-beta03")
    
    // 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-beta03")

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

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

    // 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-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 composable را حذف کرده‌ایم و یک تابع DrawScope عمومی drawCircularProgressIndicator با همان عملکرد اضافه کرده‌ایم. لطفاً مستقیماً از CircularProgressIndicator استفاده کنید تا تغییرات به‌طور پیش‌فرض متحرک شوند، اما در صورت نیاز به انیمیشن‌های سفارشی، از drawCircularProgressIndicator خود را بسازید. ( Ie762f )
• ما پارامترها را در DrawScope.drawCircularProgressIndicator مرتب کرده‌ایم تا پارامتر targetProgress به بالا ببریم. ( I8ab92 )
• Api OpenOnPhoneDialog برای وضوح و سازگاری بهتر با دیالوگ های دیگر به روز شد. پارامتر show به visible تغییر نام داد و curvedText به جای داشتن مقدار پیش فرض، اکنون توسط تماس گیرنده ارائه می شود. ( Idec2d )
• ما openOnPhoneCurvedText به openOnPhoneDialogCurvedText ( I65bdd ) تغییر نام دادیم
• ما ScrollIndicatorColors برای ارائه رنگ های سفارشی به ScrollIndicator اضافه کرده ایم. ( I9eb8c )
• به پیکربندی رنگ مورد استفاده برای ترسیم پس‌زمینه پشت TimeText اجازه دهید. ( I9f5d9 )
• تایپوگرافی های ArcLarge , ArcMedium و ArcSmall به روز شده برای CurvedTextStyle ( Iffc41 )
• ScreenScaffoldDefaults.contentPaddingWithEdgeButton را حذف کرده ایم. ( Ia923e )
• ما errorDim به ColorScheme اضافه کرده‌ایم، برای خطاهای با اولویت بالا یا اقدامات اضطراری مانند هشدارهای ایمنی، پوشش‌های گفتگوی ناموفق یا دکمه‌های توقف. ( I70998 )

رفع اشکال

• ما wear.compose.material3 به نسخه 1.15.0 androidx.core.core ( I132e9 ) پین کرده ایم.
• ما عملکرد Dialog را با استفاده از AppScaffold برای لایه‌بندی دیالوگ‌ها بر روی سایر محتوای صفحه بهبود بخشیده‌ایم ( I1b9a4 )
• بالشتک عمودی داخلی EdgeButton را کاهش داد. ( I1a5bb )
• ما معنای Button را به دکمه های Slider اضافه کرده ایم. ( I80cc6 )

نسخه 1.0.0-alpha32

29 ژانویه 2025

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

تغییرات API

• در CurvedTextStyle ، فاصله حروف را به فاصله حروف در جهت عقربه‌های ساعت و فاصله حروف خلاف جهت عقربه‌های ساعت تقسیم کرده‌ایم. این مورد ضروری است زیرا حروف در جهت عقربه‌های ساعت از خط پایه خارج می‌شوند در حالی که حروف خلاف جهت عقربه‌های ساعت به سمت داخل می‌روند (بنابراین فاصله حروف بزرگ‌تر مورد نیاز است) ( I4b848 )
• ما IconButtonShapes ، IconToggleButtonShapes ، TextButtonShapes و TextToggleButtonShapes را برای بهبود سازگاری در کتابخانه های Material3 به روز کرده ایم. این تغییر همچنین ذخیره شکل را برای کاهش تعداد تخصیص ها معرفی می کند. ( I049fc )
• ما پارامتر pressedShapeCornerSizeFraction از روش variantAnimatedShape در IconToggleButton و TextToggleButton حذف کرده ایم ( I58a65 )
• ما در حال ارائه بهبودهایی برای رندر متن منحنی (از جمله TimeText ) هستیم که با صفحات غیر گرد ناسازگار است. پشتیبانی از صفحه غیر گرد نیز دیگر بخشی از الزامات Wear OS نیست، برای اطلاعات بیشتر به راهنمای شروع کار مراجعه کنید. ( I1cc1c )
• ما ButtonGroup 's ButtonGroupScope به‌روزرسانی کرده‌ایم، و ButtonGroupItem مبتنی بر DSL را با Modifier.weight ، Modifier.minWidth و Modifier.enlargeOnPress جایگزین کرده‌ایم. ( I16c3c )
• در ButtonGroup API، ما ButtonGroupScope مبتنی بر اصلاح‌کننده جدید را به‌روزرسانی کرده‌ایم: enlargeOnPress اکنون animateWidth نامیده می‌شود و به جای MutableInteractionSource یک InteractionSource می‌گیرد، زیرا نیازی به جهش آن نیست. ما همچنین ثابت عمومی ButtonGroupDefaults.DefaultMinWidth اضافه کرده‌ایم، حداقل عرض پیش‌فرض دکمه‌ها در یک ButtonGroup . ( Ie27ec )
• ما ListHeaderDefaults.contentColor به‌روزرسانی کرده‌ایم تا با حروف کوچک شروع شود زیرا یک ویژگی ترکیب‌پذیر است ( I125a5 )
• ما یک پارامتر توصیف محتوا به SliderDefaults.DecreaseIcon و SliderDefaults.IncreaseIcon اضافه کرده‌ایم، با مقادیر پیش‌فرض مناسب ( I2e1a7 )
• ما پارامتر spacing در Picker و PickerGroup به verticalSpacing تغییر نام دادیم ( Ib75cc )
• ما ConfirmationDialogDefaults.successText و failureText را حذف کرده‌ایم زیرا انتظار می‌رود فراخوان‌کنندگان 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 Compose را به حالت «API صریح» به‌روزرسانی کرده‌ایم. ( Iebf9f )
• ما APIهای ScreenScaffold و EdgeButton را به‌روزرسانی کرده‌ایم، به‌گونه‌ای که تعیین بالشتک‌های محتوا در صفحه‌هایی که دارای EdgeButton هستند آسان‌تر است. در API جدید، size EdgeButton فقط به EdgeButton منتقل می‌شود، و ScreenScaffold پارامتر edgeButtonSpacing را برای فاصله بین EdgeButton و محتوای فهرست می‌گیرد. ( I424fd )
• در DatePicker ، پارامترهای minDate به maxDate و minValidDate به maxValidDate تغییر نام دادیم. در DatePickerColors ، پارامتر selectedPickerContentColor به activePickerContentColor و unselectedPickerContentColor به inactivePickerContentColor ( Iba17b ) تغییر نام دادیم.
• ما پیش‌فرض‌های ArcProgressIndicator را به strokeWidth=6dp و diameter = 81.24% ارتفاع صفحه نمایش ( I6f248 ) به‌روزرسانی کرده‌ایم.
• ما Confirmation API را به‌روزرسانی کرده‌ایم تا استفاده از آن را به عنوان یک گفتگو نشان دهد. در حال حاضر Composable ConfirmationDialog نامیده می‌شود که به‌روزرسانی‌های مربوط به نام‌گذاری رنگ‌ها و کلاس‌های پیش‌فرض را دارد. همچنین برای سازگاری با سایر APIهای انیمیشن Compose، پارامتر show را به visible تغییر نام داده ایم. علاوه بر این، ConfirmationDialogContent ، SuccessConfirmationDialogContent ، FailureConfirmationDialogContent را برای موقعیت‌هایی در دسترس قرار داده‌ایم که توسعه‌دهندگان باید انیمیشن‌های گفتگوی مقدماتی/خروجی را سفارشی کنند. ( Iaeb33 )
• ما CircularProgressIndicatorContent به CircularProgressIndicatorStatic (نوع غیر متحرک CircularProgressIndicator ) به‌روزرسانی کرده‌ایم تا اکنون بتوان از آن برای ساخت CircularProgressIndicator با انیمیشن‌های سفارشی استفاده کرد. ( I1346f )
• ما ترتیب پارامترها را در ArcProgressIndicator ثابت کرده‌ایم و ابتدا پارامتر اصلاح‌کننده را قرار داده‌ایم ( I4656a )
• SwipeToReveal API را برای دریافت پارامتر اسلات متنی برای برچسب‌های کنش‌ها (به جز اقدام ثانویه) و حذف پارامترهای برچسب از عملکرد لغو ( 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 )
• ما به دنبال آخرین تغییرات در سبک های تایپوگرافی و ارتفاعات خط ، فاصله بین برچسب های اولیه و ثانویه را در Button ، ToggleButton و RadioButton اضافه کرده ایم. ( 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 قابل تهی را که به طور پیش فرض برای تهی است ، در معرض دید قرار دهند. در اینجا هیچ تغییر معنایی وجود ندارد: عبور از تهی به این معنی است که شما مایل به بلند کردن MutableInteractionSource نیستید و در صورت لزوم در داخل مؤلفه ایجاد می شود. تغییر در تهی به برخی از مؤلفه ها اجازه می دهد تا هرگز یک MutableInteractionSource را اختصاص ندهند ، و به سایر مؤلفه ها اجازه می دهد تا فقط در هنگام نیاز به تنبلی یک نمونه را ایجاد کنند و این باعث بهبود عملکرد در این مؤلفه ها می شود. اگر از MutableInteractionSource استفاده نمی کنید که به این مؤلفه ها منتقل می کنید ، توصیه می شود به جای آن NULL را منتقل کنید. همچنین توصیه می شود که در مؤلفه های خود تغییرات مشابهی ایجاد کنید. ( IB90FC ، B/298048146 )
• API جدید Ripple را در wear:compose-material و wear:compose-material3 که جایگزین rememberRipple مستهلک شده است. همچنین یک CompositionLocal موقت موقت ، LocalUseFallbackRippleImplementation استفاده می کند ، اما در صورت بازگشت اجزای مواد به استفاده از API های مستهلک شده rememberRipple/RippleTheme بازگرداندن اجزای مواد. این در نسخه پایدار بعدی حذف خواهد شد و فقط در مواردی که در حال ارائه یک RippleTheme سفارشی هستید ، کمک به مهاجرت موقت است. برای اطلاعات مهاجرت و اطلاعات بیشتر در زمینه این تغییر ، به Developer.android.com مراجعه کنید. ( AF92B21 )
• ما پیشرفت های جزئی در API HorizontalPageIndicator و مستندات آن انجام داده ایم. ( i60efc )
• ما ColorScheme به روز کرده ایم که تغییر ناپذیر باشد ، و به روزرسانی های رنگ فردی کارآمدتر می شود ، اما استفاده متداول تر از رنگ ها را کارآمدتر می کند. استدلال در مورد این تغییر این است که اکثر برنامه ها به روزرسانی رنگهای فردی را به عنوان یک مورد اصلی استفاده نمی کنند. این هنوز هم امکان پذیر است ، اما بیشتر از گذشته بازخوانی خواهد کرد ، به نوبه خود ما به طور قابل توجهی میزان اشتراک های حالت را از طریق تمام کد مواد کاهش می دهیم و بر اولیه سازی و هزینه زمان اجرای موارد استفاده استاندارد تأثیر می گذارد. ( IBC2D6 )
• API های ToggleButton و SplitToggleButton به روز شده برای اجازه دادن به رنگهای معلول. علاوه بر این ، اکنون از نشانه های طراحی مواد برای مقادیر رنگ و تایپوگرافی استفاده می شود. ( if087c )
• دکمه به روز شده رنگ پس زمینه رنگ برای استفاده از نشانه های طراحی مواد. ( IBA215 )
• ما با برداشتن کلیک کلیک ، کادر Checkbox ، Switch و RadioButton را فقط به نمایش می گذارند. پیش بینی می شود این مؤلفه ها در (Split)ToggleButton استفاده شوند که این کلیک را انجام می دهد ، بنابراین اجزای آن اکنون به وضوح به عنوان فقط نمایشگر مشخص شده اند (و برای استفاده مستقل در سایش در نظر گرفته نشده اند). ( I2322E )

رفع اشکال

• ما برای مقادیر حرکتی مدت زمان و وسایل نقلیه در ساییدگی به نشانه های حرکتی اضافه کرده ایم.
• ما یک اشکال را در ToggleButton ، SplitToggleButton ، Checkbox ، Switch و RadioButton برطرف کرده ایم تا اطلاعیه های دسترسی تکرار نشوند (قبلاً نقش های معنایی کپی شده بودند). ( ICA281 )
• ما لایه MaterialCore را برای CompactButton برای بهبود عملکرد حذف کرده ایم. ( 7902858 )

نسخه 1.0.0-alpha15

15 نوامبر 2023

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

API تغییر می کند

• ما به SwipeToDismissBox سطح بنیاد به BasicSwipeToDismissBox تغییر نام داده ایم. این باعث می شود تمایز بین مؤلفه سطح پایه و سطح Material3 SwipeToDismissBox واضح تر شود. حالت دوم رنگها را از MaterialTheme برای استفاده در Scrims و نمایندگان اجرای باقی مانده را به BasicSwipeToDismissBox منتقل می کند. ( ibecfc )

رفع اشکال

• ما برای بهبود عملکرد ، لایه هسته ای را برای دکمه Material3 حذف کرده ایم. ( i55555 )

نسخه 1.0.0-alpha14

18 اکتبر 2023

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

API تغییر می کند

• ما پارامتر indicatorStyle را از Material3 HorizontalPageIndicator حذف کرده ایم - در عوض ، شکل صفحه دستگاه (خطی یا دور) را دنبال می کند. ( i83728 )
• ما با اضافه کردن یک کلاس جدید SplitToggleButtonColors ، رنگ ها را برای SplitToggleButton از آنهایی که برای ToggleButton جدا شده اند ، جدا کرده ایم. ( i78bee )

نسخه 1.0.0-alpha13

4 اکتبر 2023

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

API تغییر می کند

• ما یک زمینه زیرنویس اختیاری را به TitleCard اضافه کرده ایم. ( IFC45a )
• ما نشانه های رنگی طراحی مواد را برای TextButton اضافه کرده ایم. ( i769dc )

نسخه 1.0.0-alpha12

20 سپتامبر 2023

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

API تغییر می کند

• ما IconButton برای استفاده از نشانه های طراحی مواد به روز کرده ایم. ( i3f137 )
• ما برای استفاده از نشانه های طراحی مواد ، IconToggleButton به روز کرده ایم. ( i7d263 )
• ما سازندگان CheckboxColors ، RadioButtonColors ، SwitchColors را عمومی کرده ایم. ( i82b73 )

نسخه 1.0.0-alpha11

6 سپتامبر 2023

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

رفع اشکال

• ما تایپوگرافی را برای کارتهای Material3 به TitleMedium به روز کردیم. ( i597bd )
• ما تایپوگرافی و تراز را برای Material3 ListHeader و ListSubheader خود به روز کرده ایم. ( IB5CEB )

نسخه 1.0.0-alpha10

23 آگوست 2023

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

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

• اضافه کردن HorizontalPageIndicator در کتابخانه Sear Material3. ( IFEE99 )

API تغییر می کند

• برای استفاده از نشانه های طراحی Material3 ، کد دکمه ها را به روز کنید. ( i92fe4 )
• اعلام Sear Material 3 Stepper و Slider API به عنوان آزمایشی به عنوان جزئیات رابط کاربری هنوز در حال نهایی شدن است. ( i84d54 )
• ما اندازه های ExtraSmall را از TextButton Round و TextToggleButton حذف کرده ایم زیرا این اندازه فقط در مورد IconButton اعمال می شود. ( IBC7D5 )

رفع اشکال

• ما راهنمایی های مربوط به تایپوگرافی را برای TextToggleButton به روز کرده ایم تا از Labellarge برای LargeButtonsize استفاده کنیم ( IB10FA )
• ما راهنمایی های مربوط به تایپوگرافی را برای TextButton به روز کرده ایم تا از Labellarge برای LargeButtonsize استفاده کند ( i8f3a7 )
• ما حداقل هدف لمسی کارت را برای دسترسی 48DP تعیین کرده ایم. ( IEB9B1 )
• اضافه کردن AppCard با نسخه ی نمایشی ، حذف AppCard با نسخه ی نمایشی پس زمینه ( ID735F )
• یک اشکال را در دکمه های گرد برطرف کنید که اصلاح کننده ها به درستی زنجیر نشده اند. ( i5e162 )

نسخه 1.0.0-alpha09

9 آگوست 2023

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

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

• ما ToggleButton برای Material3 اضافه کرده ایم ( i6bed6 )

API تغییر می کند

• ما حاشیه نویسی FloatRange را به عنوان محدودیت های API ، که قبلاً در نظرات بیان شده بود ، روشن کرده ایم. ( ICB401 )
• ما تایپوگرافی را برای Wear Material3 به روز کرده ایم تا به آخرین دستورالعمل های Material3 پایبند باشد. ( i1bad6 )

رفع اشکال

• ما رنگ ها را برای Button ، IconButton و TextButton مطابق با طراحی Material3 به روز کرده ایم. ( IB2495 )
• ما در حالت های معلولیت ، دید کادر ثابت را نشان می دهیم. ( IB25BF )

نسخه 1.0.0-alpha08

26 جولای 2023

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

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

• ما کنترل های انتخاب زیر را برای Material3 - Switch ، Checkbox ، RadioButton اضافه کرده ایم. ( IB918C )
• ما IconToggleButton و TextToggleButton به Material3 اضافه کرده ایم ، یک دکمه ضامن دایره ای با یک شکاف واحد برای نماد و متن. 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 Changes

• 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 )

Version 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.

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

• 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 )

Version 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

24 مه 2023

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

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

• 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 Changes

• 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. Version 1.0.0-alpha04 contains these commits.

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

• 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 Changes

• 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. Version 1.0.0-alpha02 contains these commits.

رفع اشکال

• 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.

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

• 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

Declaring dependencies

To add a dependency on Wear, you must add the Google Maven repository to your project. Read Google's Maven repository for more information.

Add the dependencies for the artifacts you need in the build.gradle file for your app or module:

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

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

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

    // For Wear preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.5.0-beta03")
    
    // 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-beta03")

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

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

    // 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.
}

For more information about dependencies, see Add build dependencies .

بازخورد

Your feedback helps make Jetpack better. Let us know if you discover new issues or have ideas for improving this library. Please take a look at the existing issues in this library before you create a new one. You can add your vote to an existing issue by clicking the star button.

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

See the Issue Tracker documentation for more information.

Wear Compose Material3 Version 1.5

Version 1.5.0-beta03

4 ژوئن 2025

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

API Changes

• 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 Changes

• 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 Changes

• 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

9 آوریل 2025

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

API Changes

• 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 )

Dependency Updates

• This library now targets Kotlin 2.0 language level and requires KGP 2.0.0 or newer. ( 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 Changes

• 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 Changes

• 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 Changes

• 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 Changes

• 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 Changes

• 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 Changes

• 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 Changes

• 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 Changes

• 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 Changes

• 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 Changes

• 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 Changes

• 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 Changes

• 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 Changes

• 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 Changes

• 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 )

Version 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 Changes

• 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 Changes

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

Version 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 Changes

• 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 )

Version 1.0.0-alpha16

24 ژانویه 2024

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

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

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

API Changes

• 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 )

Version 1.0.0-alpha15

15 نوامبر 2023

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

API Changes

• 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. Version 1.0.0-alpha14 contains these commits.

API Changes

• 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 )

Version 1.0.0-alpha13

4 اکتبر 2023

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

API Changes

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

Version 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 Changes

• 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. Version 1.0.0-alpha11 contains these commits.

رفع اشکال

• 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. Version 1.0.0-alpha10 contains these commits.

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

• Add HorizontalPageIndicator in Wear Material3 library. ( Ifee99 )

API Changes

• 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 )

Version 1.0.0-alpha09

9 آگوست 2023

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

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

• We have added ToggleButton for material3 ( I6bed6 )

API Changes

• 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. Version 1.0.0-alpha08 contains these commits.

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

• 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 Changes

• 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 )

Version 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.

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

• 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 )

Version 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

24 مه 2023

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

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

• 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 Changes

• 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. Version 1.0.0-alpha04 contains these commits.

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

• 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 Changes

• 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. Version 1.0.0-alpha02 contains these commits.

رفع اشکال

• 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.

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

• 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.