پوشیدن آهنگسازی

پوشیدن آهنگسازی

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

برنامه‌های Jetpack Compose را برای دستگاه‌های پوشیدنی با ارائه عملکردی برای پشتیبانی از دستگاه‌های پوشیدنی خاص، اندازه‌ها، اشکال و حرکات ناوبری بنویسید.

آخرین به روز رسانی	انتشار پایدار	کاندید را آزاد کنید	نسخه بتا	انتشار آلفا
18 سپتامبر 2024	1.4.0	-	-	1.5.0-alpha02

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

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

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

شیار

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

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

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

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

کاتلین

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

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

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

    // NOTE: DO NOT INCLUDE a dependency on androidx.compose.material:material.
    // androidx.wear.compose:compose-material is designed as a replacement
    // not an addition to androidx.compose.material:material.
    // If there are features from that you feel are missing from
    // androidx.wear.compose:compose-material please raise a bug to let us know.
}

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

بازخورد

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

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

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

Wear Compose Material3 نسخه 1.0

نسخه 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 اکنون از یک تنوع انیمیشن شکل جدید پشتیبانی می‌کنند که در آن اشکال مختلف حالت‌های علامت‌دار، بدون علامت و فشار داده شده را نشان می‌دهند. تغییر شکل متحرک قبلی برای حالت تازه فشار داده شده همچنان پشتیبانی می شود. ( I29f03 )
• ما پشتیبانی از استفاده EdgeButton با Column را به دلیل نیاز به مشخص کردن ارتفاع EdgeButton به طور صریح در ScreenScaffold حذف کردیم. ( Ie353d )
• ما پشتیبانی از Wear Compose LazyColumn با ScreenScaffold خود اضافه کرده ایم (و پیاده سازی ScrollInfoProvider را برای LazyColumnState اضافه کرده ایم). ( Ib8d29 )
• ما LocalTextMaxLines ، LocalTextAlign ، LocalTextOverflow در یک ترکیب LocalTextConfiguration واحد ترکیب کرده‌ایم تا راه‌حلی مقیاس‌پذیرتر را در آینده ارائه کنیم. ( I5edbc )
• ما arc-large را به عنوان مقیاس نوع اضافی اضافه کرده‌ایم که برای رشته‌های متنی سرصفحه کوتاه در بالا یا پایین صفحه، مانند همپوشانی‌های تأیید، رزرو شده است. ( I60e3e )
• ما پیش‌فرض‌هایی را برای اندازه‌های آیکون بزرگ و فوق‌العاده توصیه شده و پد محتوا به دکمه اضافه کرده‌ایم. ( I84675 )

رفع اشکال

• ما رنگ‌های IconButton و TextButton را به‌روزرسانی کرده‌ایم. ( I48324 )
• ما اضافه بارهای دکمه پایه را برای هماهنگی با سایر اضافه بارها به صورت عمودی در مرکز قرار داده ایم. برای بازیابی رفتار قبلی، از Modifier.align از RowScope استفاده کنید. ( 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 اضافه کرده‌ایم، یک دکمه متمایز مخصوص Wear با شکلی که از انحنای پایین صفحه پیروی می‌کند ( I16369 )
• ما یک شکاف جدید به ScreenScaffold برای دکمه پایین (مانند EdgeButton ) اضافه کرده‌ایم که بسته به محتوای پیمایش نشان داده می‌شود و اندازه آن تغییر می‌کند ( I032eb )
• ما Modifier.scrollTransform و Modifier.targetMorphingHeight را اضافه کرده‌ایم تا جلوه‌های حرکتی Material3 را به موارد در LazyColumn اضافه کنیم. ( Ie229a )
• ما SegmentedCircularProgressIndicator به عنوان یک تغییر در CircularProgressIndicator اضافه کرده‌ایم. تنوع بخش‌بندی شده یا یک مقدار پیشرفت واحد را در تمام بخش‌ها نشان می‌دهد یا هر بخش را به‌صورت روشن/خاموش نشان می‌دهد. ( I6e059 )
• ما LinearProgressIndicator به عنوان جایگزینی برای CircularProgressIndicator موجود اضافه کرده ایم. ( I89182 )
• ما AlertDialog اضافه کرده‌ایم و طرح‌بندی‌هایی را برای ارائه درخواست‌های مهم به کاربر ارائه می‌کنیم. تغییرات برای یک جفت دکمه تأیید/رد کردن یا یک دکمه پایین (معمولاً EdgeButton) در زیر مجموعه ای از گزینه ها گنجانده شده است. هر دو نسخه دارای شکاف هایی برای نماد، عنوان و متن اضافی برای ارائه جزئیات بیشتر هستند. ( Ieb873 )
• ما OpenOnPhoneDialog اضافه کرده‌ایم که باید برای نشان دادن عملکردی که در تلفن کاربر ادامه می‌یابد استفاده شود. OpenOnPhoneDialog پس از مهلت زمانی مشخص رد می شود. ( I978fd )
• ما Confirmation اضافه کرده‌ایم، یک مؤلفه گفتگو که دارای شکاف‌هایی برای نماد و متن منحنی یا خطی است. تغییرات خاصی برای پیام های موفقیت/شکست ارائه شده است. تأییدیه‌ها به‌طور خودکار پس از مهلت زمانی رد می‌شوند. ( Ib43e8 )
• ما یک پس‌زمینه به TimeText اضافه کرده‌ایم تا مشکلاتی را که محتوای اصلی و TimeText همپوشانی دارند و زمان را مبهم می‌کنند، کاهش دهیم. ( Ia11fd )
• ما LevelIndicator اضافه کرده‌ایم که مقدار تنظیمی مانند ولوم را نشان می‌دهد و می‌تواند با مولفه Stepper موجود برای ساخت یک صفحه صدا استفاده شود. LevelIndicator شبیه ScrollIndicator است، اما در سمت مقابل صفحه نمایش داده می‌شود و به طور پیش‌فرض دارای پهنای حرکت گسترده‌تر و رنگ نشانگر متفاوت است. ( I8a4ac )
• ما TimePicker با طرح‌بندی‌هایی برای ۲۴ ساعت (با یا بدون ثانیه)، یا زمان ۱۲ ساعت با انتخاب صبح/عصر اضافه کرده‌ایم. ( Ia5124 )
• ما DatePicker با پیکربندی برای ترتیب ستون (به عنوان مثال روز-ماه-سال، ماه-روز-سال یا سال-ماه-روز) و حداقل/حداکثر تاریخ‌های اختیاری اضافه کرده‌ایم. ( IBF13b )
• ما یک پارامتر وزن به تابع text TimeText اضافه کرده ایم. در مواردی که TimeText از بیش از یک عنصر متن تشکیل شده است، این امکان کنترل نحوه توزیع فضا را فراهم می کند. ( I36700 )
• ما RadioButton و SplitRadioButton اضافه کرده‌ایم - این مؤلفه‌ها API قبلی را با ترکیب هر دو (Split) SelectableButton و کنترل رادیویی کودک ( If7ae8 ) ساده می‌کنند.
• ما CheckboxButton و SplitCheckboxButton اضافه کرده‌ایم - این مؤلفه‌ها API قبلی را با ترکیب هر دو (Split) ToggleButton و کنترل Checkbox فرزند ( 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 اضافه کرده‌ایم، به طوری که پس‌زمینه‌های تصویر Button اکنون اندازه مؤلفه خود را به‌طور پیش‌فرض حفظ می‌کنند. تنظیم 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 به‌روزرسانی کرده‌ایم - این پارامترها می‌توانند توسط توسعه‌دهندگان در صورت لزوم مستقیماً در Texte15 لغو شوند ( 7 )
• ما عرض stroke پیش‌فرض LevelIndicator را به 6dp تغییر داده‌ایم تا آن را از ScrollIndicator که دارای عرض stroke 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 )

رفع اشکال

• ما اشکالی را برطرف کرده‌ایم که در آن دکمه‌های قابل انتخاب دوبار ضربه زدن را برای تغییر زمانی که قبلاً انتخاب شده بود اعلام می‌کردند. ( 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 حاوی این تعهدات است.

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

نسخه 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

• ما TimeText به کتابخانه Wear Compose Material3 اضافه کرده ایم. این مؤلفه زمان فعلی (و وضعیت اضافی) را در بالای صفحه نمایش می دهد. API جدید و مختصر Material3 از تکرار بین محتوای خطی و منحنی جلوگیری می کند. ( I4d7c3 )
• ما نام پارامترها را از onSelected به onSelect برای RadioButton به روز کرده ایم. ( I1a971 )
• 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 حاوی این commit ها است.

تغییرات API

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

نسخه 1.0.0-alpha17

7 فوریه 2024

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

تغییرات API

• ما دکمه API را برای استفاده از buttonColors به ​​طور پیش‌فرض به‌روزرسانی کرده‌ایم و filledButtonColors تکراری را حذف کرده‌ایم. ( I4fe3b )
• ما الگوهای پیش فرض را برای ButtonColors ، IconButtonColors و TextButtonColors با ایجاد یک نمونه کش داخلی و کاهش استفاده از CompositionLocal بازسازی کرده ایم. ( I5f51c )
• ما سربار rememberUpdatedState را در کلاس‌های رنگ خاص Component حذف کرده‌ایم و روش‌های دسترسی را در کلاس‌های رنگی به‌عنوان داخلی علامت‌گذاری کرده‌ایم. ( If6571 )

رفع اشکال

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

نسخه 1.0.0-alpha16

24 ژانویه 2024

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

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

• ما CompactButton اضافه کرده‌ایم که می‌تواند از همان رنگ‌های پر شده، پر شده و طرح‌ریزی شده مانند Button استفاده کند. ( I05df0 )

تغییرات API

• ما RadioButton / SplitRadioButton به عنوان محفظه هایی برای کنترل های انتخاب، مانند کنترل رادیو، اضافه کرده ایم. این با ToggleButton موجود متفاوت است زیرا RadioButton قابل انتخاب است (و در یک گروه انتخاب عمل می کند) در حالی که ToggleButton قابل تغییر است (و مستقل است). ( I61275 )
• برای سازگاری با کتابخانه Compose Material3، LocalContentAlpha از کتابخانه Wear Compose Material3 حذف می کنیم. ( I49a0a )
• Wear Material و Wear Material3 که یک MutableInteractionSource را در API خود نشان می‌دهند، به‌روزرسانی شده‌اند تا اکنون یک MutableInteractionSource قابل تهی را که پیش‌فرض آن null است، در معرض نمایش بگذارد. هیچ تغییر معنایی در اینجا وجود ندارد: عبور از null به این معنی است که شما نمی خواهید MutableInteractionSource را بالا ببرید و در صورت نیاز در داخل کامپوننت ایجاد می شود. تغییر به null به برخی از مؤلفه‌ها اجازه می‌دهد تا هرگز یک MutableInteractionSource تخصیص ندهند، و به سایر مؤلفه‌ها اجازه می‌دهد فقط در صورت نیاز، نمونه‌ای را ایجاد کنند، که عملکرد این مؤلفه‌ها را بهبود می‌بخشد. اگر از MutableInteractionSource که به این مؤلفه ها منتقل می کنید استفاده نمی کنید، توصیه می شود به جای آن، null را ارسال کنید. همچنین توصیه می شود که تغییرات مشابهی را در اجزای خود ایجاد کنید. ( Ib90fc , b/298048146 )
• API ریپل جدید را در کتابخانه های wear:compose-material و wear:compose-material3 اضافه می کند که جایگزین rememberRipple منسوخ شده است. همچنین یک CompositionLocal موقت، LocalUseFallbackRippleImplementation را اضافه می کند تا اجزای Material را به استفاده از APIهای منسوخ rememberRipple/RippleTheme برگرداند. این مورد در نسخه پایدار بعدی حذف می‌شود و فقط به عنوان کمکی موقت برای مهاجرت برای مواردی در نظر گرفته شده است که یک RippleTheme سفارشی ارائه می‌کنید. برای اطلاعات مهاجرت و اطلاعات بیشتر در زمینه این تغییر به developer.android.com مراجعه کنید. ( af92b21 )
• ما پیشرفت های جزئی در api HorizontalPageIndicator و مستندات آن ایجاد کرده ایم. ( I60efc )
• ما ColorScheme به‌روزرسانی کرده‌ایم که تغییر ناپذیر باشد، به‌روزرسانی‌های رنگی را کمتر کارآمد می‌کنیم، اما استفاده رایج‌تر از رنگ‌ها را کارآمدتر می‌کنیم. دلیل این تغییر این است که اکثر برنامه‌ها به‌روزرسانی رنگ‌های جداگانه را به عنوان یک مورد استفاده اصلی ندارند. این هنوز امکان پذیر است، اما بیش از قبل دوباره ترکیب می شود، به نوبه خود میزان اشتراک های حالت را از طریق همه کدهای مواد به طور قابل توجهی کاهش می دهیم و بر مقدار اولیه و هزینه زمان اجرا موارد استفاده استاندارد بیشتر تأثیر می گذارد. ( Ibc2d6 )
• API های ToggleButton و SplitToggleButton به روز کرد تا امکان سفارشی سازی رنگ های غیرفعال را فراهم کند. علاوه بر این، نشانه های طراحی متریال اکنون برای مقادیر رنگ و تایپوگرافی استفاده می شود. ( If087c )
• رنگ‌های پس‌زمینه تصویر دکمه‌ها را برای استفاده از نشانه‌های طراحی متریال به‌روزرسانی کرد. ( Iba215 )
• ما مولفه‌های Checkbox ، Switch و RadioButton را با حذف کنترل کلیک تغییر داده‌ایم تا فقط نمایشگر باشند. انتظار می‌رود این مؤلفه‌ها در (Split)ToggleButton که کلیک را کنترل می‌کند، استفاده شوند، بنابراین مؤلفه‌ها اکنون به وضوح به‌عنوان فقط نمایشگر نشان داده می‌شوند (و برای استفاده مستقل در Wear در نظر گرفته نشده‌اند). ( I2322e )

رفع اشکال

• ما توکن‌هایی را برای مقادیر حرکت مدت‌ها و کاهش‌ها در Wear Compose Material 3 اضافه کرده‌ایم. ( I437cd )
• ما یک اشکال را در 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 حاوی این commit ها است.

تغییرات API

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

رفع اشکال

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

نسخه 1.0.0-alpha14

18 اکتبر 2023

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

تغییرات 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 حاوی این commit ها است.

تغییرات API

• ما یک قسمت زیرنویس اختیاری به TitleCard اضافه کرده‌ایم. ( Ifc45a )
• ما نشانه های رنگی Material Design را برای TextButton اضافه کرده ایم. ( I769dc )

نسخه 1.0.0-alpha12

20 سپتامبر 2023

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

تغییرات 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 حاوی این commit ها است.

رفع اشکال

• ما تایپوگرافی کارت های 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 حاوی این commit ها است.

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

• HorizontalPageIndicator در کتابخانه Wear Material3 اضافه کنید. ( Ifee99 )

تغییرات API

• برای استفاده از توکن های طراحی Material3، کد دکمه ها را به روز کنید. ( I92fe4 )
• اعلان Wear Material 3 Stepper و Slider به عنوان آزمایشی به عنوان جزئیات رابط کاربری هنوز در حال نهایی شدن است. ( I84d54 )
• اندازه‌های ExtraSmall را از TextButton و 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 حاوی این commit ها است.

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

• ما 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 حاوی این commit ها است.

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

• ما کنترل های انتخاب زیر را برای Material3 - Switch ، Checkbox ، RadioButton اضافه کرده ایم. ( Ib918c )
• ما IconToggleButton و TextToggleButton به Material3 اضافه کرده‌ایم، یک دکمه جابجایی دایره‌ای با یک شکاف برای نماد و متن به ترتیب. برای اندازه‌های مختلف ToggleButton ، توصیه می‌کنیم از Modifier.touchTargetAwareSize با اندازه‌های ارائه‌شده در دکمه‌های جابجایی مربوطه استفاده کنید. ( I9f015 )
• ما ListHeader و ListSubheader به اجزای Material3 خود اضافه کرده ایم. ( ابائفه )
• ما Material3 SwipeToDismissBox اضافه کرده‌ایم که بنیاد جدید را SwipeToDismissBox می‌نامد و مقادیر رنگی پیش‌فرض را از موضوع آن ارائه می‌کند. ( I275fb )
• ما Material3 InlineSlider به Wear Compose اضافه کرده‌ایم. این به کاربران امکان می دهد از طیف وسیعی از مقادیر انتخاب کنند. محدوده انتخاب‌ها به‌عنوان نواری بین حداقل و حداکثر مقادیر محدوده نشان داده می‌شود که کاربران می‌توانند یک مقدار واحد را انتخاب کنند. InlineSlider برای تنظیم تنظیماتی مانند صدا یا روشنایی ایده آل است. ( I7085f )

تغییرات API

• ما تم Shapes in Wear Material 3 را به‌روزرسانی کرده‌ایم تا از RoundedCornerShape به جای Shape استفاده کنیم. ( Idb133 )
• ما ثابت‌های ارتفاع را برای Button عمومی کرده‌ایم ( Idbfde )
• فایل های API به روز شده برای حاشیه نویسی حذف سازگاری ( I8e87a , b/287516207 )
• ما InlineSliderColors در Wear Compose Material 3 به‌روزرسانی کرده‌ایم تا ویژگی‌های سازنده عمومی و عمومی داشته باشد. ( I6b632 )
• ما تمام کلاس‌های رنگ را در Wear Compose Material 3 به‌روزرسانی کرده‌ایم تا سازنده‌های عمومی و ویژگی‌های عمومی داشته باشیم. ( I17702 )
• ما ثابت های لایه افقی و عمودی دکمه را عمومی کرده ایم. ( Ieeaf7 )

رفع اشکال

• دکمه اکنون ارتفاع خود را تنظیم می‌کند تا محتوایی را که به دلیل فونت‌های بزرگ برای دسترسی افزایش یافته است، در صورت لزوم تنظیم کند ( Iaf302 )
• ما تعدادی دمو دکمه را برای رسیدگی به مشکلات دسترسی به روز کرده ایم. ( I61ce9 )
• Stepper و InlineSlider اکنون از کلیک‌های مکرر در فشار طولانی پشتیبانی می‌کنند تا بتوانید با نگه داشتن دکمه‌های + یا - به سرعت مقدار Stepper و InlineSlider را افزایش/کاهش دهید ( I27359 )

نسخه 1.0.0-alpha07

21 ژوئن 2023

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

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

• ما جزء Stepper را به کتابخانه Compose for Wear OS Material 3 خود اضافه کرده ایم. این شبیه به نسخه قبلی Material است، اما به دنبال بازخورد توسعه‌دهندگان، به‌طور پیش‌فرض معنای محدوده را حذف نمی‌کند. ما Modifier.rangeSemantics مواردی را که به معنای محدوده مورد نیاز است ارائه می کنیم. ( IC39fd )
• ما curvedText به کتابخانه Compose for Wear OS Material 3 خود اضافه کرده‌ایم. ( Ia8ae3 )

رفع اشکال

• ما wear.compose.foundation به‌روزرسانی کرده‌ایم تا وابستگی API مربوط به wear.compose.material3 باشد ( I72004 , b/285404743 )

نسخه 1.0.0-alpha06

7 ژوئن 2023

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

رفع اشکال

• ما TextButton برای استفاده از تابع پسوند toDisabledColor برای صحیح مقادیر آلفای غیرفعال شده به روز کرده ایم. ( I814c8 )

نسخه 1.0.0-alpha05

24 مه 2023

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

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

• ما TextButton به Material3 اضافه کرده‌ایم، یک دکمه دایره‌ای با یک شکاف برای متن. برای اندازه های مختلف TextButton ، توصیه می کنیم از Modifier.touchTargetAwareSize و ExtraSmallButtonSize ، SmallButtonSize ، DefaultButtonSize و LargeButtonSizeIcon ارائه شده در TextButtonDefaults استفاده کنید. TextButton پیش‌فرض هیچ حاشیه و پس‌زمینه شفافی برای اقدامات با تاکید کم ندارد. برای اقداماتی که نیاز به تاکید زیاد دارند، از filledTextButtonColors استفاده کنید. برای تاکید متوسط، که TextButton مشخص شده است، مرز را روی ButtonDefaults.outlinedButtonBorder تنظیم کنید. برای حد وسط بین خطوط مشخص و پر شده، از filledTonalTextButtonColors استفاده کنید. ( I667e4 )
• ما Card ، OutlinedCard ، AppCard و TitleCard به کتابخانه Wear Compose Material3 اضافه کرده‌ایم. AppCard و TitleCard همچنین می‌توانند با استفاده از CardDefaults.outlinedCardColors و CardDefaults.outlinedCardBorder ظاهر مشخصی داشته باشند ( I80e72 )

تغییرات API

• ما پارامتر برچسب Button را به انتها منتقل کرده ایم تا از نحو لامبدا انتهایی پشتیبانی کند و پارامتر نقش را حذف کرده ایم (زیرا می توان با استفاده از Modifier.semantics این را نادیده گرفت). سازنده های ButtonColors اکنون عمومی هستند. ( Ie1b6d )

نسخه 1.0.0-alpha04

10 مه 2023

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

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

• ما IconButton به Material3 اضافه کرده‌ایم، یک دکمه دایره‌ای با یک شکاف برای نماد/تصویر. چهار تغییر وجود دارد: IconButton ، FilledIconButton ، FilledTonalIconButton و OutlinedIconButton . برای اندازه های مختلف IconButton ، توصیه می کنیم از Modifier.touchTargetAwareSize و ExtraSmallButtonSize ، SmallButtonSize ، DefaultButtonSize و LargeButtonSizeIcon ارائه شده در IconButtonDefaults استفاده کنید. ما همچنین IconButtonDefaults.iconSizeFor را برای تعیین اندازه نماد توصیه شده برای اندازه دکمه مشخص ارائه می دهیم. ( I721d4 )

نسخه 1.0.0-alpha03

19 آوریل 2023

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

تغییرات API

• ما مولفه Material 3 Button را اضافه کرده‌ایم - این دکمه استادیوم شکل ما است و قبلاً Chip در کتابخانه Wear Compose Material نامیده می‌شد (برای سازگاری با کتابخانه Compose Material 3 به Button تغییر نام داده است). دکمه پیش‌فرض دارای پس‌زمینه پر شده است و تغییرات دکمه‌ای برای FilledTonal (پس‌زمینه خاموش)، Outlined (شفاف با حاشیه نازک) و Child (پس‌زمینه شفاف و بدون حاشیه، برای اقدامات تکمیلی با کمترین میزان برجستگی استفاده می‌شود) وجود دارد. دکمه‌های گرد برای آیکون ساده و محتوای متنی در نسخه بعدی دنبال خواهند شد. ( Ia6942 )

نسخه 1.0.0-alpha02

5 آوریل 2023

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

رفع اشکال

• ما یک DefaultTextStyle به Wear Compose Material 3 اضافه کرده‌ایم که PlatformTextStyle.includeFontPadding را به‌طور پیش‌فرض به true (تنظیم فعلی) می‌دهد. این به ما این امکان را می‌دهد که در آینده خاموش کردن پد فونت را به‌طور پیش‌فرض با کتابخانه‌های Compose همگام‌سازی کنیم ( برای پس‌زمینه به رفع پد فونت در Compose مراجعه کنید). ( I7e461 )

نسخه 1.0.0-alpha01

22 مارس 2023

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

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

• Material 3 تکامل بعدی متریال دیزاین است و شامل تم به روز شده و اجزای بازطراحی شده است. Material 3 on Wear Compose طوری طراحی شده است که با کتابخانه Material 3 Compose در Android منسجم باشد. این اولین نسخه آلفا شامل اجرای اولیه و کاربردی موارد زیر است:

  • موضوع مواد - طرح رنگ، تایپوگرافی و اشکال را به طور پیوسته در اجزای کتابخانه پیکربندی می کند. تم Material3 رنگ‌هایی را اصلاح کرده است که کنتراست قابل دسترس را پشتیبانی می‌کنند. ( I84005 )
  • متن/آیکون - بلوک‌های ساختمان برای برنامه‌های Wear Compose ( I8e06a )

• ما به توسعه Wear Material ( androidx.wear.compose:compose-material ) و Wear Material 3 ( androidx.wear.compose:compose-material3 ) به صورت موازی ادامه خواهیم داد. نسخه‌های بعدی Material3 مجموعه ویجت را گسترش می‌دهد تا سایر اجزای آشنا از Compose for Wear OS مانند دکمه‌ها، انتخاب‌کننده‌ها و لغزنده‌ها را در بر بگیرد.

• کتابخانه‌های Wear Material و Wear Material 3 متقابلا انحصاری هستند و نباید در یک برنامه ترکیب شوند، در درجه اول به این دلیل که به مضامین مختلفی اشاره می‌کنند که منجر به تناقضات غیرمنتظره می‌شود.

Wear Compose نسخه 1.5

نسخه 1.5.0-alpha02

18 سپتامبر 2024

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

تغییرات API

• ما پشتیبانی از Wear Compose LazyColumn با ScreenScaffold خود اضافه کرده ایم (و پیاده سازی ScrollInfoProvider را برای LazyColumnState اضافه کرده ایم). ( Ib8d29 )
• ما viewportSize به LazyColumnLayoutInfo اضافه کرده ایم. ( I4187f )

رفع اشکال

• ما یک اشکال را برطرف کرده‌ایم تا زمانی که پرچم userScrollEnabled روی false تنظیم شده باشد، اسکرول چرخشی اکنون در ScalingLazyColumn غیرفعال است. ( I490ab , b/360295825 )
• ما یک رفع اشکال برای پرداختن به پدهای عمودی غیرمنتظره در متن منحنی ایجاد کرده‌ایم. ارتفاع متن منحنی اکنون بیشتر با فضای واقعی استفاده شده توسط متن مطابقت دارد. لطفاً توجه داشته باشید که این احتمالاً تست های اسکرین شات را که شامل متن منحنی هستند ( Iaa6ef ) می کند.
• ما یک رفع اشکال را به Dialog برگردانده‌ایم که در آن زمانی که showDialog روی نادرست تنظیم شده بود، پاسخ به تماس onDismissRequest فراخوانی شد، زیرا در برخی موارد باعث می‌شود که onDismissRequest چندین بار فراخوانی شود. ( I64656 )

نسخه 1.5.0-alpha01

4 سپتامبر 2024

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

تغییرات API

• ما یک LazyColumn جدید به کتابخانه Wear Compose Foundation با API های LazyColumnState و LazyColumnScope مرتبط اضافه کرده ایم. این به عنوان پایه ای برای ایجاد مقیاس بندی و جلوه های شکل گیری قابل تنظیم با Wear Compose عمل می کند. ( Ib3b22 )
• ما یک نسخه نمایه شده از itemsIndexed را به عنوان بخشی از LazyColumn API جدید به LazyColumnScope اضافه کرده ایم. ( Ib4a57 )
• ما اصلاح‌کننده‌های LazyColumn را اضافه کرده‌ایم تا از رفتارهای مقیاس‌بندی و شکل‌گیری پشتیبانی کنیم. ( Ie229a )
• HierarchicalFocusCoordinator به پایدار ارتقا یافته است. ( I31035 )
• ما پشتیبانی از فاصله حروف را به متن منحنی اضافه کرده ایم. ( I3c740 )
• یک پارامتر rotationLocked به CurvedLayout.curvedComposable اضافه کرد تا چرخش اجزا را متوقف کند. ( I66898 )
• API موقت LocalUseFallbackRippleImplementation از مواد سایش و سایش مواد3 حذف شده است ( I62282 )
• WearDevices.SQUARE از پیش‌نمایش چندگانه @WearPreviewDevices حذف کرد ( I11c02 )

رفع اشکال

• SwipeToReveal اکنون موارد آشکار شده را در قسمت قابل مشاهده صفحه نمایش قرار می دهد، این به زمانی کمک می کند که SwipeToReveal در یک لیست استفاده شود، بنابراین موارد همیشه قابل تعامل هستند و هرگز خارج از صفحه نمایش قرار نمی گیرند. ( I38929 )
• اکنون SwipeToReveal پس از تکمیل animatedTo lastActionType را به None بازنشانی می‌کند. ( I59b03 )
• اسناد را برای پارامتر جدید rotationLocked در curvedComposable بهبود بخشید. ( Ifbd57 )
• خرابی هنگام عبور NaN به ScalingLazyColumnSnapFlingBehavior 's performFling رفع شد. ( IC13da )
• رفع اشکال در اصلاح کننده اندازه طرح منحنی ( I0fedf )
• ما برای فاصله حروف مشخص شده در 'sp' پشتیبانی اضافه کرده ایم. ( I9f6e3 )
• ما یک اشکال در گفتگوی Material2 را برطرف کرده‌ایم که در آن هنگام نامرئی شدن گفتگو، پاسخ تماس onDismissRequest فراخوانی نمی‌شد ( I64656 )
• تغییر نام LayoutCoordinates.introducesFrameOfReference به LayoutCoordinates.introducesMotionFrameOfReference برای انعکاس بهتر هدف آن. تغییر نام تابع مرتبط برای محاسبه مختصات بر اساس آن پرچم. ( I3a330 )

نسخه 1.4

نسخه 1.4.0

4 سپتامبر 2024

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

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

• ScalingLazyColumn و Picker اکنون به طور پیش‌فرض از ورودی چرخشی پشتیبانی می‌کنند - توصیه می‌شود کنترل چرخشی صریح را حذف کنید و به رفتار سیستم پیش‌فرض موکول کنید. در صورت لزوم، از پارامتر rotaryScrollableBehavior برای پیکربندی رفتار اسکرول یا snap استفاده کنید - برای رفتار snap، توصیه می‌شود با استفاده از پارامتر flingBehavior قابلیت‌های رفتار ضربه‌ای و پیمایش لمسی را ارائه دهید.
• Modifier.rotaryScrollable اصلاح‌کننده جدیدی است که رویدادهای چرخشی را با محفظه‌های قابل پیمایش متصل می‌کند و به کاربران امکان می‌دهد با استفاده از یک تاج یا یک قاب چرخان روی دستگاه Wear OS خود پیمایش کنند.
• SwipeDismissableNavHost اکنون یک انیمیشن ورودی برای انتقال درون برنامه ارائه می دهد.
• اکنون هنگامی که صفحه ای برای اولین بار نمایش داده می شود، PositionIndicator به طور پیش فرض نشان داده می شود.

تغییرات اضافی

• برای مجموعه کامل‌تری از تغییرات معرفی‌شده در نسخه 1.3.0، به یادداشت‌های انتشار beta01 مراجعه کنید.

نسخه 1.4.0-rc01

21 آگوست 2024

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

• ما وابستگی های Compose را به 1.7.0-rc01 به روز کرده ایم و Wear Compose Navigation را به androidx.lifecycle 2.8.3 پین کرده ایم.

نسخه 1.4.0-beta03

12 ژوئن 2024

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

رفع اشکال

• ما Modifier.rotaryScrollable به‌روزرسانی کرده‌ایم تا استفاده از «focusable» را با «focusTarget» جایگزین کنیم که عملکرد را بهبود می‌بخشد. ( ID294b )
• ما مشکلی را برطرف کردیم که در آن ProgressIndicator اعلامیه خود را در TalkBack تکرار کرد. ( I94563 )
• نمایه‌های خط پایه کتابخانه Wear Compose را به‌روزرسانی کرده‌ایم. ( I3cbc3 )

نسخه 1.4.0-beta02

29 مه 2024

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

رفع اشکال

• ما عرض مرز ارسال شده به صفحه‌خوان‌ها را از متن منحنی افزایش داده‌ایم تا مشکلات مربوط به برش ( Id865f ) را برطرف کنیم.
• ما مرز HorizontalPageIndicator را که به صفحه‌خوان‌ها منتقل شده بود محدود کرده‌ایم - قبلاً نشانگر تمام صفحه را اشغال می‌کرد ( Id8d7a ).

نسخه 1.4.0-beta01

14 مه 2024

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

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

• ما Modifier.rotaryScrollable اضافه کرده ایم. rotaryscrollable ، یک اصلاح کننده جدید که رویدادهای چرخشی را با ظروف قابل پیمایش متصل می کند ، به کاربران امکان می دهد از طریق تاج یا یک حاشیه چرخان در دستگاه OS Wear خود حرکت کنند. علاوه بر این ، ScalingLazyColumn و Picker اکنون به طور پیش فرض از ورودی چرخشی پشتیبانی می کنند. برای پیکربندی یا رفتار SNAP از پارامتر rotaryScrollableBehavior استفاده کنید. برای رفتار SNAP ، توصیه می شود SNAP را از طریق پارامتر flingBehavior و همچنین برای پیمایش لمسی تهیه کنید.
• SwipeDismissableNavHost اکنون یک انیمیشن ورودی برای انتقال درون برنامه را فراهم می کند.
• اکنون هنگام نمایش یک صفحه نمایش به طور PositionIndicator فرض به طور پیش فرض نشان داده می شود.
• SelectableChip و SplitSelectableChip به عنوان تنوع در ToggleChip اضافه شده اند - از این استفاده کنید تا با RadioButton برای ارائه معناشناسی قابل انتخاب به جای معناشناسی قابل جابجایی برای دسترسی استفاده کنید.
• ListHeader اکنون از تنظیمات ارتفاع پشتیبانی می کند وقتی که محتویات به ارتفاع اضافی نیاز دارند تا اندازه های بزرگ فونت را در خود جای دهد.

رفع اشکال

• ما یک اشکال را برطرف کرده ایم که تراشه های قابل انتخاب اعلام کرده اند تا در هنگام انتخاب ، ضربه بزنید. ( i7ed88 )

نسخه 1.4.0-alpha08

1 مه 2024

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

تغییرات API

• ما تغییرات زیر را در API Rotary جدید ایجاد کرده ایم: تغییر Modifier.rotary توسط Modifier.rotaryScrollable رابط RotaryBehavior به RotaryScrollableBehavior و عملکرد آن handleScrollEvent به performScroll تغییر نام داد. RotaryScrollableAdapter به RotaryScrollableLayoutInfoProvider تغییر نام داد و خاصیت scrollableState را حذف کرد. ( i0c8a6 )
• ما تغییرات اضافی در Rotary API ایجاد کرده ایم: تغییر نام RotaryScrollableLayoutInfoProvider به RotarySnapLayoutInfoProvider (زیرا این ارائه دهنده فقط برای دوار با SNAP مورد نیاز است). نوع پارامتر snapOffset را در RotaryScrollableDefaults.snapBehavior snapOffset از int به DP تغییر داد. ( iddebe )
• ما به پارامتر clickInteractionSource در SplitSelectableChip به containerInteractionSource تغییر نام داده ایم. ( IA8F84 )
• ما نام پارامتر Click Callback را برای SplitSelectableChip به روز کرده ایم - از onClick به onSelectionClick و از onBodyClick به onContainerClick . ( i32237 )

رفع اشکال

• ما بالشتک افقی را برای PositionIndicator به 2DP (5DP) به روز کرده ایم ، تا یک اشکال را برطرف کنیم که در آن PositionIndicator (نوار پیمایش) با محتوای قابل پیمایش همپوشانی داشته باشد. لطفاً توجه داشته باشید که انتظار می رود این تغییر تصاویر موجود را شامل شود که به دلیل تغییر بالشتک PositionIndicator شامل می شود. ( i57472 )
• ما با توصیف تفاوت بین دستگاه های چرخشی کم و RES HI-Res ، مستندات مربوط به API Rotary جدید را بهبود بخشیده ایم. ( i63abe )
• ما به یک استثناء خارج از حد در SwipeDismissableNavHost پرداخته ایم که می تواند در هنگام مقادیر آلفا درون یابی کمتر از صفر باشد. ( IB75A1 ، B/335782510 )

نسخه 1.4.0-alpha07

17 آوریل 2024

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

تغییرات API

• ما Modifier.rotary اضافه کرده ایم ، یک اصلاح کننده جدید که رویدادهای چرخشی را با ظروف قابل پیمایش متصل می کند ، به کاربران امکان می دهد از طریق یک تاج یا یک صفحه چرخشی در دستگاه Wear OS خود حرکت کنند. علاوه بر این ، ScalingLazyColumn و Picker اکنون به طور پیش فرض از ورودی Rotary پشتیبانی می کنند ، با اضافه بار جدید که شامل پارامتر rotaryBehavior برای مشخص کردن پیکربندی هر یک از پیمایش یا SNAP است. اگر پارامتر rotaryBehavior روی SNAP تنظیم شده است ، توصیه می شود SNAP را از طریق پارامتر flingBehavior نیز برای پیمایش لمسی تهیه کنید. ( i2ef6f )
• منابع NestedScroll و توینگ و چرخیدن توسط UserInput جایگزین و SideEffect جایگزین می شوند تا برای تعریف گسترده این منابع که اکنون شامل انیمیشن ها (عوارض جانبی) و چرخ ماوس و صفحه کلید (UserInput) هستند ، جای بگیرد. ( i40579 )
• ما SelectableChip و SplitSelectableChip اضافه کرده ایم تا تمایز بین کنترل های ضامن مانند Switch/Checkbox و کنترل های قابل انتخاب مانند RadioButton روشن تر شود. این جایگزین اضافه بار اضافه شده از ToggleChip/SplitToggleChip با پارامترهای selectionControl است. ( IA0217 )
• اصلاح کننده دید به روز شده از IndeterminateStrokeWidth در ProgressIndicatorDefaults به عموم. ( i5b5a4 )

نسخه 1.4.0-alpha06

3 آوریل 2024

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

رفع اشکال

• ما به عنوان بخشی از تلاش بیشتر برای مهاجرت رفتارهای چرخشی به Androidx از Horologist ، پیش نویس داخلی پشتیبانی چرخشی اضافه کرده ایم. ( i617d1 )
• ما به عنوان بخشی از تلاش بیشتر برای مهاجرت رفتارهای چرخشی به Androidx از Horrostic ، پیش نویس داخلی پشتیبانی از هاپتیک را اضافه کرده ایم. ( i5568a )

نسخه 1.4.0-alpha05

20 مارس 2024

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

تغییرات API

• ما خواص initialCenterItemIndex و initialCenterItemScrollOffset را از عمومی ScalingLazyListState عمومی ساخته ایم. ( I0C616 )
• ما FullScreenStrokeWidth را از ProgressIndicatorDefaults عمومی ساخته ایم. ( IBEA23 )

رفع اشکال

• ما با کاهش تعداد تماس های layoutInfo از ScalingLazyColumn ، عملکرد PositionIndicator را بهبود بخشیده ایم. ( IDC83D )

نسخه 1.4.0-alpha04

6 مارس 2024

androidx.wear.compose:compose-*:1.4.0-alpha04 منتشر شده است. نسخه 1.4.0-alpha04 شامل این تعهدات است.

تغییرات API

• ما یک اضافه بار جدید برای ToggleChip و SplitToggleChip اضافه کرده ایم که به جای پارامتر toggleControl ، یک پارامتر selectionControl را می گیرد. این باید با کنترل RadioButton استفاده شود تا به جای معانی قابل جابجایی برای دسترسی ، معنایی قابل انتخاب را ارائه دهد ( I1D6D9 )
• ما نام پارامتر را برای اضافه بار جدید selectionControl از onSelected به onSelect برای ToggleChip و SplitToggleChip ( I1A971 ) به روز کرده ایم.

نسخه 1.4.0-alpha03

21 فوریه 2024

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

تغییرات API

• بسته بندی Modifier.inspectable . این API بیش از حد لازم از اصلاح کننده شما ایجاد می کند ، بنابراین اکنون استفاده از آن دلسرد می شود. در صورت تمایل به افشای ویژگی های اصلاح کننده در ابزار ، از توسعه دهندگان به اجرای روش inspectableProperties() در ModifierNodeElement تشویق می شوند. ( IB3236 )

رفع اشکال

• ما یک اشکال اسناد را برای حاشیه نویسی WearPreview* برطرف کرده ایم. ( id526d )

نسخه 1.4.0-alpha02

7 فوریه 2024

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

رفع اشکال

• ما یک اشکال را در کشش به آشکار برطرف کرده ایم ، جایی که با شروع به کشیدن یک مورد دیگر ، می توان با (و لغو) یک عمل متعهد را روی یک مورد تعامل کرد. ( IDE059 )
• ما ListHeader برای پشتیبانی از تنظیمات ارتفاع به روز کرده ایم وقتی که محتویات به ارتفاع اضافی برای داشتن اندازه های بزرگ فونت نیاز دارند. ( i7290c ، b/251166127 )

نسخه 1.4.0-alpha01

24 ژانویه 2024

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

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

• ما انیمیشن ورودی را به SwipeDismissableNavHost برای انتقال درون برنامه اضافه کرده ایم. ( CFEB79a )
• اکنون هنگام نمایش یک صفحه نمایش به طور PositionIndicator فرض به طور پیش فرض نشان داده می شود. این تغییر به منظور کمک به رعایت دستورالعمل های کیفیت سایش معرفی شد. متأسفانه ، این بدان معناست که تست های تصویر باید روی صفحه نمایش هایی که شامل PositionIndicator است ، به روز شود ، زیرا قبلاً PositionIndicator نمایش داده نمی شد. ( 419CEF7 )

تغییرات API

• ما یک API جدید Ripple را در wear:compose-material and wear:compose-material3 که جایگزین rememberRipple مستهلک شده است. همچنین یک CompositionLocal موقت موقت ، LocalUseFallbackRippleImplementation استفاده می کند ، اما در صورت بازگشت اجزای مواد به استفاده از API های مستهلک شده rememberRipple/RippleTheme بازگرداندن اجزای مواد. این در نسخه پایدار بعدی حذف خواهد شد و فقط در مواردی که در حال ارائه یک RippleTheme سفارشی هستید ، کمک به مهاجرت موقت است. برای اطلاعات مهاجرت و اطلاعات بیشتر در زمینه این تغییر ، به Developer.android.com مراجعه کنید. ( AF92B21 )
• ما ColorScheme به روز کرده ایم که تغییر ناپذیر باشد ، و به روزرسانی های رنگ فردی کارآمدتر می شود ، اما استفاده متداول تر از رنگ ها را کارآمدتر می کند. استدلال در مورد این تغییر این است که اکثر برنامه ها به روزرسانی رنگهای فردی را به عنوان یک مورد اصلی استفاده نمی کنند. این هنوز هم امکان پذیر است اما بیشتر از گذشته بازخوانی خواهد کرد ، به نوبه خود ما به طور قابل توجهی میزان اشتراک های حالت را از طریق تمام کد مواد کاهش می دهیم و بر اولیه سازی و هزینه زمان اجرای موارد استفاده استاندارد تأثیر می گذارد. ( F5C48B7 )
• مواد سایش و سایش مواد 3 اجزای در معرض MutableInteractionSource در API خود به روز شده اند تا در حال حاضر یک MutableInteractionSource قابل تهی را که به طور پیش فرض برای تهی است ، در معرض دید قرار دهند. در اینجا هیچ تغییر معنایی وجود ندارد: عبور از تهی به این معنی است که شما مایل به بلند کردن MutableInteractionSource نیستید و در صورت لزوم در داخل مؤلفه ایجاد می شود. تغییر در تهی به برخی از مؤلفه ها اجازه می دهد تا هرگز یک MutableInteractionSource اختصاص ندهند ، و به سایر مؤلفه ها اجازه می دهد تا فقط در هنگام نیاز به تنبلی یک نمونه را ایجاد کنند و این باعث بهبود عملکرد در این مؤلفه ها می شود. اگر از MutableInteractionSource استفاده نمی کنید که به این مؤلفه ها منتقل می کنید ، توصیه می شود به جای آن NULL را منتقل کنید. همچنین توصیه می شود که تغییرات مشابهی را در اجزای خود ایجاد کنید. ( F8FA920 )
• ما برای صرفه جویی در حالت قابل ارتقاء ، rememberExpandableState به روز کرده ایم. این تضمین می کند که داده ها هنگام حرکت به صفحه دیگر ذخیره می شوند و هنگام بازگشت به صفحه اصلی بازسازی می شوند. ( 5C80095 )

رفع اشکال

• ما تنظیمات ReduceMotion را برای استفاده از یک شنونده آگاه از چرخه عمر به روز کرده ایم. ( 7C6B122 )
• ما شنونده TouchExplorationStateProvider را به روز کرده ایم تا از چرخه عمر آگاه باشد ( BE28B01 )
• ما لایه MaterialCore را برای CompactButton برای بهبود عملکرد حذف کرده ایم ( 25db8e9 )
• ما برای جلوگیری از استثنائات ، BasicSwipeToDismissBox برای جبران خسارات نان قوی تر کرده ایم ( B983739 )
• ما BasicSwipeToDismissBox به روز کرده ایم تا اطمینان حاصل کنیم که مقادیر آلفا در محدوده 0،1 قرار دارند
• ما یک اشکال را در ToggleButton ، SplitToggleButton ، Checkbox ، Switch و RadioButton برطرف کرده ایم تا اعلامیه های دسترسی تکرار نشوند (قبلاً نقش های معنایی کپی شده بودند) ( D11EEB7 )

نسخه 1.3

نسخه 1.3.1

3 آوریل 2024

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

رفع اشکال

• ما یک اشکال را در کشش به یک آشکار برطرف کرده ایم ، جایی که با شروع به کشیدن یک مورد دیگر ، می توان با (و لغو) یک اقدام متعهد را روی یک مورد انجام داد. ( IDE059 )

نسخه 1.3.0

24 ژانویه 2024

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

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

• کلاس SwipeToDismissBoxState ، شمارش SwipeToDismissValue و Modifier.edgeSwipeToDismiss اکنون در حال حاضر هر بخش از بسته androidx.wear.compose.foundation ، به جای بسته androidx.wear.compose.material . این معماری به روز شده به شما امکان می دهد تا کنترل ژست را به طور مستقل از سایر ملاحظات طراحی پیاده سازی کنید. گردش کار طراحی مواد ، مانند استفاده از رنگ ها از یک موضوع پیکربندی شده ، به طور جداگانه اداره می شوند.
• کلاسهای SwipeToRevealCard و SwipeToRevealChip به شما در اجرای recommended swipe-to-reveal guidance کمک می کنند. کلاس SwipeToRevealSample نحوه استفاده از این مؤلفه ها را نشان می دهد.

• نسخه 1.3.0-alpha02 ما تغییراتی را ایجاد کرد که باعث می شود اشیاء Chip و ToggleChip در ارتفاع رشد کنند تا از مقیاس گذاری فونت انتخاب شده کاربر بهتر پشتیبانی کنند. این می تواند باعث بروز برخی از قطع شود. برای رفع این مشکل ، شکل large برای MaterialTheme اکنون از شعاع گوشه ای بزرگتر (26 dp به جای 24 dp) استفاده می کند. اشیاء Chip و ToggleChip از این شعاع گوشه جدید برای جلوگیری از قطع محتوای در گوشه های تراشه و ToggleChip استفاده می کنند.

  • با توجه به ارتفاع پیش فرض 52 DP ، بیشتر Chips و ToggleChips بدون تغییر هستند. با این حال ، اشیاء Chip و ToggleChip که حاوی چندین خط از متن برچسب اولیه یا ثانویه هستند ، یا ارتفاع آن بیش از حد است ، می تواند باعث شکسته شدن آزمایش های تصویر شود.

تغییرات اضافی

برای یک مجموعه کامل تر از تغییرات معرفی شده در نسخه 1.3.0 ، به یادداشت های انتشار Beta01 مراجعه کنید.

توصیه هایی برای اجرای

• اگر برنامه شما به کاربران اجازه می دهد تا محتوای صفحه نمایش را مانند یک برنامه مبتنی بر نقشه بچرخانند ، با تنظیم userSwipeEnabled به false در SwipeDismissableNavHost ، دست زدن به کشویی را خاموش کنید و دکمه ای را شامل می شود که به کاربران امکان می دهد به صفحه قبلی بروند.
• برای خاموش کردن انیمیشن ها برای یک نشانگر موقعیت در حین انیمیشن های محو و تغییر موقعیت در یک لیست پیمایش ، از یک شی SnapSpec استفاده کنید.
• در حالی که منتظر بارگذاری یک برنامه رسانه ای برای بارگیری محتوا برای پخش هستید ، یک ترکیب Placeholder خالی را نشان دهید.
• برای ایجاد مجموعه ای از موارد قابل ارتقاء در صورت تقاضا ، با استفاده از کلاس ExpandableStateMapping استفاده کنید.

نسخه 1.3.0-rc01

10 ژانویه 2024

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

رفع اشکال

• ما شکل بزرگ MaterialTheme را برای استفاده از شعاع گوشه ای 26DP به روز کرده ایم و این اکنون توسط Chip و ToggleChip استفاده می شود. این تغییر برای پشتیبانی از تنظیمات ارتفاع مورد نیاز است در حالی که محتویات به ارتفاع اضافی نیاز دارند تا اندازه های بزرگ فونت را در خود جای دهند - در غیر این صورت ، شکل استادیوم موجود برخی از محتوای متن را کلی می کند.

  

  شکل 1 : متن بریده شده در گوشه ها.

  

  شکل 2 : متن قطع نشده است.

  این تغییر ممکن است باعث شکستگی در تست های تصویر شود. ( i2e6ae )

نسخه 1.3.0-beta02

13 دسامبر 2023

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

رفع اشکال

• ما حرکت کشویی در نظر گرفته شده را در BasicSwipeToDismissBox بازیابی کرده ایم. این در نسخه قبلی تغییر یافته بود ، به گونه ای که قسمت اسلاید انتقال در حالی که انگشت در حال لمس صفحه بود ، رخ داده است. ( id8e76 )

نسخه 1.3.0-beta01

15 نوامبر 2023

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

نسخه 1.3 بتا 01 آهنگسازی برای سیستم عامل Wear نشان می دهد که این نسخه از کتابخانه کامل است و API قفل شده است (به جز جایی که به عنوان آزمایشی مشخص شده است). Wear Compose 1.3 شامل قابلیت های جدید زیر است:

• SwipeToDismissBoxState ، SwipeToDismissValue و Modifier.edgeSwipeToDismiss از androidx.wear.compose.material به androidx.wear.compose.foundation به همراه اجرای زیر فشار به دیسمیس در BasicSwipeToDismissBox منتقل شده است. این اجازه می دهد تا حرکت ژست برای ضربه تند وشدید زدن به دیسمیس به طور مستقل از طراحی مواد ، به عنوان مثال از SwipeDismissableNavHost در androidx.wear.compose.navigation استفاده شود. SwipeToDismissBox از androidx.wear.compose.material هنوز هم توصیه می شود که با طراحی مواد استفاده شود ، زیرا رنگ ها را از MaterialTheme بیرون می کشد ، سپس اجرای باقی مانده را به BasicSwipeToDismissBox واگذار می کند.
• SwipeDismissableNavHost اکنون از یک پارامتر جدید userSwipeEnabled پشتیبانی می کند تا بتوانید دست زدن به کش رفتن را برای صفحه هایی که در آن لازم نیست خاموش کنید.
• BasicSwipeToDismissBox با استفاده از HierarchicalFocusCoordinator کنترل تمرکز را بهبود بخشیده است.
• SwipeToReveal دارای آهنگ های جدید SwipeToRevealCard و SwipeToRevealChip در مواد است که از راهنمایی UX توصیه شده برای Card و Chip پیروی می کنند. همچنین پشتیبانی از عمل ثانویه دارد.
• DefaultTextStyle اکنون بالشتک قلم را خاموش می کند تا در پلتفرم Android سازگار باشد.
• Chip و ToggleChip اکنون ارتفاع خود را تنظیم کنید تا محتوایی را که به دلیل فونت های بزرگ برای دسترسی رشد کرده است ، در خود جای دهد
• اکنون PositionIndicator دارای مشخصات انیمیشن فردی برای انیمیشن های محو ، محو شدن و تغییر موقعیت است. به دلایل عملکرد ، توصیه می کنیم هنگام استفاده از لیست های قابل پیمایش ، تغییر مکان و تغییر موقعیت خاموش شود.
• ExpandableStateMapping روش جدیدی برای تولید ExpandableStates در صورت نیاز به ایجاد تقاضا و لزوماً با دامنه @Composable فراهم نمی کند.
• اگر محتوای دیگر در حالت آماده نباشد ، Placeholder اجازه می دهد تا تنظیم مجدد شود. همچنین ، تنظیم حرکت کاهش اکنون در مورد اثر لرزان و حرکت پاک کردن بر روی Placeholder اعمال می شود.

مسائل شناخته شده

• در ابتدا هنگام نمایش صفحه نمایش ، PositionIndicator در ابتدا نشان داده نمی شود. ما قصد داریم در اوایل 1.4 آلفا تغییر ایجاد کنیم تا در ابتدا نشان داده شود ، اما بدون هیچ انیمیشن.

تغییرات API

• ما به SwipeToDismissBox سطح بنیاد به BasicSwipeToDismissBox تغییر نام داده ایم. این باعث می شود تمایز بین مؤلفه سطح پایه و سطح مواد SwipeToDismissBox واضح تر شود. حالت دوم رنگها را از MaterialTheme برای استفاده در Scrims و نمایندگان اجرای باقی مانده را به BasicSwipeToDismissBox منتقل می کند. ( ibecfc )
• ما rememberExpandableStateMapping به عنوان تجربی مشخص کرده ایم و عملکرد expandableItem را بهبود بخشیده ایم. ( i5f6bc )
• ما کلاس SwipeToRevealAction را در کارت SwipeToReveal Material و API های تراشه با یک API مبتنی بر شکاف با استفاده از SwipeToRevealPrimaryAction ، SwipeToRevealSecondaryAction و SwipeToRevealUndoAction Composables جایگزین کرده ایم. لطفاً برای نمونه هایی در مورد نحوه استفاده از API جدید ، کد نمونه را مشاهده کنید. ( IA8943 )
• ما پرچم های انیمیشن PositionIndicator را با پارامترهای AnimationSpec جایگزین کرده ایم. انیمیشن های فردی را می توان با عبور snap به عنوان AnimationSpec غیرفعال کرد. ( i6c523 )

رفع اشکال

• وقتی اندازه محدود است ، یک اشکال ایجاد شده توسط متن خمیده محدود را برطرف کرده ایم ( i50efe )
• ما به یک تصادف بالقوه NAN مربوط به curvedComposable ( I970EB ) پرداخته ایم
• ما حذف انیمیشن برجسته تغییر موقعیت را در PositionIndicator برگردانیم. ( IEB424 )
• ما برای بهبود عملکرد آن ، لایه هسته ای را برای تراشه مواد حذف کرده ایم. ( IF2DCB )

نسخه 1.3.0-alpha08

18 اکتبر 2023

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

تغییرات API

• ما پرچم های جداگانه را به اضافه بار PositionIndicator ، برای کنترل انیمیشن های مختلف اضافه کرده ایم: showFadeInAnimation ، showFadeOutAnimation و showPositionAnimation . API قبلی مستهجن شده و تماس های جدید را به طرف جدید ارسال کرده است. به دلایل عملکرد و برای قوام UX ، هنگامی که از PositionIndicator با لیست قابل پیمایش استفاده می شود ، توصیه می کنیم پرچم های showFadeInAnimation و showPositionAnimation خاموش کنید. اگر PositionIndicator به عنوان یک شاخص مستقل استفاده می شود ، به عنوان مثال برای تغییر حجم ، پس توصیه می کنیم هر 3 انیمیشن را روشن کنید. ( i44294 )
• ما به دنبال مهاجرت عملکرد کشش به دیسمیس به wear.compose.foundation ، ما SwipeToDismissBoxState ، SwipeToDismissValue و edgeSwipeToDismiss کاهش داده ایم. لطفاً معادل های wear.compose.foundation را جایگزین کنید. ( IEE8C9 )

رفع اشکال

• ما پروفایل های پایه برای Wear Foundation ، کتابخانه های مواد و ناوبری را به روز کرده ایم. ( IDB060 )
• ما یک تغییر رفتاری را برای PositionIndicator معرفی شده در یک CL قبلی برگردانیم ، به گونه ای که هنگام نمایش یک صفحه نمایش ، PositionIndicator متحرک شد. ما قصد داریم در یک آلفای اولیه 1.4 تغییر مشابهی ایجاد کنیم ، به طوری که در ابتدا PositionIndicator نمایش داده می شود ، اما بدون هیچ انیمیشن. ( i41843 )
• ما به برخی از مشکلات عملکرد در PositionIndicator پرداخته ایم. ( i1c654 ، b/302399827 )
• ما عملکرد پیش فرض ارائه دهنده ارائه دهنده وضعیت اکتشاف Touch را بهینه کرده ایم تا به جای وضعیت مشتق شده به State<Boolean> اعتماد کنیم. ( IEEC4D )
• ما مستطیل های systemGestureExclusion برای Android 13 و بالاتر تنظیم کرده ایم. ( ib1f4b )

نسخه 1.3.0-alpha07

4 اکتبر 2023

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

تغییرات API

• ما برای کنترل انیمیشن های مختلف ، پرچم های جداگانه را به PositionIndicator اضافه کرده ایم: showFadeInAnimation ، showFadeOutAnimation و showPositionAnimation . API قبلی مستهجن شده و تماس های جدید را به طرف جدید ارسال کرده است. به دلایل عملکرد و برای قوام UX ، هنگامی که از PositionIndicator با لیست قابل پیمایش استفاده می شود ، توصیه می کنیم پرچم های showFadeInAnimation و showPositionAnimation خاموش کنید. اگر PositionIndicator به عنوان یک شاخص مستقل استفاده می شود ، به عنوان مثال برای تغییر حجم ، پس توصیه می کنیم هر 3 انیمیشن را روشن کنید. ( IA2D63 )

رفع اشکال

• ما با افزودن یک انیمیشن محو به متن عمل اصلی ، و محو شدن عمل ثانویه/تغییر مقیاس نماد در گسترش کامل کش رفتن ، پیشرفت هایی را برای نشان دادن حرکت انجام داده ایم. ( IB7223 )
• توصیه می شود که کشش برای آشکار کردن اقدامات در دسترس باشد و ما اقدامات دسترسی سفارشی را به کشش خود اضافه کرده ایم تا نمونه ها را آشکار کنیم. ( i42224 )
• ما عملکرد SwipeToDismissBox را بهبود بخشیده ایم ، از جمله اصلاح مجدد برای اطمینان از اینکه منطق اولیه باعث ایجاد مجدد نمی شود. SwipeToDismissBox اکنون به عنوان اندازه تمام صفحه ترسیم شده است. ( IE0AA2 )
• ما وقتی که به طور PositionIndicator از بین رفت ، یک اشکال برطرف کرده ایم. ( i2091a )
• عملکرد بهبود یافته PositionIndicator با بهینه سازی مجدد. پرچم های جدید برای کنترل انیمیشن ها ( fadeIn ، fadeOut و positionChange ) متعاقباً اضافه شده اند (به تغییرات API مراجعه کنید) ( IFAC7D )
• ما تست های میکروبیچارک را برای PositionIndicator اضافه کرده ایم ( IDF875 )

نسخه 1.3.0-alpha06

20 سپتامبر 2023

androidx.wear.compose:compose-*:1.3.0-alpha06 منتشر شده است. نسخه 1.3.0-alpha06 شامل این تعهدات است.

رفع اشکال

• ما پشتیبانی از Modifier.edgeSwipeToDismiss را اضافه کرده ایم. EdgesWipetodismiss با SwipeToReveal . ( i95774 ، b/293444286 )
• ما نمونه هایی را برای مواد SwipeToRevealChip و SwipeToRevealCard اضافه کرده ایم. ( IEB974 )
• ما پروفایل های پایه را برای بنیاد آهنگسازی و کتابخانه های مواد به روز کرده ایم. ( i1dd1f )

نسخه 1.3.0-alpha05

6 سپتامبر 2023

androidx.wear.compose:compose-*:1.3.0-alpha05 منتشر شده است. نسخه 1.3.0-alpha05 شامل این تعهدات است.

رفع اشکال

• ما به سمت کشش اضافه کرده ایم تا فاش شود به طوری که فقط یک مورد در یک زمان قابل جابجایی است. ( i3cd7a )
• مستندات ScalingLazyColumnDefaults را بهبود بخشید تا بهتر رفتار واقعی آن را مطابقت دهد. ( i886d3 )

نسخه 1.3.0-alpha04

23 آگوست 2023

androidx.wear.compose:compose-*:1.3.0-alpha04 منتشر شده است. نسخه 1.3.0-alpha04 شامل این تعهدات است.

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

• ما برای اقدام ثانویه SwipeToReveal پشتیبانی خنثیسازی کرده ایم. ( i7a22d )

تغییرات API

• اضافه کردن HorizontalPageIndicator در کتابخانه Sear Material3. ( IFEE99 )
• به روز شده سایش ابزار پیش نمایش را برای استفاده از کتابخانه androidx.wear.tooling.preview . ( IB036E )

رفع اشکال

• یک اشکال را در دکمه های گرد برطرف کنید که اصلاح کننده ها به درستی زنجیر نشده اند. ( i5e162 )

نسخه 1.3.0-alpha03

9 آگوست 2023

androidx.wear.compose:compose-*:1.3.0-alpha03 منتشر می شود. نسخه 1.3.0-alpha03 شامل این تعهدات است.

تغییرات API

• ما دو ترکیب جدید را در مواد برای اجرای SwipeToReveal با کارت و تراشه اضافه کرده ایم. این ترکیبات از راهنمایی UX توصیه شده در مورد این مؤلفه پیروی می کنند و اجرای SwipeToReveal را با اجزای موجود در مواد سایش آسان تر می کنند. ( i7ec65 )
• ما حاشیه نویسی FloatRange را به عنوان محدودیت های API روشن کرده ایم ، که قبلاً در نظرات بیان شده بود. ( ICB401 )

رفع اشکال

• ما منطق پیمایش اولیه ScalingLazyColumn را در داخل onGloballyPositioned() جابجا کرده ایم. ( IC90F1 )
• اکنون برای بهینه سازی تخصیص سکته مغزی drawWithCache در PositionIndicator ، ProgressIndicator و SelectionControls استفاده می کنیم. ( i5f225 ، b/288234617 )
• ما در حالت های معلولیت ، دید کادر ثابت را نشان می دهیم. ( IB25BF )
• ما Placeholder به روز کرده ایم تا اجازه دهید مجدداً تنظیم مجدد محل را نشان دهد اگر محتوای دیگر در حالت آماده نباشد. ( IBD820 )
• ما برخی از تست های Placeholder پوسته پوسته شده را انجام داده ایم ( IDB560 )

نسخه 1.3.0-alpha02

26 جولای 2023

androidx.wear.compose:compose-*:1.3.0-alpha02 منتشر می شود. نسخه 1.3.0-alpha02 شامل این تعهدات است.

تغییرات API

• ما ExpandableStateMapping ، یک روش جدید برای تولید ExpandableStates را ارائه داده ایم ، برای مواردی که در آن نیاز به ایجاد تقاضا دارند ، نه لزوماً در یک دامنه @Composable ( IFF9E0 )
• SwipeToDismissBox از androidx.wear.compose.material به androidx.wear.compose.foundation منتقل شده است. ( I275FB )
• پرونده های API به روز شده برای حاشیه نویسی سرکوب سازگاری. ( i8e87a ، b/287516207 )
• ما ثابت های ارتفاع را برای Chip ، CompactChip و ToggleChip Public ( IDBFDE ) ساخته ایم
• ما بسته های افقی و عمودی را برای Chip و CompactChip عمومی درست کرده ایم. ( IEEAF7 )
• قابلیت های اضافه شده برای خاموش کردن دست زدن به کش رفتن در SwipeDismissableNavHost از طریق پارامتر جدید userSwipeEnabled . ( id2a0b ، b/230865655 )
• ما کتابخانه ناوبری Wear Compose را برای استفاده از SwipeToDismissBox جدید از بنیاد Wear Compose به روز کرده ایم. ( i4ff8e )

رفع اشکال

• ما یک اشکال Z مرتبه را برطرف کرده ایم که expandedItem بعد از کلیک بر روی رفتار یک دکمه هنگام داشتن دکمه ، محتوای صحیح را نشان نداد. ( i1899d ، b/289991514 )
• بهبود تمرکز تمرکز SwipeToDismissBox (و از این رو SwipeDismissableNavHost ) با استفاده از HierarchicalFocusCoordinator ( I45362 ، B/277852486 )
• ما در SwipeableV2 به حرکت در ژست رسیدیم. ( i89737 )
• ما پروفایل های پایه را برای انتشار 1.2 خود نهایی کرده ایم. ( id5740 )
• پس از مهاجرت SwipeToDismissBox به پایه و اساس ، اجرای Material SwipeToDismissBox اکنون به بنیاد پیش می رود و مقادیر رنگی پیش فرض را از موضوع خود تهیه می کند. ( IF8451 )
• ما معنایی عنوان را به ListHeader اضافه کرده ایم. ( IC5420 )
• Chip و ToggleChip اکنون در صورت لزوم ، ارتفاع خود را تنظیم می کنند تا محتوایی را که به دلیل فونت های بزرگ برای دسترسی به آن رشد کرده است ، در خود جای دهد. ( IAF302 )
• رفع اشکال در نقش معنایی منطقه قابل حمل SplitToggleChip ، برای دسترسی. ( IEED3a )
• تنظیم حرکت کاهش اکنون اثر لرزان را خاموش کرده و حرکت را از بین می برد. ( I91046 )
• اکنون Stepper و InlineSlider از کلیک های مکرر روی مطبوعات طولانی پشتیبانی می کنند تا بتوانید با نگه داشتن دکمه های + یا - - به سرعت مقدار Stepper و InlineSlider را افزایش یا کاهش دهید. ( I27359 )

نسخه 1.3.0-alpha01

21 ژوئن 2023

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

رفع اشکال

• همانطور که در 1.2.0-alpha07 و 1.2.0-alpha10 اعلام شده است ، اکنون ما در حال تغییر DefaultTextStyle هستیم تا Padding Font را خاموش کنیم تا در پلت فرم Android سازگار باشد. این موارد برخی از موارد قطع متن با اندازه های بزرگ قلم را برطرف می کند و همچنین ممکن است روی طرح های صفحه تأثیر بگذارد ، به طوری که باید آزمایشات تصویر به روز شود. به عنوان مثال ، ما متن را در اینجا می بینیم ( IC6A86 )

شکل 1 : متن قطع شده.

• دیگر هنگام خاموش شدن فونت وجود ندارد:

شکل 2 : متن قطع نشده است.

• ما wear.compose.foundation به روز کرده ایم wear.compose.material
• ما یک اشکال در SwipeToDismissBox برطرف کرده ایم. کلیدهای پس زمینه و محتوا اکنون به بلوک یادآوری منتقل می شوند تا هنگام تغییر محتوا یا پس زمینه ، اصلاح کننده های جدید ایجاد شوند. ( IB876C ، B/280392104 )
• ما TimeText به روز کرده ایم تا هنگام انتخاب قالب برای زمان 12 یا 24 ساعته از محلی استفاده کنیم. ( if4a3d )
• ما ناسازگاری در پارامترهای contentScrimColor فرض SwipeToDismissBox را ثابت کرده ایم. ( i2d70f )
• ما حرکت حرکت را در SwipeToReveal بهبود بخشیده ایم. ( I28FB7 )

مسائل شناخته شده

• پشتیبانی از اندازه قلم با تنظیم کاربر یک نیاز دسترسی است. ما می دانیم که تراشه های چند لایه می توانند هنگام نمایش با اندازه های بزرگ با اندازه های بزرگ ، منجر به بریدن متن شوند ، بنابراین ما تراشه را در نسخه اولیه 1.3 آلفا به روز می کنیم تا در این موارد تنظیمات ارتفاع را انجام دهیم.

نسخه 1.2

نسخه 1.2.1

18 اکتبر 2023

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

رفع اشکال

• رفع اشکال هنگامی که PositionIndicator از بین برود. ( 7a167f )

نسخه 1.2.0

9 آگوست 2023

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

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

• انتشار پایدار آهنگسازی برای Wear OS 1.2.0 ( ادامه مطلب )
• برای لیستی از تغییرات کلیدی در سایش آهنگسازی 1.2 ، به یادداشت های انتشار مراجعه کنید ( آهنگسازی برای Wear OS 1.2 Beta01 )

نسخه 1.2.0-RC01

26 جولای 2023

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

رفع اشکال

• ما پروفایل های پایه را برای نسخه 1.2 ما نهایی کرده ایم ( ID5740 )

نسخه 1.2.0-beta02

7 ژوئن 2023

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

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

• ما متغیر جدید CompositionLocal LocalReduceMotion تجربی را اضافه کرده ایم که مقیاس بندی و محو شدن در ScalingLazyColumn غیرفعال می کند. ( i58024 )

رفع اشکال

• ما پروفایل های پایه را برای بنیاد Wear Compose و کتابخانه های مواد ( I4725D ) به روز کرده ایم
• ما ناسازگاری در مقادیر پیش فرض را برای پارامترهای SwipeToDismissBox contentScrimColor ( i2d70f ) ثابت کرده ایم.
• ما مقدار پیش فرض DefaultTextStyle را که برای تنظیمات IncludeFontPadding استفاده شده است ( I737ED ) ثابت کرده ایم

نسخه 1.2.0-beta01

24 مه 2023

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

آنچه در آهنگسازی برای پوشیدن سیستم عامل 1.2 است

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

• expandableItem و expandableItems دو مؤلفه جدید Foundation هستند که از گسترش موارد در یک ScalingLazyColumn پشتیبانی می کنند. برای یک مورد قابل ارتقاء ، مانند متن که در آن تعداد خطوط وجود دارد ، از expandableItem استفاده کنید. برای ساده کردن ایجاد دکمه ای که پس از گسترش محتوا فرو می ریزد ، برای گروهی از موارد قابل ارتقاء و expandableItems expandableButton استفاده کنید.
• HierarchicalFocusCoordinator - این ترکیب آزمایشی باعث می شود که زیر درختان زیر ترکیب را به عنوان تمرکز فعال یا غیرفعال کنید.
• Picker - API اکنون برای کنترل اینکه آیا انتخاب کننده برای پیمایش کاربر فعال است ، از userScrollEnabled استفاده می کند.
• PickerGroup - یک ترکیب جدید برای دستیابی به چند انتخاب کننده با هم. این مرکز با استفاده از HierarchicalFocusCoordinator API بین انتخاب کنندگان تمرکز می کند و مرکز خودکار وسایل انتخابی را امکان پذیر می کند.
• Placeholder - ما به روزرسانی هایی را برای انیمیشن های Shimmer و "پاک کردن" انجام داده ایم. اثر پاک کردن اکنون بلافاصله هنگام آماده شدن محتوا اعمال می شود.
• ScalingLazyColumn - ما کلاسهای ScalingLazyColumn و مرتبط از androidx.wear.compose.material.ScalingLazyColumn to androidx.wear.compose.foundation.lazy.ScalingLazyColumn را مهاجرت کرده ایم. لطفاً برای استفاده از نسخه Foundation.Lazy به روز کنید.
• SwipeToReveal ما پشتیبانی آزمایشی برای کش رفتن به یک رژیم به عنوان ابزاری برای دسترسی به اقدامات ثانویه ، تکمیل الگوی "مطبوعات طولانی" موجود را اضافه کرده ایم.
• Stepper - اکنون دارای یک بار اضافه با یک پارامتر enableRangeSemantics اضافی برای تسهیل غیرفعال کردن معناشناسی دامنه پیش فرض است.
• Previews - ما حاشیه نویسی های سفارشی زیر را برای پیش نمایش آهنگ سازی در صفحه های سایش اضافه کرده ایم: WearPreviewSmallRound پیش نمایش های این دستگاه را در یک دستگاه کوچک و گرد. WearPreviewLargeRound پیش نمایش ترکیب در یک دستگاه گرد بزرگ ؛ WearPreviewSquare پیش نمایش ترکیب در یک دستگاه مربع. همچنین ، حاشیه نویسی های زیر و چند منظوره: WearPreviewFontScales پیش نمایش ترکیبات موجود در دستگاه Wear با اندازه های مختلف فونت را نشان می دهد ، در حالی که WearPreviewDevices پیش نمایش ترکیبات موجود در دستگاه های مختلف را دارد.
• ما یک DefaultTextStyle را برای پوشیدن پوشیدن که به طور پیش فرض PlatformTextStyle.includeFontPadding را به True اضافه کرده است اضافه کرده ایم (این تنظیم فعلی است). این به ما امکان می دهد تا به طور پیش فرض با کتابخانه های آهنگسازی در نسخه اولیه 1.3 آلفای همگام سازی کنید - برای کسب اطلاعات بیشتر به 1.2.0 -alpha10 مراجعه کنید.

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

• ما هنگام روشن شدن تنظیمات reduction_motion ، پشتیبانی آزمایشی را برای مقیاس بندی معلول و انیمیشن محو شده اضافه کرده ایم. ( i58024 )

رفع اشکال

• مستندات بهبود یافته برای angularWidthDp در CurvedSize.kt ( IAB75C )
• SwipeDismissableNavHost اکنون هشدار را با دلایل احتمالی پشتی خالی وارد می کند. این کار برای جلوگیری از تصادفات غیر منتظره به دلیل IllegalArgumentException است که در هنگام خالی بودن پشتی پرتاب شده است ، انجام می شود. ( i04a81 ، b/277700155 )

نسخه 1.2.0-alpha10

10 مه 2023

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

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

• ما به عنوان ابزاری برای دسترسی به اقدامات ثانویه ، پشتیبانی از کش رفتن را برای فاش کردن اضافه کرده ایم. این الگوی الگوی "پرس طولانی" را تکمیل می کند ، روش موجود یک کاربر می تواند اقدامات ثانویه (متفاوت) را فاش کند. ( i60862 )

تغییرات API

• ما RevealScope به ترکیبات Action در SwipeToReveal اضافه کرده ایم ، که دسترسی به جبران هایی را که در آن اقدامات اضافی فاش می شود ، فراهم می کند. ( i3fd56 )

رفع اشکال

• مسئله ای که ScalingLazyColumn در Wear API 33 پس از پرواز ( IC4599 ) گیر کرده بود ، رفع کرد
• ما برخی از عملکردهای عملکرد را برای کاهش JANK در PositionIndicator انجام داده ایم. ( i35e92 )
• ما یک اشکال را در تراشه و CompactChip برطرف کرده ایم که در آن نقش معنایی دیگر در Role.Button قرار نگرفته است. ( i93f91 ، b/277326264 )

مسائل شناخته شده

• ما یک اشکال در استودیوی اندرویدی را شناسایی کرده ایم که باعث خرابی در ارائه پیش نمایش در هنگام حاشیه نویسی با wearpreviewdevice و wwearpreviewfontscales می شود - یک راه حل به زودی برای انتشار برنامه ریزی شده است. لطفاً توجه داشته باشید که دیگر حاشیه نویسی های پیش نمایش Wear همانطور که در Android Studio Giraffe 2022.3.1 و فراتر از آن در نظر گرفته شده است.

• در نسخه 1.2.0 -alpha07 ما به طور DEFAULTTEXTSTYLE برای پوشیدن آهنگسازی اضافه کردیم ، و با حفظ مقدار موجود PlatformTextStyle.includefontpadding به عنوان درست - برای پس زمینه ، به Fix Font Font Padding در آهنگسازی مراجعه کنید. ما در حال تغییر DefaultTextStyle برای خاموش کردن فونت در نسخه اولیه 1.3 آلفا خواهیم بود تا در پلتفرم Android سازگار باشد. این امر به برخی از موارد قطع متن با اندازه های بزرگ قلم می پردازد و همچنین ممکن است روی طرح های صفحه تأثیر بگذارد ، به طوری که تست های تصویر نیاز به به روزرسانی دارند. به عنوان مثال ، با اندازه فونت بزرگ ، متن را در اینجا می بینیم:

شکل 1 : متن قطع شده.

• دیگر هنگام خاموش شدن فونت وجود ندارد:

Figure 2 : Text not clipped.

The new setting can be adopted now by overriding the typography in your theme - see example code .

Version 1.2.0-alpha09

19 آوریل 2023

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

تغییرات API

• Add angularSizeDp to the CurvedModifier api for setting angular width in DP ( I89a52 )

رفع اشکال

• We have fixed accessibility issues in our time picker demos( Id0eb7 )

نسخه 1.2.0-alpha08

5 آوریل 2023

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

تغییرات API

• We have renamed ExpandableItemsState to ExpandableState . ( If85ea )
• We have added expandableButton to simplify creating a button that collapses when the content is expanded and also updated the expandables examples. ( Iae309 )

رفع اشکال

• Improved expandable samples to show more possibilities. Modified animation of expandableItem to keep its content centered through the animation. ( I2f637 )
• Updated ToggleControls to avoid extra recompositions when manually animating the colors using State. ( I5d319 )

نسخه 1.2.0-alpha07

22 مارس 2023

androidx.wear.compose:compose-*:1.2.0-alpha07 is released. نسخه 1.2.0-alpha07 شامل این تعهدات است.

تغییرات API

• We have moved the Expandable Item components (added in 1.2.0-alpha06) from material to foundation, since they had no meaningful reference to the MaterialTheme . ( Ib0525 )

رفع اشکال

• We have fixed a crash that occurred in a screen using PickerGroup , by ensuring that PickerGroup handles focus correctly when no Picker has the focus. Also added support for RSB scrolling in our Picker demos. ( If8c19 )
• We have improved the dialog transitions - the intro transition is now smoother to match the outro transition. ( Ib5af9 )
• We have added a DefaultTextStyle to Wear Compose which defaults the PlatformTextStyle.includeFontPadding property to true (this is the current setting). This will allows us to synchronize turning off font padding by default with the Compose libraries in the future - see ( Fix font padding in Compose ) for background. ( I2aee8 )
• Reverted an UpsideDownCake preview dependency via activity-compose that blocked publishing apps to the Google Play Store. ( I6443d )

نسخه 1.2.0-alpha06

8 مارس 2023

androidx.wear.compose:compose-*:1.2.0-alpha06 is released. نسخه 1.2.0-alpha06 شامل این تعهدات است.

تغییرات API

• Add CurvedBox component, which places components on top of each other in the curved world. ( I29200 )
• Added Expandable Item(s) - two new components to support either a group of expandable items in a ScalingLazyColumn , or an expandable single item, such as Text in which the number of lines expands. ( I95dd5 )
• We have added the following custom annotations for previewing composables on Wear screens: WearPreviewSmallRound previews the composable on a small, round device; WearPreviewLargeRound previews the composable on a large round device; WearPreviewSquare previews the composable on a square device. Also, the following and multi-preview annotations: WearPreviewFontScales previews the composables on a wear device with multiple font sizes, while WearPreviewDevices previews the composables on different wear devices. To use these previews, you must be using the latest Android Studio (Giraffe Canary 6) or beyond. Please note that if these annotations do not suit your purpose, Preview can still be used and supports further customisations via parameters. ( I397ff )
• We have marked HierarchicalFocusCoordinator as experimental while it is considered as a candidate to be moved into core compose libraries, given its wide applicability. ( I3a768 )

رفع اشکال

• Fixed a bug on HierarchicalFocusCoordinator , when the lambda passed in for the focusEnabled parameter is changed, we now correctly use the new one. ( Icb353 )
• We have updated the default disabled content color to Background when using primary colors as the background in Button , CompactButton , Chip , CompactChip and ToggleButton . This improves the contrast for accessibility. ( I527cc )

نسخه 1.2.0-alpha05

22 فوریه 2023

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

تغییرات API

• Updated PickerGroup API to allow propagating the min constraints to the composable optionally. When set as true, the minimum constraints passed from the parent composable will be allowed on the PickerGroup . If set as false, PickerGroup will reset the minimum constraints. ( I3e046 )
• We have added animateScrollToOption to the Picker API in order to support programmatic animation to a specific Picker option ( I6fe67 )

رفع اشکال

• We have updated HorizontalPageIndicator to support right-to-left layouts. ( Ia4359 )
• Added Screenshot tests for right-to-left layout in HorizontalPageIndicator ( I6fbb8 )
• Added further tests to SwipeDismissableNavHostTest that use TestNavHostController ( I61d54 )

نسخه 1.2.0-alpha04

8 فوریه 2023

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

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

• PickerGroup for handling multiple pickers together using the focus API. It handles the focus between the different pickers, enables auto-centering of the pickers based on parameters and allows developers to change the focus between different pickers while handling the events from the group. In talkback mode, the PickerGroup handles the talkback focus by moving the focus to the selected Picker from the group. ( I60840 )

تغییرات API

• We have added an overload to Stepper with an additional enableRangeSemantics parameter in order to facilitate disabling the default range semantics ( Ia61d4 )

رفع اشکال

• Allow ScalingLazyColumn to be nested within a horizontally scrolling page ( Iec3f8 , b/266555016 )
• Improvement of Stepper kdocs and StepperTest tests clean-up. ( Ic118e )
• Updated androidx.navigation dependency to version 2.5.3 ( If58ed )

نسخه 1.2.0-alpha03

25 ژانویه 2023

androidx.wear.compose:compose-*:1.2.0-alpha03 is released. نسخه 1.2.0-alpha03 شامل این تعهدات است.

تغییرات API

• We have migrated ScalingLazyColumn (and associated classes) from androidx.wear.compose.material.ScalingLazyColumn to andrdoidx.wear.compose.foundation.lazy.ScalingLazyColumn (see this example for migration). This new location more closely matches that of compose.foundation.lazy.LazyColumn and is more natural as it is not an opinionated Material component. The change is happening now in preparation for a new Material3 library, which we will be working on in parallel with the existing Material library. ( I060e7 )

The following changes are part of the ScalingLazyColumn migration from Material to Foundation.Lazy :

• PositionIndicator apis targeting Material ScalingLazyColumn have been deprecated - please update to Foundation.Lazy ScalingLazyColumn . Additionally anchorType field was added to ScalingLazyListLayoutInfo . ( I29d95 )
• ScalingLazyColumn has been marked as deprecated in the Wear Compose Material package ( I16d34 )
• We have updated the ScrollAway modifier to use ScalingLazyListState from Wear Compose Foundation.Lazy and deprecated the overload that took ScalingLazyListState from Wear Compose Material. ( Ifc42c )
• We have updated the Dialog APIs to use ScalingLazyListState from Foundation.Lazy and deprecated the overloads that used Material ScalingLazyListState ( Ic8960 )
• We have updated the Picker APIs to use ScalingParams from Foundation.Lazy and deprecated the overloads that used Material ScalingParams . ( Idc3d8 )

رفع اشکال

• We have fixed a bug that caused unnecessary recompositions in ScalingLazyListState.centerItemIndex by ensuring that it only pushes updates when the value actually changes ( Ia9f38 )
• We have improved the performance of SwipeToDismissBox ( I3933b )
• Added benchmark tests for ScalingLazyColumn in Wear Compose Foundation ( Ie00f9 )
• We have updated some internal ScalingLazyColumn classes methods in Material to use their equivalents from Foundation.Lazy ( I38aab )
• We have fixed some issues in Picker tests and add more tests for checking scroll with offset ( I6ac34 )
• We migrated the ScalingLazyColumn Integration Demos to depend on Foundation.Lazy instead of Material ScalingLazyColumn ( Ic6caa )
• We have added optional fromDate/toDate parameters to our DatePicker demo ( I961cd )

نسخه 1.2.0-alpha02

11 ژانویه 2023

androidx.wear.compose:compose-*:1.2.0-alpha02 is released. نسخه 1.2.0-alpha02 حاوی این commit ها است.

تغییرات API

• Android Compose UI tests will now run layout passes for each frame when executing frames to get to idle (eg via waitForIdle ). This may affect tests that assert on individual frames of layout animations. ( I8ea08 , b/222093277 )
• The parameter minLines is added to Wear Text for consistent behaviour with BasicText ( I24874 )
• CompactChipTapTargetPadding has been made public so that it appears in the documentation ( If1e70 , b/234119038 )

رفع اشکال

• Disable multiplatform builds for wear.compose packages ( Iad3d7 )
• Fix kdocs for scrollToOption ( I6f9a0 )
• PlaceholderState.rememberPlaceholderState() updated to use rememberUpdatedState to that the state will update if the onContentReady lambda. ( I02635 , b/260343754 )
• We have fixed a text jittering issue seen in the Picker component by leveraging the new compositing strategy added to Modifier.graphicsLayer . ( I99302 )
• We have fixed a bug that caused flickering in our DatePicker demo ( I660bd )
• We have improved the accessibility for the 12-hour time and date picker demos ( I05e12 )
• We have updated our time and date picker demos so that the pickers are not affected by RSB changes when unselected ( I4aecb )

نسخه 1.2.0-alpha01

7 دسامبر 2022

androidx.wear.compose:compose-*:1.2.0-alpha01 is released. نسخه 1.2.0-alpha01 حاوی این commit ها است.

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

• We've updated the experimental Placeholder functionality so that the “Wipe Off” effect is immediately applied when the content is ready rather than waiting for the next animation loop to start. We have also made some updates to the shimmer and wipe off animations. ( I5a7f4 )

تغییرات API

• We have added a HierarchicalFocusCoordinator composable to enable marking sub-trees of the composition as focus enabled or focus disabled.( I827cb )
• We have added a new property to override the semantic role for ToggleButton .( I67132 )
• We have updated TimeTextDefaults.TimeFormat12Hours to remove AM/PM in TimeText . This will change the default value of timeSource parameters in TimeText API. ( I1eb7f )
• We have extended the Picker API to improve accessibility for screens with multi-picker. There is a new property userScrollEnabled to control whether the picker is active for user scrolling. ( I3c3aa )

رفع اشکال

• We have changed the default border width for an OutlinedButton/OutlinedCompactButton from 2.dp to 1.dp to match final UX specs. ( Icf84d )
• In order to reduce the effect of the first item added to an empty ScalingLazyColumn appearing to scroll into place we have added an estimated autoCentering topPadding when the contents are empty. This change calculates the amount of top padding needed by assuming an initial item of height 0.dp. For ScalingLazyListAnchorType.ItemStart this will calculate the correct top padding, for ScalingLazyListAnchorType.ItemCenter this calculation will be incorrect as the height of the items is needed to correctly size the contents resulting in a small scroll into place effect based on the items real height.( I239a4 )
• We have updated the background scrim applied to the SwipeToDismiss animation to match the Wear platform. ( I9003e )
• We have fixed PositionIndicator handling of LazyListState and ScalingLazyListState for list items of size 0 to avoid divide by zero errors.( Ic28dd )

نسخه 1.1

Version 1.1.2

8 فوریه 2023

androidx.wear.compose:compose-foundation:1.1.2 , androidx.wear.compose:compose-material:1.1.2 , and androidx.wear.compose:compose-navigation:1.1.2 are released. Version 1.1.2 contains these commits.

رفع اشکال

• We have fixed a bug that caused unnecessary recompositions in ScalingLazyListState.centerItemIndex by ensuring that it only pushes updates when the value actually changes ( Ia9f38 )

نسخه 1.1.1

11 ژانویه 2023

androidx.wear.compose:compose-foundation:1.1.1 , androidx.wear.compose:compose-material:1.1.1 , and androidx.wear.compose:compose-navigation:1.1.1 are released. نسخه 1.1.1 شامل این تعهدات است.

رفع اشکال

• PlaceholderState.rememberPlaceholderState() updated to use rememberUpdatedState to that the state will update if the onContentReady lambda. ( I02635 , b/260343754 )

نسخه 1.1.0

7 دسامبر 2022

androidx.wear.compose:compose-foundation:1.1.0 , androidx.wear.compose:compose-material:1.1.0 , and androidx.wear.compose:compose-navigation:1.1.0 are released. نسخه 1.1.0 حاوی این commit ها است.

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

• Stable release of Compose for Wear OS 1.1.0 ( read more ).
• For a list of the key changes in Wear Compose 1.1 see the release notes for ( Compose for Wear OS 1.1 Beta01 ).

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

• We've updated the experimental Placeholder functionality so that the “Wipe Off” effect is immediately applied when the content is ready rather than waiting for the next animation loop to start. We have also made some updates to the shimmer and wipe off animations. ( I5a7f4 )

رفع اشکال

• We have changed the default border width for an OutlinedButton/OutlinedCompactButton from 2.dp to 1.dp to match final UX specs. ( Icf84d )
• In order to reduce the effect of the first item added to an empty ScalingLazyColumn appearing to scroll into place we have added an estimated autoCentering topPadding when the contents are empty. This change calculates the amount of top padding needed by assuming an initial item of height 0.dp. For ScalingLazyListAnchorType.ItemStart this will calculate the correct top padding, for ScalingLazyListAnchorType.ItemCenter this calculation will be incorrect as the height of the items is needed to correctly size the contents resulting in a small scroll into place effect based on the items real height.( I239a4 )
• We have updated the background scrim applied to the SwipeToDismiss animation to match the Wear platform.( I9003e )
• We have fixed PositionIndicator handling of LazyListState and ScalingLazyListState for list items of size 0 to avoid divide by zero errors.( Ic28dd )

نسخه 1.1.0-rc01

9 نوامبر 2022

androidx.wear.compose:compose-foundation:1.1.0-rc01 , androidx.wear.compose:compose-material:1.1.0-rc01 , and androidx.wear.compose:compose-navigation:1.1.0-rc01 are released . نسخه 1.1.0-rc01 حاوی این commit ها است.

رفع اشکال

• We have added baseline profile rules for Placeholders , ScrollAway , RadioButton , Switch , Checkbox , OutlinedButton , OutlinedCompactButton , OutlinedChip and OutlinedCompactChip . ( I8249c )
• We have fixed a bug in Modifier.scrollAway so that if the specified itemIndex is invalid (for example, if that item index is out of range), then the TimeText will now still be displayed. ( I2137a )
• We have updated the SwipeToDismissBox animation to match the platform implementation. After the initial squeeze animation, the screen now slides off to the right once the dismissal has been triggered. ( I41d34 )
• As an optimization, we have updated Modifier.scrollAway to only read the scrollState inside the measure block to avoid recomposing the modifier after each remeasure. ( I4c6f1 )
• We have added documentation and a sample to placeholders to show the correct ordering for Modifier.placeholder and Modifier.placeholderShimmer when applied to the same composable. ( Ie96f4 , b/256583229 )
• We have changed the default border width for an OutlinedCompactChip/OutlinedChip from 2.dp to 1.dp to match final UX specs. ( Ib3d8e )
• We have fixed a bug in rememberPickerState where updated inputs were not saved, so that composables were not updated after changes to the inputs. ( I49ff6 , b/255323197 )
• We have made some UI updates to the placeholders, 1) change the shimmer gradient to 1.5x the screen size, 2) add easing (cubic bezier) of the shimmer progression and 3) speed up the wipe-off animation (250ms). ( Id29c1 )
• We have corrected a UI bug in the placeholder wipeOff effect where Chip and Card backgrounds were wiping off slightly early due to not taking the component's position on screen into account. ( I2c7cb )
• We have updated the placeholder background drawing to merge colors rather than layer them where possible to reduce the risk of alpha blending of the different cropped layers from allowing underlying colors to bleed through at the placeholder background edges. ( I2ea26 )
• We have corrected the calculation of ScalingLazyListState.centerItemIndex/centerItemOffset so that if two items sit either side of the viewport center line the one that is closest will be considered as the centerItem . ( I30709 , b/254257769 )
• We have corrected a bug in the ScalingLazyListState.layoutInfo.visibleItemsInfo which was reporting incorrect offsets during ScalingLazyColumn initialization. Now an empty list will be returned until all list items are visible and have the correct offsets. Check for ScalingLazyListState.layoutInfo.visibleItemsInfo.isNotEmpty() will confirm that the ScalingLazyColumn initialization is complete and items are visible. ( I3a3b8 )

نسخه 1.1.0-beta01

24 اکتبر 2022

androidx.wear.compose:compose-foundation:1.1.0-beta01 , androidx.wear.compose:compose-material:1.1.0-beta01 , and androidx.wear.compose:compose-navigation:1.1.0-beta01 are released . نسخه 1.1.0-beta01 حاوی این تعهدات است.

What's in Compose for Wear OS 1.1

The 1.1.0-beta01 of Compose for Wear OS indicated that this release of the library is feature complete and the API locked.

• Wear Compose 1.1 release includes the following new functionality:
  • Picker - Accessibility improvements to Picker so that multi-picker screens are navigable with screen readers and the content description is accessible
  • Picker contentDescription parameter is now used only for the selected Picker option and takes a nullable String (in the previous commit, it was necessary to pass a mapping from option to the content description, but only the selected option was used).
  • Picker items are now always center-aligned, fixing a bug when setting gradientRatio to zero had the side-effect of changing the alignment.
  • Chip/ToggleChip - We have updated the default gradients for Chip/ToggleChip to bring them in line with the latest UX spec. ChipDefaults.gradientBackgroundChipColors has been updated to start from 50% of primary rather than 32.5%.
  • Chip/ToggleChip - Added overloads for modifying Chip shapes
  • Chip/Button/ToggleButton - Added a new outlined style for Chips and Buttons and new OutlinedChip and OutlinedButton composables that provide a transparent Chip/Button with a thin border.
  • Card - Updated the default gradients for Cards to bring them in line with the latest UX spec. CardDefaults.cardBackgroundPainter has been updated to start from 30% of primary and end at 20% of onSurfaceVariant (was previously 20% to 10% onSurfaceVariant ). ToggleChip.toggleChipColors changes from a linear gradient of 75% surface to 32.5% primary to 0% surface to 50% primary.
  • Button/ToggleButton - Added properties for modifying button shapes.
  • Theme - Updated a number of the default colors in the MaterialTheme in order to improve accessibility as the original colors did not have sufficient contrast resulting in difficulties for users to differentiate chip/card/button backgrounds from the theme background color.
  • InlineSlider/Stepper - Button roles added so that Talkback can recognise them as buttons.
  • Scaffold - PositionIndicator now is positioned and sized so that it only takes the space needed. This is useful, for example, if semantic information is added to it, talkback now gets the correct bounds of the PositionIndicator on screen.
  • CurvedText/TimeText - Added Modifier.scrollAway , which scrolls an item vertically in/out of view, based on scroll state (with overloads to work with Column , LazyColumn and ScalingLazyColumn ). ScrollAway is typically used to scroll a TimeText out of view as the user starts to scroll a list of items upwards.
  • CurvedText/TimeText - Added support for fontFamily , fontStyle and fontSynthesis in CurvedTextStyle , usable on curvedText and basicCurvedText
  • CurvedText/TimeText - Added fontWeight to the constructor and copy method on CurvedTextStyle
  • ToggleControls - Added animated Checkbox , Switch and RadioButton toggle controls for use with ToggleChip and SplitToggleChip . These can be used instead of the static icons provided by ToggleChipDefaults ( switchIcon , checkboxIcon and radioIcon ).
  • Placeholder - Added experimental placeholder support. This has three distinct visual effects designed to work together.
  • Firstly a placeholder background brush effect used in containers such as Chip and Cards to draw over the normal background when waiting for content to load.
  • Secondly a modifier ( Modifier.placeholder() ) to draw a stadium shaped placeholder widget over the top of content that is being loaded.
  • Thirdly a modifier gradient/shimmer effect ( Modifier.placeholderShimmer() ) that is drawn over the top of the other effects to indicate to users that we are waiting for data to load.
    • All of these effects are designed to be coordinated and shimmer and wipe-off in an orchestrated fashion.
• Core Compose dependencies updated from 1.2 to 1.3

تغییرات API

• Font parameters ( fontFamily , fontWeight , fontStyle & fontSynthesis ) can now be specified directly as parameters of curvedText ( Idc422 )

رفع اشکال

• curveText and basicCurvedText will now work properly with talkback (the have a properly sized and placed (but empty) compose-ui node associated with them, using the text as content description) ( I7af7c , b/210721259 )
• Bug fix to the Picker when PickerState.repeatedItems = false to add an explicit setting of autoCentering params on the Pickers internal ScalingLazyColumn to ensure that it is possible to scroll the zero'th option to the center of the view. ( I8a4d7 )

Version 1.1.0-alpha07

5 اکتبر 2022

androidx.wear.compose:compose-foundation:1.1.0-alpha07 , androidx.wear.compose:compose-material:1.1.0-alpha07 , and androidx.wear.compose:compose-navigation:1.1.0-alpha07 are released . Version 1.1.0-alpha07 contains these commits.

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

• We have added experimental placeholder support. This has three distinct visual effects designed to work together. Firstly a placeholder background brush effect used in containers such as Chip and Cards to draw over the normal background when waiting for content to load. Secondly a modifier ( Modifier.placeholder() ) to draw a stadium shaped placeholder widget over the top of content that is being loaded. Thirdly a modifier gradient/shimmer effect ( Modifier.placeholderShimmer() ) that is drawn over the top of the other effects to indicate to users that we are waiting for data to load. All of these effects are designed to be coordinated and shimmer and wipe-off in an orchestrated fashion. ( I3c339 )

تغییرات API

• Added support for fontWeight , fontFamily , fontStyle and fontSynthesis in CurvedTextStyle , usable on curvedText and basicCurvedText . Those parameter can be used to specify the font and style to use on the curved text.( Iaa1a8 ),( I72759 )
• Updated Modifier.scrollAway 's offset parameter to Dp for consistency with Modifier.offset (previously it was in pixels). Also, refactored as a LayoutModifier for efficiency. ( I9f94b )
• As part of the new toggle controls API, we have renamed RadioButton's circleColor to ringColor . ( I28fa9 )
• We have added animated Checkbox , Switch and RadioButton toggle controls for use with ToggleChip and SplitToggleChip . These can be used instead of the static icons provided by ToggleChipDefaults ( switchIcon , checkboxIcon and radioIcon ). ( I8a8c4 )

نسخه 1.1.0-alpha06

21 سپتامبر 2022

androidx.wear.compose:compose-foundation:1.1.0-alpha06 , androidx.wear.compose:compose-material:1.1.0-alpha06 , and androidx.wear.compose:compose-navigation:1.1.0-alpha06 are released . نسخه 1.1.0-alpha06 شامل این تعهدات است.

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

• We have added Modifier.scrollAway , which scrolls an item vertically in/out of view, based on scroll state (with overloads to work with Column , LazyColumn and ScalingLazyColumn ). ScrollAway is typically used to scroll a TimeText out of view as the user starts to scroll a list of items upwards. ( I61766 )

رفع اشکال

• The PositionIndicator now is positioned and sized so that it only takes the space needed. This is useful, for example, if semantic information is added to it, talkback now gets the correct bounds of the PositionIndicator on screen. ( Ie6106 , b/244409133 )

نسخه 1.1.0-alpha05

7 سپتامبر 2022

androidx.wear.compose:compose-foundation:1.1.0-alpha05 , androidx.wear.compose:compose-material:1.1.0-alpha05 , and androidx.wear.compose:compose-navigation:1.1.0-alpha05 are released . نسخه 1.1.0-alpha05 شامل این تعهدات است.

رفع اشکال

• Button roles were added to InlineSlider and Stepper so that Talkback can recognise them as buttons. ( Icb46c , b/244260275 )
• We have corrected the z-order of position and page indicators in the Scaffold. The indicators will now sit on top of the vignette and so will not be obscured by the vignette if it is present. ( Ib988f , b/244207528 )

نسخه 1.1.0-alpha04

24 آگوست 2022

androidx.wear.compose:compose-foundation:1.1.0-alpha04 , androidx.wear.compose:compose-material:1.1.0-alpha04 , and androidx.wear.compose:compose-navigation:1.1.0-alpha04 are released . نسخه 1.1.0-alpha04 شامل این تعهدات است.

تغییرات API

• We have updated a number of the default colors in the MaterialTheme in order to improve accessibility as the original colors did not have sufficient contrast resulting in difficulties for users to differentiate chip/card/button backgrounds from the theme background color. The updated colors are surface(0xFF202124->0xFF303133), onPrimary(0xFF202124->0xFF303133), onSecondary(0xFF202124->0xFF303133), primaryVariant(0xFF669DF6->0xFF8AB4F8) and onError(0xFF202124->0xFF000000). The changes in colors though relatively subtle may impact existing screenshot tests. ( 81ab09 )

رفع اشکال

• Fix a logic bug in ScalingLazyColumn that could result in lists with a small (typically exactly 2) number of list items not completing initialization and as a result being transparent. ( 504347 )

نسخه 1.1.0-alpha03

10 آگوست 2022

androidx.wear.compose:compose-foundation:1.1.0-alpha03 , androidx.wear.compose:compose-material:1.1.0-alpha03 , and androidx.wear.compose:compose-navigation:1.1.0-alpha03 are released . نسخه 1.1.0-alpha03 شامل این تعهدات است.

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

• We have added a new outlined style for Chips and Buttons and new OutlinedChip and OutlinedButton composables that provide a transparent Chip/Button with a thin border. ( Id5972 )

تغییرات API

• Added overloads for modifying button shapes ( Icccde )

رفع اشکال

• We have corrected the size of the toggle control area of the ToggleChip as it was not matching its UX spec. The UX Spec calls for a 4.dp spacer between the label and a 24x24.dp toggle control icon area giving a total 28.dp width. However the implementation is incorrectly giving 36x24.dp toggle control area. This results in taking away 8.dp of usable text label area. NOTE: This bug fix gives additional space for the text label and as result can (positively) impact the text layout for overflowing text. If you have screenshot tests including ToggleChips they may need to be updated. ( I514c8 , b/240548670 )

نسخه 1.1.0-alpha02

27 جولای 2022

androidx.wear.compose:compose-foundation:1.1.0-alpha02 , androidx.wear.compose:compose-material:1.1.0-alpha02 , and androidx.wear.compose:compose-navigation:1.1.0-alpha02 are released . نسخه 1.1.0-alpha02 حاوی این commit ها است.

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

• We have switched Compose for Wear OS dependencies on core Compose libraries from 1.2.0 to 1.3.0-alpha0X

تغییرات API

• Added overloads for modifying chip shapes ( I02e87 )

رفع اشکال

• We have animated the visibility of the vignette when showing/hiding Dialog, to be consistent with the existing scaling animation. ( Ida33e )
• We have fixed a bug where a divide-by-zero could occur with some fling behavior when scrolling. ( I86cb6 )
• Fixed a bug in the ChipDefaults.childChipColor() to ensure that the disabled background color is fully transparent. ( I2b3c3 , b/238057342 )

نسخه 1.1.0-alpha01

29 ژوئن 2022

androidx.wear.compose:compose-foundation:1.1.0-alpha01 , androidx.wear.compose:compose-material:1.1.0-alpha01 , and androidx.wear.compose:compose-navigation:1.1.0-alpha01 are released . نسخه 1.1.0-alpha01 حاوی این commit ها است.

تغییرات API

• Picker's contentDescription parameter is now used only for the selected Picker option and takes a nullable String (previously, it was necessary to pass a mapping from option to the content description, but only the selected option was used). ( Ife6a7 )
• We have made accessibility improvements to Picker so that multi-picker screens are navigable with screen readers and the content description is accessible ( I64edb )

رفع اشکال

• We have updated the baseline profile rules packaged with the Wear Compose library ( I9c694 )
• We have corrected the direction of the gradient for Chips in right to left mode. Was top left->bottom right, is now top right->bottom left. ( Ic2e77 )
• We have updated the default gradients for Chip/ToggleChip/Card to bring them in line with latest UX spec. ChipDefaults.gradientBackgroundChipColors has been updated to start from 50% of primary rather than 32.5%. CardDefaults.cardBackgroundPainter has been updated to start from 30% of primary and end at 20% of onSurfaceVariant (was previously 20% to 10% onSurfaceVariant ). ToggleChip.toggleChipColors changes from a linear gradient of 75% surface to 32.5% primary to 0% surface to 50% primary. ( I43bbd )
• We have added a background color ( MaterialTheme.color.surface ) behind Chip/ToggleChips that have gradient backgrounds in order to ensure that they are properly visible in the unlikely event that a light color is used behind them. ( Ibe1a4 , b/235937657 )
• Picker items are now always center-aligned, fixing a bug when setting gradientRatio to zero had the side-effect of changing the alignment. ( I712b8 )

نسخه 1.0

نسخه 1.0.2

7 سپتامبر 2022

androidx.wear.compose:compose-foundation:1.0.2 , androidx.wear.compose:compose-material:1.0.2 , and androidx.wear.compose:compose-navigation:1.0.2 are released. نسخه 1.0.2 شامل این تعهدات است.

رفع اشکال

• We have corrected the z-order of position and page indicators in the Scaffold. The indicators will now sit on top of the vignette and so will not be obscured by the vignette if it is present. ( Ib988f , b/244207528 )

نسخه 1.0.1

24 آگوست 2022

androidx.wear.compose:compose-foundation:1.0.1 , androidx.wear.compose:compose-material:1.0.1 , and androidx.wear.compose:compose-navigation:1.0.1 are released. نسخه 1.0.1 شامل این تعهدات است.

رفع اشکال

• Fix a logic bug in ScalingLazyColumn that could result in lists with a small (typically exactly 2) number of list items not completing initialization and as a result being transparent. ( 076c61 )

نسخه 1.0.0

27 جولای 2022

androidx.wear.compose:compose-foundation:1.0.0 , androidx.wear.compose:compose-material:1.0.0 , and androidx.wear.compose:compose-navigation:1.0.0 are released. نسخه 1.0.0 حاوی این commit ها است.

ویژگی های اصلی 1.0.0

• This is the first stable release of Compose for Wear OS ( read more ).
• Compose for Wear OS builds upon the core Compose libraries providing additional wearable-specific components and, where appropriate, alternate implementations of core Compose components tailored to wearable devices.
• For a list of the key components in Wear Compose see the release notes for ( Compose for Wear OS Beta01 ).

رفع اشکال

• We have animated the visibility of the vignette when showing/hiding Dialog, to be consistent with the existing scaling animation. ( Ida33e )
• We have fixed a bug where a divide-by-zero could occur with some fling behavior when scrolling. ( I86cb6 )
• Fixed a bug in the ChipDefaults.childChipColor() to ensure that the disabled background color is fully transparent. ( I2b3c3 , b/238057342 )

نسخه 1.0.0-RC02

22 ژوئن 2022

androidx.wear.compose:compose-foundation:1.0.0-rc02 , androidx.wear.compose:compose-material:1.0.0-rc02 , and androidx.wear.compose:compose-navigation:1.0.0-rc02 are released . نسخه 1.0.0-RC02 شامل این تعهدات است.

رفع اشکال

• We have corrected the direction of the gradient for Cards in right to left (RTL) mode. It was top left->bottom right, and it is now top right->bottom left. ( Ic2e77 )
• We have updated the default gradients for Chip/ToggleChip/Card to bring them in line with the latest UX spec. ChipDefaults.gradientBackgroundChipColors has been updated to start from 50% of primary rather than 32.5%. CardDefaults.cardBackgroundPainter has been updated to start from 30% of primary and end at 20% of onSurfaceVariant (was previously 20% to 10% onSurfaceVariant). ToggleChip.toggleChipColors changes from a linear gradient of 75% surface to 32.5% primary to 0% surface to 50% primary. ( I43bbd )
• We have added a background color ( MaterialTheme.color.surface ) behind Chip/ToggleChips that have gradient backgrounds in order to ensure that they are properly visible in the unlikely event that a light color is used behind them. ( Ibe1a4 , b/235937657 )
• We have updated the baseline profile rules packaged with the Wear Compose library ( I9c694 )

نسخه 1.0.0-rc01

15 ژوئن 2022

androidx.wear.compose:compose-foundation:1.0.0-rc01 , androidx.wear.compose:compose-material:1.0.0-rc01 , and androidx.wear.compose:compose-navigation:1.0.0-rc01 are released . نسخه 1.0.0-rc01 حاوی این commit ها است.

تغییرات API

• رابط در کتابخانه های آهنگسازی اکنون با استفاده از روش های رابط پیش فرض JDK8 ( I5BCF1 ) ساخته شده است

رفع اشکال

• We have removed the explicit call to fillMaxWidth() on list header as it is not needed and can result in problems if a ScalinglazyColumn has a mixture of ListHeader() and Chip() components as the width will tend to grow/shrink as ListHeader items are scrolled in/out of view. ( I37144 , b/235074035 )
• We have fixed a bug in the ScalingLazyColumn that could result in the list items not drawing correctly until scrolled if the 0th list item was large enough (including padding) ( Ic6159 , b/234328517 )
• We have made a small adjustment in the ScalingLazyColumn easing as items reach the edge of the screen to match UX spec updates. Old values CubicBezierEasing(0.25f, 0.00f, 0.75f, 1.00f) -> new values CubicBezierEasing(0.3f, 0f, 0.7f, 1f) . To keep the old behavior you can override the scalingParams of ScalingLazyColumn ( Ie375c )
• We have added padding to the CompactChip in order to ensure that its tap target size is at least 48.dp high to meet the Material accessibility guidelines. This might impact any layouts you have using CompactChips as they will be taking up additional space. ( I3d57c )

نسخه 1.0.0-beta03

1 ژوئن 2022

androidx.wear.compose:compose-foundation:1.0.0-beta03 , androidx.wear.compose:compose-material:1.0.0-beta03 , and androidx.wear.compose:compose-navigation:1.0.0-beta03 are released . نسخه 1.0.0-beta03 شامل این تعهدات است.

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

• We have made ScalingLazyColumn work in Compose @Preview mode. ( I3b3b6 , b/232947354 )

تغییرات API

• We have changed the default value for the ScalingLazyColumn.horizontalAlignment property from Start to CenterHorizontally to ensure that when list items do not fill the entire width of the column they will be aligned for maximum visibility. To switch back to the previous behavior set horizontalAlignment = Alignment.Start .( I9ed4b )

مسائل شناخته شده

• CompactChip's tap/touch height is smaller than Material accessibility guidelines. This will be corrected in the next release (15th June) . If you are using CompactChip this will affect your layouts as CompactChips will now have additional padding above and below. Please adjust and test your layouts or see the bug comments for a workaround to use the existing behavior. ( b/234332135 )

رفع اشکال

• New demo to animate adding or removing a start text on a TimeText . ( I16d75 )
• Add tests for HorizontalPageIndicator.PagesState ( I64ed0 )
• Updating TimeText closer to UX specs ( Ib7ea1 )

نسخه 1.0.0-beta02

18 مه 2022

androidx.wear.compose:compose-foundation:1.0.0-beta02 , androidx.wear.compose:compose-material:1.0.0-beta02 , and androidx.wear.compose:compose-navigation:1.0.0-beta02 are released . نسخه 1.0.0-beta02 شامل این تعهدات است.

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

• Picker now always responds to scroll events even when in read-only mode. This avoids the need for users to first select a Picker by tapping, before they can scroll. In read-only mode, options other than that currently selected are obscured by a shim in gradientColor . ( I72925 )
• We have changed the UX behavior of Chip/ToggleChip/CompactChip/SplitToggleChip to stop them from doing fillMaxWidth by default. Instead they will grow to fit their contents. To keep the previous behavior simply add modifier = Modifier.fillMaxWidth() ( I60a2c , b/232206371 )

رفع اشکال

• CurvedTextStyle constructor taking a TextStyle now also respects the fontWeight (This may be added to the constructor and copy methods in future revisions of the API) ( Ieebb9 )
• Edge swiping improvements. When Modifier.edgeSwipeToDismiss is used and a swipe to the left is triggered from the edge area, it no longer triggers swipe-to-dismiss when swipe direction changes to the right. Previously, it was possible to trigger swipe-to-dismiss by swiping to the left and then swiping to the right.( I916ea )
• HorizontalPageIndicator now shows up to 6 pages on the screen. If there are more than 6 pages in total, it shows a half-size indicator on the left or right, with a smooth transition between pages.( I2ac29 )
• Improved default snap behavior on ScalingLazyColumn and Picker ( I49539 )
• Edge swiping improvements. When Modifier.edgeSwipeToDismiss is used, swipe-to-dismiss only triggers when first touch lands on the edge and swiped to the right, Previously it was possible to trigger swipe-to-dismiss by swiping from any part of the screen if a scroll reaches the start.( I8ca2a )

نسخه 1.0.0-beta01

11 مه 2022

androidx.wear.compose:compose-foundation:1.0.0-beta01 , androidx.wear.compose:compose-material:1.0.0-beta01 , and androidx.wear.compose:compose-navigation:1.0.0-beta01 are released . نسخه 1.0.0-beta01 حاوی این تعهدات است.

What's in Compose for Wear OS 1.0

The 1.0.0-beta01 of Compose for Wear OS marks an important milestone as the library is feature complete and the API locked.

Wear Compose Material components in the 1.0 release include:

• Material Theme - used as a replacement for the Compose for Mobile MaterialTheme , provides the colors, shapes and typography for building components on Wearables that implement the Wear Material Design UX guidelines out of the box.
• Button , CompactButton and ToggleButton - Button offers a single slot to take an icon, image or short text (3 characters max). Circular in shape with recommended sizes for default, large or small buttons. CompactButton offers a single slot to take any content (icon, image or text) and is circular in shape with background size extra small. CompactButton has optional transparent padding around the background that increases the clickable area. ToggleButton is a button that offers a single slot to take any content (short text, icon or image) and has on/off (checked/unchecked) states with coloring and different icons to show whether checked or not
• Cards - used to display information about applications such as notifications. Flexible design for different use cases with AppCard and TitleCard giving different layouts and support for images as either card contents or backgrounds.
• Chips - stadium shaped components similar to buttons, but with a larger area and multiple slots to allow for labels, secondary labels and icons. In different sizes and with support for images as backgrounds.
• ToggleChips and SplitToggleChips - a Chip with a checked/unchecked state and the addition of a ToggleControl slot to show an icon such as a switch or radio button to show the checked state of the component. In addition, the SplitToggleChip has two tappable areas, one clickable and one toggleable.
• CircularProgressIndicator - Wear Material progress indicator with two variations. The first expresses the proportion of completion of an ongoing task and supports a gap in the circular track between start and end angles. The second indicates indeterminate progress for an unspecified wait time.
• curvedText - forms part of the DSL for describing CurvedLayouts , along with curvedRow and curvedColumn , to lay out components around circular devices. See Wear Component Foundation below for more details on CurvedLayout and CurvedModifier (this plays a similar role to Modifiers in the non curved world and allows for configuration of various aspects of layout, padding, gradients, etc).
• Dialog, Alert and Confirmation - Dialog displays a full-screen dialog, layered over any other content, and supports swipe-to-dismiss. It takes a single slot which is expected to be opinionated Wear Material dialog content such as Alert or Confirmation. Alert is opinionated dialog content with slots for icon, title and message. It has overloads for either two negative and positive buttons shown side-by-side or a slot for one or more vertically stacked chips. Confirmation is opinionated dialog content that displays a message for a given duration. It has a slot for an icon or image (that could be animated).
• HorizontalPageIndicator - shows horizontal page position in a fashion appropriate to the Wearable form factor. Designed to take the full screen and show a curved indicator on round devices. Can be used with the Accompanist page viewer.
• Icon - A Wear implementation of Icon which takes color and alpha from the Wear Material Theme. For a clickable icon, see Button or Chip.
• Picker - displays a scrollable list of items from which to pick. By default, items will be repeated 'infinitely' in both directions. Can be displayed in read-only mode to hide unselected options.
• PositionIndicator - shows scroll position or other positional indication in a fashion appropriate to the Wearable form factor. Designed to take the full screen and shows a curved indicator on round devices.
• Scaffold - implements the basic Wear Material Design visual layout structure. This component provides an API to put together several Wear Material components (such as TimeText , PositionIndicator and Vignette ) constructing the screen, ensuring proper layout strategy for them and collecting necessary data so these components will work together correctly.
• ScalingLazyColumn - a scrolling scaling/fisheye list component that forms a key part of the Wear Material Design language. Provides scaling and transparency effects to the content items. ScalingLazyColumn is designed to be able to handle potentially large numbers of content items, which are only materialized and composed when needed.
• Slider - allows users to make a selection from a range of values. The range of selections is shown as a bar, which can optionally be displayed with separators.
• Stepper - a full-screen component that allows users to make a selection from a range of values, using increase/decrease buttons at the top and bottom of the screen, with a slot in the middle for Text or a Chip.
• SwipeToDismissBox - handles the swipe-to-dismiss gesture. It takes a single slot for the background (only displayed during the swipe gesture) and the foreground content. Can optionally be combined with the androidx navigation library by using SwipeDismissableNavHost (see Wear Compose Navigation library below).
• Text - A Wear implementation of the Compose Material Text component, taking color and alpha from the Wear Material Theme
• TimeText - a component for showing Time and application status at the top of the screen. Adjusts to screen shape by using curved text on round screens.

• Vignette - a screen treatment for use in the Scaffold that blurs top and bottom of screen when scrollable content is in use.

• The following components are also included from Wear Compose Foundation:

• CurvedLayout - Wear Foundation CurvedLayout is a layout composable that places its children in an arc, rotating them as needed. This is similar to a Row layout curved into a segment of an annulus. Note that the content of a CurvedLayout is not a composable lambda - rather, it is a DSL (domain-specific language). All elements in the CurvedLayout's DSL support an optional modifier parameter, created from CurvedModifier .

• basicCurvedText - an element in the CurvedLayout DSL, basicCurvedText allows developers to easily write curved text following the curvature of a circle (usually at the edge of a circular screen). basicCurvedText can be only created within the CurvedLayout to ensure the best experience, like being able to specify the positioning, and using CurvedModifiers . Note that in most cases curvedText should be used instead, since it uses Material theming.

• curvedComposable - wraps normal composable content so that it can be used with CurvedLayout . If curvedComposable has several elements inside, they will be drawn on top of each other (like a Box). To put several composables along a curve, wrap each one with curvedComposable .

• curvedRow and curvedColumn - similar to Row and Column, curvedRow and curvedColumn can be nested inside a CurvedLayout to lay elements out as needed. For a curvedRow , the angular layout direction and radial alignment may be specified. For a curvedColumn , the angular alignment and radial direction may be specified.

• CurvedModifier - all curved components accept a modifier parameter that can be created using CurvedModifier : background, size, weight and padding are supported.

• The following component is also included from Wear Compose Navigation:

• SwipeDismissableNavHost - provides a place in the Compose hierarchy for self-contained navigation to occur, with backwards navigation provided by a swipe gesture. Content is displayed within a SwipeToDismissBox , showing the current navigation level. During a swipe-to-dismiss gesture, the previous navigation level (if any) is shown in the background.

• See previous release notes for the various Alpha releases for more details of what has been delivered.

تغییرات API

• Added CurvedModifier.padding* functions. These are used to specify additional space to be added around a curved component. ( I4dbb4 )
• Removed CompositionLocal internal class ( I42490 )
• We have added constant values for Button , CompactButton and ToggleButton icon sizes, as guidance ( I57cab )
• Add enabled parameter to AppCard and TitleCard . Now they have a similar API to androidx.compose.material Cards. When the parameter is set to false, the card will not be clickable. ( Idc48d , b/228869805 )

رفع اشکال

• Stepper now disables the decrease and increase buttons when the lower/upper limits have been reached (and applies ContentAlpha.disabled to the iconColor) ( I4be9f )
• We have added 1dp padding around Picker contents when drawn with a gradient to prevent jitter on text seen when swiping. ( I0b7b9 )
• Add screenshot tests for PositionIndicator ( I5e8bc )
• Add more tests for AppCard and TitleCard ( I85391 , b/228869805 )

Version 1.0.0-alpha21

20 آوریل 2022

androidx.wear.compose:compose-foundation:1.0.0-alpha21 , androidx.wear.compose:compose-material:1.0.0-alpha21 , and androidx.wear.compose:compose-navigation:1.0.0-alpha21 are released . Version 1.0.0-alpha21 contains these commits.

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

• Added new curved modifiers to specify the background of a curved element: CurvedModifier.background , .radialGradientBackground and .angularGradientBackground ( I8f392 )
• Allow curved text overflow mode (clip/ellipsis/visible) to be specified. ( I8e7aa )
• Added CurvedModifier.weight modifier, similar to the one in Compose. This can be used on children of curvedRow and CurvedLayout (for width) and children of curvedColumn (for height). ( I8abbd )
• Added CurvedModifier.size , .angularSize and .radialSize modifiers to specify the size of a curved element. ( I623c7 )

تغییرات API

• Reorder parameters to ensure background is before color consistently across the Wear Compose API ( I43208 )
• Removed clockwise & insideOut parameters and replaced with more expressive constants on new classes. Curved layout direction can now be LayoutDirection aware, and it is inherited when not specified ( If0e6a )
• We have replaced autoCenter: Boolean with autoCenter: AutoCentringParams in order to fix an API issue with the ScalingLazyColumn . ( Ia9c90 )
• We have renamed iconTintColor and toggleControlTintColor to iconColor and toggleControlColor throughout the API (Chip/ToggleChip/Dialog/Slider/Stepper/...) as the color is applied to the icon/toggleControl slot. ( Ied238 )
• Rewrite PageIndicatorStyle enum into value class ( I2dc72 )
• We have added RowScope/ColumnScope/BoxScope to some of the slots in our Composables to indicate to developers what the layouts assumptions are. This will allow developers to use additional modifiers on some slot content and avoid the need to provide extra layout elements. Additionally we have made some minor updates to the AppCard/TitleCard colors so that timeColor and appColor default to contentColor , these properties can still all be individually overridden if needed. ( I26b59 )
• Made SwipeToDismissBoxState.Companion object private ( I39e84 )
• Fix parameters order for InlineSlider and Stepper . A simple change to follow api guidelines ( I11fec )
• We have removed the Saver object for SwipeToDismissBoxState as it was not used. ( Ifb54e )
• We have updated CompactChip to bring it inline with the latest UX Specification. Padding has been reduced to horizontal = 12.dp and vertical = 0.dp. The font for label has been changed from button to caption1. The recommended icon sizes are 20x20 when both icon and label are present and 24x24 for an icon only compact chip. For the icon only use case we have also ensured that the icon is center aligned. ( Iea2be )
• We have added a number of new fields to ScalingLazyListLayoutInfo to enable developers to know the amount of contentPadding and autoCenteringPadding that has been applied. These can be useful for developers when calculating fling/scroll ( I7577b )
• We have implemented in/out transitions for Dialog. A showDialog parameter has been added and the Dialog now controls its own visibility (this enables Dialog to run the intro and outro animations when the Dialog is shown/hidden). Note that the outro animation is not performed when the user leaves the dialog via swipe-to-dismiss. We have also added a default value for state in the recently added SwipeToDismissBox overload. ( I682a0 )
• In order to better support i18n and a11y we have changed ToggleChip and SplitToggleChip so that they no longer have a default for the toggleControl slot. We have also changed ToggleChipDefaults so that the following methods now return ImageVector rather than Icon (note that as they no longer return @Composables they have changed to start with lower case), SwitchIcon()->switchIcon() , CheckboxIcon->checkboxIcon() and RadioIcon()->radioIcon() - this allows and encourages developers to create their own Icon() composables with an appropriate contentDescription set. ( I5bb5b )
• We have added a SwipeDismissableNavHostState parameter to SwipeDismissableNavHost . This supports use of edge-swiping on screens used as navigation destinations, because SwipeToDismissBoxState can now be hoisted and used to initialize both SwipeDismissableNavHostState and Modifier.edgeSwipeToDismiss on screens that require edge-swiping. ( I819f5 , b/228336555 )

رفع اشکال

• Ensure curved layouts are updated when needed. ( Ie8bfa , b/229079150 )
• Bug fix for https://issuetracker.google.com/issues/226648931 ( Ia0a0a , b/226648931 )
• Removed unnecessary experimental annotations ( I88d7e )

Version 1.0.0-alpha20

6 آوریل 2022

androidx.wear.compose:compose-foundation:1.0.0-alpha20 , androidx.wear.compose:compose-material:1.0.0-alpha20 , and androidx.wear.compose:compose-navigation:1.0.0-alpha20 are released . Version 1.0.0-alpha20 contains these commits.

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

• Add edgeSwipeToDismiss modifier for SwipeToDismiss . Allows swipeToDismiss to be active only on the left edge of the viewport. Used when the center of the screen needs to be able to handle horizontal paging, such as 2-d scrolling a Map or swiping horizontally between pages.( I3fcec , b/200699800 )

تغییرات API

• Base implementation of CurvedModifiers , this opens the way to introduce ways to customize curved content (but no CurvedModifiers are provided yet, and the ability to create custom modifiers may be available later) ( I9b8df )
• EdgeSwipe modifier documentation and default values update for better understanding .( I6d00d )
• Add PageIndicator slot into Scaffold. By adding PageIndicator directly into Scaffold we might assure that it will be correctly shown on circular devices. ( Ia6042 )
• Remove default Icons from InlineSlider and Stepper parameters. This will help developers to be more attentive to localization and accessibility requirements. Usages of default icons were shown in demos and samples. ( I7e6fd )
• Replace Trailing and Leading parameter names with Start and End in TimeText ( Iaac32 )
• We have added a SwipeToDismissBox overload with an onDismissed parameter to support the common usage of triggering a navigation event when the swipe gesture has completed. ( I50353 , b/226565726 )
• Removed ExperimentalWearMaterialApi annotations from TimeText usage ( Ide520 )
• We have marked ScalingLazyList/Column scope and info interfaces as sealed as they are not intended for external developers to implement and this will allow us to add new members in them in future without binary breaking changes. ( I7d99f )
• We have added a new flingBehaviour property to the Picker and a PickerDefaults.flingBehaviour() method to enable configuration of the fling behavior such as adding RSB support. PickerState now implements the ScrollableState interface. ( Ib89c7 )

رفع اشکال

• Update the Android Runtime (ART) baseline profile rules for Wear Compose libraries. ART can leverage profile rules on devices in order to compile ahead-of-time a specific subset of the application to improve the performance of the application. توجه داشته باشید که این هیچ تاثیری در برنامه های اشکال زدایی نخواهد داشت. ( Iaa8ef )
• Improve documentation ( I2c051 )

Version 1.0.0-alpha19

23 مارس 2022

androidx.wear.compose:compose-foundation:1.0.0-alpha19 , androidx.wear.compose:compose-material:1.0.0-alpha19 , and androidx.wear.compose:compose-navigation:1.0.0-alpha19 are released . Version 1.0.0-alpha19 contains these commits.

تغییرات API

• Renamed CurvedRow to CurvedLayout , and reworked to be a scope with a DSL. Using this DSL, more complex curved layouts can be specified using a series of nested curvedRow and curvedColumn (Which are the curved layout equivalents of Row and Column). Inside these layout elements, three elements can be used: curvedComposable (to add any @Composable), basicCurvedText (foundation's curved text) and curvedText (wear material aware curved text). ( Ib776a )
• Make the side for the PositionIndicator configurable. The basic PositionIndicator's position can now be configured to be End (layout direction-aware), OppositeRsb (takes into account screen rotation, to position itself opposite to the physical RSB), or the absolutes Left & Right. ( I2f1f3 )
• For SwipeToDismissBox , we have renamed SwipeDismissTarget .Original to SwipeToDismissValue.Default and SwipeDismissTarget.Dismissal to SwipeToDismissValue.Dismissed . We have also moved SwipeToDismissBoxDefaults.BackgroundKey and SwipeToDismissBoxDefaults.ContentKey to SwipeToDismissKeys.Background , SwipeToDismissKeys.Content respectively. ( I47a36 )
• We have added a read-only mode to Picker, for screens with multiple Pickers where only one Picker is editable at a time. When the Picker is read-only, it displays the currently selected option, and a label if one has been provided. ( I879de )
• SwipeToDismissBoxState has been refactored to restrict the scope of ExperimentalWearMaterialApi to Modifier.swipeable and SwipeableState , which are now used internally. SwipeToDismissBoxState now has currentValue , targetValue , isAnimationRunning and snapTo members to support common use cases - please let us know if you require any further properties to be made available. Also fixed the behavior of SwipeableState in the case where the swipe offset is within a rounding error of an anchor. ( I58302 )

رفع اشکال

• Simplified and fixed code to detect if the content of a ScalingLazyColumn can be scrolled (used to decide if we display a scrollbar or not) ( I7bce0 )
• Fixed a bug on Position Indicator when used with more than one state and switching between them ( I320b5 )
• We have updated the default Compose for Wear OS theme typography/fonts to match our latest UX guidance. Of note display1 (40.sp) and display2 (34.sp) are now smaller than their previous values and various other minor updates to line height and line spacing have been made. ( Ie3077 )
• We have added resistance to SwipeToDismissBox so that motion only happens when swiping to dismiss and not at all in the opposite direction. ( Ifdfb9 )
• We have changed some of the default parameter values for the CircularProgressIndicator functions to bring them in-line with Wear Material Design UX guidance. For the Spinner/Indeterminant version the size (40->24.dp), indicatorColor (primary->onBackground), trackColor transparency (30%->10%) and stroke width (4->3dp) have been updated. For the Progress/Determinate version the trackColor transparency (30%->10%) has been updated. ( I659cc )
• We have updated the default scaling params of the ScalingLazyColumn in-line with the latest Wear Material Design UX specifications. Visually this results in list items starting to be scaled closer to the list center, but being less scaled at the list edge than before. ( Ica8f3 )
• Some adjustments to ScalingLazyColumnDefaults.snapFlingBehavior to improve the end of the animation ( If3260 )

Version 1.0.0-alpha18

9 مارس 2022

androidx.wear.compose:compose-foundation:1.0.0-alpha18 , androidx.wear.compose:compose-material:1.0.0-alpha18 , and androidx.wear.compose:compose-navigation:1.0.0-alpha18 are released . Version 1.0.0-alpha18 contains these commits.

تغییرات API

• Several improvements to PositionIndicator: ShowResult renamed PositionIndicatorVisibility. Some performance improvements to avoid recomputations when not needed ( Iaed9d )
• The recommended coloring for the SplitToggleChip has been updated. SplitToggleChip's now have a solid colored background when checked or unchecked with the coloring of the ToggleControl being the primary indication of whether the component is checked or not. We have added a new ToggleDefaults.splitToggleChipColors() to support the new color scheme. We have also simplified the toggleChipColors() methods removing the splitBackgroundOverlayColor ( I7e66e )
• We have added unadjustedSize to the ScalingLazyListItemInfo as it is not safe to calculate the original item size using the scaled size and scaling factor due to float maths precision. ( I54657 , b/221079441 )
• Add HorizontalPageIndicator . It represents a total number of pages and a selected page. Might be linear or curved, depending on the shape of the device. It also supports custom indicator shape, which defines how each indicator is visually represented. ( Iac898 )
• We have updated PickerState so that the numberOfOptions can be updated. This supports use-cases such as a DatePicker , when the number of days in the month changes depending on the month selected. The constructor parameter for PickerState has changed to initialNumberOfOptions accordingly. ( Iad066 )
• Hide the PositionIndicator when is a scrollbar and can't scroll. ( Id0a7f )
• For consistency with Scaffold, our full-screen Dialog component now displays a PositionIndicator and a Vignette . We are also now using ScalingLazyColumn instead of Column , which means that the Dialog contents are now in ScalingLazyListScope (and typically need to be enclosed by item { /* content */ }). Dialog supports the verticalArrangement parameter accordingly. ( Idea13 )
• We have changed the name of ToggleChip and SplitToggleChip toggleIcon property to toggleControl to better align with Material Design in order to help designers and developers navigate the API. ( If5921 , b/220129803 )
• We have added a new entry caption3 to the Wear Material Theme Typology.Caption3 is a small font used for the extra long-form writing like legal texts. ( I74b13 , b/220128356 )

رفع اشکال

• Stop the snapping animation when we are there. ( Idb69d )
• Animate changes in PositionIndicator. ( I94cb9 )
• Based on UI/UX feedback we have changed the ScalingLazyColumn autoCentering so that it will provide only enough space to make sure the items with index ScalingLazyListState.initialCenterItemIndex or higher will be able to be fully scrolled to the center of the viewport. This allows developers to place one or two items about the item initially in the center which are not scrollable into the middle. This will mean that an autoCenter'ing ScalingLazyColumn will not be able to scroll above the initialCenterItemIndex/initialCenterItemScrollOffset ( I22ee2 )
• We have added a demo for a Date Picker and fixed a bug in PickerState where the initiallySelectedOption was not applied until the Picker had been displayed. ( Id0d7e )
• In order to reduce the clipping of wider ScalingLazyColumn items on circular screens we have increased the default horizontal content padding from 8 to 10 dp. ( I0d609 )
• Ensure the PositionIndicator is shown when scrolling. ( Ied9a2 )

Version 1.0.0-alpha17

23 فوریه 2022

androidx.wear.compose:compose-foundation:1.0.0-alpha17 , androidx.wear.compose:compose-material:1.0.0-alpha17 , and androidx.wear.compose:compose-navigation:1.0.0-alpha17 are released . Version 1.0.0-alpha17 contains these commits.

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

• We have added snap support that can be used with ScalingLazyColumn . Set flingBehavior = ScalingLazyColumnDefaults.flingWithSnapBehavior(state) to enable snap support. ( I068d3 , b/217377069 )
• We have added demos for Picker used to select a time in either 24 hour or 12 hour clock. ( Ie5552 )

تغییرات API

• Fix an issue with TimeText custom fonts & styles on square device ( Iea76e )
• ScalingLazyListLayoutInfo now has reverseLayout , viewportSize and orientation properties matching those from LazyListLayoutInfo ( I4f258 , b/217917020 )
• ScalingLazyColumn now has a userScrollEnabled property matching that from LazyList ( I164d0 , b/217912513 )
• Pickers now have a gradient on the top and bottom by default ( Iab92a )

رفع اشکال

• We have modified ScalingLazyColumn so that it no longer greedily fills all of the space in its parent. Instead it will take its size from the size of its contents. This makes it consistent with the behaviour of LazyColumn . If you want to reinstate the old behaviour then pass Modifier.fillMaxWidth()/width()/widthIn() to the ScalingLazyColumn ( I51bf8 )
• We have improved the exception message in SwipeDismissableNavHost.kt that was triggered if the navigation backstack was empty. ( I1b1dc )

Version 1.0.0-alpha16

9 فوریه 2022

androidx.wear.compose:compose-foundation:1.0.0-alpha16 , androidx.wear.compose:compose-material:1.0.0-alpha16 , and androidx.wear.compose:compose-navigation:1.0.0-alpha16 are released . Version 1.0.0-alpha16 contains these commits.

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

• Add CircularProgressIndicator . Progress indicators display the length of a process or an unspecified wait time. Supports a gap (cutout) for TimeText or other components if used full-screen. ( Iab8da )

تغییرات API

• Pickers now have a flingBehavior parameter, the default value makes them snap to the closest option when scrolling/flinging. ( I09000 )
• Additional integer API for InlineSlider and Stepper ( I1b5d6 )

رفع اشکال

• We have changed the default initialCenterItemIndex for the ScalingLazyListState from 0->1. This means that unless overridden on state construction with ScalingLazyListState.rememberScalingLazyListState(initialCenterItemIndex = ) then the 2nd list item (index == 1) will be placed in the center of the viewport at initialization and the 1st (index == 0) item will be placed before it. This allows for a better default visual effect out of the box as most of the viewport will be filled with list items. ( I0c623 , b/217344252 )
• We have reduced the ScalingLazyColumn default extraPadding that is provided to ensure that there are plenty of list items to draw (even when we are scaling some of them down in size) from 10% to 5%. This will avoid composing extra list items that might not appear in the viewport. If non standard scalingParams are being used (more extreme scaling for instance) the developer can adjust extra padding using viewportVerticalOffsetResolver . ( I76be4 )
• Fix an issue with TimeText on multiple lines on square device ( Ibd3fb )
• We have modified ScalingLazyColumn so that it no longer greedily fills all of the space in its parent. Instead it will take its size from the size of its contents. This makes it consistent with the behavior of LazyColumn . If you want to reinstate the old behavior then pass Modifier.fillMaxSize() to the ScalingLazyColumn - NOTE: This change is incomplete and will be addressed in a follow up change in the next Alpha release. ( I3cbfa )

Version 1.0.0-alpha15

26 ژانویه 2022

androidx.wear.compose:compose-foundation:1.0.0-alpha15 , androidx.wear.compose:compose-material:1.0.0-alpha15 , and androidx.wear.compose:compose-navigation:1.0.0-alpha15 are released . Version 1.0.0-alpha15 contains these commits.

تغییرات API

• We have added a new property autoCentering to the ScalingLazyColumn . When true (the default) this will ensure that all items including the first and last can be scrolled so that they are visible in the center of the lists viewport. Note that if using auto-centering you will probably want to set vertical content padding to 0.dp. If both autoCentering and vertical content padding are provided then they will both result in additional space being available before the first and after the last list items allowing them to be scrolled even further. ( I2a282 , b/214922490 )
• We have added a Dialog component that enables any composable to trigger a full screen dialog that sits on top of other content. When shown, the dialog supports swipe-to-dismiss and will show its parent's content in the background during the swipe gesture. The dialog content is expected to be Alert or Confirmation (renamed from earlier components AlertDialog and ConfirmationDialog ) - Alert , Confirmation and Dialog are all in the androidx.wear.compose.material.dialog package. Alert and Confirmation can be used as navigation destinations. Also, added ColumnScope to Alert and Confirmation parameters as necessary. ( Ia9014 )
• We have removed onSurfaceVariant2 from the Compose for WearOS Material Theme Colors and replaced uses in the library with onSurfaceVariant . ( Icd592 )
• Added a method to programmatically select an option on the PickerState , the initially selected option can now also be specified when creating a PickerState . ( I92bdf )
• We have added support for customizing the fling behavior of the ScalingLazyColumn . ( I1ad2e , b/208842968 )
• We have added NavController.currentBackStackEntryAsState() to the Wear.Compose.Navigation library. ( If9028 , b/212739653 )
• Added Modifier.onRotaryScrollEvent() and Modifier.onPreRotaryScrollEvent() for Wear devices with a rotating side button.( I18bf5 , b/210748686 )

Version 1.0.0-alpha14

12 ژانویه 2022

androidx.wear.compose:compose-foundation:1.0.0-alpha14 , androidx.wear.compose:compose-material:1.0.0-alpha14 , and androidx.wear.compose:compose-navigation:1.0.0-alpha14 are released . Version 1.0.0-alpha14 contains these commits.

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

• We have added a number of methods to ScalingLazyListState to allow developer control over scrolling to specific list items and also setting the initial list item and offset.

  As part of this change we have also modified the ScalingLazyList so that it is oriented around the center of the viewport of the ScalingLazyList rather than the start of the viewport.

  A new property anchorType: ScalingLazyListAnchorType = ScalingLazyListAnchorType.ItemCenter has been added to the ScalingLazyList to control whether the center ( ScalingLazyListAnchorType.ItemCenter ) or Edge ( ScalingLazyListAnchorType.ItemStart ) should be aligned to the viewport's centerline.

  As a result the ScalingLazyListItemInfo.offset and ScalingLazyListItemInfo.adjustedOffset have changed and will now reflect the offset of the item with respect to both the position of the list item and the anchorType of the list. Eg for a ScalingLazyColumn with anchorType of ItemCenter and an list item positioned with its center on the centerline of the viewport the offset would be 0 .

  The new methods are scrollTo , animatedScrollTo , centerItemIndex , and centerItemOffset . ( I61b61 )

• We have added a back button handler to SwipeDismissableNavHost , so that pressing back navigates to the previous level in the navigation hierarchy. ( I5b086 , b/210205624 )

نسخه 1.0.0-alpha13

15 دسامبر 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha13 , androidx.wear.compose:compose-material:1.0.0-alpha13 , and androidx.wear.compose:compose-navigation:1.0.0-alpha13 are released . Version 1.0.0-alpha13 contains these commits.

تغییرات API

• We have made RangeIcons internal (referenced internally by InlineSlider and Stepper ). ( I927ec )

رفع اشکال

• Fixed an issue where SwipeDismissableNavHost would add a destination to the Compose hierarchy before it has reached the CREATED Lifecycle state, resulting in an IllegalStateException . This fix was a prerequisite to updating dependency on navigation-compose to 2.4.0-beta02 and beyond. ( I40a2b , b/207328687 )

• Added a Drawables enum class for getting drawable resources within the Wear Compose library, so that reflection is no longer needed. This fixes a bug where library drawables were removed when minifyEnabled=true or shrinkResources=true ). ( Ib2a98 )

• Added tests for Stepper in Wear Compose ( I2d03a )

• Added samples for SwipeDismissableNavHost in Wear Compose Navigation. ( I85f06 )

نسخه 1.0.0-alpha12

1 دسامبر 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha12 , androidx.wear.compose:compose-material:1.0.0-alpha12 , and androidx.wear.compose:compose-navigation:1.0.0-alpha12 are released . Version 1.0.0-alpha12 contains these commits.

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

• We have added a Stepper component which allows users to make a selection from a range of values. Stepper is a full-screen control with increase and decrease buttons at the top and bottom, and a slot in the middle (expected to take either a Chip or Text). The button icons can be customized if required. ( I625fe )

• We have added 2 new composables for displaying dialogs: AlertDialog waits for a response from the user and displays a title, icon, message and either a) two buttons for simple positive/negative choices or b) vertically stacked chips or toggle chips for more flexible choices, ConfirmationDialog displays an acknowledgement with a timeout. This simple dialog has slots for a title and an (animated) icon. ( Ic2cf8 )

تغییرات API

• Add units (millis) to suggested dialog duration values. ( I09b48 )

Version 1.0.0-alpha11

17 نوامبر 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha11 , androidx.wear.compose:compose-material:1.0.0-alpha11 , and androidx.wear.compose:compose-navigation:1.0.0-alpha11 are released . Version 1.0.0-alpha11 contains these commits.

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

• We have added a picker component that lets the user select an item from a scrolling list. By default, the list of selectable items is repeated 'infinitely' in both directions, to give the impression of a rotating cylinder seen from the side. Two features will be added in later releases: snapping to a value after a swipe/fling; adding a function to PickerState to set/scroll to the current value. ( I6461b )

تغییرات API

• Added a ScalingLazyItemScope and some new modifiers fillParentMaxSize/fillParentMaxWidth/fillParentMaxHeight to allow list items to be sized based on the size of the parent container. Items can be set to fill all or a fraction of the parent's size. This exposes functionality already available in the LazyRow/Column ( I4612f )
• Added support to ScalingLazyColumn to allow items to have a key. Also added convenience methods to allow adding of items from Arrays and Lists. ( Ic1f89 )

رفع اشکال

• Additional examples for TimeText ( I8cb64 )

نسخه 1.0.0-alpha10

3 نوامبر 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha10 , androidx.wear.compose:compose-material:1.0.0-alpha10 , and androidx.wear.compose:compose-navigation:1.0.0-alpha10 are released . Version 1.0.0-alpha10 contains these commits.

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

• Added an InlineSlider for wear compose. InlineSlider 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. ( If0148 )

• Check out the new Compose for WearOS Codelab !

تغییرات API

• Macrobenchmark now has a minSdkVersion of 23 . ( If2655 )

رفع اشکال

• Update transition handling in SwipeDismissableNavHost in a SideEffect ( I04994 , b/202863359 )
• Update transition handling in SwipeDismissableNavHost ( I1cbe0 , b/202863359 )

نسخه 1.0.0-alpha09

27 اکتبر 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha09 , androidx.wear.compose:compose-material:1.0.0-alpha09 , and androidx.wear.compose:compose-navigation:1.0.0-alpha09 are released . Version 1.0.0-alpha09 contains these commits.

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

• We have launched the Developer Preview of Compose on Wear OS - see our blog post which reviews the main composables and links to further resources to starting using them.

تغییرات API

• We have added support for developers to be able to customize all of the colors in the Wear Material Design Color theme. ( I4759b , b/199754668 )

رفع اشکال

• Added SwipeToDismissBox samples that persist state ( Ibaffe )
• Added links to developer.android.com guides from KDocs for CurvedText, TimeText and SwipeToDismissBox. ( I399d4 )
• SwipeDismissableNavHost now throws if there's no current destination (indicates that the NavGraph was not built with the wear.compose.navigation.composable utility function) ( I91403 )
• Added additional documentation and examples for time source usage in TimeText ( I4f6f0 )

نسخه 1.0.0-alpha08

13 اکتبر 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha08 , androidx.wear.compose:compose-material:1.0.0-alpha08 , and androidx.wear.compose:compose-navigation:1.0.0-alpha08 are released . Version 1.0.0-alpha08 contains these commits.

تغییرات API

• We have renamed AppCard and TitleCard body properties to content and moved them to the end of the property list to allow them to be provided as a trailing lambda. Also renamed bodyColor to contentColor for consistency with the new slot names. ( I57e78 )

رفع اشکال

• Added links to developer.android.com guides from KDocs for button, card, chip, theme, position indicator and scaling lazy column components. ( I22428 )
• Fix WearOS SwipeToDismissBox sometimes not handling swipes. ( I9387e )
• Added samples for Button, CompactButton, Chip, CompactChip, AppCard, TitleCard, ToggleButton, ToggleChip, SplitToggleChip ( Iddc15 )
• Added microbenchmark performance tests for Card, Chip, ToggleChip, TimeText and ScalingLazyColumn. ( If2fe9 )

نسخه 1.0.0-alpha07

29 سپتامبر 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha07 , androidx.wear.compose:compose-material:1.0.0-alpha07 , and androidx.wear.compose:compose-navigation:1.0.0-alpha07 are released . نسخه 1.0.0-alpha07 حاوی این commit ها است.

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

• Added a CurvedText component in material, a component allowing developers to easily write curved text following the curvature of a circle (usually at the edge of a circular screen). ( I19593 )

تغییرات API

• Added tests for TimeText ( Idfead )
• Transform ArcPaddingValues into an interface. ( Iecd4c )
• Added animation to SwipeToDismissBox ( I9ad1b )
• Added hasBackground parameter to the SwipeToDismissBox API so that the swipe gesture can be disabled when there is no background content to display. ( I313d8 )
• rememberNavController() now takes a optional set of Navigator instances that will be added to the returned NavController to better support optional Navigators such as those from Accompanist Navigation Material . ( I4619e )
• Reference NamedNavArgument from navigation-common and remove copy from wear.compose.navigation. ( I43af6 )

رفع اشکال

• Fixed CurvedRow test flakiness on smaller devices. ( If7941 )
• Fixed possible flickering on CurvedRow when the content updates, and ensures the curved row is remeasured ( Ie4e06 )
• ChipDefaults.gradientBackgroundChipColors() has been updated in line with UX Spec changes. The gradient now starts with MaterialTheme.colors.primary with alpha 32.5% and ends with MaterialTheme.colors.surface with alpha @ 0% over a background of MaterialTheme.colors.surface @ 75% alpha. ( Id1548 )
• We have updated the colors for ToggleChips when in the selected state to match the latest Wear Material Design UX Spec guidance. When selected ToggleChips now have a gradient background from MaterialTheme.color.surface @ 0% alpha, top left, to MaterialTheme.color.primary @ 32% alpha, bottom right, over a background of MaterialTheme.color.surface @ 75% alpha. This results in a more subtle difference between checked and unchecked for the ToggleChip. ( Idd40b )

نسخه 1.0.0-alpha06

15 سپتامبر 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha06 , androidx.wear.compose:compose-material:1.0.0-alpha06 , and androidx.wear.compose:compose-navigation:1.0.0-alpha06 are released . نسخه 1.0.0-alpha06 حاوی این commit ها است.

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

• We have added Scaffold a top level application composable that provides a structure for handling PositionIndicators (like Scroll or Volume) position, an area at the top of the screen for displaying the time and application status, and also supports a Vignette to blur the screen top and bottom edge for scrollable content. The main area of the Scaffold is where the application contents are placed. ( I5e0bf )
• Added TimeText implementation for Wear Compose ( I5654c )

Wear Compose Navigation Library

• We have added the first release of the Wear Compose Navigation library, which provides integration between the Wear Compose and Androidx Navigation libraries. It provides a simple means to navigate between @Composable functions as the destinations in your application.

• This initial release provides:

  • A SwipeDismissableNavHost composable that hosts a navigation graph and provides backwards navigation via swipe gestures
  • NavGraphBuilder.composable extension to assist with constructing navigation graphs
  • rememberSwipeDismissableNavController() to allow hoisting state

• Example usage where we create two screens and navigate between them:

  val navController = rememberSwipeDismissableNavController()
  SwipeDismissableNavHost(
      navController = navController,
      startDestination = "start"
  ) {
      composable("start") {
          Column(
              horizontalAlignment = Alignment.CenterHorizontally,
              verticalArrangement = Arrangement.Center,
              modifier = Modifier.fillMaxSize(),
          ) {
              Button(onClick = { navController.navigate("next") }) {
                  Text("Go")
              }
          }
      }
      composable("next") {
          Column(
              horizontalAlignment = Alignment.CenterHorizontally,
              verticalArrangement = Arrangement.Center,
              modifier = Modifier.fillMaxSize(),
          ) {
              Text("Swipe to go back")
          }
      }
  }
  

• Wear Compose Navigation is packaged as a separate library so that simple WearCompose applications that implement their own hand-rolled navigation are not required to depend on the Androidx Navigation library.

تغییرات API

• Updated SwipeDismissableNavHost to support rememberSaveable by setting the key identity for background and content ( I746fd )
• We have added a PositionIndicator adapter that can handle LazyListState ( I21b88 )
• Updated SwipeToDismissBox to support rememberSaveable ( Ie728b )
• We have added reverseLayout support to the ScalingLazyColumn. This allows for the reversing of the direction of scrolling and layout ( I9e2fc )
• performGesture مستهلک و GestureScope ، که توسط performTouchInput و TouchInjectionScope جایگزین شده اند. ( ia5f3f ، b/190493367 )
• We have renamed VignetteValue to VignettePosition and renamed VignetteValue.Both renamed to VignettePosition.TopAndBottom. ( I57ad7 )
• We have renamed ScalingLazyColumnState to ScalingLazyListState, ScalingLazyColumnItemInfo to ScalingLazyListItemInfo, ScalingLazyColumnLayoutInfo to ScalingLazyListLayoutInfo and ScalingLazyColumnScope to ScalingLazyListScope in case we decide to add a ScalingLazyRow implementation in the future. ( I22734 )

رفع اشکال

• Updated CompactChip documentation to describe what happens if neither an icon nor a label is provided. ( I4ba88 )
• We have made some adjustments to the Wear card components. ( I6b3d0 )
  1. TitleCard spacing between Title and Body reduced from 8.dp to 2.dp.
  2. TitleCard header font changed from body to title3.
  3. Card background gradient changed to make the background appear darker.

نسخه 1.0.0-alpha05

1 سپتامبر 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha05 and androidx.wear.compose:compose-material:1.0.0-alpha05 are released. نسخه 1.0.0-alpha05 حاوی این commit ها است.

تغییرات API

• Mark ArcPaddingValues as @Stable ( I57deb )
• ScalingLazyColumnState now implements the ScrollableState interface giving developers programmatic access to scroll the component. ( I47dbc )

رفع اشکال

• We have reduced the spacing between Icon and Text in Chip and ToggleChip to bring them in line with updates to the UX Spec. ( I83802 )

نسخه 1.0.0-alpha04

18 آگوست 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha04 and androidx.wear.compose:compose-material:1.0.0-alpha04 are released. نسخه 1.0.0-alpha04 حاوی این commit ها است.

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

• Added a SwipeToDismissBox and swipeable modifier that can be used to support a left-to-right swipe-to-dismiss gesture. Although independent of navigation components, this is expected to be used to exit one screen and navigate to another. Added integration tests to demo swipe-to-dismiss. ( I7bbaa )
• We have added ScalingLazyColumnItemInfo and ScalingLazyColumnLayoutInfo interfaces to ScalingLazyColumnState class to enable developers to know the actual positions and sizes of items in the ScalingLazyColumn after scaling has been applied. We have also fixed a bug with the way that scaling was calculated when 'top' content padding is applied to the ScalingLazyColumn. ( I27c07 )

تغییرات API

• Add CurvedTextStyle class to specify curved text styling Options. Similar to TextStyle, but now only supports color, fontSize and background. More styling options will be added in the future. ( I96ac3 )
• We have added ScalingLazyColumnItemInfo and ScalingLazyColumnLayoutInfo interfaces to ScalingLazyColumnState class to enable developers to know the actual positions and sizes of items in the ScalingLazyColumn after scaling has been applied. We have also fixed a bug with the way that scaling was calculated when 'top' content padding is applied to the ScalingLazyColumn. ( I27c07 )
• Added @ExperimentalWearMaterialApi to SwipeDismissTarget enum, part of the SwipeToDismissBox API. ( I48b5e )

رفع اشکال

• Added test material for SwipeToDismissBox ( I9febc )

نسخه 1.0.0-alpha03

4 آگوست 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha03 and androidx.wear.compose:compose-material:1.0.0-alpha03 are released. نسخه 1.0.0-alpha03 حاوی این commit ها است.

تغییرات API

• Added CurvedText component, that allows developers to easily write text following the curvature a circle (usually at the edge of a circular screen) ( Id1267 )
• We have renamed CardDefaults.imageBackgroundPainter() to CardDefaults.imageWithScrimBackgroundPainter() to make it clear that the background image with have a scrim drawn over it. ( I53206 )
• Adding ScalingLazyColumn component that provides a list component for Wear Material that gives a fisheye view with the list contents scaling down in size and becoming transparent as they scale towards the edge of the component. ( I7070c )

رفع اشکال

• We changed the default color of the appName content in AppCard in response to a UX Spec update. The default color for the appName is now MaterialTheme.colors.onSurfaceVariant . Additionally added a missing parameter doc description for the title slot. ( Ic4ad1 )

نسخه 1.0.0-alpha02

21 جولای 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha02 and androidx.wear.compose:compose-material:1.0.0-alpha02 are released. نسخه 1.0.0-alpha02 حاوی این commit ها است.

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

• Added a new class CurvedRow to laid out composables in an arc ( I29941 )
• Added a new type of card for use in applications (TitleCard), also add support for having images as the background to Cards to emphasize their contents ( I53b0f )

تغییرات API

• Add support for radial alignment to CurvedRow (similar to the vertical alignment in a row) ( Id9de5 )
• Add a new class CurvedRow to laid out composables in an arc ( I29941 )
• Added a new type of card for use in applications (TitleCard), also add support for having images as the background to Cards to emphasize their contents ( I53b0f )
• Added toggle icons (checkbox, switch and radio buttons) to ToggleChipDefaults to make it easier for developers to configure ToggleChip and SplitToggleChips ( I7b639 )
• The start and end content padding for Chips has been updated so that it is consistently 14.dp regardless of whether the Chip has an icon present or not (was previously 12.dp if icon present and 14.dp if not) ( I34c86 )

رفع اشکال

• Add tests for CurvedRow ( I93cdb )
• Tying Wear Compose dependencies to Compose 1.0.0-rc01. ( Ie6bc9 )
• Changed the handing of background image painting in Cards and Chips so that the image is Cropped rather than being stretched in order to maintain image proportions. ( I29b41 )
• Added more demos and integration tests for Button and ToggleButton. ( 5e27ed2 )
• Added more Chip tests to cover the content colors for imageBackgroundChips ( Ia9183 )

نسخه 1.0.0-alpha01

1 ژوئیه 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha01 and androidx.wear.compose:compose-material:1.0.0-alpha01 are released. نسخه 1.0.0-alpha01 حاوی این commit ها است.

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

Wear Compose is a Kotlin, Compose-based library that supports Wear Material design, an extension of Material Design for WearOS wearables. This first alpha release contains early, functional implementations of the following:

• Material theme - configures the colors, typography and shapes consistently across the components used from this library.
• Chip, CompactChip - chips are stadium shaped and variations are available to take icon, label and secondary label content.
• - ToggleChip, SplitToggleChip - a specialized type of chip that includes a slot for a bi-state toggle icon such as a radio button or checkbox. In addition, the SplitToggleChip has two tappable areas, one clickable and one toggleable.
• Button, CompactButton - buttons are circular in shape, with a single content slot for an icon or minimal text (maximum 3 characters).
• ToggleButton - a button that turns an action on or off, with a single slot for icon or minimal text (maximum 3 characters).
• Card, AppCard - rectangular shaped with rounded corners, offering slots for content such as app icon, time, title and body.

Future releases will extend the Widget set adding support for Wear Material Design pickers, sliders, lists, page indicators, dialogs, scroll rsb indicators, toasts and more.

Additionally support will be provided for other Wearable Specific features such as curved layouts and text, as well as scaffolding to make it easy for developers to build Wearable apps/overlays.

Wear Compose Material is designed with the same principles as Compose Material, although being targeted at wearables. The Wear Compose Material library should be used in place of the Compose Material library when building for a Wearable device.

The two “Material” libraries should be considered mutually exclusive and should not be mixed in the same app. If developers find themselves including the Compose Material library in their dependencies it would suggest that either a) there are components missing from the Wear Compose Material library, please let us know what you need, or b) are using a component that we do not recommend for use on a Wearable Device.