wear protolayout

wear protolayout

  

مرجع واجهة برمجة التطبيقات
androidx.wear.protolayout

تسمح هذه المكتبة بتحديد مجموعة من تنسيقات واجهة المستخدم وتعبيرات غير واجهة المستخدم لعرضها أو تقييمها على مساحات العرض البعيدة.

آخر تعديل	الإصدار الثابت	إصدار محتمل	الإصدار التجريبي	الإصدار التجريبي
12 شباط (فبراير) 2025	1.2.1	-	-	1.3.0-alpha08

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

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

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

رائع

dependencies {
    // Use to implement support for Wear ProtoLayout Expressions
    implementation "androidx.wear.protolayout:protolayout-expression:1.3.0-alpha04"

    // Use to implement support for Wear ProtoLayout
    implementation "androidx.wear.protolayout:protolayout:1.3.0-alpha04"

    // Use to utilize components and layouts with Material design in your ProtoLayout
    implementation "androidx.wear.protolayout:protolayout-material:1.3.0-alpha04"
}

Kotlin

dependencies {
    // Use to implement support for Wear ProtoLayout Expressions
    implementation("androidx.wear.protolayout:protolayout-expression:1.3.0-alpha04")

    // Use to implement support for Wear ProtoLayout
    implementation("androidx.wear.protolayout:protolayout:1.3.0-alpha04")

    // Use to utilize components and layouts with Material design in your ProtoLayout
    implementation("androidx.wear.protolayout:protolayout-material:1.3.0-alpha04")
}

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

الملاحظات

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

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

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

الإصدار 1.3

الإصدار 1.3.0-alpha08

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

تم إصدار androidx.wear.protolayout:protolayout-*:1.3.0-alpha08. يتضمّن الإصدار 1.3.0-alpha08 عمليات الربط هذه.

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

• أضِف مَعلمة القائمة FontSetting لنص Material3. (Ic102d)
• تمت إضافة فئة DynamicDataMap التي تتيح الآن استخدام واجهة برمجة تطبيقات Kotlin لحالات التطبيق بشكل أفضل وأكثر أمانًا من حيث النوع (I012ba).StateBuilder
• تمت إضافة طرق المصنع مثل intAppDataKey لتسهيل إنشاء عناصر AppDataKey (Icea2a).
• تتوفّر الآن طريقة hasValueOfType(Class<?>) في DynamicDataValue بالإضافة إلى طرق hasInt/hasColor/.... (I4f7a6)
• أضفنا errorDim إلى ColorScheme تنسيق Material3 ProtoLayout، وذلك للأخطاء ذات الأولوية العالية أو الإجراءات في حالات الطوارئ، مثل تنبيهات السلامة. (Ia17bb)
• أضفنا ميزة حماية من الأعطال عند الوصول إلى الإعداد العام "تقليل الحركة"، والذي كان يتم تفعيله على بعض المنصات التي لم يتم توفير هذا الإعداد فيها. (I01e2c)

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

• تمت إعادة تسمية addKeyToValueMapping إلى addToStateMap وتمت إزالة الطريقتَين DynamicDataMap.put وDynamicDataMap.put لأنّهما كانتا متكرّرتين. (Ibe9dd)
• تتيح الآن مخطّطات خطوط Material3 استخدام محور المتغير "الاستدارة" لخطوط النظام التي تتيح هذا المحور. يتوافق ProtoLayout FontSetting مع محور الاستدارة للخطوط التي تتيح هذا المحور. (I33eb5)
• تمت إعادة تسمية multilineAlignment إلى alignment في طريقة نص Material3. (I2b66b)
• عدِّل مؤشر التقدم الدائري ليكون من النوع "مربّع"، وحدِّد أيضًا mainContent في constructGraphic ليكون من النوع "مربّع" (I5a3dc).
• إتاحة استخدام مؤشر التقدّم الدائري في الرسم البياني بشكل أفضل (I039db)

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

• اسمح بالقيم الديناميكية في ColorStop وكذلك للزوايا الافتتاحية/الختامية في SweepGradient. (I0146d)
• إصلاحات في "مستندات Google" (I4a63a)
• تم تعديل مكوّنات Material 3 (graphicCard وavatarButton) لتوفير عنصر احتياطي عندما لا تكون سمة weight توسيع العنصر متاحة (مثل الإصدارات الأقدم من واجهة برمجة التطبيقات 33). تم تعديل مكوّن النص للرجوع إلى TEXT_OVERFLOW_ELLIPSIZE_END عندما لا يكون TEXT_OVERFLOW_ELLIPSIZE متوافقًا مع أداة التحويل. (I19e2c)
• تحديث "مستندات Google" لـ PrimaryLayoutMargins (Ibaf7b)

الإصدار 1.3.0-alpha07

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

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

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

• تمت إضافة خيار واجهة برمجة التطبيقات لضبط عوامل تشغيل مختلفة للصور المتحركة من Lottie. بالإضافة إلى ذلك، تمت إضافة واجهة برمجة تطبيقات للمشغِّلات التي يتم تنشيطها عندما يكون التنسيق مرئيًا (I8272d).
• تمت إضافة عوامل التعديل border وvisibility وopacity. (I6d3dd)
• تمت إضافة زر الصورة الرمزية إلى مكوّن ProtoLayout في Material3. (Idb5ae)
• نسمح الآن بتخصيص الهوامش (على الجانب وفي بعض الحالات في أسفل الشاشة) في Material3 primaryLayout. (Ib22f6)
• أضِف الصيغة المقسّمة لمؤشر التقدّم الدائري. (I6a648)
• تمت إضافة مكوّن زر مكثّف إلى ProtoLayout Material3. (Ia3c5c)
• تمت إضافة مكوّنات الزر المصوّر وزرّ الحبوب إلى ProtoLayout Material3. (Ifb88a)

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

• يُطلق الآن على LayoutModfier.foldIn اسم foldRight ليعكس بشكل أفضل سلوكه المتوقّع (Idf242).
• إنّ عامل تشغيل VisibleOnce متوفّر الآن بشكل تجريبي. (Ib2d26)
• أزِل withOpacity من واجهة برمجة التطبيقات المتاحة للجميع لأنّ هناك بديلاً لمكتبة الرسومات. (I030c2)
• تمت إعادة تسمية طرق المستوى الأعلى في LayoutString.kt وLayoutColor.kt لتكون لها أسماء متوافقة مع Java. (I7aff0)
• تمت إزالة الخطوط غير المخصّصة لتنسيق ProtoLayout في Material3. (Idd9ae)
• أضِف اللاحقة Color إلى الحقول في فئات *Colors في Material3. (I2d114)

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

• أضِف تنفيذ EdgeButton الاحتياطي لمحرّك العرض الأقدم الذي لا يتيح استخدام الزوايا غير المتماثلة. (I63364)
• أضِف تنفيذًا احتياطيًا لمؤشر التقدّم الدائري باستخدام أداة عرض قديمة. (I0f134)

الإصدار 1.3.0-alpha06

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

تم إصدار androidx.wear.protolayout:protolayout-*:1.3.0-alpha06. يتضمّن الإصدار 1.3.0-alpha06 عمليات الربط هذه.

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

• ‫LayoutColor للتوافق مع نوعَي الألوان الثابت والديناميكي (I4c89b)
• تمت إضافة مكوّن ProtoLayout Material3 textButton. (Id680d)
• أضِف مكوّن iconButton ProtoLayout Material3. (Ica3f0)
• تمت إضافة مكوّن حاوية الأزرار ProtoLayout Material3. (I17a38)
• تمت إضافة إمكانية استخدام العناصر المعدِّلة للسياق التي يمكن ربطها ببعضها في protolayout-material3 (I4af62).
• تمت إضافة شريحة ProtoLayout Material3 واحدة CircularProgressIndicator (I2c8a2)
• تمت إضافة مُعدِّلات padding وmetadata (I8720a)
• تمّت إضافة المُعدِّلات background وclip وclickable (I35478)
• أضِف LinearGradient إلى الفرشاة واسمح باستخدامها في أداة تعديل الخلفية. (Ic4dea)
• أضِف حجمًا صغيرًا لكل من appCard وtitleCard. (I91f98)
• تمت إضافة مكوّن ProtoLayout Material3 graphicDataCard. (I92be7)
• تمت إضافة مكوّنات ProtoLayout Material3 iconDataCard وtextDataCard. (I4e1e4)
• تمت إضافة مكوّن ProtoLayout Material3 appCard. (Id4c57)
• اختصار EdgeButtonColors إلى ButtonColors (I83624)
• تمت إضافة مكوّن ProtoLayout Material3 titleCard. (I2dc72)

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

• تقبل ProtoLayout Material3 API الآن LayoutString لتتوافق مع النصوص الثابتة والديناميكية. (I9c24a)

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

• إضافة عملية تنفيذ لعرض DashedArcLine (I0c700)
• تغيير في أداة العرض للسماح ArcSpacer بأخذ طول dp (I1437b)

الإصدار 1.3.0-alpha05

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

تم إصدار androidx.wear.protolayout:protolayout-*:1.3.0-alpha05. يتضمّن الإصدار 1.3.0-alpha05 عمليات الربط هذه.

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

• تمت إضافة LayoutString للسماح بحقول سلاسل التنسيق القابلة للربط. (Ida650)
• تمت إضافة مكوّن حاوية بطاقة ProtoLayout Material3. (Ic985a)

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

• تستخدم هذه المكتبة الآن تعليقات توضيحية حول عدم تحديد قيمة JSpecify، وهي عبارة عن استخدام للنوع. على مطوّري Kotlin استخدام مَعلمات المُجمِّع التالية لفرض الاستخدام الصحيح: -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode (Id1f9b، b/326456246)

الإصدار 1.3.0-alpha04

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

تم إصدار androidx.wear.protolayout:protolayout-*:1.3.0-alpha04. يتضمّن الإصدار 1.3.0-alpha04 عمليات الربط هذه.

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

• تم تعديل شكل Material3 ليصبح فئة تحتوي على حقول تحتوي على قيمة Corner الفعلية، تمامًا كما هو الحال في Wear Compose. (Ied8cd)
• تم تعديل ألوان Material3 لتشمل مفهوم ColorScheme، كما هو الحال في Wear Compose. (If645e)
• أضِف إلى مكتبة الاختبار عدّة أدوات مطابقة شائعة الاستخدام. (Ie5cec)

الإصدار 1.3.0-alpha03

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

تم إصدار androidx.wear.protolayout:protolayout-*:1.3.0-alpha03. يتضمّن الإصدار 1.3.0-alpha03 عمليات الربط هذه.

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

• إضافة LayoutElementAssertionsProvider وLayoutElementAssertion وLayoutElementMatcher إلى مكتبة الاختبار (Id1110)

الإصدار 1.3.0-alpha02

16 أكتوبر 2024

تم إصدار androidx.wear.protolayout:protolayout-*:1.3.0-alpha02. يتضمّن الإصدار 1.3.0-alpha02 عمليات الربط هذه.

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

• الإصدار الأولي من مكتبة Material 3 تتضمّن المكوّنات text وedgeButton وbuttonGroup وprimaryLayout.

إصلاحات الأمان

• اعتبارًا من هذا التغيير، يتم تجميع حزمة androidx باستخدام protobuf 4.28.2 لمعالجة CVE-2024-7254. عليك ترقية الإصدار 1.3.0-alpha01 من androidx.wear.protolayout:protolayout-proto وandroidx.wear.protolayout:protolayout-external-protobuf إلى الإصدار 1.3.0-alpha02 لحلّ مشكلة التعرّض للثغرة الأمنية.

المساهمة الخارجية

الإصدار 1.3.0-alpha01

2 أكتوبر 2024

تم إصدار androidx.wear.protolayout:protolayout-*:1.3.0-alpha01. يتضمّن الإصدار 1.3.0-alpha01 عمليات الربط هذه.

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

• توضيح أنّ مدى توفّر أسماء مجموعات الخطوط Roboto وRoboto Flex يعتمد على الجهاز (I193be)
• تم تفعيل مجموعة خطوط Roboto Flex في أداة عرض مربّعات AndroidX. (I08e94)

الإصدار 1.2

الإصدار 1.2.1

16 أكتوبر 2024

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

إصلاحات الأمان

• اعتبارًا من هذا التغيير، يتم تجميع حزمة androidx باستخدام protobuf 4.28.2 لحلّ المشكلة CVE-2024-7254. عليك ترقية الإصدار 1.2.0 من androidx.wear.protolayout:protolayout-proto وandroidx.wear.protolayout:protolayout-external-protobuf إلى الإصدار 1.2.1 لحلّ مشكلة التعرّض للثغرة الأمنية.

الإصدار 1.2.0

7 آب (أغسطس) 2024

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

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

• تم تعديل FontStyle لتوفير خطوط إضافية للأعمدة المتغيّرة وواجهة برمجة تطبيقات أفضل لاختيار الخطوط من أجل إتاحة خطوط Flex القادمة.
• إتاحة عوامل تعديل إضافية:
  • مُعدِّل التحويل الذي يقدّم الترجمة والدوران والتكبير/التصغير مع رسوم متحركة أو بدونها
  • تحديد قيم مختلفة (أفقية وعمودية) لكل نصف قطر زاوية
• تحسين إمكانية الوصول إلى جميع مساحات اللمس من خلال توسيع منطقة النقر على أي عنصر يستخدم مُعدِّل "قابل للنقر" لتكون على الأقل 48dp x 48dp
• تم تحسين PrimaryLayout وEdgeContentLayout من خلال إضافة setResponsiveContentInsetEnabled لدعم السلوك المتجاوب لهذه التنسيقات بشكلٍ أفضل على مختلف أحجام الشاشات وتحسين اتساق مربّعات التطبيقات.
• تحسين التوسيع/عدم التوسيع لنص Material Design من أجل الضبط غير الخطّي لحجم الخط في Android 14
• تحسين التوافق مع اتجاه تنسيق RTL في جميع عناصر القوس

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

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

الإصدار 1.2.0-rc01

24 تموز (يوليو) 2024

تم إصدار androidx.wear.protolayout:protolayout-*:1.2.0-rc01. يتضمّن الإصدار 1.2.0-rc01 عمليات الربط هذه.

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

• لقد أصلحنا شريحة Material Chip العادية لكي لا يمكن استخدامها كرمز إلا إذا لم يتم تمرير أي من التصنيفات الأساسية أو الثانوية. (Iceef9)
• تم تعديل مستندات تنسيقات Material Design لتضمين مرئيات من الصفحة ذات الصلة لتسهيل فهم التنسيقات. (I0256a)

الإصدار 1.2.0-beta01

10 تموز (يوليو) 2024

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

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

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

• تم تعديل FontStyle لتضمين خطوط إضافية على النحو التالي:
  • ضبط إعدادات مختلفة لأشكال الخط، مثل FontSetting.weight وFontSetting.width
  • ضبط العرض نفسه لجميع الأحرف الرقمية - الأرقام الجدولية (إعداد ميزة الخط FontSetting.tnum)
  • واجهات برمجة تطبيقات محسّنة لاختيار الخطوط لتتوافق مع الخطوط المرنة القادمة من خلال تحديد أسماء مجموعات الخطوط المفضّلة لاستخدامها
• مُعدِّل Corner الموسّع للسماح بتحديد كل CornerRadius باستخدام قيم أفقية وعمودية منفصلة للسماح بإنشاء عناصر ذات زوايا غير متماثلة
• تمت إضافة مُعدِّل Transformation جديد يتيح الترجمة والدوران والتكبير/التصغير لعنصر LayoutElement. يمكن إضافة تأثيرات متحركة إلى هذه التحويلات باستخدام قيم ديناميكية.
• تمت إضافة setArcDirection مع خيارات Clockwise وCounterClockwise وNormal إلى جميع عناصر القوس (Arc وArcLine وArcText) لتوفير دعم أفضل في اتجاهات التنسيق المختلفة (مثل LTR وRTL).
• تحسين إمكانية الوصول إلى جميع مساحات اللمس من خلال توسيع مساحة اللمس في أي عنصر يستخدم المُعدِّل Clickable لتكون على الأقل 48dp x 48dp
• تم تحسين PrimaryLayout وEdgeContentLayout من خلال إضافة setResponsiveContentInsetEnabled لدعم السلوك المتجاوب لهذه التنسيقات بشكلٍ أفضل على مختلف أحجام الشاشات وتحسين اتساق مربّعات التطبيقات. تمت إضافة تحذير من أداة التدقيق اللغوي لاقتراح استخدام واجهات برمجة التطبيقات هذه مع حلّ سريع.
• تحسين التوسيع/عدم التوسيع لخط Material Text من أجل الضبط غير الخطّي لحجم الخط في Android 14

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

• تتم إزالة اسم مجموعة الخطوط التلقائية (DEFAULT_SYSTEM_FONT) لأنّه يُفترض عدم استخدام واجهة برمجة التطبيقات preferredFontFamilies. (I39dab)
• يجب أن تكون المَعلمة التي تم تمريرها إلى FontSetting.width موجبة. (I1266f)

الإصدار 1.2.0-alpha05

26 حزيران (يونيو) 2024

تم إصدار androidx.wear.protolayout:protolayout-*:1.2.0-alpha05. يتضمّن الإصدار 1.2.0-alpha05 عمليات الربط هذه.

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

• أضِف طريقة hasText إلى Material.CompactChip للتحقّق مما إذا تم ضبط محتوى النص. (I6e8fc)

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

• تم نقل FontFamily const لتصبح في FontStyle بدلاً من فئة Builder. (I06ced)
• تعديل واجهتَي برمجة التطبيقات FontSetting.weight وFontSetting.width لتشملا التعليقات التوضيحية للنطاق وتغيير مَعلمة الوزن لتكون int. (Ia726c)

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

• تعمل النصوص غير القابلة للتوسيع في مكتبة Material الآن بشكل صحيح مع ميزة "الضبط غير الخطّي لحجم الخط" في Android 14. (I6601e)

الإصدار 1.2.0-alpha04

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

تم إصدار androidx.wear.protolayout:protolayout-*:1.2.0-alpha04. يتضمّن الإصدار 1.2.0-alpha04 عمليات الربط هذه.

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

• تمت إضافة واجهة برمجة التطبيقات للزوايا غير المتماثلة لتتمكّن من تحديد نصف قطر كل زاوية بشكل منفصل باستخدام قيمتَين. (Icbd69)
• تم توسيع نطاق واجهة برمجة التطبيقات FontSetting لتشمل ما يلي:
  • إعداد ميزة الخط، مثل ضبط الخط على أن يكون جدوليًا (If12b7)
  • إعدادات اختلافات الخط، مثل ضبط عرض مخصّص للخطوط المتغيرة (I2b36d)
• تمت إضافة واجهة برمجة التطبيقات Font family API إلى FontStyle للسماح بتحديد قائمة بترتيب عائلات الخطوط التي يجب استخدامها. (Iba9f5)
• تمت إعادة تسمية الثوابت لارتفاع المساحة بين المحتوى والتصنيف الثانوي في LayoutDefaults في Material، والتي كانت في البداية مسبوقة بـ "Edge content" لتكون أكثر عمومية لأنّه يمكن تطبيقها على كل من PrimaryLayout وEdgeContentLayout. (I4dc32)

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

• تمت إعادة تسمية محاور الخطوط المتغيّرة من axisName إلى axisTag. (I02ba3)

الإصدار 1.2.0-alpha03

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

تم إصدار androidx.wear.protolayout:protolayout-*:1.2.0-alpha03. يتضمّن الإصدار 1.2.0-alpha03 عمليات الربط هذه.

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

• تمت إضافة واجهة برمجة تطبيقات لضبط قيم الوزن المخصّصة FontStyle. (I7390a)

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

• حلّ مشكلة تعذّر الربط في getTouchDelegateInfo بسبب خلوّ الخريطة المستهدفة من بيانات (I2accf)

الإصدار 1.2.0-alpha02

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

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

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

• أضفنا إمكانية إيقاف تأثير التموج على العناصر الفردية التي يمكن النقر عليها. (If1ede)
• تمّت إزالة واجهة برمجة التطبيقات الخاصة بعملية التحويل من ArcModifiers لأنّها لا تتيح هذه الميزة (Ic0827).
• ArcDirectionProp يتوقّع "المنشئ" الآن قيمة في دالة الإنشاء. (I76ada)
• ستسمح طريقة PlatformDataValues.Builder.putAll بدمج PlatformDataValue واحد في PlatformDataValue آخر. (I50ba3)
• تمت إعادة تسمية Text#setIsScalable إلى Text#setScalable. (If920e)
• يمكن لـ Material Text ضبط ما إذا كان سيتم استخدام حجم قابل للتغيير (يزداد حجمه عند تغيير حجم خط المستخدم) أم لا. (Ibc849)
• أضفنا خيار ضبط وصف المحتوى على TitleChip. (I5d21f)
• تم إصلاح CompactChip للعمل بشكل صحيح مع الرمز فقط وتعديل واجهة برمجة التطبيقات للسماح بهذا الخيار. (I6589e)

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

• تم إصلاح مشكلة بيانات المنصة المكرّرة المحتملة أثناء بدء التشغيل. (Iba0fd)
• أدخِل دالة جلب جديدة إلى DynamicDataNode لاسترداد تكلفة العقدة. يتم استخدام التكلفة عند الحصول على حصة العقد الديناميكية. في الوقت الحالي، ستكون تكلفة العقد التي تحتوي على قيم ثابتة هي 0، وستكون تكلفة جميع العقد الأخرى هي 1. (Ia33e1)
• أزِل منطق العدّ من NO_OP_QUOTA_MANAGER. (Ib50b8)
• أضفنا قاعدة فحص أخطاء لعرض تحذير عند استخدام PrimaryLayout بدون setResponsiveContentInsetEnabled وتقديم حل سريع. (I12025)
• هناك حدّ أقصى لعدد عقد التعبيرات الديناميكية. (Iffae8)

الإصدار 1.2.0-alpha01

‫6 مارس 2024

تم إصدار androidx.wear.protolayout:protolayout-*:1.2.0-alpha01. يتضمّن الإصدار 1.2.0-alpha01 عمليات الربط هذه.

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

• تتوفّر الآن لعناصر ProtoLayout Arc خيار إضافة ArcDirection (Clockwise أو Counterclockwise أو Normal) إليها. ستؤدي إضافة هذا السلوك إلى Arc أو ArcLine أو ArcText إلى إصلاح سلوكها في تنسيقات RTL. (I90699)
• تم تعديل EdgeContentLayout باستخدام أداة ضبط setResponsiveContentInsetEnabled جديدة لتحقيق توافق أفضل مع إرشادات تجربة المستخدم، وتحقيق اتساق في مربّعات المعلومات من خلال وضع التصنيف الأساسي في مكان ثابت في أعلى الشاشة واستخدام ميزة "العرض المتوافق مع مختلف الأجهزة" للتصنيفات. (I60175)
• أضفنا PrimaryLayout.setResponsiveContentInsetEnabled الذي يضيف عنصرًا مُدمجًا متجاوبًا إلى التصنيف الأساسي والتصنيف الثانوي والشريحة السفلية في هذا التنسيق، لتجنّب خروج المحتوى عن حدود الشاشة. (I0c457)
• تُضيف طريقة لإزالة الهوامش الخارجية من CircularProgressIndicator حتى يمكن استخدامه كمكوّن أصغر. (I55c06)

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

• يستبعد مُنشئ المربّعات الآن تلقائيًا مساحة بادئة الخط في جميع العناصر النصية، بدون خيار لتضمينها. (I3e300)

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

• تم إصلاح مشكلة محاذاة النص عند استخدام ميزة اقتطاع النص وتباعد الأحرف والمحاذاة بالوسط في النص. (I716c7)
• إضافة حل بديل لمشكلة رسم قوس Skia (I08f09)
• إصلاح ArcLine اتجاه الرسم لتصاميم RTL (I6c141)

الإصدار 1.1

الإصدار 1.1.0

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

تم إصدار androidx.wear.protolayout:protolayout-*:1.1.0. يحتوي الإصدار 1.1.0 على عمليات الربط هذه.

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

• إتاحة التدرّج اللوني وتمثيل أفضل للزوايا التي تزيد عن 360 درجة في ArcLine
• يتيح تنسيق التاريخ والوقت استخدام مناطق زمنية مختلفة لأنواع البيانات الديناميكية.
• خيارات أفضل لضبط حجم النص تلقائيًا واستخدام النقاط اللاتينية للإشارة إلى النص المقتطع
• يتيح عنصر "المسافة" استخدام سمات موسّعة مع وزن اختياري.
• تعليق توضيحي لمتطلبات إصدار المخطط لجميع واجهات برمجة تطبيقات ProtoLayout
• يجب توسيع مساحة الاستهداف لأي عنصر Clickable إلى 48 بكسل مستقل الكثافة × 48 بكسل مستقل الكثافة، وذلك لتلبية متطلبات تسهيل الاستخدام.
• يكون وضع "ملء النص" غير مفعّل تلقائيًا، وهو السلوك الوحيد على مستوى جميع عناصر النص ومكوّنات Material التي تحتوي على نص.

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

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

الإصدار 1.1.0-rc01

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

تم إصدار androidx.wear.protolayout:protolayout-*:1.1.0-rc01. يحتوي الإصدار 1.1.0-rc01 على هذه المراجعات.

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

• تظهر علامة PlatformTimeUpdateNotifierImpl مباشرةً بعد تفعيل التحديث. (I77145)
• تم حلّ مشكلة CircularProgressIndicator في التنسيقات من اليمين إلى اليسار. من الآن فصاعدًا، سيتم عرض المحتوى باتجاه عقارب الساعة في جميع الحالات. (I95ee3)
• إضافة حل بديل لمشكلة رسم قوس skia (I08f09)

الإصدار 1.1.0-beta01

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

تم إصدار androidx.wear.protolayout:protolayout-*:1.1.0-beta01. يحتوي الإصدار 1.1.0-beta01 على هذه المراجعات.

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

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

• يتيح ArcLine الآن استخدام مخططات التدرّج اللوني من خلال إضافة Brush مع SweepGradient وإضافة ظل على الغطاء لتمثيل الطول بشكل أفضل أكبر من 360 درجة من خلال إضافة Shadow على StrokeCap الحالي.
• تتيح DynamicInstant تنسيق التاريخ والوقت حسب المنطقة. يمكن استخدام DynamicInstant وDynamicDuration كنوعَي بيانات للحالة أو المنصة.
• ميزة تغيير الحجم التلقائي لحجم النص التي تتيح ضبط أحجام متعددة على FontStyle.setSizes حيث سيتم تغيير حجم النص تلقائيًا استنادًا إلى المساحة المتوفّرة داخل العنصر الرئيسي بالإضافة إلى ذلك، حسّنا خيارات استخدام النقاط اللاتينية للنص الذي يتدفق من خلال إضافة TEXT_OVERFLOW_ELLIPSIZE وإيقاف TEXT_OVERFLOW_ELLIPSIZE_END نهائيًا.
• تتيح Spacer الآن استخدام سمات موسّعة مع وزن اختياري. بالنسبة إلى المبنى ExpandedDimensionProp، أضفنا طريقة مساعدة DimensionBuilders.weight.
• إتاحة إخفاء عناصر التنسيق وإظهارها ديناميكيًا باستخدام Modifier.visible ويشمل ذلك استخدام قيم ديناميكية في BoolProp.
• تتضمّن الآن جميع واجهات برمجة تطبيقات ProtoLayout تعليقًا توضيحيًا لمتطلبات إصدار المخطّط، ويمكن التحقّق من الإصدار قبل طلب واجهة برمجة تطبيقات أحدث.
• تم الآن توسيع المنطقة المستهدَفة لكل عنصر يتضمّن Clickable لتكون 48×48 على الأقل في أداة المعالجة لتلبية متطلبات تسهيل الاستخدام بشكل أفضل.
• بعد إطلاق مبادرات أخرى لمكونات التصميم المتعدد الأبعاد وميزة "الإنشاء"، أوقفنا الآن تلقائيًا ميزة "ملء النص" في جميع عناصر Text. بالإضافة إلى ذلك، تمت إزالة AndroidTextStyle ووظائف الإعداد ذات الصلة من واجهة برمجة التطبيقات العامة. مع إصلاحات الأخطاء التالية:
• تمت إضافة طريقة ضبط لوضع محتوى الحافة في EdgeContentLayout حتى يمكن وضعه قبل المحتوى الآخر.
• طرح استثناء بشكلٍ متسق عند العثور على قيمة تعداد غير معروفة
• إلغاء صلاحية نتيجة تعبير عندما ينتج قيمة رقمية غير صالحة (NaN أو لانهائية) أو يُعرِض خطأ ArithmeticException

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

• تعديلات على واجهة برمجة التطبيقات SweepGradient للسماح بقبول أيّ من الألوان أو ColorStops في أداة الإنشاء (I6676f)

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

• إضافة واجهة برمجة تطبيقات ودعم مُنشئ رسومات محدودَين لضبط الاتجاه الذي يتم فيه رسم عناصر القوس (Idef5a)
• يتم ضبط القيمة التلقائية لـ RoundMode على Floor في FloatToInt32Node في حال عدم تحديدها. سيستمرّ ظهور استثناء في العقدة إذا لم يتم التعرّف على RoundMode المقدَّمة. (I1b2d8)

الإصدار 1.1.0-alpha04

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

تم إصدار androidx.wear.protolayout:protolayout-*:1.1.0-alpha04. يحتوي الإصدار 1.1.0-alpha04 على هذه المراجعات.

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

• لا تنفّذ فئة VersionInfo واجهة Comparable. (I8d13c)
• يتيح أداة الربط الآن خيار TEXT_OVERFLOW_ELLIPSIZE. (I7f085)

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

• تم إيقاف خيار "تدفّق النص" TEXT_OVERFLOW_ELLIPSIZE_END نهائيًا. يُرجى استخدام واجهة برمجة التطبيقات الجديدة TEXT_OVERFLOW_ELLIPSIZE التي تتضمّن سلوكًا مشابهًا جدًا. (I822d8)
• بعد إطلاق مبادرات أخرى لعناصر التصميم المتعدد الأبعاد وميزة "الإنشاء"، أوقفنا الآن تلقائيًا ميزة "ملء النص" في جميع عناصر "النص". بالإضافة إلى ذلك، تمت إزالة AndroidTextStyle ووظائف الإعداد ذات الصلة من واجهة برمجة التطبيقات المتاحة للجميع. (I79094 وIb0b03 وI32959 وIaf7d5 وIfa298 وI0a4ae وIda9d3)
• تم استبدال Modifier.hidden بـ Modifier.visible (I56902)
• يقبل FontStyle#setSizes الآن وسيطات int بدلاً من SpProp. (I02b37)

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

• ارفِع استثناءً عند العثور على قيمة تعداد غير محدّدة أو غير معروفة. (I9d2cf)
• إعادة صياغة DynamicTypeBindingRequest (I27b57)
• إلغاء صلاحية نتيجة تعبير عندما ينتج قيمة رقمية غير صالحة (NaN أو لانهائية) أو يُعرِض خطأ ArithmeticException (I681ae)

الإصدار 1.1.0-alpha03

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

تم إصدار androidx.wear.protolayout:protolayout-*:1.1.0-alpha03. يحتوي الإصدار 1.1.0-alpha03 على هذه المراجعات.

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

• إتاحة ميزة تجريبية لإخفاء عناصر التنسيق أو إظهارها بشكل ديناميكي (I64a78)
• إتاحة القيم الديناميكية في BoolProp (I2fe96)
• إضافة تعليق توضيحي لمتطلبات إصدار المخطّط إلى واجهات برمجة التطبيقات ProtoLayout (I0f03c)
• توسيع نطاق واجهة برمجة التطبيقات باستخدام الخيار الجديد في TextOverflow لحذف أجزاء من النص في حاوية رئيسية ثابتة حتى في حال عدم بلوغ الحد الأقصى من الأسطر (ولكن لا تتوفّر مساحة كافية للنص) (I110a9)
• تمت إضافة طريقة المساعدة DimensionBuilders.weight لإنشاء ExpandedDimensionProp مع الوزن. (I4f72b)
• يمكن استخدام DynamicInstant وDynamicDuration كنوعَي بيانات للحالة أو المنصة. (I6819f)

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

• تعديل واجهة برمجة التطبيقات لإخفاء DynamicZonedDateTime ونقل جميع عملياتها إلى DyanamicInstant (I34b94)
• يتيح الآن عنصر "المسافة" سمة "المسافة الموسّعة" للعرض/الارتفاع. (Ie7c94)
• إتاحة إضافة منطقة استهداف النقرة في أداة الربط (I39c79)

الإصدار 1.1.0-alpha02

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

تم إصدار androidx.wear.protolayout:protolayout-*:1.1.0-alpha02. يحتوي الإصدار 1.1.0-alpha02 على هذه المراجعات.

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

• تمت إضافة حقل ArcLine StrokeCap Shadow إلى واجهة برمجة التطبيقات. (I830ec)
• توسيع واجهة برمجة التطبيقات لتتمكّن من تحديد عرض أو ارتفاع عنصر "المسافة" للتوسيع (I757ca)
• أضفنا واجهة برمجة تطبيقات تجريبية لتغيير حجم النص تلقائيًا استنادًا إلى المساحة المتوفّرة له داخل العنصر الرئيسي. (Ibbe63)
• أن تتيح الحد الأدنى للحجم القابل للنقر (I178e3)
• تمت إضافة ميزة عرض المحتوى لنظام التشغيل StrokeCap Shadow. (I48b17)
• إضافة إمكانية استخدام أداة التقديم والترجيع مع مخطّط التدرّج في ArcLine (I4d5bb)

الإصدار 1.1.0-alpha01

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

تم إصدار androidx.wear.protolayout:protolayout-*:1.1.0-alpha01. يحتوي الإصدار 1.1.0-alpha01 على هذه المراجعات.

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

• تمت إضافة خيار فرشاة إلى Arcline، مع إتاحة استخدام SweepGradient. (Ie7ce3)
• تمت إضافة إمكانية استخدام تنسيق التاريخ والوقت حسب المنطقة. (Ibfae0)
• تمت إضافة protos وjava Wrappers المطلوبة لتنسيق التاريخ والوقت حسب المنطقة. (I97126)
• تمت إضافة وظائف جلب لإعادة قراءة القيمة المخزّنة في DynamicDataValue. (Ie6cea)
• تمت إضافة طريقة ضبط لوضع محتوى الحافة في EdgeContentLayout حتى يمكن وضعه قبل المحتوى الآخر. (Ie8e8a)

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

• تم إصلاح مشكلة عدم تعديل تعبير يتضمّن عمليات تسجيل متعددة لمصادر بيانات الوقت على الفور. (I8e1a8)
• تم إصلاح خطأ في مركز العنصر الجذر أثناء تعديلات الاختلافات. (Ie48f7)
• لن يتم تجاهل قيم قيود التنسيق غير المحدّدة (أو الفارغة) بعد الآن. (Ibc785)
• تم تقليل الوقت الفاصل بين ظهور تنسيق وبدء تشغيل عقد مسار الإحالة الناجحة. (I38d4e)

الإصدار 1.0

الإصدار 1.0.0

9 آب (أغسطس) 2023

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

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

تقدّم مكتبة ProtoLayout واجهات برمجة تطبيقات لإنشاء تنسيقات وتعبيرات يمكن استخدامها على مساحات عرض Wear OS المختلفة. على سبيل المثال، تستخدم مكتبة Tiles واجهات برمجة التطبيقات هذه لتفعيل ربط بيانات النظام الأساسي (لتعديل بيانات المربّعات بشكل أسرع) والرسوم المتحرّكة.

الإصدار 1.0.0-rc01

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

تم إصدار androidx.wear.protolayout:protolayout-*:1.0.0-rc01. يحتوي الإصدار 1.0.0-rc01 على هذه المراجعات.

• لنقل البيانات من "الألواح" إلى ProtoLayout، يُرجى اتّباع التعليمات الواردة هنا.

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

• أزلنا الطريقتَين setLayoutConstraintForDynamicAnchorAngle وgetLayoutConstraintForDynamicAnchorAngle من عنصر Arc. تمت إضافة هذه الطرق عن طريق الخطأ ولم يكن لها أي تأثير في التنسيق المقدَّم. (If7d01)
• لقد حدّدنا الحدّ الأقصى للعمق الذي يمكن أن يصل إليه تنسيق ProtoLayout بـ 30 LayoutElements متداخلة. (I8a74b)

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

• أضفنا عملية تحقّق لرمي خطأ في حال ضبط DynamicColor على SpanText. (I0e5bc)
• يُرجى العلم أنّ وحدة مصدر البيانات DAILY_CALORIES هي سعر حراري. (Iaa785)

الإصدار 1.0.0-beta01

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

تم إصدار androidx.wear.protolayout:protolayout-*:1.0.0-beta01. يحتوي الإصدار 1.0.0-beta01 على هذه المراجعات.

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

• السماح بضبط الساعة لإجراء اختبارات ربط الوقت (I05622)

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

• يقبل كلّ من PlatformDataReceiver.onData() وStateBuilders.Builder.addKeyToValueMapping الآن الربط الآمن للأنواع من DynamicDataKey إلى DynamicDataValue بدلاً من الأنواع العامة غير الآمنة. وهذا يعني أنّه يتم الآن كتابة DynamicDataValue باستخدام DynamicType. تم نقل ثوابت HEART_RATE_ACCURACY_X إلى جذر PlatformHealthSources، لمطابقة موضع الثوابت الأخرى في Android. يتم الآن استخدام HEART_RATE_ACCURACY_X ثوابت int مباشرةً في DynamicHeartRateAccuracy.constant() وDynamicHeartRateAccuracy.dynamicDataValueOf() بدلاً من القيمة الثابتة. (I82ff5)
• تمّت إمكانية إنشاء فئة PlatformHealthSources.Constants عن طريق الخطأ. تم حلّ هذه المشكلة الآن. (Icb849)
• يتلقّى PlatformTimeUpdateNotifier#setReceiver الآن Runnable بدلاً من الدالة Supplier وExecutor للإشعار. (I9d938)
• لقد غيّرنا نوع المَعلمة في PlatformTimeUpdateNotifier#setReceiver من Callable إلى Supplier. (I664bf)
• يمكن الآن إضافة رمز إلى CompactChip وTitleChip. (I5a01e)

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

• تعديل رسائل Prop باستخدام الحقول الديناميكية لاستخدام oneof بدلاً من ذلك (I81739)
• إعادة استخدام تنفيذ أدوات الضبط لعمليات التحميل الزائد التي تحتوي على أدوات ضبط (Ied70c)
• تسجيل ملفات مرجعية بشكل صحيح في أدوات الضبط التي تتضمّن عمليات تحميل زائدة (I86ed2)

الإصدار 1.0.0-alpha11

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

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

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

• أضفنا PlatformDataKey لقياس دقة معدل ضربات القلب. (I7f9b8)

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

• أعِد تسمية StateBuilders#getIdToValueMapping إلى getKeyToValueMapping وغيِّر نوع الإرجاع إلى Map<<AppDataKey<?>,DynamicDataValue>. (Iaa7ae)
• جعل StateStore فئة نهائية (I408ca)
• تم استبدال واجهة TimeGateway بواجهة PlatformTimeUpdateNotifier في مكتبة protolayout-expression-pipeline التي توفّر معدّل التكرار المطلوب لتعديل بيانات الوقت. (I60869)
• إعادة تسمية register/unregisterForData في PlatformDataProvider إلى set/clearReceiver (I14b02)
• في "نص المواد"، تمت إعادة تسمية getExcludeFontPadding ليصبح hasExcludeFontPadding. (Iea01d)
• تمت إضافة أداة ضبط لمحاذاة التصنيف بشكلٍ مثالي إلى جميع مكوّنات الشريحة. تم الآن تطبيق الحد الأدنى لحجم الهدف الذي يمكن النقر عليه على جميع الشرائح. (I8ae92)
• تمت إعادة تسمية LayoutDefaults#BUTTON_MAX_NUMBER إلى MAX_BUTTONS. (I84788)
• تمت إعادة تسمية DAILY_DISTANCE إلى DAILY_DISTANCE_M. (I4f758)

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

• تعديل مستندات أنواع الإعلانات لتوضيح سبب فرض القيمة الثابتة حدِّد القيمة التلقائية المستخدَمة في حال عدم تقديم قيمة ثابتة. (I155aa)
• PlatformDataKey يجب أن تتّبع مساحات الاسماء أسلوب تسمية Java. (I47bda)

الإصدار 1.0.0-alpha10

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

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

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

• أضِف AppDataKey للوصول إلى حالة التطبيق المُرسَل. أضِف PlatformDataKey للوصول إلى بيانات النظام الأساسي. أضِف دعمًا لمساحة الاسم في StateStore. (I7985e)
• إتاحة عمليتَي Equal وNotEqual في DynamicBool (I6a0c1)

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

• أصبحت فئة FontStyles نهائية الآن (Iaa2ea).
• تم إيقاف LayoutElementBuilders#FontStyles نهائيًا. يُرجى استخدام androidx.wear.protolayout.Typography أو إنشاء FontStyle خاص بك. (Ic929b)
• إخفاء واجهة Action#Builder المُدمجة من واجهة Action توفّر فئتَا LoadAction وLaunchAction تنفيذات لواجهة Builder. (I1d70c)
• السماح باستخدام DynamicFloat مع FloatProp يُرجى العِلم أنّ FloatProp لا تتطلّب قيود التنسيق لأنّها لا تُستخدَم كعنصر لتغيير التنسيق. (I286ac)
• تمّت إزالة الإجراءَين LoalAction وSetStateAction لأنّهما لم يكونا متوافقَين بعد. (I5d6a6)
• تمّت إضافة إمكانية استخدام تنسيق ARGB_8888 لموارد الصور المضمّنة. (I8a07c)
• إعادة تسمية StateEntryValue إلى DynamicDataValue، وتعديل واجهات برمجة التطبيقات الخاصة بالحالة لاستخدام DynamicDataKey (If1c01)
• نحن نحدّ من عدد الإدخالات المسموح بها في StateStore لضمان احتواء استخدام الذاكرة ووقت تعديل الحالة بشكل جيد والتحكّم فيهما لكل مثيل من StateStore. نتيجةً لذلك، على المطوّر التأكّد من عدم تضمين أكثر من MAX_STATE_ENTRY_COUNT إدخال في الخريطة، وإلا سيتلقّى IllegalStateException عند إنشاء StateStore أو تعديله. (Ibadb3)
• إخفاء الصفوف OnLoadTrigger وOnConditionMetTrigger، وإعادة تسمية الصف setTrigger إلى setCondition للصف OnConditionMetTrigger (Ibf629)
• لأسباب تتعلّق بالأداء والتوافق، لن تتيح برامج عرض ProtoLayout المجموعة الكاملة من الميزات في موارد AnimatedVectorDrawable. وسنضع علامة "تجريبية" على واجهات برمجة التطبيقات هذه إلى أن نتمكّن من تحديد المجموعة المتوافقة. (Ic6daf)
• تمت إضافة أنواع ديناميكية للمسافة اليومية والسعرات الحرارية اليومية والطوابق التي تم صعودها أو نزولها يوميًا. أصبحت مفاتيح مصادر صحة المنصة الآن ضمن PlatformHealthSources.Keys (Ib7637).
• تستبدل الطريقة Easing.cubicBezier الطريقة CubicBezierEasing.Builder. وبهذا، تتم إزالة فئة EasingFunction ويمكن الآن الوصول مباشرةً إلى الثوابت المُخفِّفة من هذه الفئة من واجهة Easing. بالإضافة إلى ذلك، يتم استبدال setInfiniteRepeatable بـ INFINITE_REPEATABLE_WITH_RESTART وINFINITE_REPEATABLE_WITH_REVERSE (Ib41e7).
• نفِّذ PlatformDataProvider لتقديم معدّل نبضات القلب وعدد الخطوات اليومية. تمت إزالة واجهة SensorGateway من واجهة برمجة التطبيقات المتاحة للجميع. (I55b84)
• أضِف PlatformDataProvider وعدِّل StateStore للتسجيل في PlatformDataProvider عندما يكون المفتاح المتوافق مع مقدّم الخدمة مطلوبًا من العقدة من مسار التعبير. (Ib616a)
• لم يعُد SensorGateway هو Closeable لأنّه لم يعُد يحتفظ بأي حالة. (I6b4f7)
• السماح باستخدام FloatProp مع DynamicFloat للتقدّم في CircularProgressIndicator تتوفّر هذه الميزة لبرامج عرض متوافقة مع الإصدار 1.2. ستستخدم أدوات العرض القديمة القيمة staticValue إذا تم توفيرها، وإلا ستستخدم القيمة 0 (I0d91b).
• تمّت إعادة صياغة الثوابت MultiButtonLayout إلى فئة LayoutDefaults.MultiButtonLayoutDefaults التي تحتوي الآن على أحجام الأزرار استنادًا إلى عدد الأزرار في التنسيق. (I13973)
• إتاحة استخدام StringProp مع DynamicString في Material Text تتوفّر هذه الميزة لبرامج عرض متوافقة مع الإصدار 1.2. ستستخدم أدوات العرض القديمة القيمة الثابتة المقدَّمة. عدِّل نوع الإرجاع Text#getText من String إلى StringProp. (I7275b)

الإصدار 1.0.0-alpha09

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

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

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

• أضفنا عنصر تنسيق إضافة تجريبيًا. يُرجى العِلم أنّه لا يمكن استخدام هذا الخيار تلقائيًا، ويتطلّب إضافة عارض قادرة على فهم عنصر التنسيق. (I6581d)
• تمت إضافة StrokeCap لـ ArcLine. (I94951)
• تمت إضافة إمكانية إجراء عملية فورية مشروطة. (I489a7)
• تمت إضافة إمكانية استخدام عملية "المدة الشَرطية". (Iab469)
• تمت إضافة إمكانية إنشاء المدة من الثواني. (Ib5fa1)

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

• تمّت إزالة enable/disablePlatformSource طريقة من DynamicTypeEvaluator. يجب أن يكون المتصل مسؤولاً عن إجراء التعديلات. (I78c6d)
• السماح بتحديد الحد الأقصى لحجم أنواع البيانات المرتبطة (Ie2966)
• إضافة إمكانية استخدام وصف المحتوى الديناميكي في protolayout-material (I62c8e)
• استخدِم long و@IntRange للمدة والتأخير في AnimationParameters. (I388b6)

الإصدار 1.0.0-alpha08

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

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

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

• تمت إضافة AndroidTextStyle إلى LayoutElementBuilders. (I8d967)
• أضفنا إمكانية ضبط استبعاد مساحة بادئة الخطوط في ProtoLayout نص المواد. (I17f5d)
• يتوفّر الآن تنسيق ARGB_8888 للصور المضمّنة. (I18c1e)
• تتيح DynamicColor الآن إجراء onCondition. (I10927)

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

• السماح بمدة مخصّصة للصورة المتحركة العكسية (I3251f)
• لقد أضفنا مفتاح التعديل SemanticDescription. بالإضافة إلى ذلك، لا يمكن ربط ContentDescription. (I3f1d)
• تم استبدال الطريقة DynamicBool.isFalse() الآن بالطريقة DynamicBool.negate() وتمّت إزالة DynamicBool.isTrue(). بالإضافة إلى ذلك، تؤدي الآن قيم NaN DynamicFloat وتضييق نطاق DynamicInt32 إلى DynamicFloat إلى عرض نتيجة ديناميكية غير صالحة. (I6ac1e)
• تستخدم الآن أداتا تنسيق Int وfloat نمط Builder. (Ieb213)

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

• تمت إزالة القيمة الثابتة الاحتياطية من الحقول التي يمكن تنشيطها. (Ifcb01)
• تمّت إزالة DynamicTypeValueReceiver#onPreUpdate. (I2dc35)
• تمّ الآن وضع حدّ أقصى لطول السلاسل في التعبيرات الديناميكية. (I4c93)
• تم ضبط تبعيات Gradle الآن بشكل صحيح على api بدلاً من implementation عند الحاجة. (I40503)

الإصدار 1.0.0-alpha07

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

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

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

• إتاحة القيم الديناميكية في StringProp (I04342)
• وضع علامة على عناصر التنسيق القابلة للربط (Ia110b)

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

• sensorGateway#registerSensorGatewayConsumer يأخذ نوع البيانات كمَعلمة بدلاً من الطريقة في Consumer. (Icf314)
• تمت إعادة تسمية ObservableStateStore إلى StateStore. (Ieb0e2)
• تمت إضافة DynamicTypeEvaluator.Builder بدلاً من وسيطات المُنشئ للسماح بمزيد من الوسائط الاختيارية، بما في ذلك ObservableStateStore التي يتم ضبطها تلقائيًا الآن على متجر فارغ. (I6f832)
• تمّ إعادة ترتيب المَعلمات في DynamicTypeEvaluator. (Ic1ba4)

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

• نشر الإشارات بشكل صحيح من مصادر أدوات استشعار النظام الأساسي إلى العقد في مرحلة ما بعد المعالجة (I5a922)

الإصدار 1.0.0-alpha06

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

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

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

• أضفنا واجهة برمجة تطبيقات تجريبية لاستخدام معدل ضربات القلب والخطوات اليومية في التعبيرات الديناميكية (Ifd711).
• أضفنا إمكانية تأخير الصور المتحركة إلى الخلف والأمام. (Ic25f7)
• أضفنا DynamicColor إلى الحدود والخلفية.
• أضفنا إمكانية استخدام القيم الديناميكية للأنواع في DimensionBuilder.
• نقل التنسيق والمكونات من tiles-material إلى protolayout-material

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

• تمت إضافة LoadActionListener إلى ProtoLayoutViewInstance. (If7806)

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

• تمت إضافة FloatNodesTest (Id7281)
• إصلاح تعطُّل عارض الصور عند تعذُّر تحميل صورة نقطية من الموقع

الإصدار 1.0.0-alpha05

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

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

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

• أضفنا رسمًا متحركًا تجريبيًا "لتعديل المحتوى" إلى عنصر Modifiers. سيتم تشغيل هذا المؤثر المتحرك كلما تغيّر العنصر (الذي يتضمّن هذا المُعدِّل) أو أحد عناصره الفرعية أثناء تعديل التنسيق. (bd03e5d)

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

• أضفنا forwardRepeatDelayMillis وreverseRepeatDelayMillis إلى Repeatable. تمت أيضًا إعادة تسمية delayMillis في AnimationSpec إلى startDelayMillis (Ifb266).
• تقبل طرق DynamicTypeEvaluator.bind الآن عنصرًا تنفيذيًا. (I346ab)
• أضفنا طريقة startEvaluation إلى BoundDynamicType لبدء التقييم بعد ربط النوع الديناميكي. (I19908)

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

• ستتم إعادة استخدام عنصر Animator للحركات اللاحقة لعنصر واحد. (Ia3be9)

الإصدار 1.0.0-alpha04

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

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

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

• يُعلم ObservableStateStore المستمعين الآن أيضًا عند إزالة مفتاح.
• أضفنا إصدار مخطّط العارض ومعدّل الخط إلى DeviceParameters (يمكن استخدامهما لإنشاء تنسيقات بشكل مشروط استجابةً لإعدادات الإصدارات والخطوط المختلفة).
• أضفنا إمكانية إضافة تأثيرات متحركة إلى قيم DynamicInt32 (I05485).
• لقد أضفنا مشغِّلَي OnLoad وOnConditionalMet. ويمكن استخدامها لبدء الصور المتحركة التي تتيح استخدام عامل تشغيل.
• أضفنا وزن التنسيق للسمات الموسّعة والحد الأدنى للحجم للسمات المُلفّفة.
• أضفنا نوعَي الإعلانات الديناميكية الفورية والمدّة. ويمكن استخدامها لتمثيل لحظة زمنية أو مدة في تعبير ديناميكي.
• لقد أضفنا إمكانية استخدام AnimatedVectorDrawable وSeekableAnimatedVectorDrawable كموارد تنسيق.

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

• تتطلّب بيانات أجهزة الاستشعار استخدام الإصدار 29 من واجهة برمجة التطبيقات أو الإصدارات الأحدث. (I8099e)
• أضفنا طريقتَي مساعدة launchAction (لبدء الأنشطة).

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

• إعادة تسمية set/getSpec إلى set/getAnimationSpec في صورة Tiles المتحركة (I3d74b)

الإصدار 1.0.0-alpha03

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

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

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

• أضفنا toByteArray() وfromByteArray() إلى الأنواع الديناميكية في مكتبة protolayout-express.
• أضفنا toString() إلى الأنواع الديناميكية في مكتبة تعبيرات protolayout.
• أضفنا ميزة التقييم للأنواع الديناميكية. يمكن استخدام فئة DynamicTypeEvaluator من مكتبة protolayout-expression-pipeline لتقييم (وتلقّي قيم معدَّلة) لنوع ديناميكي تم إنشاؤه سابقًا (DynamicString أو DynamicFloat أو …)
• عندما يتعذّر تشغيل الصور المتحركة (إما لأنّ المُقيّم أوقفها أو لأنّ عدد الصور المتحركة التي يتم تشغيلها وصل إلى الحدّ الأقصى)، سيتم استخدام القيم الثابتة التي تم ضبطها على العقدة القابلة للتحريك لاستبدال الصورة المتحركة.

الإصدار 1.0.0-alpha02

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

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

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

• يتم نقل أدوات إنشاء التنسيقات من androidx.wear.tiles:tiles إلى androidx.wear.protolayout:protolayout. سيتم إيقاف الإصدارات في androidx.wear.tiles:tiles نهائيًا في أحد الإصدارات التجريبية التالية.

الإصدار 1.0.0-alpha01

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

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

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

• يقدّم هذا الإصدار مكتبة جديدة "تعبير ProtoLayout" لإنشاء تعبيرات من المتغيّرات الديناميكية.