wear protolayout
آخر تعديل | الإصدار الثابت | إصدار محتمل | الإصدار التجريبي | الإصدار التجريبي الأول |
---|---|---|---|---|
11 كانون الأول (ديسمبر) 2024 | 1.2.1 | - | - | 1.3.0-alpha05 |
الإعلان عن التبعيات
لإضافة تبعية على wear-protolayout، يجب إضافة مستودع Google Maven إلى مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.
أضِف التبعيات للعناصر التي تحتاج إليها في ملف build.gradle
ل
تطبيقك أو وحدتك:
Groovy
dependencies { // Use to implement support for Wear ProtoLayout Expressions implementation "androidx.wear.protolayout:protolayout-expression:1.3.0-alpha05" // Use to implement support for Wear ProtoLayout implementation "androidx.wear.protolayout:protolayout:1.3.0-alpha05" // Use to utilize components and layouts with Material design in your ProtoLayout implementation "androidx.wear.protolayout:protolayout-material:1.3.0-alpha05" }
Kotlin
dependencies { // Use to implement support for Wear ProtoLayout Expressions implementation("androidx.wear.protolayout:protolayout-expression:1.3.0-alpha05") // Use to implement support for Wear ProtoLayout implementation("androidx.wear.protolayout:protolayout:1.3.0-alpha05") // Use to utilize components and layouts with Material design in your ProtoLayout implementation("androidx.wear.protolayout:protolayout-material:1.3.0-alpha05") }
لمزيد من المعلومات عن العناصر الاعتمادية، اطّلِع على مقالة إضافة عناصر الاعتماد الخاصة بالإنشاء.
ملاحظات
تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا واجهت مشاكل جديدة أو كان لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية عن طريق النقر على زر النجمة.
اطّلِع على مستندات أداة تتبُّع المشاكل لمزيد من المعلومات.
الإصدار 1.3
الإصدار 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
x48dp
- تم تحسين
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
x48dp
- تم تحسين
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
لتشمل ما يلي: - تمت إضافة واجهة برمجة التطبيقات Font family API إلى
FontStyle
للسماح بتحديد قائمة بترتيب عائلات الخطوط التي يجب استخدامها. (Iba9f5) - تمت إعادة تسمية الثوابت لارتفاع المساحة بين المحتوى والتصنيف الثانوي في
LayoutDefaults
في Material، والتي كانت في البداية مسبوقة بـ "محتوى الحافة" لتكون أكثر عمومية لأنّه يمكن تطبيقها على كل من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
يتوقّع Builder الآن قيمة في عنصر الإنشاء. (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
لتنسيقات RTL. من الآن فصاعدًا، سيتم عرض المحتوى باتجاه عقارب الساعة في جميع الحالات. (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
بـ 30LayoutElements
متداخلة. (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()
. بالإضافة إلى ذلك، تؤدي الآن قيم NaNDynamicFloat
وتضييق نطاق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 على هذه المراجعات.
الميزات الجديدة
تغييرات واجهة برمجة التطبيقات
- يأخذ
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
في صورة متحركة للمربّعات (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" لإنشاء تعبيرات من المتغيّرات الديناميكية.