نوشتن در Wear

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

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

وابستگی‌های آرتیفکت‌های موردنیازتان را در فایل build.gradle برای برنامه یا واحدتان اضافه کنید:

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

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

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

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

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

    // For integration between Wear Compose and Androidx Navigation libraries
    implementation("androidx.wear.compose:compose-navigation:1.7.0")
    
    // For Wear preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.7.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 کمک می‌کند. اگر مشکلات جدیدی پیدا کردید یا ایده‌هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل‌از ایجاد کتابخانه جدید، مشکلات موجود در این کتابخانه را بررسی کنید. با کلیک کردن روی دکمه ستاره می‌توانید رأی خود را به یک مشکل موجود اضافه کنید.

ایجاد مشکل جدید

برای کسب اطلاعات بیشتر، به مستندات «پیگیری مسائل» مراجعه کنید.

نسخه ۱.۸

نسخه 1.8.0-alpha01

۷ اکتبر ۲۰۲۶

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

تغییرات میانای برنامه‌سازی کاربردی

• ‫AppScaffold و ScreenScaffold سربار جدید بدون پارامتر timeText اضافه شد و جهت توصیه‌شده برای انتقال Wear Compose 1.8 به «نوار وضعیت سیستم» جدید تعیین شد. وقتی در ساخت‌های قدیمی‌تر بدون «نوار وضعیت سیستم» اجرا می‌شود، این سربارهای جدید به پیش‌فرض TimeText برمی‌گردند. اکنون سربارهای موجود به‌طور پیش‌فرض به «نوار وضعیت سیستم» منتقل می‌شوند، مگر اینکه timeText سفارشی صریحی ارائه شود. (I40a5e)
• ‫StatusBarSuppression عنصر ترکیبی کمکی اضافه شد تا «نوار وضعیت سیستم» را در عناصر تمام‌صفحه و رونهاد سرکوب کند. (I387c3)
• «اصلاح‌گر معرفی‌شده»curveToEdge که از سایه‌زن برای منحنی کردن عنصر به حاشیه محتوی اصلی در اطراف مرکز استفاده می‌کند و همیشه محتوی را به‌عنوان دایره درنظر می‌گیرد. مشکلات شناخته‌شده: اجزای کلیک‌کردنی مرزهای کلیک‌کردنی نادرستی خواهند داشت و TalkBack اجزا را به‌درستی برجسته نمی‌کند. (I8bbaa)
• ‫PullToRefreshBox و PullToRefreshState به «نوشتن Wear با Material 3» اضافه شد، با فاصله‌های کشیدن و آستانه‌های بازآوری که برای دستگاه‌های Wear OS سفارشی‌سازی شده است.(Iee9a5)
• ‫PullToRefreshBox،‏ PullToRefreshDefaults، و PullToRefreshState را به «میاناهای برنامه‌سازی کاربردی» عمومی پایدار در Wear Compose Material 3 ارتقا دادیم. (I079b6)
• یک سربار SwipeToReveal با پارامتر تبدیل اضافه می‌کند تا از تبدیل‌های محتوی در TransformingLazyColumn پشتیبانی کند. (I328ce)
• کتابخانه‌ها اکنون Kotlin 2.2 را هدف‌یابی می‌کنند و به kotlinc 2.2 نیاز دارند (I82396، b/498369605)
• پرچم ویژگی آزمایشی WearComposeFoundationFlags.isTransformingLazyColumnClickableThresholdEnabled برداشته شد. آستانه کلیک‌کردنی در TransformingLazyColumn اکنون همیشه فعال است. (Ib68c8)
• پرچم آزمایشی WearComposeFoundationFlags.isTransformingLazyColumnPinnableContainerEnabled برداشته شد. (Ibad2e)

رفع اشکال‌ها

• اشکال در Wear Compose Foundation HorizontalPager برطرف شد. در این اشکال، مدیریت اشاره نمی‌توانست بین صفحه‌بندی و تند کشیدن برای بستن اولویت‌بندی صحیح انجام دهد. (I54caf)
• ‫Modifier.testTag("time_text") به TimeText اضافه شد تا در موارد آزمایشی که «نوار وضعیت سیستم» به عنصر ترکیبی پیش‌فرض TimeText برمی‌گردد، بتواند آن را تشخیص دهد. (Iacb09)
• ‫IllegalStateException در OneHandedGestureModifier.updateCompositionLocals که به‌دلیل دسترسی به گره‌ها قبل‌از پیوست کردن ایجاد شده بود برطرف شد. (I662271)
• پشتیبانی از اشاره AlertDialog اضافه شد، بنابراین پیمایش به پایین و کلیک‌های دکمه Confirm به‌طور پیش‌فرض دردسترس است. (I51f81)
• با بهبود منطق سرکوب رؤیت‌پذیری در ScreenContent، مشکل چشمک زدن TimeText در برنامه هنگام انتقال به نوار وضعیت ارثی برطرف شد. (I12dd01)
• رفع مشکلی که باعث می‌شد مؤلفه‌هایی که «نوار وضعیت سیستم» را سرکوب می‌کردند (مثل «گام‌به‌گام») به ارائه TimeText درون‌برنامه‌ای برگردند. (I86830)
• ‫StatusBarSuppression() اصلاح شد تا وقتی نوار وضعیت سراسری غیرفعال است، LocalStatusBarEnabled را رعایت کند و از عبورهای غیرضروری چیدمان در کادرهای گفتگو جلوگیری کند. (I4f77f6)
• مشکلی در Wear Material3 Scaffold برطرف شد که در آن وقتی صفحه بالایی مقدار تهی ارائه می‌داد، currentScrollInfoProvider از صفحه‌های زیرین ارث نمی‌برد. (I97874)
• پشتیبانی از سرکوب نوار وضعیت Dialog و ScreenScaffold تو در تو در Wear Material3 Scaffold اضافه شد. (I01772)
• مشکلی در AppScaffold برطرف شد که باعث می‌شد رونهاد نوار وضعیت هنگام پیمایش در عنصر لنگر بالا دوباره ظاهر شود. (I421b3)
• مشکلی که در آن ScreenScaffold بالایی هنگام باز کردن صفحه‌هایی با حالت نوار وضعیت غیرفعال جمع می‌شد برطرف شد. (I7cf4f)
• پشتیبانی از هماهنگی نوار وضعیت چندپنجره‌ای به داربست‌های Wear Compose Material3 اضافه شد که به کادرهای گفتگو و پنجره‌های جداگانه امکان می‌دهد کنترل‌کننده‌های نوار وضعیت سیستم خودشان را هدایت کنند. ‫(Ibf82c)
• ‫TransformingLazyColumn دربرابر فاصله‌های منفی بین موارد مقاوم شد (I99ac7)
• نشانگرهای اشاره بهینه شد و پس‌زمینه اشاره‌گر نشانگر در منابع با عملکردهای بوم بااستفاده از مسیرها جایگزین شد. (Iee2b7)
• نشانگرهای اشاره بهینه‌سازی‌شده با جایگزین کردن AVDهای اصلی و بستن در منابع با توابع رسم بااستفاده از مسیرها. (Ib2d05)
• ‫androidx.lifecycle:lifecycle-runtime پیش‌نیاز به نسخه ۲.۱۰.۰ به‌روزرسانی شد. این نسخه برای اجرای بررسی‌های لینت زمان اجرای چرخه حیات دسته‌ای با AGP نسخه ۹.۵.۰-alpha04 یا جدیدتر الزامی است. (I99bfd، b/556807521)
• نمایه‌های مبنا برای کتابخانه‌های Wear Compose Foundation،‏ Material3، و Navigation3 به‌روزرسانی شد. (I9b0a3)

نسخه ۱.۷

نسخه ۱.۷.۱

۷ اکتبر ۲۰۲۶

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

رفع اشکال‌ها

• رفع اشکال لرزش پویانمایی OneHandedGestureHintScrollIndicator (I650c6)
• برداشتن قفل پیمایش از OneHandedGestureScrollIndicator و مدیریت نمایان بودن نشانگر در ScreenScaffold با ترکیب محلی (I13050)
• رفع IllegalStateException در Modifier.oneHandedGesture (I35151)

نسخه ۱.۷.۰

‫۲۳ سپتامبر ۲۰۲۶

‫androidx.wear.compose:compose-*:1.7.0 منتشر شد. نسخه ۱.۷.۰ شامل این تعهدات است.

تغییرات مهم از نسخه ۱.۶.۰:

• «میانای برنامه‌سازی کاربردی» جدیدی برای اشاره‌های یک‌دستی معرفی کردیم که شامل کنترل‌کننده‌های اشاره برای کنش اصلی (دو انگشتی به‌هم نزدیک کردن) و کنش بستن (چرخاندن مچ دست) و همچنین نشانگرهای پویانمایی برای کلیک کردن/پیمایش کردن/صفحه‌بندی کردن است که نشان می‌دهد اشاره‌ها چه زمانی دردسترس هستند.
• پشتیبانی از PinnableContainer به TransformingLazyColumn اضافه شد، برای نگه داشتن مورد در حافظه به‌جای حذف کردن آن وقتی مورد از نمای درگاه پیمایش می‌شود.
• ‫TransformingLazyColumn اکنون از پویانمایی عناصر هنگام خروج از درگاه دید پشتیبانی می‌کند و به آن‌ها امکان می‌دهد به‌جای محو شدن، به‌آرامی از صفحه‌نمایش خارج شوند.
• ‫firstLayoutItemProvider به‌عنوان سفارشی‌سازی اختیاری برای اولین مورد چیدمان به TransformingLazyColumn اضافه شد. وقتی مشخص شود، ارائه‌دهنده مورد و لبه آن را که به‌عنوان مرجع جای‌گذاری اولیه استفاده می‌شود تعریف می‌کند، که برای کنترل جهت تغییر محتوا هنگام به‌روزرسانی پویا موارد مفید است.
• بهبودهایی در SwipeToReveal برای پشتیبانی از پیمایش تودرتو، پرتاب‌های سریع، لرزش دوم در حالت نمایان شدن جزئی، و actionContentSpacing برای فاصله بین محتوای اصلی و دکمه‌های کنش.
• گزارمان‌های @FrequentlyChangingValue و @RememberInComposition را معرفی کردیم که هشدارهای lint را ارائه می‌دهند تا از مشکلات عملکردی ناشی از خواندن به‌روزرسانی‌های وضعیت با فرکانس بالا یا عدم به‌خاطر سپردن اشیا درطول ترکیب جلوگیری کنند.

رفع اشکال‌ها

• ‫androidx.lifecycle:lifecycle-runtime پیش‌نیاز به نسخه ۲.۱۰.۰ به‌روزرسانی شد. این نسخه برای اجرای بررسی‌های لینت زمان اجرای چرخه حیات دسته‌ای با AGP نسخه ۹.۵.۰-alpha04 یا جدیدتر الزامی است. (If8e16)

نسخه 1.7.0-rc01

۹ سپتامبر ۲۰۲۶

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

• این نسخه پخش، نسخه Compose for Wear OS 1.7.0 را به نسخه نامزد انتشار به‌روز می‌کند، اما درغیراین‌صورت تغییرات قابل‌توجهی نسبت‌به نسخه پخش 1.7.0-beta02 ندارد.

نسخه 1.7.0-beta02

۲۶ اوت ۲۰۲۶

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

رفع اشکال‌ها

• نمایه‌های مبنا برای کتابخانه‌های Wear Compose Foundation،‏ Material3، و Navigation3 به‌روزرسانی شد. (I9b0a3)
• رفع پرش پویانمایی اشاره در OneHandedGestureScrollIndicator. (6e0c1cb)

نسخه 1.7.0-beta01

‫۱۲ اوت ۲۰۲۶

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

انتشار نسخه 1.7.0-beta01 از Compose ویژه Wear OS نشان می‌دهد که این نسخه از کتابخانه دارای ویژگی‌های کامل است و API قفل شده است. ‫Wear Compose نسخه ۱.۷.۰-beta01 شامل عملکرد جدید زیر است:

• پشتیبانی از اشاره یک‌دستی، شامل کنترل‌کننده‌های اشاره برای کنش اصلی (برای نمونه، دو انگشتی جمع کردن) و کنش بستن (برای نمونه، چرخاندن مچ دست) و نشانگرهای پویانمایی‌شده که نشان می‌دهند اشاره‌ها چه زمانی در عناصر واسط کاربر کلیک‌کردنی (مثل دکمه‌ها و کارت‌ها)، فهرست‌های پیمایش‌کردنی، و صفحه‌بندها دردسترس هستند.
• پشتیبانی از PinnableContainer به TransformingLazyColumn اضافه شد، برای نگه داشتن مورد در حافظه به‌جای حذف کردن آن وقتی مورد از نمای درگاه پیمایش می‌شود.
• ‫TransformingLazyColumn اکنون از پویانمایی عناصر هنگام خروج از درگاه دید پشتیبانی می‌کند و به آن‌ها امکان می‌دهد به‌جای محو شدن، به‌آرامی از صفحه‌نمایش خارج شوند.
• ‫firstLayoutItemProvider به‌عنوان سفارشی‌سازی اختیاری برای اولین مورد چیدمان به TransformingLazyColumn اضافه شد. وقتی مشخص شود، ارائه‌دهنده مورد و لبه آن را که به‌عنوان مرجع جای‌گذاری اولیه استفاده می‌شود تعریف می‌کند، که برای کنترل جهت تغییر محتوا هنگام به‌روزرسانی پویا موارد مفید است.
• بهبودهایی در SwipeToReveal برای پشتیبانی از پیمایش تودرتو، پرتاب‌های سریع، لرزش دوم در حالت نمایان شدن جزئی، و actionContentSpacing برای فاصله بین محتوای اصلی و دکمه‌های کنش.
• گزارمان‌های @FrequentlyChangingValue و @RememberInComposition را معرفی کردیم که هشدارهای lint را ارائه می‌دهند تا از مشکلات عملکردی ناشی از خواندن به‌روزرسانی‌های وضعیت با فرکانس بالا یا عدم به‌خاطر سپردن اشیا درطول ترکیب جلوگیری کنند.

تغییرات میانای برنامه‌سازی کاربردی

• نام GestureAction به OneHandedGestureAction، GesturePriority به OneHandedGesturePriority، و GestureIndicatorSize به OneHandedGestureIndicatorSize تغییر کرد (Ifc7f4، b/522761843)

رفع اشکال‌ها

• مشکلی در ScrollInfoProvider برطرف شد که باعث می‌شد TimeText هنگام تغییر یا تغییر اندازه موارد فهرست چشمک بزند یا ناپدید شود. (Ief762، b/537433564)

نسخه 1.7.0-alpha07

۲۹ ژوئیه ۲۰۲۶

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

تغییرات میانای برنامه‌سازی کاربردی

• ‫OneHandedGesture API بازسازی شد و وضعیت نشانگر بولی (که پس‌از نشان دادن نشانگر نیاز به بازنشانی داشت) با تابع تعلیق برای اجرای پویانمایی جایگزین شد. هر نوع نشانگر اکنون کلاس وضعیت نشانگر خاص خودش را دارد که منطق پویانمایی آن نشانگر را دربرمی‌گیرد. نام از key به gestureId در GestureConfiguration تغییر کرد. (I7974f،‏ b/522761843)
• افزودن CompactButton محتوای تک‌جایگاهی با بار اضافی (Idaffc، b/527889640)
• افزودن پشتیبانی PinnableContainer به TransformingLazyColumn (Id3dc9، b/492418172)

رفع اشکال‌ها

• اسناد سطح واحد برای Wear Compose Foundation،‏ Material 3، و Navigation 3 اضافه و به‌روز شد. (I111d7، b/498153783)
• مشکلی در ScreenScaffold برطرف شد که در آن، بازآرایی‌ها می‌توانست باعث شود ScrollInfoProvider به‌یادنیامده وضعیت ردیابی پیمایش را بازنشانی کند. (I8be02, b/524620765)
• خطای نشانی IllegalArgumentException: maxWidth must be >= than minWidth به‌دلیل حاشیه‌های افقی بزرگ (I014e8، b/531192734)
• رفع پویانمایی EdgeButton در پرتاب سریع. (I9657f،‏ b/512700520)

نسخه 1.7.0-alpha06

‫۱۵ ژوئیه ۲۰۲۶

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

تغییرات میانای برنامه‌سازی کاربردی

• ‫ButtonContent،‏ AppCardContent، و TitleCardContent عنصر ترکیبی را برای Material3 به ترتیب به اشیای ButtonDefaults و CardDefaults منتقل کنید. (I8d589، b/527889640)
• برداشتن مقدار پیش‌فرض از پارامتر Modifier.oneHandedGesture gestureLabel (Ica100، b/527068051)
• نام gestureLabel را در Modifier.oneHandedGesture به onGestureLabel تغییر دهید و آن را تهی‌پذیر کنید تا با دیگر پارامترهای contentDescription سازگار باشد (I952a8، b/527068051)
• ‫OneHandedGestureIndicatorState را معرفی کنید تا دیداری‌سازی و پویانمایی بین Modifier.oneHandedGesture() و نشانگرهای اشاره را هماهنگ کند. برای بهبود کنترل چرخه حیات، InteractionSource را با این رویکرد مبتنی بر وضعیت جایگزین کنید. پارامتر wrapAround را به OneHandedGestureDefaults.scrollToNextPage اضافه کنید تا با دیگر عملکردهای پیمایش اشاره پیش‌فرض هماهنگ شود. (I9e1e3، b/522761843)

رفع اشکال‌ها

• اسناد interactionSource را برای Modifier.oneHandedGesture شفاف‌سازی کنید تا مشخص شود کدام تعاملات منتشر می‌شوند (I2dc8d)
• به‌دلیل مشکلاتی که در وابستگی به «کیت توسعه نرم‌افزار Wear» در مصرف‌کنندگانی که از «کیت توسعه نرم‌افزار Wear» یا اشاره‌های یک‌دستی استفاده نمی‌کنند وجود دارد، پشتیبانی از اشاره‌های یک‌دستی در AlertDialog به‌طور موقت برداشته شده است. (Ib19e0, b/503841738)
• ‫TransformingLazyColumn بهبودیافته برای پشتیبانی از پویانمایی‌های جای‌گذاری برای مواردی که از درگاه دید خارج می‌شوند، که به آن‌ها امکان می‌دهد به‌جای محو شدن، از صفحه سر بخورند. همچنین مشکل چسبیدن دیداری را که در آن موارد مقیاس‌بندی‌شده پویا درطول پویانمایی‌های جای‌گذاری فوراً به ارتفاع هدف خود می‌چسبیدند برطرف کردیم (I89d84، b/525071281)
• از ItemInfo مبتنی بر شاخص در firstVisibleItemLayoutItemInfo استفاده کنید. (I256e3،‏ b/527881678)
• عملکرد پویانمایی TimePicker وقتی «کاهش حرکت» فعال است اصلاح شد. (Ic9150, b/467288916)

نسخه 1.7.0-alpha05

۱ ژوئیه ۲۰۲۶

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

تغییرات میانای برنامه‌سازی کاربردی

• میانای TransformingLazyColumnFirstLayoutItemProvider در «پایه» اضافه شد تا سفارشی‌سازی محتوایی که درحین به‌روزرسانی محتوا تغییر جهت می‌دهد فعال شود، همراه با پیاده‌سازی‌های آماده rememberTransformingLazyColumnFirstLayoutItemProvider و rememberTransformingLazyColumnFirstVisibleItemProvider در Material3. (I54814، b/503353428)

• نام پارامتر برگشتی را در TransformingLazyColumnFirstLayoutItemProvider از current به centerItem تغییر داد. ‫TransformingLazyColumnState افزونه firstVisibleItemLayoutItemInfo و layoutItemInfoOf را اضافه کردیم و rememberTransformingLazyColumnFirstLayoutItemProvider را به‌روز کردیم تا از لامبدای تمیز و مبتنی بر پارامتر استفاده کند. (I9a8d9، b/503353428)

• برای محتوای «کارت» و «دکمه» چندجایگاهی Material3، سربار اضافه کنید تا با اشاره‌های یک‌دستی استفاده شود. (I74ccb، b/515718015، b/490343658)

• پشتیبانی از دسترس‌پذیری را به اشاره‌های تک‌دست اضافه کنید. (I0054d، b/519085906)

• تغییر نام OneHandedGestureDefaults.scrollToNextItem() به OneHandedGestureDefaults.scrollDownToNextItem و افزودن پارامتر wrapAround به OneHandedGestureDefaults تابع پیمایش (I940ce،‏ b/509639667)

• اگر توسعه‌دهنده بخواهد کلید را به‌صورت دستی ارائه دهد، Modifier.oneHandedGesture() غیرترکیبی را اضافه کنید. (I191e1، b/504712626)

• نام «میانای برنامه‌سازی کاربردی offsetOf» را در RevealState به positionOf تغییر دهید. (I2675f، b/522387997)

• پارامتر actionContentSpacing به SwipeToReveal اضافه شد و به توسعه‌دهندگان امکان داد فاصله بین جایگاه‌های کنش و محتوا را سفارشی‌سازی کنند. (I2abaf،‏ b/507073912)

رفع اشکال‌ها

• مشکلی در ScreenScaffold برطرف شد که در آن، بازآرایی‌ها می‌توانست باعث شود ScrollInfoProvider به‌یادنیامده وضعیت ردیابی پیمایش را بازنشانی کند. (I98f6d، b/524620765)
• TransformingLazyColumn رنگ نوار پیمایش درطول پویانمایی نشانگر از رنگ پس‌زمینه نشانگر اشاره پیروی می‌کند (I353fb، b/524915104)
• ‫OneHandedGestureIndicator پیش‌فرض gestureIndicatorTint را به LocalContentColor تغییر داد (I1abd3،‏ b/524228063)
• توضیحات محتوای انتخابگرهای روز و سال DatePicker را برای پشتیبانی از بومی‌سازی پارامتری‌سازی کنید. (I5dcd9،‏ b/430563857)
• فرکانس‌های نمایشگر تطبیقی را براساس اینکه نشانگر در داخل یا خارج از عنصر میانای کاربر میزبان آن پرداز می‌شود به GestureIndicators معرفی کنید. (Ic618f، b/515071642)
• رفع مشکل هم‌زمان بودن هنگام راه‌اندازی اشاره‌های یک‌دستی (I7b95f، b/512086558)

نسخه 1.7.0-alpha04

۳ ژوئن ۲۰۲۶

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

تغییرات میانای برنامه‌سازی کاربردی

• ‫RevealState.drag()‎،‏ SwipeToRevealDragScope اضافه شد و flingBehavior سفارشی در SwipeToReveal آشکار شد تا کنترل برنامه‌نویسی‌شده بر اشاره‌های تند کشیدن، جبران‌سازی‌ها، و پویانمایی‌های استقرار را فعال کند. (Ibfe56، [b/484185090]
• OneHandedGestureIndicator گسترش یافت تا از کنش‌های «اصلی» و «بستن» پشتیبانی کند و معماری پیوند آن برای مدیریت خودکار چرخه حیات به InteractionSource منتقل شد. (I7e893, [b/512836472]
• پیمایش مبتنی بر اشاره جدیدی برای عناصر مبتنی بر ScalingLazyColumn و «کادرهای گفتگوی هشدار» اضافه شد. این به‌روزرسانی پیمایش پیش‌فرض ۵۰٪ صفحه را برای پیش‌بینی‌پذیری بهتر معرفی می‌کند و شامل حالت اختیاری چسبیدن به مورد برای پیمایش دقیق است. (Ie9cfb, [b/509639667]
• پرچم isOneHandedGesturesInAlertDialogEnabled در Wear Compose Material3 را با LocalOneHandedGestureEnabled CompositionLocal  جایگزین کنید. از این پرچم می‌توان برای غیرفعال کردن اشاره‌های یک‌دستی در سراسر سلسله‌مراتب عناصر استفاده کرد. (Ib9240،‏ [b/516777416]
• ‫ButtonDefaults منسوخ شده است.‫ExtraSmallIconSize و ButtonDefaults.SmallIconSize. این پیش‌فرض‌ها مختص CompactButton بود و به CompactButtonDefaults منتقل شده است.‫ExtraSmallIconSize و CompactButtonDefaults.به‌ترتیب SmallIconSize. (Id747c, [b/513588028]

رفع اشکال‌ها

• رفع پویانمایی EdgeButton در پرتاب سریع. (I88215, [b/512700520]
• رفع مشکل AppScaffold TimeText که در ترکیب مجدد به‌روز نمی‌شد. (Iecea5, [b/512439755]
• ‫ScreenScaffold باید به‌طور صریح از PaddingValues ارائه‌شده توسط لامبدای محتوای داخلی استفاده کند. (I20d71, [b/512355364]
• گزارمان‌های ‎ @FrequentlyChangingValue و ‎ @RememberInComposition را معرفی کردیم تا هشدارهای lint ارائه دهیم و از مشکلات عملکردی ناشی از خواندن به‌روزرسانی‌های وضعیت با بسامد بالا یا به‌خاطر نیاوردن اشیا درطول ترکیب جلوگیری کنیم. ‫(I955f4،‏ [b/409488336]
• وقتی اشاره یک‌دستی برای عناصر ترکیبی Button راه‌اندازی می‌شود، مطمئن شوید که اثر موجی از مرکز دکمه شروع شود. (Ie61ec, [b/514600304]
• با گنجاندن کنش اشاره و اولویت در کلید تولیدشده خودکار، مشکل تداخل کلید در Modifier.oneHandedGesture حل شد. (I49760, [b/517045657]

نسخه 1.7.0-alpha03

‫۱۹ مه ۲۰۲۶

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

تغییرات میانای برنامه‌سازی کاربردی

• اگر توسعه‌دهنده بخواهد کلید را به‌صورت دستی ارائه دهد، Modifier.oneHandedGesture() غیرترکیبی را اضافه کنید. (I191e1، b/504712626)
• نشانگرهای اشاره از OneHandedGestureDefaults برداشته می‌شود و پشتیبانی از رنگ به اشاره‌های یک‌دستی اضافه می‌شود (I7934f، b/505009712، b/504712626)
• مدیریت صریح برای اشاره‌های بستن با یک دست در AlertDialog اضافه شد. (Id71e8, b/509675781)
• ‫DeferredTargetAnimation دیگر آزمایشی نیست، لطفاً موافقت را بردارید. (I1e4ae،‏ b/500030165)

رفع اشکال‌ها

• رفع مشکل هم‌زمان بودن هنگام راه‌اندازی اشاره‌های یک‌دستی (I7b95f، b/512086558)
• نشانگرهای اشاره یک‌دستی براساس جهت مچ دست به‌جای LayoutDirection قرینه می‌شوند. (I6db5d،‏ b/512003346)
• رفع اشکال در کشیدن حاشیه در عناصر TLC (I0c3c1، b/510772213)
• پیش‌نمایش‌های تصویر به‌خط برای نمونه‌های Kdoc در SurfaceTransformation.kt،‏ SwitchButton.kt، و TextButton.kt اضافه شد. این تصاویر اکنون در مستندات صفحات Wear Compose Material 3 DAC ارائه می‌شوند و به توسعه‌دهندگان زمینه دیداری فوری برای هر نوع دکمه و مثال ارائه می‌دهند. (Ib53ae، b/484905061)
• پیش‌نمایش‌های تصویر به‌خط برای همه نمونه‌ها در Kdoc مربوط به Button.kt اضافه شد. این تصاویر اکنون مستقیماً در اسناد در صفحات Wear Compose Material 3 DAC ارائه می‌شوند و به توسعه‌دهندگان زمینه دیداری فوری برای هر نوع دکمه و مثال ارائه می‌دهند. (Ie2fb5، b/484905061)
• پیش‌نمایش‌های تصویر درون‌خطی برای نمونه‌ها در KDoc در Card.kt،‏ IconButton.kt،‏ LevelIndicator.kt، و ListHeader.kt اضافه شد. این تصاویر اکنون در مستندات صفحه‌های Wear Compose Material 3 DAC ارائه می‌شوند. (I371bc،‏ b/484905061)
• پیش‌نمایش‌های تصویر درون‌خطی برای نمونه‌ها در KDoc برای Picker،‏ SegmentedCircularProgressIndicator،‏ Slider، و Stepper اضافه شد. این تصاویر اکنون در مستندات صفحه‌های Wear Compose Material 3 DAC پردازش می‌شوند و به توسعه‌دهندگان زمینه دیداری فوری برای این عناصر و نمونه‌ها ارائه می‌دهند. (I6c6ef،‏ b/484905061)
• پیش‌نمایش‌های تصویر درون‌خطی برای نمونه‌ها در KDoc برای CheckboxButton،‏ SplitCheckboxButton،‏ CircularProgressIndicator،‏ ConfirmationDialog،‏ SuccessConfirmationDialog،‏ FailureConfirmationDialog، و curvedText اضافه شد. این تصاویر اکنون در مستندات صفحه‌های Wear Compose Material 3 DAC پردازش می‌شوند و به توسعه‌دهندگان زمینه دیداری فوری برای این عناصر و نمونه‌ها ارائه می‌دهند. (Ie4662، b/484905061)
• ‫Fix AlertDialogScreenshotTest test (I9be58, b/508678506)
• پیش‌نمایش‌های تصویر درون‌خطی برای نمونه‌ها در KDoc برای NonClickableCard،‏ OpenOnPhoneDialog،‏ VerticalPageIndicator،‏ VerticalPagerScaffold، و RadioButton اضافه شد. این تصاویر اکنون در مستندات صفحه‌های Wear Compose Material 3 DAC پردازش می‌شوند و به توسعه‌دهندگان زمینه دیداری فوری برای این عناصر و نمونه‌ها ارائه می‌دهند. (I2aa2d, b/484905061)

نسخه 1.7.0-alpha02

۶ مه ۲۰۲۶

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

رفع اشکال‌ها

• اندازه GestureIndicator ثابت در AlertDialogs (I0c16e،‏ b/504912009)
• ‫LeftRevealed/RightRevealed لنگر SwipeToReveal برای آشکار کردن موقعیت خارج از محدوده تنظیم شد. (Id84ff، b/498681589)
• شرح وضعیت را به Checkbox و Switch (Iba12e،‏ b/485098874) اضافه کنید
• اشکال دیداری در FadingExpandingLabel برطرف شد که در آن وقتی تعداد خطوط کاهش می‌یافت، نوشتار قدیمی چشمک می‌زد. (Ia40c9، b/503709020)
• افزودن پشتیبانی پیش‌فرض از اشاره یک‌دستی به Material3 AlertDialog (I5848e، b/479098589)
• منطق نمایان بودن داخلی در حالت یک‌دستی برداشته شده است (I8c602، b/502903320)

نسخه 1.7.0-alpha01

۸ آوریل ۲۰۲۶

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

تغییرات میانای برنامه‌سازی کاربردی

• ‫API جدیدی برای اشاره‌های یک‌دستی معرفی شد که در آن می‌توان برگشت به تماس‌های اولویت‌دار را برای کنش‌های اصلی و بستن ثبت کرد. سیستم به‌طور خودکار مرتبط‌ترین هدف روی صفحه را شناسایی می‌کند تا اطمینان حاصل شود که اشاره‌ها و نشانگرهای آن‌ها فقط برای عناصری فعال می‌شوند که کاربر درحال‌حاضر می‌تواند ببیند و با آن‌ها تعامل داشته باشد. Modifier.oneHandedGesture را به عنصر ترکیبی مرتبط با اشاره (برای نمونه، «دکمه») اضافه کنید و از OneHandedGestureDefaults.GestureIndicator برای نشان دادن دردسترس بودن کنش اشاره به کاربر استفاده کنید. پیمایش و صفحه‌بندی را می‌توان با اشاره اصلی نیز راه‌اندازی کرد، و توصیه می‌شود از OneHandedGestureDefaults.scrollDown و OneHandedGestureDefaults.scrollToNextPage در برگشت تماس‌ها استفاده شود. OneHandedGestureDefaults.ScrollGestureIndicator و OneHandedGestureDefaults.VerticalPageGestureIndicator به‌عنوان جایگزین برای ScrollIndicator و PageIndicator ارائه شده‌اند تا به‌طور موقت نشانگر اشاره را به کاربر نمایش دهند. (Ic6324، b/479098447، b/485488443)
• ‫requestAnchorItem به TransformingLazyColumnState اضافه شد و TransformingLazyColumnAnchorType معرفی شد تا توسعه‌دهندگان کنترل دقیقی بر جهت ازهم بازکردن مورد و لنگر چیدمان داشته باشند. (I0c1e6, b/494301025)
• پرچم isSwipeToRevealDualFlingThresholdEnabled اضافه شد که به‌طور پیش‌فرض روشن است، اما اگر رفع اشکال‌های مربوط به عملکرد تند کشیدن در SwipeToReveal در این نسخه باعث پسرفت شود، می‌توان آن را غیرفعال کرد (در این صورت، لطفاً در اسرع وقت اشکالی ثبت کنید) (Ie6db6، b/497743775)

رفع اشکال‌ها

• ‫SwipeToReveal بهبود یافته است تا از پرتاب‌های سریع پشتیبانی کند و به کاربران امکان دهد کنش‌ها را بدون توجه به فاصله تند کشیدن به‌طور کامل آشکار کنند (با خاموش کردن پرچم isSwipeToRevealDualFlingThresholdEnabled، می‌توان این تغییر را غیرفعال کرد). (I833fd، b/490728860)
• ‫SwipeToReveal اصلاح شد تا با تند کشیدن بیش‌از ۷۵٪ عرض صفحه‌نمایش، تند کشیدن کامل را راه‌اندازی کند (با خاموش کردن پرچم isSwipeToRevealDualFlingThresholdEnabled، این تغییر می‌تواند غیرفعال شود). (Id5604، b/490728860)
• بازخورد لمسی دومی برای SwipeToReveal اضافه شد که وقتی تند کشیدن به وضعیت نمایان شدن جزئی می‌رسد فعال می‌شود (با خاموش کردن پرچم isSwipeToRevealDualFlingThresholdEnabled می‌توانید این تغییر را غیرفعال کنید). (Ic27e3، b/492273799)
• مشکلی در TransformingLazyColumn برطرف شد که باعث می‌شد پویانمایی‌های عنصر (Modifier.animateItem) ازکار بیفتد. (I904ec،‏ b/493167084)
• اشکالی در PickerGroup (و درنتیجه DatePicker) برطرف شد تا از ایجاد پیمایش موردنظر در ستون‌های «انتخابگر» انتخاب‌نشده دراثر چند لمس جلوگیری شود (Id76c5، b/378646798)

Wear Compose Version 1.6

نسخه ۱.۶.۲

‫۱۹ مه ۲۰۲۶

‫androidx.wear.compose:compose-*:1.6.2 منتشر شد. نسخه ۱.۶.۲ شامل این تعهدها است.

رفع اشکال‌ها

• رفع مشکل رسم حاشیه در TransformingLazyColumn مورد (I0c3c1، b/510772213)

• تکلیف itemSpacing را در استراتژی اندازه‌گیری فضای خالی محتوا TransformingLazyColumn اصلاح کنید (I12d2f، b/498137919)

نسخه ۱.۶.۱

۸ آوریل ۲۰۲۶

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

رفع اشکال‌ها

• مشکلی که باعث می‌شد پویانمایی‌های عنصر (ازطریق Modifier.animateItem) در TransformingLazyColumn ازکار بیفتد برطرف شد. (I904ec،‏ b/493167084)

نسخه ۱.۶.۰

۲۵ مارس ۲۰۲۶

‫androidx.wear.compose:compose-*:1.6.0 منتشر شد. نسخه ۱.۶.۰ شامل این تعهدها است.

تغییرات مهم از نسخه ۱.۵.۰:

• کتابخانه Wear Compose Navigation3 معرفی شد که با NavDisplay و SceneStrategy عناصر کتابخانه Navigation 3 ادغام می‌شود و بااستفاده از SwipeDismissableSceneStrategy جدید ما، منطق بستن با کشیدن مختص Wear را اضافه می‌کند.
• پشتیبانی از TransformingLazyColumn برای reverseLayout، چسباندن بااستفاده از TransformingLazyColumnDefaults.snapFlingBehavior و Modifier.minimumVerticalContentPadding، اضافه شد که امکان تعریف حاشیه محتوای ترجیحی برای موارد موجود در فهرست را درصورت قرارگیری در لبه‌های بالا یا پایین فراهم می‌کند.
• سرریزهای جدیدی برای AlertDialog اضافه شد که از TransformingLazyColumn برای هماهنگی با پیمایش در دیگر صفحه‌های Material3 استفاده می‌کند.
• با معرفی پیچاندن نوشتار ازطریق پارامتر جدید CurvedTextStyle warpOffset، که به‌طور پیش‌فرض برای API 34 و نسخه‌های بالاتر روشن است، پرداز زدن نوشتار منحنی به‌ویژه برای قلم‌های شکسته بهبود یافته است.
• LocalAmbientModeManager، CompositionLocal جدیدی که از تعریف واسط کاربر و عملکرد متفاوت برای حالت‌های تعاملی و محیطی پشتیبانی می‌کند اضافه شد.
• برای فهرست کامل‌تری از ویژگی‌های معرفی‌شده در نسخه ۱.۶.۰، یادداشت‌های انتشار beta01 را ببینید

نسخه 1.6.0-rc01

۱۱ مارس ۲۰۲۶

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

• این نسخه پخش نسخه Compose for Wear OS 1.6.0 را به نسخه نامزد ارتقا می‌دهد، اما درغیراین‌صورت تغییرات قابل‌توجهی نسبت‌به نسخه پخش 1.6.0-beta01 ندارد.

نسخه 1.6.0-beta01

۲۵ فوریه ۲۰۲۶

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

انتشار نسخه 1.6.0-beta01 از Compose برای Wear OS نشان می‌دهد که این نسخه از کتابخانه ازنظر ویژگی کامل است و «میانای برنامه‌سازی کاربردی» قفل است (به‌جز مواردی که به‌عنوان آزمایشی علامت‌گذاری شده‌اند). ‫Wear Compose نسخه 1.6.0-beta01 شامل عملکرد جدید زیر است:

• کتابخانه Wear Compose Navigation3 که با NavDisplay و SceneStrategy کتابخانه Navigation 3 ادغام می‌شود و بااستفاده از SwipeDismissableSceneStrategy جدید ما، منطق بستن با کشیدن مختص Wear را اضافه می‌کند.
• پشتیبانی از TransformingLazyColumn برای reverseLayout، چسباندن بااستفاده از TransformingLazyColumnDefaults.snapFlingBehavior و Modifier.minimumVerticalContentPadding، اضافه شد که امکان تعریف حاشیه محتوای ترجیحی برای موارد موجود در فهرست را درصورت قرارگیری در لبه‌های بالا یا پایین فراهم می‌کند.
• سرریزهای جدیدی برای AlertDialog اضافه شد که از TransformingLazyColumn برای هماهنگی با پیمایش در دیگر صفحه‌های Material3 استفاده می‌کند.
• با معرفی پیچاندن نوشتار ازطریق پارامتر جدید CurvedTextStyle warpOffset، که به‌طور پیش‌فرض برای API 34 و نسخه‌های بالاتر روشن است، پرداز زدن نوشتار منحنی به‌ویژه برای قلم‌های شکسته بهبود یافته است.
• LocalAmbientModeManager، CompositionLocal جدیدی که از تعریف واسط کاربر و عملکرد متفاوت برای حالت‌های تعاملی و محیطی پشتیبانی می‌کند اضافه شد.
• ‫TimePicker به‌روز شد تا از نوع جدید MinutesSeconds پشتیبانی کند و پارامتر جدید initialSelection را برای مشخص کردن عنصر زمان انتخاب‌شده اولیه اضافه کند.
• سربارهای جدید در «کارت‌ها» برای ارائه انواع غیرقابل‌کلیک در مواردی که کارت‌ها فقط نمایشی هستند و برای پاسخ دادن به کلیک‌های کاربر درنظر گرفته نشده‌اند.
• ‫LocalRippleConfiguration اضافه شد تا کنترل ظاهر موجک فراهم شود.
• پارامتر snapSensitivity برای RotaryScrollableDefaults.snapBehavior معرفی شد و PagerScaffoldDefaults اکنون شامل مقادیر پیش‌فرض توصیه‌شده برای SnapPositionalThreshold و HighSnapPositionalThreshold برای استفاده با PagerDefaults.snapFlingBehavior است.

تغییرات میانای برنامه‌سازی کاربردی

• مقادیر پیش‌فرض توصیه‌شده برای Modifier.minimumVerticalContentPadding از minimumListVerticalContentPadding به minimumVerticalListContentPadding تغییر نام داد تا تأکید شود که این حاشیه محتوا به فهرست اشاره دارد و اسناد مرتبط به‌روزرسانی شد. (I496ca،‏ b/426154225)
• اکنون نوشتار منحنی به‌طور پیش‌فرض تاب می‌دهد و پرداز زدن نوشتار منحنی را به‌ویژه برای قلم‌های شکسته بهبود می‌بخشد. (I6979d،‏ b/450526792،‏ b/481617443)

رفع اشکال‌ها

• تعامل بین «کنترل‌کننده‌های سطح بالا» animateItem و minimumVerticalContentPadding را اصلاح کنید. (Ia865c،‏ b/483663045)
• به‌دلیل وابستگی به PathIterator از کتابخانه androidx.graphics.path که برای آزمایش توسعه‌دهنده در Robolectric قبل‌از API 34 دردسترس نیست (و درنتیجه آزمایش‌های توسعه‌دهنده موجود را خراب می‌کند)، انحراف پیچیده برای نوشتار منحنی اکنون فقط به‌طور پیش‌فرض برای API 34 و نسخه‌های بالاتر روشن است. (Ie5bae، b/484319336)
• نوشتار منحنی تاب‌خورده را مستحکم‌تر می‌کند. (If2b34، b/483390353)
• ‫ConfirmationDialogDefaults.SuccessIcon به‌روز شد تا جهت چیدمان راست‌به‌چپ را نادیده بگیرد تا علامت تأیید معکوس نشود. (Ic6add، b/481966029)

نسخه 1.6.0-alpha10

‫۱۱ فوریه ۲۰۲۶

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

تغییرات میانای برنامه‌سازی کاربردی

• نام Modifier.responsiveVerticalPadding به Modifier.minimumVerticalContentPadding تغییر کرد، با پارامترهای حاشیه‌گذاری به‌عنوان Dp، به‌جای رابط ResponsiveVerticalPadding. پیش‌فرض‌های توصیه‌شده از ResponsiveVerticalPaddingDefaults به اشیای پیش‌فرض ویژه عنصر مثل ButtonDefaults، CardDefaults، و غیره منتقل شد (Icaab2، b/426154225)
• ‫WearComposeFoundationFlags.isTransformingLazyColumnClickableThresholdEnabled اضافه شد تا عملکرد جدید معرفی‌شده برای TransformingLazyColumn را کنترل کند. این عملکرد جدید اکنون کلیک‌های فراتر از آستانه ۲۰dp در بالا و پایین چیدمان را نادیده می‌گیرد تا از تک‌ضرب‌های تصادفی در جایی که مورد فقط به‌صورت جزئی قابل‌مشاهده است جلوگیری کند. همچنین، تغییر را به‌روز کردیم تا فقط کلیک‌های لبه-مورد را در رویدادهایی که در محدوده لمس هستند رهگیری کند تا از نادیده گرفتن اشاره‌های کشیدن جلوگیری شود. (I1ba28, b/480910891)
• ‫rememberAmbientModeManager اکنون در پیاده‌سازی خود از LocalActivity برای دریافت «فعالیت» کنونی استفاده می‌کند، به‌جای اینکه «فعالیت» را به‌عنوان پارامتر دریافت کند (Idf114، b/473603258)
• ‫AmbientMode برای توسعه‌پذیری به غیرجامع تغییر کرد (I92cc3، b/473603258)
• ‫rememberSwipeDismissableSceneStrategyState به‌روزرسانی شد تا پارامتر swipeToDismissBoxState را بردارد، زیرا این پارامتر فقط تا میانای برنامه کاربردی ۳۵ جزئیات پیاده‌سازی است (I5907c، b/476105162)
• [TLC] Modifier.responsiveVerticalPadding به TransformingLazyColumn اضافه شد و امکان تنظیم خودکار حاشیه محتوا برای هم‌تراز شدن با دستورالعمل‌های طراحی «Wear OS Material 3» فعال شد. (Ia7e73، b/426154225)

رفع اشکال‌ها

• شرط پیش‌دریافت TransformingLazyColumn به‌روزرسانی شد تا فوریت براساس لبه‌های درگاه دید بدون حاشیه محاسبه شود (I48d85، b/476420552)
• ‫Picker اکنون با گذراندن Color.Unspecified به‌عنوان gradientColor «انتخابگر»، از شفافیت یکپارچه در پس‌زمینه‌های سفارشی مثل گرادیان‌ها یا تصاویر پشتیبانی می‌کند. برای TimePicker و DatePicker، این تأثیر را می‌توان با ملغی کردن محلی MaterialTheme.colorScheme.background به Color.Unspecified به‌دست آورد. (Icc476، b/458429791، b/458429791)
• آستانه کلیک‌پذیری ۲۰ پیکسل برای TransformingLazyColumn مورد در بالا و پایین صفحه معرفی شد تا از ضربه‌های تصادفی زمانی که موارد تا حد زیادی پنهان هستند جلوگیری شود. (I2c9cb, b/443285887)
• بهبود مدیریت «کاهش حرکت» در OpenOnPhoneDialog. (Ib1d12, b/48558283)

نسخه 1.6.0-alpha09

‫۲۸ ژانویه ۲۰۲۶

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

تغییرات میانای برنامه‌سازی کاربردی

• تغییر نام PagerScaffoldDefaults.SnapPositionalThreshold به LowSnapPositionalThreshold و RotaryScrollableDefaults.SnapSensitivity به LowSnapSensitivity (I157ee، b/449949891)
• توصیف‌گر از SwipeDismissableSceneStrategy برداشته شد. (‫۳۰ فرانک، b/449949891)

رفع اشکال‌ها

• رفع تأخیر پویانمایی پیمایش بیش‌ازحد چرخشی در رفتار چسبنده (I7db89، b/474016470)
• رفع اشکال SwipeDismissableSceneStrategy که مانع از بازگشت سیستم در API 36+ می‌شود (Icf20b، b/476105162)
• پویانمایی SwitchButton را اصلاح کنید تا به‌عنوان شکلی کامل مقیاس‌بندی/محو شود (I7a7eb، b/378644361)
• بهبود پویانمایی چرخش معرفی نماد بررسی CheckboxButton (I89944، b/378646769)

نسخه 1.6.0-alpha08

‫۱۴ ژانویه ۲۰۲۶

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

تغییرات میانای برنامه‌سازی کاربردی

• ‫RotaryScrollableDefaults.snapBehavior به‌روز شده است تا پارامتر شناور snapSensitivity را بگیرد، و PagerScaffoldDefaults اکنون مقادیر پیش‌فرض توصیه‌شده SnapPositionalThreshold و HighSnapPositionalThreshold را برای استفاده با PagerDefaults.snapFlingBehavior عمومی می‌کند. (I7e11c، b/449949891)
• پشتیبانی چسباندن به TransformingLazyColumn برای ورودی لمسی و چرخشی اضافه شد. هنگام پیکربندی چسباندن، توصیه می‌شود هم flingBehavior بااستفاده از TransformingLazyColumnDefaults.snapFlingBehavior و هم rotaryScrollableBehavior بااستفاده از RotaryScrollableDefaults.snapBehavior را برای داشتن تجربه‌ای یکپارچه ارائه دهید. (I5326f، b/422455104)
• ‫LocalAmbientModeManager، عنصر ترکیبی جدیدی برای تعریف آسان واسط کاربر و رفتار متفاوت برای حالت‌های تعاملی و محیطی معرفی شد. (I00161، b/427724331)

رفع اشکال‌ها

• رفع مشکلی که باعث می‌شد فهرست‌هایی با رفتار چرخشی چسبنده پس‌از پیمایش بیش‌ازحد به حالت اولیه برنگردند. (I05216، b/470317969)
• مشکل جلوه موجی برای دکمه‌های افزایش و کاهش در «لغزنده Material3» برطرف شد. اکنون موج به‌درستی در کل عرض مؤلفه لغزنده گسترش می‌یابد. (I8c0c4، b/378658409)

نسخه 1.6.0-alpha07

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

‫androidx.wear.compose:compose-*:1.6.0-alpha07 منتشر شد. نسخه 1.6.0-alpha07 شامل این تغییرات است.

تغییرات میانای برنامه‌سازی کاربردی

• ‫wear-compose:compose-navigation3 عنصر کتابخانه (I01b5c،‏ b/427463127) اضافه شد
• SwipeDismissableSceneStrategy برای یکپارچگی Wear با Navigation3 اضافه شد. می‌توان از آن با NavDisplay برای نمایش محتوای «نگارش برای Wear» استفاده کرد. (I7aa08، b/427463127)
• ‫ResponsiveTransformingLazyColumn را معرفی می‌کنیم، عنصر جدید Material3 که براساس TransformingLazyColumn از پایه wear compose ساخته شده است و به‌طور خودکار حاشیه‌های عمودی واکنش‌گرا را براساس نوع محتوای فهرست محاسبه و اعمال می‌کند. (I102f4, b/426154225)

رفع اشکال‌ها

• رفع مشکلی که در آن PageIndicator وقتی شاخص صفحه فعلی در PagerState تغییر می‌کرد (برای نمونه، با فراخوانی scrollToPage() یا استفاده از animateScrollToPage() با حرکت کاهش‌یافته) به‌درستی بازطراحی نمی‌شد. (I97150، b/465669950)
• رفع اشکال معناشناسی TransformingLazyColumn scrollOffset محاسبه (Idec30، b/417941554)
• فاصله داخلی کنش واگرداندن SwipeToReveal تصحیح شد (I770f8، b/382259843)
• ‫PredictiveBackScene برای مدیریت Navigation3 برای API36+ پیاده‌سازی شد. (Idedf6، b/427463127)

نسخه 1.6.0-alpha06

۳ دسامبر ۲۰۲۵

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

تغییرات میانای برنامه‌سازی کاربردی

• ‫LocalRippleConfiguration اضافه شد تا کنترل ظاهر موجک فراهم شود (I9e0fa، b/382336566)
• سربارهای جدیدی برای AlertDialog اضافه شد که از TransformingLazyColumn برای ارائه کنترل پیشرفته بر پویانمایی‌های پیمایش مورد استفاده می‌کند. بهبودهایی در چیدمان برای صفحه‌نمایش‌های بزرگ‌تر اضافه شد. (I862ff، b/438468382)
• پارامتر تبدیل به ButtonGroup اضافه شد تا با محتوی‌های تغییر پویا مثل TransformingLazyColumn استفاده شود. (I8743b،‏ b/453710565)

رفع اشکال‌ها

• رفع مشکل مربوط به عنوان AlertDialog و ظاهر شدن چندباره دکمه‌های تأیید/رد در ترکیب (I8e1b0، b/463955367)
• هنگام گوش دادن به TimeZone «تغییرات»، کد TimeText را قوی‌تر کنید. (I1c276،‏ b/457909952)
• عملکرد SplitRadioButton و SplitCheckboxButton با کاهش تعداد بازترکیب بهبود یافت. (I3ddc9, b/455845192)

نسخه 1.6.0-alpha05

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

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

تغییرات میانای برنامه‌سازی کاربردی

• ‫RotarySnapSensitivity را برای عملکرد چرخشی و PagerSensitivity را برای عملکرد پرتاب صفحه معرفی کنید تا برنامه‌ها بتوانند سطح حساسیت عملکرد چرخشی و پرتاب را به‌ویژه برای صفحه‌گردها تنظیم کنند. (Ic3a83، b/449949891)
• تغییرات ساده‌شده در rememberTransformingLazyColumnState که با معرفی چیدمان معکوس برای TransformingLazyColumn ایجاد شده است، در یک تابع واحد ادغام می‌شود و از مقدار نگهبان برای استفاده از شاخص لنگر پیش‌فرض استفاده می‌کند. (I09302, b/453731755)
• GenericFailureIcon پیش‌فرض جدیدی اضافه شد تا در FailureConfirmationDialog استفاده شود که نماد خطای عمومی را نشان می‌دهد. نام FailureIcon موجود به ConnectionFailureIcon تغییر کرد. (I8e965, b/453730430)

رفع اشکال‌ها

• هنگام تجزیه الگوهای پیچیده محلی، TimePicker مقاوم‌تر شد. (I7b169، b/456538838)
• چیدمان اولیه TransformingLazyColumn وقتی verticalArrangement Arrangement.Center است اصلاح شد. (Id18ef, b/451481233)
• سازنده TransformingLazyColumnState با تابع rememberTransformingLazyColumnState تراز شد (I36d6a، b/453731755)
• نماد تیک برای CheckboxButton به‌روزرسانی شد تا گرد شود. (Ie645e، b/378645751)
• نماد تیک برای SwitchButton به‌روزرسانی شد تا گرد شود. (I31fbf، b/378642590)
• انحراف scrollToItem در TransformingLazyColumn که جهت پیمایش را معکوس می‌کرد اصلاح شد. (Ib2c93، b/451481233)
• عملکرد SwitchButton و SplitSwitchButton بهبود یافته است. (I708de، b/448781327)

نسخه 1.6.0-alpha04

‫۲۲ اکتبر ۲۰۲۵

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

تغییرات میانای برنامه‌سازی کاربردی

• پیاده‌سازی reverseLayout برای TransformingLazyColumn (I19f9e،‏ b/352513793)
• ‫ConfirmationDialogDefaults.VariantFailureIcon برای استفاده در FailureConfirmationDialog اضافه شد. در برخی موارد، ممکن است این نماد خطای عمومی جدید در مقایسه با ConfirmationDialogDefaults.FailureIcon که اتصال قطع‌شده به تلفن را نشان می‌دهد ترجیح داده شود. (Ifc851،‏ b/443115305)

رفع اشکال‌ها

• با بازسازی استفاده از LaunchedEffect، عملکرد «انتخابگر» بهبود یافت. (I94519،‏ b/418192973)
• اشکالی در SwipeDismissableNavHost در API36+ برطرف شد که در آن، فشار دادن دکمه برگشت درطول پویانمایی اشاره برگشت پیش‌گویانه باعث قطع شدن و شروع مجدد پویانمایی می‌شد. اکنون پیاده‌سازی به‌جای Animatable از SeakableTransitionState.animateTo استفاده می‌کند که کمی عملکرد را بهبود می‌دهد. (I2241f, b/428156670)
• اشکالی در ترتیب اعلام دسترس‌پذیری در AlertDialog برطرف شد که در آن دکمه تأیید به‌عنوان «دکمه» اعلام می‌شد. به‌جای «تأیید» استاندارد، «تأیید کردن» را انتخاب کنید. دکمه. (Ic2381، b/429378202)
• رؤیت‌پذیری شماره TimePicker را در صفحه‌نمایش‌های کوچک بهبود دهید. (I68386، b/447625365)
• انشعاب «چیدمان تنبل» از «پایه Wear Compose» برداشته شد - این یعنی TransformingLazyColumn اکنون از پیاده‌سازی «چیدمان تنبل» در «پایه Compose» استفاده می‌کند، ازجمله پیش‌واکشی، و در اکثر موارد از بهبود عملکرد در زمان‌بندی قاب‌ها بهره‌مند می‌شود. (Idd743، b/445911630)

نسخه 1.6.0-alpha03

‫۸ اکتبر ۲۰۲۵

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

تغییرات میانای برنامه‌سازی کاربردی

• پارامتر به TimePicker اضافه شد تا عنصر زمان در ابتدا کانونی مشخص شود. انتخاب به‌طور پیش‌فرض روی اولین عنصر دردسترس براساس منطقه و TimePickerType تنظیم می‌شود. (Ie5dfe، b/437015874)
• پارامتر targetProgress استفاده‌نشده در روش CircularProgressIndicator drawCircularProgressIndicator برداشته شد. (Ieeb3c،‏ b/430544552)

رفع اشکال‌ها

• پشتیبانی از TransformingLazyColumn verticalAlignment را که وجود ندارد پیاده‌سازی کنید - اکنون از چیدمان‌های استاندارد که در بالا، پایین، یا مرکز قرار می‌گیرند پشتیبانی می‌کند. (I2e630، b/444143326)
• محاسبه پهنای نوشتار منحنی بهبود یافت تا فاصله‌های قبل و بعداز نوشتار را درنظر بگیرد (ممکن است باعث خراب شدن نماگرفت‌هایی شود که نوشتار منحنی دارند، به‌ویژه وقتی که پس‌زمینه‌ای مثل TimeText داشته باشد). (I924a4، b/446601899)
• ‫Compose Foundation‏ WarpedCurvedTextRenderer را به‌روزرسانی کرد تا از androidx.emoji2 برای رفع خطای کلاس زمان اجرا، EmojiCompatInitializer را انتخاب کند. (I589b4،‏ b/444422736)
• ‫ScalingLazyColumn به‌روزرسانی شد تا روی گره پیمایش‌پذیر با CollectionInfo تمرکز کند، تا در زمینه‌های بیشتری با گردان کار کند، مثلاً در Material3 AlertDialog. (I6be3c، b/445332360)

نسخه 1.6.0-alpha02

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

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

تغییرات میانای برنامه‌سازی کاربردی

• پرداز زدن بهبودیافته نوشتار منحنی، به‌ویژه برای قلم‌های شکسته، با معرفی پیچاندن نوشتار بااستفاده از پارامتر جدید CurvedTextStyle warpOffset. (If5dcb)

رفع اشکال‌ها

• ذخیره کردن پویانمایی مورد بهینه‌سازی‌شده در حافظه نهان درحین پیمایش در TransformingLazyColumn. (I62ae8)
• تغییرات OpenOnPhoneDialog و ConfirmationDialog به‌روزرسانی شده است تا FLAG_KEEP_SCREEN_ON را تنظیم کند، به‌طوری‌که پویانمایی‌ها تا انتها اجرا شوند و کادرهای گفتگو طبق انتظار خودبه‌خود بسته شوند. (Iad7d4)
• اشکالی که باعث ازکارافتادن Modifier.edgeSwipeToDismiss هنگام استفاده با SwipeDismissableNavHost در API 36 و نسخه‌های بالاتر می‌شد برطرف شد. (Ifc13d)
• اسناد و نظرات به‌روزشده مرتبط با پارامتر جدید CurvedTextStyle warpOffset برای ارجاع صحیح به مورد «نامشخص». (I41aa5)

نسخه 1.6.0-alpha01

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

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

تغییرات میانای برنامه‌سازی کاربردی

• انواع غیرکلیک‌کردنی برای Card،‏ TitleCard،‏ OutlinedCard، و AppCard اضافه شد (I509bb،‏ b/406690146)
• پارامتر interactionSource را از «میاناهای برنامه‌سازی کاربردی کارت غیرکلیک‌کردنی» جدید برداشت. (If0c7a، b/440323280)
• نوع جدید MinutesSeconds به عنصر TimePicker اضافه شد که فقط ستون‌های دقیقه و ثانیه را نمایش می‌دهد و ستون ساعت را حذف می‌کند (Ia9e94، b/438004664)

رفع اشکال‌ها

• استفاده HorizontalPagerScaffold از پارامتر اصلاح‌گر خود را اصلاح کنید تا اگر Modifier.fillMaxSize() اضافه شود، HorizontalPager نشانگر صفحه را ازدست ندهد (I07ae1، b/441682601)
• جهت ScrollIndicator به‌طور پیش‌فرض با جهت چیدمان محتوا تراز می‌شود. (I0da0f, b/441489028)
• مشکل ScrollAway هنگام استفاده با TransformingLazyColumn برطرف شد. پس‌از پیمایش به صفحه‌نمایش دیگر و برگشتن، TimeText به‌درستی پیمایش نمی‌شد. (Ic0ef1، b/433549148)
• گزارش TransformingLazyColumn SCROLL_BACKWARDS و معناشناسی SCROLL_FORWARDS برای موارد حاشیه‌ای در بالا/پایین صفحه‌نمایش اصلاح شد. (I5c28d،‏ b/405205994)
• رفع اشکالی در SwipeDismissableNavHost که باعث می‌شد گذارهای درحال انجام پس‌از کشیدن به عقب در API 36 به‌عنوان تکمیل‌شده علامت‌گذاری نشوند. (Ife72e، b/441089689)
• OpenOnPhoneMaxSweepAngle پیش‌فرض را به ۲۰۰ درجه به‌روز کنید تا از کوتاه شدن برخی‌از ترجمه‌های «تلفنتان را بررسی کنید» جلوگیری شود. (Ib2e4c، b/428243902)

Wear Compose نسخه ۱.۵

نسخه ۱.۵.۶

۳ دسامبر ۲۰۲۵

‫androidx.wear.compose:compose-*:1.5.6 منتشر شد. نسخه ۱.۵.۶ شامل این تعهدها است.

رفع اشکال‌ها

• بهینه‌سازی کردن ذخیره کردن پویانمایی مورد در حافظه نهان درحین پیمایش در TransformingLazyColumn. (I62ae8، b/441701460)
• تغییرات OpenOnPhoneDialog و ConfirmationDialog به‌روزرسانی شده است تا FLAG_KEEP_SCREEN_ON را تنظیم کند، به‌طوری‌که پویانمایی‌ها تا انتها اجرا شوند و کادرهای گفتگو طبق انتظار خودبه‌خود بسته شوند. (Iad7d4، b/437986990)
• اشکالی که باعث ازکارافتادن Modifier.edgeSwipeToDismiss هنگام استفاده با SwipeDismissableNavHost در API 36 و نسخه‌های بالاتر می‌شد برطرف شد. (Ifc13d، b/441901722)

نسخه ۱.۵.۵

۵ نوامبر ۲۰۲۵

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

رفع اشکال‌ها

• بهبود رؤیت‌پذیری شماره TimePicker در صفحه‌های کوچک (I70fbe)

نسخه ۱.۵.۴

‫۲۲ اکتبر ۲۰۲۵

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

رفع اشکال‌ها

• با بازسازی استفاده از LaunchedEffect، عملکرد «انتخابگر» بهبود یافت. (I94519،‏ b/418192973)
• اشکالی در SwipeDismissableNavHost در API36+ برطرف شد که در آن، فشار دادن دکمه برگشت درطول پویانمایی اشاره برگشت پیش‌گویانه باعث قطع شدن و شروع مجدد پویانمایی می‌شد. اکنون پیاده‌سازی به‌جای Animatable از SeakableTransitionState.animateTo استفاده می‌کند که کمی عملکرد را بهبود می‌دهد. (I2241f, b/428156670)
• اشکالی در ترتیب اعلام دسترس‌پذیری در AlertDialog برطرف شد که در آن دکمه تأیید به‌عنوان «دکمه» اعلام می‌شد. به‌جای «تأیید» استاندارد، «تأیید کردن» را انتخاب کنید. دکمه. (Ic2381، b/429378202)

نسخه ۱.۵.۳

‫۸ اکتبر ۲۰۲۵

‫androidx.wear.compose:compose-*:1.5.3 منتشر شد. نسخه ۱.۵.۳ شامل این تعهدات است.

رفع اشکال‌ها

• پشتیبانی از TransformingLazyColumn verticalAlignment را که وجود ندارد پیاده‌سازی کنید - اکنون از چیدمان‌های استاندارد که در بالا، پایین، یا مرکز قرار می‌گیرند پشتیبانی می‌کند. (I2e630، b/444143326)

نسخه 1.5.2

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

‫androidx.wear.compose:compose-*:1.5.2 منتشر شد. نسخه ۱.۵.۲ شامل این تعهدات است.

رفع اشکال‌ها

• ذخیره کردن پویانمایی مورد بهینه‌سازی‌شده در حافظه نهان درحین پیمایش در TransformingLazyColumn. (I62ae8)
• تنوع‌های OpenOnPhoneDialog و ConfirmationDialog به‌روزرسانی شده‌اند تا FLAG_KEEP_SCREEN_ON را تنظیم کنند، به‌طوری‌که پویانمایی‌ها تا انتها اجرا شوند و کادرهای گفتگو طبق انتظار خودبه‌خود بسته شوند. (Iad7d4)
• اشکالی که باعث ازکارافتادن Modifier.edgeSwipeToDismiss هنگام استفاده با SwipeDismissableNavHost در API 36 و نسخه‌های بالاتر می‌شد برطرف شد. (Ifc13d)
• اسناد و نظرات به‌روزشده مرتبط با پارامتر جدید CurvedTextStyle warpOffset برای ارجاع صحیح به مورد «نامشخص». (I41aa5)

نسخه 1.5.1

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

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

رفع اشکال‌ها

• استفاده از پارامتر اصلاح‌گر HorizontalPagerScaffold را اصلاح کنید تا درصورت افزودن Modifier.fillMaxSize()، نشانگر صفحه در HorizontalPager ازدست نرود (I07ae1، b/441682601)
• جهت ScrollIndicator به‌طور پیش‌فرض با جهت چیدمان محتوا تراز می‌شود. (I0da0f, b/441489028)
• مشکل ScrollAway هنگام استفاده با TransformingLazyColumn برطرف شد. پس‌از پیمایش به صفحه‌نمایش دیگر و برگشتن، TimeText به‌درستی پیمایش نمی‌شد. (Ic0ef1، b/433549148)
• گزارش TransformingLazyColumn SCROLL_BACKWARDS و معناشناسی SCROLL_FORWARDS برای موارد حاشیه‌ای در بالا/پایین صفحه‌نمایش اصلاح شد. (I5c28d،‏ b/405205994)
• رفع اشکالی در SwipeDismissableNavHost که باعث می‌شد گذارهای درحال انجام پس‌از کشیدن به عقب در API 36 به‌عنوان تکمیل‌شده علامت‌گذاری نشوند. (Ife72e، b/441089689)
• OpenOnPhoneMaxSweepAngle پیش‌فرض را به ۲۰۰ درجه به‌روز کنید تا از کوتاه شدن برخی‌از ترجمه‌های «تلفنتان را بررسی کنید» جلوگیری شود. (Ib2e4c، b/428243902)

نسخه ۱.۵.۰

‫۲۷ اوت ۲۰۲۵

‫androidx.wear.compose:compose-*:1.5.0 منتشر شد. نسخه ۱.۵.۰ شامل این تعهدات است.

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

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

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

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

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

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

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

• برای فهرست کامل‌تری از ویژگی‌های معرفی‌شده در نسخه ۱.۵.۰، (یادداشت‌های انتشار beta01) را ببینید.

نسخه 1.5.0-rc02

‫۱۳ اوت ۲۰۲۵

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

رفع اشکال‌ها

• اشکالی در TimePicker برطرف شد که در آن رشته‌های طولانی بین‌المللی‌شده برای دوره (قبل‌ازظهر/بعدازظهر) می‌توانست چیدمان را خراب کند. (I0fa81)

نسخه 1.5.0-rc01

۳۰ ژوئیه ۲۰۲۵

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

رفع اشکال‌ها

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

نسخه 1.5.0-beta06

‫۱۶ ژوئیه ۲۰۲۵

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

رفع اشکال‌ها

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

نسخه 1.5.0-beta05

‫۲ ژوئیه ۲۰۲۵

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

رفع اشکال‌ها

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

نسخه 1.5.0-beta04

‫۱۸ ژوئن ۲۰۲۵

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

رفع اشکال‌ها

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

نسخه 1.5.0-beta03

‫۴ ژوئن ۲۰۲۵

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

تغییرات میانای برنامه‌سازی کاربردی

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

رفع اشکال‌ها

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

نسخه 1.5.0-beta02

‫۲۰ مه ۲۰۲۵

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

رفع اشکال‌ها

• نمایه‌های پایه برای کتابخانه‌های foundation،‏ material، و material3 به‌روزرسانی شد. (I53f06)
• اشکالی در TransformingLazyColumn برطرف شد که در آن، وقتی مورد پایینی برداشته می‌شد، اندازه موارد تغییر می‌کرد. ‫(Idacab)
• اشکالی در TransformingLazyColumn برطرف شد که باعث می‌شد فهرست در بالا یا پایین فهرست گیر کند. (I49d00)
• OpenOnPhoneDialog در TalkBack باید نوشتار منحنی را اعلام کند، نه شرح محتوای نماد. (I4efe8)
• اشکالی در SwipeToReveal برطرف شد که وقتی hasPartiallyRevealedState روی «نادرست» تنظیم می‌شد، گزارش نادرستی از لنگر در RevealState.currentValue ارائه می‌داد. (I9c7cf)
• اکنون SwipeToReveal دکمه واگرداندن به‌طور پیش‌فرض ButtonDefaults.Height است. (I1f6c8)
• عملکرد BasicSwipeToDismissBox با حذف استفاده از «بوم» برای کشیدن سایه‌بان بهبود یافته است. (I68f2c)
• اشکال دسترس‌پذیری در «لغزنده» برطرف شد. در این اشکال، درصد اعلام‌شده پس‌از به‌روزرسانی با مقدار مطابقت نداشت (I91146)
• اشکالی در پیاده‌سازی placeholderShimmer برطرف شد. (Iee39b
• عملکرد TransformingLazyColumn با بهینه‌سازی محاسبات ScrollProgress تا ۳۰٪ بهبود یافته است. (I4c4cb)

نسخه 1.5.0-beta01

۷ مه ۲۰۲۵

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

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

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

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

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

• ‫TransformingLazyColumn - فهرست تنبلی که به‌صورت عمودی پیمایش می‌کند و از پویانمایی‌های تغییر شکل و مقیاس‌بندی پشتیبانی می‌کند
• گروه‌های تمرکز سلسله‌مراتبی - برای حاشیه‌نویسی عناصر ترکیبی در یک برنامه، برای پیگیری بخش فعال ترکیب، و هماهنگی تمرکز استفاده می‌شود.
• صفحه‌بندی‌ها - HorizontalPager و VerticalPager مؤلفه، ساخته‌شده روی مؤلفه‌های «پایه Compose» با بهبودهای ویژه Wear برای بهبود عملکرد و رعایت دستورالعمل‌های Wear OS.

تغییرات میانای برنامه‌سازی کاربردی

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

رفع اشکال‌ها

• نحوه مدیریت EdgeButton در ScreenScaffold اصلاح شد تا پس‌از برداشته شدن مورد TransformingLazyColumn،‏ EdgeButton در جای خود پویانمایی شود. ‫(I6d366).
• وابستگی‌های Wear Compose در کتابخانه‌های Compose به نسخه ۱.۸.۰ به‌روزرسانی شد. ‫(I2ef3f).
• حرکت CircularProgressIndicator نامشخص به‌روزرسانی شد تا دیگر به‌طور موقت پسرفت نکند. (Ieddb1).
• اشکال SwipeDismissableNavHost برطرف شد - تمرکز پس‌از کشیدن به عقب به‌درستی تغییر نمی‌کرد و باعث می‌شد ورودی چرخشی کار نکند (این اشکال مربوط به API 36 و بالاتر بود که از «بازگشت پیش‌بینانه» استفاده می‌کند). (Ieddb1).
• مستندات اصلاح‌شده برای «میانای برنامه‌سازی کاربردی فوکوس سلسله‌مراتبی» (Idf2ff).
• مستندات «دکمه» و «کارت» به‌روزرسانی شد تا نحوه ملغی کردن containerPainter و disabledContainerPainter در containerColor و disabledContainerColor را بیان کند (I4a453).
• تغییری در TimeText در نسخه پخش قبلی که BroadcastReceiver را به یک رشته کاری منتقل می‌کرد برگردانده شد، زیرا این تغییر برای برنامه‌هایی که رشته‌بندی خود را درطول پیمایش مدیریت می‌کنند مشکل ایجاد می‌کرد. ‫(I34d02).
• نمونه‌های «انتخابگر» به‌روزرسانی شد تا فراخوانی‌های غیرضروری «به‌یادآوری» برداشته شود و درعوض از rememberUpdatedState در «انتخابگر» برای به‌یاد داشتن جدیدترین تابع لامبدای contentDescription استفاده شود. (Icb5b1).
• سبک‌های نوشتار در TimePicker و DatePicker به‌روز شد تا تغییرات قلم دیگر منجر به کوتاه شدن نوشتار نشود. ‫(I26194).
• ListHeader و ListSubHeader اکنون به‌ترتیب تراز نوشتار را به‌صورت پیش‌فرض روی تراز مرکزی و تراز شروع تنظیم می‌کنند. (I78339).
• نمونه‌ها و نمایش‌های عملی «پایه» و «کشیدن به بیرون Material» به‌روزرسانی شد تا کنش‌های دسترس‌پذیری سفارشی را اعلام کند (کنش‌های سفارشی باید به‌عنوان معناشناسی به محتوا اضافه شوند، نه به خود عنصر ترکیبی SwipeToReveal). (Ie92a3).
• MaxLines پیش‌فرض تنظیم‌شده در محتوای EdgeButton براساس اندازه آن به‌روزرسانی شد - اکنون برای اندازه بسیار کوچک ۱، برای اندازه کوچک و متوسط ۲، و برای اندازه بزرگ ۳ است. ‫(Ie35f6).
• ‫LocalReduceMotion ساده شد تا ناظر فقط یک بار ثبت شود و عملکرد بهبود یابد. (Ib1979).
• تعداد بازطراحی‌ها در ScrollIndicator برای بهبود عملکرد به‌حداقل رسید. ‫(Ia7a67).
• اشکالی در TransformingLazyColumn برطرف شد که در آن، وقتی EdgeButton به ارتفاع کامل خود می‌رسید، مورد نمایان بالای فهرست به‌درستی مقیاس‌بندی نمی‌شد. (I30580).

نسخه 1.5.0-alpha14

‫۲۳ آوریل ۲۰۲۵

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

تغییرات میانای برنامه‌سازی کاربردی

• همه وابستگی‌های Material SwipeToReveal به Foundation SwipeToReveal به بسته Material منتقل شد، برای نمونه RevealValue،‏ RevealDirection،‏ RevealActionType،‏ RevealState،‏ rememberRevealState. توسعه‌دهندگان باید وارد کردن این کلاس‌ها و توابع را از androidx.wear.compose.foundation به androidx.wear.compose.material تغییر دهند. (Ib7cb8)
• «میانای برنامه‌سازی کاربردی» HierarchicalFocusCoordinator به‌روزرسانی شد تا به‌جای عناصر ترکیبی، اصلاح‌گر باشد.
• یادداشت‌های انتقال:
  • با افزودن Modifier.hierarchicalFocus(function()) به content، یا عنصر ترکیبی دربرگیرنده، می‌توان HierarchicalFocusCoordinator(function, content) را جایگزین کرد.
  • با افزودن Modifier.hierarchicalFocusRequester(focusRequester) می‌توانید ActiveFocusListener { if (it) focusRequester.requestFocus() } را جایگزین کنید
  • دیگر موارد استفاده نادر از ActiveFocusListener می‌توانند از پارامتر جدید در Modifier.hierarchicalFocus استفاده کنند
  • ‫focusRequester(rememberActiveFocusRequester()) می‌تواند با hierarchicalFocusRequester() جایگزین شود
  • ‫val focusRequester = rememberActiveFocusRequester() را می‌توان با remember { FocusRequester() } و افزودن Modifier.hierarchicalFocusRequester(focusRequester) جایگزین کرد. (Ie319a)

رفع اشکال‌ها

• آستانه سرعت که اشاره‌های تند باید از آن فراتر بروند تا باعث تغییر وضعیت شوند برای عناصر زیر افزایش یافته است: SwipeToReveal، BasicSwipeToDismissBox، و SwipeDismissableNavHost (فقط برای API 35 و پایین‌تر برای SwipeDismissableNavHost). (If47bf)
• مشکل پویانمایی هنگام اضافه شدن موارد جدید به TransformingLazyColumn برطرف شد. (I589b2)

نسخه 1.5.0-alpha13

‫۹ آوریل ۲۰۲۵

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

تغییرات میانای برنامه‌سازی کاربردی

• برای استفاده از پروژه‌های منتشرشده با Kotlin 2.0، باید از KGP 2.0.0 یا نسخه‌های جدیدتر استفاده کنید (Idb6b5)
• ‫targetPage دارایی به PagerState (I4de8b) اضافه شد

رفع اشکال‌ها

• جلوگیری از ترکیب مجدد غیرضروری درحین بازگشت پیش‌گویانه. (Iecd6d)
• خصوصیت isScrollable مربوط به ScrollInfoProvider را اصلاح کرد تا مقدار فعلی را برگرداند. (Icbfb8)

نسخه 1.5.0-alpha12

‫۲۶ مارس ۲۰۲۵

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

تغییرات میانای برنامه‌سازی کاربردی

• پیاده‌سازی پیش‌فرض SwipeToReveal از gestureInclusion را بهبود دهید تا ژست‌ها فقط درصورتی نادیده گرفته شوند که وضعیت عنصر «پوشیده‌شده» باشد. (I7e3d6)
• برای SwipeToReveal، bidirectionalGestureInclusion را به‌جای تابع به مقدار تبدیل کرد و @FloatRange را به پارامتر edgeZoneFraction در gestureInclusion اضافه کرد. (Ica7c3)

رفع اشکال‌ها

• ‫SwipeToReveal bidirectionalGestureInclusion را تغییر دهید تا به‌جای کلاس، شیء برگرداند. (I29597)
• استفاده از فناوری لمسی هنگام اجرای آزمایش‌ها در RoboElectric غیرفعال شد. (I58bd1)
• فاصله‌های داخلی SwipeToReveal بین محتوا و دکمه‌های کنش، و همچنین فاصله داخلی بین نماد و نوشتار دکمه‌های کنش را به‌روز کنید. (Ic46cb)

نسخه 1.5.0-alpha11

‫۱۲ مارس ۲۰۲۵

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

تغییرات میانای برنامه‌سازی کاربردی

• ‫PagerState به‌روز شد، «پایه Compose» PagerState به‌عنوان کلاس پایه برداشته شد و ویژگی‌های currentPage،‏ currentPageOffsetFraction، و pageCount اضافه شد. واسط GestureInclusion را به‌روزرسانی کرد، نام روش را به ignoreGestureStart تغییر داد. (I4ae07)
• ‫requireOffset را به SwipeToDismissBoxState به‌عنوان روش توصیه‌شده برای دریافت جبران SwipeToDismissBoxState اضافه کنید. (I21042)
• ‫CurvedModifier.semantics اضافه شد، در ابتدا از شرح محتوا و نمایه‌گذاری پیمایش پشتیبانی می‌کند (I0b093)
• CurvedModifier.clearAndSetSemantics را اضافه کرده‌ایم تا روشی برای غیرفعال کردن معناشناسی منحنی ارائه دهیم. CurvedText همچنان به‌طور پیش‌فرض شرح محتوا را به نوشتار تبدیل می‌کند، اما timeTextCurvedText و timeTextSeparator اکنون محتوایشان را اعلام نمی‌کنند. (I4b568)
• نام مدیریت پیش‌فرض HorizontalPager برای اشاره‌های تند به PagerDefaults.gestureInclusion تغییر کرده است. اکنون رفتار پیش‌فرض این است که فقط اشاره‌های تند که از لبه سمت راست صفحه اول شروع می‌شوند نادیده گرفته شوند، و فقط زمانی که Talkback خاموش باشد. در موارد دیگر، رفتار پیش‌فرض این است که اشاره‌های تند توسط صفحه‌بندی نادیده گرفته نمی‌شوند، بنابراین برای کنترل‌کننده‌های تند کشیدن برای بستن دردسترس نخواهند بود. (Iee486)
• پیمایش بیش‌ازحد چرخشی برای rotaryScrollable api اضافه شد. «حرکت سریع» و «پیمایش تودرتو» به رفتار حرکت سریع rotaryScrollable اضافه شد. این تغییر باید عملکرد پیمایش بیش‌ازحد و پیمایش تودرتو را بین پیمایش لمسی و پیمایش چرخشی هم‌سطح کند. (I71926)
• پشتیبانی از منطقه کشیدن از لبه به SwipeToReveal اضافه شد. اکنون رفتار پیش‌فرض SwipeToReveal این است که وقتی اشاره از لبه شروع می‌شود، کشیدن را غیرمجاز کند. اکنون رفتار پیش‌فرض Material3 SwipeToReveal این است که وقتی اشاره از لبه شروع می‌شود و SwipeDirection روی تک‌جهتی تنظیم شده است، کشیدن را غیرمجاز کند. (I32ef0)
• اکنون TLC به‌طور پیش‌فرض از contentPadding خالی استفاده می‌کند به‌جای اینکه اولین و آخرین مورد را در مرکز قرار دهد. (I77ab7)

رفع اشکال‌ها

• کتابخانه‌های Wear Compose به کامپایلر Kotlin 2.0 به‌روزرسانی شده است. (I2de79)
• نمونه LetterSpacing منحنی روی زیرسازی اصلاح شد. (Iebf7c)

نسخه 1.5.0-alpha10

‫۲۶ فوریه ۲۰۲۵

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

تغییرات میانای برنامه‌سازی کاربردی

• ‫SwipeToRevealDefaults را عمومی کنید. (I0c34c)
• پارامتر swipeToDismissEdgeZoneFraction را در HorizontalPager جایگزین کرده‌ایم. درعوض، پارامتر جدیدی، gestureInclusion معرفی شده است که می‌توان از آن برای دستیابی به عملکرد لازم تند کشیدن برای بستن استفاده کرد. gestureInclusion نمونه‌ای از GestureInclusion را می‌گیرد که تصمیم می‌گیرد رویداد پیمایش بعدی باید ادامه یابد یا نه. مجاز کردن اشاره به این معنی است که «صفحه‌بندی» آن را مصرف می‌کند - درغیراین‌صورت، در جای دیگری مثل کنترل‌کننده تند کشیدن برای بستن مدیریت می‌شود. عملکرد پیش‌فرض جدید این است که اشاره‌ها در لبه سمت راست صفحه اول در «صفحه‌گرد» مجاز نباشد و بنابراین کشیدن برای بستن در این ناحیه مجاز باشد. همه صفحه‌های دیگر به Pager اجازه می‌دهند از همه اشاره‌ها استفاده کند، یعنی «تند کشیدن برای بستن» نمی‌تواند از آن‌ها راه‌اندازی شود. برای دستیابی به عملکرد «تند کشیدن برای بستن» در همه صفحه‌ها، کافی است نمونه سفارشی GestureInclusion ارائه دهید (به PagerDefaults.disableLeftEdgeOnFirstPage مراجعه کنید) که صفحه کنونی را نادیده می‌گیرد. تغییر مهم دیگری که در اینجا معرفی شده است این است که عنصر «صفحه‌بندی» دیگر به‌طور پیش‌فرض تمام‌صفحه نیست، درعوض برای دستیابی به این رفتار، Modifier.fillMaxSize() را اضافه کنید. (I9d3aa)
• در «میانای برنامه‌سازی کاربردی آشکارسازی با کشیدن» (If5999)، نام createAnchors را به createRevealAnchors تغییر داده‌ایم
• ‫RevealScope را از API نمایان کردن با کشیدن برداشته‌ایم. (Ie4ad5)
• «آشکارسازی» و «آشکارشده» را از RevealValue در API «کشیدن برای آشکارسازی» برداشته‌ایم. (I8dbc5)
• نام SwipeDirection را در «میانای برنامه‌سازی کاربردی کشیدن برای آشکار کردن» به RevealDirection تغییر داده‌ایم. (I7472f)
• امضای پارامتر positionalThreshold تابع rememberRevealState در SwipeToReveal را تغییر داده‌ایم. (I29c0a)
• پارامتر جدید overscrollEffect را به ScalingLazyColumn، TransformingLazyColumn، و ScreenScaffold اضافه کرده‌ایم. (I0cee8)
• هنگام استفاده از PagerDefaults#snapFlingBehaviour، پارامتر pagerSnapDistance با پارامتر Int maxFlingPages جایگزین شده است که می‌توان از آن برای مشخص کردن حداکثر تعداد صفحاتی که «صفحه‌گرد» باید پرتاب کند استفاده کرد. (I8cfc0)
• ‫Wear Pager اکنون PagerScope خودش را دارد و از Compose Foundation PagerScope استفاده نمی‌کند. (I9195b)
• پشتیبانی از lineHeight را به «نوشتار منحنی» (I1c936) اضافه کرده‌ایم
• ‫initialAnchorItemIndex و initialAnchorItemOffset را به TransformingLazyColumnState و rememberTransformingLazyColumnState را به آن اضافه کرده‌ایم تا موقعیت پیمایش اولیه بتواند در TransformationLazyColumn مشخص شود. (I0a0d5)
• runWithTimingDisabled را به‌نفع runWithMeasurementDisabled منسوخ کنید، که رفتار را واضح‌تر توصیف می‌کند - همه سنجه‌ها موقتاً متوقف می‌شوند. علاوه‌براین، ابرکلاس MicrobenchmarkScope را نمایان کنید زیرا بازاعلان کردن تابع runWithMeasurementDisabled برای باز کردن دسترسی امکان‌پذیر نیست، چون درون‌خطی است. ‫(I9e23b،‏ b/389149423،‏ b/149979716)
• ‫TransformingLazyColumnItemScrollProgress.Unspecified را به «میانای برنامه‌سازی کاربردی» اضافه کرده‌ایم تا از بوکس کردن در TransformingLazyColumnItemScrollProgress جلوگیری کنیم. (I0835d)

رفع اشکال‌ها

• بهبود Kdoc برای CurvedTextStyle (Id45e3)
• SwipeableV2 (بخشی‌از پیاده‌سازی SwipeToReveal) را به‌جای عمومی، داخلی کرده‌ایم اما برای گروه کتابخانه محدود شده است. (Idbb94)
• آزمایش‌هایی به HierarchicalFocusCoordinator (I1ce54،‏ b/395548918) اضافه کرده‌ایم
• در نمونه‌های پایه نوشتن در پوشیدنی‌ها، SwipeToReveal را بهبود داده‌ایم. (I5f307)
• رفع داده‌های معنایی محور پیمایش برای verticalScrollAxisRange در TransformingLazyColumn برای دسترس‌پذیری (I68123)
• با برداشتن رشته‌های پس‌زمینه غیرضروری، عملکرد لمس لرزشی چرخشی در Wear4 و نسخه‌های بالاتر بهبود می‌یابد (I39cfe)
• تغییر SwipeDismissableNavHost برای استفاده از PredictiveBackNavHost فقط در API 36 و نسخه‌های بالاتر. (I59bed)
• محافظی دربرابر خرابی هنگام دسترسی به تنظیم «کاهش حرکت» اضافه کرده‌ایم. (I01e2c)
• برای کاهش لرزش (Icca88)، پیش‌واکشی را برای TransformingLazyColumn پیاده‌سازی کرده‌ایم

نسخه 1.5.0-alpha09

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

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

تغییرات میانای برنامه‌سازی کاربردی

• در CurvedTextStyle، فاصله‌گذاری حروف را به فاصله‌گذاری حروف ساعت‌گرد و فاصله‌گذاری حروف پادساعت‌گرد تقسیم کرده‌ایم. این کار لازم است زیرا حروف در جهت عقربه‌های ساعت از خط پایه فاصله می‌گیرند، درحالی‌که حروف در خلاف جهت عقربه‌های ساعت به خط پایه نزدیک می‌شوند (بنابراین فاصله بین حروف باید بیشتر باشد) (I4b848)
• ‫CompositionLocal LocalReduceMotion ساده شده است تا به‌جای شیء ReduceMotion، مقدار بولی برگرداند. واسط ReduceMotion اکنون منسوخ شده است. فراخوانی‌های قبلی مثل LocalReduceMotion.current.enabled() را می‌توان با LocalReduceMotion.current جایگزین کرد (I4937f)
• در PagerDefaults، نام snapAnimationSpec به SnapAnimationSpec تغییر کرده است. (I20c9a)

نسخه 1.5.0-alpha08

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

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

تغییرات میانای برنامه‌سازی کاربردی

• همه کتابخانه‌های Wear Compose را به حالت «میانای برنامه‌سازی کاربردی صریح» به‌روز کرده‌ایم. (Iebf9f)
• پارامتر پویانمایی چسبنده صفحه پیمایش را بخشی از PagerDefaults کرده‌ایم. (Ifff64)
• پارامتر جابه‌جایی به SwipeToDismissBoxState اضافه کردیم. (I586bd)

رفع اشکال‌ها

• بازخورد لمسی پلاتفرم چرخشی اکنون برای نسخه‌های Wear OS پس‌از V (Idb03e) فراخوانی می‌شود

نسخه 1.5.0-alpha07

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

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

تغییرات میانای برنامه‌سازی کاربردی

• ‫TransformingLazyColumnState اکنون روشی برای مشاهده پیشرفت پیمایش فعلی براساس شاخص‌های عنصر لنگر ارائه می‌دهد. (I72b01)
• اگر Modifier.animateItem جدید را داشته باشید، هنگام افزودن، برداشتن، و جابه‌جا کردن موارد، پویانمایی‌هایی به TransformingLazyColumn اضافه کرده‌ایم. (Iecb9c)
• ‫TransformingLazyColumn اکنون مقادیر beforeContentPadding و afterContentPadding را آشکار می‌کند. (Iccd5f)
• ‫TransformingLazyColumn اکنون ترکیب محلی LocalTransformingLazyColumnItemScope را ارائه می‌دهد که عناصر (مثل Card و Button در Material3) می‌توانند از آن برای تغییر شکل خودکار هنگام قرار گرفتن در TransformingLazyColumn استفاده کنند. تماس‌گیرندگان می‌توانند بااستفاده از پوشش جدید TransformExclusion، تغییر شکل خودکار را غیرفعال کنند. (I1652f)

رفع اشکال‌ها

• سرعت‌های حداقل و حداکثر پرتاب برای چرخش در دستگاه‌هایی که U و نسخه‌های بالاتر را هدف‌یابی می‌کنند به‌روز کرده‌ایم. (I33559)
• خرابی‌ای را که درصورت نداشتن عناصر ترکیب‌شدنی در TransformingLazyColumn رخ می‌داد برطرف کرده‌ایم (Idb99d)
• ScrollFeedbackProviderپشتیبانی از بازخورد لمسی چرخشی را به Android Vanilla ice cream اضافه کرده‌ایم. (Ibc553)
• هنگام استفاده از SwipeToReveal، میزان لغزش لمسی را افزایش داده‌ایم تا احتمال فعال شدن تصادفی تند کشیدن هنگام پیمایش عمودی را کاهش دهیم. (Ic0672)
• ‫SwipeDismissableNavHost را به‌روز کرده‌ایم تا درصورت دردسترس بودن از PredictiveBackHandler با «میانای برنامه‌سازی کاربردی ۳۵» و نسخه‌های جدیدتر استفاده کند. در این صورت، پویانمایی‌های جدید اعمال خواهد شد. (I08c11)

نسخه 1.5.0-alpha06

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

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

تغییرات میانای برنامه‌سازی کاربردی

• با برداشتن پارامتر orientation که دیگر لازم نیست، ScrollInfoProvider را برای PagerState ساده‌تر کرده‌ایم. رفتار جدید این است که TimeText در جای خود برای صفحه‌بندی افقی و عمودی باقی بماند. (I71767)
• ‫TransformingLazyColumn در نسخه‌های پخش قبلی معرفی شده است. اکنون درحال برداشتن نام‌های مستعار LazyColumn در Wear (که به TransformingLazyColumn بازارسال می‌شدند) به نفع نام جدید TransformingLazyColumn هستیم. همچنین دارایی height متعلق به TransformingLazyColumnVisibleItemInfo را برداشته‌ایم - لطفاً به‌جای آن از measuredHeight استفاده کنید. (I0ea1e)
• ‫PagerDefaults.snapFlingBehavior snapAnimationSpec را از مشخصات Tween به Spring تغییر دادیم.(I10d02، b/349781047، b/303807950)
• ‫LocalReduceMotion CompositionLocal را به نسخه پایدار (Ia6f32) ارتقا دادیم

رفع اشکال‌ها

• ‫Modifier.rotaryScrollable را به‌روز کرده‌ایم تا از focusTargetWithSemantics برای پشتیبانی بهتر از معناشناسی در چرخشی استفاده کند. (Ief0a0)
• وابستگی حداقل «میانای برنامه‌سازی کاربردی» را برای کتابخانه‌های Compose به ۱.۷.۴ به‌روز کرده‌ایم. (I88b46)
• برای رفع اشکال برش، تغییر شکل عرض را در TransformingLazyColumn غیرفعال کرده‌ایم. (I3dfb8)
• اشکالی را که باعث می‌شد موارد پس‌از پیمایش بیش‌ازحد با TransformingLazyColumn (Id7668) ناپدید شوند برطرف کردیم
• ‫LazyLayoutSemantics را برای TransformingLazyColumn اضافه کردیم. (Ia8f56)

نسخه 1.5.0-alpha05

۳۰ اکتبر ۲۰۲۴

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

تغییرات میانای برنامه‌سازی کاربردی

• پشتیبانی از animateScrollTo را در TransformingLazyColumnState اضافه کرده‌ایم تا پیمایش به یک مورد بتواند پویانمایی شود. (I4097d)
• در تاریخ TransformingLazyColumnState، requestScrollTo را اضافه کرده‌ایم تا پیمایش به اندازه‌گیری بعدی به‌تعویق بیفتد. (I20a5e)
• پشتیبانی از contentPadding را در TransformingLazyColumn اضافه کرده‌ایم. (I3a69c)

رفع اشکال‌ها

• اشکالی را در پردازاندن TransformingLazyColumn زمانی که ارتفاع محتوا کوتاه‌تر از ارتفاع صفحه است برطرف کرده‌ایم. (I6c3e1)
• ‫ScrollInfoProvder برای TransformingLazyColumn اکنون مورد اول را به‌درستی ردیابی می‌کند. (I1e4a3)
• ‫TransformingLazyColumnState اکنون وضعیت خود را (anchorItemIndex و anchorItemScrollOffset) ذخیره می‌کند. (I3d265)

نسخه 1.5.0-alpha04

‫۱۶ اکتبر ۲۰۲۴

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

تغییرات میانای برنامه‌سازی کاربردی

• نام Wear Compose Foundation LazyColumn را به TransformingLazyColumn تغییر داده‌ایم تا تفاوت بین این و Compose Foundation LazyColumn واضح‌تر شود. (I0608b)
• پشتیبانی از چرخش برای صفحه‌بندهای افقی/عمودی اضافه شد و به کاربران امکان می‌دهد بااستفاده از دستگاه‌های ورودی چرخشی در صفحه‌بندها پیمایش کنند. (I9770d)
• PagerDefaults جدید را به‌روز کرده‌ایم تا مشخص شود که صفحه‌گرد به‌طور پیش‌فرض به صفحه می‌چسبد. (Iff7d0)
• ‫TransformingLazyColumnItemScrollProgress اکنون یک کلاس مقدار است که باید عملکرد را بهبود دهد. (Ic399e)
• ‫TransformingLazyColumn اکنون از همان ابتدا از گردان پشتیبانی می‌کند. (I05206)
• ‫TransformingLazyColumnState اکنون از scrollToItem پشتیبانی می‌کند. (I507b3)
• ‫@ExperimentalWearFoundationApi از SwipeToReveal API برداشته شد (I34a66)

نسخه 1.5.0-alpha03

‫۲ اکتبر ۲۰۲۴

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

تغییرات میانای برنامه‌سازی کاربردی

• برای موارد نادری که صفحه فعلی از تند کشیدن برای بستن پشتیبانی نمی‌کند، از تند کشیدن دوطرفه در SwipeToReveal پشتیبانی کرده‌ایم. . پیش‌فرض همچنان این است که فقط در کشیدن‌های راست به چپ، با کشیدن آشکار شود و اکیداً توصیه می‌شود که رفتار پیش‌فرض رعایت شود تا با کشیدن برای بستن تداخل ایجاد نشود. (Ifac04)
• ‫LazyColumnState را به‌روز کرده‌ایم تا canScrollForward و canScrollBackward را ملغی کند - اکنون وقتی اولین یا آخرین عنصر دقیقاً در مرکز صفحه قرار می‌گیرد، پیمایش متوقف می‌شود. (Ia77d7)
• اجزای جدید HorizontalPager و VerticalPager را اضافه کرده‌ایم که مشکلات رایج را برطرف می‌کنند، مثلاً مدیریت تمرکز و تعامل با کشیدن سیستم برای بستن که ممکن است در Wear رخ دهد. (I2902b)
• پشتیبانی از LazyColumn را اضافه کرده‌ایم تا key و contentType کارخواه را ازطریق layoutItems نمایان کنیم. (I1bd9c)

رفع اشکال‌ها

• پویانمایی‌های نوشتار منحنی را به‌روز کرده‌ایم تا بااستفاده از پرچم‌های رنگ، روان‌تر شوند. (I73a15)
• اسناد «گفتگوی Material» را به‌روز کرده‌ایم تا نشان دهیم که onDismissRequest پس‌از تنظیم پرچم نمایش روی false فراخوانی نمی‌شود. (Ifd8d6)
• اشکالی را در پویانمایی وینیت در «کادر گفتگوی Material» برطرف کرده‌ایم (I126bf)

نسخه 1.5.0-alpha02

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

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

تغییرات میانای برنامه‌سازی کاربردی

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

رفع اشکال‌ها

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

نسخه 1.5.0-alpha01

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

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

تغییرات میانای برنامه‌سازی کاربردی

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

رفع اشکال‌ها

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

نسخه ۱.۴

نسخه ۱.۴.۱

‫۱۲ فوریه ۲۰۲۵

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

رفع اشکال‌ها

• ما دربرابر خرابی هنگام دسترسی به تنظیم جهانی «کاهش حرکت» که در برخی‌از پلاتفرم‌ها که این تنظیم ارائه نشده بود راه‌اندازی می‌شد، محافظت کرده‌ایم. (I01e2c)

نسخه ۱.۴.۰

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

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

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

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

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

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

نسخه 1.4.0-rc01

‫۲۱ اوت ۲۰۲۴

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

• وابستگی‌های Compose را به 1.7.0-rc01 به‌روزرسانی کرده‌ایم و «پیمایش Compose ویژه Wear» را به androidx.lifecycle 2.8.3 سنجاق کرده‌ایم

نسخه 1.4.0-beta03

۱۲ ژوئن ۲۰۲۴

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

رفع اشکال‌ها

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

نسخه 1.4.0-beta02

۲۹ مه ۲۰۲۴

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

رفع اشکال‌ها

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

نسخه 1.4.0-beta01

۱۴ مه ۲۰۲۴

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

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

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

رفع اشکال‌ها

• اشکالی را که در آن تراشه‌های انتخابی هنگام انتخاب شدن، دوضربه برای تغییر وضعیت را اعلام می‌کردند برطرف کردیم. (I7ed88)

نسخه 1.4.0-alpha08

۱ مه ۲۰۲۴

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

تغییرات میانای برنامه‌سازی کاربردی

• تغییرات زیر را در API گردان جدید اعمال کرده‌ایم: Modifier.rotary به Modifier.rotaryScrollable تغییر نام داد؛ رابط RotaryBehavior به RotaryScrollableBehavior و عملکرد آن handleScrollEvent به performScroll تغییر نام داد؛ RotaryScrollableAdapter به RotaryScrollableLayoutInfoProvider تغییر نام داد و دارایی scrollableState برداشته شد. (I0c8a6)
• تغییرات دیگری در API گردان ایجاد کرده‌ایم: نام RotaryScrollableLayoutInfoProvider را به RotarySnapLayoutInfoProvider تغییر دادیم (زیرا این ارائه‌دهنده فقط برای گردان با چسبندگی لازم است)؛ نوع پارامتر snapOffset در RotaryScrollableDefaults.snapBehavior snapOffset را از Int به Dp تغییر دادیم. (Iddebe)
• پارامتر clickInteractionSource را در SplitSelectableChip به containerInteractionSource تغییر نام داده‌ایم. (Ia8f84)
• نام‌های پارامترهای برگشت کلیک را برای SplitSelectableChip به‌روز کرده‌ایم - از onClick به onSelectionClick و از onBodyClick به onContainerClick. (I32237)

رفع اشکال‌ها

• فاصله افقی PositionIndicator را به ۲dp (قبلاً ۵dp بود) به‌روز کردیم تا اشکالی را که در آن PositionIndicator (نوار پیمایش) با محتوای پیمایش‌پذیر هم‌پوشانی داشت برطرف کنیم. لطفاً توجه داشته باشید که انتظار می‌رود این تغییر باعث ازکار افتادن نماگرفت‌های موجودی شود که شامل PositionIndicator است، زیرا حاشیه تغییر کرده است. (I57472)
• با شرح تفاوت‌های بین دستگاه‌های گردان کم‌وضوح و پروضوح، مستندات مربوط به «میانای برنامه‌سازی کاربردی» گردان جدید را بهبود داده‌ایم. (I63abe)
• استثنای خارج از محدوده در SwipeDismissableNavHost را که می‌توانست وقتی مقادیر آلفای درونیابی‌شده کمتر از صفر باشد راه‌اندازی شود برطرف کرده‌ایم. (Ib75a1، b/335782510)

نسخه 1.4.0-alpha07

‫۱۷ آوریل ۲۰۲۴

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

تغییرات میانای برنامه‌سازی کاربردی

• Modifier.rotary را اضافه کرده‌ایم، اصلاح‌گر جدیدی که رویدادهای چرخشی را به محتویات پیمایش‌پذیر متصل می‌کند و به کاربران امکان می‌دهد ازطریق تاج یا حاشیه چرخان در دستگاه Wear OS خود پیمایش کنند. علاوه‌براین، ScalingLazyColumn و «انتخابگر» اکنون به‌طور پیش‌فرض از ورودی چرخشی پشتیبانی می‌کنند و سراینده‌های جدیدی دارند که شامل پارامتر rotaryBehavior برای مشخص کردن پیکربندی پیمایش یا چسبیدن می‌شود. اگر پارامتر rotaryBehavior روی چسبیدن تنظیم شده است، توصیه می‌شود که چسبیدن را ازطریق پارامتر flingBehavior نیز برای پیمایش لمسی ارائه دهید. (I2ef6f)
• منابع NestedScroll «کشیدن و پرتاب کردن» با UserInput و SideEffect جایگزین می‌شوند تا تعریف گسترده این منابع را که اکنون شامل پویانمایی‌ها (اثر جانبی) و چرخ موشواره و صفحه‌کلید (ورودی کاربر) می‌شود دربر بگیرند. (I40579)
• SelectableChip و SplitSelectableChip را اضافه کرده‌ایم تا تفاوت بین کنترل‌های کلیدی مثل Switch/Checkbox و کنترل‌های قابل‌انتخاب مثل RadioButton را واضح‌تر کنیم. این کار جایگزین سربارهای قبلاً اضافه‌شده ToggleChip/SplitToggleChip با selectionControl پارامتر می‌شود. (Ia0217)
• اصلاح‌گر رؤیت‌پذیری IndeterminateStrokeWidth در ProgressIndicatorDefaults به عمومی به‌روزرسانی شد. (I5b5a4)

نسخه 1.4.0-alpha06

۳ آوریل ۲۰۲۴

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

رفع اشکال‌ها

• پیش‌نویس داخلی پشتیبانی از چرخش را به‌عنوان بخشی از تلاش بزرگ‌تر برای انتقال رفتار «چرخش» از Horologist به AndroidX اضافه کرده‌ایم. (I617d1)
• به‌عنوان بخشی از تلاش بزرگ‌تر برای انتقال رفتار «چرخشی» از Horologist به AndroidX، پیش‌نویس داخلی پشتیبانی از لمس لرزشی را اضافه کرده‌ایم. (I5568a)

نسخه 1.4.0-alpha05

‫۲۰ مارس ۲۰۲۴

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

تغییرات میانای برنامه‌سازی کاربردی

• دارایی‌های initialCenterItemIndex و initialCenterItemScrollOffset متعلق به ScalingLazyListState را عمومی کرده‌ایم. (I0c616)
• ‫FullScreenStrokeWidth از ProgressIndicatorDefaults را عمومی کرده‌ایم. (Ibea23)

رفع اشکال‌ها

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

نسخه 1.4.0-alpha04

۶ مارس ۲۰۲۴

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

تغییرات میانای برنامه‌سازی کاربردی

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

نسخه 1.4.0-alpha03

۲۱ فوریه ۲۰۲۴

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

تغییرات میانای برنامه‌سازی کاربردی

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

رفع اشکال‌ها

• اشکال مستندات مربوط به WearPreview* گزارمان را برطرف کرده‌ایم. ‫(Id526d)

نسخه 1.4.0-alpha02

۷ فوریه ۲۰۲۴

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

رفع اشکال‌ها

• اشکالی را در «کشیدن برای آشکار کردن» برطرف کردیم که در آن امکان تعامل با کنش انجام‌شده در یک مورد (و لغو آن) با شروع کشیدن مورد دیگر وجود داشت.(Ide059)
• ListHeader را به‌روز کرده‌ایم تا از تنظیمات ارتفاع پشتیبانی کند، درصورتی‌که محتوا برای جای دادن اندازه‌های بزرگ قلم به ارتفاع بیشتری نیاز داشته باشد. (I7290c، b/251166127)

نسخه 1.4.0-alpha01

۲۴ ژانویه ۲۰۲۴

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

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

• پویانمایی ورودی را به SwipeDismissableNavHost برای گذارهای درون‌برنامه اضافه کردیم.(cfeb79a)
• اکنون PositionIndicator به‌طور پیش‌فرض هنگام نمایش اولیه صفحه نشان داده می‌شود. این تغییر برای کمک به رعایت «دستورالعمل‌های کیفیت Wear» معرفی شده است. متأسفانه، این یعنی آزمایش‌های نماگرفت باید در صفحه‌هایی که شامل PositionIndicator است به‌روزرسانی شوند، زیرا PositionIndicator قبلاً نمایش داده نمی‌شد. (419cef7)

تغییرات میانای برنامه‌سازی کاربردی

• یک API جدید موجی در کتابخانه‌های wear:compose-material و wear:compose-material3 اضافه کرده‌ایم که جایگزین rememberRipple منسوخ‌شده می‌شود. همچنین CompositionLocal، LocalUseFallbackRippleImplementation موقتی را اضافه می‌کند تا مؤلفه‌های Material را به استفاده از میاناهای برنامه‌سازی کاربردی rememberRipple/RippleTheme منسوخ‌شده برگرداند. این مورد در نسخه پایدار بعدی برداشته خواهد شد و فقط به‌عنوان یک کمک موقت برای انتقال در مواردی که RippleTheme سفارشی ارائه می‌دهید درنظر گرفته شده است. برای اطلاعات مربوط به انتقال و اطلاعات زمینه‌ای بیشتر درباره این تغییر، به developer.android.com مراجعه کنید. (af92b21)
• ‫ColorScheme را به‌روز کرده‌ایم تا تغییرناپذیر شود، که باعث می‌شود به‌روزرسانی‌های رنگ تکی کارایی کمتری داشته باشد، اما استفاده رایج‌تر از رنگ‌ها کارایی بیشتری داشته باشد. دلیل این تغییر این است که اکثر برنامه‌ها به‌روزرسانی رنگ‌های جداگانه را به‌عنوان مورد استفاده اصلی خود ندارند. این کار همچنان امکان‌پذیر است اما نسبت‌به قبل بیشتر ترکیب خواهد شد، درنتیجه مقدار اشتراک‌های وضعیت را در کل کد مواد به‌طور قابل‌توجهی کاهش می‌دهیم و بر هزینه مقداردهی اولیه و زمان اجرای موارد استفاده استانداردتر تأثیر می‌گذارد. (f5c48b7)
• عناصر Wear material و Wear material3 که MutableInteractionSource را در میانای برنامه‌سازی کاربردی خود آشکار می‌کنند به‌روز شده‌اند تا اکنون MutableInteractionSource تهی‌پذیری را که به‌طور پیش‌فرض تهی است آشکار کنند. در اینجا هیچ تغییر معنایی وجود ندارد: ارسال مقدار null به این معنی است که نمی‌خواهید MutableInteractionSource را بالا ببرید، و درصورت نیاز، در داخل عنصر ایجاد خواهد شد. تغییر به null باعث می‌شود برخی‌از عناصر هرگز MutableInteractionSource را تخصیص ندهند و به عناصر دیگر اجازه می‌دهد فقط زمانی که نیاز دارند نمونه‌ای را به‌صورت تنبل ایجاد کنند، که عملکرد را در سراسر این عناصر بهبود می‌بخشد. اگر از MutableInteractionSource که به این عناصر ارسال می‌کنید استفاده نمی‌کنید، توصیه می‌شود به‌جای آن مقدار null ارسال کنید. همچنین توصیه می‌شود که تغییرات مشابهی را در عناصر خودتان ایجاد کنید. (f8fa920)
• ‫rememberExpandableState را به‌روز کرده‌ایم تا وضعیت ازهم بازشدنی را ذخیره کنیم. این کار تضمین می‌کند که داده‌ها هنگام پیمایش به صفحه‌ای دیگر ذخیره شوند و هنگام بازگشت به صفحه اصلی بازیابی شوند. (5c80095)

رفع اشکال‌ها

• تنظیم ReduceMotion را به‌روز کرده‌ایم تا از شنونده آگاه از چرخه حیات استفاده کند. (7c6b122)
• «شنونده» TouchExplorationStateProvider را به‌روز کرده‌ایم تا از چرخه حیات آگاه باشد (be28b01)
• لایه materialcore را برای CompactButton برداشتیم تا عملکرد را بهبود دهیم (25db8e9)
• ‫BasicSwipeToDismissBox را برای جبران NaN مستحکم‌تر کرده‌ایم تا از استثناها جلوگیری کنیم (b983739)
• ‫BasicSwipeToDismissBox را به‌روز کرده‌ایم تا مطمئن شویم مقادیر آلفا در محدوده ۰,۱ قرار دارند
• اشکالی را در ToggleButton، SplitToggleButton، Checkbox، Switch، و RadioButton برطرف کرده‌ایم تا اعلان‌های دسترس‌پذیری تکرار نشوند (قبلاً نقش‌های معنایی تکرار می‌شدند) (d11eeb7)

نسخه ۱.۳

نسخه ۱.۳.۱

۳ آوریل ۲۰۲۴

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

رفع اشکال‌ها

• اشکالی را در «آشکار کردن با تند کشیدن» برطرف کرده‌ایم. در این حالت، با شروع تند کشیدن روی مورد دیگر، امکان تعامل با کنش انجام‌شده روی یک مورد (و لغو آن) وجود داشت. (Ide059)

نسخه ۱.۳.۰

۲۴ ژانویه ۲۰۲۴

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

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

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

• نسخه پخش 1.3.0-alpha02 ما تغییری را معرفی کرد که باعث می‌شود ارتفاع اشیای Chip و ToggleChip افزایش یابد تا بهتر از مقیاس‌بندی قلم انتخاب‌شده توسط کاربر پشتیبانی کند. این کار می‌تواند باعث شود برخی‌از بخش‌ها بریده شوند. برای رفع این مشکل، شکل large برای MaterialTheme اکنون از شعاع گوشه بزرگ‌تری (۲۶ پیکسل به‌جای ۲۴ پیکسل) استفاده می‌کند. ‫Chip و ToggleChip شیء از این شعاع گوشه جدید استفاده می‌کنند تا از برش محتوا در گوشه‌های «تراشه» و ToggleChip جلوگیری کنند.

  • بیشتر Chips و ToggleChips بدون تغییر باقی می‌مانند، زیرا ارتفاع پیش‌فرض آن‌ها ۵۲ dp است. بااین‌حال، Chip و ToggleChip شیء که حاوی چندین خط نوشتار برچسب اصلی یا فرعی هستند، یا ارتفاع آن‌ها ملغی شده است، می‌توانند باعث ازکارافتادن آزمایش‌های نماگرفت شوند.

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

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

توصیه‌هایی برای پیاده‌سازی

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

نسخه 1.3.0-rc01

‫۱۰ ژانویه ۲۰۲۴

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

رفع اشکال‌ها

• شکل بزرگ MaterialTheme را به‌روز کرده‌ایم تا از شعاع گوشه گرد ۲۶dp استفاده کند و اکنون «تراشه» و ToggleChip از آن استفاده خواهند کرد. این تغییر برای پشتیبانی از تنظیمات ارتفاع زمانی که محتوا برای جای دادن اندازه‌های بزرگ قلم به ارتفاع بیشتری نیاز دارد ضروری است—درغیراین‌صورت، شکل استادیومی موجود برخی‌از محتوای نوشتاری را برش می‌دهد.

  

  

  این تغییر ممکن است باعث ازکارافتادگی در آزمایش‌های نماگرفت شود. (I2e6ae)

نسخه 1.3.0-beta02

‫۱۳ دسامبر ۲۰۲۳

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

رفع اشکال‌ها

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

نسخه 1.3.0-beta01

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

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

انتشار نسخه 1.3-beta01 از Compose برای Wear OS نشان می‌دهد که این نسخه از کتابخانه دارای ویژگی‌های کامل است و 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 در Material است که از رهنمودهای توصیه شده «تجربه کاربری» برای Card و Chip پیروی می‌کند. همچنین از واگرداندن کنش ثانویه پشتیبانی می‌کند.
• ‫DefaultTextStyle اکنون حاشیه قلم را خاموش می‌کند تا در سراسر «پلاتفرم Android» یکسان باشد.
• ‫Chip و ToggleChip اکنون ارتفاع خود را تنظیم می‌کنند تا محتوایی را که به‌دلیل قلم‌های بزرگ برای دسترس‌پذیری رشد کرده است دربر بگیرند
• ‫PositionIndicator اکنون مشخصات پویانمایی جداگانه‌ای برای پویانمایی‌های محو شدن، محو شدن و تغییر موقعیت دارد. به‌دلایل عملکردی، توصیه می‌کنیم وقتی از فهرست‌های پیمایش‌شدنی استفاده می‌کنید، محو شدن و تغییر موقعیت را خاموش کنید.
• ExpandableStateMapping روش جدیدی برای تولید ExpandableStates ارائه می‌دهد، زمانی که باید به‌صورت درخواستی ایجاد شوند و لزوماً با محدوده @Composable نباشند.
• اکنون Placeholder اجازه می‌دهد اگر محتوا دیگر در حالت آماده نباشد، بازنشانی انجام شود. همچنین، تنظیم کاهش حرکت اکنون برای جلوه درخشش و حرکت پاک‌سازی در Placeholder اعمال می‌شود.

مشکلات شناخته‌شده

• وقتی صفحه‌نمایش برای اولین‌بار نمایش داده می‌شود، PositionIndicator در ابتدا نشان داده نمی‌شود. قصد داریم در نسخه آلفای اولیه ۱.۴ تغییری ایجاد کنیم تا در ابتدا نشان داده شود، اما بدون هیچ پویانمایی.

تغییرات میانای برنامه‌سازی کاربردی

• نام سطح «پایه» SwipeToDismissBox را به BasicSwipeToDismissBox تغییر داده‌ایم. این کار تمایز بین عنصر سطح «پایه» و سطح «ماده» SwipeToDismissBox را واضح‌تر می‌کند. مورد دوم رنگ‌ها را از MaterialTheme می‌گیرد تا در سایه‌بان‌ها استفاده کند و پیاده‌سازی باقی‌مانده را به BasicSwipeToDismissBox واگذار می‌کند. (Ibecfc)
• ‫rememberExpandableStateMapping را به‌عنوان آزمایشی علامت‌گذاری کرده‌ایم و عملکرد expandableItem را بهبود داده‌ایم. (I5f6bc)
• کلاس SwipeToRevealAction را در Material SwipeToReveal Card و Chip APIs با یک API مبتنی بر شکاف بااستفاده از عناصر ترکیبی SwipeToRevealPrimaryAction، SwipeToRevealSecondaryAction، و SwipeToRevealUndoAction جایگزین کرده‌ایم. لطفاً برای نمونه‌هایی از نحوه استفاده از API جدید، کد نمونه را ببینید. (Ia8943)
• پرچم‌های پویانمایی PositionIndicator را با پارامترهای AnimationSpec جایگزین کرده‌ایم. پویانمایی‌های تکی را می‌توان با ارسال snap به‌عنوان AnimationSpec غیرفعال کرد. (I6c523)

رفع اشکال‌ها

• اشکالی را که درصورت محدود بودن اندازه، با محدود شدن نوشتار منحنی ایجاد می‌شد برطرف کرده‌ایم (I50efe)
• خرابی بالقوه NaN مربوط به curvedComposable را برطرف کرده‌ایم (I970eb)
• برداشتن پویانمایی برجسته کردن تغییر موقعیت در PositionIndicator را برگرداندیم. (Ieb424)
• لایه material-core را برای تراشه material برداشته‌ایم تا عملکرد آن را بهبود دهیم. (If2dcb)

نسخه 1.3.0-alpha08

۱۸ اکتبر ۲۰۲۳

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

تغییرات میانای برنامه‌سازی کاربردی

• پرچم‌های جداگانه‌ای به PositionIndicator سربار اضافه کرده‌ایم تا پویانمایی‌های مختلف را کنترل کنیم: showFadeInAnimation،‏ showFadeOutAnimation، و showPositionAnimation. «میانای برنامه‌سازی کاربردی» قبلی منسوخ شده است و تماس‌ها را به میانای جدید هدایت می‌کند. به‌دلایل عملکردی و برای یکپارچگی تجربه کاربری، وقتی از PositionIndicator با فهرست پیمایش‌پذیر استفاده می‌شود، توصیه می‌کنیم پرچم‌های showFadeInAnimation و showPositionAnimation را خاموش کنید. اگر از PositionIndicator به‌عنوان نشانگر مستقل استفاده می‌شود، برای مثال برای تغییر صدا، توصیه می‌کنیم هر ۳ پویانمایی روشن باشد. (I44294)
• پس‌از انتقال عملکرد «کشیدن برای بستن» به wear.compose.foundation، «مجموعه نمادهای Material» SwipeToDismissBoxState، SwipeToDismissValue، و edgeSwipeToDismiss را منسوخ کرده‌ایم. لطفاً با معادل‌های wear.compose.foundation جایگزین کنید. (Iee8c9)

رفع اشکال‌ها

• نمایه‌های مبنا را برای کتابخانه‌های زیربنای نوشتن، Material، و پیمایش در Wear به‌روز کرده‌ایم. (Idb060)
• تغییر رفتاری PositionIndicator را که در CL قبلی معرفی شده بود برگرداندیم، به‌طوری‌که PositionIndicator هنگام نمایش اولیه صفحه پویانمایی می‌شد. قصد داریم تغییر مشابهی را در نسخه آلفای اولیه ۱.۴ اعمال کنیم تا PositionIndicator در ابتدا نمایش داده شود، اما بدون هیچ پویانمایی. (I41843)
• برخی‌از مشکلات عملکرد را در PositionIndicator برطرف کرده‌ایم. (I1c654،‏ b/302399827)
• عملکرد پیاده‌سازی پیش‌فرض ارائه‌دهنده وضعیت کاوش لمسی را بهینه‌سازی کرده‌ایم تا به‌جای وضعیت مشتق‌شده، به State<Boolean> متکی باشد. (Ieec4d)
• ‫systemGestureExclusion مستطیل برای Android 13 و نسخه‌های بالاتر تنظیم کرده‌ایم. (Ib1f4b)

نسخه 1.3.0-alpha07

۴ اکتبر ۲۰۲۳

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

تغییرات میانای برنامه‌سازی کاربردی

• پرچم‌های جداگانه‌ای به PositionIndicator اضافه کرده‌ایم تا پویانمایی‌های مختلف را کنترل کنیم: showFadeInAnimation،‏ showFadeOutAnimation، و showPositionAnimation. «میانای برنامه‌سازی کاربردی» قبلی منسوخ شده است و تماس‌ها را به میانای جدید هدایت می‌کند. به‌دلایل عملکردی و برای یکپارچگی تجربه کاربری، وقتی از PositionIndicator با فهرست پیمایش‌پذیر استفاده می‌شود، توصیه می‌کنیم پرچم‌های showFadeInAnimation و showPositionAnimation را خاموش کنید. اگر از PositionIndicator به‌عنوان نشانگر مستقل استفاده می‌شود، برای مثال برای تغییر صدا، توصیه می‌کنیم هر ۳ پویانمایی روشن باشد. (Ia2d63)

رفع اشکال‌ها

• با افزودن پویانمایی محو شدن به نوشتار کنش اصلی و محو کردن کنش ثانویه/تغییر مقیاس نماد در ازهم بازکردن با تند کشیدن کامل، بهبودهایی در آشکار کردن حرکت با تند کشیدن ایجاد کرده‌ایم. (Ib7223)
• توصیه می‌شود که کنش‌های «تند کشیدن برای آشکار کردن» دسترس‌پذیر شوند و ما کنش‌های دسترس‌پذیری سفارشی را به نمونه‌های «تند کشیدن برای آشکار کردن» اضافه کرده‌ایم. (I42224)
• عملکرد SwipeToDismissBox را بهبود داده‌ایم، ازجمله با بازسازی کد برای اطمینان از اینکه منطق اولیه باعث بازسازی نمی‌شود. اکنون SwipeToDismissBox به‌اندازه تمام‌صفحه رسم می‌شود. (Ie0aa2)
• اشکالی را که باعث می‌شد PositionIndicator به‌اشتباه ناپدید شود برطرف کردیم. (I2091a)
• عملکرد PositionIndicator با بهینه‌سازی ترکیب مجدد بهبود یافت. پرچم‌های جدیدی برای کنترل پویانمایی‌ها (fadeIn، fadeOut، و positionChange) متعاقباً اضافه شده است (به «تغییرات میانای برنامه‌سازی کاربردی» مراجعه کنید) (Ifac7d)
• آزمایش‌های «ریزسنجش» را برای PositionIndicator (Idf875) اضافه کرده‌ایم

نسخه 1.3.0-alpha06

‫۲۰ سپتامبر ۲۰۲۳

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

رفع اشکال‌ها

• پشتیبانی از Modifier.edgeSwipeToDismiss با SwipeToReveal را اضافه کرده‌ایم. (I95774، b/293444286)
• نمونه‌هایی برای «متریال» SwipeToRevealChip و SwipeToRevealCard اضافه کرده‌ایم. (Ieb974)
• نمایه‌های پایه را برای کتابخانه‌های Wear Compose Foundation و Material به‌روز کرده‌ایم. (I1dd1f)

نسخه 1.3.0-alpha05

۶ سپتامبر ۲۰۲۳

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

رفع اشکال‌ها

• عملکردی به «تند کشیدن برای آشکار کردن» اضافه کرده‌ایم تا فقط یک مورد در هر زمان بتواند تند کشیده شود. (I3cd7a)
• مستندات ScalingLazyColumnDefaults بهبود یافت تا بهتر با رفتار واقعی آن مطابقت داشته باشد. (I886d3)

نسخه 1.3.0-alpha04

۲۳ اوت ۲۰۲۳

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

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

• از این پس می‌توانید کنش ثانویه SwipeToReveal را واگرد کنید. (I7a22d)

تغییرات میانای برنامه‌سازی کاربردی

• ‫HorizontalPageIndicator را در کتابخانه Wear Material3 اضافه کنید. (Ifee99)
• ابزار پیش‌نمایش «نوشتن Wear» به‌روزرسانی شد تا از کتابخانه androidx.wear.tooling.preview استفاده کند. (Ib036e)

رفع اشکال‌ها

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

نسخه 1.3.0-alpha03

۹ اوت ۲۰۲۳

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

تغییرات میانای برنامه‌سازی کاربردی

• دو عنصر ترکیبی جدید در Material برای پیاده‌سازی SwipeToReveal با «کارت‌ها» و «تراشه‌ها» اضافه کرده‌ایم. این عناصر ساختنی از راهنمایی‌های توصیه شده تجربه کاربری در مؤلفه پیروی می‌کنند و پیاده‌سازی SwipeToReveal را با مؤلفه‌های موجود در Wear Material برای توسعه‌دهندگان آسان‌تر می‌کنند. (I7ec65)
• ما FloatRange گزارمان را به‌عنوان محدودیت‌های API فعال کرده‌ایم که قبلاً در نظرات ذکر شده بود. (Icb401)

رفع اشکال‌ها

• منطق پیمایش اولیه ScalingLazyColumn را به داخل onGloballyPositioned() منتقل کرده‌ایم. (Ic90f1)
• اکنون از drawWithCache در PositionIndicator،‏ ProgressIndicator، و SelectionControls برای بهینه‌سازی تخصیص سکته استفاده می‌کنیم. (I5f225، b/288234617)
• رؤیت‌پذیری تیک چارگوش انتخاب در وضعیت‌های غیرفعال را اصلاح کرده‌ایم. (Ib25bf)
• ‫Placeholder را به‌روز کرده‌ایم تا درصورتی‌که محتوا دیگر در وضعیت آماده نباشد، امکان بازنشانی برای نمایش جای‌بان وجود داشته باشد. (Ibd820)
• چندین اصلاح برای آزمون‌های Placeholder ناپایدار انجام داده‌ایم (Idb560)

نسخه 1.3.0-alpha02

۲۶ ژوئیه ۲۰۲۳

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

تغییرات میانای برنامه‌سازی کاربردی

• ExpandableStateMapping را به‌عنوان روشی جدید برای تولید ExpandableStates ارائه کرده‌ایم، برای مواردی که باید به‌صورت درخواستی ایجاد شوند، نه لزوماً در محدوده @Composable (Iff9e0)
• ‫SwipeToDismissBox از بسته androidx.wear.compose.material به بسته androidx.wear.compose.foundation انتقال داده شده است. ‫(I275fb)
• فایل‌های «میانای برنامه‌سازی کاربردی» برای حاشیه‌نویسی کردن سرکوب سازگاری به‌روزرسانی شد. (I8e87a, b/287516207)
• ثابت‌های ارتفاع را برای Chip، CompactChip، و ToggleChip عمومی کرده‌ایم (Idbfde)
• فاصله‌های افقی و عمودی را برای Chip و CompactChip عمومی کرده‌ایم. (Ieeaf7)
• عملکردی اضافه شد که ازطریق پارامتر جدید userSwipeEnabled، مدیریت تند کشیدن را در SwipeDismissableNavHost خاموش می‌کند. (Id2a0b, b/230865655)
• کتابخانه «پیمایش Wear Compose» را به‌روز کرده‌ایم تا از SwipeToDismissBox جدید در «پایه Wear Compose» استفاده کند. (I4ff8e)

رفع اشکال‌ها

• اشکال ترتیب z را که در آن expandedItem محتوای صحیح را پس‌از کلیک کردن روی رفتار دکمه وقتی دکمه دارد نشان نمی‌داد برطرف کردیم. (I1899d،‏ b/289991514)
• بااستفاده از HierarchicalFocusCoordinator (I45362، b/277852486)، مدیریت کانون توجه SwipeToDismissBox (و درنتیجه SwipeDismissableNavHost) را بهبود دهید
• اصلاحی در مدیریت اشاره در SwipeableV2 انجام داده‌ایم . (I89737)
• نمایه‌های پایه را برای نسخه ۱.۲ نهایی کرده‌ایم. (Id5740)
• پس‌از انتقال SwipeToDismissBox به Foundation، پیاده‌سازی Material SwipeToDismissBox اکنون به Foundation ارسال می‌شود و مقادیر رنگ پیش‌فرض را از زمینه خود تأمین می‌کند.(If8451)
• معناشناسی عنوان را به ListHeader اضافه کرده‌ایم. (Ic5420)
• Chip و ToggleChip اکنون ارتفاع خود را برای جای دادن محتوایی که به‌دلیل قلم‌های بزرگ برای دسترس‌پذیری رشد کرده است، درصورت نیاز تنظیم می‌کنند. (Iaf302)
• اشکالی را در نقش معنایی ناحیه ضربه‌زدنی SplitToggleChip برای دسترس‌پذیری رفع کردیم. (Ieed3a)
• تنظیم کاهش حرکت اکنون جلوه درخشان و حرکت پاک‌سازی را در جای‌بان‌ها خاموش می‌کند. (I91046)
• اکنون Stepper و InlineSlider از کلیک‌های مکرر روی فشار طولانی پشتیبانی می‌کنند تا بتوانید با نگه داشتن دکمه‌های + یا -، مقدار Stepper و InlineSlider را به‌سرعت افزایش/کاهش دهید. (I27359)

نسخه 1.3.0-alpha01

۲۱ ژوئن ۲۰۲۳

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

رفع اشکال‌ها

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

• وقتی حاشیه قلم خاموش باشد، دیگر وجود ندارد:

• ‫wear.compose.foundation را به‌روز کرده‌ایم تا به میانای برنامه‌سازی کاربردی wear.compose.material وابسته باشد (I72004، b/285404743)
• اشکالی را در SwipeToDismissBox برطرف کرده‌ایم. اکنون کلیدهای پس‌زمینه و محتوا به بلوک «به‌یادآوردن» منتقل می‌شوند تا وقتی محتوا یا پس‌زمینه تغییر می‌کند، اصلاح‌کننده‌های جدید ایجاد شوند. (Ib876c،‏ b/280392104)
• ‫TimeText را به‌روز کرده‌ایم تا هنگام انتخاب قالب برای زمان ۱۲ یا ۲۴ ساعته از منطقه استفاده کند. (If4a3d)
• ناهمخوانی در SwipeToDismissBox contentScrimColor پارامتر پیش‌فرض را برطرف کردیم. (I2d70f)
• مدیریت حرکت را در SwipeToReveal بهبود داده‌ایم. (I28fb7)

مشکلات شناخته‌شده

• پشتیبانی از اندازه‌های قلم پیکربندی‌شده توسط کاربر یکی از الزامات دسترس‌پذیری است. می‌دانیم که «تراشه‌های» چندخطی وقتی با اندازه قلم بزرگ نمایش داده می‌شوند می‌توانند منجر به برش نوشتار شوند، بنابراین «تراشه» را در نسخه آلفای اولیه ۱.۳ به‌روز خواهیم کرد تا در این موارد ارتفاع را تنظیم کند.

نسخه ۱.۲

نسخه ۱.۲.۱

۱۸ اکتبر ۲۰۲۳

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

رفع اشکال‌ها

• اشکالی که باعث می‌شد PositionIndicator به‌اشتباه ناپدید شود برطرف شد. (7a167f)

نسخه ۱.۲.۰

۹ اوت ۲۰۲۳

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

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

• نسخه پایدار Compose برای Wear OS 1.2.0 (بیشتر بخوانید)
• برای مشاهده فهرست تغییرات کلیدی در Wear Compose 1.2، یادداشت‌های انتشار (Compose for Wear OS 1.2 Beta01) را ببینید

نسخه 1.2.0-rc01

۲۶ ژوئیه ۲۰۲۳

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

رفع اشکال‌ها

• نمایه‌های پایه برای نسخه ۱.۲ ما (Id5740) نهایی شده است

نسخه 1.2.0-beta02

۷ ژوئن ۲۰۲۳

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

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

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

رفع اشکال‌ها

• نمایه‌های پایه را برای کتابخانه‌های بنیاد و مواد Wear Compose به‌روز کرده‌ایم(I4725d)
• ناهمخوانی در مقادیر پیش‌فرض برای پارامترهای SwipeToDismissBox contentScrimColor را برطرف کرده‌ایم (I2d70f)
• مقدار پیش‌فرض DefaultTextStyle را که برای تنظیم IncludeFontPadding استفاده می‌شد اصلاح کردیم (I737ed)

نسخه 1.2.0-beta01

۲۴ مه ۲۰۲۳

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

محتویات Compose برای Wear OS 1.2

انتشار نسخه 1.2-beta01 از Compose برای Wear OS نشان می‌دهد که این نسخه از کتابخانه دارای ویژگی‌های کامل است و «میانای برنامه‌سازی کاربردی» قفل شده است (به‌جز مواردی که به‌عنوان آزمایشی علامت‌گذاری شده‌اند). ‫Wear Compose 1.2 شامل عملکرد جدید زیر است:

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

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

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

رفع اشکال‌ها

• اسناد بهبودیافته برای angularWidthDp در CurvedSize.kt (Iab75c)
• ‫SwipeDismissableNavHost اکنون هشداری با دلایل احتمالی پشته برگشت خالی ثبت می‌کند. این کار برای جلوگیری از خرابی‌های غیرمنتظره ناشی از IllegalArgumentException انجام می‌شود که وقتی پشته برگشت خالی بود ایجاد می‌شد. (I04a81, b/277700155)

نسخه 1.2.0-alpha10

۱۰ مه ۲۰۲۳

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

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

• ما از «تند کشیدن برای آشکار کردن» به‌عنوان روشی برای دسترسی به کنش‌های ثانویه پشتیبانی می‌کنیم. این الگو مکمل الگوی «فشار طولانی» است، روشی که کاربر می‌توانست کنش‌های ثانویه (متفاوت) را آشکار کند. (I60862)

تغییرات میانای برنامه‌سازی کاربردی

• ‫RevealScope را به عناصر ترکیبی کنش در SwipeToReveal اضافه کرده‌ایم که دسترسی به افست را در جایی که کنش‌های اضافی آشکار می‌شوند فراهم می‌کند. (I3fd56)

رفع اشکال‌ها

• مشکلی برطرف شد که در آن ScalingLazyColumn پس‌از انتقال سریع روی Wear API 33 گیر می‌کرد (Ic4599)
• برای کاهش پرش، بهبودهایی در عملکرد PositionIndicator ایجاد کرده‌ایم. (I35e92)
• اشکالی را در «تراشه» و CompactChip برطرف کردیم که در آن نقش معنایی دیگر روی Role.Button تنظیم نمی‌شد. (I93f91، b/277326264)

مشکلات شناخته‌شده

• اشکالی در «استودیو Android» شناسایی کرده‌ایم که باعث می‌شود پیش‌نمایش هنگام حاشیه‌نویسی با @WearPreviewDevices و @WearPreviewFontScales رندر نشود - رفع این اشکال به‌زودی منتشر خواهد شد. لطفاً توجه داشته باشید که دیگر گزارمان‌های پیش‌نمایش Wear در Android Studio Giraffe 2022.3.1 و نسخه‌های بالاتر طبق انتظار کار می‌کنند.

• در نسخه 1.2.0-alpha07، «سبک نوشتاری پیش‌فرض» را به Wear Compose اضافه کردیم و مقدار PlatformTextStyle.includeFontPadding موجود را به‌عنوان درست حفظ کردیم - برای پس‌زمینه، رفع فاصله قلم در Compose را ببینید. در نسخه آلفای اولیه ۱.۳، برای یکسان‌سازی در سراسر «پلاتفرم Android»، «سبک نوشتار پیش‌فرض» را تغییر خواهیم داد تا حاشیه قلم را خاموش کنیم. این کار برخی‌از موارد برش نوشتار با اندازه‌های قلم بزرگ را برطرف می‌کند و ممکن است بر چیدمان‌های صفحه‌نمایش نیز تأثیر بگذارد، بنابراین آزمایش‌های نماگرفت باید به‌روزرسانی شوند. برای مثال، با اندازه‌های بزرگ قلم، برش نوشتار را در اینجا می‌بینیم:

• وقتی حاشیه قلم خاموش باشد، دیگر وجود ندارد:

اکنون می‌توانید با ملغی کردن حروف‌چینی در زمینه خود، تنظیم جدید را اتخاذ کنید - کد نمونه را ببینید.

نسخه 1.2.0-alpha09

‫۱۹ آوریل ۲۰۲۳

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

تغییرات میانای برنامه‌سازی کاربردی

• ‫angularSizeDp را به CurvedModifier api برای تنظیم پهنای زاویه‌ای در DP اضافه کنید (I89a52)

رفع اشکال‌ها

• مشکلات دسترس‌پذیری را در نمایش‌های انتخابگر زمان خود(Id0eb7) برطرف کرده‌ایم

نسخه 1.2.0-alpha08

۵ آوریل ۲۰۲۳

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

تغییرات میانای برنامه‌سازی کاربردی

• نام ExpandableItemsState را به ExpandableState تغییر دادیم. (If85ea)
• expandableButton را اضافه کرده‌ایم تا ایجاد دکمه‌ای که وقتی محتوا ازهم باز می‌شود جمع می‌شود ساده‌تر شود و همچنین نمونه‌های ازهم بازشدنی را به‌روز کرده‌ایم. (Iae309)

رفع اشکال‌ها

• نمونه‌های ازهم بازشونده بهبودیافته برای نمایش امکانات بیشتر. پویانمایی expandableItem اصلاح شد تا محتوای آن درطول پویانمایی در مرکز قرار گیرد. (I2f637)
• ‫ToggleControls به‌روزرسانی شد تا هنگام پویانمایی دستی رنگ‌ها بااستفاده از «حالت»، از ترکیب‌های مجدد اضافی جلوگیری شود. (I5d319)

نسخه 1.2.0-alpha07

۲۲ مارس ۲۰۲۳

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

تغییرات میانای برنامه‌سازی کاربردی

• عناصر «مورد ازهم بازشدنی» (اضافه‌شده در نسخه 1.2.0-alpha06) را از material به foundation منتقل کردیم، زیرا هیچ ارجاع معناداری به MaterialTheme نداشتند. (Ib0525)

رفع اشکال‌ها

• خرابی‌ای را که در صفحه‌ای بااستفاده از PickerGroup رخ می‌داد اصلاح کردیم. برای این کار، مطمئن شدیم که وقتی هیچ «انتخابگری» تمرکز ندارد، PickerGroup تمرکز را به‌درستی مدیریت می‌کند. همچنین پشتیبانی از پیمایش RSB را به نمایش‌های «انتخابگر» اضافه کردیم. (If8c19)
• گذار گفتگوی را بهبود بخشیده‌ایم - گذار مقدمه اکنون روان‌تر است تا با گذار پایانی مطابقت داشته باشد. (Ib5af9)
• DefaultTextStyle را به «نوشتن برای Wear» اضافه کرده‌ایم که به‌طور پیش‌فرض ویژگی PlatformTextStyle.includeFontPadding را روی درست تنظیم می‌کند (این تنظیم فعلی است). این کار به ما امکان می‌دهد خاموش کردن پیش‌فرض حاشیه قلم را با کتابخانه‌های «نگارش» در آینده همگام‌سازی کنیم - برای اطلاعات بیشتر، (رفع حاشیه قلم در «نگارش») را ببینید. (I2aee8)
• وابستگی پیش‌نمایش UpsideDownCake ازطریق فعالیت-ترکیب که مانع انتشار برنامه‌ها در «فروشگاه Google Play» می‌شد برگردانده شد. (I6443d)

نسخه 1.2.0-alpha06

۸ مارس ۲۰۲۳

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

تغییرات میانای برنامه‌سازی کاربردی

• عنصر CurvedBox را اضافه کنید که عناصر را روی هم در دنیای منحنی قرار می‌دهد. (I29200)
• افزودن مورد(های) ازهم‌بازشدنی - دو عنصر جدید برای پشتیبانی از گروهی از موارد ازهم‌بازشدنی در ScalingLazyColumn، یا یک مورد ازهم‌بازشدنی واحد، مثل «نوشتار» که تعداد خطوط آن ازهم‌باز می‌شود. (I95dd5)
• برای پیش‌نمایش عناصر ترکیبی در صفحه‌های Wear، حاشیه‌نویسی‌های سفارشی زیر را اضافه کرده‌ایم: WearPreviewSmallRound عنصر ترکیبی را در دستگاه کوچک و گرد پیش‌نمایش می‌کند؛ WearPreviewLargeRound عنصر ترکیبی را در دستگاه بزرگ و گرد پیش‌نمایش می‌کند؛ WearPreviewSquare عنصر ترکیبی را در دستگاه مربعی پیش‌نمایش می‌کند. همچنین، گلچین‌های چندپیش‌نمایش و گلچین‌های زیر: WearPreviewFontScales عناصر ترکیبی را در دستگاه پوشیدنی با اندازه‌های قلم مختلف پیش‌نمایش می‌کند، درحالی‌که WearPreviewDevices عناصر ترکیبی را در دستگاه‌های پوشیدنی مختلف پیش‌نمایش می‌کند. برای استفاده از این پیش‌نمایش‌ها، باید از جدیدترین نسخه Android Studio (Giraffe Canary 6) یا نسخه‌های بالاتر استفاده کنید. لطفاً توجه داشته باشید که اگر این گزارمان‌ها با هدف شما مطابقت ندارند، همچنان می‌توانید از «پیش‌نمایش» استفاده کنید و از سفارشی‌سازی‌های بیشتر ازطریق پارامترها پشتیبانی می‌کند. (I397ff)
• ‫HierarchicalFocusCoordinator را به‌عنوان آزمایشی علامت‌گذاری کرده‌ایم زیرا با توجه به کاربرد گسترده آن، به‌عنوان نامزد انتقال به کتابخانه‌های اصلی Compose درنظر گرفته می‌شود. (I3a768)

رفع اشکال‌ها

• اشکالی در HierarchicalFocusCoordinator برطرف شد. وقتی لامبدای ارسال‌شده برای پارامتر focusEnabled تغییر می‌کند، اکنون به‌درستی از لامبدای جدید استفاده می‌کنیم. (Icb353)
• وقتی از رنگ‌های اصلی به‌عنوان پس‌زمینه در Button،‏ CompactButton،‏ Chip،‏ CompactChip، و ToggleButton استفاده می‌کنید، رنگ پیش‌فرض محتوای غیرفعال را به «پس‌زمینه» به‌روز کرده‌ایم. این کار کنتراست را برای دسترس‌پذیری بهبود می‌بخشد. (I527cc)

نسخه 1.2.0-alpha05

۲۲ فوریه ۲۰۲۳

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

تغییرات میانای برنامه‌سازی کاربردی

• «میانای برنامه کاربردی» PickerGroup به‌روزرسانی شد تا امکان انتشار اختیاری محدودیت‌های حداقل در عناصر ترکیبی فراهم شود. وقتی روی درست تنظیم شود، محدودیت‌های حداقلی که از ترکیب‌کننده والد منتقل شده است در PickerGroup مجاز خواهد بود. اگر روی «نادرست» تنظیم شود، PickerGroup محدودیت‌های حداقل را بازنشانی خواهد کرد. (I3e046)
• ‫animateScrollToOption را به Picker API اضافه کرده‌ایم تا از پویانمایی برنامه‌ریزی‌شده به گزینه Picker خاصی پشتیبانی کنیم (I6fe67)

رفع اشکال‌ها

• ‫HorizontalPageIndicator را به‌روز کرده‌ایم تا از چیدمان‌های راست‌به‌چپ پشتیبانی کند. (Ia4359)
• آزمایش‌های «نماگرفت» برای چیدمان راست‌به‌چپ در HorizontalPageIndicator (I6fbb8) اضافه شد
• آزمایش‌های بیشتری به SwipeDismissableNavHostTest اضافه شد که از TestNavHostController استفاده می‌کنند (I61d54)

نسخه 1.2.0-alpha04

۸ فوریه ۲۰۲۳

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

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

• PickerGroup برای مدیریت چند انتخابگر باهم بااستفاده از میانای برنامه‌سازی کاربردی تمرکز. این کلاس تمرکز بین انتخابگرهای مختلف را مدیریت می‌کند، انتخابگرها را براساس پارامترها به‌طور خودکار در مرکز قرار می‌دهد، و به توسعه‌دهندگان امکان می‌دهد تمرکز بین انتخابگرهای مختلف را درحین مدیریت رویدادهای گروه تغییر دهند. در حالت Talkback،‏ PickerGroup با انتقال تمرکز به «انتخابگر» انتخاب‌شده از گروه، تمرکز Talkback را مدیریت می‌کند. (I60840)

تغییرات میانای برنامه‌سازی کاربردی

• برای تسهیل غیرفعال کردن معناشناسی محدوده پیش‌فرض (Ia61d4)، یک سربار با پارامتر enableRangeSemantics اضافی به «گام‌به‌گام» اضافه کرده‌ایم

رفع اشکال‌ها

• اجازه دهید ScalingLazyColumn در صفحه پیمایش افقی تودرتو شود (Iec3f8، b/266555016)
• بهبود اسناد Stepper kdocs و پاک‌سازی آزمایش‌های StepperTest. (Ic118e)
• وابستگی androidx.navigation به نسخه 2.5.3 (If58ed) به‌روز شد

نسخه 1.2.0-alpha03

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

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

تغییرات میانای برنامه‌سازی کاربردی

• ‫ScalingLazyColumn (و کلاس‌های مرتبط) را از androidx.wear.compose.material.ScalingLazyColumn به andrdoidx.wear.compose.foundation.lazy.ScalingLazyColumn منتقل کرده‌ایم (برای انتقال، این مثال را ببینید). این مکان جدید بیشتر با مکان compose.foundation.lazy.LazyColumn مطابقت دارد و طبیعی‌تر است زیرا جزء Material با نظر شخصی نیست. این تغییر اکنون درحال انجام است تا برای کتابخانه جدید Material3 آماده شود، که به‌موازات کتابخانه Material فعلی روی آن کار خواهیم کرد. (I060e7)

تغییرات زیر بخشی از انتقال ScalingLazyColumn از Material به Foundation.Lazy است:

• ‫PositionIndicator میانای برنامه‌سازی کاربردی که Material ScalingLazyColumn را هدف‌یابی می‌کند منسوخ شده است - لطفاً به Foundation.Lazy ScalingLazyColumn به‌روزرسانی کنید. علاوه‌براین، فیلد anchorType به ScalingLazyListLayoutInfo اضافه شد. (I29d95)
• ‫ScalingLazyColumn در بسته Wear Compose Material (I16d34) به‌عنوان منسوخ علامت‌گذاری شده است
• اصلاح‌گر ScrollAway را به‌روز کرده‌ایم تا از ScalingLazyListState از Wear Compose Foundation.Lazy استفاده کند و بار اضافی که ScalingLazyListState را از Wear Compose Material می‌گرفت منسوخ شده است. (Ifc42c)
• «میاناهای برنامه‌سازی کاربردی» Dialog را به‌روز کرده‌ایم تا از ScalingLazyListState از Foundation.Lazy استفاده کند و سربارهای استفاده‌کننده از Material ScalingLazyListState (Ic8960) را منسوخ کرده‌ایم
• «میاناهای برنامه‌سازی کاربردی انتخابگر» را به‌روز کرده‌ایم تا از ScalingParams از Foundation.Lazy استفاده کند و سربارهای استفاده‌کننده از Material ScalingParams را منسوخ کرده‌ایم. (Idc3d8)

رفع اشکال‌ها

• با اطمینان از اینکه به‌روزرسانی‌ها فقط زمانی ارسال می‌شوند که مقدار واقعاً تغییر کند، اشکالی را که باعث بازآرایی‌های غیرضروری در ScalingLazyListState.centerItemIndex می‌شد برطرف کردیم (Ia9f38)
• عملکرد SwipeToDismissBox را بهبود داده‌ایم (I3933b)
• آزمایش‌های معیار برای ScalingLazyColumn در Wear Compose Foundation (Ie00f9) اضافه شد
• برخی‌از روش‌های کلاس‌های داخلی ScalingLazyColumn را در Material به‌روز کرده‌ایم تا از معادل‌های آن‌ها در Foundation.Lazy استفاده کنیم (I38aab)
• برخی‌از مشکلات را در آزمایش‌های «انتخابگر» برطرف کرده‌ایم و آزمایش‌های بیشتری برای بررسی پیمایش با جبران اضافه کرده‌ایم (I6ac34)
• «نمونه‌های یکپارچه‌سازی ScalingLazyColumn» را انتقال دادیم تا به‌جای Material ScalingLazyColumn (Ic6caa) به Foundation.Lazy وابسته باشد
• پارامترهای اختیاری fromDate/toDate را به نسخه نمایشی DatePicker خود (I961cd) اضافه کرده‌ایم

نسخه 1.2.0-alpha02

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

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

تغییرات میانای برنامه‌سازی کاربردی

• آزمایش‌های «میانای کاربر Android Compose» اکنون هنگام اجرای قاب‌ها برای رسیدن به حالت آماده به‌کار (برای نمونه ازطریق waitForIdle)، گذر چیدمان را برای هر قاب اجرا می‌کنند. این موضوع ممکن است بر آزمایش‌هایی که قاب‌های تکی پویانمایی‌های چیدمان را تأیید می‌کنند تأثیر بگذارد. (I8ea08، b/222093277)
• پارامتر minLines به «نوشتار Wear» اضافه شده است تا با BasicText رفتار یکسانی داشته باشد (I24874)
• ‫CompactChipTapTargetPadding عمومی شده است تا در مستندات نشان داده شود (If1e70، b/234119038)

رفع اشکال‌ها

• غیرفعال کردن ساخت‌های چندسکویی برای wear.compose بسته (Iad3d7)
• رفع اشکال kdocs برای scrollToOption (I6f9a0)
• ‫PlaceholderState.rememberPlaceholderState() به‌روز شد تا از rememberUpdatedState استفاده کند تا وضعیت درصورت onContentReady لامبدا به‌روز شود. (I02635، b/260343754)
• با بهره‌گیری از استراتژی ترکیب جدید اضافه‌شده به Modifier.graphicsLayer، مشکل لرزش متن مشاهده‌شده در عنصر Picker را برطرف کرده‌ایم. (I99302)
• اشکالی را که باعث پرش در نسخه نمایشی DatePicker ما می‌شد (I660bd) برطرف کرده‌ایم
• دسترس‌پذیری را برای نمایش‌های برگزیننده تاریخ و زمان ۱۲ ساعته (I05e12) بهبود داده‌ایم
• نمونه‌های نمایشی انتخابگر زمان و تاریخ را به‌روز کرده‌ایم تا انتخابگرها هنگام لغو انتخاب تحت تأثیر تغییرات RSB قرار نگیرند (I4aecb)

نسخه 1.2.0-alpha01

۷ دسامبر ۲۰۲۲

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

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

• عملکرد آزمایشی «جای‌بان» را به‌روز کرده‌ایم تا جلوه «پاک کردن» بلافاصله پس‌از آماده شدن محتوا اعمال شود و منتظر شروع حلقه پویانمایی بعدی نماند. همچنین برخی به‌روزرسانی‌ها را در پویانمایی‌های درخشش و پاک کردن انجام داده‌ایم. (I5a7f4)

تغییرات میانای برنامه‌سازی کاربردی

• HierarchicalFocusCoordinatorعنصری ترکیبی اضافه کرده‌ایم تا امکان علامت‌گذاری زیردرخت‌های ترکیب به‌عنوان فعال‌کننده تمرکز یا غیرفعال‌کننده تمرکز را فراهم کند.(I827cb)
• دارایی جدیدی برای ملغی کردن نقش معنایی ToggleButton اضافه کرده‌ایم.(I67132)
• ‫TimeTextDefaults.TimeFormat12Hours را به‌روز کرده‌ایم تا AM/PM را در TimeText برداریم. این کار مقدار پیش‌فرض پارامترهای timeSource را در TimeText API تغییر می‌دهد. (I1eb7f)
• «میانای برنامه‌سازی کاربردی انتخابگر» را گسترش داده‌ایم تا دسترسی‌پذیری را برای صفحه‌نمایش‌های دارای انتخابگر چندگانه بهبود دهیم. دارایی جدیدی به‌نام userScrollEnabled وجود دارد که کنترل می‌کند انتخابگر برای پیمایش کاربر فعال باشد یا نه. (I3c3aa)

رفع اشکال‌ها

• عرض پیش‌فرض حاشیه OutlinedButton/OutlinedCompactButton را از ۲.dp به ۱.dp تغییر دادیم تا با مشخصات نهایی تجربه کاربری مطابقت داشته باشد. (Icf84d)
• برای کاهش اثر اولین موردی که به ScalingLazyColumn خالی اضافه می‌شود و به‌نظر می‌رسد در جای خود پیمایش می‌کند، وقتی محتوا خالی است autoCentering topPadding تخمینی اضافه کرده‌ایم. این تغییر با فرض اینکه ارتفاع مورد اولیه ۰.dp است، مقدار بالشتک بالای موردنیاز را محاسبه می‌کند. برای ScalingLazyListAnchorType.ItemStart، این کار باعث محاسبه درست بالشتک بالا می‌شود، اما برای ScalingLazyListAnchorType.ItemCenter این محاسبه درست نخواهد بود زیرا برای اندازه‌گیری درست محتوا به ارتفاع عناصر نیاز است که درنتیجه براساس ارتفاع واقعی عناصر، پیمایش کوچکی در محل ایجاد می‌شود.(I239a4)
• ما زمینه تیره اعمال‌شده روی پویانمایی SwipeToDismiss را به‌روز کرده‌ایم تا با پلاتفرم Wear مطابقت داشته باشد. (I9003e)
• برای جلوگیری از خطاهای تقسیم بر صفر، نحوه مدیریت PositionIndicator برای LazyListState و ScalingLazyListState را برای فهرست‌های با اندازه ۰ اصلاح کرده‌ایم.(Ic28dd)

نسخه ۱.۱

نسخه ۱.۱.۲

۸ فوریه ۲۰۲۳

‫androidx.wear.compose:compose-foundation:1.1.2،‏ androidx.wear.compose:compose-material:1.1.2، و androidx.wear.compose:compose-navigation:1.1.2 منتشر شدند. نسخه ۱.۱.۲ حاوی این تعهدات است.

رفع اشکال‌ها

• با اطمینان از اینکه به‌روزرسانی‌ها فقط زمانی ارسال می‌شوند که مقدار واقعاً تغییر کند، اشکالی را که باعث بازآرایی‌های غیرضروری در ScalingLazyListState.centerItemIndex می‌شد برطرف کردیم (Ia9f38)

نسخه ۱.۱.۱

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

‫androidx.wear.compose:compose-foundation:1.1.1،‏ androidx.wear.compose:compose-material:1.1.1، و androidx.wear.compose:compose-navigation:1.1.1 منتشر شدند. نسخه ۱.۱.۱ حاوی این تعهدات است.

رفع اشکال‌ها

• ‫PlaceholderState.rememberPlaceholderState() به‌روز شد تا از rememberUpdatedState استفاده کند تا وضعیت درصورت onContentReady لامبدا به‌روز شود. (I02635، b/260343754)

نسخه ۱.۱.۰

۷ دسامبر ۲۰۲۲

‫androidx.wear.compose:compose-foundation:1.1.0،‏ androidx.wear.compose:compose-material:1.1.0، و androidx.wear.compose:compose-navigation:1.1.0 منتشر شدند. نسخه ۱.۱.۰ حاوی این تعهدات است.

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

• نسخه پایدار Compose for Wear OS 1.1.0 (بیشتر بخوانید).
• برای مشاهده فهرست تغییرات کلیدی در Wear Compose 1.1، یادداشت‌های انتشار (Compose for Wear OS 1.1 Beta01) را ببینید.

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

• عملکرد آزمایشی «جای‌بان» را به‌روز کرده‌ایم تا جلوه «پاک کردن» بلافاصله پس‌از آماده شدن محتوا اعمال شود و منتظر شروع حلقه پویانمایی بعدی نماند. همچنین برخی به‌روزرسانی‌ها را در پویانمایی‌های درخشش و پاک کردن انجام داده‌ایم. (I5a7f4)

رفع اشکال‌ها

• عرض پیش‌فرض حاشیه OutlinedButton/OutlinedCompactButton را از ۲.dp به ۱.dp تغییر دادیم تا با مشخصات نهایی تجربه کاربری مطابقت داشته باشد. (Icf84d)
• برای کاهش اثر اولین موردی که به ScalingLazyColumn خالی اضافه می‌شود و به‌نظر می‌رسد در جای خود پیمایش می‌کند، وقتی محتوا خالی است autoCentering topPadding تخمینی اضافه کرده‌ایم. این تغییر با فرض اینکه ارتفاع مورد اولیه ۰.dp است، مقدار بالشتک بالای موردنیاز را محاسبه می‌کند. برای ScalingLazyListAnchorType.ItemStart، این کار باعث محاسبه درست بالشتک بالا می‌شود، اما برای ScalingLazyListAnchorType.ItemCenter این محاسبه درست نخواهد بود زیرا برای اندازه‌گیری درست محتوا به ارتفاع عناصر نیاز است که درنتیجه براساس ارتفاع واقعی عناصر، پیمایش کوچکی در محل ایجاد می‌شود.(I239a4)
• ما زمینه مات اعمال‌شده روی پویانمایی SwipeToDismiss را به‌روز کرده‌ایم تا با پلاتفرم Wear مطابقت داشته باشد.(I9003e)
• برای جلوگیری از خطاهای تقسیم بر صفر، نحوه مدیریت PositionIndicator برای LazyListState و ScalingLazyListState را برای فهرست‌های با اندازه ۰ اصلاح کرده‌ایم.(Ic28dd)

نسخه 1.1.0-rc01

۹ نوامبر ۲۰۲۲

‫androidx.wear.compose:compose-foundation:1.1.0-rc01،‏ androidx.wear.compose:compose-material:1.1.0-rc01، و androidx.wear.compose:compose-navigation:1.1.0-rc01 منتشر شدند. نسخه 1.1.0-rc01 حاوی این تعهدات است.

رفع اشکال‌ها

• قوانین نمایه پایه را برای Placeholders، ScrollAway، RadioButton، Switch، Checkbox، OutlinedButton، OutlinedCompactButton، OutlinedChip، و OutlinedCompactChip اضافه کرده‌ایم. (I8249c)
• اشکالی را در Modifier.scrollAway برطرف کرده‌ایم تا اگر itemIndex مشخص‌شده نامعتبر باشد (برای مثال، اگر شاخص مورد خارج از محدوده باشد)، TimeText همچنان نمایش داده شود. (I2137a)
• پویانمایی SwipeToDismissBox را به‌روز کرده‌ایم تا با پیاده‌سازی پلاتفرم مطابقت داشته باشد. پس‌از پویانمایی فشرده‌سازی اولیه، اکنون با راه‌اندازی بستن، صفحه به سمت راست می‌لغزد. (I41d34)
• به‌عنوان بهینه‌سازی، Modifier.scrollAway را به‌روز کرده‌ایم تا فقط scrollState را در بلوک اندازه‌گیری بخواند تا پس‌از هر اندازه‌گیری مجدد، اصلاح‌گر را دوباره ترکیب نکند. (I4c6f1)
• برای نشان دادن ترتیب صحیح Modifier.placeholder و Modifier.placeholderShimmer هنگام اعمال شدن روی یک عنصر ترکیبی، مستندات و نمونه‌ای به جای‌بان‌ها اضافه کرده‌ایم. (Ie96f4، b/256583229)
• عرض پیش‌فرض حاشیه OutlinedCompactChip/OutlinedChip را از ۲.dp به ۱.dp تغییر دادیم تا با مشخصات نهایی تجربه کاربری مطابقت داشته باشد. (Ib3d8e)
• اشکالی را در rememberPickerState برطرف کرده‌ایم که در آن ورودی‌های به‌روزرسانی‌شده ذخیره نمی‌شدند، بنابراین عناصر ترکیبی پس‌از تغییر ورودی‌ها به‌روزرسانی نمی‌شدند. (I49ff6، b/255323197)
• چند به‌روزرسانی در واسط کاربری جای‌بان‌ها انجام داده‌ایم: ۱) گرادیان درخشش را به ۱٫۵ برابر اندازه صفحه تغییر داده‌ایم، ۲) تسهیل (بزیر مکعبی) پیشرفت درخشش را اضافه کرده‌ایم، و ۳) پویانمایی پاک‌سازی را تسریع کرده‌ایم (۲۵۰ میلی‌ثانیه). (Id29c1)
• اشکال رابط کاربری در جلوه «پاک‌کردن» جای‌بان را اصلاح کرده‌ایم. در این اشکال، پس‌زمینه‌های «تراشه» و «کارت» به‌دلیل درنظر نگرفتن موقعیت عنصر روی صفحه، کمی زودتر پاک می‌شدند. (I2c7cb)
• طراحی پس‌زمینه جای‌بان را به‌روز کرده‌ایم تا درصورت امکان رنگ‌ها را ادغام کند و نه لایه‌بندی کند تا خطر ترکیب آلفای لایه‌های برش‌خورده مختلف را کاهش دهیم و از نفوذ رنگ‌های زیرین در لبه‌های پس‌زمینه جای‌بان جلوگیری کنیم. (I2ea26)
• محاسبه ScalingLazyListState.centerItemIndex/centerItemOffset را اصلاح کرده‌ایم تا اگر دو عنصر در دو طرف خط مرکزی درگاه دید قرار بگیرند، عنصری که نزدیک‌تر است به‌عنوان centerItem درنظر گرفته شود. (I30709، b/254257769)
• اشکالی را در ScalingLazyListState.layoutInfo.visibleItemsInfo که درطول مقداردهی اولیه ScalingLazyColumn افست‌های نادرستی گزارش می‌کرد اصلاح کردیم. اکنون تا زمانی که همه عناصر فهرست نمایان شوند و افست‌های صحیح را داشته باشند، فهرست خالی برگردانده می‌شود. بررسی ScalingLazyListState.layoutInfo.visibleItemsInfo.isNotEmpty() تأیید می‌کند که مقداردهی اولیه ScalingLazyColumn کامل شده است و موارد قابل‌مشاهده هستند. (I3a3b8)

نسخه 1.1.0-beta01

‫۲۴ اکتبر ۲۰۲۲

‫androidx.wear.compose:compose-foundation:1.1.0-beta01،‏ androidx.wear.compose:compose-material:1.1.0-beta01، و androidx.wear.compose:compose-navigation:1.1.0-beta01 منتشر شدند. نسخه 1.1.0-beta01 حاوی این تعهدات است.

محتویات Compose برای Wear OS نسخه ۱.۱

نسخه 1.1.0-beta01 از Compose برای Wear OS نشان داد که این نسخه پخش کتابخانه دارای ویژگی‌های کامل است و API قفل شده است.

• نسخه پخش Wear Compose 1.1 شامل عملکرد جدید زیر است:
  • انتخاب‌گر - بهبودهای دسترس‌پذیری در «انتخاب‌گر» به‌طوری‌که صفحه‌های انتخاب‌گر چندگانه با صفحه‌خوان‌ها پیمایش‌پذیر باشند و شرح محتوا دردسترس باشد
  • پارامتر Picker contentDescription اکنون فقط برای گزینه Picker انتخاب‌شده استفاده می‌شود و یک «رشته» تهی‌پذیر می‌گیرد (در تعهد قبلی، لازم بود نگاشتی از گزینه به شرح محتوا ارسال شود، اما فقط از گزینه انتخاب‌شده استفاده می‌شد).
  • اکنون عناصر انتخابگر همیشه در مرکز تراز می‌شوند و اشکالی که در آن تنظیم gradientRatio روی صفر باعث تغییر تراز می‌شد برطرف شده است.
  • Chip/ToggleChip - گرادیان‌های پیش‌فرض Chip/ToggleChip را به‌روز کرده‌ایم تا با جدیدترین مشخصات تجربه کاربری هماهنگ شوند. ChipDefaults.gradientBackgroundChipColors به‌روز شده است تا به‌جای ‎٪۳۲٫۵ از ‎٪۵۰ رنگ اصلی شروع شود.
  • ‫Chip/ToggleChip - سربار برای اصلاح شکل‌های «تراشه» اضافه شد
  • Chip/Button/ToggleButton - سبک جدیدی با خطوط محیطی برای «تراشه‌ها» و «دکمه‌ها» و عناصر ترکیبی جدید OutlinedChip و OutlinedButton اضافه شد که Chip/Button شفاف با حاشیه نازک ارائه می‌دهد.
  • کارت - گرادیان‌های پیش‌فرض «کارت‌ها» به‌روزرسانی شد تا با جدیدترین مشخصات تجربه کاربری هماهنگ شود. CardDefaults.cardBackgroundPainter به‌روزرسانی شد تا از ۳۰٪ رنگ اصلی شروع شود و به ۲۰٪ رنگ onSurfaceVariant ختم شود (قبلاً از ۲۰٪ تا ۱۰٪ onSurfaceVariant بود). ToggleChip.toggleChipColors از گرادیان خطی ۷۵٪ سطح به ۳۲٫۵٪ رنگ اصلی به ۰٪ سطح به ۵۰٪ رنگ اصلی تغییر می‌کند.
  • ‫Button/ToggleButton - خصوصیت‌هایی برای اصلاح شکل دکمه اضافه شد.
  • زمینه - تعدادی از رنگ‌های پیش‌فرض در MaterialTheme به‌روزرسانی شد تا دسترس‌پذیری بهبود یابد زیرا رنگ‌های اصلی کنتراست کافی نداشتند و کاربران در تشخیص پس‌زمینه‌های تراشه/کارت/دکمه از رنگ پس‌زمینه زمینه دچار مشکل می‌شدند.
  • InlineSlider/Stepper - نقش‌های دکمه اضافه شد تا Talkback بتواند آن‌ها را به‌عنوان دکمه تشخیص دهد.
  • داربست - PositionIndicator اکنون در موقعیت و اندازه مناسب قرار گرفته است تا فقط فضای موردنیاز را اشغال کند. برای مثال، اگر اطلاعات معنایی به آن اضافه شود، TalkBack اکنون مرزهای صحیح PositionIndicator را در صفحه دریافت می‌کند.
  • ‫CurvedText/TimeText - Modifier.scrollAway اضافه شد که براساس وضعیت پیمایش، مورد را به‌صورت عمودی به داخل/خارج نمای پیمایش می‌کند (با سرباره‌هایی برای کار با Column، LazyColumn، و ScalingLazyColumn). معمولاً از ScrollAway برای پیمایش TimeText به خارج از نما استفاده می‌شود، زیرا کاربر شروع به پیمایش فهرست موارد به بالا می‌کند.
  • ‫CurvedText/TimeText - پشتیبانی از fontFamily،‏ fontStyle، و fontSynthesis در CurvedTextStyle اضافه شد، در curvedText و basicCurvedText قابل‌استفاده است
  • ‫CurvedText/TimeText - fontWeight را به سازنده و روش کپی در CurvedTextStyle اضافه کرد
  • ‫ToggleControls - کنترل‌های روشن/خاموش پویانمایی‌شده Checkbox،‏ Switch، و RadioButton را برای استفاده با ToggleChip و SplitToggleChip اضافه کرد. می‌توان از این نمادها به‌جای نمادهای ثابت ارائه‌شده توسط ToggleChipDefaults (switchIcon، checkboxIcon، و radioIcon) استفاده کرد.
  • جای‌بان - پشتیبانی آزمایشی جای‌بان اضافه شد. این جلوه سه اثر دیداری متمایز دارد که برای کار کردن با یکدیگر طراحی شده‌اند.
  • ابتدا جلوه قلم‌موی پس‌زمینه جای‌بان که در محتویاتی مثل «تراشه» و «کارت» استفاده می‌شود تا هنگام انتظار برای بار شدن محتوا روی پس‌زمینه معمولی طراحی کند.
  • دوم، یک اصلاح‌کننده (Modifier.placeholder()) برای کشیدن ابزاره جای‌بان به‌شکل ورزشگاه در بالای محتوایی که درحال بار شدن است.
  • سوم، یک جلوه گرادیان/درخشش اصلاح‌کننده (Modifier.placeholderShimmer()) که روی جلوه‌های دیگر کشیده می‌شود تا به کاربران نشان دهد که منتظر بار شدن داده‌ها هستیم.
    • همه این جلوه‌ها به‌گونه‌ای طراحی شده‌اند که به‌صورت هماهنگ و درخشان و محو شوند.
• وابستگی‌های اصلی Compose از ۱.۲ به ۱.۳ به‌روز شد

تغییرات میانای برنامه‌سازی کاربردی

• اکنون می‌توان پارامترهای قلم (fontFamily،‏ fontWeight،‏ fontStyle، و fontSynthesis) را مستقیماً به‌عنوان پارامترهای curvedText (Idc422) مشخص کرد

رفع اشکال‌ها

• ‫curveText و basicCurvedText اکنون با TalkBack به‌درستی کار می‌کنند (گره compose-ui با اندازه و مکان مناسب (اما خالی) به آن‌ها منسوب شده است و از نوشتار به‌عنوان شرح محتوا استفاده می‌کند) (I7af7c،‏ b/210721259)
• رفع اشکال Picker وقتی PickerState.repeatedItems = false برای افزودن تنظیم صریح پارامترهای autoCentering در ScalingLazyColumn داخلی «انتخابگرها» برای اطمینان از اینکه امکان پیمایش گزینه صفرم به مرکز نما وجود دارد. (I8a4d7)

نسخه 1.1.0-alpha07

۵ اکتبر ۲۰۲۲

‫androidx.wear.compose:compose-foundation:1.1.0-alpha07،‏ androidx.wear.compose:compose-material:1.1.0-alpha07، و androidx.wear.compose:compose-navigation:1.1.0-alpha07 منتشر شدند. نسخه 1.1.0-alpha07 حاوی این تعهدات است.

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

• از جای‌بان آزمایشی پشتیبانی کرده‌ایم. این جلوه سه اثر دیداری متمایز دارد که برای کار کردن با یکدیگر طراحی شده‌اند. ابتدا جلوه قلم‌موی پس‌زمینه جای‌بان که در محتویاتی مثل «تراشه» و «کارت» استفاده می‌شود تا هنگام انتظار برای بار شدن محتوا روی پس‌زمینه معمولی طراحی کند. دوم، یک اصلاح‌کننده (Modifier.placeholder()) برای کشیدن ابزاره جای‌بان به‌شکل ورزشگاه در بالای محتوایی که درحال بار شدن است. سوم، یک جلوه گرادیان/درخشش اصلاح‌کننده (Modifier.placeholderShimmer()) که روی جلوه‌های دیگر کشیده می‌شود تا به کاربران نشان دهد که منتظر بار شدن داده‌ها هستیم. همه این جلوه‌ها به‌گونه‌ای طراحی شده‌اند که به‌صورت هماهنگ و با درخشش و پاک‌سازی به‌شیوه‌ای ارکسترال اجرا شوند. (I3c339)

تغییرات میانای برنامه‌سازی کاربردی

• پشتیبانی از fontWeight،‏ fontFamily،‏ fontStyle، و fontSynthesis در CurvedTextStyle اضافه شد، در curvedText و basicCurvedText قابل‌استفاده است. از این پارامتر می‌توان برای مشخص کردن قلم و سبک مورد استفاده در نوشتار منحنی استفاده کرد.(Iaa1a8)،(I72759)
• پارامتر جابه‌جایی Modifier.scrollAway به Dp به‌روزرسانی شد تا با Modifier.offset هماهنگ باشد (قبلاً برحسب پیکسل بود). همچنین، برای بهره‌وری به‌عنوان LayoutModifier بازسازی شد. (I9f94b)
• به‌عنوان بخشی از «میانای برنامه‌سازی کاربردی» کنترل‌های جدید کلید تغییر وضعیت، نام RadioButton’s circleColor را به ringColor تغییر داده‌ایم. (I28fa9)
• کنترل‌های کلید Checkbox، Switch، و RadioButton متحرک را برای استفاده با ToggleChip و SplitToggleChip اضافه کرده‌ایم. می‌توان از این نمادها به‌جای نمادهای ایستا که ToggleChipDefaults ارائه می‌دهد (switchIcon، checkboxIcon، و radioIcon) استفاده کرد. (I8a8c4)

نسخه 1.1.0-alpha06

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

‫androidx.wear.compose:compose-foundation:1.1.0-alpha06،‏ androidx.wear.compose:compose-material:1.1.0-alpha06، و androidx.wear.compose:compose-navigation:1.1.0-alpha06 منتشر شدند. نسخه 1.1.0-alpha06 شامل این تعهدات است.

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

• ‫Modifier.scrollAway را اضافه کرده‌ایم که براساس وضعیت پیمایش، موردی را به‌صورت عمودی به داخل/خارج از نما پیمایش می‌کند (با سرباره‌هایی برای کار با Column، LazyColumn، و ScalingLazyColumn). معمولاً از ScrollAway برای پیمایش TimeText به خارج از نما استفاده می‌شود، زیرا کاربر شروع به پیمایش فهرست موارد به بالا می‌کند. (I61766)

رفع اشکال‌ها

• PositionIndicator اکنون در موقعیت و اندازه‌ای قرار گرفته است که فقط فضای موردنیاز را اشغال می‌کند. برای مثال، اگر اطلاعات معنایی به آن اضافه شود، TalkBack اکنون مرزهای صحیح PositionIndicator را در صفحه دریافت می‌کند. (Ie6106،‏ b/244409133)

نسخه 1.1.0-alpha05

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

‫androidx.wear.compose:compose-foundation:1.1.0-alpha05،‏ androidx.wear.compose:compose-material:1.1.0-alpha05، و androidx.wear.compose:compose-navigation:1.1.0-alpha05 منتشر شدند. نسخه 1.1.0-alpha05 حاوی این تعهدات است.

رفع اشکال‌ها

• نقش‌های دکمه به InlineSlider و Stepper اضافه شد تا Talkback بتواند آن‌ها را به‌عنوان دکمه تشخیص دهد. (Icb46c، b/244260275)
• ترتیب z نشانگرهای موقعیت و صفحه را در «داربست» اصلاح کرده‌ایم. اکنون نشانگرها در بالای وینیت قرار می‌گیرند و بنابراین اگر وینیت وجود داشته باشد، نشانگرها توسط آن پوشیده نمی‌شوند. (Ib988f، b/244207528)

نسخه 1.1.0-alpha04

۲۴ اوت ۲۰۲۲

‫androidx.wear.compose:compose-foundation:1.1.0-alpha04،‏ androidx.wear.compose:compose-material:1.1.0-alpha04، و androidx.wear.compose:compose-navigation:1.1.0-alpha04 منتشر شدند. نسخه 1.1.0-alpha04 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

• تعدادی از رنگ‌های پیش‌فرض در MaterialTheme را به‌روز کرده‌ایم تا دسترسی‌پذیری را بهبود دهیم زیرا رنگ‌های اصلی کنتراست کافی نداشتند و درنتیجه کاربران در تشخیص پس‌زمینه‌های تراشه/کارت/دکمه از رنگ پس‌زمینه زمینه دچار مشکل می‌شدند. رنگ‌های به‌روزشده عبارت‌اند از surface(0xFF202124->0xFF303133)، onPrimary(0xFF202124->0xFF303133)، onSecondary(0xFF202124->0xFF303133)، primaryVariant(0xFF669DF6->0xFF8AB4F8)، و onError(0xFF202124->0xFF000000). تغییرات رنگ‌ها، اگرچه نسبتاً ظریف هستند، ممکن است بر آزمایش‌های نماگرفت کنونی تأثیر بگذارند. (81ab09)

رفع اشکال‌ها

• اشکال منطقی در ScalingLazyColumn را برطرف کنید که می‌تواند منجر به فهرست‌هایی با تعداد کمی (معمولاً دقیقاً ۲) از عناصر فهرست شود که مقداردهی اولیه را تکمیل نمی‌کنند و در نتیجه شفاف می‌شوند. (504347)

نسخه 1.1.0-alpha03

۱۰ اوت ۲۰۲۲

‫androidx.wear.compose:compose-foundation:1.1.0-alpha03،‏ androidx.wear.compose:compose-material:1.1.0-alpha03، و androidx.wear.compose:compose-navigation:1.1.0-alpha03 منتشر شدند. نسخه 1.1.0-alpha03 حاوی این تعهدات است.

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

• سبک جدیدی با خطوط پیرامونی برای Chips و Buttons و عناصر ترکیبی جدید OutlinedChip و OutlinedButton اضافه کرده‌ایم که Chip/Button شفافی با حاشیه نازک ارائه می‌دهد. (Id5972)

تغییرات میانای برنامه‌سازی کاربردی

• سربار برای اصلاح شکل دکمه (Icccde) اضافه شد

رفع اشکال‌ها

• اندازه ناحیه کنترل دکمه ToggleChip را اصلاح کردیم زیرا با مشخصات تجربه کاربری آن مطابقت نداشت. «مشخصات تجربه کاربری» خواستار فاصله ۴ پیکسل بین برچسب و ناحیه نماد کنترل دکمه ۲۴×۲۴ پیکسل است که در مجموع عرض ۲۸ پیکسل را ارائه می‌دهد. بااین‌حال، پیاده‌سازی به‌اشتباه ناحیه کنترل کلید 36x24.dp را ارائه می‌دهد. این کار باعث می‌شود ۸ نقطه از فضای برچسب نوشتاری قابل‌استفاده گرفته شود. توجه: این رفع اشکال فضای بیشتری برای برچسب نوشتاری فراهم می‌کند و درنتیجه می‌تواند بر چیدمان نوشتار برای نوشتار سرریز (مثبت) تأثیر بگذارد. اگر آزمایش‌های نماگرفت دارید که شامل ToggleChips است، ممکن است لازم باشد آن‌ها را به‌روزرسانی کنید. (I514c8،‏ b/240548670)

نسخه 1.1.0-alpha02

۲۷ ژوئیه ۲۰۲۲

‫androidx.wear.compose:compose-foundation:1.1.0-alpha02،‏ androidx.wear.compose:compose-material:1.1.0-alpha02، و androidx.wear.compose:compose-navigation:1.1.0-alpha02 منتشر شدند. نسخه 1.1.0-alpha02 شامل این تعهدها است.

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

• وابستگی‌های Compose برای Wear OS را در کتابخانه‌های اصلی Compose از نسخه ۱.۲.۰ به نسخه ۱.۳.۰-alpha0X تغییر داده‌ایم

تغییرات میانای برنامه‌سازی کاربردی

• سربار برای اصلاح شکل‌های تراشه اضافه شد (I02e87)

رفع اشکال‌ها

• برای هماهنگی با پویانمایی مقیاس‌بندی موجود، رؤیت‌پذیری ویگنت را هنگام نمایش/پنهان کردن «کادر گفتگو» پویانمایی کرده‌ایم. (Ida33e)
• اشکالی را که در آن تقسیم بر صفر ممکن بود با برخی‌از رفتارهای پرتاب هنگام پیمایش رخ دهد برطرف کردیم. (I86cb6)
• اشکالی در ChipDefaults.childChipColor() برطرف شد تا اطمینان حاصل شود که رنگ پس‌زمینه غیرفعال کاملاً شفاف است. ‫(I2b3c3، b/238057342)

نسخه 1.1.0-alpha01

۲۹ ژوئن ۲۰۲۲

‫androidx.wear.compose:compose-foundation:1.1.0-alpha01،‏ androidx.wear.compose:compose-material:1.1.0-alpha01، و androidx.wear.compose:compose-navigation:1.1.0-alpha01 منتشر شدند. نسخه 1.1.0-alpha01 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

• پارامتر contentDescription «انتخابگر» اکنون فقط برای گزینه «انتخابگر» انتخاب‌شده استفاده می‌شود و «رشته» تهی‌پذیر می‌گیرد (قبلاً لازم بود نگاشتی از گزینه به شرح محتوا ارسال شود، اما فقط از گزینه انتخاب‌شده استفاده می‌شد). (Ife6a7)
• به «انتخابگر» بهبودهایی در زمینه دسترس‌پذیری اضافه کرده‌ایم تا صفحه‌های انتخابگر چندگانه با صفحه‌خوان‌ها پیمایش‌پذیر باشند و شرح محتوا دردسترس باشد (I64edb)

رفع اشکال‌ها

• قوانین نمایه پایه بسته‌بندی‌شده با کتابخانه Wear Compose (I9c694) را به‌روز کرده‌ایم
• جهت گرادیان «تراشه‌ها» را در حالت راست‌به‌چپ اصلاح کرده‌ایم. قبلاً از بالا سمت چپ به پایین سمت راست بود، اکنون از بالا سمت راست به پایین سمت چپ است. (Ic2e77)
• گرادیان‌های پیش‌فرض برای Chip/ToggleChip/Card را به‌روز کرده‌ایم تا با جدیدترین مشخصات تجربه کاربری هم‌راستا شوند. ChipDefaults.gradientBackgroundChipColors به‌روز شده است تا به‌جای ۳۲٫۵٪ از ۵۰٪ رنگ اصلی شروع شود. ‫CardDefaults.cardBackgroundPainter به‌روز شده است تا از ۳۰٪ رنگ اصلی شروع شود و در ۲۰٪ رنگ onSurfaceVariant پایان یابد (قبلاً از ۲۰٪ تا ۱۰٪ رنگ onSurfaceVariant بود). ToggleChip.toggleChipColors از گرادیان خطی ۷۵٪ سطح به ۳۲٫۵٪ رنگ اصلی به ۰٪ سطح به ۵۰٪ رنگ اصلی تغییر می‌کند. (I43bbd)
• برای اطمینان از اینکه Chip/ToggleChips با پس‌زمینه‌های گرادیانی درصورت استفاده از رنگ روشن در پس‌زمینه به‌درستی قابل‌مشاهده باشند، رنگ پس‌زمینه‌ای (MaterialTheme.color.surface) به آن‌ها اضافه کرده‌ایم. (Ibe1a4،‏ b/235937657)
• اکنون عناصر انتخابگر همیشه در مرکز تراز می‌شوند و اشکالی که در آن تنظیم gradientRatio روی صفر باعث تغییر تراز می‌شد برطرف شده است. (I712b8)

نسخه 1.0

نسخه ۱.۰.۲

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

‫androidx.wear.compose:compose-foundation:1.0.2،‏ androidx.wear.compose:compose-material:1.0.2، و androidx.wear.compose:compose-navigation:1.0.2 منتشر شدند. نسخه 1.0.2 حاوی این تعهدات است.

رفع اشکال‌ها

• ترتیب z نشانگرهای موقعیت و صفحه را در «داربست» اصلاح کرده‌ایم. اکنون نشانگرها در بالای وینیت قرار می‌گیرند و بنابراین اگر وینیت وجود داشته باشد، نشانگرها توسط آن پوشیده نمی‌شوند. (Ib988f، b/244207528)

نسخه ۱.۰.۱

۲۴ اوت ۲۰۲۲

‫androidx.wear.compose:compose-foundation:1.0.1،‏ androidx.wear.compose:compose-material:1.0.1، و androidx.wear.compose:compose-navigation:1.0.1 منتشر شدند. نسخه 1.0.1 شامل این تعهدات است.

رفع اشکال‌ها

• اشکال منطقی در ScalingLazyColumn را برطرف کنید که می‌تواند منجر به عدم تکمیل مقداردهی اولیه فهرست‌هایی با تعداد کمی (معمولاً دقیقاً ۲) از عناصر فهرست شود و در نتیجه شفاف باشد. (076c61)

نسخه ۱.۰.۰

۲۷ ژوئیه ۲۰۲۲

‫androidx.wear.compose:compose-foundation:1.0.0،‏ androidx.wear.compose:compose-material:1.0.0، و androidx.wear.compose:compose-navigation:1.0.0 منتشر شدند. نسخه ۱.۰.۰ حاوی این تعهدات است.

ویژگی‌های اصلی نسخه 1.0.0

• این اولین نسخه پخش پایدار «نوشتن» برای Wear OS است (بیشتر بخوانید).
• ‫Compose برای Wear OS برپایه کتابخانه‌های اصلی Compose ساخته شده است و اجزای اضافی ویژه پوشیدنی‌ها و، درصورت لزوم، پیاده‌سازی‌های جایگزین اجزای اصلی Compose را که برای دستگاه‌های پوشیدنی سفارشی‌سازی شده‌اند ارائه می‌دهد.
• برای مشاهده فهرست عناصر اصلی در Wear Compose، یادداشت‌های انتشار (Compose for Wear OS Beta01) را ببینید.

رفع اشکال‌ها

• برای هماهنگی با پویانمایی مقیاس‌بندی موجود، رؤیت‌پذیری ویگنت را هنگام نمایش/پنهان کردن «کادر گفتگو» پویانمایی کرده‌ایم. (Ida33e)
• اشکالی را که در آن تقسیم بر صفر ممکن بود با برخی‌از رفتارهای پرتاب هنگام پیمایش رخ دهد برطرف کردیم. (I86cb6)
• اشکالی در ChipDefaults.childChipColor() برطرف شد تا اطمینان حاصل شود که رنگ پس‌زمینه غیرفعال کاملاً شفاف است. ‫(I2b3c3، b/238057342)

نسخه 1.0.0-rc02

‫۲۲ ژوئن ۲۰۲۲

‫androidx.wear.compose:compose-foundation:1.0.0-rc02،‏ androidx.wear.compose:compose-material:1.0.0-rc02، و androidx.wear.compose:compose-navigation:1.0.0-rc02 منتشر شدند. نسخه 1.0.0-rc02 حاوی این تعهدها است.

رفع اشکال‌ها

• جهت گرادیان «کارت‌ها» را در حالت راست‌به‌چپ (RTL) اصلاح کرده‌ایم. قبلاً از بالا سمت راست به پایین سمت چپ بود و اکنون از بالا سمت چپ به پایین سمت راست است. (Ic2e77)
• گرادیان‌های پیش‌فرض برای Chip/ToggleChip/Card را به‌روز کرده‌ایم تا با جدیدترین مشخصات تجربه کاربری هم‌راستا شوند. ChipDefaults.gradientBackgroundChipColors به‌روز شده است تا به‌جای ۳۲٫۵٪ از ۵۰٪ رنگ اصلی شروع شود. ‫CardDefaults.cardBackgroundPainter به‌روز شده است تا از ۳۰٪ رنگ اصلی شروع شود و در ۲۰٪ رنگ onSurfaceVariant پایان یابد (قبلاً از ۲۰٪ تا ۱۰٪ در «متغیر سطح» بود). ‫ToggleChip.toggleChipColors از گرادیان خطی ۷۵٪ سطح به ۳۲٫۵٪ اصلی به ۰٪ سطح به ۵۰٪ اصلی تغییر می‌کند. (I43bbd)
• رنگ پس‌زمینه‌ای (MaterialTheme.color.surface) به پشت Chip/ToggleChips که پس‌زمینه‌های گرادیانی دارند اضافه کرده‌ایم تا مطمئن شویم که درصورت استفاده از رنگ روشن در پشت آن‌ها، به‌درستی قابل‌مشاهده باشند. (Ibe1a4، b/235937657)
• قوانین نمایه پایه بسته‌بندی‌شده با کتابخانه Wear Compose (I9c694) را به‌روز کرده‌ایم

نسخه 1.0.0-rc01

۱۵ ژوئن ۲۰۲۲

‫androidx.wear.compose:compose-foundation:1.0.0-rc01،‏ androidx.wear.compose:compose-material:1.0.0-rc01، و androidx.wear.compose:compose-navigation:1.0.0-rc01 منتشر شدند. نسخه 1.0.0-rc01 حاوی این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

• میاناهای کتابخانه‌های Compose اکنون بااستفاده از روش‌های میانای پیش‌فرض jdk8 ساخته می‌شوند (I5bcf1)

رفع اشکال‌ها

• فراخوانی صریح fillMaxWidth() را در سرصفحه فهرست برداشته‌ایم زیرا لازم نیست و اگر ScalinglazyColumn ترکیبی از عناصر ListHeader() و Chip() داشته باشد می‌تواند مشکل ایجاد کند زیرا با پیمایش عناصر ListHeader به داخل/خارج نما، عرض تمایل به افزایش/کاهش خواهد داشت. (I37144،‏ b/235074035)
• اشکالی را در ScalingLazyColumn برطرف کرده‌ایم که درصورت بزرگ بودن کافی عنصر فهرست ۰ (ازجمله حاشیه)، می‌توانست باعث شود عناصر فهرست تا زمانی که پیمایش نشده‌اند به‌درستی رسم نشوند (Ic6159، b/234328517)
• برای مطابقت با به‌روزرسانی‌های مشخصات تجربه کاربری، وقتی عناصر به لبه صفحه می‌رسند، در ScalingLazyColumn تسهیلات تغییر کوچکی ایجاد کرده‌ایم. مقادیر قدیمی CubicBezierEasing(0.25f, 0.00f, 0.75f, 1.00f) -> مقادیر جدید CubicBezierEasing(0.3f, 0f, 0.7f, 1f). برای حفظ رفتار قدیمی، می‌توانید scalingParams مربوط به ScalingLazyColumn (Ie375c) را ملغی کنید
• به CompactChip حاشیه اضافه کرده‌ایم تا مطمئن شویم اندازه هدف لمسی آن حداقل ۴۸ پیکسل مستقل از تراکم باشد و با رهنمودهای دسترس‌پذیری Material مطابقت داشته باشد. این کار ممکن است بر چیدمان‌هایی که از CompactChips استفاده می‌کنند تأثیر بگذارد زیرا فضای بیشتری را اشغال خواهند کرد. (I3d57c)

نسخه 1.0.0-beta03

۱ ژوئن ۲۰۲۲

‫androidx.wear.compose:compose-foundation:1.0.0-beta03،‏ androidx.wear.compose:compose-material:1.0.0-beta03، و androidx.wear.compose:compose-navigation:1.0.0-beta03 منتشر شدند. نسخه 1.0.0-beta03 شامل این تعهدات است.

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

• ‫ScalingLazyColumn را در حالت «نوشتن» @Preview فعال کرده‌ایم. (I3b3b6، b/232947354)

تغییرات میانای برنامه‌سازی کاربردی

• برای اطمینان از اینکه وقتی عناصر فهرست کل پهنای ستون را پر نمی‌کنند برای حداکثر رؤیت‌پذیری تراز شوند، مقدار پیش‌فرض دارایی ScalingLazyColumn.horizontalAlignment را از «شروع» به CenterHorizontally تغییر داده‌ایم. برای بازگشت به مجموعه رفتار قبلی horizontalAlignment = Alignment.Start.(I9ed4b)

مشکلات شناخته‌شده

• ارتفاع ضربه/لمس CompactChip کوچک‌تر از دستورالعمل‌های دسترس‌پذیری Material است. این مورد در نسخه پخش بعدی (۱۵ ژوئن) اصلاح خواهد شد. اگر از CompactChip استفاده می‌کنید، این کار بر چیدمان‌های شما تأثیر می‌گذارد زیرا CompactChip اکنون در بالا و پایین دارای فضای خالی اضافی خواهد بود. لطفاً چیدمان‌هایتان را اصلاح و آزمایش کنید یا برای استفاده از رفتار موجود، نظرات اشکال را برای راهکار موقت ببینید. (b/234332135)

رفع اشکال‌ها

• نمونه نمایشی جدید برای پویانمایی افزودن یا برداشتن نوشتار شروع در TimeText. (I16d75)
• افزودن آزمون برای HorizontalPageIndicator.PagesState (I64ed0)
• درحال به‌روزرسانی TimeText برای نزدیک‌تر شدن به مشخصات تجربه کاربری (Ib7ea1)

نسخه 1.0.0-beta02

‫۱۸ مه ۲۰۲۲

‫androidx.wear.compose:compose-foundation:1.0.0-beta02،‏ androidx.wear.compose:compose-material:1.0.0-beta02، و androidx.wear.compose:compose-navigation:1.0.0-beta02 منتشر شدند. نسخه 1.0.0-beta02 شامل این تعهدات است.

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

• انتخاب‌گر اکنون همیشه به رویدادهای پیمایش پاسخ می‌دهد، حتی وقتی در حالت فقط خواندنی باشد. به‌این‌ترتیب، کاربران دیگر لازم نیست قبل‌از پیمایش، ابتدا با تک‌ضرب زدن «انتخابگر» را انتخاب کنند. در حالت فقط خواندنی، گزینه‌هایی به‌جز گزینه انتخاب‌شده فعلی با یک لایه در gradientColor مبهم می‌شوند. (I72925)
• رفتار تجربه کاربری Chip/ToggleChip/CompactChip/SplitToggleChip را تغییر داده‌ایم تا به‌طور پیش‌فرض fillMaxWidth را انجام ندهد. درعوض، اندازه آن‌ها متناسب با محتوایشان بزرگ می‌شود. برای حفظ رفتار قبلی، کافی است modifier = Modifier.fillMaxWidth()(I60a2c، b/232206371) را اضافه کنید

رفع اشکال‌ها

• سازنده CurvedTextStyle که اکنون TextStyle را می‌گیرد، fontWeight را نیز رعایت می‌کند(این ممکن است در بازبینی‌های آتی میانای برنامه‌سازی کاربردی به سازنده و روش‌های کپی اضافه شود) (Ieebb9)
• بهبود تند کشیدن از لبه. وقتی از Modifier.edgeSwipeToDismiss استفاده می‌شود و تند کشیدن به چپ از ناحیه لبه‌ای راه‌اندازی می‌شود، دیگر با تغییر جهت تند کشیدن به راست، تند کشیدن برای بستن راه‌اندازی نمی‌شود. قبلاً، با تند کشیدن به‌چپ و سپس تند کشیدن به‌راست، می‌شد تند کشیدن برای بستن را راه‌اندازی کرد.(I916ea)
• ‫HorizontalPageIndicator اکنون حداکثر ۶ صفحه را در صفحه‌نمایش نشان می‌دهد. اگر درمجموع بیش‌از ۶ صفحه وجود داشته باشد، نشانگر نیم‌اندازه‌ای در سمت چپ یا راست نشان داده می‌شود و بین صفحات انتقال نرمی انجام می‌شود.(I2ac29)
• بهبود رفتار پیش‌فرض چسباندن در ScalingLazyColumn و Picker (I49539)
• بهبود تند کشیدن از لبه. وقتی از Modifier.edgeSwipeToDismiss استفاده می‌شود، تند کشیدن برای بستن فقط زمانی فعال می‌شود که اولین لمس در لبه صفحه انجام شود و به راست تند کشیده شود. قبلاً امکان فعال کردن تند کشیدن برای بستن با تند کشیدن از هر قسمت صفحه وجود داشت، به‌شرطی که پیمایش به ابتدا برسد.(I8ca2a)

نسخه 1.0.0-beta01

۱۱ مه ۲۰۲۲

‫androidx.wear.compose:compose-foundation:1.0.0-beta01،‏ androidx.wear.compose:compose-material:1.0.0-beta01، و androidx.wear.compose:compose-navigation:1.0.0-beta01 منتشر شدند. نسخه 1.0.0-beta01 شامل این تعهدات است.

محتویات Compose برای Wear OS 1.0

1.0.0-beta01 «ترکیب برای Wear OS» نقطه عطفی مهم محسوب می‌شود زیرا کتابخانه دارای ویژگی کامل و میانای برنامه‌سازی کاربردی قفل‌شده است.

عناصر «مواد Compose ویژه پوشیدنی‌ها» در نسخه ۱.۰ شامل موارد زیر است:

• «زمینه Material» - به‌عنوان جایگزینی برای Compose for Mobile MaterialTheme استفاده می‌شود، رنگ‌ها، اشکال، و طرح حروف را برای ساختن عناصر در «پوشیدنی‌ها» که دستورالعمل‌های «تجربه کاربری طراحی مواد Wear» را ازپیش پیاده‌سازی می‌کنند ارائه می‌دهد.
• ‫Button،‏ CompactButton، و ToggleButton - دکمه یک جایگاه برای قرار دادن نماد، تصویر، یا نوشتار کوتاه (حداکثر ۳ نویسه) ارائه می‌دهد. دایره‌ای شکل با اندازه‌های توصیه‌شده برای دکمه‌های پیش‌فرض، بزرگ، یا کوچک. ‫CompactButton یک جایگاه واحد برای قرار دادن هر نوع محتوایی (نماد، تصویر، یا نوشتار) ارائه می‌دهد و شکل آن دایره‌ای است و اندازه پس‌زمینه آن بسیار کوچک است. ‫CompactButton در اطراف پس‌زمینه خود حاشیه شفاف اختیاری دارد که ناحیه کلیک‌کردنی را افزایش می‌دهد. ‫ToggleButton دکمه‌ای است که یک جایگاه برای قرار دادن هر محتوایی (نوشتار کوتاه، نماد، یا تصویر) ارائه می‌دهد و وضعیت روشن/خاموش (علامت‌دار/بدون علامت) با رنگ‌آمیزی و نمادهای مختلف دارد تا نشان دهد علامت‌دار است یا نه
• کارت‌ها - برای نمایش اطلاعات درباره برنامه‌هایی مثل اعلان‌ها استفاده می‌شود. طراحی انعطاف‌پذیر برای موارد استفاده مختلف با AppCard و TitleCard که چیدمان‌های مختلف و پشتیبانی از تصاویر را به‌عنوان محتوای کارت یا پس‌زمینه ارائه می‌دهند.
• تراشه‌ها - اجزای استادیومی شکل شبیه به دکمه‌ها، اما با مساحت بزرگ‌تر و چند شکاف برای امکان برچسب‌ها، برچسب‌های ثانویه و نمادها. در اندازه‌های مختلف و با پشتیبانی از تصاویر به‌عنوان پس‌زمینه.
• ‫ToggleChips و SplitToggleChips - تراشه‌ای با وضعیت انتخاب‌شده/انتخاب‌نشده و افزودن ToggleControl جایگاه برای نمایش نمادی مثل کلید یا دکمه رادیویی برای نشان دادن وضعیت انتخاب‌شده عنصر. علاوه‌براین، SplitToggleChip دو ناحیه تک‌ضرب‌زدنی دارد، یکی کلیک‌کردنی و دیگری روشن/خاموش‌کردنی.
• CircularProgressIndicator - نشانگر پیشرفت «طراحی مواد» ویژه Wear با دو نوع مختلف. اولی نسبت تکمیل یک تکلیف جاری را بیان می‌کند و از شکاف در مسیر دایره‌ای بین زاویه‌های شروع و پایان پشتیبانی می‌کند. دومی نشان‌دهنده پیشرفت نامشخص برای زمان انتظار نامشخص است.
• curvedText - بخشی از «زبان مدل‌سازی خاص» برای توصیف CurvedLayouts است، که به‌همراه curvedRow و curvedColumn برای چیدن عناصر در اطراف دستگاه‌های دایره‌ای استفاده می‌شود. برای جزئیات بیشتر درباره CurvedLayout و CurvedModifier (این مورد نقش مشابهی با «اصلاح‌کننده‌ها» در دنیای غیرمنحنی دارد و امکان پیکربندی جنبه‌های مختلف چیدمان، حاشیه‌گذاری، گرادیان‌ها، و غیره را فراهم می‌کند)، «پایه مؤلفه Wear» را در زیر ببینید.
• کادر گفتگو، هشدار، و تأیید - کادر گفتگو یک کادر گفتگوی تمام‌صفحه را نمایش می‌دهد که روی هر محتوای دیگری لایه‌بندی شده است و از کشیدن برای بستن پشتیبانی می‌کند. یک جایگاه واحد می‌گیرد که انتظار می‌رود محتوای کادر گفتگوی «طراحی مواد» Wear با نظر شخصی باشد، مثل «هشدار» یا «تأیید». هشدار محتوای گفتگوی نظرگرایانه با جایگاه‌هایی برای نماد، عنوان، و پیام است. این کارت دارای سربار برای دو دکمه منفی و مثبت است که در کنار هم نشان داده می‌شوند یا دارای جایگاهی برای یک یا چند تراشه عمودی روی هم چیده شده است. تأیید محتوای کادر گفتگوی نظرگرایانه‌ای است که پیامی را برای مدت معینی نمایش می‌دهد. جایی برای نماد یا تصویر (که می‌تواند پویانمایی شود) دارد.
• HorizontalPageIndicator - موقعیت افقی صفحه را به روشی مناسب برای ضریب شکل «پوشیدنی» نشان می‌دهد. طراحی‌شده برای اشغال کل صفحه و نمایش نشانگر منحنی در دستگاه‌های گرد. می‌تواند با نمایشگر صفحه «همراه» استفاده شود.
• نماد - پیاده‌سازی Wear از «نماد» که رنگ و آلفا را از «زمینه Wear Material» می‌گیرد. برای نماد کلیک‌کردنی، «دکمه» یا «تراشه» را ببینید.
• گزینشگر - فهرستی پیمایش‌شدنی از موارد را نمایش می‌دهد که می‌توانید از میان آن‌ها انتخاب کنید. به‌طور پیش‌فرض، موارد در هر دو جهت «بی‌نهایت» تکرار خواهند شد. می‌تواند در حالت فقط خواندنی نمایش داده شود تا گزینه‌های انتخاب‌نشده پنهان شود.
• PositionIndicator - موقعیت پیمایش یا نشانگر موقعیت دیگری را به روشی مناسب با عامل فرم «پوشیدنی» نشان می‌دهد. طراحی‌شده برای اشغال کل صفحه و نمایش نشانگر منحنی در دستگاه‌های گرد.
• داربست - ساختار چیدمان دیداری پایه «طراحی سه‌بعدی Wear» را پیاده‌سازی می‌کند. این عنصر یک API ارائه می‌دهد تا چندین عنصر Wear Material (مثل TimeText، PositionIndicator، و Vignette) را که صفحه را می‌سازند کنار هم قرار دهد، استراتژی چیدمان مناسب را برای آن‌ها تضمین کند، و داده‌های لازم را جمع‌آوری کند تا این عناصر به‌درستی با هم کار کنند.
• ‫ScalingLazyColumn - عنصر فهرست پیمایشی مقیاس‌بندی/چشم‌ماهی که بخش کلیدی زبان «طراحی مواد» Wear را تشکیل می‌دهد. جلوه‌های مقیاس‌بندی و شفافیت را به عناصر محتوا ارائه می‌دهد. ‫ScalingLazyColumn به‌گونه‌ای طراحی شده است که بتواند تعداد بالقوه زیادی از عناصر محتوا را مدیریت کند، عناصری که فقط درصورت نیاز مادی و ترکیب می‌شوند.
• لغزنده - به کاربران امکان می‌دهد از میان طیف وسیعی از مقادیر انتخاب کنند. محدوده انتخاب‌ها به‌صورت یک نوار نشان داده می‌شود که درصورت تمایل می‌تواند با جداکننده‌ها نمایش داده شود.
• «گام‌به‌گام» - عنصر تمام‌صفحه‌ای که به کاربران امکان می‌دهد بااستفاده از دکمه‌های افزایش/کاهش در بالا و پایین صفحه، از میان طیف مقادیر انتخاب کنند، و در وسط آن جایگاهی برای «نوشتار» یا «تراشه» وجود دارد.
• SwipeToDismissBox - اشاره تند کشیدن برای بستن را مدیریت می‌کند. این کارت یک جایگاه برای پس‌زمینه (فقط درحین اشاره تند نمایش داده می‌شود) و محتوای پیش‌زمینه می‌گیرد. بااستفاده از SwipeDismissableNavHost می‌توان آن را به‌صورت اختیاری با کتابخانه پیمایش androidx ترکیب کرد (به کتابخانه «پیمایش Wear Compose» در زیر مراجعه کنید).
• نوشتار - پیاده‌سازی Wear از عنصر «نوشتار Compose Material» که رنگ و آلفا را از «زمینه Wear Material» می‌گیرد
• TimeText - عنصری برای نمایش زمان و وضعیت برنامه در بالای صفحه. بااستفاده از نوشتار منحنی در صفحه‌های گرد، با شکل صفحه تنظیم می‌شود.

• ویگنت - یک پردازش صفحه برای استفاده در «داربست» که هنگام استفاده از محتوای پیمایش‌پذیر، بالا و پایین صفحه را محو می‌کند.

• عناصر زیر نیز از «پایه Wear Compose» اضافه شده است:

• ‫CurvedLayout - Wear Foundation CurvedLayout یک عنصر ترکیبی چیدمان است که فرزندانش را در یک کمان قرار می‌دهد و درصورت نیاز آن‌ها را می‌چرخاند. این شبیه چیدمان «ردیفی» است که به بخش حلقه‌ای خم شده است. توجه داشته باشید که محتوای CurvedLayout یک لامبدای ترکیبی نیست - بلکه یک DSL (زبان خاص دامنه) است. همه عناصر در DSL مربوط به CurvedLayout از پارامتر اصلاح‌کننده اختیاری که از CurvedModifier ایجاد شده است پشتیبانی می‌کنند.

• basicCurvedText - عنصری در CurvedLayout DSL، basicCurvedText به توسعه‌دهندگان اجازه می‌دهد به‌راحتی نوشتار منحنی را با پیروی از انحنای دایره (معمولاً در لبه صفحه‌نمایش دایره‌ای) بنویسند. basicCurvedText فقط می‌تواند در CurvedLayout ایجاد شود تا بهترین تجربه را تضمین کند، مثلاً بتوانید جایگاه را مشخص کنید و از CurvedModifiers استفاده کنید. توجه داشته باشید که در اکثر موارد باید از curvedText استفاده شود، زیرا از زمینه‌سازی Material استفاده می‌کند.

• curvedComposable - محتوای ترکیب‌پذیر معمولی را می‌پیچد تا بتواند با CurvedLayout استفاده شود. اگر curvedComposable چندین عنصر در داخل داشته باشد، این عناصر روی هم کشیده می‌شوند (مانند «جعبه»). برای قرار دادن چند عنصر ترکیب‌پذیر در امتداد یک منحنی، هرکدام را با curvedComposable بپیچید.

• curvedRow و curvedColumn - مشابه Row و Column، curvedRow و curvedColumn می‌توانند در CurvedLayout تودرتو باشند تا عناصر را درصورت نیاز چیدمان کنند. برای curvedRow، ممکن است جهت چیدمان زاویه‌ای و تراز شعاعی مشخص شود. برای curvedColumn، ممکن است تراز زاویه‌ای و جهت شعاعی مشخص شود.

• CurvedModifier - همه عناصر منحنی پارامتر اصلاح‌گری را می‌پذیرند که می‌تواند بااستفاده از CurvedModifier ایجاد شود: پس‌زمینه، اندازه، وزن، و لایه‌گذاری پشتیبانی می‌شوند.

• مؤلفه زیر نیز از Wear Compose Navigation اضافه شده است:

• SwipeDismissableNavHost - مکانی در سلسله‌مراتب Compose برای ناوبری خوداتکا فراهم می‌کند، و ناوبری به عقب با اشاره تند کشیدن ارائه می‌شود. محتوا در SwipeToDismissBox نمایش داده می‌شود و سطح پیمایش فعلی را نشان می‌دهد. درطول اشاره تند به‌سمت بیرون، سطح پیمایش قبلی (درصورت وجود) در پس‌زمینه نشان داده می‌شود.

• برای جزئیات بیشتر درباره آنچه ارائه شده است، یادداشت‌های انتشار قبلی را برای نسخه‌های مختلف آلفا ببینید.

تغییرات میانای برنامه‌سازی کاربردی

• ‫CurvedModifier.padding* تابع اضافه شد. از این‌ها برای مشخص کردن فضای اضافی که باید در اطراف یک عنصر منحنی اضافه شود استفاده می‌شود. (I4dbb4)
• ‫CompositionLocal کلاس داخلی (I42490) برداشته شد
• مقادیر ثابتی برای اندازه‌های نماد Button، CompactButton، و ToggleButton به‌عنوان راهنمایی اضافه کرده‌ایم (I57cab)
• پارامتر فعال را به AppCard و TitleCard اضافه کنید. اکنون آن‌ها میانای برنامه‌سازی کاربردی مشابهی با «کارت‌های androidx.compose.material» دارند. وقتی پارامتر روی «نادرست» تنظیم شود، کارت کلیک‌کردنی نخواهد بود. (Idc48d، b/228869805)

رفع اشکال‌ها

• اکنون وقتی به حد پایین/بالا می‌رسید، «گام‌به‌گام» دکمه‌های کاهش و افزایش را غیرفعال می‌کند (و ContentAlpha.disabled را به iconColor اعمال می‌کند) (I4be9f)
• وقتی محتوای «انتخابگر» با گرادیان رسم می‌شود، در اطراف آن 1dp حاشیه اضافه کرده‌ایم تا از لرزش نوشتار هنگام تند کشیدن جلوگیری شود. (I0b7b9)
• افزودن آزمایش‌های نماگرفت برای PositionIndicator (I5e8bc)
• آزمایش‌های بیشتری برای AppCard و TitleCard اضافه کنید (I85391،‏ b/228869805)

نسخه 1.0.0-alpha21

‫۲۰ آوریل ۲۰۲۲

‫androidx.wear.compose:compose-foundation:1.0.0-alpha21،‏ androidx.wear.compose:compose-material:1.0.0-alpha21، و androidx.wear.compose:compose-navigation:1.0.0-alpha21 منتشر شدند. نسخه 1.0.0-alpha21 شامل این تعهدات است.

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

• اصلاح‌کننده‌های منحنی جدیدی برای مشخص کردن پس‌زمینه عنصر منحنی اضافه شد: CurvedModifier.background، .radialGradientBackground، و .angularGradientBackground (I8f392)
• اجازه می‌دهد حالت سرریز نوشتار منحنی (برش/حذف/نمایان) مشخص شود. (I8e7aa)
• ‫CurvedModifier.weight اصلاح‌گر اضافه شد، مشابه اصلاح‌گر موجود در «نوشتن». این ویژگی را می‌توان برای فرزندان curvedRow و CurvedLayout (برای عرض) و فرزندان curvedColumn (برای ارتفاع) استفاده کرد. (I8abbd)
• ‫CurvedModifier.size،‏ .angularSize، و .radialSize اصلاح‌گر اضافه شد تا اندازه عنصر منحنی را مشخص کند. (I623c7)

تغییرات میانای برنامه‌سازی کاربردی

• پارامترها را دوباره مرتب کنید تا مطمئن شوید که پس‌زمینه به‌طور پیوسته قبل‌از رنگ در «میانای برنامه‌سازی کاربردی Wear Compose» قرار می‌گیرد (I43208)
• پارامترهای insideOut و در جهت عقربه‌های ساعت برداشته شد و با ثابت‌های گویاتر در کلاس‌های جدید جایگزین شد. اکنون جهت چیدمان منحنی می‌تواند از LayoutDirection آگاه باشد و درصورت مشخص نشدن، به ارث می‌رسد (If0e6a)
• ‫autoCenter: Boolean را با autoCenter: AutoCentringParams جایگزین کردیم تا مشکل میانای برنامه‌سازی کاربردی ScalingLazyColumn را برطرف کنیم. (Ia9c90)
• نام iconTintColor و toggleControlTintColor را در سراسر «میانای برنامه‌سازی کاربردی» به iconColor و toggleControlColor تغییر داده‌ایم (تراشه/تراشه کلیدی/چارگوش گفتگو/لغزنده/گام‌به‌گام/ …) زیرا رنگ به جایگاه نماد/کنترل کلیدی اعمال می‌شود. (Ied238)
• بازنویسی عدد ثابت PageIndicatorStyle به کلاس مقدار (I2dc72)
• RowScope/ColumnScope/BoxScope را به برخی‌از جایگاه‌های «عناصر ترکیبی» خود اضافه کرده‌ایم تا به توسعه‌دهندگان نشان دهیم فرضیه‌های چیدمان چیست. این کار به توسعه‌دهندگان امکان می‌دهد از اصلاح‌کننده‌های اضافی در برخی‌از محتوای جای آگهی استفاده کنند و از نیاز به ارائه عناصر چیدمان اضافی جلوگیری کنند. علاوه‌براین، به‌روزرسانی‌های جزئی در رنگ‌های AppCard/TitleCard انجام داده‌ایم تا timeColor و appColor به‌طور پیش‌فرض روی contentColor تنظیم شوند. درصورت نیاز، این دارایی‌ها همچنان می‌توانند به‌صورت جداگانه لغو شوند. (I26b59)
• ‫SwipeToDismissBoxState.Companion شیء خصوصی شد (I39e84)
• ترتیب پارامترها را برای InlineSlider و Stepper اصلاح کنید. تغییری ساده برای پیروی از رهنمودهای api (I11fec)
• «شیء ذخیره‌کننده» را برای SwipeToDismissBoxState برداشته‌ایم زیرا استفاده نشده است. (Ifb54e)
• ‫CompactChip را به‌روز کرده‌ایم تا با «مشخصات تجربه کاربری» جدید هماهنگ شود. حاشیه به افقی = ۱۲.dp و عمودی = ۰.dp کاهش یافته است. قلم برچسب از دکمه به عنوان۱ تغییر کرده است. اندازه‌های توصیه‌شده برای نماد ۲۰x۲۰ درصورتی‌که هم نماد و هم برچسب وجود داشته باشد و ۲۴x۲۴ برای تراشه فشرده فقط نماد است. برای مورد استفاده فقط نماد، همچنین مطمئن شده‌ایم که نماد در مرکز تراز شده باشد. (Iea2be)
• تعدادی فیلد جدید به ScalingLazyListLayoutInfo اضافه کرده‌ایم تا توسعه‌دهندگان بتوانند مقدار contentPadding و autoCenteringPadding اعمال‌شده را بدانند. این‌ها می‌توانند هنگام محاسبه پرتاب/پیمایش برای توسعه‌دهندگان مفید باشند (I7577b)
• گذار ورودی/خروجی را برای «کادر گفتگو» پیاده‌سازی کرده‌ایم. پارامتر showDialog اضافه شده است و اکنون «کادر گفتگو» رؤیت‌پذیری خودش را کنترل می‌کند (این کار باعث می‌شود «کادر گفتگو» بتواند پویانمایی‌های آغاز و پایان را هنگام نمایش/پنهان شدن «کادر گفتگو» اجرا کند). توجه داشته باشید که پویانمایی پایانی زمانی اجرا نمی‌شود که کاربر ازطریق کشیدن برای بستن از کادر گفتگو خارج شود. همچنین مقدار پیش‌فرضی برای وضعیت در SwipeToDismissBox سرریز که اخیراً اضافه شده است اضافه کرده‌ایم. (I682a0)
• برای پشتیبانی بهتر از i18n و a11y، ToggleChip و SplitToggleChip را تغییر داده‌ایم تا دیگر برای جایگاه toggleControl پیش‌فرض نداشته باشند. همچنین ToggleChipDefaults را تغییر داده‌ایم تا روش‌های زیر اکنون به‌جای «نماد»، «بردار تصویر» برگردانند (توجه داشته باشید که چون دیگر @Composables برنمی‌گردانند، با حروف کوچک شروع می‌شوند)، SwitchIcon()->switchIcon()، CheckboxIcon->checkboxIcon()، و RadioIcon()->radioIcon() - این کار به توسعه‌دهندگان امکان می‌دهد و آن‌ها را تشویق می‌کند تا با مجموعه contentDescription مناسب، عناصر ترکیبی Icon() خودشان را ایجاد کنند. (I5bb5b)
• پارامتر SwipeDismissableNavHostState را به SwipeDismissableNavHost اضافه کردیم. این ویژگی از استفاده از کشیدن از لبه در صفحه‌هایی که به‌عنوان مقصد پیمایش استفاده می‌شوند پشتیبانی می‌کند، زیرا اکنون می‌توان SwipeToDismissBoxState را بالا برد و از آن برای مقداردهی اولیه SwipeDismissableNavHostState و Modifier.edgeSwipeToDismiss در صفحه‌هایی که به کشیدن از لبه نیاز دارند استفاده کرد. (I819f5، b/228336555)

رفع اشکال‌ها

• مطمئن شوید چیدمان‌های منحنی درصورت نیاز به‌روزرسانی شوند. (Ie8bfa، b/229079150)
• رفع اشکال برای https://issuetracker.google.com/issues/226648931 (Ia0a0a، b/226648931)
• حاشیه‌نویسی‌های آزمایشی غیرضروری برداشته شد (I88d7e)

نسخه 1.0.0-alpha20

‫۶ آوریل ۲۰۲۲

‫androidx.wear.compose:compose-foundation:1.0.0-alpha20،‏ androidx.wear.compose:compose-material:1.0.0-alpha20، و androidx.wear.compose:compose-navigation:1.0.0-alpha20 منتشر شدند. نسخه 1.0.0-alpha20 حاوی این تعهدات است.

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

• افزودن اصلاح‌گر edgeSwipeToDismiss برای SwipeToDismiss. اجازه می‌دهد swipeToDismiss فقط در لبه سمت راست نمای درگاه فعال باشد. وقتی مرکز صفحه باید بتواند صفحه‌بندی افقی را مدیریت کند، مثلاً پیمایش دوبعدی «نقشه» یا تند کشیدن افقی بین صفحه‌ها، از این ویژگی استفاده می‌شود.(I3fcec، b/200699800)

تغییرات میانای برنامه‌سازی کاربردی

• پیاده‌سازی پایه CurvedModifiers، این امر راه را برای معرفی روش‌هایی برای سفارشی‌سازی محتوای منحنی باز می‌کند (اما هنوز CurvedModifiers ارائه نشده است و امکان ایجاد اصلاح‌کننده‌های سفارشی ممکن است بعداً دردسترس قرار گیرد) (I9b8df)
• مستندات اصلاح‌کننده EdgeSwipeو به‌روزرسانی مقادیر پیش‌فرض برای درک بهتر .(I6d00d)
• جای PageIndicator را به Scaffold اضافه کنید. با افزودن PageIndicator مستقیماً به Scaffold، می‌توانیم مطمئن شویم که به‌درستی در دستگاه‌های دایره‌ای نمایش داده می‌شود. ‫(Ia6042)
• «نمادهای» پیش‌فرض را از InlineSlider و پارامترهای «گام‌به‌گام» بردارید. این کار به توسعه‌دهندگان کمک می‌کند تا به الزامات بومی‌سازی و دسترس‌پذیری توجه بیشتری داشته باشند. در نمایش‌های نمونه و نمونه‌ها، موارد استفاده از نمادهای پیش‌فرض نشان داده شده است. (I7e6fd)
• جایگزین کردن نام‌های پارامتر «پیشرو» و «پیرو» با «شروع» و «پایان» در TimeText (Iaac32)
• یک SwipeToDismissBox سرریز با پارامتر onDismissed اضافه کرده‌ایم تا از استفاده رایج از راه‌اندازی رویداد پیمایش پس‌از تکمیل اشاره تند پشتیبانی کنیم. (I50353، b/226565726)
• ‫ExperimentalWearMaterialApi گزارمان از TimeText پروانه (Ide520) برداشته شد
• واسط‌های اطلاعات و محدوده ScalingLazyList/Column را به‌عنوان مهروموم‌شده علامت‌گذاری کرده‌ایم زیرا برای توسعه‌دهندگان خارجی درنظر گرفته نشده است و این کار به ما امکان می‌دهد در آینده بدون تغییرات باینری مخرب، اعضای جدیدی به آن‌ها اضافه کنیم. (I7d99f)
• دارایی جدید flingBehaviour را به «انتخابگر» و روش PickerDefaults.flingBehaviour() را برای فعال کردن پیکربندی رفتار پرتاب کردن، مثل افزودن پشتیبانی از RSB، اضافه کرده‌ایم. ‫PickerState اکنون رابط ScrollableState را پیاده‌سازی می‌کند. (Ib89c7)

رفع اشکال‌ها

• قوانین نمایه پایه «زمان اجرای Android» (ART) را برای کتابخانه‌های Wear Compose به‌روزرسانی کنید. ‫ART می‌تواند از قوانین نمایه در دستگاه‌ها استفاده کند تا زیرمجموعه خاصی از برنامه را ازقبل گردآوری کند و عملکرد برنامه را بهبود دهد. توجه داشته باشید که این کار هیچ تأثیری بر برنامه‌های اشکال‌زدایی‌شدنی نخواهد داشت. (Iaa8ef)
• بهبود مستندات (I2c051)

نسخه 1.0.0-alpha19

۲۳ مارس ۲۰۲۲

‫androidx.wear.compose:compose-foundation:1.0.0-alpha19،‏ androidx.wear.compose:compose-material:1.0.0-alpha19، و androidx.wear.compose:compose-navigation:1.0.0-alpha19 منتشر شدند. نسخه 1.0.0-alpha19 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

• نام CurvedRow به CurvedLayout تغییر کرد و برای تبدیل شدن به حوزه با DSL بازطراحی شد. بااستفاده از این DSL، چیدمان‌های منحنی پیچیده‌تر را می‌توان بااستفاده از مجموعه‌ای از curvedRow و curvedColumn تودرتو مشخص کرد (که معادل چیدمان منحنی «ردیف» و «ستون» هستند). درون این عناصر چیدمان، می‌توان از سه عنصر استفاده کرد: curvedComposable (برای افزودن هر @Composable)، basicCurvedText (نوشتار منحنی پایه)، و curvedText (نوشتار منحنی آگاه از مواد Wear). (Ib776a)
• طرف PositionIndicator را قابل‌پیکربندی کنید. اکنون می‌توان موقعیت «نشانگر موقعیت» پایه را به‌گونه‌ای پیکربندی کرد که «پایان» (آگاه از جهت چیدمان)، «مخالف RSB» (چرخش صفحه را درنظر می‌گیرد تا در مقابل RSB فیزیکی قرار گیرد)، یا «چپ و راست مطلق» باشد. (I2f1f3)
• برای SwipeToDismissBox، نام SwipeDismissTarget.Original را به SwipeToDismissValue.Default و SwipeDismissTarget.Dismissal را به SwipeToDismissValue.Dismissed تغییر داده‌ایم. همچنین SwipeToDismissBoxDefaults.BackgroundKey و SwipeToDismissBoxDefaults.ContentKey را به‌ترتیب به SwipeToDismissKeys.Background و SwipeToDismissKeys.Content منتقل کرده‌ایم. (I47a36)
• حالت فقط خواندنی را به «انتخابگر» اضافه کرده‌ایم، برای صفحه‌هایی که چند «انتخابگر» دارند و در هر زمان فقط یک «انتخابگر» قابل‌ویرایش است. وقتی «انتخابگر» فقط خواندنی باشد، گزینه انتخابی فعلی و برچسب را (درصورت وجود) نمایش می‌دهد. (I879de)
• ‫SwipeToDismissBoxState برای محدود کردن محدوده ExperimentalWearMaterialApi به Modifier.swipeable و SwipeableState، که اکنون به‌صورت داخلی استفاده می‌شوند، بازسازی شده است. ‫SwipeToDismissBoxState اکنون currentValue،‏ targetValue،‏ isAnimationRunning، و snapTo عضو دارد تا از موارد استفاده رایج پشتیبانی کند - لطفاً اگر به دارایی‌های بیشتری نیاز دارید که دردسترس قرار گیرد به ما اطلاع دهید. همچنین رفتار SwipeableState را در مواردی که انحراف تند کشیدن در محدوده خطای گرد کردن لنگر است اصلاح کرد. (I58302)

رفع اشکال‌ها

• کد ساده و اصلاح‌شده برای تشخیص اینکه آیا محتوای ScalingLazyColumn قابل پیمایش است یا نه (برای تصمیم‌گیری درباره اینکه آیا نوار پیمایش نمایش دهیم یا نه استفاده می‌شود) (I7bce0)
• اشکال «نشانگر موقعیت» هنگام استفاده با بیش از یک وضعیت و جابه‌جایی بین آن‌ها برطرف شد (I320b5)
• برای مطابقت با جدیدترین راهنمایی‌های تجربه کاربری، حروف‌چینی/قلم‌های زمینه پیش‌فرض «نوشتن» برای Wear OS را به‌روز کرده‌ایم. از نمایش1 (۴۰.sp) و نمایش2 (۳۴.sp) اکنون کوچک‌تر از مقادیر قبلی‌شان هستند و به‌روزرسانی‌های جزئی دیگری در ارتفاع خط و فاصله خط انجام شده است. (Ie3077)
• مقاومت دربرابر SwipeToDismissBox را اضافه کرده‌ایم تا حرکت فقط هنگام تند کشیدن برای بستن اتفاق بیفتد و در جهت مخالف اصلاً اتفاق نیفتد. (Ifdfb9)
• برخی‌از مقادیر پارامتر پیش‌فرض را برای توابع CircularProgressIndicator تغییر داده‌ایم تا آن‌ها را با راهنمایی‌های تجربه کاربری «طراحی مواد Wear» هماهنگ کنیم. برای نسخه «گردونه/نامشخص»، اندازه (۴۰->۲۴.dp)، رنگ نشانگر (اصلی->روی پس‌زمینه)، شفافیت رنگ مسیر (۳۰٪->۱۰٪)، و پهنای ضربه (۴->۳dp) به‌روز شده است. برای نسخه «پیشرفت/قطعی»، شفافیت trackColor (از ۳۰٪ به ۱۰٪) به‌روز شده است. (I659cc)
• پارامترهای مقیاس‌بندی پیش‌فرض ScalingLazyColumn را مطابق با جدیدترین مشخصات «تجربه کاربری طراحی Wear Material» به‌روز کرده‌ایم. ازنظر بصری، این امر باعث می‌شود که موارد فهرست از مرکز فهرست به سمت لبه فهرست مقیاس‌بندی شوند، اما در لبه فهرست نسبت‌به قبل کمتر مقیاس‌بندی شوند. (Ica8f3)
• برخی‌از اصلاحات در ScalingLazyColumnDefaults.snapFlingBehavior برای بهبود انتهای پویانمایی (If3260)

نسخه 1.0.0-alpha18

۹ مارس ۲۰۲۲

‫androidx.wear.compose:compose-foundation:1.0.0-alpha18،‏ androidx.wear.compose:compose-material:1.0.0-alpha18، و androidx.wear.compose:compose-navigation:1.0.0-alpha18 منتشر شدند. نسخه 1.0.0-alpha18 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

• چندین بهبود در PositionIndicator: ShowResult به PositionIndicatorVisibility تغییر نام داد. بهبودهایی در عملکرد برای جلوگیری از محاسبات مجدد درصورت عدم نیاز (Iaed9d)
• رنگ‌آمیزی توصیه‌شده برای SplitToggleChip به‌روز شده است. ‫SplitToggleChip اکنون وقتی علامت‌گذاری یا علامت‌گذاری‌نشده باشد پس‌زمینه‌ای یک‌رنگ دارد و رنگ ToggleControl نشان اصلی علامت‌گذاری یا علامت‌گذاری‌نشده بودن عنصر است. ToggleDefaults.splitToggleChipColors() جدیدی برای پشتیبانی از آرایش رنگ جدید اضافه کرده‌ایم. همچنین toggleChipColors() روش را با برداشتن splitBackgroundOverlayColor (I7e66e) ساده‌تر کرده‌ایم
• ‫unadjustedSize را به ScalingLazyListItemInfo اضافه کرده‌ایم زیرا به‌دلیل دقت محاسبات ممیز شناور، محاسبه اندازه اصلی مورد بااستفاده از اندازه مقیاس‌بندی‌شده و عامل مقیاس‌بندی ایمن نیست. (I54657، b/221079441)
• ‫HorizontalPageIndicator را اضافه کنید. این ویژگی نشان‌دهنده تعداد کل صفحات و صفحه انتخاب‌شده است. بسته به شکل دستگاه، ممکن است خطی یا منحنی باشد. همچنین از شکل نشانگر سفارشی پشتیبانی می‌کند که نحوه نمایش بصری هر نشانگر را تعریف می‌کند. (Iac898)
• ‫PickerState را به‌روز کرده‌ایم تا numberOfOptions بتواند به‌روز شود. این ویژگی از موارد استفاده‌ای مثل DatePicker پشتیبانی می‌کند، یعنی زمانی که تعداد روزهای ماه بسته به ماه انتخابی تغییر می‌کند. پارامتر سازنده برای PickerState به initialNumberOfOptions تغییر کرده است. (Iad066)
• وقتی PositionIndicator نوار پیمایش است و نمی‌تواند پیمایش کند، آن را پنهان کنید. (Id0a7f)
• برای هماهنگی با Scaffold، عنصر Dialog تمام‌صفحه ما اکنون PositionIndicator و Vignette را نمایش می‌دهد. اکنون به‌جای Column از ScalingLazyColumn استفاده می‌کنیم، که یعنی محتوای «کادر گفتگو» اکنون در ScalingLazyListScope است (و معمولاً باید در { /* content */ } مورد قرار گیرد). «کادر گفتگو» از پارامتر verticalArrangement (چیدمان عمودی) متناسب با آن پشتیبانی می‌کند. (Idea13)
• نام ویژگی toggleIcon و ToggleChip را به toggleControl و SplitToggleChip تغییر داده‌ایم تا با «طراحی Material» هماهنگ‌تر شود و به طراحان و توسعه‌دهندگان کمک کند در API پیمایش کنند. (If5921، b/220129803)
• یک ورودی جدید با نام caption3 به «گونه‌شناسی موضوع Wear Material» اضافه کرده‌ایم.Caption3 قلم کوچکی است که برای نوشتن متن‌های طولانی مثل متن‌های حقوقی استفاده می‌شود. (I74b13, b/220128356)

رفع اشکال‌ها

• وقتی به آنجا رسیدیم، پویانمایی چسباندن را متوقف کنید. (Idb69d)
• تغییرات در «نشانگر موقعیت» را پویاسازی کنید. (I94cb9)
• براساس بازخورد UI/UX، ScalingLazyColumn «مرکزگرایی خودکار» را تغییر داده‌ایم تا فقط فضای کافی برای اطمینان از اینکه عناصر با شاخص ScalingLazyListState.initialCenterItemIndex یا بالاتر بتوانند به‌طور کامل به مرکز درگاه دید پیمایش کنند ارائه دهد. این کار به توسعه‌دهندگان امکان می‌دهد یک یا دو مورد را در ابتدا در مرکز قرار دهند که قابل پیمایش به وسط نیستند. این یعنی ScalingLazyColumn با قابلیت «مرکز خودکار» نمی‌تواند بالاتر از initialCenterItemIndex/initialCenterItemScrollOffset پیمایش کند (I22ee2)
• نسخه نمایشی برای «انتخاب‌گر تاریخ» اضافه کرده‌ایم و اشکالی را در PickerState برطرف کرده‌ایم که در آن initiallySelectedOption تا زمانی که «انتخاب‌گر» نمایش داده نشده بود اعمال نمی‌شد. (Id0d7e)
• برای کاهش برش موارد ScalingLazyColumn پهن‌تر در صفحه‌های دایره‌ای، بالشتک محتوای افقی پیش‌فرض را از ۸ به ۱۰ dp افزایش داده‌ایم. (I0d609)
• مطمئن شوید که PositionIndicator هنگام پیمایش نشان داده شود. (Ied9a2)

نسخه 1.0.0-alpha17

۲۳ فوریه ۲۰۲۲

‫androidx.wear.compose:compose-foundation:1.0.0-alpha17،‏ androidx.wear.compose:compose-material:1.0.0-alpha17، و androidx.wear.compose:compose-navigation:1.0.0-alpha17 منتشر شدند. نسخه 1.0.0-alpha17 شامل این تعهدات است.

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

• پشتیبانی از snap را اضافه کرده‌ایم که می‌توانید با ScalingLazyColumn استفاده کنید. برای فعال کردن پشتیبانی چسباندن، flingBehavior = ScalingLazyColumnDefaults.flingWithSnapBehavior(state) را تنظیم کنید. (I068d3, b/217377069)
• نسخه‌های نمایشی برای «انتخاب‌گر» اضافه کرده‌ایم که برای انتخاب زمان در قالب ۲۴ ساعته یا ۱۲ ساعته استفاده می‌شود. (Ie5552)

تغییرات میانای برنامه‌سازی کاربردی

• رفع مشکل مربوط به TimeText قلم و سبک سفارشی در دستگاه مربعی (Iea76e)
• ‫ScalingLazyListLayoutInfo اکنون reverseLayout،‏ viewportSize، و ویژگی‌های جهتی دارد که با ویژگی‌های LazyListLayoutInfo مطابقت دارد (I4f258،‏ b/217917020)
• ‫ScalingLazyColumn اکنون دارایی userScrollEnabled دارد که با دارایی LazyList مطابقت دارد (I164d0،‏ b/217912513)
• انتخابگرها اکنون به‌طور پیش‌فرض در بالا و پایین گرادیان دارند (Iab92a)

رفع اشکال‌ها

• ‫ScalingLazyColumn را اصلاح کرده‌ایم تا دیگر همه فضای عنصر والدش را به‌صورت حریصانه پر نکند. درعوض، اندازه آن از اندازه محتوایش گرفته می‌شود. این کار باعث می‌شود که با عملکرد LazyColumn سازگار باشد. اگر می‌خواهید رفتار قدیمی را برگردانید، Modifier.fillMaxWidth()/width()/widthIn() را به ScalingLazyColumn (I51bf8) ارسال کنید
• پیام استثنا را در SwipeDismissableNavHost.kt که درصورت خالی بودن پشته برگشت پیمایش راه‌اندازی می‌شد بهبود داده‌ایم. (I1b1dc)

نسخه 1.0.0-alpha16

۹ فوریه ۲۰۲۲

‫androidx.wear.compose:compose-foundation:1.0.0-alpha16،‏ androidx.wear.compose:compose-material:1.0.0-alpha16، و androidx.wear.compose:compose-navigation:1.0.0-alpha16 منتشر شدند. نسخه 1.0.0-alpha16 شامل این تعهدات است.

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

• ‫CircularProgressIndicator را اضافه کنید. نشانگرهای پیشرفت طول یک فرایند یا زمان انتظار نامشخص را نمایش می‌دهند. درصورت استفاده از حالت تمام‌صفحه، از شکاف (برش) برای TimeText یا دیگر عناصر پشتیبانی می‌کند. (Iab8da)

تغییرات میانای برنامه‌سازی کاربردی

• انتخابگرها اکنون پارامتر flingBehavior دارند، مقدار پیش‌فرض باعث می‌شود هنگام پیمایش/پرتاب به نزدیک‌ترین گزینه بچسبند. (I09000)
• میانای برنامه‌سازی کاربردی عدد صحیح اضافی برای InlineSlider و Stepper (I1b5d6)

رفع اشکال‌ها

• شاخص پیش‌فرض اولیه initialCenterItemIndex را برای ScalingLazyListState از ۰ به ۱ تغییر داده‌ایم. این یعنی اینکه اگر در ساختار حالت با ScalingLazyListState.rememberScalingLazyListState(initialCenterItemIndex =) ملغی نشود، دومین عنصر فهرست (شاخص == ۱) در مرکز درگاه دید در زمان مقداردهی اولیه قرار می‌گیرد و عنصر اول (شاخص == ۰) قبل‌از آن قرار می‌گیرد. این کار باعث می‌شود جلوه دیداری پیش‌فرض بهتری از جعبه دریافت کنید زیرا بیشتر ناحیه نمایش با عناصر فهرست پر می‌شود. (I0c623، b/217344252)
• ScalingLazyColumn پیش‌فرض extraPadding ارائه‌شده را از ۱۰٪ به ۵٪ کاهش داده‌ایم تا مطمئن شویم تعداد کافی عنصر فهرست برای رسم کردن وجود دارد (حتی وقتی اندازه برخی‌از آن‌ها را کوچک می‌کنیم). این کار از ساختن عناصر فهرست اضافی که ممکن است در نمای درگاه نشان داده نشوند جلوگیری می‌کند. اگر از scalingParams غیر استاندارد استفاده می‌شود (برای مثال، مقیاس‌بندی شدیدتر)، توسعه‌دهنده می‌تواند بااستفاده از viewportVerticalOffsetResolver حاشیه اضافی را تنظیم کند. (I76be4)
• رفع مشکل «نوشتار زمان» در چند خط در دستگاه مربعی (Ibd3fb)
• ‫ScalingLazyColumn را اصلاح کرده‌ایم تا دیگر همه فضای عنصر والدش را به‌صورت حریصانه پر نکند. درعوض، اندازه آن از اندازه محتوایش گرفته می‌شود. این کار باعث می‌شود که با رفتار LazyColumn هماهنگ شود. اگر می‌خواهید رفتار قدیمی را برگردانید، Modifier.fillMaxSize() را به ScalingLazyColumn ارسال کنید - توجه: این تغییر ناقص است و در تغییر بعدی در نسخه آلفای بعدی به آن پرداخته خواهد شد. (I3cbfa)

نسخه 1.0.0-alpha15

‫۲۶ ژانویه ۲۰۲۲

‫androidx.wear.compose:compose-foundation:1.0.0-alpha15،‏ androidx.wear.compose:compose-material:1.0.0-alpha15، و androidx.wear.compose:compose-navigation:1.0.0-alpha15 منتشر شدند. نسخه 1.0.0-alpha15 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

• دارایی جدیدی به‌نام autoCentering را به ScalingLazyColumn اضافه کرده‌ایم. وقتی درست باشد (پیش‌فرض)، این کار تضمین می‌کند که همه موارد، ازجمله اولین و آخرین مورد، قابل پیمایش باشند تا در مرکز نمای درگاه فهرست‌ها نمایان شوند. توجه داشته باشید که اگر از مرکزگرایی خودکار استفاده می‌کنید، احتمالاً می‌خواهید حاشیه محتوای عمودی را روی ۰.dp تنظیم کنید. اگر هم «مرکزگرایی خودکار» و هم «حاشیه‌گذاری محتوای عمودی» ارائه شده باشد، هر دو باعث ایجاد فضای اضافی قبل‌از اولین و بعداز آخرین مورد فهرست می‌شوند و به آن‌ها امکان می‌دهند حتی بیشتر پیمایش شوند. (I2a282, b/214922490)
• یک عنصر Dialog اضافه کرده‌ایم که به هر عنصر ترکیبی امکان می‌دهد تا کادر گفتگوی تمام‌صفحه‌ای را که بالای محتوای دیگر قرار می‌گیرد راه‌اندازی کند. وقتی نشان داده می‌شود، این کادر گفتگو از کشیدن برای بستن پشتیبانی می‌کند و محتوای والد خود را در پس‌زمینه درحین ژست کشیدن نشان می‌دهد. انتظار می‌رود محتوای کادر گفتگو Alert یا Confirmation باشد (نام آن از عناصر قبلی AlertDialog و ConfirmationDialog تغییر کرده است) - Alert، Confirmation، و Dialog همه در بسته androidx.wear.compose.material.dialog هستند. می‌توان از «هشدار» و «تأیید» به‌عنوان مقصد ناوبری استفاده کرد. همچنین، درصورت لزوم، ColumnScope را به پارامترهای «هشدار» و «تأیید» اضافه کرد. (Ia9014)
• ‫onSurfaceVariant2 را از «رنگ‌های زمینه Material برای WearOS» برداشته‌ایم و موارد استفاده در کتابخانه را با onSurfaceVariant جایگزین کرده‌ایم. (Icd592)
• روشی برای انتخاب برنامه‌ریزی‌شده گزینه در PickerState اضافه شد، اکنون هنگام ایجاد PickerState نیز می‌توان گزینه انتخاب‌شده اولیه را مشخص کرد. (I92bdf)
• از سفارشی‌سازی رفتار پرتاب ScalingLazyColumn پشتیبانی کرده‌ایم. (I1ad2e،‏ b/208842968)
• ‫NavController.currentBackStackEntryAsState() را به کتابخانه Wear.Compose.Navigation اضافه کردیم. (If9028،‏ b/212739653)
• ‫Modifier.onRotaryScrollEvent() و Modifier.onPreRotaryScrollEvent() برای دستگاه‌های Wear دارای دکمه کناری چرخان اضافه شد.(I18bf5، b/210748686)

نسخه 1.0.0-alpha14

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

‫androidx.wear.compose:compose-foundation:1.0.0-alpha14،‏ androidx.wear.compose:compose-material:1.0.0-alpha14، و androidx.wear.compose:compose-navigation:1.0.0-alpha14 منتشر شدند. نسخه 1.0.0-alpha14 شامل این تعهدات است.

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

• روش‌های متعددی به ScalingLazyListState اضافه کرده‌ایم تا توسعه‌دهندگان بتوانند پیمایش به موارد فهرست خاص و همچنین تنظیم مورد فهرست اولیه و جبران را کنترل کنند.

  به‌عنوان بخشی از این تغییر، ScalingLazyList را نیز اصلاح کرده‌ایم تا به‌جای شروع نمای دید، حول مرکز نمای دید ScalingLazyList جهت‌گیری کند.

  دارایی جدیدی به‌نام anchorType: ScalingLazyListAnchorType = ScalingLazyListAnchorType.ItemCenter به ScalingLazyList اضافه شده است تا کنترل کند که آیا مرکز (ScalingLazyListAnchorType.ItemCenter) یا Edge (ScalingLazyListAnchorType.ItemStart) باید با خط مرکزی درگاه دید تراز شود یا نه.

  در نتیجه، ScalingLazyListItemInfo.offset و ScalingLazyListItemInfo.adjustedOffset تغییر کرده‌اند و اکنون انحراف مورد را نسبت به موقعیت عنصر فهرست و anchorType فهرست نشان می‌دهند. برای مثال، برای ScalingLazyColumn با anchorType از ItemCenter و عنصر فهرستی که مرکز آن روی خط مرکزی درگاه دید قرار دارد، مقدار جابه‌جایی 0 خواهد بود.

  روش‌های جدید عبارت‌اند از scrollTo، animatedScrollTo، centerItemIndex، و centerItemOffset. (I61b61)

• یک کنترل‌کننده دکمه برگشتن به SwipeDismissableNavHost اضافه کرده‌ایم تا با فشار دادن دکمه برگشتن، به سطح قبلی در سلسله‌مراتب پیمایش پیمایش شود. (I5b086، b/210205624)

نسخه 1.0.0-alpha13

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

‫androidx.wear.compose:compose-foundation:1.0.0-alpha13،‏ androidx.wear.compose:compose-material:1.0.0-alpha13، و androidx.wear.compose:compose-navigation:1.0.0-alpha13 منتشر شدند. نسخه 1.0.0-alpha13 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

• ‫RangeIcons داخلی (با InlineSlider و Stepper ارجاع داخلی شده است). (I927ec)

رفع اشکال‌ها

• مشکلی برطرف شد که در آن SwipeDismissableNavHost قبل‌از رسیدن به وضعیت «چرخه حیات» CREATED، مقصد را به سلسله مراتب «نوشتن» اضافه می‌کرد و درنتیجه IllegalStateException ایجاد می‌شد. این اصلاح پیش‌نیاز به‌روزرسانی وابستگی به navigation-compose به 2.4.0-beta02 و بالاتر بود. (I40a2b, b/207328687)

• یک کلاس شمارشی Drawables برای دریافت منابع قابل‌رسم در کتابخانه Wear Compose اضافه شد، بنابراین دیگر نیازی به انعکاس نیست. این کار اشکالی را برطرف می‌کند که در آن عناصر طراحی کتابخانه هنگام minifyEnabled=true یا shrinkResources=true برداشته می‌شدند). (Ib2a98)

• آزمایش‌هایی برای Stepper در «نوشتن در Wear» (I2d03a) اضافه شد

• نمونه‌هایی برای SwipeDismissableNavHost در «پیمایش نوشتن Wear» اضافه شد. (I85f06)

نسخه 1.0.0-alpha12

۱ دسامبر ۲۰۲۱

‫androidx.wear.compose:compose-foundation:1.0.0-alpha12،‏ androidx.wear.compose:compose-material:1.0.0-alpha12، و androidx.wear.compose:compose-navigation:1.0.0-alpha12 منتشر شدند. نسخه 1.0.0-alpha12 شامل این تعهدات است.

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

• عنصر «گام‌به‌گام» را اضافه کرده‌ایم که به کاربران امکان می‌دهد از میان محدوده‌ای از مقادیر انتخاب کنند. «گام‌به‌گام» یک کنترل تمام‌صفحه است که دکمه‌های افزایش و کاهش در بالا و پایین دارد و یک جایگاه در وسط (که انتظار می‌رود «تراشه» یا «نوشتار» را بپذیرد). درصورت نیاز، نمادهای دکمه را می‌توانید سفارشی‌سازی کنید. (I625fe)

• ‫۲ عنصر ترکیبی جدید برای نمایش دادن کادرهای گفتگو اضافه کرده‌ایم: ‫AlertDialog منتظر پاسخ کاربر می‌ماند و عنوان، نماد، پیام، و یکی از موارد زیر را نمایش می‌دهد: الف) دو دکمه برای انتخاب‌های مثبت/ منفی ساده یا ب) تراشه‌های عمودی یا تراشه‌های روشن/ خاموش برای انتخاب‌های انعطاف‌پذیرتر، ‫ConfirmationDialog تأییدیه‌ای با زمان اتمام نمایش می‌دهد. این چارگوش ساده دارای جایگاه‌هایی برای عنوان و نماد (پویانمایی‌شده) است. (Ic2cf8)

تغییرات میانای برنامه‌سازی کاربردی

• واحدهای (میلی‌ثانیه) را به مقادیر مدت کادر گفتگوی پیشنهادی اضافه کنید. (I09b48)

نسخه 1.0.0-alpha11

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

‫androidx.wear.compose:compose-foundation:1.0.0-alpha11،‏ androidx.wear.compose:compose-material:1.0.0-alpha11، و androidx.wear.compose:compose-navigation:1.0.0-alpha11 منتشر شدند. نسخه 1.0.0-alpha11 شامل این تعهدات است.

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

• عنصر انتخابگری اضافه کرده‌ایم که به کاربر امکان می‌دهد موردی را از فهرست پیمایشی انتخاب کند. به‌طور پیش‌فرض، فهرست موارد قابل‌انتخاب در هر دو جهت «بی‌نهایت» تکرار می‌شود تا این تصور ایجاد شود که استوانه‌ای درحال چرخش از کنار دیده می‌شود. دو ویژگی در نسخه‌های بعدی اضافه خواهد شد: چسبیدن به مقدار پس‌از کشیدن/پرتاب کردن؛ افزودن تابعی به PickerState برای تنظیم/پیمایش به مقدار فعلی. (I6461b)

تغییرات میانای برنامه‌سازی کاربردی

• ‫ScalingLazyItemScope و چند اصلاح‌گر جدید fillParentMaxSize/fillParentMaxWidth/fillParentMaxHeight اضافه شد تا به موارد فهرست اجازه دهد براساس اندازه محتوی والد اندازه‌بندی شوند. موارد را می‌توان به‌گونه‌ای تنظیم کرد که تمام یا بخشی از اندازه عنصر والد را پر کنند. این کارکردی را که قبلاً در LazyRow/Column (I4612f) دردسترس بود آشکار می‌کند
• پشتیبانی از ScalingLazyColumn اضافه شد تا به موارد اجازه دهد کلید داشته باشند. همچنین روش‌های راحتی برای اجازه دادن به افزودن موارد از «آرایه‌ها» و «فهرست‌ها» اضافه شد. (Ic1f89)

رفع اشکال‌ها

• نمونه‌های بیشتر برای TimeText (I8cb64)

نسخه 1.0.0-alpha10

۳ نوامبر ۲۰۲۱

‫androidx.wear.compose:compose-foundation:1.0.0-alpha10،‏ androidx.wear.compose:compose-material:1.0.0-alpha10، و androidx.wear.compose:compose-navigation:1.0.0-alpha10 منتشر شدند. نسخه 1.0.0-alpha10 حاوی این تعهدات است.

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

• «لغزنده به‌خط» برای نوشتن در دستگاه‌های پوشیدنی اضافه شد. InlineSlider به کاربران امکان می‌دهد از میان طیف وسیعی از مقادیر انتخاب کنند. محدوده انتخاب‌ها به‌صورت یک نوار بین مقادیر حداقل و حداکثر محدوده نشان داده می‌شود که کاربران می‌توانند از آن یک مقدار را انتخاب کنند. (If0148)

• ‫Compose جدید برای WearOS Codelab را بررسی کنید!

تغییرات میانای برنامه‌سازی کاربردی

• ‫Macrobenchmark اکنون minSdkVersion از 23 دارد. (If2655)

رفع اشکال‌ها

• به‌روزرسانی مدیریت انتقال در SwipeDismissableNavHost در SideEffect (I04994، b/202863359)
• به‌روزرسانی مدیریت انتقال در SwipeDismissableNavHost (I1cbe0، b/202863359)

نسخه 1.0.0-alpha09

‫۲۷ اکتبر ۲۰۲۱

‫androidx.wear.compose:compose-foundation:1.0.0-alpha09،‏ androidx.wear.compose:compose-material:1.0.0-alpha09، و androidx.wear.compose:compose-navigation:1.0.0-alpha09 منتشر شدند. نسخه 1.0.0-alpha09 شامل این تعهدات است.

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

• «پیش‌نمایش توسعه‌دهنده» Compose را در Wear OS راه‌اندازی کرده‌ایم - پست وبلاگ ما را که composableهای اصلی را بررسی می‌کند و به منابع بیشتری برای شروع استفاده از آن‌ها پیوند می‌دهد ببینید.

تغییرات میانای برنامه‌سازی کاربردی

• ما پشتیبانی از توسعه‌دهندگان را اضافه کرده‌ایم تا بتوانند همه رنگ‌های زمینه «طراحی رنگ Wear Material» را سفارشی‌سازی کنند. (I4759b،‏ b/199754668)

رفع اشکال‌ها

• نمونه‌های SwipeToDismissBox اضافه شد که وضعیت را حفظ می‌کند (Ibaffe)
• پیوندهایی به راهنمای developer.android.com از KDocs برای CurvedText،‏ TimeText، و SwipeToDismissBox اضافه شد. (I399d4)
• اکنون اگر مقصد فعلی وجود نداشته باشد، SwipeDismissableNavHost استثنا ایجاد می‌کند (این نشان می‌دهد که NavGraph با تابع کمکی wear.compose.navigation.composable ساخته نشده است) (I91403)
• مستندات و نمونه‌های بیشتری برای استفاده از منبع زمان در TimeText (I4f6f0) اضافه شد

نسخه 1.0.0-alpha08

‫۱۳ اکتبر ۲۰۲۱

‫androidx.wear.compose:compose-foundation:1.0.0-alpha08،‏ androidx.wear.compose:compose-material:1.0.0-alpha08، و androidx.wear.compose:compose-navigation:1.0.0-alpha08 منتشر شدند. نسخه 1.0.0-alpha08 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

• نام ویژگی‌های AppCard و TitleCard body را به content تغییر داده‌ایم و آن‌ها را به انتهای فهرست ویژگی‌ها منتقل کرده‌ایم تا بتوانند به‌عنوان لامبدای دنباله‌دار ارائه شوند. همچنین bodyColor به contentColor تغییر نام داد تا با نام‌های جدید جایگاه هماهنگ باشد. (I57e78)

رفع اشکال‌ها

• پیوندهایی به راهنمای developer.android.com از KDocs برای دکمه، کارت، تراشه، زمینه، نشانگر موقعیت، و مؤلفه‌های ستون تنبل مقیاس‌بندی اضافه شد. (I22428)
• رفع مشکل WearOS SwipeToDismissBox که گاهی اوقات تند کشیدن‌ها را مدیریت نمی‌کرد. (I9387e)
• نمونه‌هایی برای «دکمه»، «دکمه فشرده»، «تراشه»، «تراشه فشرده»، «کارت برنامه»، «کارت عنوان»، «دکمه روشن/خاموش»، «تراشه روشن/خاموش»، «تراشه روشن/خاموش تقسیم‌شده» (Iddc15) اضافه شد
• آزمایش‌های عملکرد ریزمعیار برای Card،‏ Chip،‏ ToggleChip،‏ TimeText، و ScalingLazyColumn اضافه شد. (If2fe9)

نسخه 1.0.0-alpha07

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

‫androidx.wear.compose:compose-foundation:1.0.0-alpha07،‏ androidx.wear.compose:compose-material:1.0.0-alpha07، و androidx.wear.compose:compose-navigation:1.0.0-alpha07 منتشر شدند. نسخه 1.0.0-alpha07 حاوی این تعهدات است.

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

• عنصر CurvedText (نوشتار منحنی) در Material اضافه شد، عنصری که به توسعه‌دهندگان امکان می‌دهد به‌راحتی نوشتار منحنی را براساس انحنای دایره (معمولاً در لبه صفحه‌نمایش دایره‌ای) بنویسند. (I19593)

تغییرات میانای برنامه‌سازی کاربردی

• آزمون‌هایی برای TimeText (Idfead) اضافه شد
• ‫ArcPaddingValues را به واسط تبدیل کنید. (Iecd4c)
• پویانمایی به SwipeToDismissBox (I9ad1b) اضافه شد
• پارامتر hasBackground به SwipeToDismissBox API اضافه شد تا ژست تند کشیدن وقتی محتوای پس‌زمینه‌ای برای نمایش وجود ندارد غیرفعال شود. (I313d8)
• اکنون rememberNavController() مجموعه اختیاری از Navigator نمونه را می‌پذیرد که به NavController برگشتی اضافه می‌شوند تا بهتر از «پیمایشگرهای» اختیاری مثل پیمایشگرهای مواد پیمایش همراه پشتیبانی کند. (I4619e)
• ‫NamedNavArgument را از navigation-common ارجاع دهید و کپی را از wear.compose.navigation بردارید. (I43af6)

رفع اشکال‌ها

• مشکل ناپایداری تست CurvedRow در دستگاه‌های کوچک‌تر برطرف شد. (If7941)
• مشکل احتمالی پرش در «ردیف منحنی» هنگام به‌روزرسانی محتوا برطرف شد، و ردیف منحنی دوباره اندازه‌گیری می‌شود (Ie4e06)
• ‫ChipDefaults.gradientBackgroundChipColors()‎ مطابق با تغییرات «مشخصات تجربه کاربری» به‌روزرسانی شده است. گرادیان اکنون با MaterialTheme.colors.primary با آلفای ۳۲٫۵٪ شروع می‌شود و با MaterialTheme.colors.surface با آلفای ۰٪ روی پس‌زمینه‌ای از MaterialTheme.colors.surface با آلفای ۷۵٪ پایان می‌یابد. (Id1548)
• رنگ‌های «تراشه‌های روشن/خاموش» را در حالت انتخاب‌شده به‌روز کرده‌ایم تا با جدیدترین راهنمایی‌های «مشخصات تجربه کاربری طراحی Wear Material» مطابقت داشته باشد. وقتی انتخاب شود، «تراشه‌های تغییر وضعیت» اکنون پس‌زمینه‌ای با گرادیان از MaterialTheme.color.surface @ 0% alpha، بالا سمت راست، تا MaterialTheme.color.primary @ 32% alpha، پایین سمت چپ، روی پس‌زمینه‌ای از MaterialTheme.color.surface @ 75% alpha دارند. این امر منجر به تفاوت ظریف‌تری بین انتخاب‌شده و لغو انتخاب‌شده برای ToggleChip می‌شود. (Idd40b)

نسخه 1.0.0-alpha06

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

‫androidx.wear.compose:compose-foundation:1.0.0-alpha06،‏ androidx.wear.compose:compose-material:1.0.0-alpha06، و androidx.wear.compose:compose-navigation:1.0.0-alpha06 منتشر شدند. نسخه 1.0.0-alpha06 شامل این تعهدات است.

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

• ما Scaffold را به‌عنوان یک عنصر ترکیبی برنامه سطح بالا اضافه کرده‌ایم که ساختاری برای مدیریت موقعیت «نشانگرهای موقعیت» (مانند «پیمایش» یا «میزان صدا») ارائه می‌دهد، ناحیه‌ای در بالای صفحه برای نمایش زمان و وضعیت برنامه، و همچنین از Vignette برای محو کردن لبه‌های بالا و پایین صفحه برای محتوای پیمایش‌پذیر پشتیبانی می‌کند. ناحیه اصلی «داربست» جایی است که محتوای برنامه در آن قرار می‌گیرد. (I5e0bf)
• پیاده‌سازی TimeText برای Wear Compose اضافه شد (I5654c)

کتابخانه پیمایش Wear Compose

• اولین نسخهٔ پخش کتابخانه «پیمایش نوشتن Wear» را اضافه کرده‌ایم که یکپارچگی بین کتابخانه‌های «نوشتن Wear» و «پیمایش Androidx» را فراهم می‌کند. این کتابخانه روشی ساده برای پیمایش بین توابع @Composable به‌عنوان مقصد در برنامه شما ارائه می‌دهد.

• این نسخهٔ پخش اولیه این موارد را ارائه می‌دهد:

  • عنصر SwipeDismissableNavHost ترکیبی که میزبان گراف ناوبری است و ازطریق اشاره‌های تند کشیدن، ناوبری به عقب را ارائه می‌دهد
  • افزونه NavGraphBuilder.composable برای کمک به ساختن گراف‌های ناوبری
  • ‫rememberSwipeDismissableNavController() برای مجاز کردن وضعیت بالابری

• نمونه استفاده‌ای که در آن دو صفحه ایجاد می‌کنیم و بین آن‌ها پیمایش می‌کنیم:

  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» به‌عنوان کتابخانه جداگانه‌ای بسته‌بندی شده است تا برنامه‌های ساده WearCompose که پیمایش دست‌ساز خودشان را پیاده‌سازی می‌کنند ملزم به اتکا به کتابخانه Androidx Navigation نباشند.

تغییرات میانای برنامه‌سازی کاربردی

• ‫SwipeDismissableNavHost به‌روز شد تا با تنظیم هویت کلید برای پس‌زمینه و محتوا (I746fd) از rememberSaveable پشتیبانی کند
• آداپتور PositionIndicator را اضافه کرده‌ایم که می‌تواند LazyListState را مدیریت کند (I21b88)
• ‫SwipeToDismissBox به‌روزرسانی شد تا از rememberSaveable پشتیبانی کند (Ie728b)
• پشتیبانی از reverseLayout را به ScalingLazyColumn اضافه کرده‌ایم. این کار امکان معکوس کردن جهت پیمایش و چیدمان را فراهم می‌کند (I9e2fc)
• ‫performGesture و GestureScope منسوخ شدند و با performTouchInput و TouchInjectionScope جایگزین شدند. (Ia5f3f، b/190493367)
• نام VignetteValue را به VignettePosition تغییر دادیم و نام VignetteValue.Both را به VignettePosition.TopAndBottom تغییر دادیم. (I57ad7)
• درصورتی‌که تصمیم بگیریم در آینده پیاده‌سازی ScalingLazyRow را اضافه کنیم، نام ScalingLazyColumnState را به ScalingLazyListState، نام ScalingLazyColumnItemInfo را به ScalingLazyListItemInfo، نام ScalingLazyColumnLayoutInfo را به ScalingLazyListLayoutInfo، و نام ScalingLazyColumnScope را به ScalingLazyListScope تغییر داده‌ایم. (I22734)

رفع اشکال‌ها

• مستندات CompactChip به‌روز شد تا توضیح دهد اگر نه نماد و نه برچسب ارائه نشود چه اتفاقی می‌افتد. (I4ba88)
• تعدادی تغییر در عناصر کارت Wear ایجاد کرده‌ایم. (I6b3d0)
  1. فاصله TitleCard بین «عنوان» و «متن» از ۸dp به ۲dp کاهش یافت.
  2. قلم سرایند «کارت عنوان» از بدنه به عنوان۳ تغییر کرد.
  3. گرادیان پس‌زمینه کارت تغییر کرد تا پس‌زمینه تیره‌تر به‌نظر برسد.

نسخه 1.0.0-alpha05

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

‫androidx.wear.compose:compose-foundation:1.0.0-alpha05 و androidx.wear.compose:compose-material:1.0.0-alpha05 منتشر شدند. نسخه 1.0.0-alpha05 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

• ‫ArcPaddingValues را به‌عنوان ‎ @Stable علامت‌گذاری کنید (I57deb)
• ‫ScalingLazyColumnState اکنون رابط ScrollableState را پیاده‌سازی می‌کند و به توسعه‌دهندگان امکان می‌دهد ازطریق برنامه‌ریزی به پیمایش مؤلفه دسترسی داشته باشند. (I47dbc)

رفع اشکال‌ها

• فاصله بین «نماد» و «نوشتار» در «تراشه» و «تراشه تغییر وضعیت» را کاهش داده‌ایم تا با به‌روزرسانی‌های «مشخصات تجربه کاربری» هماهنگ شوند. (I83802)

نسخه 1.0.0-alpha04

۱۸ اوت ۲۰۲۱

‫androidx.wear.compose:compose-foundation:1.0.0-alpha04 و androidx.wear.compose:compose-material:1.0.0-alpha04 منتشر شدند. نسخه 1.0.0-alpha04 شامل این تعهدات است.

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

• «جعبه تند کشیدن برای بستن» و اصلاح‌گر تندکشیدنی اضافه شد که می‌توان از آن برای پشتیبانی از اشاره تند کشیدن از چپ به راست برای بستن استفاده کرد. اگرچه مستقل از عناصر پیمایش است، انتظار می‌رود از آن برای خروج از یک صفحه و پیمایش به صفحه‌ای دیگر استفاده شود. آزمایش‌های یکپارچه‌سازی به نسخه نمایشی «کشیدن برای بستن» اضافه شد. (I7bbaa)
• واسطه‌های ScalingLazyColumnItemInfo و ScalingLazyColumnLayoutInfo را به کلاس ScalingLazyColumnState اضافه کرده‌ایم تا توسعه‌دهندگان بتوانند موقعیت‌ها و اندازه‌های واقعی عناصر را در ScalingLazyColumn پس‌از اعمال مقیاس‌بندی بدانند. همچنین اشکالی را در نحوه محاسبه مقیاس‌بندی زمانی‌که بالشتک محتوای «بالا» به ScalingLazyColumn اعمال می‌شود برطرف کرده‌ایم. (I27c07)

تغییرات میانای برنامه‌سازی کاربردی

• کلاس CurvedTextStyle را اضافه کنید تا سبک نوشتار منحنی را مشخص کنید گزینه‌ها. مشابه با TextStyle، اما اکنون فقط از رنگ، اندازه قلم، و پس‌زمینه پشتیبانی می‌کند. گزینه‌های سبک‌بندی بیشتری در آینده اضافه خواهد شد. ‫(I96ac3)
• واسطه‌های ScalingLazyColumnItemInfo و ScalingLazyColumnLayoutInfo را به کلاس ScalingLazyColumnState اضافه کرده‌ایم تا توسعه‌دهندگان بتوانند موقعیت‌ها و اندازه‌های واقعی عناصر را در ScalingLazyColumn پس‌از اعمال مقیاس‌بندی بدانند. همچنین اشکالی را در نحوه محاسبه مقیاس‌بندی زمانی‌که بالشتک محتوای «بالا» به ScalingLazyColumn اعمال می‌شود برطرف کرده‌ایم. (I27c07)
• ‫@ExperimentalWearMaterialApi به شمارش SwipeDismissTarget اضافه شد، بخشی از SwipeToDismissBox API. (I48b5e)

رفع اشکال‌ها

• مطالب آزمایشی برای SwipeToDismissBox (I9febc) اضافه شد

نسخه 1.0.0-alpha03

۴ اوت ۲۰۲۱

‫androidx.wear.compose:compose-foundation:1.0.0-alpha03 و androidx.wear.compose:compose-material:1.0.0-alpha03 منتشر شدند. نسخه 1.0.0-alpha03 حاوی این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

• عنصر CurvedText اضافه شد که به توسعه‌دهندگان امکان می‌دهد به‌راحتی نوشتار را در امتداد انحنای دایره (معمولاً در لبه صفحه‌نمایش دایره‌ای) بنویسند (Id1267)
• نام CardDefaults.imageBackgroundPainter() را به CardDefaults.imageWithScrimBackgroundPainter() تغییر دادیم تا مشخص شود که تصویر پس‌زمینه با یک پرده توری روی آن کشیده می‌شود. (I53206)
• افزودن عنصر ScalingLazyColumn که عنصر فهرستی را برای Wear Material ارائه می‌دهد و نمای چشم ماهی با محتوای فهرست ارائه می‌دهد که با نزدیک شدن به لبه عنصر، اندازه آن کوچک‌تر و شفاف‌تر می‌شود. ‫(I7070c)

رفع اشکال‌ها

• در پاسخ به به‌روزرسانی «مشخصات تجربه کاربری»، رنگ پیش‌فرض محتوای appName را در AppCard تغییر دادیم. رنگ پیش‌فرض برای appName اکنون MaterialTheme.colors.onSurfaceVariant است. علاوه‌براین، شرح سند پارامتر جاافتاده‌ای برای جایگاه عنوان اضافه شد. (Ic4ad1)

نسخه 1.0.0-alpha02

۲۱ ژوئیه ۲۰۲۱

‫androidx.wear.compose:compose-foundation:1.0.0-alpha02 و androidx.wear.compose:compose-material:1.0.0-alpha02 منتشر شدند. نسخه 1.0.0-alpha02 شامل این تعهدات است.

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

• کلاس جدیدی به‌نام CurvedRow به عناصر چیدمانی در کمان اضافه شد (I29941)
• نوع جدیدی از کارت برای استفاده در برنامه‌ها اضافه شد (TitleCard)، همچنین پشتیبانی از داشتن تصویر به‌عنوان پس‌زمینه «کارت‌ها» برای تأکید بر محتوای آن‌ها اضافه شد (I53b0f)

تغییرات میانای برنامه‌سازی کاربردی

• پشتیبانی از تراز شعاعی به CurvedRow اضافه شد (مشابه تراز عمودی در ردیف) (Id9de5)
• افزودن کلاس جدید CurvedRow به عناصر ترکیبی چیده‌شده در یک کمان (I29941)
• نوع جدیدی از کارت برای استفاده در برنامه‌ها اضافه شد (TitleCard)، همچنین پشتیبانی از داشتن تصویر به‌عنوان پس‌زمینه «کارت‌ها» برای تأکید بر محتوای آن‌ها اضافه شد (I53b0f)
• نمادهای کلید روشن/خاموش (چارگوش انتخاب، کلید، و دکمه‌های رادیویی) به ToggleChipDefaults اضافه شد تا پیکربندی ToggleChip و SplitToggleChips برای توسعه‌دهندگان آسان‌تر شود (I7b639)
• بالشتک محتوای شروع و پایان برای «تراشه‌ها» به‌روز شده است تا صرف‌نظر از اینکه «تراشه» نماد دارد یا نه، به‌طور یکنواخت ۱۴dp باشد (قبلاً اگر نماد داشت ۱۲dp و اگر نماد نداشت ۱۴dp بود) (I34c86)

رفع اشکال‌ها

• افزودن آزمایش برای CurvedRow (I93cdb)
• درحال پیوند دادن وابستگی‌های Wear Compose به Compose 1.0.0-rc01. (Ie6bc9)
• نحوه مدیریت نقاشی تصویر پس‌زمینه در «کارت‌ها» و «تراشه‌ها» تغییر کرد تا تصویر به‌جای کشیده شدن، برش داده شود و نسبت‌های تصویر حفظ شود. (I29b41)
• آزمایش‌های ادغام و نمایش‌های بیشتری برای «دکمه» و «دکمه تغییر وضعیت» اضافه شد. (5e27ed2)
• آزمایش‌های «تراشه» بیشتری اضافه شد تا رنگ‌های محتوا برای imageBackgroundChips پوشش داده شود (Ia9183)

نسخه 1.0.0-alpha01

۱ ژوئیه ۲۰۲۱

‫androidx.wear.compose:compose-foundation:1.0.0-alpha01 و androidx.wear.compose:compose-material:1.0.0-alpha01 منتشر شدند. نسخه 1.0.0-alpha01 شامل این تعهدات است.

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

‫Wear Compose کتابخانه‌ای مبتنی بر Kotlin و Compose است که از Wear Material Design، افزونه‌ای از Material Design برای دستگاه‌های پوشیدنی WearOS، پشتیبانی می‌کند. این اولین نسخه آلفا شامل پیاده‌سازی‌های اولیه و کاربردی از موارد زیر است:

• زمینه «طراحی مواد» - رنگ‌ها، حروف‌چینی، و شکل‌ها را به‌طور یکنواخت در سراسر عناصر استفاده‌شده از این کتابخانه پیکربندی می‌کند.
• تراشه، تراشه فشرده - تراشه‌ها به‌شکل استادیوم هستند و گونه‌های مختلفی برای دریافت محتوای نماد، برچسب، و برچسب ثانویه دردسترس هستند.
• - ToggleChip،‏ SplitToggleChip - نوعی تراشه تخصصی که شامل جایگاهی برای نماد کلید دوحالته مانند دکمه رادیویی یا چارگوش انتخاب است. علاوه‌براین، SplitToggleChip دو ناحیه تک‌ضرب‌زدنی دارد، یکی کلیک‌کردنی و دیگری روشن/خاموش‌کردنی.
• دکمه، دکمه فشرده - دکمه‌ها دایره‌ای شکل هستند و یک جایگاه محتوا برای نماد یا نوشتار حداقلی (حداکثر ۳ نویسه) دارند.
• دکمه روشن/خاموش - دکمه‌ای که کنشی را روشن یا خاموش می‌کند، با یک جایگاه برای نماد یا نوشتار حداقلی (حداکثر ۳ نویسه).
• کارت، کارت برنامه - مستطیل‌شکل با گوشه‌های گرد، که جایگاه‌هایی برای محتوا مانند نماد برنامه، زمان، عنوان، و متن ارائه می‌دهد.

نسخه‌های آینده با افزودن پشتیبانی از انتخابگرهای «طراحی مواد Wear»، لغزنده‌ها، فهرست‌ها، نشانگرهای صفحه، کادرهای گفتگو، نشانگرهای نوار پیمایش، پیام‌های لحظه‌ای، و موارد دیگر، مجموعه «ابزارک» را گسترش خواهند داد.

علاوه‌براین، برای دیگر ویژگی‌های مختص «پوشیدنی‌ها» مثل چیدمان و نوشتار منحنی و همچنین داربست‌بندی برای آسان کردن ساختن برنامه‌ها/رونهادهای «پوشیدنی‌ها» برای توسعه‌دهندگان پشتیبانی ارائه خواهد شد.

‫Wear Compose Material با همان اصول Compose Material طراحی شده است، بااین‌حال هدف آن دستگاه‌های پوشیدنی است. هنگام ساختن برای دستگاه پوشیدنی، باید از کتابخانه Wear Compose Material به‌جای کتابخانه Compose Material استفاده شود.

دو کتابخانه «Material» باید به‌صورت متقابل انحصاری درنظر گرفته شوند و نباید در یک برنامه با هم ترکیب شوند. اگر توسعه‌دهندگان متوجه شدند که کتابخانه «Material Compose» را در وابستگی‌هایشان گنجانده‌اند، این نشان می‌دهد که یا الف) مؤلفه‌هایی در کتابخانه «Wear Compose Material» وجود ندارد، لطفاً به ما بگویید به چه چیزی نیاز دارید، یا ب) از مؤلفه‌ای استفاده می‌کنند که ما استفاده از آن را در «دستگاه پوشیدنی» توصیه نمی‌کنیم.