Wear Compose

  
كتابة تطبيقات Jetpack Compose للأجهزة القابلة للارتداء من توفير وظائف لدعم الأجهزة القابلة للارتداء والأحجام والأشكال إيماءات التنقل.
التعديل الأخير الإصدار المستقر سحب المرشح الإصدار التجريبي إصدار أولي
21 آب (أغسطس) 2024 1.3.1 1.4.0-rc01 - -

إعلان التبعيات

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

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

Groovy

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

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

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

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

Kotlin

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

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

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

    // 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.0 من Wear Compose Material3

الإصدار 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 على عمليات التنفيذ هذه.

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

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

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

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

الإصدار 1.0.0-alpha21

17 أبريل 2024

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

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

الإصدار 1.0.0-alpha20

3 أبريل 2024

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

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

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

الإصدار 1.0.0-alpha19

‫6 مارس 2024

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

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

  • لقد أضفنا TimeText إلى مكتبة Wear Compose Material3. يعرض هذا المكوِّن الوقت الحالي (والحالة الإضافية) في أعلى الشاشة. تساعد واجهة برمجة تطبيقات 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 OS وارتدائها التي تعرض رمز MutableInteractionSource في واجهة برمجة التطبيقات الخاصة بها لتكشف الآن عن سمة MutableInteractionSource قابلة للإلغاء ويتم ضبطها تلقائيًا على قيمة فارغة. ما مِن تغييرات دلالية هنا: يعني تمرير "خالٍ" أنّك لا تريد رفع "MutableInteractionSource"، وسيتم إنشاؤه داخل المكوِّن إذا لزم الأمر. يؤدي التغيير إلى القيمة "فارغ" إلى السماح لبعض المكوّنات بعدم تخصيص MutableInteractionSource مطلقًا، كما يسمح للمكوّنات الأخرى بإنشاء مثيل بطريقة كسولة عند الحاجة، ما يحسّن الأداء على مستوى هذه المكوّنات. إذا كنت لا تستخدم MutableInteractionSource التي تمرِّرها إلى هذه المكوّنات، ننصحك باستخدام قيمة null بدلاً من ذلك. يوصى أيضًا بإجراء تغييرات مماثلة في المكونات الخاصة بك. (Ib90fc، b/298048146)
  • تضيف هذه الواجهة واجهة برمجة تطبيقات Ripple جديدة في مكتبات 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)
  • أزلنا طبقة المادة الأساسية لـ CompactButton لتحسين الأداء. (7902858)

الإصدار 1.0.0-alpha15

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

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

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

  • لقد أعدنا تسمية المستوى الأساسي SwipeToDismissBox إلى BasicSwipeToDismissBox. وهذا يجعل التمييز أكثر وضوحًا بين المكوّن على مستوى الأساس والمستوى SwipeToDismissBox من مادة 3. هذا الخيار يسحب الألوان من MaterialTheme لاستخدامها في أدوات التحديد ويفوض التنفيذ المتبقي إلى BasicSwipeToDismissBox. (Ibecfc)

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

  • لقد أزلنا طبقة النواة الأساسية لـ Material3 Button لتحسين الأداء. (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)
  • لقد أضفنا رموزًا مميّزة للّون من تصميم Material Design لـ 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 إلى TitleMedium. (I597bd)
  • عدّلنا أسلوب الخط والمحاذاة في Material3 ListHeader وListSubheader. (Ib5ceb)

الإصدار 1.0.0-alpha10

23 آب (أغسطس) 2023

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

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

  • يمكنك إضافة "HorizontalPageIndicator" في مكتبة Wear Material3. (Ifee99)

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

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

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

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

الإصدار 1.0.0-alpha09

9 آب (أغسطس) 2023

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

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

  • لقد أضفنا ToggleButton للمواد 3 (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. (إيبايف)
  • لقد أضفنا سمة Material3 SwipeToDismissBox التي يُطلق على اسمها الأساسي SwipeToDismissBox الجديد وتوفّر قيم اللون التلقائية من مظهرها. (I275fb)
  • لقد أضفنا Material3 InlineSlider إلى Wear Compose. يسمح للمستخدمين بالاختيار من بين مجموعة من القيم. يتم عرض نطاق الاختيارات كشريط بين الحد الأدنى والحد الأقصى للقيم للنطاق، ويمكن للمستخدمين اختيار قيمة واحدة من خلالها. يُعد InlineSlider مثاليًا لضبط الإعدادات، مثل مستوى الصوت أو السطوع. (I7085f)

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

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

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

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

الإصدار 1.0.0-alpha07

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

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

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

  • لقد أضفنا المكوِّن Stepper إلى مكتبة Compose for 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 إلى مكتبة Wear Compose Material3. يمكن أيضًا منح 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 - وهو زر على شكل استاد كان يُعرف باسم "تشيب" في مكتبة Wear Compose Material (تمت إعادة تسميته إلى "Button" لتحقيق الاتساق مع مكتبة Compose Material 3). يكون للزر التلقائي خلفية معبأة وهناك تباينات للأزرار الخاصة بـ FilledTonal (خلفية مكتومة) ومُحددة (شفافة بحدود رفيعة) وعنصر ثانوي (خلفية شفافة وبدون حدود، ويتم استخدامه للإجراءات التكميلية ذات أقل قدر من البروز). سيتم طرح الأزرار المستديرة لإنشاء محتوى نصي أو رموز بسيطة في إصدار مستقبلي.(Ia6942)

الإصدار 1.0.0-alpha02

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

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

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

  • لقد أضفنا علامة DefaultTextStyle إلى المادة 3 من Wear Compose، علمًا بأنّ قيمة السمة PlatformTextStyle.includeFontPadding مضبوطة تلقائيًا على "صحيح" (الإعداد الحالي). سيتيح لنا ذلك مزامنة إيقاف المساحة المتروكة للخط تلقائيًا مع مكتبات "إنشاء" في المستقبل (يُرجى الاطّلاع على إصلاح المساحة المتروكة للخط في ميزة "إنشاء" للخلفية). (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. يحتوي هذا الإصدار الأولي الأول على عمليات تنفيذ وظيفية مبكرة لما يلي:

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

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

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

الإصدار 1.4

الإصدار 1.4.0-rc01

21 آب (أغسطس) 2024

تم طرح androidx.wear.compose:compose-*:1.4.0-rc01. يحتوي الإصدار 1.4.0-rc01 على عمليات التنفيذ هذه.

  • عدّلنا تبعيات Compose إلى 1.7.0-rc01 وثبَّتنا ميزة "التنقل في Compose" على Wear Compose ضِمن النطاق androidx.lifecycle 2.8.3

الإصدار 1.4.0-beta03

12 يونيو 2024

تم طرح androidx.wear.compose:compose-*:1.4.0-beta03. يحتوي الإصدار 1.4.0-beta03 على عمليات التنفيذ هذه.

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

  • لقد عدّلنا Modifier.rotaryScrollable لاستبدال استخدام القيمة "Focusable" بـ "FocusTarget"، ما يؤدي إلى تحسين الأداء. (Id294b)
  • لقد أصلحنا مشكلة تسبّبت في تكرار إشعار "ProgressIndicator" بالإعلان بموجب TalkBack. (I94563)
  • لقد عدّلنا الملفات الشخصية الأساسية لمكتبة Wear Compose. (I3cbc3)

الإصدار 1.4.0-beta02

29 مايو 2024

تم طرح androidx.wear.compose:compose-*:1.4.0-beta02. يحتوي الإصدار 1.4.0-beta02 على عمليات التنفيذ هذه.

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

  • لقد تمت زيادة عرض الحدود التي تم تمريرها إلى برامج قراءة الشاشة من النص المنحني لمعالجة مشاكل اقتطاع النص (Id865f).
  • تم تقييد حد HorizontalPageIndicator الذي تم تمريره إلى برامج قراءة الشاشة، حيث كان المؤشر يشغل في السابق وضع ملء الشاشة (Id8d7a).

الإصدار 1.4.0-beta01

14 مايو 2024

تم طرح androidx.wear.compose:compose-*:1.4.0-beta01. يحتوي الإصدار 1.4.0-beta01 على عمليات التنفيذ هذه.

يشير الإصدار 1.4 إلى الإصدار التجريبي 1.4 من Compose لـ Wear OS إلى أنّ هذا الإصدار من المكتبة مكتمل السمات وأنّ واجهة برمجة التطبيقات مقفلة (باستثناء إذا تم وضع علامة عليها بأنّها تجريبية). يشمل الإصدار 1.4 من Wear Compose الوظائف الجديدة التالية:

  • لقد أضفنا ميزة Modifier.rotaryScrollable، وهي أداة تعديل جديدة تربط الأحداث الدوّارة بالحاويات القابلة للتمرير، ما يتيح للمستخدمين التنقّل من خلال تاج أو حافة دوارة على جهاز Wear OS. بالإضافة إلى ذلك، يتيح كل من ScalingLazyColumn وPicker تلقائيًا إدخال البيانات عبر وحدة تحكُّم دورانية. يمكنك استخدام المَعلمة rotaryScrollableBehavior لضبط سلوك التمرير أو المحاذاة. بالنسبة إلى سلوك المحاذاة، يُنصح بتوفير المحاذاة من خلال مَعلمة flingBehavior وكذلك التمرير باللمس.
  • يوفّر تطبيق "SwipeDismissableNavHost" الآن صورة متحركة للدخول ضمن عمليات الانتقال داخل التطبيق.
  • يتم الآن عرض "PositionIndicator" تلقائيًا عند عرض الشاشة لأول مرة.
  • تمت إضافة SelectableChip وSplitSelectableChip كصيغة مختلفة على ToggleChip. استخدِم هذه الإضافة مع RadioButton لتوفير دلالات قابلة للاختيار بدلاً من دلالات يمكن التبديل بينها لتسهيل الاستخدام.
  • تتيح "ListHeader" الآن إمكانية ضبط الارتفاع عندما يحتاج المحتوى إلى ارتفاع إضافي للتوافق مع أحجام الخطوط الكبيرة.

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

  • أصلحنا مشكلة أدّت إلى الإعلان عن ميزة "النقر مرّتين" في الشرائح القابلة للاختيار عند اختيارها. (I7ed88)

الإصدار 1.4.0-alpha08

1 مايو 2024

تم طرح androidx.wear.compose:compose-*:1.4.0-alpha08. تحتوي الإصدار 1.4.0-alpha08 على عمليات التنفيذ هذه.

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

  • تم إجراء التغييرات التالية على واجهة برمجة التطبيقات الدوارة الجديدة: تمت إعادة تسمية Modifier.rotary إلى Modifier.rotaryScrollable؛ إعادة تسمية الواجهة RotaryBehavior إلى RotaryScrollableBehavior ووظيفتها handleScrollEvent إلى performScroll؛ تمت إعادة تسمية RotaryScrollableAdapter إلى RotaryScrollableLayoutInfoProvider وإزالة الموقع scrollableState. (I0c8a6)
  • لقد أجرينا تغييرات إضافية على واجهة برمجة التطبيقات rotary API: تمت إعادة تسمية RotaryScrollableLayoutInfoProvider إلى RotarySnapLayoutInfoProvider (لأن هذا المزوِّد مطلوب فقط لواجهة برمجة التطبيقات الدوّارة ذات المحاذاة). تم تغيير نوع مَعلمة snapOffset في RotaryScrollableDefaults.snapBehavior snapOffset من Int إلى Dp. (Iddebe)
  • لقد أعدنا تسمية المعلَمة clickInteractionSource في SplitSelectableChip إلى containerInteractionSource. (Ia8f84)
  • لقد عدّلنا أسماء مَعلمات استدعاء النقر في SplitSelectableChip من onClick إلى onSelectionClick ومن onBodyClick إلى onContainerClick. (I32237)

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

  • عدّلنا المساحة المتروكة الأفقية لـ PositionIndicator إلى 2dp (كانت 5dp) لإصلاح خطأ يتداخل فيه PositionIndicator (شريط التمرير) مع المحتوى القابل للتمرير. يُرجى العِلم أنّه من المتوقّع أن يؤدي هذا التغيير إلى إيقاف لقطات الشاشة الحالية التي تتضمّن PositionIndicator بسبب تغيير المساحة المتروكة. (I57472)
  • أدخلنا تحسينات على المستندات الخاصة بواجهة برمجة التطبيقات الدوارة الجديدة من خلال توضيح الاختلافات بين الأجهزة الدوّارة المنخفضة الدقة والعالية الدقة. (I63abe)
  • لقد عالجنا استثناءً خارج النطاق في SwipeDismissableNavHost يمكن أن يظهر عندما تكون قيم ألفا المُدرجة أقل من صفر. (Ib75a1، b/335782510)

الإصدار 1.4.0-alpha07

17 أبريل 2024

تم طرح androidx.wear.compose:compose-*:1.4.0-alpha07. يحتوي الإصدار 1.4.0-alpha07 على عمليات التنفيذ هذه.

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

  • لقد أضفنا ميزة Modifier.rotary، وهي أداة تعديل جديدة تربط الأحداث الدوّارة بالحاويات القابلة للتمرير، ما يتيح للمستخدمين التنقّل من خلال تاج أو حافة دوارة على جهاز Wear OS. بالإضافة إلى ذلك، يتيح كل من ScalingLazyColumn وأداة الاختيار الآن طريقة إدخال البيانات عبر وحدة تحكُّم دورانية تلقائيًا، مع استخدام أحمال زائدة جديدة تتضمّن المَعلمة rotaryBehavior لتحديد إعدادات التمرير أو المحاذاة. إذا تم ضبط مَعلمة rotaryBehavior على "محاذاة"، ننصحك بتوفير Snap عبر مَعلمة flingBehavior أيضًا للتمرير باللمس. (I2ef6f)
  • سيتم استبدال ميزة "السحب والنقل" لـ NestedScroll بـ UserInput وSideEffect لاستيعاب التعريف الموسّع لهذه المصادر التي تتضمن الآن الصور المتحركة (التأثير الجانبي) وعجلة الماوس ولوحة المفاتيح (UserInput). (I40579)
  • لقد أضفنا SelectableChip وSplitSelectableChip لنوضّح الفرق بين عناصر التحكّم بالتبديل، مثل Switch/Checkbox، وعناصر التحكّم القابلة للاختيار، مثل RadioButton. سيؤدي ذلك إلى استبدال عمليات التحميل الزائدة التي تمت إضافتها سابقًا في ToggleChip/SplitToggleChip بمعلمات selectionControl. (Ia0217)
  • تم تعديل تعديل مستوى رؤية IndeterminateStrokeWidth في ProgressIndicatorDefaults ليصبح علنيًا. (I5b5a4)

الإصدار 1.4.0-alpha06

3 أبريل 2024

تم طرح androidx.wear.compose:compose-*:1.4.0-alpha06. يحتوي الإصدار 1.4.0-alpha06 على عمليات التنفيذ هذه.

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

  • لقد أضفنا مسودة داخلية لدعم الدوران، في إطار الجهود الكبيرة المبذولة لنقل سلوك Rotary إلى AndroidX من قناة Horology. (I617d1)
  • لقد أضفنا مسودة داخلية لدعم تقنية اللمس، وذلك في إطار الجهود الكبيرة التي تهدف إلى نقل سلوك Rotary من أجل AndroidX إلى AndroidX. (I5568a)

الإصدار 1.4.0-alpha05

20 مارس 2024

تم طرح 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

‫6 مارس 2024

تم طرح androidx.wear.compose:compose-*:1.4.0-alpha04. يحتوي الإصدار 1.4.0-alpha04 على عمليات التنفيذ هذه.

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

  • لقد أضفنا حملاً زائدًا جديدًا للمَعلمتَين ToggleChip وSplitToggleChip يأخذ المَعلمة selectionControl بدلاً من المَعلمة toggleControl. يجب استخدام هذا الإعداد مع عنصر التحكّم RadioButton لتوفير دلالات قابلة للاختيار بدلاً من دلالات قابلة للاختيار لتسهيل الاستخدام (I1d6d9).
  • لقد عدّلنا أسماء المَعلمات لحِمل selectionControl الزائد الجديد من onSelected إلى onSelect في ToggleChip وSplitToggleChip (I1a971).

الإصدار 1.4.0-alpha03

21 فبراير 2024

تم طرح androidx.wear.compose:compose-*:1.4.0-alpha03. يحتوي الإصدار 1.4.0-alpha03 على هذه عمليات التنفيذ.

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

  • تم إيقاف برنامج تضمين Modifier.inspectable نهائيًا. ستؤدي واجهة برمجة التطبيقات هذه إلى إنشاء عدد أكبر من عمليات إلغاء التعديل الخاصة بك أكثر من اللازم، لذا لا يُنصح باستخدامها الآن. ننصح المطوّرين بتنفيذ طريقة inspectableProperties() على ModifierNodeElement إذا أرادوا عرض سمات التعديل للأدوات. (Ib3236)

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

  • أصلحنا خطأً في المستندات يتعلّق بتعليقات WearPreview* التوضيحية. (Id526d)

الإصدار 1.4.0-alpha02

7 فبراير 2024

تم طرح androidx.wear.compose:compose-*:1.4.0-alpha02. يحتوي الإصدار 1.4.0-alpha02 على هذه عمليات التنفيذ.

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

  • أصلحنا خطأً في ميزة "التمرير السريع لعرض الإعلان"، حيث كان من الممكن التفاعل مع (وإلغاء) إجراء تم الالتزام به على عنصر من خلال البدء بالتمرير السريع على عنصر آخر.(Ide059)
  • وقد عدّلنا ListHeader لتوفير عمليات ضبط الارتفاع عندما يحتاج المحتوى إلى ارتفاع إضافي ليناسب أحجام الخطوط الكبيرة. (I7290c، b/251166127)

الإصدار 1.4.0-alpha01

24 يناير 2024

تم طرح androidx.wear.compose:compose-*:1.4.0-alpha01. يحتوي الإصدار 1.4.0-alpha01 على هذه عمليات التنفيذ.

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

  • لقد أضفنا صورة متحركة للإدخال إلى SwipeDismissableNavHost لعمليات الانتقال داخل التطبيق.(cfeb79a)
  • يتم الآن عرض "PositionIndicator" تلقائيًا عند عرض الشاشة لأول مرة. تم إجراء هذا التغيير للمساعدة في تلبية إرشادات جودة أجهزة Wear OS. يعني ذلك أنّه يجب تعديل اختبارات لقطات الشاشة على الشاشات التي تتضمّن PositionIndicator، لأنّه لم يكن من الممكن عرض PositionIndicator في السابق. (419cef7)

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

  • لقد أضفنا واجهة برمجة تطبيقات Ripple جديدة في مكتبتَي wear:compose-material وwear:compose-material3 ستحلّ محلّ واجهة rememberRipple التي تم إيقافها نهائيًا. تتم أيضًا إضافة CompositionLocal، LocalUseFallbackRippleImplementation مؤقت، لإعادة مكونات Material إلى استخدام واجهات برمجة تطبيقات rememberRipple/RippleTheme المتوقّفة. ستتم إزالة هذا الاسم في الإصدار الثابت التالي، وهو مخصّص فقط ليكون وسيلة مساعدة مؤقتة لنقل البيانات في الحالات التي تقدّم فيها RippleTheme مخصّصًا. يمكنك الانتقال إلى developer.android.com للاطّلاع على معلومات حول عملية النقل ومزيد من المعلومات الأساسية حول هذا التغيير. (af92b21)
  • لقد عدّلنا السمة ColorScheme لتصبح غير قابلة للتغيير، ما يجعل عمليات تعديل الألوان الفردية أقل كفاءة، ويساهم في زيادة فعالية الاستخدام الشائع للألوان. السبب وراء هذا التغيير هو أن معظم التطبيقات لن يكون لها تحديث ألوان فردية كحالة استخدام رئيسية. لا يزال هذا ممكنًا، إلا أنّه ستتم إعادة إنشائه أكثر من ذي قبل. وبالتالي، سنخفض بشكل كبير عدد اشتراكات الولايات من خلال كل رموز المواد، وسيؤثر ذلك في تكلفة الإعداد ووقت التشغيل لمزيد من حالات الاستخدام العادية. (f5c48b7)
  • تم تعديل مواد Wear المواد ومكوّنات Wearmaterial3 التي تعرض MutableInteractionSource في واجهة برمجة التطبيقات الخاصة بها ليتم الآن عرض عنصر MutableInteractionSource قابل للإلغاء ويتم ضبطه تلقائيًا على قيمة فارغة. ما مِن تغييرات دلالية هنا: يعني تمرير "خالٍ" أنّك لا تريد رفع "MutableInteractionSource"، وسيتم إنشاؤه داخل المكوِّن إذا لزم الأمر. يؤدي التغيير إلى القيمة "فارغ" إلى السماح لبعض المكوّنات بعدم تخصيص MutableInteractionSource مطلقًا، كما يسمح للمكوّنات الأخرى بإنشاء مثيل بطريقة كسولة عند الحاجة، ما يحسّن الأداء على مستوى هذه المكوّنات. إذا كنت لا تستخدم MutableInteractionSource التي تمرِّرها إلى هذه المكوّنات، ننصحك باستخدام قيمة null بدلاً من ذلك. يوصى أيضًا بإجراء تغييرات مماثلة في المكونات الخاصة بك. (f8fa920)
  • تم تعديل rememberExpandableState لحفظ الحالة القابلة للتوسيع. يضمن هذا الإجراء تخزين البيانات عند الانتقال إلى شاشة أخرى واستعادتها عند الرجوع إلى الشاشة الأصلية. (5c80095)

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

  • عدّلنا الإعدادات ReduceMotion لاستخدام خدمة "مستمِع واعٍ لمراحل النشاط". (7c6b122)
  • عدّلنا أداة المستمع TouchExplorationStateProvider لتكون على دراية بمراحل النشاط (be28b01)
  • أزلنا طبقة المادة الأساسية CompactButton لتحسين الأداء (25db8e9)
  • لقد أضفنا تحسينات أكثر على BasicSwipeToDismissBox إلى إزاحة NaN لتجنّب الاستثناءات (b983739).
  • وتم تعديل BasicSwipeToDismissBox للتأكّد من أنّ قيم ألفا تقع ضمن النطاق 0,1.
  • أصلحنا خطأً في ToggleButton وSplitToggleButton وCheckbox وSwitch وRadioButton لكي لا يتم تكرار إشعارات تسهيل الاستخدام (كان يتم تكرار الأدوار الدلالية سابقًا) (d11eeb7).

الإصدار 1.3

الإصدار 1.3.1

3 أبريل 2024

تم طرح androidx.wear.compose:compose-*:1.3.1. يحتوي الإصدار 1.3.1 على عمليات الالتزام هذه.

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

  • أصلحنا خطأً في ميزة "التمرير السريع لعرض الإعلان"، حيث كان من الممكن التفاعل مع (وإلغاء) إجراء تم الالتزام به على عنصر من خلال البدء بالتمرير السريع على عنصر آخر. (Ide059)

الإصدار 1.3.0

24 يناير 2024

تم طرح androidx.wear.compose:compose-*:1.3.0. يحتوي الإصدار 1.3.0 على هذه عمليات التنفيذ.

تغييرات مهمة منذ الإصدار 1.2.0

  • أصبحت فئة SwipeToDismissBoxState وتعداد SwipeToDismissValue ودالة الإضافة Modifier.edgeSwipeToDismiss الآن كل جزء من حزمة androidx.wear.compose.foundation، بدلاً من الحزمة androidx.wear.compose.material. تتيح لك هذه البنية المحدَّثة تنفيذ معالجة الإيماءات بشكل مستقل عن اعتبارات التصميم الأخرى. يتم التعامل مع مهام سير عمل "التصميم المتعدد الأبعاد"، مثل تطبيق الألوان من مظهر تم ضبطه، بشكل منفصل.
  • تساعدك الصفّتان SwipeToRevealCard وSwipeToRevealChip على تنفيذ recommended swipe-to-reveal guidance. توضّح فئة SwipeToRevealSample كيفية استخدام هذه المكوّنات.

  • طرَح الإصدار 1.3.0-alpha02 تغييرًا يؤدي إلى زيادة ارتفاع عناصر Chip وToggleChip لتوفير إمكانية ضبط حجم الخط الذي يختاره المستخدم بشكل أفضل. وقد يؤدي هذا إلى حدوث بعض الاقتصاص. لحلّ هذه المشكلة، يستخدم شكل large لـ MaterialTheme نطاقًا أكبر للزاوية (26 وحدة بكسل مستقلة الكثافة بدلاً من 24 بكسل مستقل الكثافة). يستخدم العنصران Chip وToggleChip هذا النطاق الجغرافي الجديد للزاوية لتجنّب اقتصاص المحتوى على جانبَي "الشريحة" و"ToggleChip".

    • لم تتغيّر معظم Chips وToggleChips، نظرًا للارتفاع التلقائي الذي يبلغ 52 وحدة بكسل مستقلة الكثافة (dp). ومع ذلك، يمكن أن يحدث تعطُّل اختبارات لقطات الشاشة للكائنَين Chip وToggleChip اللذين يحتويان على أسطر متعددة من نص التصنيف الأساسي أو الثانوي أو تم إلغاء الارتفاع له.

تغييرات إضافية

للحصول على مجموعة أكثر اكتمالاً من التغييرات التي تم إجراؤها في الإصدار 1.3.0، يمكنك الاطّلاع على ملاحظات الإصدارbeta01.

اقتراحات التنفيذ

  • إذا كان تطبيقك يسمح للمستخدمين بتحريك محتوى الشاشة، كما هو الحال في تطبيق مستند إلى الخريطة، يمكنك إيقاف معالجة التمرير السريع من خلال ضبط userSwipeEnabled على false في SwipeDismissableNavHost القابل للإنشاء، وتضمين زر يسمح للمستخدمين بالانتقال إلى الشاشة السابقة.
  • لإيقاف الصور المتحركة لمؤشر الموضع أثناء التلاشي للداخل وتغيير الموضع ضمن قائمة التمرير، استخدِم عنصر SnapSpec.
  • أثناء انتظار تطبيق وسائط لتحميل محتوى لتشغيله، اعرض Placeholder فارغًا قابلاً للإنشاء.
  • لإنشاء مجموعة من العناصر القابلة للتوسيع عند الطلب، يمكنك استخدام فئة ExpandableStateMapping التجريبية.

الإصدار 1.3.0-rc01

10 يناير 2024

تم طرح androidx.wear.compose:compose-*:1.3.0-rc01. يحتوي الإصدار 1.3.0-rc01 على هذه عمليات التنفيذ.

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

  • لقد عدّلنا الشكل الكبير الذي يبلغ MaterialTheme بحيث يستخدِم نصف قطر الزاوية المستديرة بمقدار 26 بكسل مستقل الكثافة، وسيتم استخدام ذلك الآن من خلال "الشريحة" و"ToggleChip". هذا التغيير مطلوب لدعم عمليات ضبط الارتفاع عندما يحتاج المحتوى إلى ارتفاع إضافي لاستيعاب أحجام الخطوط الكبيرة - وإلا، فإن شكل الملعب الحالي يقتطع بعض المحتوى النصي.

    النص مثبّت على الزوايا
    الشكل 1: نص معلّق على الزوايا
    لم يتم اقتصاص النص
    الشكل 2: لم يتم اقتصاص النص.

    وقد يؤدي هذا التغيير إلى تعطُّل في اختبارات لقطات الشاشة. (I2e6ae)

الإصدار 1.3.0-beta02

13 كانون الأول (ديسمبر) 2023

تم طرح androidx.wear.compose:compose-*:1.3.0-beta02. يحتوي الإصدار 1.3.0-beta02 على عمليات التنفيذ هذه.

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

  • لقد أعدنا حركة التمرير السريع المقصودة في BasicSwipeToDismissBox. وقد تم تغيير ذلك في إصدار سابق، بحيث حدث جزء الشريحة عند الانتقال أثناء لمس الشاشة. (Id8e76)

الإصدار 1.3.0-beta01

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

تم طرح androidx.wear.compose:compose-*:1.3.0-beta01. يحتوي الإصدار 1.3.0-beta01 على عمليات التنفيذ هذه.

يشير الإصدار 1.3 إلى الإصدار التجريبي 01 من Compose لـ Wear OS إلى أنّ هذا الإصدار من المكتبة مكتمل السمات وأنّ واجهة برمجة التطبيقات مقفلة (باستثناء إذا تم وضع علامة عليها كإصدار تجريبي). يشمل الإصدار 1.3 من Wear Compose الوظائف الجديدة التالية:

  • تم نقل بيانات SwipeToDismissBoxState وSwipeToDismissValue وModifier.edgeSwipeToDismiss من androidx.wear.compose.material إلى androidx.wear.compose.foundation، بالإضافة إلى عملية تنفيذ التمرير السريع للإغلاق الأساسية في BasicSwipeToDismissBox. يتيح ذلك استخدام التعامل مع الإيماءات مع ميزة التمرير سريعًا للإغلاق بشكل مستقل عن التصميم المتعدد الأبعاد، مثلاً عن SwipeDismissableNavHost في androidx.wear.compose.navigation. لا يزال يُنصح باستخدام SwipeToDismissBox من androidx.wear.compose.material مع Material Design، لأنّه يسحب الألوان من MaterialTheme، ثم يفوّض عملية التنفيذ المتبقية إلى BasicSwipeToDismissBox.
  • يتيح تطبيق "SwipeDismissableNavHost" الآن مَعلمة userSwipeEnabled جديدة تتيح إيقاف ميزة التمرير السريع على الشاشات التي لا تتطلّب ذلك.
  • تم تحسين التعامل مع التركيز في "BasicSwipeToDismissBox" باستخدام "HierarchicalFocusCoordinator".
  • تتوفّر في SwipeToReveal عناصر جديدة من نوع SwipeToRevealCard وSwipeToRevealChip قابلة للإنشاء في "المواد" تتّبع إرشادات تجربة المستخدم المقترَحة لكل من Card وChip. وقد تم أيضًا التراجع عن إتاحة الإجراء الثانوي.
  • يتم الآن إيقاف المساحة المتروكة للخط من خلال تطبيق DefaultTextStyle لتصبح متسقة في نظام Android الأساسي.
  • يتم الآن تعديل ارتفاع Chip وToggleChip لاستيعاب المحتوى الذي ازداد رواجه بسبب استخدام خطوط كبيرة لتسهيل الاستخدام.
  • يشتمل تطبيق PositionIndicator الآن على مواصفات فردية للصور المتحركة في الصور المتحركة التي تتلاشى للداخل أو التلاشي للخارج أو لتغيير الموضع. لأسباب تتعلق بالأداء، ننصح بإيقاف ميزة التلاشي وتغيير الموضع عند استخدامهما مع القوائم القابلة للتمرير.
  • توفّر ExpandableStateMapping طريقة جديدة لإنشاء ExpandableStates عندما يلزم إنشاؤها عند الطلب وليس بالضرورة على نطاق @Composable.
  • يسمح Placeholder الآن بإعادة الضبط إذا لم يعُد المحتوى جاهزًا. بالإضافة إلى ذلك، يتم الآن تطبيق إعداد تقليل الحركة على التأثير اللامعان وحركة المسح في Placeholder.

المشاكل المعروفة

  • لا يتم عرض "PositionIndicator" في البداية عند عرض الشاشة لأول مرة. نعتزم إجراء تغيير على إصدار ألفا مبكر 1.4 بحيث يتم عرضه في البداية، ولكن بدون أي رسوم متحركة.

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

  • لقد أعدنا تسمية المستوى الأساسي SwipeToDismissBox إلى BasicSwipeToDismissBox. وهذا يجعل التمييز أكثر وضوحًا بين مكوّن على مستوى الأساس ومستوى المادة SwipeToDismissBox. هذا الخيار يسحب الألوان من MaterialTheme لاستخدامها في أدوات التحديد ويفوض التنفيذ المتبقي إلى BasicSwipeToDismissBox. (Ibecfc)
  • لقد وضعنا علامة على "rememberExpandableStateMapping" كجهاز تجريبي وحسّننا أداء expandableItem. (I5f6bc)
  • لقد استبدلنا الفئة SwipeToRevealAction في واجهات برمجة التطبيقات الخاصة ببطاقة Material SwipeToReveal والرقاقة بواجهة برمجة تطبيقات مستندة إلى الخانة باستخدام العناصر القابلة للإنشاء SwipeToRevealPrimaryAction وSwipeToRevealSecondaryAction وSwipeToRevealUndoAction. يُرجى الاطّلاع على الرمز النموذجي للحصول على أمثلة حول كيفية استخدام واجهة برمجة التطبيقات الجديدة. (Ia8943)
  • لقد استبدلنا علامات الرسوم المتحركة PositionIndicator بمعلمات AnimationSpec. ويمكن إيقاف الصور المتحركة الفردية من خلال ضبط snap كعنصر AnimationSpec. (I6c523)

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

  • أصلحنا خطأ ناتجًا عن نص منحنٍ محدود عندما يكون الحجم محدودًا (I50efe).
  • لقد عالجنا مشكلة تعطُّل NaN محتملة مرتبطة بـ curvedComposable (I970eb).
  • تم التراجع عن إزالة الصورة المتحركة لتسليط الضوء على تغيير الموضع في PositionIndicator. (Ieb424)
  • أزلنا طبقة النواة المادية لرقاقة المواد لتحسين أدائها. (If2dcb)

الإصدار 1.3.0-alpha08

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

تم طرح androidx.wear.compose:compose-*:1.3.0-alpha08. يحتوي الإصدار 1.3.0-alpha08 على هذه عمليات التنفيذ.

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

  • لقد أضفنا علامات فردية إلى أحمال PositionIndicator الزائدة للتحكّم في الصور المتحركة المختلفة: showFadeInAnimation وshowFadeOutAnimation وshowPositionAnimation. لقد تم إيقاف واجهة برمجة التطبيقات السابقة نهائيًا، وتتم إعادة توجيه الطلبات إلى الواجهة الجديدة. لأسباب تتعلق بالأداء واتّساق تجربة المستخدم، عند استخدام PositionIndicator مع قائمة قابلة للتمرير، ننصحك بإيقاف علامتَي showFadeInAnimation وshowPositionAnimation. في حال استخدام PositionIndicator كمؤشر مستقلّ، على سبيل المثال لتغيير مستوى الصوت، ننصح بتفعيل جميع الصور المتحركة الثلاث. (I44294)
  • لقد أوقفنا المواد SwipeToDismissBoxState وSwipeToDismissValue وedgeSwipeToDismiss نهائيًا بعد نقل وظيفة "التمرير السريع للرفض" إلى wear.compose.foundation. يُرجى استبدالها بـ wear.compose.foundation المكافئة. (Iee8c9)

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

  • لقد عدّلنا الملفات الشخصية الأساسية لمكتبة مواد العرض الأساسية ومكتبة مواد العرض والتنقل. (Idb060)
  • تم التراجع عن التغيير السلوكي في PositionIndicator الذي تم تقديمه في CL سابق، بحيث كان PositionIndicator متحرّكًا عند عرض الشاشة في البداية. نعتزم إجراء تغيير مماثل في إصدار أولي 1.4، بحيث يتم عرض PositionIndicator في البداية ولكن بدون أي رسوم متحركة. (I41843)
  • لقد عالجنا بعض المشاكل المتعلقة بالأداء في PositionIndicator. (I1c654، b/302399827)
  • تم تحسين أداء التنفيذ التلقائي لمزوّد حالة الاستكشاف باللمس للاعتماد على State<Boolean> بدلاً من الحالة المستمدة. (Ieec4d)
  • لقد تم ضبط systemGestureExclusion مستطيلات لنظام التشغيل Android 13 والإصدارات الأحدث. (Ib1f4b)

الإصدار 1.3.0-alpha07

‫4 أكتوبر 2023

تم طرح androidx.wear.compose:compose-*:1.3.0-alpha07. يحتوي الإصدار 1.3.0-alpha07 على هذه عمليات التنفيذ.

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

  • لقد أضفنا علامات فردية إلى 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

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

تم طرح androidx.wear.compose:compose-*:1.3.0-alpha06. يحتوي الإصدار 1.3.0-alpha06 على هذه عمليات التنفيذ.

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

  • لقد أضفنا إمكانية استخدام النطاق Modifier.edgeSwipeToDismiss من خلال SwipeToReveal. (I95774، b/293444286)
  • لقد أضفنا نماذج للمادتين SwipeToRevealChip وSwipeToRevealCard. (Ieb974)
  • تم تحديث الملفات الشخصية الأساسية لمكتبات Wear Compose Foundation وMaterials. (I1dd1f)

الإصدار 1.3.0-alpha05

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

تم طرح androidx.wear.compose:compose-*:1.3.0-alpha05. يحتوي الإصدار 1.3.0-alpha05 على هذه عمليات التنفيذ.

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

  • لقد أضفنا خيار المعالجة في ميزة "التمرير سريعًا لعرض التفاصيل" بحيث يمكن التمرير سريعًا على عنصر واحد فقط في كل مرة. (I3cd7a)
  • تم تحسين عملية توثيق ScalingLazyColumnDefaults لمطابقة سلوكها الفعلي بشكل أفضل. (I886d3)

الإصدار 1.3.0-alpha04

23 آب (أغسطس) 2023

تم طرح androidx.wear.compose:compose-*:1.3.0-alpha04. يحتوي الإصدار 1.3.0-alpha04 على هذه عمليات التنفيذ.

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

  • لقد أضفنا إمكانية التراجع عن الإجراء الثانوي للإجراء SwipeToReveal. (I7a22d)

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

  • يمكنك إضافة "HorizontalPageIndicator" في مكتبة Wear Material3. (Ifee99)
  • تم تعديل أداة معاينة Wear Compose لاستخدام مكتبة androidx.wear.tooling.preview. (Ib036e)

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

  • إصلاح خطأ في الأزرار الدائرية التي لم يتم فيها ربط مفاتيح التعديل بشكل صحيح (I5e162)

الإصدار 1.3.0-alpha03

9 آب (أغسطس) 2023

تم طرح androidx.wear.compose:compose-*:1.3.0-alpha03. يحتوي الإصدار 1.3.0-alpha03 على هذه عمليات التنفيذ.

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

  • لقد أضفنا عنصرَين جديدَين قابلَين للإنشاء في المادة الأساسية لتنفيذ SwipeToReveal مع البطاقات والشرائح. تتّبع هذه العناصر القابلة للإنشاء إرشادات تجربة المستخدم المقترَحة بشأن المكوّنات، وتسهّل على المطوّرين تنفيذ SwipeToReveal باستخدام المكوّنات الحالية في Wear Material. (I7ec65)
  • لقد فعّلنا تعليقات FloatRange التوضيحية كقيود لواجهة برمجة التطبيقات، وقد تم ذكرها سابقًا في التعليقات. (Icb401)

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

  • تم نقل منطق التمرير الأولي لـ ScalingLazyColumn داخل onGloballyPositioned(). (Ic90f1)
  • نحن نستخدم الآن drawWithCache في PositionIndicator وProgressIndicator وSelectionControls لتحسين عمليات توزيع المفاتيح. (I5f225، b/288234617)
  • لقد أصلحنا علامة اختيار مربّع الاختيار في حالات الإيقاف. (Ib25bf)
  • تم تعديل السمة Placeholder للسماح بإعادة الضبط من أجل عرض العنصر النائب إذا لم يعُد المحتوى جاهزًا. (Ibd820)
  • لقد أجرينا بعض الإصلاحات على اختبارات Placeholder غير المستقرة (Idb560).

الإصدار 1.3.0-alpha02

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

تم طرح androidx.wear.compose:compose-*:1.3.0-alpha02. يحتوي الإصدار 1.3.0-alpha02 على هذه عمليات التنفيذ.

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

  • لقد قدّمنا طريقة جديدة لإنشاء ExpandableStates، وهي ExpandableStateMapping، للحالات التي يجب إنشاؤها عند الطلب، وليس بالضرورة أن تكون ضمن نطاق @Composable (Iff9e0).
  • تم نقل SwipeToDismissBox من androidx.wear.compose.material إلى حزمة androidx.wear.compose.foundation. (I275fb)
  • تم تعديل ملفات واجهة برمجة التطبيقات لإضافة تعليقات توضيحية إلى منع التوافق. (I8e87a، b/287516207)
  • جعلنا ثوابت الارتفاع Chip وCompactChip وToggleChip عامة (Idbfde)
  • تم جعل المساحات المتروكة الأفقية والرأسية Chip وCompactChip عامة. (Ieeaf7)
  • تمت إضافة وظيفة لإيقاف معالجة التمرير السريع في SwipeDismissableNavHost عبر مَعلمة userSwipeEnabled الجديدة. (Id2a0b، b/230865655)
  • تم تعديل مكتبة التنقّل في Compose لاستخدام SwipeToDismissBox الجديدة من Wear Compose Foundation. (I4ff8e)

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

  • أصلحنا خطأ ترتيب z حيث لم يعرض expandedItem المحتوى الصحيح بعد النقر على سلوك أحد الأزرار عندما يكون يحتوي على أزرار. (I1899d، b/289991514)
  • يمكنك تحسين معالجة التركيز على SwipeToDismissBox (وبالتالي SwipeDismissableNavHost) باستخدام HierarchicalFocusCoordinator (I45362، وb/277852486).
  • تم إصلاح مشكلة التعامل مع الإيماءات في SwipeableV2 . (I89737)
  • لقد انتهينا من الملفات الشخصية الأساسية لإصدارنا 1.2. (Id5740)
  • بعد نقل السمة SwipeToDismissBox إلى سمة "مؤسسة"، تتم الآن إعادة توجيه عملية تنفيذ المادة SwipeToDismissBox إلى "مؤسسة" وتوفير قيم الألوان التلقائية من موضوعها.(If8451)
  • لقد أضفنا دلالات العنوان إلى ListHeader. (Ic5420)
  • يتم الآن تعديل ارتفاع كل من Chip وToggleChip ليلائم المحتوى الذي ازداد حجمه بسبب توفُّر خطوط كبيرة لتسهيل الاستخدام، عند الحاجة. (Iaf302)
  • تم إصلاح خطأ في الدور الدلالي للمنطقة القابلة للنقر في SplitToggleChip لتسهيل الاستخدام. (Ieed3a)
  • يعمل إعداد تقليل الحركة الآن على إيقاف التأثير الوميض وحركة المسح على العناصر النائبة. (I91046)
  • يمكن الآن استخدام Stepper وInlineSlider مع النقرات المتكرّرة عند الضغط مع الاستمرار لكي تتمكّن من زيادة/خفض قيمة Stepper وInlineSlider بسرعة من خلال الضغط مع الاستمرار على الزرّ + أو -. (I27359)

الإصدار 1.3.0-alpha01

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

تم طرح androidx.wear.compose:compose-*:1.3.0-alpha01. يحتوي الإصدار 1.3.0-alpha01 على هذه عمليات التنفيذ.

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

  • كما أعلنّا في 1.2.0-alpha07 و1.2.0-alpha10، نحن بصدد تغيير DefaultTextStyle لإيقاف المساحة المتروكة للخطوط كي تكون متسقة في نظام Android الأساسي. سيعالج ذلك بعض حالات اقتصاص النصوص ذات أحجام الخطوط الكبيرة، وقد يؤثر أيضًا في تنسيقات الشاشة، وبالتالي يجب تعديل اختبارات لقطات الشاشة. على سبيل المثال، نرى هنا اقتصاص النص (Ic6a86).
النص مقصوص بحجم خط كبير
الشكل 1: النص مقصوص.
  • لن يعود متاحًا عند إيقاف المساحة المتروكة للخط:
لم يتم اقتصاص النص بحجم خط كبير
الشكل 2: لم يتم اقتصاص النص.
  • تم تحديث wear.compose.foundation ليصبح نظامًا يعتمد على واجهة برمجة التطبيقات wear.compose.material (I72004، b/285404743).
  • أصلحنا خطأ في "SwipeToDismissBox". يتم الآن تمرير مفاتيح المحتوى والخلفية إلى جزء التذكُّر حتى يتم إنشاء مفاتيح تعديل جديدة عندما يتغيّر المحتوى أو الخلفية. (Ib876c، b/280392104)
  • عدّلنا TimeText لاستخدام اللغة عند اختيار تنسيق الإعداد لمدة 12 أو 24 ساعة. (If4a3d)
  • أصلحنا عدم اتّساق في المعلمات التلقائية SwipeToDismissBox contentScrimColor. (I2d70f)
  • لقد أدخلنا تحسينات على إمكانية التعامل مع الحركة في SwipeToReveal. (I28fb7)

المشاكل المعروفة

  • يعتبر دعم أحجام الخطوط التي يضبطها المستخدم من متطلبات إمكانية الوصول. نعلم أنّ "الشرائح المتعددة الأسطر" قد تؤدي إلى كسر النص عند عرضها بأحجام خطوط كبيرة، لذلك سنحدِّث "الشريحة" في إصدار 1.3 ألفا مبكر لإجراء تعديلات على الارتفاع في تلك الحالات.

الإصدار 1.2

الإصدار 1.2.1

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

تم طرح androidx.wear.compose:compose-*:1.2.1. يحتوي الإصدار 1.2.1 على عمليات الالتزام هذه.

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

  • تم إصلاح الخطأ الذي تسبَّب في اختفاء "PositionIndicator" بشكل غير صحيح. (7a167f)

الإصدار 1.2.0

9 آب (أغسطس) 2023

تم طرح androidx.wear.compose:compose-*:1.2.0. يحتوي الإصدار 1.2.0 على عمليات الالتزام هذه.

تغييرات مهمة منذ الإصدار 1.1.0

  • إصدار ثابت من Compose لنظام التشغيل Wear OS 1.2.0 (مزيد من المعلومات)
  • للحصول على قائمة بالتغييرات الأساسية في الإصدار 1.2 من Wear Compose، يمكنك الاطّلاع على ملاحظات الإصدار (Compose for Wear OS 1.2beta01).

الإصدار 1.2.0-rc01

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

تم طرح androidx.wear.compose:compose-*:1.2.0-rc01. يحتوي الإصدار 1.2.0-rc01 على هذه عمليات التنفيذ.

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

  • لقد انتهينا من الملفات الشخصية الأساسية للإصدار 1.2 (Id5740).

الإصدار 1.2.0-beta02

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

تم طرح androidx.wear.compose:compose-*:1.2.0-beta02. يحتوي الإصدار 1.2.0-beta02 على عمليات التنفيذ هذه.

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

  • لقد أضفنا المتغيّر التجريبي الجديد LocalReduceMotion CompositionLocal الذي يوقِف تغيير الحجم والتلاشي في ScalingLazyColumn. (I58024)

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

  • لقد عدّلنا الملفات الشخصية الأساسية لمكتبة مواد العرض الأساسية ومكتبة Wear WebView(I4725d).
  • أصلحنا عدم اتّساق في القيم التلقائية لمَعلمات contentScrimColor SwipeToDismissBox (I2d70f)
  • لقد أصلحنا القيمة التلقائية DefaultTextStyle المُستخدَمة في الإعداد IncludeFontPadding (I737ed).

الإصدار 1.2.0-beta01

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

تم طرح androidx.wear.compose:compose-*:1.2.0-beta01. يحتوي الإصدار 1.2.0-beta01 على عمليات التنفيذ هذه.

ميزات أداة Compose في الإصدار 1.2 من نظام التشغيل Wear OS

يشير الإصدار 1.2 إلى بيتا01 من Compose لـ Wear OS إلى أنّ هذه الميزات من المكتبة قد اكتملت وأنّ واجهة برمجة التطبيقات مقفلة (باستثناء إذا تم وضع علامة عليها بأنّها تجريبية). يشتمل الإصدار 1.2 من Wear Compose على الوظائف الجديدة التالية:

  • expandableItem وexpandableItems هما مكوِّنان جديدان من Foundation يتيحان توسيع العناصر داخل ScalingLazyColumn. استخدِم expandableItem لعنصر واحد قابل للتوسيع، مثل النص الذي يتضمّن عدد الأسطر. يمكنك استخدام expandableItems لمجموعة من العناصر القابلة للتوسيع وexpandableButton لتبسيط إنشاء زر يتم تصغيره بعد توسيع المحتوى.
  • HierarchicalFocusCoordinator - تتيح هذه الميزة التجريبية القابلة للإنشاء وضع علامة على الأشجار الفرعية في المقطوعة الموسيقية للإشارة إلى أنّها مفعَّلة أو تم إيقاف التركيز عليها.
  • Picker: تتضمّن واجهة برمجة التطبيقات الآن userScrollEnabled للتحكّم في ما إذا كانت أداة الاختيار نشطة للتنقّل بين المستخدمين.
  • PickerGroup - عنصر جديد قابل للإنشاء للتعامل مع أدوات اختيار متعددة معًا. وتعالج هذه الميزة التركيز بين أدوات الاختيار باستخدام واجهة برمجة تطبيقات HierarchicalFocusCoordinator، كما تفعِّل ميزة التوسيط التلقائي لعناصر الاختيار.
  • Placeholder: لقد أجرينا تعديلات على الصور المتحركة اللامعة والصور المتحركة "محو". يتم الآن تطبيق تأثير المسح على الفور عندما يصبح المحتوى جاهزًا.
  • ScalingLazyColumn - تم نقل بيانات ScalingLazyColumn والفئات المرتبطة بها من androidx.wear.compose.material.ScalingLazyColumn إلى androidx.wear.compose.foundation.lazy.ScalingLazyColumn. يُرجى تحديث التطبيق لاستخدام إصدار Foundation.Lazy.
  • SwipeToReveal: لقد أضفنا دعمًا تجريبيًا لميزة "التمرير السريع لعرض" كوسيلة للوصول إلى الإجراءات الثانوية، بحيث تكمل نمط "الضغط مع الاستمرار" الحالي.
  • تتضمّن الدالة Stepper الآن حملاً زائدًا مع مَعلمة enableRangeSemantics إضافية لتسهيل إيقاف دلالات النطاق التلقائي.
  • Previews: لقد أضفنا التعليقات التوضيحية المخصّصة التالية لمعاينة العناصر القابلة للإنشاء على شاشات Wear OS: "WearPreviewSmallRound" يعاين العنصر القابل للإنشاء على جهاز دائري صغير. يعاين WearPreviewLargeRound العنصر القابل للإنشاء على جهاز دائري كبير. يعاين WearPreviewSquare العنصر القابل للإنشاء على جهاز مربّع. بالإضافة إلى ذلك، يعاين WearPreviewFontScales التعليقات التوضيحية التالية والمعاينة المتعدّدة: العناصر القابلة للإنشاء على جهاز قابل للارتداء بأحجام خطوط متعدّدة، في حين يعاين WearPreviewDevices العناصر القابلة للإنشاء على أجهزة Wear OS مختلفة.
  • لقد أضفنا DefaultTextStyle إلى Wear Compose والذي سيؤدي إلى ضبط السمة PlatformTextStyle.includeFontPadding تلقائيًا على "صحيح" (هذا هو الإعداد الحالي). سيتيح لنا ذلك مزامنة إيقاف المساحة المتروكة للخطوط تلقائيًا مع مكتبات "إنشاء" في الإصدارات الأولية من 1.3. راجع 1.2.0-alpha10 للحصول على مزيد من المعلومات.

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

  • لقد أضفنا دعمًا تجريبيًا لتحريك الصور المتحركة والتلاشي المعطلة عند تشغيل إعداد تقليل_الحركة. (I58024)

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

  • مستندات محسَّنة حول angularWidthDp في CurvedSize.kt (Iab75c)
  • يسجِّل SwipeDismissableNavHost الآن تحذيرًا بالأسباب المحتملة وراء احتواء تسلسل استدعاء الدوال البرمجية على مساحة فارغة. ويتم إجراء ذلك لمنع حدوث أعطال غير متوقّعة بسبب IllegalArgumentException الذي تم طرحه عندما كانت حزمة الخلفية فارغة. (I04a81، b/277700155)

الإصدار 1.2.0-alpha10

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

تم طرح androidx.wear.compose:compose-*:1.2.0-alpha10. يحتوي الإصدار 1.2.0-alpha10 على هذه عمليات التنفيذ.

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

  • لقد أضفنا دعمًا لميزة "التمرير السريع لعرض الرسالة" كوسيلة للوصول إلى الإجراءات الثانوية. يكمل هذا النمط نمط "الضغط مع الاستمرار"، والطريقة الحالية التي يمكن للمستخدم من خلالها الكشف عن إجراءات ثانوية (مختلفة). (I60862)

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

  • لقد أضفنا RevealScope إلى عناصر الإجراء القابلة للإنشاء في SwipeToReveal، ما يتيح الوصول إلى الإزاحة التي يتم عندها الكشف عن إجراءات إضافية. (I3fd56)

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

  • تم إصلاح مشكلة توقُّف "ScalingLazyColumn" على واجهة برمجة تطبيقات Wear API 33 بعد الانتقال إلى واجهة أخرى (Ic4599).
  • لقد أجرينا بعض التحسينات على أداء "PositionIndicator" للحدّ من التعطّل. (I35e92)
  • أصلحنا خطأً في "الشريحة" و"CompactChip" حيث لم يعُد يتم ضبط الدور الدلالي على Role.Button. (I93f91، b/277326264)

المشاكل المعروفة

  • لقد رصدنا خطأً في "استوديو Android" يتسبب في تعذُّر عرض المعاينة عند إضافة تعليقات توضيحية إليها باستخدام @WearPreviewDevices و @WearPreviewFontScales. ومن المقرَّر طرح إصلاحٍ قريبًا. تجدر الإشارة إلى أنّ التعليقات التوضيحية الأخرى لمعاينة إصدار Wear تعمل على النحو المطلوب في الإصدار Giraffe من "استوديو Android" لعام 2022.3.1 والإصدارات اللاحقة.

  • في الإصدار 1.2.0-alpha07 أضفنا defaultTextStyle إلى Wear Compose، مع الاحتفاظ بقيمة PlatformTextStyle.includeFontPadding الحالية على "صحيحة". وبالنسبة إلى الخلفية، يمكنك الاطّلاع على إصلاح مساحة الخطوط المتروكة في Compose. سنغيّر بشكل تلقائي TextStyle لإيقاف المساحة المتروكة للخط في الإصدار 1.3 ألفا في البداية، وذلك من أجل الاتساق على مستوى نظام Android الأساسي. سيعالج ذلك بعض حالات اقتصاص النصوص ذات أحجام الخطوط الكبيرة وقد يؤثر أيضًا في تنسيقات الشاشة، وبالتالي تحتاج اختبارات لقطات الشاشة إلى تعديل. فعلى سبيل المثال، في حالة وجود خطوط كبيرة، نرى النص يقتطع هنا:

النص مقصوص بحجم خط كبير
الشكل 1: النص مقصوص.
  • لن يعود متاحًا عند إيقاف المساحة المتروكة للخط:
لم يتم اقتصاص النص بحجم خط كبير
الشكل 2: لم يتم اقتصاص النص.

يمكن اعتماد الإعداد الجديد الآن من خلال تجاوز أسلوب الخط في المظهر، ويمكنك الاطّلاع على مثال على الرمز.

الإصدار 1.2.0-alpha09

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

تم طرح androidx.wear.compose:compose-*:1.2.0-alpha09. يحتوي الإصدار 1.2.0-alpha09 على هذه عمليات التنفيذ.

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

  • أضِف angularSizeDp إلى واجهة برمجة تطبيقات CurvedModifier لضبط عرض زاوية في DP (I89a52).

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

  • أصلحنا مشاكل تسهيل الاستخدام في الإصدارات التجريبية لأداة اختيار الوقت(Id0eb7).

الإصدار 1.2.0-alpha08

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

تم طرح 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

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

تم طرح androidx.wear.compose:compose-*:1.2.0-alpha07. يحتوي الإصدار 1.2.0-alpha07 على هذه عمليات التنفيذ.

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

  • لقد نقلنا مكونات العنصر القابل للتوسيع (المُضافة في الإصدار 1.2.0-alpha06) من المادة إلى الأساس، نظرًا لعدم وجود إشارة مفيدة إلى MaterialTheme. (Ib0525)

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

  • أصلحنا عطلاً حدث على شاشة باستخدام PickerGroup، وذلك من خلال التأكد من معالجة PickerGroup للتركيز بشكل صحيح عندما لا يكون هناك تركيز على منتقي. كما أضفنا دعمًا لتمرير RSB في عروض أداة الاختيار. (If8c19)
  • لقد أدخلنا تحسينات على انتقالات مربّعات الحوار، وأصبح الانتقال إلى المقدمة أكثر سلاسة الآن لمطابقة الانتقال الختامي. (Ib5af9)
  • لقد أضفنا DefaultTextStyle إلى Wear Compose والذي سيؤدي إلى ضبط السمة PlatformTextStyle.includeFontPadding تلقائيًا على "صحيح" (هذا هو الإعداد الحالي). سيتيح لنا ذلك مزامنة إيقاف المساحة المتروكة للخط تلقائيًا مع مكتبات "إنشاء" في المستقبل. راجِع (إصلاح المساحة المتروكة للخط في ميزة "إنشاء") للحصول على خلفية. (I2aee8)
  • تمت إعادة الاعتماد على معاينة UpsideDownCake من خلال إنشاء النشاط الذي حظر نشر التطبيقات إلى "متجر Google Play". (I6443d)

الإصدار 1.2.0-alpha06

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

تم طرح androidx.wear.compose:compose-*:1.2.0-alpha06. يحتوي الإصدار 1.2.0-alpha06 على هذه عمليات التنفيذ.

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

  • إضافة المكوِّن CurvedBox، الذي يضع العناصر فوق بعضها البعض في العالم المنحني. (I29200)
  • تمت إضافة العناصر القابلة للتوسيع - مكونان جديدان لدعم إما مجموعة من العناصر القابلة للتوسيع في ScalingLazyColumn، أو عنصر واحد قابل للتوسيع، مثل النص الذي يتوسع فيه عدد الأسطر. (I95dd5)
  • لقد أضفنا التعليقات التوضيحية المخصّصة التالية لمعاينة العناصر القابلة للإنشاء على شاشات Wear OS: يعاين "WearPreviewSmallRound" المحتوى القابل للإنشاء على جهاز دائري صغير. يعاين WearPreviewLargeRound العنصر القابل للإنشاء على جهاز دائري كبير. يعاين WearPreviewSquare العنصر القابل للإنشاء على جهاز مربّع. بالإضافة إلى ذلك، يعاين WearPreviewFontScales التعليقات التوضيحية التالية والمعاينة المتعدّدة: العناصر القابلة للإنشاء على جهاز قابل للارتداء بأحجام خطوط متعدّدة، في حين يعاين WearPreviewDevices العناصر القابلة للإنشاء على أجهزة Wear OS مختلفة. لاستخدام هذه المعاينات، يجب استخدام أحدث إصدار من "استوديو Android" (Giraffe Canary 6) أو الإصدارات الأحدث. تجدر الإشارة إلى أنّه إذا لم تناسب هذه التعليقات التوضيحية هدفك، سيظلّ بإمكانك استخدام المعاينة وإتاحة إمكانية إجراء المزيد من عمليات التخصيص من خلال المَعلمات. (I397ff)
  • لقد وضعنا علامة على "HierarchicalFocusCoordinator" باعتباره تجريبيًا، بينما يُعتبَر مرشّحًا لنقله إلى مكتبات الإنشاء الأساسية، نظرًا إلى قابلية تطبيقه. (I3a768)

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

  • تم إصلاح خطأ في HierarchicalFocusCoordinator، عندما تم تغيير دالة lambda التي تم تمريرها للمَعلمة focusEnabled، نستخدم الآن القيمة الجديدة بشكلٍ صحيح. (Icb353)
  • لقد عدّلنا لون المحتوى المتوقف التلقائي إلى "الخلفية" عند استخدام الألوان الأساسية كخلفية في Button وCompactButton وChip وCompactChip وToggleButton. يؤدي هذا إلى تحسين تباين سهولة الوصول. (I527cc)

الإصدار 1.2.0-alpha05

22 شباط (فبراير) 2023

تم طرح androidx.wear.compose:compose-*:1.2.0-alpha05. يحتوي الإصدار 1.2.0-alpha05 على هذه عمليات التنفيذ.

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

  • تم تعديل واجهة برمجة تطبيقات PickerGroup للسماح بنشر القيود الأدنى على العنصر القابل للإنشاء بشكل اختياري. عند ضبط هذه السياسة على "صحيح"، سيتم السماح بالحدّ الأدنى من القيود التي تم تمريرها من العنصر الرئيسي القابل للإنشاء في PickerGroup. وفي حال ضبطها على "خطأ"، سيعيد PickerGroup ضبط الحدّ الأدنى للقيود. (I3e046)
  • لقد أضفنا animateScrollToOption إلى واجهة برمجة تطبيقات Picker لإتاحة الصور المتحركة الآلية في أداة اختيار محددة (I6fe67)

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

  • تم تحديث HorizontalPageIndicator لإتاحة التنسيقات من اليمين إلى اليسار. (Ia4359)
  • تمت إضافة اختبارات لقطات الشاشة للتنسيق من اليمين إلى اليسار في HorizontalPageIndicator (I6fbb8)
  • تمت إضافة المزيد من الاختبارات إلى SwipeDismissableNavHostTest والتي تستخدم TestNavHostController (I61d54).

الإصدار 1.2.0-alpha04

8 شباط (فبراير) 2023

تم طرح androidx.wear.compose:compose-*:1.2.0-alpha04. يحتوي الإصدار 1.2.0-alpha04 على هذه عمليات التنفيذ.

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

  • PickerGroup للتعامل مع أدوات اختيار متعددة معًا باستخدام واجهة برمجة تطبيقات التركيز. وتتعامل مع التركيز بين أدوات الاختيار المختلفة، وتفعِّل ميزة التوسيط التلقائي للأدوات الاختيارية استنادًا إلى المَعلمات، وتسمح للمطوّرين بتغيير التركيز بين أدوات الاختيار المختلفة أثناء التعامل مع الأحداث من المجموعة. في وضع TalkBack، تعالج السمة PickerGroup تركيز TalkBack من خلال نقل التركيز إلى "أداة الاختيار" المحدَّدة من المجموعة. (I60840)

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

  • لقد أضفنا حملاً زائدًا إلى برنامج الخطوة مع مَعلمة enableRangeSemantics إضافية لتسهيل إيقاف دلالات النطاق التلقائي (Ia61d4).

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

  • السماح بدمج ScalingLazyColumn في صفحة تمرير أفقي (Iec3f8، b/266555016)
  • تم تحسين أداة إزالة المستندات عن طريق وحدة المعالجة (kdocs) وStepperTest اختبارات. (Ic118e)
  • تم تعديل تبعية androidx.navigation إلى الإصدار 2.5.3 (If58ed).

الإصدار 1.2.0-alpha03

25 كانون الثاني (يناير) 2023

تم طرح 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، وهو طبيعي أكثر لأنه ليس مكوّنًا من مكوّنات المادة المستندة إلى رأي. يتم تطبيق التغيير الآن استعدادًا لمكتبة Material3 جديدة، والتي سنعمل عليها بالتوازي مع مكتبة Materials الحالية. (I060e7)

التغييرات التالية في عملية نقل ScalingLazyColumn من Material إلى Foundation.Lazy:

  • تم إيقاف PositionIndicator من واجهات برمجة التطبيقات التي تستهدف المادة ScalingLazyColumn - يُرجى التحديث إلى Foundation.Lazy ScalingLazyColumn. تمت إضافة حقل "anchorType" أيضًا إلى "ScalingLazyListLayoutInfo". (I29d95)
  • تم إيقاف تطبيق ScalingLazyColumn نهائيًا في حزمة مواد Wear Compose (I16d34).
  • عدّلنا أداة التعديل "ScrollAway" لاستخدام "ScalingLazyListState" من نظام التشغيل Wear Compose Foundation.Lazy وأوقفنا نهائيًا التحميل الزائد الذي بلغ ScalingLazyListState من مواد Wear Compose. (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 إلى الاعتماد على Foundation.Lazy بدلاً من Material ScalingLazyColumn (Ic6caa).
  • لقد أضفنا معلَمات fromDate/toDate اختيارية إلى الإصدار التجريبي من DatePicker (I961cd).

الإصدار 1.2.0-alpha02

11 كانون الثاني (يناير) 2023

تم طرح androidx.wear.compose:compose-*:1.2.0-alpha02. يحتوي الإصدار 1.2.0-alpha02 على عمليات التنفيذ هذه.

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

  • ستعمل اختبارات واجهة مستخدم Compose في Android الآن على تشغيل بطاقات التنسيق لكل إطار عند تنفيذ الإطارات للانتقال إلى وضع عدم النشاط (على سبيل المثال، عبر waitForIdle). وقد يؤثر ذلك في الاختبارات التي تؤكد على الإطارات الفردية لرسوم متحركة التخطيط. (I8ea08، b/222093277)
  • تتم إضافة المَعلمة minLines إلى تطبيق Wear Text لسلوك متسق مع BasicText (I24874).
  • تم نشر CompactChipTapTargetPadding بشكل علني ليظهر في المستندات (If1e70، b/234119038).

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

  • إيقاف الإصدارات المتعددة الأنظمة الأساسية لحِزم wear.compose (Iad3d7)
  • إصلاح مستندات kdocs لـ scrollToOption (I6f9a0)
  • تم تعديل الدالة PlaceholderState.rememberPlaceholderState() لاستخدام rememberUpdatedState، وسيتم تعديل الحالة إذا كانت دالة onContentReady lambda. (I02635، b/260343754)
  • لقد أصلحنا مشكلة تشوش النص التي تظهر في المكوِّن Picker من خلال الاستفادة من استراتيجية الدمج الجديدة المُضافة إلى Modifier.graphicsLayer. (I99302)
  • أصلحنا خطأً أدى إلى الوميض في إصدار "DatePicker" التجريبي (I660bd).
  • أدخلنا تحسينات على إمكانية الوصول للإصدارات التجريبية لأداة اختيار الوقت والتاريخ لمدة 12 ساعة (I05e12).
  • لقد عدّلنا الإصدارات التجريبية لأداة اختيار الوقت والتاريخ كي لا يتأثر المنتتقيون بتغييرات RSB عند إلغاء اختياره (I4aecb)

الإصدار 1.2.0-alpha01

7 كانون الأول (ديسمبر) 2022

تم طرح androidx.wear.compose:compose-*:1.2.0-alpha01. يحتوي الإصدار 1.2.0-alpha01 على هذه عمليات التنفيذ.

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

  • لقد عدّلنا وظيفة العنصر النائب التجريبية كي يتمّ تطبيق التأثير "حجب البيانات" على الفور عندما يكون المحتوى جاهزًا بدلاً من انتظار بدء تكرار الصور المتحركة التالية. لقد أجرينا أيضًا بعض التحديثات على الرسوم المتحركة اللامعة ومحوها. (I5a7f4)

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

  • لقد أضفنا عنصر HierarchicalFocusCoordinatorقابل للإنشاء لتفعيل وضع علامة على الأشجار الفرعية في المقطوعة الموسيقية كتركيز أو إيقاف التركيز عليها.(I827cb)
  • لقد أضفنا سمة جديدة لإلغاء الدور الدلالي لـ ToggleButton.(I67132)
  • لقد عدّلنا TimeTextDefaults.TimeFormat12Hours لإزالة صباحًا/مساءً في TimeText. سيؤدي هذا إلى تغيير القيمة التلقائية لمَعلمات timeSource في TimeText API. (I1eb7f)
  • لقد وسّعنا نطاق واجهة برمجة التطبيقات Picker API لتحسين إمكانية الوصول إلى الشاشات التي تتيح استخدام أدوات اختيار متعددة. تتوفّر سمة جديدة "userScrollEnabled" للتحكّم في ما إذا كانت أداة الاختيار نشطة للتنقّل بين المستخدمين. (I3c3aa)

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

  • لقد غيّرنا عرض الحد التلقائي لـ OutlinedButton/OutlinedCompactButton من 2.dp إلى 1.dp ليتطابق مع المواصفات النهائية لتجربة المستخدم. (Icf84d)
  • لتقليل تأثير العنصر الأول الذي تمت إضافته إلى عنصر ScalingLazyColumn فارغ الذي يظهر للانتقال إلى مكانه، أضفنا قيمة تقدَّر بـ autoCentering topPadding عندما تكون العناصر فارغة. يحتسب هذا التغيير مقدار المساحة المتروكة العلوية المطلوبة بافتراض أن عنصر أوليًا يبلغ ارتفاعه 0.dp. بالنسبة إلى ScalingLazyListAnchorType.ItemStart، سيتم احتساب المساحة المتروكة العلوية الصحيحة، وبالنسبة إلى ScalingLazyListAnchorType.ItemCenter، ستكون هذه العملية الحسابية غير صحيحة لأنّ ارتفاع العناصر مطلوب لحجم المحتوى بشكل صحيح، ما يؤدي إلى تمرير صغير إلى الموضع المطلوب استنادًا إلى الارتفاع الفعلي للعناصر.(I239a4)
  • لقد عدّلنا تطبيق مصغّر الخلفية على الصورة المتحركة "SwipeToDismiss" ليتطابق مع منصة Wear OS. (I9003e)
  • لقد أصلحنا طريقة معالجة PositionIndicator لـ LazyListState وScalingLazyListState لعناصر القائمة ذات الحجم 0 لتجنُّب القسمة على صفر من الأخطاء.(Ic28dd)

الإصدار 1.1

الإصدار 1.1.2

8 شباط (فبراير) 2023

تم طرح الإصدارات androidx.wear.compose:compose-foundation:1.1.2 وandroidx.wear.compose:compose-material:1.1.2 وandroidx.wear.compose:compose-navigation:1.1.2. يحتوي الإصدار 1.1.2 على عمليات الالتزام هذه.

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

  • أصلحنا خطأً تسبب في عمليات إعادة هيكلة غير ضرورية في ScalingLazyListState.centerItemIndex من خلال التأكد من أنه يرسل التحديثات فقط عندما تتغير القيمة فعليًا (Ia9f38).

الإصدار 1.1.1

11 كانون الثاني (يناير) 2023

تم طرح الإصدارات androidx.wear.compose:compose-foundation:1.1.1 وandroidx.wear.compose:compose-material:1.1.1 وandroidx.wear.compose:compose-navigation:1.1.1. يحتوي الإصدار 1.1.1 على عمليات الالتزام هذه.

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

  • تم تعديل الدالة PlaceholderState.rememberPlaceholderState() لاستخدام rememberUpdatedState، وسيتم تعديل الحالة إذا كانت دالة onContentReady lambda. (I02635، b/260343754)

الإصدار 1.1.0

7 كانون الأول (ديسمبر) 2022

تم طرح الإصدارات androidx.wear.compose:compose-foundation:1.1.0 وandroidx.wear.compose:compose-material:1.1.0 وandroidx.wear.compose:compose-navigation:1.1.0. يحتوي الإصدار 1.1.0 على هذه عمليات التنفيذ.

تغييرات مهمة منذ الإصدار 1.0.0

  • إصدار ثابت من Compose لنظام التشغيل Wear OS 1.1.0 (مزيد من المعلومات)
  • للحصول على قائمة بالتغييرات الأساسية في الإصدار 1.1 من Wear Compose، يمكنك الاطّلاع على ملاحظات الإصدار (Compose لـ Wear OS 1.1 Beta01).

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

  • لقد عدّلنا وظيفة العنصر النائب التجريبية كي يتمّ تطبيق التأثير "حجب البيانات" على الفور عندما يكون المحتوى جاهزًا بدلاً من انتظار بدء تكرار الصور المتحركة التالية. لقد أجرينا أيضًا بعض التحديثات على الرسوم المتحركة اللامعة ومحوها. (I5a7f4)

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

  • لقد غيّرنا عرض الحد التلقائي لـ OutlinedButton/OutlinedCompactButton من 2.dp إلى 1.dp ليتطابق مع المواصفات النهائية لتجربة المستخدم. (Icf84d)
  • لتقليل تأثير العنصر الأول الذي تمت إضافته إلى عنصر ScalingLazyColumn فارغ الذي يظهر للانتقال إلى مكانه، أضفنا قيمة تقدَّر بـ autoCentering topPadding عندما تكون العناصر فارغة. يحتسب هذا التغيير مقدار المساحة المتروكة العلوية المطلوبة بافتراض أن عنصر أوليًا يبلغ ارتفاعه 0.dp. بالنسبة إلى ScalingLazyListAnchorType.ItemStart، سيتم احتساب المساحة المتروكة العلوية الصحيحة، وبالنسبة إلى ScalingLazyListAnchorType.ItemCenter، ستكون هذه العملية الحسابية غير صحيحة لأنّ ارتفاع العناصر مطلوب لحجم المحتوى بشكل صحيح، ما يؤدي إلى تمرير صغير إلى الموضع المطلوب استنادًا إلى الارتفاع الفعلي للعناصر.(I239a4)
  • لقد عدّلنا تطبيق إطارات الخلفية على الصور المتحركة "SwipeToDismiss" ليتناسب مع نظام التشغيل Wear OS (I9003e).
  • لقد أصلحنا طريقة معالجة PositionIndicator لـ LazyListState وScalingLazyListState لعناصر القائمة ذات الحجم 0 لتجنُّب القسمة على صفر من الأخطاء.(Ic28dd)

الإصدار 1.1.0-rc01

9 تشرين الثاني (نوفمبر) 2022

تم طرح الإصدارات androidx.wear.compose:compose-foundation:1.1.0-rc01 وandroidx.wear.compose:compose-material:1.1.0-rc01 و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 من 2.dp إلى 1.dp ليتطابق مع المواصفات النهائية لتجربة المستخدم. (Ib3d8e)
  • أصلحنا خطأً في "rememberPickerState" حيث لم يتم حفظ الإدخالات المعدَّلة، وبالتالي لم يتم تعديل العناصر القابلة للإنشاء بعد إجراء تغييرات على الإدخالات. (I49ff6، b/255323197)
  • لقد أجرينا بعض تحديثات واجهة المستخدم على العناصر النائبة، 1) تغيير التدرج اللامعان إلى 1.5 ضعف حجم الشاشة، 2) إضافة إرخاء (بيزي مكعب) للتقدم اللامعان و3) تسريع الرسوم المتحركة للمسح (250 ميلي ثانية). (Id29c1)
  • صحّحنا خطأ في واجهة المستخدم في تأثير حجب العنصر النائب، والذي كان يتم فيه حجب بيانات خلفيات "الشريحة" و"البطاقة" في وقت مبكر قليلاً بسبب عدم أخذ موضع المكوِّن على الشاشة في الاعتبار. (I2c7cb)
  • لقد عدّلنا رسم خلفية العنصر النائب لدمج الألوان بدلاً من إضافتها إلى طبقات حيثما أمكن، وذلك للحدّ من خطر مزج ألفا الطبقات المختلفة التي تم اقتصاصها ومنع الألوان الأساسية من الانتشار على حواف خلفية العنصر النائب. (I2ea26)
  • لقد صحّحنا عملية احتساب القيمة ScalingLazyListState.centerItemIndex/centerItemOffset بحيث إذا كان العنصران يقعان على جانبي الخط الأوسط في إطار العرض، سيتم اعتبار العنصر الأقرب كقيمة centerItem. (I30709، b/254257769)
  • صحّحنا خطأً في ScalingLazyListState.layoutInfo.visibleItemsInfo كان يُبلغ عن إزاحات غير صحيحة أثناء إعداد ScalingLazyColumn. سيتم الآن إرجاع قائمة فارغة حتى تكون جميع عناصر القائمة مرئية وتحصل على الإزاحة الصحيحة. سيؤدي البحث عن ScalingLazyListState.layoutInfo.visibleItemsInfo.isNotEmpty() إلى التأكّد من اكتمال إعداد ScalingLazyColumn وأنّ العناصر مرئية. (I3a3b8)

الإصدار 1.1.0-beta01

24 تشرين الأول (أكتوبر) 2022

تم طرح الإصدارات androidx.wear.compose:compose-foundation:1.1.0-beta01 وandroidx.wear.compose:compose-material:1.1.0-beta01 وandroidx.wear.compose:compose-navigation:1.1.0-beta01. يحتوي الإصدار 1.1.0-beta01 على عمليات التنفيذ هذه.

ميزات أداة Compose في الإصدار 1.1 من نظام التشغيل Wear OS

أشار الإصدار 1.1.0-beta01 من Compose لنظام التشغيل Wear OS إلى أنّ هذا الإصدار من المكتبة مكتمل السمات وأنّ واجهة برمجة التطبيقات مقفلة.

  • يتضمّن إصدار Wear Compose 1.1 الوظائف الجديدة التالية:
    • المنتقي - تحسينات إمكانية الوصول إلى المنتقي بحيث تكون الشاشات متعددة الاختيار قابلة للتنقل باستخدام برامج قراءة الشاشة ويسهل الوصول إلى وصف المحتوى
    • يتم الآن استخدام مَعلمة المنتقي contentDescription فقط للخيار المحدّد، وتأخذ سلسلة قابلة للقيم الفارغة (في عملية التنفيذ السابقة، كان من الضروري تمرير التعيين من الخيار إلى وصف المحتوى، ولكن تم استخدام الخيار المحدّد فقط).
    • دائمًا ما تتم محاذاة عناصر المنتقي في المنتصف، ويؤدي إصلاح الخطأ عند ضبط gradientRatio على صفر إلى التأثير الجانبي لتغيير المحاذاة.
    • Chip/ToggleChip - لقد عدّلنا التدرجات التلقائية للسمة Chip/ToggleChip لتصبح متوافقة مع أحدث مواصفات تجربة المستخدم. تم تعديل ChipDefaults.gradientBackgroundChipColors ليبدأ من 50% من النسبة الأساسية بدلاً من 32.5%.
    • Chip/ToggleChip - أحمال زائدة لتعديل أشكال الشرائح
    • Chip/Button/ToggleButton: تمت إضافة نمط محدد جديد للشرائح والأزرار وعناصر جديدة من OutlinedChip وOutlinedButton قابلة للإنشاء توفّر Chip/Button شفافًا مع حدود رفيعة.
    • البطاقة - تم تحديث التدرجات الافتراضية للبطاقات لكي تتماشى مع أحدث مواصفات تجربة المستخدم. تم تعديل CardDefaults.cardBackgroundPainter ليبدأ من 30% من المرحلة الأساسية وينتهي عند 20% من onSurfaceVariant (كان النسبة السابقة من 20% إلى 10% onSurfaceVariant). يتغير ToggleChip.toggleChipColors من تدرج خطي من سطح بنسبة 75% إلى 32.5% أولي إلى سطح 0% إلى 50% أولي.
    • 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()) يتم رسمه فوق التأثيرات الأخرى لإخبار المستخدمين أننا في انتظار تحميل البيانات.
      • تم تصميم كل هذه التأثيرات ليتم تنسيقها بشكل متلألئ وممتلئ بطريقة منظمة.
  • تم تعديل اعتماديات "الكتابة الأساسية" من 1.2 إلى 1.3.

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

  • يمكن الآن تحديد مَعلمات الخط (fontFamily وfontWeight وfontStyle وfontSynthesis) مباشرةً كمَعلمات curvedText (Idc422).

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

  • سيعمل curveText وbasicCurvedText الآن بشكل صحيح مع TalkBack (لهما عقدة Compose-ui ذات حجم مناسب وموضوعة (ولكن فارغة) مرتبطة بهما، باستخدام النص كوصف للمحتوى) (I7af7c، b/210721259)
  • تم إصلاح الخطأ في Picker عند PickerState.repeatedItems = false لإضافة إعداد صريح لمَعلمات التوسيط التلقائي على أداة الاختيار الداخلية ScalingLazyColumn لضمان إمكانية تمرير خيار "صفر" إلى وسط العرض. (I8a4d7)

الإصدار 1.1.0-alpha07

5 تشرين الأول (أكتوبر) 2022

تم طرح الإصدارات 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

21 أيلول (سبتمبر) 2022

تم طرح الإصدارات 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

7 أيلول (سبتمبر) 2022

تم طرح الإصدارات 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-للموضع ومؤشرات الصفحة في Scaffold. وسيتم وضع المؤشرات الآن أعلى المقالة القصيرة وبالتالي لن يتم حجبها بواسطة المقالة القصيرة إذا كانت موجودة. (Ib988f، b/244207528)

الإصدار 1.1.0-alpha04

24 آب (أغسطس) 2022

تم طرح الإصدارات androidx.wear.compose:compose-foundation:1.1.0-alpha04 وandroidx.wear.compose:compose-material:1.1.0-alpha04 وandroidx.wear.compose:compose-navigation:1.1.0-alpha04. يحتوي الإصدار 1.1.0-alpha04 على هذه عمليات التنفيذ.

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

  • لقد عدّلنا عددًا من الألوان التلقائية في MaterialTheme لتحسين إمكانية الوصول، لأنّ الألوان الأصلية لم يكن فيها التباين الكافي، ما أدّى إلى صعوبات على المستخدمين التمييز بين خلفيات الشرائح/البطاقات والأزرار من لون خلفية المظهر. الألوان المعدّلة هي table(0xFF202124->0xFF303133) وonPrimary(0xFF202124->0xFF303133 وonsecondary(0xFF202124->0xFF303133) وprimary(0xFF669DF6->0xFF8AB0208) على الرغم من أنّ التغييرات في الألوان قد تكون طفيفة نسبيًا، قد تؤثّر في اختبارات لقطات الشاشة الحالية. (81ab09)

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

  • يمكنك إصلاح خطأ منطقي في ScalingLazyColumn قد يؤدي إلى عدم اكتمال إعداد القوائم التي تحتوي على عدد صغير (عادةً 2) عناصر قائمة، ما يؤدي إلى عدم اكتمال عملية الإعداد. (504347)

الإصدار 1.1.0-alpha03

10 آب (أغسطس) 2022

تم طرح الإصدارات androidx.wear.compose:compose-foundation:1.1.0-alpha03 وandroidx.wear.compose:compose-material:1.1.0-alpha03 وandroidx.wear.compose:compose-navigation:1.1.0-alpha03. يحتوي الإصدار 1.1.0-alpha03 على هذه عمليات التنفيذ.

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

  • لقد أضفنا نمطًا محددًا جديدًا لـ Chips وButtons وعناصر OutlinedChip وOutlinedButton الجديدة القابلة للإنشاء التي توفّر Chip/Button شفافًا مع حدود رفيعة. (Id5972)

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

  • إضافة أحمال زائدة لتعديل أشكال الأزرار (Icccde)

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

  • لقد صحّحنا حجم منطقة التحكّم في زر الإيقاف/التفعيل في ToggleChip لأنّها لم تكن متوافقة مع مواصفات تجربة المستخدم. تستدعي مواصفات تجربة المستخدم فاصلاً 4.dp بين التسمية ومنطقة رمز تحكم التبديل 24x24.dp مما يعطي عرض إجمالي 28.dp. ومع ذلك، فإن التنفيذ يعطي بشكل غير صحيح منطقة التحكم في تبديل 36x24.dp. ينتج عن ذلك إزالة 8.dp من منطقة تصنيف النص القابل للاستخدام. ملاحظة: يتيح إصلاح الخطأ هذا مساحة إضافية لتسمية النص، وبالتالي يمكن أن يؤثر (بشكل إيجابي) على تنسيق النص. إذا كانت لديك اختبارات لقطات شاشة تشمل ToggleChips، قد تحتاج إلى تعديلها. (I514c8، b/240548670)

الإصدار 1.1.0-alpha02

27 تموز (يوليو) 2022

تم طرح الإصدارات androidx.wear.compose:compose-foundation:1.1.0-alpha02 وandroidx.wear.compose:compose-material:1.1.0-alpha02 وandroidx.wear.compose:compose-navigation:1.1.0-alpha02. يحتوي الإصدار 1.1.0-alpha02 على عمليات التنفيذ هذه.

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

  • تم التبديل من الإصدار 1.2.0 إلى الإصدار 1.3.0-alpha0X في مكتبات Compose الأساسية لنظام التشغيل Wear OS.

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

  • تمت إضافة أحمال زائدة لتعديل أشكال الشرائح (I02e87)

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

  • لقد حرّكنا مستوى رؤية إعلان الشاشة الكاملة عند إظهار/إخفاء مربّع الحوار، بما يتماشى مع الرسم المتحرك الحالي للتحجيم. (Ida33e)
  • لقد أصلحنا خطأ يمكن أن تحدث فيه القسمة على صفر مع بعض السلوك عند التمرير. (I86cb6)
  • تم إصلاح الخطأ في "ChipDefaults.childChipColor()" لضمان أن يكون لون الخلفية غير المفعَّل شفافًا بالكامل. (I2b3c3، b/238057342)

الإصدار 1.1.0-alpha01

29 حزيران (يونيو) 2022

تم طرح الإصدارات androidx.wear.compose:compose-foundation:1.1.0-alpha01 وandroidx.wear.compose:compose-material:1.1.0-alpha01 و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 ليبدأ من 50% من النسبة الأساسية بدلاً من 32.5%. تم تعديل CardDefaults.cardBackgroundPainter ليبدأ من 30% من المرحلة الأساسية وينتهي عند 20% من onSurfaceVariant (كان النسبة السابقة من 20% إلى 10% onSurfaceVariant). يتغير ToggleChip.toggleChipColors من تدرج خطي من سطح بنسبة 75% إلى 32.5% أولي إلى سطح 0% إلى 50% أولي. (I43bbd)
  • لقد أضفنا لون خلفية (MaterialTheme.color.surface) إلى جانب Chip/ToggleChips يحتوي على خلفيات متدرجة لضمان ظهورها بشكل صحيح في حال تم استخدام لون فاتحة خلفها. (Ibe1a4، b/235937657)
  • دائمًا ما تتم محاذاة عناصر المنتقي في المنتصف، ويؤدي إصلاح الخطأ عند ضبط gradientRatio على صفر إلى التأثير الجانبي لتغيير المحاذاة. (I712b8)

الإصدار 1.0

الإصدار 1.0.2

7 أيلول (سبتمبر) 2022

تم طرح الإصدارات 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-للموضع ومؤشرات الصفحة في Scaffold. وسيتم وضع المؤشرات الآن أعلى المقالة القصيرة وبالتالي لن يتم حجبها بواسطة المقالة القصيرة إذا كانت موجودة. (Ib988f، b/244207528)

الإصدار 1.0.1

24 آب (أغسطس) 2022

تم طرح الإصدارات 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 قد يؤدي إلى عدم اكتمال إعداد القوائم التي تحتوي على عدد صغير (عادةً 2) عناصر قائمة، ما يؤدي إلى عدم اكتمال عملية الإعداد. (076c61)

الإصدار 1.0.0

27 تموز (يوليو) 2022

تم طرح الإصدارات 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 على عمليات الالتزام هذه.

الميزات الرئيسية للإصدار 1.0.0

  • هذا هو أول إصدار ثابت من Compose لنظام التشغيل Wear OS (مزيد من المعلومات).
  • يعتمد Compose for Wear OS على مكتبات Compose الأساسية التي توفّر مكوّنات إضافية خاصة بالأجهزة القابلة للارتداء، وإلى عمليات تنفيذ بديلة لمكوّنات Compose الأساسية والمخصّصة للأجهزة القابلة للارتداء، إذا كان ذلك ملائمًا.
  • للحصول على قائمة بالمكوّنات الرئيسية في Wear Compose، اطّلِع على ملاحظات الإصدار الخاصة بـ (Compose for Wear OS تجريبيًا 01).

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

  • لقد حرّكنا مستوى رؤية إعلان الشاشة الكاملة عند إظهار/إخفاء مربّع الحوار، بما يتماشى مع الرسم المتحرك الحالي للتحجيم. (Ida33e)
  • لقد أصلحنا خطأ يمكن أن تحدث فيه القسمة على صفر مع بعض السلوك عند التمرير. (I86cb6)
  • تم إصلاح الخطأ في "ChipDefaults.childChipColor()" لضمان أن يكون لون الخلفية غير المفعَّل شفافًا بالكامل. (I2b3c3، b/238057342)

الإصدار 1.0.0-rc02

22 حزيران (يونيو) 2022

تم طرح الإصدارات androidx.wear.compose:compose-foundation:1.0.0-rc02 وandroidx.wear.compose:compose-material:1.0.0-rc02 وandroidx.wear.compose:compose-navigation:1.0.0-rc02. يحتوي الإصدار 1.0.0-rc02 على هذه عمليات التنفيذ.

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

  • لقد صححنا اتجاه تدرج البطاقات في الوضع من اليمين إلى اليسار (RTL). كانت أعلى اليسار > أسفل اليمين، والآن في أعلى اليمين > أسفل اليسار. (Ic2e77)
  • لقد عدّلنا التدرجات التلقائية للسمة Chip/ToggleChip/Card لكي تتماشى مع أحدث مواصفات تجربة المستخدم. تم تعديل ChipDefaults.gradientBackgroundChipColors ليبدأ من 50% من النسبة الأساسية بدلاً من 32.5%. تم تعديل قيمة "CardDefaults.cardBackgroundPainter" لتبدأ من 30% من القيمة الأساسية وتنتهي عند 20% من onSurfaceVariant (كانت في السابق 20% إلى 10% على SurfaceVariant). يتغيّر ToggleChip.toggleChipColors من تدرج خطي من سطح بنسبة 75% إلى 32.5% أولي إلى سطح 0% إلى 50% أولي. (I43bbd)
  • لقد أضفنا لون خلفية (MaterialTheme.color.surface) إلى جانب Chip/ToggleChips يحتوي على خلفيات متدرجة لضمان ظهورها بشكل صحيح في حال تم استخدام لون فاتحة خلفها. (Ibe1a4، b/235937657)
  • لقد عدّلنا قواعد الملف الشخصي الأساسية المضمَّنة في مكتبة Wear Compose (I9c694).

الإصدار 1.0.0-rc01

15 حزيران (يونيو) 2022

تم طرح الإصدارات androidx.wear.compose:compose-foundation:1.0.0-rc01 وandroidx.wear.compose:compose-material:1.0.0-rc01 وandroidx.wear.compose:compose-navigation:1.0.0-rc01. يحتوي الإصدار 1.0.0-rc01 على هذه عمليات التنفيذ.

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

  • يتم الآن إنشاء الواجهات في مكتبات الإنشاء باستخدام طرق الواجهة التلقائية jdk8 (I5bcf1).

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

  • لقد أزلنا الاستدعاء الفاضح الذي يشير إلى fillMaxWidth() في رأس القائمة لأنه ليس ضروريًا وقد يؤدي إلى حدوث مشاكل إذا كان ScalinglazyColumn يضم مزيجًا من ListHeader() وChip() حيث يزيد العرض أو يقلل بسبب الانتقال إلى ListHeader عنصر أو إزالته. (I37144، b/235074035)
  • أصلحنا خطأً في ScalingLazyColumn قد يؤدي إلى عدم رسم عناصر القائمة بشكل صحيح إلى أن يتم تمريرها إذا كان عنصر القائمة 0 كبيرًا بما يكفي (بما في ذلك المساحة المتروكة) (Ic6159، b/234328517)
  • لقد أجرينا تعديلاً بسيطًا على تغيير السرعة في ScalingLazyColumn لأنّ العناصر تصل إلى حافة الشاشة لتتطابق مع التعديلات على مواصفات تجربة المستخدم. القيم القديمة CubicBezierEasing(0.25f, 0.00f, 0.75f, 1.00f) -> القيم الجديدة CubicBezierEasing(0.3f, 0f, 0.7f, 1f). للاحتفاظ بالسلوك القديم، يمكنك إلغاء scalingParams من ScalingLazyColumn (Ie375c).
  • لقد أضفنا مساحة متروكة إلى CompactChip للتأكّد من أنّ حجم هدف النقر يبلغ 48.dp على الأقل من أجل استيفاء إرشادات تسهيل الاستخدام في المواد. قد يؤثّر ذلك في أي تنسيقات تستخدمها من خلال "CompactChips" لأنّها ستستهلك مساحة إضافية. (I3d57c)

الإصدار 1.0.0-beta03

1 حزيران (يونيو) 2022

تم طرح الإصدارات androidx.wear.compose:compose-foundation:1.0.0-beta03 وandroidx.wear.compose:compose-material:1.0.0-beta03 و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 أقل من إرشادات إمكانية الوصول الخاصة بالمواد. سيتم تصحيح ذلك في الإصدار التالي (15 حزيران (يونيو)). إذا كنت تستخدم "شريحة مدمجة"، سيؤثر ذلك في تصميماتك، حيث سيكون هناك الآن مساحة متروكة إضافية أعلى وأسفل للشرائح المضغوطة. يُرجى ضبط التنسيقات واختبارها أو الاطّلاع على تعليقات الخطأ للحصول على حل بديل لاستخدام السلوك الحالي. (b/234332135)

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

  • عرض توضيحي جديد لتحريك إضافة أو إزالة نص بدء على TimeText (I16d75)
  • إضافة اختبارات لـ HorizontalPageIndicator.PagesState (I64ed0)
  • تعديل "TimeText" أقرب إلى مواصفات تجربة المستخدم (Ib7ea1)

الإصدار 1.0.0-beta02

18 أيار (مايو) 2022

تم طرح الإصدارات androidx.wear.compose:compose-foundation:1.0.0-beta02 وandroidx.wear.compose:compose-material:1.0.0-beta02 و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" الآن ما يصل إلى 6 صفحات على الشاشة. وفي حال توفُّر أكثر من 6 صفحات في المجمل، سيظهر مؤشر نصف الحجم على اليمين أو اليسار، مع انتقال سلس بين الصفحات.(I2ac29)
  • تم تحسين سلوك المحاذاة التلقائي على ScalingLazyColumn وPicker (I49539)
  • تحسينات على التمرير السريع عند الحافة عند استخدام ميزة "Modifier.edgeSwipeToDismiss"، لا يتم تفعيل ميزة التمرير السريع لإغلاقها إلا عندما تصل اللمسة الأولى إلى الحافة ويتم تمريرها سريعًا إلى اليسار. كان من الممكن في السابق تفعيل ميزة "التمرير السريع للإغلاق" من خلال التمرير سريعًا من أي جزء من الشاشة في حال وصول التمرير إلى البداية.(I8ca2a)

الإصدار 1.0.0-beta01

11 أيار (مايو) 2022

تم طرح الإصدارات androidx.wear.compose:compose-foundation:1.0.0-beta01 وandroidx.wear.compose:compose-material:1.0.0-beta01 وandroidx.wear.compose:compose-navigation:1.0.0-beta01. يحتوي الإصدار 1.0.0-beta01 على عمليات التنفيذ هذه.

ميزات أداة Compose في الإصدار 1.0 من نظام التشغيل Wear OS

يشكّل 1.0.0-beta01 في Compose لنظام التشغيل Wear OS إنجازًا مهمًا، إذ إنّها ميزة مكتملة وقفل واجهة برمجة التطبيقات في المكتبة.

تشمل مكونات Wear Compose Material في الإصدار 1.0 ما يلي:

  • المظهر المتعدد الأبعاد: يتم استخدامه كبديل لميزة Compose لـ MaterialTheme على الأجهزة الجوّالة، ويقدّم الألوان والأشكال وأسلوب الخط لتصميم مكونات على الأجهزة القابلة للارتداء والتي تطبّق إرشادات تجربة المستخدم في التصميم متعدد الأبعاد على نظام Wear OS بشكل فوري.
  • Button وCompactButton وToggleButton: يوفّر الزر فتحة واحدة لالتقاط رمز أو صورة أو نص قصير (بحد أقصى 3 أحرف). دائري الشكل وبأحجام يُنصح بها للأزرار التلقائية أو الكبيرة أو الصغيرة. يوفّر CompactButton فتحة واحدة لأخذ أي محتوى (رمز أو صورة أو نص) وهو دائري الشكل مع حجم الخلفية صغير جدًا. يتضمّن CompactButton مساحة شفافة اختيارية حول الخلفية تزيد المساحة القابلة للنقر. ToggleButton هو زر يوفّر فتحة واحدة لأخذ أي محتوى (نص قصير أو رمز أو صورة) مع حالة تفعيل/إيقاف (تم وضع علامة عليها أو عدم وضع علامة عليها) مع تلوين ورموز مختلفة لإظهار ما إذا كان قد تم وضع علامة عليه أم لا.
  • البطاقات - تستخدم لعرض معلومات حول التطبيقات مثل الإخطارات. تصميم مرن لحالات الاستخدام المختلفة من خلال AppCard وTitleCard، ما يوفّر تنسيقات مختلفة ويتوافق مع الصور كمحتوى بطاقة أو خلفيات
  • الرقائق - مكونات على شكل ملعب تشبه الأزرار، ولكن مع مساحة أكبر وفتحات متعددة للسماح بالتسميات والتسميات الثانوية والرموز. بأحجام مختلفة مع إمكانية استخدام الصور كخلفيات
  • ToggleChips و يضم SegmentToggleChips، وهي شريحة بالحالة "محددة/غير محددة" مع إضافة فتحة ToggleControl لعرض رمز، مثل مفتاح التبديل أو زر الاختيار، لعرض الحالة المحددة للمكوِّن. علاوة على ذلك، يتضمّن SplitToggleChip منطقتَين يمكن النقر عليهما، إحداهما قابلة للنقر والأخرى قابلة للتبديل.
  • مؤشر تقدم CircularProgressIndicator: مؤشر تقدم مواد الارتداء مع شكلين مختلفين يعبر الأول عن نسبة إكمال مهمة مستمرة ويدعم وجود فجوة في المسار الدائري بين زاويتي البداية والنهاية. يشير العنصر الثاني إلى تقدم غير محدد لوقت انتظار غير محدد.
  • المنحنيات: تشكل جزءًا من DSL لوصف CurvedLayouts، بالإضافة إلى curvedRow وcurvedColumn، لوضع المكونات حول الأجهزة الدائرية. يمكنك الاطّلاع على قسم Wear Component Foundation أدناه لمعرفة مزيد من التفاصيل حول "CurvedLayout" و"CurvedModifier" (لهذه الطريقة دور مماثل لمفاتيح التعديل في العالم غير المنحني، كما تتيح إمكانية ضبط جوانب مختلفة من التصميم والمساحة المتروكة والتدرجات، وما إلى ذلك).
  • مربّع حوار وتنبيه وتأكيد: يعرض مربّع الحوار مربّع حوار بملء الشاشة، متراكبًا على أي محتوى آخر، ويتيح التمرير سريعًا للإغلاق. تأخذ هذه العملية خانة واحدة يمكن أن تكون ضمن محتوى مربّع الحوار الخاص بـ "مواد Wear OS"، مثل "تنبيه" أو "تأكيد". التنبيه عبارة عن محتوى مربّع حوار يستند إلى آراء المستخدمين، ويتضمّن خانات للرمز والعنوان والرسالة. وتتضمّن واجهة برمجة التطبيقات حِملًا زائدًا إما على زرَّين سالبَين وإيجابيَين معروضَين جنبًا إلى جنب أو خانة لشريحة واحدة أو أكثر مكدّسة عموديًا. التأكيد هو محتوى مربع حوار يستند إلى رأيي ويعرِض رسالة لمدة معيّنة. ويحتوي على فتح لرمز أو صورة (يمكن أن تكون متحركة).
  • الأفقي مصمَّمة للاستخدام في وضع ملء الشاشة وعرض مؤشر منحنٍ على الأجهزة المستديرة يمكن استخدامه مع عارض صفحة Accompanist.
  • رمز: وهو تطبيق على نظام Wear يأخذ رمز اللون وألفا من مظهر Wear Material Theme. للحصول على رمز يمكن النقر عليه، يمكنك الاطّلاع على "زر" أو "شريحة".
  • المنتقي - يعرض قائمة قابلة للتمرير بالعناصر التي يمكن الاختيار منها. سيتم تكرار العناصر افتراضيًا "إلى ما لا نهاية" في كلا الاتجاهين. يمكن عرضها في وضع القراءة فقط لإخفاء الخيارات غير المحدّدة.
  • مؤشر الموضع: يعرض موضع التمرير أو أي مؤشر موضعي آخر بطريقة تناسب شكل الجهاز القابل للارتداء. مصمَّمة للاستخدام في وضع ملء الشاشة مع عرض مؤشر منحنٍ على الأجهزة المستديرة
  • السقالة - تنفذ هيكل التخطيط المرئي الأساسي لـ Wear Material Design. يوفّر هذا المكوِّن واجهة برمجة تطبيقات لتجميع العديد من مكوّنات Wear Material (مثل TimeText وPositionIndicator وVignette) من أجل إنشاء الشاشة، ما يضمن وضع استراتيجية تصميم مناسبة لها وجمع البيانات اللازمة كي تعمل هذه المكوّنات معًا بشكل صحيح.
  • ScalingLazyColumn - عنصر قائمة تحجيم/عين سمكة يشكل جزءًا أساسيًا من لغة Wear Material Design. يوفر تأثيرات التوسيع والشفافية لعناصر المحتوى. تم تصميم "ScalingLazyColumn" ليتمكّن من معالجة أعداد كبيرة محتملة من عناصر المحتوى، والتي يتم إنشاؤها وإنشائها عند الحاجة فقط.
  • شريط التمرير - يسمح للمستخدمين بالاختيار من بين مجموعة من القيم. يتم عرض نطاق الاختيارات كشريط، ويمكن عرضه بشكل اختياري مع فواصل.
  • السائر هو مكوِّن بملء الشاشة يتيح للمستخدمين الاختيار من بين مجموعة من القيم، باستخدام زرَّي الزيادة/الخفض في أعلى وأسفل الشاشة، مع وضع فتحة في المنتصف للنص أو الشريحة.
  • مرِّر سريعًا لرفض المربّع - يعالج هذا الإجراء إيماءة التمرير السريع للإغلاق. تأخذ هذه الميزة مساحة واحدة للخلفية (لا يتم عرضها إلا أثناء إيماءة التمرير السريع) ومحتوى المقدّمة. يمكن دمج هذه الميزة اختياريًا مع مكتبة التنقّل في androidx باستخدام ميزة SwipeDismissableNavHost (يُرجى الاطّلاع على مكتبة التنقّل في نظام التشغيل Wear Compose أدناه).
  • النص - تنفيذ على Wear لمكون Compose Material Text، مع مراعاة اللون وألفا من مظهر Wear Material Theme
  • TimeText - مكون لعرض الوقت وحالة التطبيق أعلى الشاشة. لضبط شكل الشاشة باستخدام نص منحنٍ على الشاشات المستديرة.

  • نقوش الصورة النصفية - معالجة شاشة للاستخدام في السقالة التي تخفي الجزء العلوي والسفلي من الشاشة عندما يكون المحتوى القابل للتمرير قيد الاستخدام.

  • يتم تضمين المكونات التالية أيضًا من Wear Compose Foundation:

  • CurvedLayout - Wear Foundation CurvedLayout هو تصميم قابل للإنشاء يضع الأطفال في قوس وتدويرهم حسب الحاجة. يشبه هذا تخطيط الصف المنحني في مقطع من الحلقة. يُرجى العلم أنّ محتوى CurvedLayout ليس lambda قابلة للإنشاء، بل هي لغة DSL (لغة خاصة بالنطاق). تتوافق جميع العناصر في DSL من CurvedLayout مع معلَمة تعديل اختيارية تم إنشاؤها من CurvedModifier.

  • BasicCurvedText هو عنصر في CurvedLayout DSL، وbasicCurvedText يتيح للمطورين كتابة نص منحنٍ بسهولة باتباع انحناء الدائرة (عادةً ما تكون على حافة شاشة دائرية). لا يمكن إنشاء basicCurvedText إلا ضمن CurvedLayout لضمان أفضل تجربة، مثل تحديد موضع الشارة واستخدام CurvedModifiers. لاحظ أنه في معظم الحالات يجب استخدام CurdText بدلاً منه، لأنه يستخدم Material theming.

  • CurdComposable - تلفّ المحتوى العادي القابل للإنشاء كي يمكن استخدامه مع CurvedLayout. إذا كان curvedComposable يحتوي على عدة عناصر في الداخل، سيتم رسمها فوق بعضها البعض (مثل Box). لوضع عدة عناصر قابلة للإنشاء على طول منحنى، يجب لف كل عنصر باستخدام curvedComposable.

  • المنحنيات المنحنيات والأعمدة المنحنية، مثل الصف والعمود، يمكن دمج curvedRow وcurvedColumn داخل CurvedLayout لوضع العناصر حسب الحاجة. بالنسبة إلى curvedRow، قد يتم تحديد اتجاه التنسيق الزاوي والمحاذاة الشعاعية. بالنسبة إلى curvedColumn، قد يتم تحديد المحاذاة الزاويّة والاتجاه الشعاعي.

  • CurvedModifier - تقبل جميع المكونات المنحنية معلَمة تعديل يمكن إنشاؤها باستخدام CurvedModifier: الخلفية والحجم والوزن والمساحة المتروكة متوافقة.

  • يتم أيضًا تضمين المكوّن التالي من ميزة التنقّل في ميزة Compose في Wear:

  • <b>التمرير السريع NavHost - لتوفير مكان في التسلسل الهرمي للتأليف لإجراء التنقل الذاتي، مع التنقل إلى الخلف عبر إيماءة التمرير السريع. يتم عرض المحتوى ضمن SwipeToDismissBox، مع توضيح مستوى التنقّل الحالي. أثناء إيماءة التمرير السريع للإغلاق، يتم عرض مستوى التنقل السابق (إن وجد) في الخلفية.

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

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

  • تمت إضافة دوال CurvedModifier.padding*. وتُستخدم هذه لتحديد مساحة إضافية يمكن إضافتها حول مكون منحنٍ. (I4dbb4)
  • تمت إزالة الفئة الداخلية CompositionLocal (I42490).
  • لقد أضفنا قيمًا ثابتة لأحجام الرموز Button وCompactButton وToggleButton كإرشادات (I57cab)
  • أضِف مَعلمة مفعَّلة إلى AppCard وTitleCard. أصبح لديها الآن واجهة برمجة تطبيقات مشابهة لبطاقات androidx.compose.material. وعند ضبط المَعلمة على false، لن تكون البطاقة قابلة للنقر. (Idc48d، b/228869805)

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

  • يوقف برنامج الخطوة الآن زرَّي الخفض والزيادة عند الوصول إلى الحدَّين الأدنى/العلوي (وتطبق ContentAlpha.disable على iconColor) (I4be9f)
  • لقد أضفنا مساحة متروكة بمقدار 1dp حول محتوى المنتقي عند رسمه بتدرج لمنع عدم استقرار النص عند التمرير السريع. (I0b7b9)
  • إضافة اختبارات لقطات الشاشة للحساب PositionIndicator (I5e8bc)
  • أضِف المزيد من الاختبارات لـ AppCard وTitleCard (I85391، b/228869805)

الإصدار 1.0.0-alpha21

20 نيسان (أبريل) 2022

تم طرح الإصدارات 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، مشابه لتعديله في Compose. ويمكن استخدام هذا على عناصر CurvedRow و CurvedLayout (للعرض) والفرعية المنحنية (للارتفاع) (للارتفاع). (I8abbd)
  • تمت إضافة عناصر التعديل CurvedModifier.size و.angularSize و.radialSize لتحديد حجم عنصر منحنٍ. (I623c7)

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

  • أعِد ترتيب المَعلمات للتأكّد من أنّ الخلفية قبل اللون بشكل متّسق على مستوى واجهة برمجة تطبيقات Wear Compose (I43208)
  • تمت الإزالة في اتجاه عقارب الساعة & insideOut معلمات وتم استبدالها بثوابت أكثر تعبيرًا في الفئات الجديدة. يمكن الآن أن يكون اتجاه التصميم المنحني على دراية بـ LayoutDirection، ويتم اكتسابه عند عدم تحديده (If0e6a).
  • لقد استبدلنا autoCenter: Boolean بـ autoCenter: AutoCentringParams لحل مشكلة في واجهة برمجة التطبيقات مع ScalingLazyColumn. (Ia9c90)
  • أعدنا تسمية iconTintColor وtoggleControlTintColor إلى iconColor وtoggleControlColor في واجهة برمجة التطبيقات (Chip/ToggleChip/Dialog/Slider/Stepper/...) حيث يتم تطبيق اللون على خانة الرمز/toggleControl. (Ied238)
  • إعادة كتابة التعداد PageIndicatorStyle إلى فئة القيمة (I2dc72)
  • لقد أضفنا RowScope/ColumnScope/BoxScope إلى بعض خانات المحتوى القابل للإنشاء للإشارة إلى المطوّرين بشأن افتراضات التصميم. سيتيح ذلك للمطوّرين استخدام أدوات تعديل إضافية على بعض محتوى الخانات وتجنُّب توفير عناصر تصميم إضافية. بالإضافة إلى ذلك، أجرينا بعض التعديلات البسيطة على ألوان AppCard/TitleCard كي يتم ضبط timeColor وappColor تلقائيًا على contentColor، ولا يزال من الممكن إلغاء هذه السمات بشكل فردي إذا لزم الأمر. (I26b59)
  • تم جعل الكائن SwipeToDismissBoxState.Companion خاصًا (I39e84)
  • إصلاح ترتيب المعلمات لـ InlineSlider وStepper. تغيير بسيط لاتّباع إرشادات واجهة برمجة التطبيقات (I11fec)
  • أزلنا عنصر Saver لـ SwipeToDismissBoxState بسبب عدم استخدامه. (Ifb54e)
  • وقد عدّلنا السمة CompactChip لتصبح متوافقة مع أحدث مواصفات تجربة المستخدم. تم تقليل المساحة المتروكة إلى أفقي = 12.dp وعمودي = 0.dp. تم تغيير خط التصنيف من الزر إلى التسمية التوضيحية 1. أحجام الأيقونات الموصى بها هي 20 × 20 عند وجود كل من الرمز والتصنيف و24 × 24 لشريحة صغيرة فقط للأيقونة. بالنسبة إلى حالة استخدام الرمز فقط، تأكدنا أيضًا من محاذاة الرمز إلى الوسط. (Iea2be)
  • لقد أضفنا عددًا من الحقول الجديدة إلى ScalingLazyListLayoutInfo ليتمكّن المطوّرون من معرفة مقدار contentPadding وautoCenteringPadding التي تم تطبيقها. ويمكن أن تكون هذه الإعدادات مفيدة للمطوّرين عند احتساب الانتقال/التمرير (I7577b)
  • لقد نفذنا عمليات انتقال داخل/خارج لـ Dialog. تمّت إضافة مَعلمة showDialog وأصبح بإمكان مربّع الحوار الآن التحكّم في مستوى الرؤية الخاص به (يتيح ذلك لمربّع الحوار تشغيل الصور المتحركة للمقدمة والخاتمة عند إظهار/إخفاء مربّع الحوار). تجدر الإشارة إلى أنّ الصورة المتحركة الختامية لا تظهر عندما يغادر المستخدم مربّع الحوار عن طريق التمرير السريع لإغلاقه. وقد أضفنا أيضًا قيمة تلقائية للحالة في الحمل الزائد على SwipeToDismissBox الذي تمت إضافته مؤخرًا. (I682a0)
  • وبهدف التوافق مع i18n وa11y بشكل أفضل، غيّرنا ToggleChip وSplitToggleChip بحيث لم يعُد يتم ضبط الإعداد التلقائي لخانة toggleControl. وغيّرنا أيضًا ToggleChipDefaults بحيث تعرض الطرق التالية الآن ImageVector بدلاً من Icon (يُرجى العلم أنه بما أنّ هذه الطرق لم تعُد تعرض @Composables، وتم تغييرها للبدء بالأحرف الصغيرة)، SwitchIcon()->switchIcon() وCheckboxIcon->checkboxIcon() وRadioIcon()->radioIcon()، وهذا يسمح ويشجّع المطوّرين على إنشاء عناصر Icon() قابلة للإنشاء باستخدام مجموعة contentDescription مناسبة. (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

6 نيسان (أبريل) 2022

تم طرح الإصدارات 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 وStepper. سيساعد ذلك المطوّرين في الانتباه أكثر إلى متطلبات الأقلمة وتسهيل الاستخدام. تم عرض استخدامات الرموز الافتراضية في نماذج تجريبية ونماذج. (I7e6fd)
  • استبدال أسماء المَعلمات اللاحقة واللاحقة بـ "البداية" و"النهاية" في TimeText (Iaac32)
  • لقد أضفنا حمل SwipeToDismissBox زائدًا مع مَعلمة onDismissed لإتاحة الاستخدام الشائع لبدء حدث التنقّل عند اكتمال إيماءة التمرير السريع. (I50353، b/226565726)
  • تمت إزالة تعليقات ExperimentalWearMaterialApi التوضيحية من استخدام TimeText (Ide520)
  • لقد وضعنا علامة على نطاق ScalingLazyList/Column وواجهات المعلومات تشير إلى أنّه غير مُصمَّم من قِبل المطوّرين الخارجيين، ما يتيح لنا إضافة أعضاء جُدد في المستقبل بدون إجراء تغييرات قد تؤدي إلى أعطال ثنائية. (I7d99f)
  • لقد أضفنا سمة flingBehaviour جديدة إلى أداة الاختيار وطريقة PickerDefaults.flingBehaviour() لتفعيل ضبط سلوك الانتقال، مثل إضافة دعم RSB. تنفِّذ PickerState الآن واجهة ScrollableState. (Ib89c7)

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

  • تعديل قواعد الملف الشخصي الأساسي لمكتبات Wear Compose في "وقت تشغيل Android" (ART) ويمكن لتقنية ART الاستفادة من قواعد الملف الشخصي على الأجهزة لتجميع مجموعة فرعية محدّدة من التطبيق مسبقًا لتحسين أداء التطبيق. يُرجى العلم أنّ ذلك لن يؤثر في التطبيقات التي يمكن تصحيح الأخطاء بها. (Iaa8ef)
  • تحسين المستندات (I2c051)

الإصدار 1.0.0-alpha19

23 آذار (مارس) 2022

تم طرح الإصدارات 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 لـ @Composable وbasicCurvedText (نص منحني للمؤسسة) وcurvedText (ارتداء نص مقوّس للمواد). (Ib776a)
  • اجعل جانب PositionIndicator قابلاً للضبط. يمكن الآن ضبط موضع PositionIndicator الأساسي على End (التنسيق مع ضبط الاتجاه) أو OppositeRsb (مع أخذ دوران الشاشة في الاعتبار أو لوضع نفسه مقابل RSB الفعلي) أو القيمة المطلقة Left & أجل. (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)
  • عدّلنا أسلوب الخط/الخطوط التلقائية في Compose لمظاهر نظام التشغيل Wear OS لتتوافق مع أحدث إرشادات تجربة المستخدم. ومن الملاحظ أنّ قيمة العرض1 (40.sp) وdisplay2 (34.sp) أصغر الآن من القيم السابقة، كما تم إجراء تعديلات طفيفة أخرى على ارتفاع الأسطر وتباعد الأسطر. (Ie3077)
  • لقد أضفنا مقاومة لـ "SwipeToDismissBox" لكي تتم الحركة فقط عند التمرير السريع للإغلاق وليس في الاتجاه المعاكس على الإطلاق. (Ifdfb9)
  • لقد غيّرنا بعض قيم المَعلمات التلقائية لدوال CircularProgressIndicator لجعلها متوافقة مع إرشادات تجربة المستخدم ذات التصميم المتعدد الأبعاد على نظام Wear OS. بالنسبة إلى إصدار Spinner/غير محدد، تم تحديث الحجم (40->24.dp) وIndexColor (primary->onBackground) وtrackColor transparency (30%->10%) وعرض التنسيق (4->3dp). بالنسبة إلى إصدار "التقدم/تحديد"، تم تحديث شفافية trackColor (30%->10%). (I659cc)
  • عدّلنا مَعلمات القياس التلقائية للسمة ScalingLazyColumn بما يتماشى مع أحدث مواصفات تجربة المستخدم في Wear Material Design. يؤدي هذا مرئيًا إلى بدء عناصر القائمة في الحجم لتصبح أقرب إلى مركز القائمة، ولكن تصبح أقل في حافة القائمة من ذي قبل. (Ica8f3)
  • إجراء بعض التعديلات على ScalingLazyColumnDefaults.snapFlingBehavior لتحسين نهاية الصورة المتحركة (If3260)

الإصدار 1.0.0-alpha18

9 آذار (مارس) 2022

تم طرح الإصدارات 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 تمت إعادة تسمية PositionIndicator visibility. إجراء بعض التحسينات على الأداء لتجنُّب عمليات إعادة الحوسبة عند عدم الحاجة إليها (Iaed9d)
  • تم تعديل الألوان المقترَحة لـ SplitToggleChip. تشتمل الآن للمقاطع في SegmentToggleChip على خلفية ملونة خالصة عند تحديدها أو إلغاء تحديدها حيث يكون لون عنصر ToggleControl هو المؤشر الأساسي لتحديد ما إذا كان المكون محددًا أم لا. لقد أضفنا ToggleDefaults.splitToggleChipColors() جديدة لإتاحة نظام الألوان الجديد. لقد بسّطنا أيضًا طريقتَي toggleChipColors() لإزالة splitBackgroundOverlayColor (I7e66e).
  • لقد أضفنا سمة غير المعدَّلة إلى ScalingLazyListItemInfo لأنّه ليس من الآمن حساب الحجم الأصلي للسلعة باستخدام الحجم المعدَّل وعامل القياس بسبب دقة العمليات الحسابية العائمة. (I54657، b/221079441)
  • إضافة HorizontalPageIndicator ويمثل إجمالي عدد الصفحات وصفحة محددة. وقد يكون تنسيقها خطيًا أو منحنيًا حسب شكل الجهاز. كما تدعم شكل المؤشر المخصص، الذي يحدد كيفية تمثيل كل مؤشر بشكل مرئي. (Iac898)
  • لقد عدّلنا PickerState بحيث يمكن تعديل numberOfOptions. يتوافق ذلك مع حالات الاستخدام مثل DatePicker، عندما يتغيّر عدد الأيام في الشهر حسب الشهر المحدّد. تم تغيير معلمة الدالة الإنشائية لـ PickerState إلى originalNumberOfOptions وفقًا لذلك. (Iad066)
  • إخفاء "PositionIndicator" إذا كان شريط تمرير ولا يمكن تنفيذه التمرير. (Id0a7f)
  • لتحقيق الاتساق مع Scaffold، يعرض مكوّن مربّع الحوار بملء الشاشة الآن PositionIndicator وVignette. ونستخدم الآن ScalingLazyColumn بدلاً من Column، ما يعني أنّ محتوى مربّع الحوار أصبح الآن باللغة ScalingLazyListScope (ويجب عادةً أن يكون محاطًا بالعنصر { /* content */ }). يوفّر مربّع الحوار مَعلمة الوضع العمودي وفقًا لذلك. (Idea13)
  • لقد غيّرنا اسم خاصية التبديل ToggleChip وSplitToggleChip SwitchIcon بهدف تبادل التحكّم مع نظام Material Design بشكل أفضل لمساعدة المصمّمين والمطوّرين في التنقّل في واجهة برمجة التطبيقات. (If5921، b/220129803)
  • لقد أضفنا شرحًا جديدًا للإدخال 3 إلى نمط الخط وفقًا لموضوع تصميم مواد Wear OS. (I74b13، b/220128356)

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

  • إيقاف الرسوم المتحركة الالتقاط عندما نكون هناك. (Idb69d)
  • تحريك التغييرات في PositionIndicator (I94cb9)
  • استنادًا إلى الملاحظات المتعلّقة بتجربة المستخدم أو واجهة المستخدم، غيّرنا ميزة "التوسيط التلقائي" في ScalingLazyColumn لتوفير مساحة كافية فقط للتأكّد من أنّ العناصر التي تتضمّن فهرس ScalingLazyListState.initialCenterItemIndex أو أعلى سيتمكّنون من الانتقال بالكامل إلى وسط إطار العرض. يسمح هذا للمطورين بوضع عنصر واحد أو عنصرين حول العنصر في المنتصف مبدئيًا ولا يمكن تمريرهما إلى المنتصف. يعني ذلك أنّ ميزة "ScalingLazyColumn" التي يتم عرضها في المركز التلقائي لن تتمكّن من الانتقال فوق initialCenterItemIndex/initialCenterItemScrollOffset (I22ee2).
  • لقد أضفنا عرضًا توضيحيًا لأداة اختيار التاريخ وأصلحنا خطأً في PickerState حيث لم يكن الخيار المحدَّد في البداية مطبَّقًا على "منتقي التاريخ" إلى أن يتم عرض "منتقي التاريخ". (Id0d7e)
  • لتقليل اقتصاص العناصر الأعرض في ScalingLazyColumn على الشاشات الدائرية، زِدنا المساحة المتروكة التلقائية للمحتوى الأفقي من 8 إلى 10 وحدات بكسل مستقلة الكثافة. (I0d609)
  • التأكّد من ظهور "PositionIndicator" عند الانتقال للأسفل (Ied9a2)

الإصدار 1.0.0-alpha17

23 شباط (فبراير) 2022

تم طرح الإصدارات 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 على هذه عمليات التنفيذ.

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

  • لقد أضفنا ميزة دعم المحاذاة التي يمكن استخدامها مع ScalingLazyColumn. يمكنك ضبط flingBehavior = ScalingLazyColumnDefaults.flingWithSnapBehavior(state) لتفعيل إتاحة المحاذاة. (I068d3، b/217377069)
  • لقد أضفنا إصدارات تجريبية للمنتقي اعتاد حدد وقتًا بتنسيق 24 ساعة أو 12 ساعة. (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

9 شباط (فبراير) 2022

تم طرح الإصدارات 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)
  • واجهة برمجة تطبيقات integer إضافية لكل من InlineSlider وStepper (I1b5d6)

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

  • لقد غيَّرنا قيمة miniCenterItemIndex التلقائية لعنوان ScalingLazyListState من 0 إلى 1. ويعني هذا أنّه ما لم يتم تجاوزه عند إنشاء حالة باستخدام ScalingLazyListState.rememberScalingLazyListState(initialCenterItemIndex =)، سيتم وضع عنصر القائمة الثاني (الفهرس == 1) في منتصف إطار العرض عند الإعداد، وسيتم وضع العنصر الأول (الفهرس == 0) قبله. ويسمح هذا بتأثير مرئي أفضل افتراضي خارج المربّع حيث سيتم ملء معظم إطار العرض بعناصر القائمة. (I0c623، b/217344252)
  • لقد خفّضنا قيمة ScalingLazyColumn التلقائية extraPadding التي يتم توفيرها لضمان توفّر الكثير من عناصر القائمة لرسمها (حتى في حال تقليل حجم بعض هذه العناصر) من 10% إلى 5%. سيؤدي ذلك إلى تجنُّب إنشاء عناصر قائمة إضافية قد لا تظهر في إطار العرض. في حال استخدام معلمات تحجيم غير عادية (على سبيل المثال، تحجيم أكثر شمولاً)، يمكن لمطوّر البرامج تعديل المساحة المتروكة الإضافية باستخدام viewportVerticalOffsetResolver. (I76be4)
  • حل مشكلة متعلقة بسياسة TimeText على عدة أسطر على جهاز مربّع (Ibd3fb)
  • لقد عدّلنا ScalingLazyColumn بحيث لا يملأ كل المساحة في المكان الرئيسي بطبيعته. بدلاً من ذلك، ستأخذ حجمها بناءً على حجم محتواها. ويجعل ذلك متسقًا مع سلوك LazyColumn. إذا أردت استعادة السلوك القديم، يُرجى تمرير Modifier.fillMaxSize() إلى ScalingLazyColumn. ملاحظة: هذا التغيير غير مكتمل وستتم معالجته في إطار تغيير متابعة في إصدار الإصدار الأولي التالي. (I3cbfa)

الإصدار 1.0.0-alpha15

26 يناير 2022

تم طرح الإصدارات 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. عند ضبط السياسة على "true" (الخيار التلقائي)، سيضمن ذلك تمرير جميع العناصر، بما في ذلك العنصر الأول والأخير، بحيث تظهر في منتصف إطار عرض القوائم. ملاحظة: إذا كنت تستخدم التوسيط التلقائي، ستحتاج على الأرجح إلى ضبط المساحة المتروكة للمحتوى الرأسي على 0.dp. إذا تم توفير كل من المساحة المتروكة للمحتوى العمودي والوضع التلقائي للتوسيط، سيؤدي ذلك إلى توفير مساحة إضافية قبل عناصر القائمة الأولى وبعدها، ما يتيح تمريرها أكثر من ذلك. (I2a282، b/214922490)
  • لقد أضفنا مكوِّن Dialog يتيح لأي عنصر قابل للإنشاء عرض مربّع حوار بملء الشاشة يظهر فوق المحتوى الآخر. عند ظهور مربّع الحوار، يتيح التمرير سريعًا للإغلاق وسيعرض المحتوى الرئيسي له في الخلفية أثناء إيماءة التمرير السريع. من المتوقّع أن يكون محتوى مربّع الحوار Alert أو Confirmation (تمّت إعادة تسميته من المكوّنَين السابقَين AlertDialog وConfirmationDialog) - وتتوفّر كل من Alert وConfirmation وDialog في حزمة androidx.wear.compose.material.dialog. يمكن استخدام التنبيه والتأكيد كوجهتَي تنقُّل. تمت أيضًا إضافة ColumnScope إلى مَعلمتَي "تنبيه" و"تأكيد" حسب الضرورة. (Ia9014)
  • أزلنا onSurfaceVariant2 من ميزة Compose لألوان المظاهر المتعددة في WearOS واستبدلنا الاستخدامات في المكتبة بـ onSurfaceVariant. (Icd592)
  • تمت إضافة طريقة لتحديد خيار آليًا في PickerState، ويمكن الآن تحديد الخيار المحدد مبدئيًا عند إنشاء PickerState. (I92bdf)
  • لقد أضفنا دعمًا لتخصيص سلوك الانتقال في ScalingLazyColumn. (I1ad2e، b/208842968)
  • لقد أضفنا NavController.currentBackStackEntryAsState() إلى مكتبة Wear.Compose.Navigation. (If9028، وb/212739653)
  • تمت إضافة Modifier.onRotaryScrollEvent() وModifier.onPreRotaryScrollEvent() لأجهزة Wear OS التي تتضمّن زرًا جانبيًا دوّارًا (I18bf5 وb/210748686).

الإصدار 1.0.0-alpha14

12 كانون الثاني (يناير) 2022

تم طرح الإصدارات 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

15 كانون الأول (ديسمبر) 2021

تم طرح الإصدارات 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)

  • تمت إضافة فئة تعداد قابلة للرسم للحصول على موارد قابلة للرسم ضمن مكتبة Wear Compose، وبذلك لم تعُد هناك حاجة إلى تأثير الانعكاس. سيؤدي هذا الإجراء إلى إصلاح الخطأ الذي تمت فيه إزالة ملفات المكتبة القابلة للرسم عند minifyEnabled=true أو shrinkResources=true). (Ib2a98)

  • تمت إضافة اختبارات لـ Stepper في Wear Compose (I2d03a)

  • تمت إضافة نماذج لـ "SwipeDismissableNavHost" في ميزة "التنقل في Compose" على Wear. (I85f06)

الإصدار 1.0.0-alpha12

1 كانون الأول (ديسمبر) 2021

تم طرح الإصدارات androidx.wear.compose:compose-foundation:1.0.0-alpha12 وandroidx.wear.compose:compose-material:1.0.0-alpha12 وandroidx.wear.compose:compose-navigation:1.0.0-alpha12. يحتوي الإصدار 1.0.0-alpha12 على هذه عمليات التنفيذ.

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

  • لقد أضفنا مكوِّنًا تدريجيًّا يتيح للمستخدمين الاختيار من بين مجموعة من القيم. إنّ برنامج الخطوة هو عنصر تحكم بملء الشاشة يضم زرَّي الزيادة وخفضه في الأعلى والأسفل، وخانة في المنتصف (من المتوقع أن تظهر شريحة أو نص). يمكن تخصيص رموز الأزرار إذا لزم الأمر. (I625fe)

  • لقد أضفنا عنصرَين جديدَين قابلَين للإنشاء لعرض مربّعات الحوار: وينتظر خيار الحوار للمستخدم ردًّا من المستخدم ويعرض عنوانًا ورمزًا ورسالة وإمّا أ) زران للخيارات الإيجابية/السلبية البسيطة أو ب) شرائح مكدسة عموديًا أو تبديل الشرائح للحصول على خيارات أكثر مرونة. يعرض مربّع حوار التأكيد إقرارًا مع انتهاء المهلة. يحتوي مربع الحوار البسيط هذا على خانات لعنوان ورمز (متحرك). (Ic2cf8)

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

  • أضِف وحدات (بأجزاء من الثانية) إلى قيم مدة مربّع الحوار المقترَحة. (I09b48)

الإصدار 1.0.0-alpha11

17 تشرين الثاني (نوفمبر) 2021

تم طرح الإصدارات 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/fillParentMaxLabel/fillParentMaxHeight للسماح بتحديد حجم عناصر القائمة استنادًا إلى حجم الحاوية الرئيسية. يمكن ضبط السلع لملء كل حجم العنصر الرئيسي أو جزء منه. يؤدي ذلك إلى عرض الوظائف المتوفّرة في LazyRow/Column (I4612f).
  • تمت إضافة الدعم إلى ScalingLazyColumn للسماح للعناصر بامتلاك مفتاح. كما تمت إضافة طرق ملائمة للسماح بإضافة العناصر من المصفوفات والقوائم. (Ic1f89)

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

  • أمثلة إضافية على TimeText (I8cb64)

الإصدار 1.0.0-alpha10

3 تشرين الثاني (نوفمبر) 2021

تم طرح الإصدارات androidx.wear.compose:compose-foundation:1.0.0-alpha10 وandroidx.wear.compose:compose-material:1.0.0-alpha10 وandroidx.wear.compose:compose-navigation:1.0.0-alpha10. يحتوي الإصدار 1.0.0-alpha10 على هذه عمليات التنفيذ.

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

  • تمت إضافة شريط تمرير مضمَّن لنظام Wear OS. يتيح InlineSlider للمستخدمين الاختيار من بين مجموعة من القيم. يتم عرض نطاق الاختيارات كشريط بين الحد الأدنى والحد الأقصى للقيم للنطاق، ويمكن للمستخدمين اختيار قيمة واحدة من خلالها. (If0148)

  • يمكنك الاطّلاع على ميزة Compose الجديدة التي تخصّ الدرس التطبيقي حول ترميز WearOS.

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

  • أصبح مقياس الأداء الماكرو الآن minSdkVersion من 23. (If2655)

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

  • تعديل معالجة النقل في SideEffectableNavHost في SideEffect (I04994، b/202863359)
  • تعديل معالجة النقل في مرِّر سريعًا NavHost (I1cbe0، وb/202863359)

الإصدار 1.0.0-alpha09

27 تشرين الأول (أكتوبر) 2021

تم طرح الإصدارات androidx.wear.compose:compose-foundation:1.0.0-alpha09 وandroidx.wear.compose:compose-material:1.0.0-alpha09 وandroidx.wear.compose:compose-navigation:1.0.0-alpha09. يحتوي الإصدار 1.0.0-alpha09 على هذه عمليات التنفيذ.

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

  • لقد أطلقنا إصدار "معاينة المطوِّر" من ميزة "إنشاء" على نظام التشغيل Wear OS. يمكنك الاطّلاع على مشاركة المدونة التي تستعرض العناصر الرئيسية القابلة للإنشاء وروابط إلى مصادر إضافية لبدء استخدامها.

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

  • لقد أضفنا دعمًا للمطوّرين ليتمكنوا من تخصيص جميع الألوان في مظهر Wear Material Design Color. (I4759b، b/199754668)

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

  • تمت إضافة عينات scrollToSellBox التي لا تزال مستمرة (Ibaffe)
  • تمت إضافة روابط إلى أدلة developer.android.com من K Docs لكل من CurvedText وTimeText .SquareToSellBox. (I399d4)
  • يتجاهل تمرير التمرير السريع الآن NavHost إذا لم تكن هناك وجهة حالية (يشير إلى أن لم يتم إنشاء NavGraph باستخدام wear.compose.navigation.composable. دالة الأدوات المساعدة) (I91403)
  • تمت إضافة مستندات وأمثلة إضافية حول استخدام مصدر الوقت في TimeText (I4f6f0).

الإصدار 1.0.0-alpha08

13 تشرين الأول (أكتوبر) 2021

تم طرح الإصدارات androidx.wear.compose:compose-foundation:1.0.0-alpha08 وandroidx.wear.compose:compose-material:1.0.0-alpha08 وandroidx.wear.compose:compose-navigation:1.0.0-alpha08. يحتوي الإصدار 1.0.0-alpha08 على هذه عمليات التنفيذ.

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

  • لقد أعدنا تسمية سمتَي AppCard وTitleCard body إلى content ونقلناهما إلى نهاية قائمة المواقع للسماح بتقديمهما كدالة lambda لاحقة. تمت أيضًا إعادة تسمية bodyColor إلى contentColor لتحقيق الاتساق مع أسماء الخانات الجديدة. (I57e78)

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

  • تمت إضافة روابط إلى developer.android.com. كمستندات من K Docs عن الأزرار والبطاقة والشريحة والمظهر مؤشر الموضع وقياس مكونات الأعمدة الكسولة (I22428)
  • إصلاح تطبيق WearOS ScrollToRejectBox الذي لا يعالج أحيانًا التمريرات السريعة (I9387e)
  • نماذج مضافة لـ Button و CompactButton Chip و CompactChip وAppCard و TitleCard ToggleButton وToggleChip وسبليت ToggleChip (Iddc15)
  • تمت إضافة اختبارات أداء المقاييس الصغيرة من أجل Card وChip وToggleChip وTimeText وScalingLazyColumn. (If2fe9)

الإصدار 1.0.0-alpha07

29 أيلول (سبتمبر) 2021

تم طرح الإصدارات androidx.wear.compose:compose-foundation:1.0.0-alpha07 وandroidx.wear.compose:compose-material:1.0.0-alpha07 وandroidx.wear.compose:compose-navigation:1.0.0-alpha07. يحتوي الإصدار 1.0.0-alpha07 على هذه عمليات التنفيذ.

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

  • تمت إضافة مكوِّن CurvedText في المادة، وهو مكون يسمح للمطوّرين بكتابة نص منحن بسهولة بعد انحناء دائرة (عادةً على حافة شاشة دائرية). (I19593)

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

  • تمت إضافة اختبارات لـ TimeText (Idfead)
  • تحويل ArcPaddingValues إلى واجهة. (Iecd4c)
  • تمت إضافة رسوم متحركة إلى scrollToSellBox (I9ad1b)
  • تمت إضافة معلمة hasBackground إلى scrollToSellBox واجهة برمجة التطبيقات بحيث يمكن إيقاف إيماءة التمرير السريع في حالة ليس هناك محتوى في الخلفية لعرضه. (I313d8)
  • على rememberNavController() إجراء خطوة اختيارية الآن مجموعة من Navigator مثيل ستتم إضافتها إلى تم إرجاع NavController للحصول على دعم أفضل بشكل اختياري المتنقلون مثل أولئك الذين يجرون مواد التنقّل المصاحبة: (I4619e)
  • المرجع NamedNavArgument من التنقل-شائعة وإزالة النسخة من wear.compose.navigation. (I43af6)

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

  • تم إصلاح درجة التقوّس في CurvedRow على الأجهزة الأصغر. (If7941)
  • تم إصلاح الوميض المحتمل على CurvedRow عند تحديث المحتوى، وضمان إعادة قياس الصف المنحني (Ie4e06)
  • تم تعديل ChipDefaults.radiusBackgroundChipColors() بما يتماشى مع التغييرات في مواصفات تجربة المستخدم. يبدأ التدرج الآن بـ MaterialTheme.colors.primary بـ alpha 32.5% وينتهي بـ MaterialTheme.colors.surface بـ alpha @ 0% على خلفية MaterialTheme.colors.surface @ 75% alpha. (Id1548)
  • لقد عدَّلنا ألوان ToggleChips عندما تكون في الحالة المحدّدة لتتطابق مع أحدث إرشادات مواصفات تجربة المستخدم في "التصميم المتعدد الأبعاد" لنظام Wear. عند تحديد ToggleChips، ستحصل الآن على خلفية متدرجة من MaterialTheme.color.surface @ 0% ألفا، أعلى اليسار، إلى MaterialTheme.color.primary @ 32% alpha، أسفل اليمين، على خلفية MaterialTheme.color.surface @ 75% ألفا. ينتج عن ذلك فرق أكثر دقة بين المحدد وغير المحدد في ToggleChip. (Idd40b)

الإصدار 1.0.0-alpha06

15 أيلول (سبتمبر) 2021

تم طرح الإصدارات androidx.wear.compose:compose-foundation:1.0.0-alpha06 وandroidx.wear.compose:compose-material:1.0.0-alpha06 وandroidx.wear.compose:compose-navigation:1.0.0-alpha06. يحتوي الإصدار 1.0.0-alpha06 على هذه عمليات التنفيذ.

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

  • لقد أضفنا إلى Scaffold تطبيق من المستوى الأعلى قابل للإنشاء يوفّر بنية للتعامل مع موضع مؤشرات الموضع (مثل التمرير أو مستوى الصوت)، وهي منطقة في أعلى الشاشة لعرض الوقت وحالة التطبيق، وتدعم أيضًا نقوش الصورة النصفية لتمويه الحافة العلوية والسفلية للمحتوى القابل للتمرير. المنطقة الرئيسية في Scaffold هي المكان الذي يتم فيه وضع محتويات التطبيق. (I5e0bf)
  • تمت إضافة تنفيذ TimeText لتطبيق Wear Compose (I5654c).

مكتبة التنقُّل في Wear Compose

  • لقد أضفنا الإصدار الأول من مكتبة "التنقل" في Wear Compose التي توفّر التكامل بين مكتبتَي Wear Compose و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")
        }
    }
}

  • يتم تجميع ميزة "التنقل في Compose" على نظام Wear كمكتبة منفصلة، لذا لا حاجة إلى الاعتماد على مكتبة التنقّل Androidx في تطبيقات WearCompose البسيطة التي تنفّذ تنقّلاً يدويًا.

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

  • تم تعديل SwipeDismissableNavHost إلى الدعم. rememberSaveable من خلال ضبط الهوية الأساسية للمحتوى والخلفية (I746fd)
  • لقد أضفنا محوّل PositionIndicator يمكنه التعامل مع LazyListState (I21b88).
  • تم تعديل FastToتجاهلBox لدعم التذكرSaveable (Ie728b)
  • لقد أضفنا دعم backLayout إلى عمود ScalingLazyColumn. يتيح ذلك عكس اتجاه التمرير والتنسيق (I9e2fc)
  • تم إيقاف performGesture وGestureScope، اللذَين تم ضبطهما على تم استبدالهما بـ performTouchInput وTouchInjectionScope. (Ia5f3f، b/190493367)
  • لقد أعدنا تسمية VignetteValue إلى VignettePosition وإعادة تسمية VignetteValue.Both والتي تمت إعادة تسميتها إلى VignettePosition.TopAndBottom. (I57ad7)
  • لقد أعدنا تسمية ScalingLazyColumnState إلى ScalingLazyListState, ScalingLazyColumnItemInfo to ScalingLazyListItemInfo, ScalingLazyColumnLayoutInfo to ScalingLazyListLayoutInfo and ScalingLazyColumnScope to ScalingLazyListScope في حال قررنا إضافة تنفيذ ScalingLazyRow في المستقبل. (I22734)

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

  • تم تعديل مستندات CompactChip لوصف ما يحدث إذا لم يتم توفير رمز أو تصنيف. (I4ba88)
  • لقد أجرينا بعض التعديلات على مكوّنات بطاقة Wear OS. (I6b3d0)
    1. تم تقليل تباعد ميزة TitleCard بين العنوان والنص من 8.dp إلى 2.dp.
    2. تم تغيير خط عنوان TitleCard من النص إلى العنوان 3.
    3. تم تغيير تدرج خلفية البطاقة لجعل الخلفية أغمق.

الإصدار 1.0.0-alpha05

1 أيلول (سبتمبر) 2021

تم طرح androidx.wear.compose:compose-foundation:1.0.0-alpha05 وandroidx.wear.compose:compose-material:1.0.0-alpha05. يحتوي الإصدار 1.0.0-alpha05 على هذه عمليات التنفيذ.

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

  • وضع علامة @Stable على ArcPaddingValues (I57deb)
  • تنفِّذ ScalingLazyColumnState الآن واجهة ScrollableState، مما يمنح المطورين إمكانية الوصول الآلي للتمرير في المكوِّن. (I47dbc)

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

  • لقد قللنا التباعد بين الرمز والنص في الشريحة وToggleChip لجعلهما يتماشى مع التحديثات على مواصفات تجربة المستخدم. (I83802)

الإصدار 1.0.0-alpha04

18 آب (أغسطس) 2021

تم طرح androidx.wear.compose:compose-foundation:1.0.0-alpha04 وandroidx.wear.compose:compose-material:1.0.0-alpha04. يحتوي الإصدار 1.0.0-alpha04 على عمليات التنفيذ هذه.

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

  • تمت إضافة مفتاح ScrollToتجاهلBox وأداة تعديل قابلة للتمرير السريع يمكن استخدامها من أجل دعم إيماءة التمرير السريع من اليسار إلى اليمين للإغلاق. على الرغم من أنها مستقلة عن مكونات التنقل، ومن المتوقع أن يتم استخدامه للخروج من شاشة والانتقال إلى شاشة أخرى. تمت الإضافة اختبار التكامل لعرض العرض التمرير السريع للرفض. (I7bbaa)
  • لقد أضفنا الواجهتين ScalingLazyColumnItemInfo وScalingLazyColumnLayoutInfo إلى فئة ScalingLazyColumn State لتمكين المطورين من معرفة المواضع والأحجام الفعلية للعناصر في ScalingLazyColumn بعد تطبيق الضبط. لقد أصلحنا أيضًا خطأً في الطريقة التي تم بها حساب التوسيع عند "الأعلى" يتم تطبيق المساحة المتروكة للمحتوى على عمود ScalingLazyColumn. (I27c07)

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

  • إضافة فئة CurvedTextStyle لتحديد نمط النص المنحني الخيارات. يشبه استخدام TextStyle، ولكنه الآن متوافق فقط مع اللون وحجم الخط والخلفية. ستتم إضافة المزيد من خيارات التصميم في المستقبل. (I96ac3)
  • لقد أضفنا الواجهتين ScalingLazyColumnItemInfo وScalingLazyColumnLayoutInfo إلى فئة ScalingLazyColumn State لتمكين المطورين من معرفة المواضع والأحجام الفعلية للعناصر في ScalingLazyColumn بعد تطبيق الضبط. لقد أصلحنا أيضًا خطأً في الطريقة التي تم بها حساب التوسيع عند "الأعلى" يتم تطبيق المساحة المتروكة للمحتوى على عمود ScalingLazyColumn. (I27c07)
  • تمت إضافة @ExperimentalWearMaterialApi إلى تعداد SwipeDismissTarget، وهو جزء من واجهة برمجة التطبيقات SwipeToDismissBox. (I48b5e)

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

  • تمت إضافة مواد اختبار لـ scrollToتجاهلBox (I9febc)

الإصدار 1.0.0-alpha03

4 آب (أغسطس) 2021

تم طرح 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 التي يوفر عرضًا عين السمكة مع تقليل حجم محتويات القائمة وتصبح شفافة عند توسيعها نحو حافة المكون. (I7070c)

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

  • لقد غيّرنا اللون التلقائي لمحتوى appName في AppCard استجابةً لتعديل مواصفات تجربة المستخدم. اللون التلقائي لـ appName الآن هو MaterialTheme.colors.onSurfaceVariant. بالإضافة إلى ذلك، تمت إضافة وصف مستند معلَمة مفقود لخانة العنوان. (Ic4ad1)

الإصدار 1.0.0-alpha02

21 يوليو 2021

تم طرح 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 وتقسيمToggleChips (I7b639).
  • تم تعديل المساحة المتروكة لمحتوى البداية والنهاية في "الشرائح" لكي تصبح 14.dp بشكل متّسق بغض النظر عمّا إذا كان الرمز يظهر على الشريحة أم لا (كانت سابقًا 12.dp إذا كان الرمز متوفّرًا و14.dp إذا لم يكن متوفّرًا) (I34c86).

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

  • إضافة اختبارات لـ CurvedRow (I93cdb)
  • ربط تبعيات Wear Compose لـ Compose 1.0.0-rc01. (Ie6bc9)
  • تم تغيير تسليم صورة الخلفية في "البطاقات" و"الشرائح" لاقتصاص الصورة بدلاً من تمديدها للحفاظ على تناسب الصورة. (I29b41)
  • تمت إضافة المزيد من العروض التوضيحية واختبارات الدمج لكل من Button وToggleButton. (5e27ed2)
  • تمت إضافة المزيد من اختبارات الشرائح لتغطية ألوان محتوى imageBackgroundChips (Ia9183).

الإصدار 1.0.0-alpha01

1 تموز (يوليو) 2021

تم طرح 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 والكتابة، وتتوافق مع "التصميم المتعدد الأبعاد" (Wear Material)، وهي امتداد لميزة "التصميم المتعدد الأبعاد" لأجهزة WearOS القابلة للارتداء. يحتوي هذا الإصدار الأولي الأول على عمليات تنفيذ وظيفية مبكرة لما يلي:

  • مظهر المواد - لضبط الألوان وأسلوب الخط والأشكال باستمرار عبر المكونات المستخدمة من هذه المكتبة.
  • رقائق صغيرة وصغيرة: يتم تصميم الرقائق على شكل ملعب، وتتوفر أشكال مختلفة من الرقائق، مثل الأيقونات وشركات الإنتاج وشركات الإنتاج الثانوية.
  • - ToggleChip، وSegmentToggleChip، - نوع متخصص من الشرائح يتضمن فتحة لرمز التبديل ثنائي الحالة مثل زر الاختيار أو مربع الاختيار. بالإضافة إلى ذلك، تشتمل SegmentToggleChip على منطقتين قابلتين للنقر، إحداهما قابلة للنقر، والأخرى قابلة للنقر.
  • زر، زر مضغوط: تكون الأزرار دائرية الشكل، وتحتوي على فتحة محتوى واحدة لرمز أو نص بسيط (3 أحرف كحد أقصى).
  • زر التبديل - زر لتشغيل أحد الإجراءات أو إيقافه، به فتحة واحدة للرمز أو الحد الأدنى من النص (3 أحرف كحد أقصى).
  • بطاقة وAppCard - مستطيلة الشكل بزوايا مستديرة، توفر خانات للمحتوى مثل رمز التطبيق والوقت والعنوان والجسم.

ستعمل الإصدارات المستقبلية على توسيع مجموعة التطبيقات المصغّرة مع دعم أدوات اختيار التصميم متعدد الأبعاد لـ Wear، وأشرطة التمرير، والقوائم، ومؤشرات الصفحات، ومربعات الحوار، ومؤشرات التمرير السريع (rsb)، وعناصر الإشعارات المنبثقة والمزيد.

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

تم تصميم مادة Wear Compose وفقًا للمبادئ نفسها المستخدَمة في Compose، على الرغم من أنّها تستهدِف الأجهزة القابلة للارتداء. يجب استخدام مكتبة مواد Wear Compose بدلاً من مكتبة Compose Material عند إنشاء تصميم لجهاز قابل للارتداء.

يجب اعتبار مكتبتَي "المواد" نافيتَين، ويجب ألا يتم مزجهما في تطبيق واحد. إذا وجد المطوّرون أنّهم يدرجون مكتبة Compose Material ضمن الموارد التابعة لهم، سيقترحون إمّا أ) عدم توفّر مكوّنات من مكتبة Wear Compose Material، وإعلامنا بما تحتاج إليه، أو ب) استخدام مكوّن لا ننصح باستخدامه على جهاز قابل للارتداء.