Wear Compose Material 3

  
يمكنك كتابة تطبيقات Jetpack Compose لأجهزة Wear OS من خلال توفير وظائف تتيح استخدام أحجام الأجهزة المختلفة ولفتات التنقّل باستخدام نظام التصميم Material 3 Expressive.
آخر تعديل الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأولي
4 حزيران (يونيو) 2025 - - 1.5.0-beta03 -

تحديد التبعيات

لإضافة تبعية على Wear، يجب إضافة مستودع Google Maven إلى مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف التبعيات للعناصر التي تحتاج إليها في ملف build.gradle ل تطبيقك أو وحدتك:

Groovy

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

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

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

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

Kotlin

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

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

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

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

لمزيد من المعلومات عن العناصر الاعتمادية، اطّلِع على مقالة إضافة عناصر الاعتماد الخاصة بالإصدار.

الملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا واجهت مشاكل جديدة أو كان لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.

إنشاء مشكلة جديدة

اطّلِع على مستندات أداة تتبُّع المشاكل لمزيد من المعلومات.

Wear Compose Material3 الإصدار 1.5

الإصدار 1.5.0-beta03

4 حزيران (يونيو) 2025

تم إصدار androidx.wear.compose:compose-*:1.5.0-beta03. يتضمّن الإصدار 1.5.0-beta03 عمليات الربط هذه.

تغييرات واجهة برمجة التطبيقات

  • يقرأ 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 بشكل صحيح في تنسيق RTL (Ib378d).
  • يتيح AnimatedText الآن اتجاه النص من اليمين إلى اليسار (I4533c).
  • يعيد تطبيق TransformingLazyColumn الآن تغيير حجم العناصر بشكل صحيح عند إزالة العنصر السفلي (Idacab).
  • TransformingLazyColumn يُجري الآن جولة قياس واحدة فقط، ما يؤدي إلى تحسين الأداء من خلال تقليل أوقات عرض اللقطات. (I501a1)

الإصدار 1.5.0-beta02

20 أيار (مايو) 2025

تم إصدار androidx.wear.compose:compose-*:1.5.0-beta02. يتضمّن الإصدار 1.5.0-beta02 عمليات الربط هذه.

إصلاح الأخطاء

  • تم تعديل الملفات الأساسية لـ foundation وmaterial وmaterial3. (I53f06)
  • تم إصلاح خطأ في TransformingLazyColumn، حيث يتم تغيير حجم العناصر عند إزالة العنصر السفلي. (Idacab)
  • تم إصلاح خطأ في TransformingLazyColumn، عندما كانت القائمة تتعلّق في أعلى أو أسفل القائمة. (I49d00)
  • OpenOnPhoneDialog من المفترض أن يُعلن تطبيق TalkBack عن النص المنحني، وليس وصف محتوى الأيقونة. (I4efe8)
  • تم إصلاح خطأ في SwipeToReveal كان يؤدي إلى الإبلاغ عن عنصر الربط غير الصحيح في RevealState.currentValue عند ضبط hasPartiallyRevealedState على false. (I9c7cf)
  • أصبحت أزرار التراجع SwipeToReveal الآن ButtonDefaults.Height تلقائيًا. (I1f6c8)
  • تم تحسين أداء BasicSwipeToDismissBox من خلال إيقاف استخدام Canvas لرسم الشاشات المصغّرة. (I68f2c)
  • تم إصلاح خلل في تسهيل الاستخدام في شريط التمرير، حيث لم تتطابق النسبة المئوية المعلَن عنها مع القيمة بعد إجراء التحديثات (I91146).
  • تم إصلاح خطأ في عملية تنفيذ placeholderShimmer. (Iee39b
  • تم تحسين أداء TransformingLazyColumn من خلال تحسين عملية احتساب ScrollProgress بنسبة %30. (I4c4cb)

الإصدار 1.5.0-beta01

7 أيار (مايو) 2025

تم إصدار androidx.wear.compose:compose-*:1.5.0-beta01. يتضمّن الإصدار 1.5.0-beta01 عمليات الربط هذه.

يشير الإصدار 1.5.0-beta01 من Compose لنظام التشغيل Wear OS إلى أنّ هذا الإصدار من المكتبة متكامل من حيث الميزات وأنّ واجهة برمجة التطبيقات مقفلة (باستثناء الحالات التي تم وضع علامة عليها كإصدار تجريبي).

يتضمّن الإصدار 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 - تُستخدَم لإضافة إجراءات إضافية إلى عنصر قابل للتجميع عند التمرير سريعًا من اليمين إلى اليسار.

بالإضافة إلى ذلك، يتضمّن الإصدار 1.5.0-beta01 من Wear Compose Foundation المكوّنات الجديدة التالية:

  • ‫TransformingLazyColumn - قائمة بطيئة التمرير عموديًا تتيح استخدام الرسوم المتحرّكة للتوسيع والتحويل
  • مجموعات التركيز التدرّجية: تُستخدَم لإضافة تعليقات توضيحية إلى العناصر القابلة للتجميع في أحد التطبيقات، وذلك لتتبُّع الجزء النشط من التركيب وتنسيق التركيز.
  • صفحات التنقّل: مكونات HorizontalPager وVerticalPager، تم إنشاؤها استنادًا إلى مكونات Compose Foundation مع تحسينات خاصة بنظام التشغيل Wear لتحسين الأداء والالتزام بإرشادات Wear OS

تغييرات واجهة برمجة التطبيقات

  • تم تعديل واجهة برمجة التطبيقات Hierarchical Focus API، وتمّت إعادة تسمية Modifier.hierarchicalFocus إلى Modifier.hierarchicalFocusGroup وإزالة مَعلمة callback، كما تمّت إزالة التحميل الزائد لمَعلمة 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).
  • تم نقل تبعيات SwipeToReveal في Wear Compose Material3 على Foundation إلى حزمة material3، مثل RevealValue وRevealDirection وRevealActionType وRevealState وrememberRevealState. على المطوّرين تغيير عمليات استيراد هذه الفئات والدوالّ من androidx.wear.compose.foundation إلى androidx.wear.compose.material3. (I640e6).
  • تم تعديل واجهة برمجة التطبيقات SwipeToReveal في Wear Compose Material3 على النحو التالي: تمت إضافة المَعلمات primaryAction وonFullSwipe وsecondaryAction وundoPrimaryAction وundoSecondaryAction وhasPartiallyRevealedState إلى العنصر القابل للتجميع SwipeToReveal. تمت إزالة إمكانية تخصيص positionalThreshold وanimationSpec من RevealState. تمت إزالة lastActionType وrevealThreshold وwidth من RevealState. تم تغيير أداة إنشاء RevealState لقبول RevealDirection بدلاً من عناصر الربط. تمت إزالة وظائف createRevealAnchors وعناصر الربط وbidirectionalAnchors. تمت إعادة تسمية وظائف SwipeToRevealScope primaryAction وsecondaryAction وundoPrimaryAction وundoSecondaryAction لتصبح PrimaryActionButton وSecondaryActionButton وUndoActionButton وتحويلها إلى وظائف قابلة للتجميع. تم وضع علامة على RevealActionType باعتبارها داخلية. (I885d0).
  • تم تعديل واجهة برمجة التطبيقات SwipeToReveal بشكلٍ إضافي على النحو التالي: تمت إعادة تسمية onFullSwipe إلى onSwipePrimaryAction، وتمت إعادة تسمية SwipeToRevealNonAnchoredSample للإشارة إلى استخدام المَعلمة hasPartiallyRevealedState، وتمّت إزالة actionButtonHeight، لأنّ الارتفاع التلقائي هو الارتفاع التلقائي للزر ويمكن ضبط الارتفاع الأكبر باستخدام مُعدِّل، وتمّت إزالة SmallActionButtonHeight من SwipeToRevealDefaults، وتمّ جعل مَعلمة القيمة في RevealValue وRevealDirection خاصّة. (I465ce).

إصلاح الأخطاء

  • تم إصلاح معالجة EdgeButton في ScreenScaffold بحيث يتم عرض EdgeButton بشكل متحرك في مكانه بعد إزالة عنصر TransformingLazyColumn. (I6d366).
  • تم تحديث الاعتماديات في Wear Compose على مكتبات Compose إلى الإصدار 1.8.0. (I2ef3f).
  • تم تعديل حركة العنصر غير المحدّد CircularProgressIndicator لكي لا يعود يتراجع مؤقتًا. (Ieddb1).
  • تم إصلاح خطأ في SwipeDismissableNavHost: لم يكن التركيز يتبدّل بشكل صحيح بعد التمرير سريعًا للخلف، ما أدّى إلى تعذُّر إدخال البيانات باستخدام الشاشة الدوّارة (كان هذا الخطأ في الإصدار 36 من واجهة برمجة التطبيقات والإصدارات الأحدث التي تستخدم ميزة "الرجوع التوقّعي"). (Ieddb1).
  • تم تعديل المستندات المتعلّقة بـ Hierarchical Focus API (Idf2ff).
  • تم تعديل مستندات Button وCard للإشارة إلى كيفية إلغاء containerPainter وdisabledContainerPainter لcontainerColor وdisabledContainerColor (I4a453).
  • تم التراجع عن تغيير في TimeText في الإصدار السابق الذي نقل BroadcastReceiver إلى سلسلة مهام فرعية للعامل، لأنّه سبّب مشاكل للتطبيقات التي تدير سلاسل المهام الفرعية الخاصة بها أثناء التنقّل. (I34d02).
  • تم تعديل نماذج Picker لإزالة طلبات التذكر غير الضرورية واستخدام rememberUpdatedState في Picker بدلاً من ذلك لتذكر أحدث دالة contentDescription lambda. (Icb5b1).
  • تم تعديل أنماط النصوص في TimePicker وDatePicker لكي لا تؤدي تغييرات الخط إلى اقتطاع النص. (I26194).
  • أصبحت رمزَا ListHeader وListSubHeader الآن يحدّدان تلقائيًا محاذاة النص على أنّها محاذاة للوسط ومحاذاة للبداية على التوالي. (I78339).
  • تم تعديل نماذج وعروض توضيحية لـ "الانتقال السريع للكشف" في Foundation وMaterial Design للإعلان عن إجراءات تسهيل الاستخدام المخصّصة (يجب إضافة الإجراءات المخصّصة كدلالات على المحتوى، وليس على العنصر القابل للتجميع SwipeToReveal نفسه). (Ie92a3).
  • تم تعديل القيمة التلقائية MaxLines التي تم ضبطها على محتوى EdgeButton وفقًا لحجمه، وأصبحت الآن 1 للمحتوى الصغير جدًا و2 للمحتوى الصغير والمتوسط و3 للمحتوى الكبير. (Ie35f6).
  • تم تبسيط LocalReduceMotion لكي يتم تسجيل المُراقب مرة واحدة فقط، وذلك لتحسين الأداء. (Ib1979).
  • تم تقليل عدد عمليات إعادة الرسم في ScrollIndicator لتحسين الأداء. (Ia7a67).
  • تم إصلاح خلل في TransformingLazyColumn، حيث لم يتم تغيير حجم العنصر العلوي المرئي في القائمة بشكل صحيح عندما وصل EdgeButton إلى ارتفاعه الكامل. (I30580).

Wear Compose Material3 الإصدار 1.0

الإصدار 1.0.0-alpha37

‫23 أبريل 2025

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha37. يحتوي الإصدار 1.0.0-alpha37 على عمليات الربط هذه.

تغييرات واجهة برمجة التطبيقات

  • تمت إزالة scrollTransform من واجهة برمجة التطبيقات المتاحة للجميع. استخدِم مجموعة المُعدِّلات transformedHeight وgraphicsLayer إذا كنت بحاجة إلى الحصول على الوظيفة نفسها. (Ie181d)
  • تم استبدال العناصر القابلة للتجميع ImageButton وImageCard بتحميلات زائدة Button وCard/TitleCard على التوالي. تمت إعادة تسمية imageButtonColors إلى buttonWithContainerPainterColors وimageCardColors إلى cardWithContainerPainterColors. تمت إضافة ButtonDefaults.scrimBrush وCardDefaults.scrimBrush العلنيَين. تمت إعادة تسمية الزرَّين imageBackgroundGradientStartColor وimageBackgroundGradientEndColor إلى scrimGradientStartColor وscrimGradientEndColor. تمت إعادة تسمية CardDefaults.ImageContentPadding إلى CardDefaults.CardWithContainerPainterContentPadding (I7b8b6)
  • يأخذ كلّ من Picker وPickerGroup الآن contentDescription كلامدا لتجنُّب عمليات إعادة التركيب غير الضرورية. (I002dd)

إصلاح الأخطاء

  • تم حلّ مشكلة اهتزاز الرمز CircularProgressIndicator غير المحدّد أثناء عرض الصور المتحركة إذا لم يكن العرض مساويًا للارتفاع. (I76bfe)
  • تم إصلاح مشكلة في تنسيق الأزرار الجانبية عند استخدام حجم غير صالح. يمنع الآن تعديل تنسيق زرّ الحافة عندما يكون الارتفاع NaN. (I32b93)
  • تم زيادة الحد الأقصى لزاوية الفحص في OpenOnPhoneDialog حتى لا يتم اقتصاص النص التلقائي "الاطّلاع على الهاتف" عند استخدام أكبر حجم للخط. (I90af9)

الإصدار 1.0.0-alpha36

9 أبريل 2025

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha36. يتضمّن الإصدار 1.0.0-alpha36 عمليات الربط هذه.

تغييرات واجهة برمجة التطبيقات

  • تم استبدال ButtonDefaults.imageBackgroundButtonColors بـ ImageButton وButtonDefaults.imageButtonColors وButtonDefaults.containerPainter وButtonDefaults.disabledContainerPainter. وتغييرات مشابهة للبطاقة تتم إزالة الرسامين من ButtonColors وCardColors. (I8c6a1)
  • تم تعديل العناصر النائبة لتبسيط واجهة برمجة التطبيقات. نوفّر الآن مُعدِّلَين، Modifier.placeholderShimmer لتطبيق تأثير التمويه على مستوى المكوّن، وModifier.placeholder لتطبيق قناع على المحتوى الذي لم يتم تحميله (Iaee7a).

إصلاح الأخطاء

  • تم دمج ميزة التمرير السريع في ScrollIndicator. (Icfb7f)
  • معالجة الخلفيات الفارغة ومربّعات الحوار غير المتوفّرة عند تشغيل مربّعات حوار material3 (Ice597)
  • تم إصلاح مشاكل في FadingExpandingLabel عندما يمتد النص على عدة أسطر. (I04eb7)
  • تم تعديل المسافة بين التصنيفات الأساسية والثانوية على الأزرار. (I99b7b)
  • تم تقليل حجم ArcLarge من 20sp إلى 18sp، وتم تعديل المسافات بين الأحرف في ArcLarge وArcSmall. يستخدم ConfirmationDialog/OpenOnPhoneDialog الآن القيمة التلقائية ArcLarge بدلاً من إلغاء القيمة 18sp. (Id39a8)

تعديلات على التبعيات

  • تستهدف هذه المكتبة الآن مستوى لغة Kotlin 2.0 وتتطلّب استخدام الإصدار 2.0.0 من KGP أو إصدار أحدث. (Idb6b5)

الإصدار 1.0.0-alpha35

26 مارس 2025

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha35. يتضمّن الإصدار 1.0.0-alpha35 عمليات الربط هذه.

تغييرات واجهة برمجة التطبيقات

  • AlertDialog تم الآن تقليل المسافة البادئة العلوية تلقائيًا عند توفير رمز، ما يضمن الاستفادة إلى أقصى حد من حجم الشاشة المتاح. (Ief06c)
  • تمت إعادة تسمية PagerScaffoldDefaults.FadeOutAnimation إلى PagerScaffoldDefaults.FadeOutAnimationSpec. تمّت إعادة تسمية مَعلمة الصفحة في AnimatedPage ليصبح pageIndex. (I701f2)
  • تم تعديل أسماء SurfaceTransformation في TransformingLazyColumn: تم تقسيم applyTransformation إلى applyContainerTransformation وapplyContentTransformation، وتمت إعادة تسمية createBackgroundPainter إلى createContainerPainter. تعديلات إضافية على أسماء TransformationSpec وResponsiveTransformationSpec (I1c534)
  • تمت إعادة تسمية AppScaffold backgroundColor إلى containerColor. (I4e63f)

إصلاح الأخطاء

  • تم إصلاح مشكلة في FadingExpandingLabel تعذّر فيها توسيع النص بشكلٍ صحيح في بعض الأحيان. (I0e773)
  • تم تقليل حجم ArcLarge من 20sp إلى 18sp، وتم تعديل المسافات بين الأحرف في ArcLarge وArcSmall. يستخدم ConfirmationDialog/OpenOnPhoneDialog الآن القيمة التلقائية ArcLarge بدلاً من إلغاء ضبطها على 18sp. (Id39a8)
  • تم تعديل الصورة المتحركة للعنوان في DatePicker وTimePicker، بحيث تعمل الصورة المتحركة للاختفاء والتلاشي كصورة متحركة واحدة لميزة "الربيع". (I68963)
  • تم تحسين PagerScaffold عن طريق تجنُّب قراءة currentPageOffsetFraction في العنصر القابل للتجميع AnimatedPage. (I433ef)
  • تم تعديل جميع مقاييس الأنواع لعرض الأرقام النسبية تلقائيًا، لأنّ ذلك يُعدّ حالة الاستخدام الأكثر شيوعًا، وقد أدّى ضبط الإعداد التلقائي على "تنسيق جدولي" إلى زيادة المسافة بين أزواج أرقام معيّنة. يستمرّ استخدام TimePicker وDatePicker لتطبيق FontFeatureSetting=tnum على الأرقام الجدولية. (I88929)
  • تم تصحيح التركيز الأولي على إدخال RSB لكل من TimePicker وDatePicker. (I1c773)
  • تم تعديل النص التلقائي في OpenOnPhoneDialog ليصبح "التحقّق من الهاتف". (I00a3f)
  • تم تعديل الأوزان لـ ArcLarge وArcMedium من 600 إلى 599 لحلّ مشكلة يتم فيها التعامل مع الوزن 600 على أنّه غامق (I2a51d)
  • عدِّل SwipeToReveal المساحات الفارغة بين المحتوى وأزرار الإجراءات، وكذلك المسافة بين الرمز ونص أزرار الإجراءات. (Ic46cb)

الإصدار 1.0.0-alpha34

12 مارس 2025

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha34. يتضمّن الإصدار 1.0.0-alpha34 عمليات الربط هذه.

تغييرات واجهة برمجة التطبيقات

  • لم تعُد PagerScaffold تُنشئ مكوّن Pager، بل يجب توفيره من خلال content Composable. أصبحت AnimatedPage وsnapWithSpringFlingBehaviour علنية الآن ويمكن استخدامهما مع Wear Foundation Pager لتحقيق السلوك السابق لإصدار M3 PagerScaffold. (اطّلِع على العيّنات المعدّلة). (Ia4724)
  • تم تعديل PagerState، مع إزالة Compose Foundation PagerState كسمة الصف الأساسية وإضافة سمات currentPage وcurrentPageOffsetFraction وpageCount. تم تعديل واجهة GestureInclusion، وإعادة تسمية الطريقة إلى ignoreGestureStart. (I4ae07)
  • تم الآن إضافة تعليق توضيحي إلى مَعلمات زاوية التنظيف LevelIndicator باستخدام FloatRange(0, 360) (I7e636).
  • أضفنا CurvedModifier.clearAndSetSemantics لتوفير وسيلة لإيقاف الدلالات المنحنية. يستمر CurvedText في ضبط وصف المحتوى تلقائيًا على النص، ولكن لا يعلن timeTextCurvedText وtimeTextSeparator الآن عن محتوياتهما. (I4b568)
  • تمت إضافة مَعلمتَي الخلفية ولون المحتوى التلقائي إلى AppScaffold. (I56652)
  • تمت إعادة تسمية المعالجة التلقائية لـ HorizontalPager لإيماءات التمرير السريع لتصبح PagerDefaults.gestureInclusion. السلوك التلقائي الآن هو تجاهل إيماءات التمرير السريع التي تبدأ من الحافة اليسرى للصفحة الأولى فقط، وذلك عندما يكون تطبيق Talkback غير مفعَّل. وفي الحالات الأخرى، يكون السلوك التلقائي هو عدم تجاهل إيماءات التمرير السريع من قِبل عارض الشرائح، وبالتالي لن تكون متاحة لمعالجات التمرير السريع لإغلاق المحتوى. (Iee486)
  • تمت إضافة مَعلمة SurfaceTransformation إلى مكوّنات الزرّ والبطاقة وعنوان القائمة، حتى تتمكّن من تطبيق عمليات تحويل مختلفة للخلفية والمحتوى عند استخدامها في الحاويات التي تغيّر مظهر العناصر استنادًا إلى موضعها، مثل TransformingLazyColumn. (Iabe3f)
  • لقد عدّلنا سمات public const val في Wear Compose Material3 API إلى public val لتجنُّب تضمين القيم. (Ib0f32)
  • تمت إضافة منطقة التمرير السريع على الحافة إلى SwipeToReveal. أصبح السلوك التلقائي لنظام التشغيل Foundation SwipeToReveal الآن هو عدم السماح بالتمرير السريع عندما تبدأ الإيماءة من الحافة. أصبح السلوك التلقائي لعنصر SwipeToReveal’ في Material3 هو عدم السماح بالتمرير سريعًا عندما تبدأ الإيماءة من الحافة، وذلك عند ضبط SwipeDirection على اتجاه واحد. (I32ef0)
  • تمت إضافة رمز FadingExpandingLabel القابل للتجميع، ما يتيح تلاشي النص مع إضافة تأثيرات متحركة سطرًا تلو الآخر. (Ic60fa)
  • يستخدم TransformingLazyColumn الآن contentPadding فارغًا تلقائيًا بدلاً من وضع العنصر الأول والأخير في المنتصف. (I77ab7)
  • تمت إزالة rememberRevealState من SwipeToReveal من مكتبة Wear Compose Material3. (I8c0e0)

إصلاح الأخطاء

  • تم تحديث مكتبات Wear Compose إلى المُجمِّع Kotlin 2.0. (I2de79)
  • تمّت إزالة ScrollIndicator وPageIndicator غير المستديرَين من Material3. لم تعُد ميزة توافق الشاشة المربّعة جزءًا من متطلبات Wear OS، ويمكنك الاطّلاع على دليل البدء للحصول على مزيد من المعلومات. (I9a852)
  • تم تعديل الرمز CurvedTextStyle المستخدَم في ConfirmationDialogDefaults وOpenOnPhoneDialogDefaults لاستخدام خط ArcLarge بحجم 18sp ومسافة بين الأحرف 1.8sp. (Ic9ced)
  • لم تعُد Card وListHeader وRadioButton وCheckboxButton وSwitchButton تحدّ من ارتفاع المحتوى تلقائيًا. استخدِم Modifier.height(IntrinsicSize.Min) لاستعادة السلوك السابق عند الضرورة. (I80bb8)
  • لقد عدّلنا اللونَين التلقائيَين TimeText وScrollIndicator ليشملا المزيد من درجات اللون الرمادي، لأنّ استخدام OnBackground (الأبيض) مباشرةً كان يُضيف الكثير من التأثير البصري عند التنافس مع محتوى آخر على الشاشة، مثل العناوين. (I8b36f)
  • لقد خفّضنا مهلة عرض الصور المتحركة للعنصرَين TimeText وScrollIndicator في مكونات الإطار إلى ثانيتَين. (I52021)
  • لقد عدّلنا حركة مربّع الحوار لكي تتم مزامنة حجم خلفية مربّع الحوار مع التمرير السريع لإغلاقه. (I925a9)
  • أضِف عرضًا توضيحيًا لـ M3 SwipeToReveal باستخدام المُعدِّل edgeSwipeToDismiss. (I02b07)
  • أضفنا عنوانًا إلى DatePicker وTimePicker ضمن TalkBack لإعلام المستخدم بالتمرير لضبط التاريخ أو الوقت. (Id738d)
  • يتبع AnimatedText الآن إعداد "تقليل الحركة". (Ib6578)
  • تم تحسين التحسين لاستخدام AppScaffold لعرض محتوى مربّع الحوار للسماح بعرض مربّعات حوار متعددة فوق بعضها (I1209c).

الإصدار 1.0.0-alpha33

26 شباط (فبراير) 2025

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha33. يتضمّن الإصدار 1.0.0-alpha33 عمليات الربط هذه.

تغييرات واجهة برمجة التطبيقات

  • لقد أزلنا مَعلمة التصنيف من primaryAction وsecondaryAction في SwipeToRevealScope. على المطوّر إضافة دلالات الإجراءات المخصّصة إلى محتوى المكوّن SwipeToReveal مباشرةً. (Ia67f3)
  • لقد أزلنا بادئات Button (زر) من أحجام وأنماط النصوص ودوالّ الألوان في IconToggleButtonDefaults وTextToggleButtonDefaults (I5471d).
  • لقد أزلنا الإصدار التجريبي من LocalMinimumInteractiveComponentEnforcement (I4ad8a).
  • لقد استبدلنا لغة PickerGroupScope DSL بلغة قابلة للتجميع. نتيجةً لذلك، أزلنا الطريقة pickerGroupItem من PickerGroupScope، وأضفنا بدلاً منها @Composable PickerGroupItem التي يجب استخدامها لإضافة أداة اختيار إلى PickerGroup. عدّلنا أيضًا نوع مَعلمة PickerGroup 'content' إلى @Composable PickerGroupScope.() -> Unit. (Ic6aec)
  • أضفنا طريقة تحميل زائدة LevelIndicator للقيم الكسورية وأضفنا بادئة Stepper إلى طرق التحميل الزائدة التي تتضمّن مَعلمة نطاق (والتي تكون مناسبة للاستخدام مع مكوّن Stepper). (If4234)
  • أضفنا TransformingLazyColumn TransformationSpec إلى واجهة برمجة التطبيقات، ما يتيح تحديد عمليات التحويل الدقيقة التي تحدث للعناصر أثناء تصفّحها في قائمة "المحتوى الذي يشبه المحتوى الخاص بك". (I21856)
  • لقد عدّلنا IconButtonShapes وIconToggleButtonShapes وTextButtonShapes وTextToggleButtonShapes لتكون متوافقة مع فئات compose/material3 (I5a081).
  • أضفنا مَعلمة overscrollEffect إلى ScalingLazyColumn وTransformingLazyColumn وScreenScaffold. (I0cee8)
  • أعدنا تسمية المَعلمة swipeDirection إلى revealDirection في rememberRevealState. (I7472f)
  • يتضمّن تطبيق Wear Pager الآن رمز PagerScope الخاص به بدلاً من استخدام رمز الإنشاء PagerScope. (I9195b)
  • لقد أزلنا العنصر القابل للتجميع LinearProgressIndicatorContent، يُرجى استخدام LinearProgressIndicator مباشرةً لكي يتم عرض التغييرات على القيم بشكل متحرك تلقائيًا. (I2c4ad)
  • أزلنا الدالة القابلة للتجميع CircularProgressIndicatorStatic وأضفنا دالة DrawScope عامة drawCircularProgressIndicator لها الوظيفة نفسها. يُرجى استخدام CircularProgressIndicator مباشرةً لكي يتم تطبيق تأثيرات متحركة على التغييرات تلقائيًا، ولكن يمكنك إنشاء عنصر قابل للتجميع من drawCircularProgressIndicator إذا كنت بحاجة إلى تأثيرات متحركة مخصّصة. (Ie762f)
  • لقد أعدنا ترتيب المَعلمات في DrawScope.drawCircularProgressIndicator لتحريك المَعلمة targetProgress للأعلى. (I8ab92)
  • تم تعديل واجهة برمجة التطبيقات OpenOnPhoneDialog لزيادة الوضوح والاتساق مع واجهة برمجة التطبيقات الأخرى. تمت إعادة تسمية المَعلمة show إلى visible، وأصبح المُتصل يقدّم الآن القيمة curvedText بدلاً من استخدام قيمة تلقائية. (Idec2d)
  • تمت إعادة تسمية openOnPhoneCurvedText إلى openOnPhoneDialogCurvedText (I65bdd).
  • أضفنا ScrollIndicatorColors لتوفير ألوان مخصّصة في ScrollIndicator. (I9eb8c)
  • السماح بضبط اللون المستخدَم لرسم خلفية خلف TimeText (I9f5d9)
  • تم تعديل الخطوط ArcLarge وArcMedium وArcSmall لتصبح CurvedTextStyle (Iffc41)
  • لقد أزلنا ScreenScaffoldDefaults.contentPaddingWithEdgeButton. (Ia923e)
  • أضفنا errorDim إلى ColorScheme للأخطاء ذات الأولوية العالية أو الإجراءات الطارئة، مثل تنبيهات السلامة أو نوافذ الحوار التي تشير إلى تعذُّر إكمال عملية أو أزرار الإيقاف. (I70998)

إصلاح الأخطاء

  • لقد ثبَّتنا wear.compose.material3 على الإصدار 1.15.0 من androidx.core.core (I132e9).
  • لقد حسّنا أداء مربّع الحوار باستخدام الرمز AppScaffold لوضع مربّعات الحوار فوق محتوى الشاشة الآخر (I1b9a4).
  • تم تقليل المساحة الفارغة الرأسية الداخلية لعنصر EdgeButton. (I1a5bb)
  • أضفنا سمات الأزرار إلى أزرار شريط التمرير. (I80cc6)

الإصدار 1.0.0-alpha32

29 كانون الثاني (يناير) 2025

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha32. يتضمّن الإصدار 1.0.0-alpha32 عمليات الربط هذه.

تغييرات واجهة برمجة التطبيقات

  • في CurvedTextStyle، قسمنا تباعُد الأحرف إلى تباعُد أحرف باتجاه عقارب الساعة وتباعُد أحرف عكس عقارب الساعة. هذا الإجراء مطلوب لأنّ الأحرف التي تُكتب باتجاه عقارب الساعة تنتشر من قاعدة الحرف، في حين تنتشر الأحرف التي تُكتب بعكس عقارب الساعة إلى الداخل (لذلك، يجب زيادة المسافة بين الأحرف) (I4b848).
  • لقد عدّلنا IconButtonShapes وIconToggleButtonShapes وTextButtonShapes وTextToggleButtonShapes لتحسين الاتساق في مكتبات Material3. يقدّم هذا التغيير أيضًا ميزة تخزين الأشكال المؤقت لتقليل عدد عمليات التوزيع. (I049fc)
  • أزلنا المَعلمة pressedShapeCornerSizeFraction من طريقة variantAnimatedShape في IconToggleButton وTextToggleButton (I58a65).
  • نحن بصدد إدخال تحسينات على عرض النصوص المنحنية (بما في ذلك TimeText) التي لا تتوافق مع الشاشات غير المستديرة. لم تعُد إتاحة استخدام شاشات غير دائرية جزءًا من متطلبات Wear OS، ويمكنك الاطّلاع على دليل البدء للحصول على مزيد من المعلومات. (I1cc1c)
  • لقد عدّلنا ButtonGroupScope في ButtonGroup، واستبدلنا ButtonGroupItem المستنِد إلى DSL بModifier.weight وModifier.minWidth وModifier.enlargeOnPress. (I16c3c)
  • في واجهة برمجة التطبيقات ButtonGroup API، عدّلنا العنصر ButtonGroupScope الجديد المستنِد إلى المُعدِّل: يُعرف العنصر enlargeOnPress الآن باسم animateWidth، ويأخذ InteractionSource بدلاً من MutableInteractionSource لأنّه ليس من الضروري تغييره. أضفنا أيضًا الثابت العام ButtonGroupDefaults.DefaultMinWidth، وهو الحد الأدنى التلقائي لعرض الأزرار في ButtonGroup. (Ie27ec)
  • عدّلنا السمة ListHeaderDefaults.contentColor لتبدأ بحرف صغير لأنّها سمة قابلة للتجميع (I125a5).
  • أضفنا مَعلمة وصف المحتوى إلى SliderDefaults.DecreaseIcon وSliderDefaults.IncreaseIcon، مع قيم تلقائية مناسبة (I2e1a7).
  • تمت إعادة تسمية المَعلمة spacing في Picker وPickerGroup إلى verticalSpacing (Ib75cc).
  • أزلنا ConfirmationDialogDefaults.successText وfailureText لأنّه من المتوقّع أن يقدّم المتصلون في ConfirmationDialog سلاسل تحتوي على سياق أكبر. تم أيضًا تغيير اسم confirmationCurvedText إلى confirmationDialogCurvedText. أخيرًا، تمت إعادة تسمية مَعلمة Dialog show إلى visible (مرئية) من أجل الاتساق مع التعديلات الأخيرة الأخرى على المربعات الحوارية. (I10074)
  • غيّر "IconButton" اسم "disabledImageOpacity" إلى "DisabledImageOpacity". (I5f94a)

إصلاح الأخطاء

  • أصلحنا خطأ في الرسوم المتحركة EdgeButton لاستخدام الحجم الصحيح في كل إطار (Id3b58).
  • تم إصلاح مشكلة عدم توافق animateContentSize مع Button. (Ib18a0)
  • لقد غيّرنا مقياس الخط الكبير للعنوان ليكون حجم الخط 18dp (Ic9d52).
  • لقد عدّلنا المسافة بين AlertDialog وحجم الرمز (Iac28c).
  • لقد أصلحنا مشكلة عدم الاتساق في نقاط التوقف للشاشة الكبيرة (الشاشات التي تبلغ دقتها 225 نقطة لكل بوصة أو أكثر هي شاشات كبيرة) (I36474).
  • تم إصلاح خطأ بسيط في موضع الأزرار (I952c2)

الإصدار 1.0.0-alpha31

15 كانون الثاني (يناير) 2025

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha31. يتضمّن الإصدار 1.0.0-alpha31 عمليات الربط هذه.

تغييرات واجهة برمجة التطبيقات

  • لقد عدّلنا جميع مكتبات Wear Compose إلى وضع "واجهة برمجة التطبيقات الصريحة". (Iebf9f)
  • لقد عدّلنا واجهات برمجة التطبيقات ScreenScaffold وEdgeButton لتسهيل تحديد مساحات تمويه المحتوى على الشاشات التي تتضمّن EdgeButton. في واجهة برمجة التطبيقات الجديدة، لا يتم تمرير size في EdgeButton إلا إلى EdgeButton، ويأخذ ScreenScaffold مَعلمة edgeButtonSpacing للتباعد بين EdgeButton ومحتوى القائمة. (I424fd)
  • في DatePicker، أعدنا تسمية المَعلمتَين minDate إلى maxDate وminValidDate إلى maxValidDate. في DatePickerColors، تمت إعادة تسمية المَعلمة selectedPickerContentColor إلى activePickerContentColor، والمَعلمة unselectedPickerContentColor إلى inactivePickerContentColor (Iba17b).
  • لقد عدّلنا القيمة التلقائية لـ ArcProgressIndicator إلى strokeWidth=6dp وننصح باستخدام diameter = 81.24% من ارتفاع الشاشة (I6f248).
  • عدّلنا Confirmation API لتعكس استخدامها كمربّع حوار. أصبح اسم العنصر القابل للتجميع الآن ConfirmationDialog، مع تعديلات مرتبطة بتسمية الألوان والفئات التلقائية. لقد أعادنا أيضًا تسمية المَعلمة show إلى visible للتوافق مع واجهات برمجة التطبيقات الأخرى لإنشاء الرسوم المتحركة. بالإضافة إلى ذلك، وفّرنا ConfirmationDialogContent وSuccessConfirmationDialogContent وFailureConfirmationDialogContent للحالات التي يحتاج فيها المطوّرون إلى تخصيص الصور المتحركة لمربّع الحوار في المقدّمة أو الخاتمة. (Iaeb33)
  • لقد عدّلنا CircularProgressIndicatorContent إلى CircularProgressIndicatorStatic (الصيغة غير المتحركة من CircularProgressIndicator) لكي يمكن استخدامها الآن لإنشاء CircularProgressIndicator باستخدام صور متحركة مخصّصة. (I1346f)
  • لقد صحّحنا ترتيب المَعلمات في ArcProgressIndicator، ووضعنا مَعلمة المُعدِّل أولاً (I4656a).
  • تم تحسين واجهة برمجة التطبيقات SwipeToReveal لتلقّي مَعلمة خانة نصية لتصنيفات الإجراءات (باستثناء الإجراء الثانوي) ولإزالة مَعلمات التصنيف من إجراء التراجع (I5b3db).

إصلاح الأخطاء

  • لقد أصلحنا خطأً كان يؤدي إلى تنشيط LongPress اللمسي أكثر من مرة في Button وCard وIconButton وTextButton (Ia8b0f).
  • تغييرات على تجربة المستخدم في AlertDialog: على الشاشات الكبيرة، أصبح زرا التأكيد والإغلاق أصغر حجمًا. تم أيضًا زيادة المسافة أسفل زرَّي التأكيد والإغلاق. (I4f066)
  • لقد غيّرنا مواصفات الحركة لملصق زر الإجراء في المكوّن SwipeToReveal. (Ib87fb)
  • تم تغيير SwipeToReveal لتوسيع الحاوية في الوقت نفسه الذي يتم فيه عرض النص. (I44cf8)
  • تم تحسين SwipeToReveal لتقديم ملاحظات لمسية عندما تتجاوز التمريرات السريعة الحدّ الأدنى الذي يتم فيه تنفيذ الإجراء الأساسي. (I23efe)
  • لقد عدّلنا SwipeToReveal لعرض علامة الحذف عند تدفّق النص تلقائيًا، وذلك للإجراءات الأساسية وإجراءات التراجع. (I71f5a)
  • لقد أصلحنا مشكلة كانت تؤدي إلى حدوث تقطُّع في الرسوم المتحركة في ButtonGroup. (I63f8f)
  • أضفنا دلالات نصية إلى AnimatedText (I6063c).
  • يعيد مربّع الحوار الآن ضبط نسبة عرض إلى ارتفاع الخلفية عند إزالة مربّع الحوار من التركيب (بدون هذا الإصلاح، قد تبقى شاشة الإطلاق في حالة تم تصغيرها) (Id24ac)
  • أضفنا تأثيرًا متحركًا لتغيير الشكل إلى الأزرار في مكوّن "المخطّط الزمني" (Id6ed3).

الإصدار 1.0.0-alpha30

11 كانون الأول (ديسمبر) 2024

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha30. يتضمّن الإصدار 1.0.0-alpha30 عمليات الربط هذه.

تغييرات واجهة برمجة التطبيقات

  • تمّت إعادة صياغة المُعدِّل scrollTransform لـ TransformingLazyColumn، ما أدّى إلى تغيير في واجهة برمجة التطبيقات. (I0c6dc)
  • عدّلنا IconToggleButtonShapes وTextToggleButtonShapes ليكون لديهما مَعلمتَا شكل مختلفتَين uncheckedPressed وcheckedPressed (I85dbd).
  • تظهر الآن خيارات غير صالحة للشهر أو اليوم في DatePicker، مع invalidPickerContentColor جديد، عند استخدام minDate أو maxDate. (If4541)
  • عدّلنا واجهة برمجة التطبيقات Stepper لتوفير خانتَي increaseIcon وdecreaseIcon، ويمكن إنشاء المحتوى الخاص بهما كالمعتاد من عنصر الرمز المخصّص للتركيب. (Id35da)
  • لقد عدّلنا dynamicColorScheme من خلال إزالة المَعلمة defaultColorScheme الاختيارية وعرض ColorScheme التي يمكن أن تحتوي على قيمة فارغة. وهذا يعني أنّه على المُرسِل معالجة الحالة الاحتياطية صراحةً في حال عدم توفير مخطط ألوان ديناميكي. (I6d62e)
  • لقد عدّلنا أحجام الرموز في ButtonDefaults لاستخدامها مع CompactButton. يجب استخدام ButtonDefaults.SmallIconSize = 24.dp مع CompactButton الذي يحتوي على رمز فقط، في حين يجب استخدام ButtonDefaults.ExtraSmallIconSize = 20.dp مع CompactButton الذي يحتوي على رمز ونص. ننصحك بلفّ CompactButton لمحتوى الصفحة (بدلاً من ملء الحد الأقصى للعرض) وتم تعديل العيّنات لإظهار ذلك. (I0582c)
  • أضفنا EdgeButtonDefaults مع أحجام الرموز المقترَحة للأنواع الأربعة المختلفة من EdgeButtonSizes. تم أيضًا تعديل تنسيق EdgeButton لكي يكون له مساحة أكبر قليلاً في أسفل الشاشة مقارنةً بالمساحة العلوية، ما يُحسِّن مظهر كلّ من الرمز والنص. (Id772a)
  • أضفنا حركة إلى LinearProgressIndicator وعرضنا LinearProgressIndicatorContent الذي يقدّم المحتوى المرئي بدون رسوم متحركة. (Idee99)
  • أضفنا عنصرًا جديدًا قابلاً للتجميع من النوع CircularProgressIndicatorContent لعرض المحتوى المرئي من CircularProgressIndicator بدون رسوم متحركة. (Ie33d4)
  • يوفّر TransformingLazyColumn الآن التركيب LocalTransformingLazyColumnItemScope المحلي الذي تستخدمه Card وButton وListHeader الآن للتحويل التلقائي عند وضعها داخل TransformingLazyColumn. يمكن للمتصلين إيقاف ميزة "التحويل التلقائي" باستخدام حزمة TransformExclusion الجديدة. (I1652f)
  • لقد عدّلنا نوع ButtonDefaults.shape إلى RoundedCornerShape (Iccdf2).

إصلاح الأخطاء

  • لقد أصلحنا خطأً في ما يتعلّق بتطبيق قيمة شفافية الخلفية الحالية على TimeText (I1eb60).
  • لقد ضبطنا TextMotion على Animated تلقائيًا في الطباعة لدينا، لتجنّب اهتزاز النص بسبب التصاق أشكال الحروف بحدود البكسل أثناء عمليات التكبير/التصغير. (I626fa)
  • لقد عدّلنا مظهر ScrollIndicator من خلال زيادة العرض وحجم الفجوة لتحسين مستوى الظهور. (Ied7cb)
  • لقد أصلحنا خطأً في Modifier.scrollTransform عند إضافة/إزالة/نقل العناصر. (I6830f)
  • لقد أصلحنا مشكلة في الصورة المتحركة للزر المستدير عند النقرات القصيرة (في السابق، لم يكن الحد الأدنى لمدة الصورة المتحركة مُتّبعًا دائمًا). (I757a7)
  • لقد عدّلنا زاوية التنظيف لـ LevelIndicator إلى %20 (أي 72 درجة). (Idde5c)
  • لقد أصلحنا موضع ScrollIndicator عند استخدام ScalingLazyColumn مع AutoCenteringParams. (I387dd)
  • لقد عدّلنا الألوان وأسلوب الخط في ListHeader وListSubHeader. بالإضافة إلى ألوان عناصر التحكّم في التبديل على CheckboxButton وSwitchButton. (I39817)
  • لقد أصلحنا موضع ScrollIndicator في LazyColumn وScalingLazyColumn باستخدام ContentPadding. (I2bc51)
  • لقد أصلحنا خطأً في الصورة المتحرّكة لتقدّم OpenOnPhoneDialog باستخدام CircularProgressIndicatorContent الجديد. (I3e443)
  • عدّلنا HorizontalPagerScaffold وVerticalPagerScaffold لإيقاف الصور المتحركة عند تفعيل ميزة "تقليل الصور الحيّة" (Iaaf68).
  • لقد نفّذنا صورة متحركة منفصلة لمؤشرات التقدّم الدائرية عندما يصل التقدّم إلى أكثر من %100. (I47135)
  • أصلحنا خطأً كان يؤدي إلى رسم EdgeButton بشكل غير صحيح في مكوّنات Pager (I91db9).

الإصدار 1.0.0-alpha29

13 تشرين الثاني (نوفمبر) 2024

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha29. يحتوي الإصدار 1.0.0-alpha29 على عمليات الربط هذه.

تغييرات واجهة برمجة التطبيقات

  • لقد عدّلنا TimeText لتوفير محتوى تلقائي يعرض الوقت. (Id23b3)
  • لقد سهّلنا استخدام المَعلمة ScrollInfoProvider في PagerState من خلال إزالة المَعلمة orientation التي لم تعُد مطلوبة. يقضي السلوك الجديد ببقاء TimeText في مكانه لكلٍّ من التنقل الأفقي والرأسي للصفحات. (I71767)
  • يوفّر LocalHapticFeedback الآن طريقة تنفيذ HapticFeedback تلقائية عندما تشير واجهة برمجة التطبيقات Vibrator API إلى أنّ ميزة اللمس المفاجئ متاحة. تمّت إضافة العناصر التالية إلى HapticFeedbackType: Confirm وContextClick وGestureEnd وGestureThresholdActivate وReject وSegmentFrequentTick وSegmentTick وToggleOn وToggleOff وVirtualKey. في تطبيق "هاتف Wear OS"، تؤدي الآن المكونات القابلة للنقر مع الاستمرار، مثل Button وIconButton وTextButton وCard، إلى التأثير LONG_PRESS عند توفير معالِج للنقر مع الاستمرار. (I5083d)

إصلاح الأخطاء

  • لقد عدّلنا طلب التأكيد. (I04bff)
  • لقد عدّلنا الحد الأدنى لمتطلبات واجهة برمجة التطبيقات إلى 1.7.4 لمكتبات Compose. (I88b46)
  • تمت إضافة حركة جديدة لمربّع الحوار OpenOnPhone. (I1e10a)
  • لقد أصلحنا خطأ في LevelIndicator بحيث يتم عرضه الآن بشكل صحيح مع ضبط المستوى على القيمة صفر. (Ie95a4)
  • لقد عدّلنا الرسوم المتحركة HorizontalPageIndicator وVerticalPageIndicator. (I5c8f3)
  • أضفنا صورة متحركة للتقلص إلى نقطة إلى الرمز ArcProgressIndicator غير المحدد. (I9fd51)

الإصدار 1.0.0-alpha28

30 تشرين الأول (أكتوبر) 2024

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha28. يتضمّن الإصدار 1.0.0-alpha28 عمليات الربط هذه.

تغييرات واجهة برمجة التطبيقات

  • أضفنا شكل قوس إلى مؤشر التقدّم الدائري غير المحدّد (I2efc1).
  • لقد طرحنا علنًا العناصر القابلة للتجميع AlertDialogContent وDialog التي تشكّل واجهة برمجة التطبيقات AlertDialog، ما يتيح إضافة تخصيصات إذا لزم الأمر (مثل تخصيص الرسوم المتحركة AlertDialog مع الحفاظ على تنسيق المحتوى المقترَح). بالإضافة إلى ذلك، أضفنا المَعلمتَين Modifier وColor إلى الأعضاء EdgeButton وConfirmButton وDismissButton في AlertDialogDefaults. (I4eb71)
  • عدّلنا واجهة برمجة التطبيقات Placeholder على النحو التالي: تمت إعادة تسمية PlaceholderState.startPlaceholderAnimation إلى PlaceholderState.animatePlaceholder وPlaceholderState.isShowContent إلى PlaceholderState.isHidden وPlaceholderDefaults.shape إلى PlaceholderDefaults.Shape، كما تمت إعادة تسمية المَعلمة painter في painterWithPlaceholderOverlayBackgroundBrush إلى originalPainter، وتغيير مستوى رؤية PlaceholderState.placeholderProgression من "عام" إلى "داخلي" وإعادة تسميته إلى placeholderShimmerProgression، وإضافة ثوابت مدة التأثير المتحرك للعنصر النائب إلى PlaceholderDefaults. (Ie5a59)
  • عدّلنا واجهة برمجة التطبيقات EdgeButton على النحو التالي: إعادة تسمية المَعلمة في ScreenScaffold من bottomButton إلى edgeButton، وجعلنا EdgeButtonSize فئة قيمة. (Ieef15)
  • لقد غيّرنا مستوى عرض copy() إلى "علني" في فئات Wear Material3 Colors (I0287f).

إصلاح الأخطاء

  • تمت إضافة الحدّ الأدنى لمدّة الصورة المتحركة للرمزَين IconToggleButton وTextToggleButton عند النقر (Ieb333)
  • تمّ إضافة الحدّ الأدنى لمدة الصور المتحركة للشكلَين IconButton وTextButton (Iebcee)
  • تم تصحيح حالة خيار التكرار DatePicker. (I3587c)
  • تمت إضافة ميزة رصد الحركة لمربّعات الحوار "تنبيه" و"تأكيد". (I173b1)

الإصدار 1.0.0-alpha27

16 أكتوبر 2024

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha27. يتضمّن الإصدار 1.0.0-alpha27 عمليات الربط هذه.

تغييرات واجهة برمجة التطبيقات

  • لقد عدّلنا ScreenScaffold وScrollIndicator بعد إعادة تسمية Wear Compose Foundation LazyColumn إلى TransformingLazyColumn. (I0608b)
  • تمت إعادة تسمية المَعلمة preferredHeight في EdgeButton إلى buttonSize، ولا يمكن اختيار قيمتها إلا من بين 4 ثوابت في فئة القيم EdgeButtonSize التي تمّ طرحها مؤخرًا. (Icdd70)
  • غيّرنا اسم ListSubheader إلى ListSubHeader وأضفنا قيمًا تلقائية متاحة للجميع لكل من ListHeader وListSubHeader. (I96730)
  • أضفنا مكوّنات HorizontalPagerScaffold وVerticalPagerScaffold جديدة لنظام التشغيل Wear، وهي توفّر رسومًا متحركة جديدة وتنسيقًا جديدًا بين نص الوقت ومكوّنات مؤشر الصفحة. (Iff7d0)
  • لقد أضفنا ميزة التنقّل بالتناوب إلى HorizontalPagerScaffold وVerticalPagerScaffold، ما يتيح للمستخدمين التنقّل في أجهزة الردّ الآلي باستخدام أجهزة الإدخال بالتناوب. (I9770d)
  • أجرينا تغييرات على MotionScheme واجهة برمجة التطبيقات لتبسيط الاستخدام وتحسين التناسق. تمّت إزالة دوال remember المضمّنة ونقل مخطّطات الحركة المضمّنة إلى كائن مصاحب مخصّص لمخطّط الحركة. تمت إعادة تسمية standardMotionScheme وexpressiveMotionScheme ليصبحا "عادي" و"تعبيري". (I5fd45)
  • لقد أضفنا إمكانية استخدام نظام ألوان ديناميكي استنادًا إلى ألوان النظام. (I073e9)
  • لقد عدّلنا عنصر "المخطّط الزمني" وفقًا لأحدث مواصفات تجربة المستخدم. (I622bb)

إصلاح الأخطاء

  • لقد عدّلنا أسلوب الخط والمسافات البادئة لمكوّنات "البطاقة". (I3ae48)
  • لقد غيّرنا سمة الحشو في AlertDialog بين زرَّي "تأكيد" و"إغلاق" وبقية المحتوى من 8dp إلى 12dp وفقًا لمواصفات تجربة المستخدم (Ie55f0).
  • لقد عدّلنا شفافية اللون لمكوّن "شريط التمرير". (Idb383)

الإصدار 1.0.0-alpha26

2 أكتوبر 2024

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha26. يتضمّن الإصدار 1.0.0-alpha26 عمليات الربط هذه.

تغييرات واجهة برمجة التطبيقات

  • عدّلنا واجهة برمجة التطبيقات ومظهر HorizontalPageIndicator وأضفنا VerticalPageIndicator لاستخدامه مع VerticalPager (Ic9309).
  • تتيح AlertDialog الآن إمكانية حذف الزر السفلي التلقائي من الصيغة المخصّصة لترتيب الأزرار، وذلك للتنسيقات المخصّصة التي لا يكون فيها EdgeButton مطلوبًا. (I34fa9)
  • أضفنا مكوّن SwipeToReveal لنظام التشغيل Wear Material 3 (Ic38b2).
  • لقد أضفنا إمكانية التمرير السريع في الاتجاهين في SwipeToReveal، وذلك للحالات النادرة التي لا تتيح فيها الشاشة الحالية التمرير السريع لإغلاق التطبيق. لا يزال الإعداد التلقائي هو التمرير السريع للكشف عن المحتوى فقط عند التمرير السريع من اليمين إلى اليسار، وينصح بشدة باحترام السلوك التلقائي لتجنُّب التعارض مع التمرير السريع لإغلاق المحتوى. (Ifac04)
  • أعدنا تسمية المَعلمة buttonHeight في EdgeButton إلى preferredHeight. (I4fab3)
  • تم تحديث إصدار Kotlin إلى 1.9 (I1a14c).
  • تمت إعادة تسمية OpenOnPhoneDialogDefaults.Icon إلى OpenOnPhoneDialogDefaults.OpenOnPhoneIcon لتجنُّب تداخلها مع Icon(I0f391).
  • أصبح بإمكانك استخدام ScrollIndicator في LazyColumn. (Ia546a)
  • عدّلنا القيم التلقائية لكلّ من TextToggleButton وIconToggleButton. (I7aaa9)
  • لقد بسّطنا واجهتَي برمجة التطبيقات Picker وPickerGroup. (Id0653)
  • لقد أضفنا CardDefaults.Shape وCardDefaults.Height، وهما رمزان خاصان بالمطوّرين الذين يستخدمون المكتبة. (I1594a، b/347649765)
  • لقد أعادنا تسمية مَعلمة التقدّم لمؤشر التقدّم الدائري المقسّم إلى ثنائي إلى segmentValue. (Ib72d9)
  • لقد عدّلنا الألوان والتنسيق في شريط التمرير. (Ic3eec)

إصلاح الأخطاء

  • لقد عدّلنا الصورة المتحركة لرمز openOnPhone (I66f85).
  • نحن نستخدم الآن رموز Google Symbols في Slider وTimePicker وDatePicker. (I46c7c)
  • لقد عدّلنا الحشو في Confirmation وOpenOnPhoneDialog. (Iaa82e)

الإصدار 1.0.0-alpha25

18 أيلول (سبتمبر) 2024

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha25. يتضمّن الإصدار 1.0.0-alpha25 عمليات الربط هذه.

تغييرات واجهة برمجة التطبيقات

  • أضفنا مؤشر تقدّم دائريًا غير محدّد. (I427a7)
  • أضفنا إمكانية عرض قيمة متغيرة للتقدّم (>100%) لكل من CircularProgressIndicator وSegmentedCircularProgressIndicator. عندما يتجاوز مستوى التقدّم 1.0، سيتم الإشارة إلى ذلك من خلال اللون overflowTrack الجديد. (Iaaa3d)
  • يتيح الآن الرمزان المستديران IconToggleButton وTextToggleButton استخدام شكل جديد للحركة المتحركة، حيث تمثّل الأشكال المختلفة حالات وضع علامة في المربّع وعدم وضع علامة فيه والضغط عليه. ولا يزال الشكل المتحرك السابق متاحًا للحالة "تم الضغط للتو". (I29f03)
  • لقد أزلنا إمكانية استخدام EdgeButton مع Column، وذلك بسبب الحاجة إلى تحديد ارتفاع EdgeButton صراحةً في ScreenScaffold. (Ie353d)
  • لقد أضفنا إمكانية استخدام ميزة LazyColumn في تطبيق Wear Compose مع ScreenScaffold (وأضافنا تنفيذًا لميزة ScrollInfoProvider في LazyColumnState). (Ib8d29)
  • لقد دمجنا LocalTextMaxLines وLocalTextAlign وLocalTextOverflow في تركيبة LocalTextConfiguration واحدة على الجهاز لتوفير حلّ أكثر قابلية للتوسّع من الآن فصاعدًا. (I5edbc)
  • أضفنا arc-large كنوع خط إضافي مخصّص لسلاسل نص الرأس القصيرة في أعلى الشاشة أو أسفلها تمامًا، مثل النصوص المركّبة لتأكيد الإجراء. (I60e3e)
  • أضفنا قيمًا تلقائية إلى Button لحجم الرمز الكبير والكبير جدًا المُقترَحَين وملء المحتوى. (I84675)

إصلاح الأخطاء

  • لقد عدّلنا ألوان IconButton وTextButton. (I48324)
  • لقد غيّرنا عمليات تحميل Button الأساسية لتصبح محاذية عموديًا في الوسط من أجل الاتساق مع عمليات التحميل الأخرى. لاستعادة السلوك السابق، استخدِم Modifier.align من RowScope. (I66e57)

الإصدار 1.0.0-alpha24

4 أيلول (سبتمبر) 2024

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha24. يتضمّن الإصدار 1.0.0-alpha24 عمليات الربط هذه.

تغييرات واجهة برمجة التطبيقات

  • أضفنا مخطّطًا للحركة إلى مظهر Material3. ستستخدم المكوّنات هذه الميزة في جميع أنحاء المكتبة لتطبيق مواصفات الحركة، مثل العناصر المرنة للحركة التعبيرية. (I54ff3)
  • أضفنا مكوّنات AppScaffold وScreenScaffold إلى مكتبة Material3، والتي تتضمّن وظائف لتنسيق الطبقات وعمليات النقل في TimeText وScrollIndicator. AppScaffold يوفّر مستوى أعلى من مكوّنات إطار العمل التي تظهر أعلى جميع الشاشات. وبالتالي، فإنّ إضافة TimeText إلى AppScaffold تسمح له بالبقاء في مكانه أثناء التمرير السريع بين الشاشات. يمكن للشاشات نفسها إلغاء نص الوقت أو إخفائه. يوفّر ScreenScaffold خانة ScrollIndicator ويُنشئ تلقائيًا مؤثرًا متحركًا لمؤشر الانتقال عند الانتقال، بما في ذلك مهلة لإخفاء مؤشر الانتقال بعد فترة من عدم النشاط. (I047d6)
  • أضفنا ScrollIndicator الذي يعرض تصميم Material3 الجديد. ويتم ضبط حجم مصغّر ثابت استنادًا إلى محتوى القائمة الأولي، وذلك لتجنُّب اختلافات الحجم عند تحميل المحتوى غير القابل للتقديم أو الإيقاف إلى القائمة. (Ic228d)
  • لقد غيّرنا واجهة برمجة التطبيقات ScrollAway بحيث تكون ScreenStage فئة قيمة بدلاً من فئة مصنّف، للسماح بإضافة مراحل إضافية حسب الحاجة من الآن فصاعدًا. (I48c93)
  • أضفنا EdgeButton، وهو زر مميز مخصّص لنظام التشغيل Wear بتصميم يتلاءم مع منحنى أسفل الشاشة (I16369).
  • أضفنا خانة جديدة إلى ScreenScaffold لزر في أسفل الشاشة (مثل EdgeButton)، وسيتم عرض هذا الزر وتغيير حجمه استنادًا إلى المحتوى الذي يتم التمرير إليه (I032eb).
  • أضفنا Modifier.scrollTransform وModifier.targetMorphingHeight لإضافة تأثيرات الحركة في Material3 إلى العناصر في LazyColumn. (Ie229a)
  • أضفنا SegmentedCircularProgressIndicator كخيار متغير في CircularProgressIndicator. يعرض السعر المتغير المقسّم قيمة واحدة للتقدّم في جميع الشرائح أو يعرض كل شريحة على أنّها مفعّلة/متوقفة. (I6e059)
  • أضفنا LinearProgressIndicator كبديل عن CircularProgressIndicator الحالي. (I89182)
  • أضفنا AlertDialog، وهي تنسيقات لعرض طلبات مهمة للمستخدم. يتم تضمين صيغ لأيّ من زرَّي التأكيد/الإغلاق أو زرّ واحد في أسفل الشاشة (عادةً ما يكون زرّ EdgeButton) أسفل حزمة من الخيارات. يتضمّن كلا الصيغ خانات للرمز والعنوان والنص الإضافي لتقديم مزيد من التفاصيل. (Ieb873)
  • أضفنا OpenOnPhoneDialog، والذي يجب استخدامه للإشارة إلى إجراء سيستمر على هاتف المستخدم. يتم رفض OpenOnPhoneDialog بعد انتهاء مهلة محدّدة. (I978fd)
  • أضفنا Confirmation، وهو مكوّن مربّع حوار يتضمّن خانات لرمز ونص منحني أو خطي. يتم توفير صيغ معيّنة لرسائل النجاح أو الإخفاق. يتم إغلاق رسائل التأكيد تلقائيًا بعد انتهاء مهلة. (Ib43e8)
  • أضفنا خلفية إلى TimeText للحدّ من المشاكل التي كان فيها المحتوى الأساسي وTimeText يتداخلان ويحجبان الوقت. (Ia11fd)
  • أضفنا LevelIndicator الذي يعرض قيمة إعداد مثل مستوى الصوت، ويمكن استخدامه مع المكوّن الحالي Stepper لإنشاء شاشة مستوى الصوت. يشبه الرمز LevelIndicator الرمز ScrollIndicator، ولكن يتم عرضه على الجانب المقابل من الشاشة، كما أنّه يتميز بعرض خطوط أوسع ولون مؤشر مختلف تلقائيًا. (I8a4ac)
  • أضفنا TimePicker، مع تنسيقات للوقت بنظام 24 ساعة (مع الثواني أو بدونها)، أو الوقت بنظام 12 ساعة مع اختيار am/pm. (Ia5124)
  • أضفنا DatePicker، مع إعدادات لترتيب الأعمدة (أي اليوم-الشهر-السنة أو الشهر-اليوم-السنة أو السنة-الشهر-اليوم) والتاريخَين الأدنى/الأعلى الاختياريَين. (Ibf13b)
  • أضفنا مَعلمة weight إلى الدالة text في TimeText. في الحالات التي يتألّف فيها TimeText من أكثر من عنصر نصي واحد، يتيح ذلك التحكّم في كيفية توزيع المساحة. (I36700)
  • لقد أضفنا RadioButton وSplitRadioButton. تعمل هذه المكوّنات على تبسيط واجهة برمجة التطبيقات السابقة من خلال دمج كل من (Split)SelectableButton وعنصر التحكّم في الراديو الفرعي (If7ae8).
  • أضفنا CheckboxButton وSplitCheckboxButton، وهما مكوّنان يبسطان واجهة برمجة التطبيقات السابقة من خلال دمج كل من العنصرَين (Split)ToggleButton وعنصر التحكّم في مربّع الاختيار الفرعي (Ia8f70).
  • أضفنا SwitchButton وSplitSwitchButton - تعمل هذه المكوّنات على تبسيط واجهة برمجة التطبيقات السابقة من خلال دمج كل من (Split)ToggleButton وعنصر التحكّم الفرعي "مفتاح تبديل" (I0d349).
  • لقد عدّلنا مستندات AnimatedText لشرح سلوك تجاوز السرعة. (Iff30a)
  • أضفنا ButtonGroupلدمج زرَّين أو 3 أزرار بحيث تؤدي الضغطات على الأزرار إلى إنشاء صورة متحركة منسقة. (Ie27db)
  • أضفنا شكلًا متحركًا اختياريًا للرمزَين IconButton وTextButton عند الضغط عليهما. (Iffca5)
  • أضفنا لونًا إضافيًا، وهو FilledVariant، إلى Button وIconButton وTextButton وCompactButton وEdgeButton (I65fc3).
  • أضفنا المَعلمة forcedSize إلى ImageWithScrimPainter، بحيث تحافظ خلفيات صور الأزرار الآن على حجم المكوّن تلقائيًا. يؤدي ضبط forcedSize = null إلى استخدام Painter.instrinsicSize بدلاً من ذلك. (Ic57af)
  • أضفنا النقر مع الاستمرار على الأزرار (Ib613d).
  • تمت أيضًا إضافة إمكانية النقر مع الاستمرار على IconButton وTextButton. (I38891)
  • تمت إضافة ميزة الضغط مع الاستمرار إلى "البطاقات". (I305d5)
  • أضفنا LocalTextMaxLines وLocalTextAlign وLocalTextOverflow كCompositionLocals واستخدمناها كمَعلمات تلقائية في Text. يمكن الآن استخدام متغيرات التكوين المحلية من خلال مكوّنات مثل CheckboxButton وSwitchButton وRadioButton لتنفيذ إرشادات تجربة المستخدم، ولكن يمكن للمطوّرين إلغاء المَعلمات إذا لزم الأمر. (Iab841)
  • أضفنا Placeholder للمساعدة في إخفاء محتوى المكوّنات، مثل الأزرار والبطاقات، إلى أن يتم تحميل البيانات. (I1a532)
  • أضفنا IconToggleButtonColors وTextToggleButtonColors لاستبدال ToggleButtonColors الذي تمت إزالته الآن. (Ie0bf1)

إصلاح الأخطاء

  • لقد عدّلنا Button وFilledTonalButton وOutlinedButton وChildButton وCompactButton لاستخدام CompositionLocals LocalTextMaxLines وLocalTextAlign وLocalTextOverflow الجديدة لتنفيذ إرشادات تجربة المستخدم. ويمكن للمطوّرين إلغاء هذه المَعلمات في النص مباشرةً إذا لزم الأمر (Ie51f7).
  • لقد غيّرنا سمك الخطوط التلقائي للرمز LevelIndicator إلى 6dp لتمييزه عن الرمز ScrollIndicator الذي يبلغ سمك خطوطه 4dp. (If6f63)
  • لقد أصلحنا مشكلة في TimeText لتصبح زوايا التنظيف أكبر. (Ie489f)
  • تم إصلاح مشكلة أثناء إعادة تركيب EdgeButton. (I4cdca)
  • تم تصحيح تنسيقات أزرار التبديل المجزّأة عند توفير مساحة مخصّصة للمحتوى. (Ia33d3)
  • يتم تقريب القيم الصغيرة لتقدّم الإجراء إلى ما لا يقل عن عرض خط مؤشر التقدّم. (I3bd84)

الإصدار 1.0.0-alpha23

14 أيار (مايو) 2024

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha23. يحتوي الإصدار 1.0.0-alpha23 على عمليات الربط هذه.

تغييرات واجهة برمجة التطبيقات

  • لقد عدّلنا واجهات برمجة التطبيقات ToggleButton وRadioButton لكي يمكن ضبط الألوان المُعطَّلة. (If13a7)
  • أضفنا CircularProgressIndicator جديدًا لتصميم Material3. (Ib3bd7)

إصلاح الأخطاء

  • لقد أصلحنا خطأً كان يعرض رسالة "انقر مرّتين لتبديل الحالة" على الأزرار القابلة للاختيار عندما تكون محدّدة. (I7ed88)

الإصدار 1.0.0-alpha22

1 مايو 2024

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha22. يتضمّن الإصدار 1.0.0-alpha22 عمليات الربط هذه.

تغييرات واجهة برمجة التطبيقات

  • لقد عدّلنا ColorScheme في Material3. (I7b2b8)
  • لقد عدّلنا مفتاح التبديل في Material3، بالإضافة إلى بعض التغييرات على الألوان، وأصبح الآن مطابقًا للعلامة المستخدَمة في مربّع الاختيار. (Icac7b)

إصلاح الأخطاء

  • عدِّل جميع العروض التوضيحية لعملية الدمج لاستخدام المُعدِّل rotaryScrollable الجديد. (I25090)

الإصدار 1.0.0-alpha21

17 نيسان (أبريل) 2024

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha21. يتضمّن الإصدار 1.0.0-alpha21 عمليات الربط هذه.

  • تم طرح هذا الإصدار بسبب مشكلة فنية في الإصدار السابق أدّت إلى عدم توفّر حِزم المصدر. ما مِن عمليات إرسال جديدة في هذا الإصدار.

الإصدار 1.0.0-alpha20

3 نيسان (أبريل) 2024

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha20. يحتوي الإصدار 1.0.0-alpha20 على عمليات الربط هذه.

إصلاح الأخطاء

  • لقد عدّلنا قيم شفافية تأثير التموج في حالتَي الضغط والتركيز لزيادة التباين. (I59f0a)
  • أضفنا مسافة بين التصنيفات الأساسية والثانوية في Button وToggleButton وRadioButton، وذلك بعد إجراء آخر التغييرات على أنماط الطباعة وارتفاعات الأسطر. (I2c0ba)

الإصدار 1.0.0-alpha19

‫6 مارس 2024

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha19. يتضمّن الإصدار 1.0.0-alpha19 عمليات الربط هذه.

تغييرات واجهة برمجة التطبيقات

  • أضفنا TimeText إلى مكتبة Material3 في Wear Compose. يعرض هذا المكوّن الوقت الحالي (والحالة الإضافية) في أعلى الشاشة. تتجنّب واجهة برمجة التطبيقات الجديدة والموجزة Material3 API تكرار المحتوى المستقيم والمنحني. (I4d7c3)
  • لقد عدّلنا أسماء المَعلمات من onSelected إلى onSelect في RadioButton. (I1a971)
  • يمكنك تقسيم RadioButton وSplitRadioButton إلى وحدات ترميز، وإعادة تنظيم الطرق الحالية لتقليل عدد عمليات البحث عن CompositionLocal من خلال إضافة نُسخ مخزّنة مؤقتًا من الألوان، وجعل طرق RadioButtonColors وSplitRadioButtonColors داخلية. (I02b33)

الإصدار 1.0.0-alpha18

21 شباط (فبراير) 2024

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha18. يحتوي الإصدار 1.0.0-alpha18 على هذه المراجعات.

تغييرات واجهة برمجة التطبيقات

  • لقد أعدنا تنظيم نمط الإعدادات التلقائية لـ CardColors وToggleButtonColors وSplitToggleButtonColors من خلال إنشاء نُسخ مؤقتة داخليًا وتقليل استخدام CompositionLocal. (If3fec)

الإصدار 1.0.0-alpha17

7 شباط (فبراير) 2024

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha17. يحتوي الإصدار 1.0.0-alpha17 على هذه المراجعات.

تغييرات واجهة برمجة التطبيقات

  • لقد عدّلنا Button API لاستخدام buttonColors تلقائيًا وإزالة filledButtonColors المكرّر. (I4fe3b)
  • لقد أعدنا تنظيم الأنماط التلقائية لـ ButtonColors وIconButtonColors وTextButtonColors من خلال إنشاء مثيل محفوظ مؤقتًا داخليًا وتقليل استخدام CompositionLocal. (I5f51c)
  • لقد أزلنا التكلفة الإضافية rememberUpdatedState في فئات الألوان الخاصة بالمكوّنات ووضعنا علامة على طرق الوصول داخل فئات الألوان على أنّها داخلية. (If6571)

إصلاح الأخطاء

  • لقد عدّلنا Modifier.minimumInteractiveComponentSize لاستخدام Modifier.node. (Iba6b7)

الإصدار 1.0.0-alpha16

24 كانون الثاني (يناير) 2024

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha16. يحتوي الإصدار 1.0.0-alpha16 على هذه المراجعات.

الميزات الجديدة

  • أضفنا CompactButton، الذي يمكنه استخدام الألوان المعبّأة والمعبّأة بدرجات لونية والمخطّطة نفسها المستخدَمة في Button.(I05df0)

تغييرات واجهة برمجة التطبيقات

  • أضفنا RadioButton/SplitRadioButton كسِيّارات لعناصر التحكّم في الاختيار، مثل عنصر التحكّم في زر الاختيار. يختلف هذا عن العنصر ToggleButton الحالي في أنّ RadioButton قابل للاختيار (ويعمل ضمن مجموعة اختيار) في حين أنّ ToggleButton قابل للتبديل (وهو مستقل). (I61275)
  • نعمل على إزالة LocalContentAlpha من مكتبة Wear Compose Material3 للحفاظ على اتساقها مع مكتبة Compose Material3. (I49a0a)
  • تم تعديل مكونات Wear Material وWear Material3 التي تعرض MutableInteractionSource في واجهة برمجة التطبيقات لتعرض الآن MutableInteractionSource قابلاً للتغيير إلى قيمة فارغة. ما مِن تغييرات دلالية هنا: يعني تمرير القيمة null أنّك لا تريد رفع MutableInteractionSource، وسيتم إنشاؤه داخل المكوّن إذا لزم الأمر. يؤدي التغيير إلى القيمة null إلى عدم تخصيص بعض المكوّنات MutableInteractionSource مطلقًا، كما يسمح للمكوّنات الأخرى بإنشاء مثيل بشكل كسول فقط عند الحاجة، ما يؤدي إلى تحسين الأداء على مستوى هذه المكوّنات. إذا كنت لا تستخدم MutableInteractionSource الذي ترسله إلى هذه المكوّنات، ننصحك بإرسال قيمة فارغة بدلاً من ذلك. وننصحك أيضًا بإجراء تغييرات مشابهة في مكوّناتك. (Ib90fc، b/298048146)
  • إضافة واجهة برمجة تطبيقات جديدة لواجهة برمجة التطبيقات ripple API في مكتبتَي wear:compose-material وwear:compose-material3، والتي تحلّ محل واجهة برمجة التطبيقات rememberRipple التي تم إيقافها نهائيًا تضيف هذه القيمة أيضًا CompositionLocal مؤقتًا، LocalUseFallbackRippleImplementation، لإعادة مكونات Material إلى استخدام واجهات برمجة التطبيقات rememberRipple/RippleTheme التي تم إيقافها نهائيًا. ستتم إزالة هذه الميزة في الإصدار الثابت التالي، وهي مخصّصة فقط لمساعدة المستخدمين في نقل البيانات مؤقتًا في الحالات التي يوفّرون فيها RippleTheme مخصّصًا. يُرجى الانتقال إلى developer.android.com للحصول على معلومات حول نقل البيانات ومزيد من المعلومات الأساسية حول هذا التغيير. (af92b21)
  • أجرينا تحسينات طفيفة على واجهة برمجة التطبيقات HorizontalPageIndicator ومستنداتها. (I60efc)
  • عدّلنا السمة ColorScheme لتصبح غير قابلة للتغيير، ما يجعل تعديلات الألوان الفردية أقل فعالية، ولكنّه يجعل الاستخدام الأكثر شيوعًا للألوان أكثر فعالية. يرجع سبب هذا التغيير إلى أنّ معظم التطبيقات لن تتضمن تغيير ألوان فردية كحالة استخدام رئيسية. لا يزال هذا ممكنًا، ولكنّه سيؤدي إلى إعادة التركيب أكثر من ذي قبل، ما سيؤدي بدوره إلى تقليل عدد الاشتراكات في الحالة بشكل كبير من خلال كل الرمز البرمجي الأساسي، وسيؤثّر في تكلفة الإعداد وتكلفة وقت التشغيل لعدد أكبر من حالات الاستخدام العادية. (Ibc2d6)
  • تم تعديل واجهات برمجة التطبيقات ToggleButton وSplitToggleButton للسماح بتخصيص الألوان المتوقفة. بالإضافة إلى ذلك، يتم الآن استخدام الرموز المميّزة لتصميم Material Design لقيم الألوان وأسلوب الخط. (If087c)
  • تم تعديل ألوان خلفية صور الأزرار لاستخدام الرموز المميّزة لتصميم Material Design. (Iba215)
  • لقد غيّرنا مكوّنات Checkbox وSwitch وRadioButton لتصبح معروضة فقط، وذلك من خلال إزالة معالجة النقر. من المتوقّع استخدام هذه المكوّنات في (Split)ToggleButton التي تعالج النقرة، لذا تمّ الآن الإشارة إلى المكوّنات بوضوح أكبر على أنّها مخصّصة للعرض فقط (وهي غير مخصّصة للاستخدام المستقل على Wear). (I2322e)

إصلاح الأخطاء

  • أضفنا علامات لقيم الحركة الخاصة بالمدّات وعمليات التخفيف في Wear Compose Material 3. (I437cd)
  • أصلحنا خطأ في ToggleButton وSplitToggleButton وCheckbox وSwitch وRadioButton حتى لا تتكرّر إشعارات تسهيل الاستخدام (في السابق، كانت الأدوار الدلالية مكرّرة). (Ica281)
  • لقد أزلنا طبقة MaterialCore لنظام التشغيل CompactButton لتحسين الأداء. (7902858)

الإصدار 1.0.0-alpha15

15 تشرين الثاني (نوفمبر) 2023

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha15. يحتوي الإصدار 1.0.0-alpha15 على هذه المراجعات.

تغييرات واجهة برمجة التطبيقات

  • أعدنا تسمية مستوى "التأسيس" SwipeToDismissBox إلى BasicSwipeToDismissBox. ويساعد ذلك في التمييز بشكل أوضح بين المكوّن على مستوى Foundation والمكوّن على مستوى Material3 SwipeToDismissBox. يسحب هذا الأخير الألوان من MaterialTheme لاستخدامها في الشاشات المصغّرة ويفوّض التنفيذ المتبقّي إلى BasicSwipeToDismissBox. (Ibecfc)

إصلاح الأخطاء

  • أزلنا طبقة material-core لزر Material3 لتحسين الأداء. (I55555)

الإصدار 1.0.0-alpha14

18 تشرين الأول (أكتوبر) 2023

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha14. يحتوي الإصدار 1.0.0-alpha14 على هذه المراجعات.

تغييرات واجهة برمجة التطبيقات

  • أزلنا المَعلمة indicatorStyle من Material3 HorizontalPageIndicator، وستتّبع بدلاً من ذلك شكل شاشة الجهاز (مستقيم أو دائري). (I83728)
  • لقد فصلنا ألوان SplitToggleButton عن ألوان ToggleButton، وذلك من خلال إضافة فئة SplitToggleButtonColors جديدة. (I78bee)

الإصدار 1.0.0-alpha13

‫4 أكتوبر 2023

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha13. يحتوي الإصدار 1.0.0-alpha13 على هذه المراجعات.

تغييرات واجهة برمجة التطبيقات

  • أضفنا حقل "العنوان الفرعي" اختياريًا إلى TitleCard. (Ifc45a)
  • لقد أضفنا رمزيات ألوان التصميم المتعدد الأبعاد لتطبيق TextButton. (I769dc)

الإصدار 1.0.0-alpha12

20 أيلول (سبتمبر) 2023

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha12. يحتوي الإصدار 1.0.0-alpha12 على هذه المراجعات.

تغييرات واجهة برمجة التطبيقات

  • لقد عدّلنا IconButton لاستخدام الرموز المميّزة لتصميم Material Design. (I3f137)
  • لقد عدّلنا IconToggleButton لاستخدام الرموز المميّزة لتصميم Material Design. (I7d263)
  • لقد جعلنا منشئي CheckboxColors وRadioButtonColors وSwitchColors علنيين. (I82b73)

الإصدار 1.0.0-alpha11

6 أيلول (سبتمبر) 2023

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha11. يحتوي الإصدار 1.0.0-alpha11 على هذه المراجعات.

إصلاح الأخطاء

  • لقد عدّلنا خطّ Material3 Cards إلى TitleMedium. (I597bd)
  • عدّلنا الخطّ والاتجاه في ListHeader وListSubheader من Material3. (Ib5ceb)

الإصدار 1.0.0-alpha10

23 آب (أغسطس) 2023

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha10. يحتوي الإصدار 1.0.0-alpha10 على هذه المراجعات.

الميزات الجديدة

  • أضِف HorizontalPageIndicator في مكتبة Wear Material3. (Ifee99)

تغييرات واجهة برمجة التطبيقات

  • عدِّل رمز الأزرار لاستخدام الرموز المميّزة لتصميم Material3. (I92fe4)
  • سيتم اعتبار واجهات برمجة تطبيقات Slider وStepper في Wear Material 3 تجريبية لأنّه لا يزال يتم وضع اللمسات الأخيرة على تفاصيل واجهة المستخدم. (I84d54)
  • أزلنا مقاسات ExtraSmall من الأشكال المستديرة TextButton وTextToggleButton لأنّ هذا المقاس لا ينطبق إلا على IconButton. (Ibc7d5)

إصلاح الأخطاء

  • عدّلنا الإرشادات المتعلقة بالخط في TextToggleButton لاستخدام LabelLarge لحجم الزر الكبير (Ib10fa).
  • عدّلنا الإرشادات المتعلقة بالخط في TextButton لاستخدام LabelLarge لـ LargeButtonSize (I8f3a7).
  • لقد ضبطنا الحد الأدنى لمساحة اللمس المستهدفة في البطاقة على 48 بكسل مستقل الكثافة لتسهيل الاستخدام. (Ieb9b1)
  • إضافة بطاقة تطبيق مع عرض توضيحي للصورة، وإزالة بطاقة التطبيق مع عرض توضيحي للخلفية (Id735f)
  • تم إصلاح خلل في الأزرار المستديرة حيث لم يتم ربط عوامل التعديل بشكل صحيح. (I5e162)

الإصدار 1.0.0-alpha09

9 آب (أغسطس) 2023

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha09. يحتوي الإصدار 1.0.0-alpha09 على هذه المراجعات.

الميزات الجديدة

  • أضفنا ToggleButton لسمة material3 (I6bed6).

تغييرات واجهة برمجة التطبيقات

  • لقد فعّلنا التعليق التوضيحي FloatRange كقيود واجهة برمجة التطبيقات، والتي سبق أن تم ذكرها في التعليقات. (Icb401)
  • لقد عدّلنا أسلوب الخط في Wear Material3 بما يتوافق مع أحدث إرشادات Material3. (I1bad6)

إصلاح الأخطاء

  • عدّلنا ألوان Button وIconButton وTextButton بما يتوافق مع تصميم Material3. (Ib2495)
  • أصلحنا مشكلة ظهور علامة مربّع الاختيار في الحالات المتوقفة. (Ib25bf)

الإصدار 1.0.0-alpha08

26 تموز (يوليو) 2023

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha08. يحتوي الإصدار 1.0.0-alpha08 على هذه المراجعات.

الميزات الجديدة

  • أضفنا عناصر التحكّم في الاختيار التالية لـ Material3: Switch وCheckbox وRadioButton. (Ib918c)
  • أضفنا IconToggleButton وTextToggleButton إلى Material3، وهما زرّان دائريان للتشغيل/الإيقاف يتضمّنان خانة واحدة للرمز والنص على التوالي. بالنسبة إلى أحجام ToggleButton المختلفة، ننصحك باستخدام Modifier.touchTargetAwareSize مع الأحجام المقدَّمة في أزرار التبديل ذات الصلة. (I9f015)
  • أضفنا ListHeader وListSubheader إلى مكونات Material3. (Ibaefe)
  • أضفنا Material3 SwipeToDismissBox الذي يستدعي Foundation SwipeToDismissBox الجديد ويقدّم قيم الألوان التلقائية من موضوعه. (I275fb)
  • أضفنا InlineSlider Material3 إلى ميزة "الكتابة السريعة" في Wear OS. ويسمح هذا الخيار للمستخدمين بإجراء اختيار من نطاق من القيم. يتم عرض نطاق الاختيارات كشريط بين الحد الأدنى والحد الأقصى للقيمة، ويمكن للمستخدمين اختيار قيمة واحدة من ذلك الشريط. InlineSlider مثالية لضبط الإعدادات، مثل مستوى الصوت أو السطوع. (I7085f)

تغييرات واجهة برمجة التطبيقات

  • لقد عدّلنا مظهر "أشكال" في Wear Material 3 لاستخدام RoundedCornerShape بدلاً من Shape. (Idb133)
  • لقد جعلنا الثوابت الخاصة بالارتفاع لعنصر الزر علنية (Idbfde).
  • تم تعديل ملفات واجهة برمجة التطبيقات لإضافة تعليقات توضيحية حول إخفاء معلومات التوافق (I8e87a، b/287516207)
  • لقد عدّلنا InlineSliderColors في Wear Compose Material 3 لتوفير عنصر الإنشاء العام والخصائص العامة. (I6b632)
  • لقد عدّلنا جميع فئات الألوان في Wear Compose Material 3 لتوفير وظائف إنشاء عامة وخصائص عامة. (I17702)
  • لقد جعلنا متغيرات الحشو الأفقي والرأسي للزر علنية. (Ieeaf7)

إصلاح الأخطاء

  • سيتم الآن تعديل ارتفاع الزرّ ليلائم المحتوى الذي زاد حجمه بسبب الخطوط الكبيرة لتسهيل الاستخدام، عند الحاجة (Iaf302)
  • عدّلنا عددًا من نماذج Buttons التجريبية لمعالجة مشاكل تسهيل الاستخدام. (I61ce9)
  • يتيح الآن زرَّا Stepper وInlineSlider النقرات المتكرّرة عند الضغط مع الاستمرار حتى تتمكّن من زيادة أو خفض قيمة Stepper وInlineSlider بسرعة عن طريق الضغط مع الاستمرار على الزرَّين + أو - (I27359).

الإصدار 1.0.0-alpha07

‫21 حزيران (يونيو) 2023

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha07. يحتوي الإصدار 1.0.0-alpha07 على هذه المراجعات.

الميزات الجديدة

  • أضفنا المكوّن Stepper إلى مكتبة Compose لنظام التشغيل Wear OS Material 3. يشبه هذا الإصدار الإصدار السابق من Material، ولكنه يحذف دلالات النطاق تلقائيًا استنادًا إلى ملاحظات المطوّرين. نوفّر Modifier.rangeSemantics الحالات التي تكون فيها دلالات النطاق مطلوبة. (Ic39fd)
  • أضفنا curvedText إلى مكتبة Compose لنظام التشغيل Wear OS Material 3. (Ia8ae3)

إصلاح الأخطاء

  • عدّلنا wear.compose.foundation ليصبح معتمِدًا على واجهة برمجة التطبيقات wear.compose.material3 (I72004، b/285404743).

الإصدار 1.0.0-alpha06

7 حزيران (يونيو) 2023

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha06. يحتوي الإصدار 1.0.0-alpha06 على هذه المراجعات.

إصلاح الأخطاء

  • لقد عدّلنا الدالة TextButton لاستخدام الدالة toDisabledColor الإضافية لعرض قيم ألفا الصحيحة غير المفعّلة. (I814c8)

الإصدار 1.0.0-alpha05

24 أيار (مايو) 2023

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha05. يحتوي الإصدار 1.0.0-alpha05 على هذه المراجعات.

الميزات الجديدة

  • أضفنا TextButton إلى Material3، وهو زر دائري يتضمّن خانة واحدة للنص. بالنسبة إلى أحجام مختلفة من TextButton، ننصحك باستخدام Modifier.touchTargetAwareSize وExtraSmallButtonSize وSmallButtonSize وDefaultButtonSize وLargeButtonSizeIcon المتوفّرة في TextButtonDefaults. لا يحتوي الرمز التلقائي TextButton على حدود وله خلفية شفافة للإجراءات ذات الأهمية المنخفضة. بالنسبة إلى الإجراءات التي تتطلّب تركيزًا كبيرًا، استخدِم filledTextButtonColors. بالنسبة إلى الإجراءات التي تتطلّب تركيزًا متوسطًا، استخدِم TextButton المخطّط، واضبط الحدود على ButtonDefaults.outlinedButtonBorder. بالنسبة إلى الإجراءات التي تتطلّب تركيزًا متوسطًا بين المخطّط والممتلئ، استخدِم filledTonalTextButtonColors. (I667e4)
  • أضفنا Card وOutlinedCard وAppCard وTitleCard إلى مكتبة Material3 في Wear Compose. يمكن أيضًا منح AppCard وTitleCard مظهرًا مخطّطًا باستخدام CardDefaults.outlinedCardColors وCardDefaults.outlinedCardBorder(I80e72).

تغييرات واجهة برمجة التطبيقات

  • لقد نقلنا مَعلمة تصنيف الزرّ إلى النهاية لتتوافق مع بنية lambda اللاحقة وأزلنا مَعلمة الدور (لأنّه يمكن إلغاء ذلك باستخدام Modifier.semantics). أصبحت الآن وظائف إنشاء ButtonColors علنية. (Ie1b6d)

الإصدار 1.0.0-alpha04

10 أيار (مايو) 2023

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha04. يحتوي الإصدار 1.0.0-alpha04 على هذه المراجعات.

الميزات الجديدة

  • أضفنا IconButton إلى Material3، وهو زر دائري يتضمّن خانة واحدة للرمز/الصورة. تتوفّر أربعة أشكال: IconButton وFilledIconButton وFilledTonalIconButton وOutlinedIconButton. بالنسبة إلى أحجام مختلفة من IconButton، ننصحك باستخدام Modifier.touchTargetAwareSize وExtraSmallButtonSize وSmallButtonSize وDefaultButtonSize وLargeButtonSizeIcon المتوفّرة في IconButtonDefaults. نوفّر أيضًا IconButtonDefaults.iconSizeFor لتحديد حجم الرمز المقترَح لحجم زر معيّن. (I721d4)

الإصدار 1.0.0-alpha03

19 نيسان (أبريل) 2023

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha03. يحتوي الإصدار 1.0.0-alpha03 على هذه المراجعات.

تغييرات واجهة برمجة التطبيقات

  • أضفنا مكوّن الزر في Material 3، وهو الزر على شكل ملعب وكان يُعرف سابقًا باسم Chip في مكتبة Material Compose في Wear (تمت إعادة تسميته إلى Button لمواءمة مع مكتبة Compose Material 3). يحتوي الزر التلقائي على خلفية مليئة، وهناك أنواع أزرار مختلفة FilledTonal (خلفية باهتة) وOutlined (شفافة مع حدود رفيعة) وChild (خلفية شفافة بدون حدود، تُستخدَم للإجراءات التكميلية ذات الأهمية الأقل). ستتوفّر أزرار مستديرة لمحتوى الرموز والنصوص البسيطة في إصدار مستقبلي.(Ia6942)

الإصدار 1.0.0-alpha02

5 نيسان (أبريل) 2023

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha02. يحتوي الإصدار 1.0.0-alpha02 على هذه المراجعات.

إصلاح الأخطاء

  • أضفنا DefaultTextStyle إلى Wear Compose Material 3 الذي يضبط PlatformTextStyle.includeFontPadding تلقائيًا على true (الإعداد الحالي). سيتيح لنا ذلك مزامنة إيقاف حشوة الخط تلقائيًا مع مكتبات Compose في المستقبل (راجِع إصلاح حشوة الخط في ميزة "الإنشاء" للخلفية). (I7e461)

الإصدار 1.0.0-alpha01

22 آذار (مارس) 2023

تم إصدار androidx.wear.compose:compose-material3:1.0.0-alpha01. يحتوي الإصدار 1.0.0-alpha01 على هذه المراجعات.

الميزات الجديدة

  • ‫Material 3 هو الإصدار التالي من Material Design، ويتضمن مظهرًا جديدًا ومكونات معدَّلة. تم تصميم واجهة Material 3 على Wear Compose لتتلاءم مع مكتبة Material 3 Compose على Android. يتضمّن هذا الإصدار الأول من الإصدار التجريبي الأولي عمليات تنفيذ وظيفية مبكرة لما يلي:

    • مظهر Material: لضبط نظام الألوان وأسلوب الخط والأشكال بشكلٍ متسق في جميع المكونات في المكتبة تم تعديل ألوان موضوع Material3 لتوفير تباين سهل الاستخدام. (I84005)
    • النص/الرمز: وحدات أساسية لتطبيقات Wear Compose (I8e06a)

  • سنواصل تطوير Wear Material (androidx.wear.compose:compose-material) وWear Material 3 (androidx.wear.compose:compose-material3) بالتوازي. ستوسّع الإصدارات المستقبلية من Material3 مجموعة التطبيقات المصغّرة لتشمل مكوّنات أخرى مألوفة من تطبيق Compose لنظام التشغيل Wear OS، مثل الأزرار وأدوات الاختيار وأدوات التمرير.

  • إنّ مكتبتَي Wear Material وWear Material 3 متعارضتان مع بعضهما البعض، ويجب عدم خلطهما في التطبيق نفسه، ويرجع ذلك في المقام الأول إلى أنّهما تشيران إلى مظاهر مختلفة قد تؤدي إلى حدوث تناقضات غير متوقّعة.