Wear
androidx.wear.activity
androidx.wear.ambient
androidx.wear.input
androidx.wear.utils
androidx.wear.noticeet
androidx.wear.Widgetet.Drawer
(الاطّلاع على المستندات ref14 حول جميع حِزم الملابس)
يعرض هذا الجدول جميع العناصر في مجموعة androidx.wear
.
العناصر | الإصدار المستقر | إصدار مرشح | الإصدار التجريبي | إصدار ألفا |
---|---|---|---|---|
رداء | 1.3.0 | - | - | 1.4.0-alpha01 |
ارتداء الجهاز | 1.1.0 | - | - | 1.2.0-alpha02 |
اختبار ارتداء الجهاز | 1.1.0 | - | - | 1.2.0-alpha02 |
الاستخدام المستمر | 1.0.0 | - | - | 1.1.0-alpha01 |
التفاعلات مع الهاتف | 1.0.1 | - | - | 1.1.0-alpha04 |
التفاعلات عن بُعد | 1.0.0 | - | - | 1.1.0-alpha02 |
إعلان التبعيات
لإضافة تبعية إلى Wear، يجب إضافة مستودع Google Maven إلى مشروعك. لمزيد من المعلومات، يمكنك الاطّلاع على مستودع Maven من Google.
أضف التبعيات للعناصر التي تحتاجها في ملف build.gradle
لتطبيقك أو الوحدة الخاصة بك:
رائع
dependencies { implementation "androidx.wear:wear:1.3.0" // Add support for wearable specific inputs implementation "androidx.wear:wear-input:1.1.0" implementation "androidx.wear:wear-input-testing:1.1.0" // Use to implement wear ongoing activities implementation "androidx.wear:wear-ongoing:1.0.0" // Use to implement support for interactions from the Wearables to Phones implementation "androidx.wear:wear-phone-interactions:1.0.1" // Use to implement support for interactions between the Wearables and Phones implementation "androidx.wear:wear-remote-interactions:1.0.0" }
Kotlin
dependencies { implementation("androidx.wear:wear:1.3.0") // Add support for wearable specific inputs implementation("androidx.wear:wear-input:1.1.0") implementation("androidx.wear:wear-input-testing:1.1.0") // Use to implement wear ongoing activities implementation("androidx.wear:wear-ongoing:1.0.0") // Use to implement support for interactions from the Wearables to Phones implementation("androidx.wear:wear-phone-interactions:1.0.1") // Use to implement support for interactions between the Wearables and Phones implementation("androidx.wear:wear-remote-interactions:1.0.0") }
لمزيد من المعلومات حول التبعيات، انظر إضافة تبعيات الإصدار.
ملاحظات
تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إخبارنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة تصويتك إلى مشكلة حالية من خلال النقر على زر النجمة.
راجِع مستندات أداة تتبُّع المشاكل للحصول على مزيد من المعلومات.
الإصدار 1.0 من Wear Core
الإصدار 1.0.0-alpha01
29 أيار (مايو) 2024
تم طرح "androidx.wear:wear-core:1.0.0-alpha01
". يحتوي الإصدار 1.0.0-alpha01 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة فئة
WearApiVersionhelper
جديدة للمساعدة في التحقّق من توافق واجهة برمجة التطبيقات في وقت التشغيل على Wear. يمكن للعملاء استخدام هذه الفئة المساعِدة الثابتة والطريقة المقدَّمة (#isApiVersionAtLeast(VERSION)
) للتحقّق من التوافق.
الإصدار 1.0 من معاينة Wear Tooling
الإصدار 1.0.0
29 تشرين الثاني (نوفمبر) 2023
تم طرح "androidx.wear:wear-tooling-preview:1.0.0
". يتضمّن الإصدار 1.0.0 هذه الالتزامات.
الميزات في الإصدار 1.0.0
- أضِف
WearDevices
لإدراج أجهزة Wear الصالحة التي يمكن استخدامها في معاينات واجهة المستخدم.
الإصدار 1.0.0-rc01
15 تشرين الثاني (نوفمبر) 2023
تم إصدار "androidx.wear:wear-tooling-preview:1.0.0-rc01
" بدون أي تغييرات. يحتوي الإصدار 1.0.0-rc01 على هذه الالتزامات.
الإصدار 1.0.0-beta01
18 تشرين الأول (أكتوبر) 2023
تم إصدار "androidx.wear:wear-tooling-preview:1.0.0-beta01
" بدون أي تغييرات. يتضمّن الإصدار 1.0.0-beta01 هذه الالتزامات.
الإصدار 1.0.0-alpha01
23 آب (أغسطس) 2023
تم طرح "androidx.wear:wear-tooling-preview:1.0.0-alpha01
". يحتوي الإصدار 1.0.0-alpha01 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- أضِف
WearDevices
لإدراج أجهزة Wear الصالحة التي يمكن استخدامها في معاينات واجهة المستخدم (Ib036e).
الإصدار 1.4 من Wear
الإصدار 1.4.0-alpha01
15 تشرين الثاني (نوفمبر) 2023
تم طرح "androidx.wear:wear:1.4.0-alpha01
". يحتوي الإصدار 1.4.0-alpha01 على هذه الالتزامات.
إصلاح الأخطاء
- توسيط رمز
ConfirmationOverlay
عموديًا عندما لا توجد رسالة. (I496d8)
الإصدار 1.3 من Wear
الإصدار 1.3.0
9 آب (أغسطس) 2023
تم طرح الإصدار "androidx.wear:wear:1.3.0
" بدون أي تغييرات منذ 1.3.0-rc01
. يتضمّن الإصدار 1.3.0 هذه الالتزامات.
التغييرات المهمة منذ الإصدار 1.2.0
- يجب نقل بيانات
AmbientModeSupport
لاستخدامLifecycleObserver
. أوقِفAmbientModeSupport
لصالح الفئات الجديدة المستندة إلى مراحل النشاط. - تعديل
ConfirmationOverlay
باستخدام الرموز/التنسيق والخطوط ومقاييس الخطوط الجديدة - تم تعديل
SwipeDismissTransitionHelper
لاستخدام ميزة قابلة للرسم في الخلفية بدلاً من استخدامView
ثانٍ لتصحيح الأخطاء عند استخدامFragmentContainerView
. - تم تعديل الصورة المتحركة في
SwipeDismissFrameLayout
لتتوافق مع نظام Wear الأساسي وعمليات تنفيذ Wear Compose. - إصلاح خطأ "
SwipeDismissFrameLayout
" لتجنُّب التجاهل غير المقصود للأجزاء ذات الانتقال العمودي - تتوافق
ArcLayout
الآن مع معاملات ترجيح التوسيع التي تعمل بطريقة مشابهة لترجيح التصميم العادي. - دعم قناة "
layoutDirection
" على "ArcLayout
"
الإصدار 1.3.0-rc01
21 حزيران (يونيو) 2023
تم طرح الإصدار "androidx.wear:wear:1.3.0-rc01
" بدون أي تغييرات منذ 1.3.0-beta01
. يتضمّن الإصدار 1.3.0-rc01 هذه الالتزامات.
الإصدار 1.3.0-beta01
7 حزيران (يونيو) 2023
تم طرح "androidx.wear:wear:1.3.0-beta01
". يتضمّن الإصدار 1.3.0-beta01 هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- تم تعديل البيانات في
AmbientLifecycleObserver
بعد تلقّي الملاحظات. تمت إعادة تسميةAmbientLifecycleObserverInterface
إلىAmbientLifecycleObserver
، ويمكن الحصول على مثيل من خلال استدعاءAmbientLifecycleObserver(...)
. تم نقلisAmbient
ليكون حقلاً بدلاً من طريقة. (I84b4f)
إصلاح الأخطاء
- إضافة عمليات تحقُّق فارغة لمعالجة الحالات التي تكون فيها طريقة العرض الرئيسية فارغة أثناء إعادة ضبط ألفا والترجمة في
SwipeToDismiss
. (Ib0ec7)
الإصدار 1.3.0-alpha05
19 نيسان (أبريل) 2023
تم طرح "androidx.wear:wear:1.3.0-alpha05
". يحتوي الإصدار 1.3.0-alpha05 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- يجب نقل بيانات
AmbientModeSupport
لاستخدامLifecycleObserver
. يمكنك إيقاف ميزة "AmbientModeSupport
" نهائيًا لصالح الفئات الجديدة المستندة إلى مراحل النشاط. (I1593b)
إصلاح الأخطاء
- عدِّل أسلوب
SwipeDismissTransitionHelper
لاستخدام العناصر القابلة للرسم بدلاً من إضافة طريقة عرض لإصلاح الأخطاء أثناء استخدامFragmentContainerView
. (I851cd)
الإصدار 1.3.0-alpha04
25 كانون الثاني (يناير) 2023
تم طرح "androidx.wear:wear:1.3.0-alpha04
". يحتوي الإصدار 1.3.0-alpha04 على هذه الالتزامات.
إصلاح الأخطاء
- لقد عدّلنا الصورة المتحركة في
SwipeDismissFrameLayout
لتتوافق مع منصة Wear OS وعمليات تنفيذ Wear Compose. (I7261b)
الإصدار 1.3.0-alpha03
24 آب (أغسطس) 2022
تم طرح "androidx.wear:wear:1.3.0-alpha03
". يتضمّن الإصدار 1.3.0-alpha03 هذه الالتزامات.
الميزات الجديدة
- تتوافق
ArcLayout
الآن مع معاملات ترجيح التوسيع التي تعمل بطريقة مشابهة لترجيح التصميم العادي. وهذا يعني أنه يمكنك تحديد الحجم النسبي للعناصر الفرعية دون الحاجة إلى حساب زواياها مباشرةً. لقد أضفنا أيضًا أفضل جهد إلىMaxAngleDegrees
يتم الالتزام به عند توسيع العناصر الثانوية باستخدام أوزان. على سبيل المثال، يمكنك تثبيت القوس بعدة أطفال وأوزانًا تصل إلى 90 درجة، وسيحترم ذلك أيضًا المساحة التي تشغلها أي عناصر غير موسَّعة.
تغييرات واجهة برمجة التطبيقات
- أضفنا الوزن إلى
ArcLayout.LayoutParams
الذي يسمح للتطبيق المصغّر بتوسيعه لملء المساحة المتاحة، في حال توفّر أكثر من تطبيق مصغّر، تكون حصّتها من المساحة المتوفّرة متناسبة مع وزنها. بالإضافة إلى ذلك، أضفناArcLayout.setMaxAngleDegrees
بحيث يمكنك، على سبيل المثال، ضبط التوسعة على 90 درجة (لا يؤثر ذلك في تنسيق أي تطبيقات مصغّرة ثابتة الحجم). أخيرًا، أصبح لدىArcLayout.Widget
الآنsetSweepAngleDegrees
وهو ما يتيح لـArcLayout
إبلاغ التطبيق المصغّر بوزن غير صفري. (I75f24) - تم تعديل إمكانية القيم الفارغة لـ
setColorFilter
(I99ddf، b/236498063)
الإصدار 1.3.0-alpha02
23 شباط (فبراير) 2022
تم طرح "androidx.wear:wear:1.3.0-alpha02
". يحتوي الإصدار 1.3.0-alpha02 على هذه الالتزامات.
الميزات الجديدة
- دعم
layoutDirection
علىArcLayout
(I14d49) - رسالة وصف محتوى محسّنة لـ ConfirmOverlay (I0fdf8)
- يُرجى تعديل
ConfirmationOverlay
باستخدام رموز/تنسيق جديد. (If5b54)
إصلاح الأخطاء
- تمت إضافة قواعد ProGuard لضمان الاحتفاظ بالرموز البرمجية المتعلقة بالمحتوى المحيط (Idaa10)
- تجنُّب التجاهل غير المقصود للأجزاء في اسحب ScrollFrameLayout باستخدام الانتقال العمودي (Idb6d8)
- إصلاح تثبيت التأكيد عند عدم احتوائه على رسالة (I63e6f)
المساهمة الخارجية
- Dae Gyu LEE (Samsung) - تجنَّب التجاهل بدون قصد للأجزاء في مرِّر سريع "قالب إطار" مع الانتقال بشكل عمودي (Idb6d8).
الإصدار 1.3.0-alpha01
29 أيلول (سبتمبر) 2021
تم طرح "androidx.wear:wear:1.3.0-alpha01
". يحتوي الإصدار 1.3.0-alpha01 على هذه الالتزامات.
إصلاح الأخطاء
- يدفع
ConfirmationOverlay
الآن الرمز إلى الأعلى لاستيعاب الرسائل الأطول، بدون أن تدخل الرسالة إلى حافة الجهاز (أو خارج الشاشة). (I54bff)
الإصدار 1.1.0 من تطبيقات Wear OS والتفاعلات
الإصدار 1.1.0-alpha04 من VerWear-Phone-Interactions
10 كانون الثاني (يناير) 2024
تم طرح "androidx.wear:wear-phone-interactions:1.1.0-alpha04
". يحتوي الإصدار 1.1.0-alpha04 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- أضفنا
RemoteAuthClient.isRemoteAuthAvailable
الذي يتحقّق مما إذا كانت المصادقة عن بُعد متاحة. (Ibc10c)
الإصدار 1.1.0-alpha02
10 كانون الثاني (يناير) 2024
تم طرح "androidx.wear:wear-remote-interactions:1.1.0-alpha02
". يحتوي الإصدار 1.1.0-alpha02 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- أضفنا علامة
RemoteActivityHelper.isRemoteActivityHelperAvailable
التي تساعد في التحقّق مما إذا كانت وظيفة بدء النشاط عن بُعد متاحة. (I107a9) - لقد عدَّلنا الدالة الإنشائية
RemoteActivityHelper
لتتضمّن معلَمة اختيارية متوافقة في Java. (I75554)
الإصدار 1.1.0-alpha01
21 حزيران (يونيو) 2023
تم طرح "androidx.wear:wear-remote-interactions:1.1.0-alpha01
". يحتوي الإصدار 1.1.0-alpha01 على هذه الالتزامات.
إصلاح الأخطاء
- تم تحسين كيفية إجراء عمليات الإكمال ومعالجة الأخطاء في
RemoteActivityHelper
. (I60d60)
المساهمة الخارجية
- عليك إزالة تبعية الجوافة من
wear-remote-interactions
واستخدام بدائل أصغر.
الإصدار 1.1.0-alpha03 من Wear-Phone-Interactions
9 آذار (مارس) 2022
تم طرح "androidx.wear:wear-phone-interactions:1.1.0-alpha03
". يتضمّن الإصدار 1.1.0-alpha03 هذه الالتزامات.
إصلاح الأخطاء
- تعرض الآن القيمة
redirectUrl
منOAuthRequest
سلسلة فارغة إذا لم يتم ضبط عنوان URL لإعادة التوجيه في عنوان URL للطلب المحدّد. (I44242)
الإصدار 1.1.0-alpha02 من Wear-Phone-Interactions
15 كانون الأول (ديسمبر) 2021
تم طرح "androidx.wear:wear-phone-interactions:1.1.0-alpha02
". يحتوي الإصدار 1.1.0-alpha02 على هذه الالتزامات.
إصلاح الأخطاء
- أصلح الأخطاء في مستندات
RemoteAuthClient
، بما في ذلك الخطأ في نموذج مقتطف الرمز والرابط المعطّل إلىErrorCode
(I260e8).
الإصدار 1.1.0-alpha01 من Wear-Phone-Interactions
15 أيلول (سبتمبر) 2021
تم طرح "androidx.wear:wear-phone-interactions:1.1.0-alpha01
". يحتوي الإصدار 1.1.0-alpha01 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
الإصدار 1.0.0 من Wear OS والتفاعلات
الإصدار 1.0.1 من Wear-Phone-Interactions
15 كانون الأول (ديسمبر) 2021
تم طرح "androidx.wear:wear-phone-interactions:1.0.1
". يتضمّن الإصدار 1.0.1 هذه الالتزامات.
إصلاح الأخطاء
- تم طرح استثناء ثابت من
BridgingManager
عند محاولة إيقاف الإشعارات الوسيطة بدونexcludedTags
.
الإصدار 1.0.0 من Wear-Phone-Interactions-Wear-التحكم عن بُعد للتفاعلات عن بُعد
15 أيلول (سبتمبر) 2021
تم طرح androidx.wear:wear-phone-interactions:1.0.0
وandroidx.wear:wear-remote-interactions:1.0.0
. يتضمّن الإصدار 1.0.0 هذه الالتزامات.
الميزات الرئيسية للإصدار 1.0.0
تحتوي "مكتبة التفاعلات الهاتفية" على واجهات برمجة تطبيقات للتفاعلات بين "الأجهزة القابلة للارتداء" و"الهواتف". ويحتوي على ما يلي:
PhoneDeviceType
، وهي توفّر طرق مساعد لتحديد نوع الهاتف الذي تم إقران الساعة الحالية به للاستخدام على الأجهزة القابلة للارتداء فقط.- واجهات برمجة التطبيقات
BridgingManager
وBridgingManagerService
وBridgingConfig
لتفعيل/إيقاف الإشعارات في وقت التشغيل واختياريًا ضبط العلامات للإشعارات المستثناة من وضع الربط. RemoteAuthClient
، يوفِّر إمكانية المصادقة عن بُعد على الأجهزة القابلة للارتداء إلى جانب إتاحة تثبيت إضافة OAuth PKCE. يتم توفير معالجات إضافية وفئات مساعد للاتصال.
تحتوي "مكتبة التفاعل عن بُعد" على واجهات برمجة تطبيقات للتفاعل بين الأجهزة القابلة للارتداء والهواتف. ويحتوي على ما يلي:
WatchFaceConfigIntentHelper
، توفير وظائف مساعِدة لتحديد رقم التعريف واسم المكوّن في أنشطة إعداد خلفية شاشة الساعة للجهاز المصاحب على الهاتف- فئة
RemoteActivityHelper
يمكن استخدامها لفتح الأغراض على أجهزة أخرى (أي من الساعة إلى الهاتف).
تفاعلات Wear-الهاتف - التفاعلات عن بُعد، الإصدار 1.0.0-rc01
1 أيلول (سبتمبر) 2021
تم طرح androidx.wear:wear-phone-interactions:1.0.0-rc01
وandroidx.wear:wear-remote-interactions:1.0.0-rc01
. يحتوي الإصدار 1.0.0-rc01 على هذه الالتزامات.
إصلاح الأخطاء
- إصلاح الخطأ الذي يمنع نشر الأخطاء التي تظهر في "خدمات Google Play" للمتصل عند استخدام RemoteActivityHelper (I60d60)
- إصلاح الخطأ الذي لا ينفّذ فيه RemoteActivityHelper بشأن مستقبله مطلقًا إذا لم تكن هناك عُقد متصلة، أو في حال عدم العثور على رقم تعريف العقدة المطلوب (I60d60)
الإصدار 1.1 من نظام التشغيل Wear OS
الإصدار 1.1.0-alpha01
23 آب (أغسطس) 2023
تم طرح "androidx.wear:wear-ongoing:1.1.0-alpha01
". يحتوي الإصدار 1.1.0-alpha01 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- أضِف حقل وصف المحتوى إلى "النشاط الجاري". وستستخدم خدمات تسهيل الاستخدام هذه البيانات لوصف "النشاط الجاري". (I79fc6)
إصلاح الأخطاء
- تمت إضافة "
@RequiresPermission
" إلى واجهات برمجة التطبيقات التي تتطلب منح إذن "POST_NOTIFICATIONS
" في الإصدار 33 من حزمة تطوير البرامج (SDK) والإصدارات الأحدث. (Ie542e، b/238790278)
الإصدار 1.0.0 من نظام التشغيل Wear OS
1 أيلول (سبتمبر) 2021
تم طرح "androidx.wear:wear-ongoing:1.0.0
". يتضمّن الإصدار 1.0.0 هذه الالتزامات.
الميزات الرئيسية للإصدار 1.0.0
- واجهة برمجة التطبيقات Wear Ongue Activities API هي واجهة برمجة تطبيقات مخصّصة لمطوّري البرامج، بما في ذلك المطوّرين التابعون لجهات خارجية، وتُستخدَم هذه الواجهة لتصنيف نشاطهم على أنّه "نشاط مستمر" وتقديم المعلومات اللازمة.
- تشير "الأنشطة الجارية" إلى الأنشطة التي يمكن أن تعمل في خلفية الساعة (مثل التمارين والمكالمات والوسائط). في نظام التشغيل Wear 3، يتم إبراز النشاط الذي يتم الإعلان عنه باعتباره مستمرًا من خلال رمز تراكب مخصص على خلفية شاشة الساعة وعرض مختلف في مشغّل التطبيقات.
- لمزيد من المعلومات، يُرجى الاطّلاع على دليل النشاط الجاري لارتداء الجهاز.
تطبيقات Wear-Phone-Interactions وWear-التحكم عن بُعد للتفاعلات عن بُعد الإصدار 1.0.0-الإصدار التجريبي 01
18 آب (أغسطس) 2021
تم طرح androidx.wear:wear-phone-interactions:1.0.0-beta01
وandroidx.wear:wear-remote-interactions:1.0.0-beta01
. يتضمّن الإصدار 1.0.0-beta01 هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- تمت إعادة تسمية الصف
RemoteIntentHelper
إلىRemoteActivityHelper
. تمت إعادة تسمية الدالتينRemoteIntentHelper#getRemoteIntentExtraIntent
وRemoteIntentHelper#getRemoteIntentNodeId
إلىRemoteActivityHelper#getTargetIntent
وRemoteActivityHelper#getTargetNodeId
، على التوالي. (Id2042)
الإصدار 1.0.0-rc01 من نظام التشغيل Wear OS
18 آب (أغسطس) 2021
تم طرح الإصدار "androidx.wear:wear-ongoing:1.0.0-rc01
" بدون أي تغييرات منذ 1.0.0-beta01
. يحتوي الإصدار 1.0.0-rc01 على هذه الالتزامات.
الإصدار 1.0.0-تجريبي 01 من نظام التشغيل Wear OS
4 آب (أغسطس) 2021
تم طرح "androidx.wear:wear-ongoing:1.0.0-beta01
". يتضمّن الإصدار 1.0.0-beta01 هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- تقبل بعض أدوات الإعداد في OngoingActivity.Builder الآن على وسيطة فارغة من أجل إعطاء التماثل والاتساق بين سيتيتر وgetter (I17ee5)
الإصدار 1.0.0-alpha07 من Wear-Phone-Interactions
4 آب (أغسطس) 2021
تم طرح "androidx.wear:wear-phone-interactions:1.0.0-alpha07
". يحتوي الإصدار 1.0.0-alpha07 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- تمت إعادة التسمية "
WearTypeHelper.isChinaDevice
" إلى "WearTypeHelper.isChinaBuild
". (I47302) - لقد عدَّلنا مكتبة RemoteAuthClient لاختيار واجهة برمجة تطبيقات جديدة (redirect_uri) تلقائيًا استنادًا إلى نوع الجهاز (RoW/China). (I38866)
- تم إصلاح الخطأ الذي تسبَّب في تعذُّر تحويل BridgingConfig إلى/من Bundle باستخدام ClassCastException. تمت إضافة اختبارات الوحدة لفئة BridgingManagerService. (I68ecb)
الإصدار 1.0.0-alpha06 من Wear-Remote-Interactions
4 آب (أغسطس) 2021
تم طرح "androidx.wear:wear-remote-interactions:1.0.0-alpha06
". يحتوي الإصدار 1.0.0-alpha06 على هذه الالتزامات.
الإصدار 1.0.0-alpha06 من Wear-Phone-Interactions
21 تموز (يوليو) 2021
تم طرح "androidx.wear:wear-phone-interactions:1.0.0-alpha06
". يحتوي الإصدار 1.0.0-alpha06 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- أصبح الصف
BridgingManagerSeviceBinder
الآن فئة فرعية من الخدمة وتمت إعادة تسميته إلى BridgingManagerSevice. (I9fca2) - تم تغيير الطريقة
RemoteAuthClient.Callback.onAuthorizationError
لتضمين معلمة OAuthRequest. تتطلب الآن الطرق التي تتطلب معاودة الاتصال أيضًا منفذًا لتشغيل عملية معاودة الاتصال. (I35e11)
إصلاح الأخطاء
- لقد جعلنا واجهة برمجة التطبيقات للمصادقة أكثر وضوحًا من خلال معلَمات أكثر توثيقًا وباستخدام الخصائص حيثما أمكن. (I12287)
الإصدار 1.0.0-alpha05 من Wear-Phone-Interactions
30 حزيران (يونيو) 2021
تم طرح "androidx.wear:wear-phone-interactions:1.0.0-alpha05
". يحتوي الإصدار 1.0.0-alpha05 على هذه الالتزامات.
إصلاح الأخطاء
- المعلمات الموثقة التي يجب تمريرها في الدالة الإنشائية لـ
BridgingConfig.Builder
.
الإصدار 1.0.0-alpha06 من Wear OS
2 حزيران (يونيو) 2021
تم طرح "androidx.wear:wear-ongoing:1.0.0-alpha06
". يحتوي الإصدار 1.0.0-alpha06 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- إضافة حقل العنوان إلى النشاط الجاري. (I7a405)
إصلاح الأخطاء
- ينسخ "
SerializationHelper.copy()
" الآن نسخة دفاعية من المعلومات (I8b276) - مستندات setCategory محسّنة (Iff01f)
الإصدار 1.0.0-alpha05 من Wear OS
18 أيار (مايو) 2021
تم طرح "androidx.wear:wear-ongoing:1.0.0-alpha05
". يحتوي الإصدار 1.0.0-alpha05 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
في
OngoingActivity
الآن، تُسترد الدالة getter جميع القيم التي تم ضبطها مباشرةً من خلال أداة الإنشاء (أو الإعدادات التلقائية المأخوذة من الإشعار المرتبط). (Id8ac8)- يُستخدَم الصف الجديد
Status
الآن لإنشاء حالةOngoingActivity
. - لم يعُد
OngoingActivityData
وOngoingActivityStatus
جزءًا من واجهة برمجة التطبيقات العامة.
- يُستخدَم الصف الجديد
لم يعُد الفئتان
TextStatusPart
وTimerStatusPart
جزءًا من واجهة برمجة التطبيقات العامة. (I57fb6)- لإنشاء
Part
مع نصّ ثابت، استخدِمStatus.TextPart
. - لإنشاء
Part
مع ساعة إيقاف (يتم العدّ إلى الآن)، استخدِمStatus.Stopwatch
. - لإنشاء "
Part
" مع موقّت (العدّ التنازلي)، استخدِمStatus.Timer
.
- لإنشاء
الإصدار 1.0.0-alpha04 من Wear OS
5 أيار (مايو) 2021
تم طرح "androidx.wear:wear-ongoing:1.0.0-alpha04
". يحتوي الإصدار 1.0.0-alpha04 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- في OnOngueActivity، يُطلق الآن على طُرق from currentOnboundActivity على اسماليةRecoveryOn أدخلActivity.
- تضم ميزة OngoingActivity الآن مجموعة كاملة من عناصر geters، وهي نفسها التي لم تكن متوفّرة في السابق إلا في OningActivityData. (I0ee4d)
الإصدار 1.0.0-alpha05 من Wear-Remote-Interactions
21 تموز (يوليو) 2021
تم طرح "androidx.wear:wear-remote-interactions:1.0.0-alpha05
". يحتوي الإصدار 1.0.0-alpha05 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
لقد أضفنا الفئة
RemoteIntentHelper
(المعروف سابقًا باسم RemoteIntent في مكتبة دعم الأجهزة القابلة للارتداء) التي يمكن استخدامها لفتح الأغراض على الأجهزة الأخرى (أي من الساعة إلى الهاتف). (I1d7e0)تمت إزالة الفئة PlayStoreAvailability من مكتبة AndroidX. لمعرفة ما إذا كان "متجر Play" متاحًا على هاتف متصل، استخدِم طريقة
androidx.phone.interactions.PhoneTypeHelper.getPhoneDeviceType
لتحديد ما إذا كان الهاتف المرتبط يعمل بنظام التشغيل Android أم لا. بعد ذلك، استخدِم طريقةandroidx.wear.utils.WearTypeHelper.isChinaDevice
لتحديد ما إذا كان الهاتف المتصل جهازًا صينيًا. إذا كان الهاتف يعمل بنظام التشغيل Android ولم يكن جهازًا صينيًا، سيكون "متجر Play" متاحًا. (Ie7dec)
الإصدار 1.0.0-alpha04 من Wear-Phone-Interactions
7 نيسان (أبريل) 2021
تم طرح "androidx.wear:wear-phone-interactions:1.0.0-alpha04
". يحتوي الإصدار 1.0.0-alpha04 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- تم تعديل ثوابت
ErrorCode
لجعل المكتبة الجديدة متوافقة مع الإصدارات السابقة من نظام التشغيل في مكتبة الدعم القابلة للارتداء.
إصلاح الأخطاء
- تم إصلاح الاستثناء الناتج عن واجهة برمجة تطبيقات OAuth الجديدة عند بدء جلسة OAuth.
الإصدار 1.0.0-alpha03 من Wear-Remote-Interactions
7 نيسان (أبريل) 2021
تم طرح "androidx.wear:wear-remote-interactions:1.0.0-alpha03
". يحتوي الإصدار 1.0.0-alpha03 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- تم تغيير
PlayStoreAvailability
إلى فئة تحتوي على عنصر مصاحب بطرق ثابتة. يظل الاستخدام كما هو.
إصلاح الأخطاء
- تم إصلاح مستند ملخّص خاص بـ
WatchFaceConfigIntentHelper
لعرض نموذج الرمز مع أحرف HTML الفعلية بشكل صحيح.
الإصدار 1.0.0-alpha03 من Wear-تفاعلات على الهاتف
10 آذار (مارس) 2021
تم طرح androidx.wear:wear-ongoing:1.0.0-alpha03
وandroidx.wear:wear-phone-interactions:1.0.0-alpha03
. يحتوي الإصدار 1.0.0-alpha03 على هذه الالتزامات.
الميزات الجديدة
- يمكنك نقل OAuthClient من مكتبة دعم الأجهزة القابلة للارتداء إلى AndroidX. تمت إعادة تسمية هذه الفئة التي تم نقلها إلى RemoteAuthClient وهي تتيح المصادقة عن بُعد على الأجهزة القابلة للارتداء مع إتاحة إمكانية إضافة إضافة OAuth PKCE. يتم توفير معالجات إضافية وفئات مساعد للاتصال.
- يمكن الآن ربط الأنشطة الجارية بإشعار يحتوي على علامة، وذلك باستخدام الدالة الإنشائية الجديدة On goesActivity.Builder.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة دعم لعلامات الإشعارات في مكتبة الأنشطة المستمرة (I653b4)
- نقل بيانات OAuthClient من Wear Support Library إلى AndroidX، وإتاحة إضافة OAuth PKCE (I3eaaa)
الإصدار 1.0.0-alpha02 من Wear-Remote-Interactions
10 آذار (مارس) 2021
تم طرح "androidx.wear:wear-remote-interactions:1.0.0-alpha02
". يحتوي الإصدار 1.0.0-alpha02 على هذه الالتزامات.
الميزات الجديدة
- نقل فئة PlayStoreAvailability من مكتبة الدعم القابل للارتداء إلى AndroidX التي توفِّر واجهة برمجة تطبيقات للتحقّق مما إذا كان "متجر Play" متاحًا على الهاتف أم لا
إصلاح الأخطاء
- جارٍ نقل فئة PlayStoreAvailability من مكتبة الدعم القابل للارتداء إلى AndroidX. (I69bfe)
الإصدار 1.0.0-alpha02
10 شباط (فبراير) 2021
تم طرح androidx.wear:wear-ongoing:1.0.0-alpha02
وandroidx.wear:wear-phone-interactions:1.0.0-alpha02
. يحتوي الإصدار 1.0.0-alpha02 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة الدعم للحالات الأكثر تعقيدًا. وتتكون من نموذج (أو أكثر) وسلسلة من الأجزاء التي سيتم استخدامها لملء العناصر النائبة للنموذج. في المقابل، تشمل هذه الحالة طريقة ثابتة لإنشاء حالات بسيطة تتضمّن جزءًا واحدًا فقط (نص أو موقّت) وأداة لإنشاء حالات أكثر تعقيدًا. (I1fe81)
- يمكنك نقل الفئتَين BridgingManager وBridgingConfig من مكتبة Wear Support Library إلى نظام AndroidX الذي يوفّر واجهات برمجة تطبيقات لتفعيل أو إيقاف الإشعارات في وقت التشغيل وضبط العلامات اختياريًا على الإشعارات التي يتم استثناؤها من وضع الربط. (I3a17e)
الإصدار 1.0.0-alpha01
27 كانون الثاني (يناير) 2021
تم طرح androidx.wear:wear-ongoing:1.0.0-alpha01
وandroidx.wear:wear-phone-interactions:1.0.0-alpha01
وandroidx.wear:wear-remote-interactions:1.0.0-alpha01
. يحتوي الإصدار 1.0.0-alpha01 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
نقل مكتبة الأنشطة المستمرة إلى مكتبة فرعية جديدة: الملابس المستمرة. تتوفّر الآن الصفوف الدراسية الآن في حزمة androidx.wear.onbound (المعروفة سابقًا باسم androidx.wear.on visibleactivities) (I7c029).
يمكنك إنشاء مكتبة دعم جديدة تحتوي على صفوف تدعم التفاعلات بدءًا من الأجهزة القابلة للارتداء إلى الهواتف. تتم تعبئتها مبدئيًا بالصفوف التي تم نقلها من مكتبة Wearable Support Library. (Id5180)
يجب نقل فئة PhoneDeviceType من مكتبة دعم الأجهزة القابلة للارتداء إلى AndroidX. تمت إعادة تسمية الفئة التي تم نقلها إلى PhoneTypeHelper الذي يوفّر طرقًا مساعِدة لتحديد نوع الهاتف الذي يتم إقران الساعة الحالية به للاستخدام على الأجهزة القابلة للارتداء فقط. (Ibd947)
أنشِئ مكتبة دعم جديدة تحتوي على صفوف تدعم التفاعل بين الأجهزة القابلة للارتداء والهواتف. تتم تعبئتها مبدئيًا بالصفوف التي تم نقلها من مكتبة Wearable Support Library. (I9deb4)
يمكنك نقل صف WatchFaceCompanion من مكتبة الدعم القابل للارتداء إلى AndroidX. تمت إعادة تسمية الفئة التي تم نقلها إلى WatchFaceConfigIntentHelper التي توفِّر وظائف مساعِدة لتحديد رقم التعريف واسم المكوِّن في أنشطة إعداد خلفية شاشة الساعة على الهاتف، كما يمكن استخدامها على المستوى المحلي لإعداد خلفية شاشة الساعة على الجهاز القابل للارتداء. (Ia455f)
إضافات ارتداء Wear وخلفية شاشة الساعة 1.0.0
الإصدار 1.0.0-alpha22
15 أيلول (سبتمبر) 2021
تم طرح "androidx.wear:wear-*:1.0.0-alpha22
". يحتوي الإصدار 1.0.0-alpha22 على هذه الالتزامات.
الميزات الجديدة
- أصبحت جلسة EditorSession متوافقة الآن مع مراقِب مراحل النشاط حتى لا تضطر إلى إغلاقها صراحةً عند انتهاء نشاطك.
تغييرات واجهة برمجة التطبيقات
- يستعين كل من EditorSession وListenableEditorSession الآن على kotlin StateFlows للإضافة complicationSlotsState وComicationsPreviewData وComicationsDataSourceInfo. (I761d9)
- تم تغيير واجهة برمجة التطبيقات EditorSession#userStyle الآن إلى
MutableStateFlow<UserStyle>
(I32ca9). - يستخدم EditorSession.createOnWatchEditorSession الآن أداة مراقبة مراحل النشاط ويتم إغلاقها تلقائيًا عند ملاحظتها onDestroy. بالإضافة إلى ذلك، لا يتطلّب
createOnWatchEditorSession
الآن سوى تمرير النشاط. تم أيضًا تطبيق تغييرات متطابقة على ListenableEditorSession. (Ic6b7f) - تمت إعادة الدالة الإنشائية لـ CustomValueUserStyleإعداد كجزء من واجهة برمجة التطبيقات العامة. (I2e69a)
UserStyle
يكتسب الآن منMap<UserStyleSetting, UserStyleSetting.Option>
وينتج عنMutableUserStyleSetting#put
redArgumentException إذا لم يكن الإعداد في المخطط أو إذا كان الخيار لا يتطابق مع الإعداد. (Iba40f)
الإصدار 1.0.0-alpha21
1 أيلول (سبتمبر) 2021
تم طرح "androidx.wear:wear-*:1.0.0-alpha21
". يحتوي الإصدار 1.0.0-alpha21 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- تستخدم الآن جميع واجهات برمجة التطبيقات المتاحة للجميع الخاصة بخلفيات شاشة الساعة والعميل والمحررات وواجهات برمجة التطبيقات java.time.Instant بدلاً من استخدام لغة طويلة، وبالتالي ارتفع الحد الأدنى لمستوى واجهة برمجة التطبيقات إلى 26. (I3cd48)
- تستخدم واجهات برمجة التطبيقات وواجهات برمجة التطبيقات للإضافة الآن ميزة ZonedDateTime غير القابلة للتغيير بدلاً من "تقويم Google". (I25cf8)
- يتم الآن إعداد Payment Slots حاليًا باستخدام NoDataComplicationData، في حين يتم الآن ضبط قيمة في مُركّبة Payment SluteSlot.complicationData، وبالتالي لم تعُد هذه البيانات قابلة للقيم. (I4dfd6) هذا يحد من وميض التعقيد عند التبديل بين خلفيات شاشة الساعة (ولكنه لا يزيلها).
الإصدار 1.0.0-alpha20
18 آب (أغسطس) 2021
تم طرح "androidx.wear:wear-*:1.0.0-alpha20
". يحتوي الإصدار 1.0.0-alpha20 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- لقد أضفنا createFallbackPreviewData إلى BillingDataSourceInfo الذي يمكن استخدامه عندما تعرِض هذه السمةCommentDataSourceInforecoveryr.retrievePreviewComplicationData قيمة فارغة. (I38c4d)
- تم تحويل PaymentDataSourceUpdateRequester إلى واجهة للسماح بسخرية اختبارات الوحدات. يمكنك إنشاء مُكمِّل بيانات ملتِمة مُركّبة لـComicationDataSourceUpdateRequester باستخدامComicationDataSourceUpdateRequester.create(). (I7da22).
- تم استبدال RenderParameters.certifiedComplicationSlotIds بـ RenderParameters.lastComplicationTapDown events الذي يعرض فئة TapEvent الجديدة التي تحتوي على ثلاثيات x وy للنقرة بالبكسل والطابع الزمني. تم استبدال الحقل "
WatchFace.TapListener.onTap
" بـ "onTapEvent(@TapType tapType: Int, tapEvent: TapEvent)
". بالإضافة إلى ذلك، تمت إزالةInteractiveWatchFaceClient.displayPressedAnimation
. (Id87d2) - تمت إضافة التعليق التوضيحي لسلاسل المحادثات الفاضحة لـ setimportantForAccessibility (I990fa).
- تم نقل إضافة SlotBoundsType إلى androidx-wear-watchface.ComplicationSlotBoundsType في wear/wear-watchface. (I09420)
- وقد أتحنا إمكانية تمرير أرقام تعريف موارد السلسلة إلى إعدادات وخيارات المستخدم. هذه هي الطريقة الموصى بها الآن لإنشاء هذه الكائنات. (I03d5f)
- تم فرض حدود على الحد الأقصى لحجم الأسلاك في مخطط UserStyle. يجب أيضًا ألا تكون الرموز في المخطط أكبر من 400×400 بكسل. (I3b65b)
- أضفنا فئة MutableUserStyle لإتاحة التغييرات على مثيلات UserStyle (I95a40).
- لقد أعدنا تسمية
ListenableWatchFaceMetadataClient.Companion#listenableCreateWatchFaceMetadataClient
إلىListenableWatchFaceMetadataClient.Companion#createListenableWatchFaceMetadataClient
. (I64ce2) - لقد عدّلنا EditorState.previewComplicationsData لكي يتضمّن فقط بيانات للإضافات المفعّلة، وقد أضفنا السمة
EditorSession.DEFAULT_PREVIEW_TIME_MILLIS
التي في حال تمريرها إلى "renderWatchFaceToBitmap
" أو "PreviewScreenshotParams
" تتطلّب عرضها مع وقت المعاينة التلقائي لخلفية شاشة الساعة. (If7b3c) - تمت إزالة دوال الإنشاء UserStyleSet التي تستخدم ChaSequence من واجهة برمجة التطبيقات العامة. يوصى باستخدام الدوال الإنشائية التي تتطلب معرّفات StringResource بدلاً من ذلك. (I8537b)
- تتيح "
CurrentUserStyleRepository.UserStyleChangeListener
" الآن تحويل SAM. (I85989)
الإصدار 1.0.0-alpha19
4 آب (أغسطس) 2021
تم طرح "androidx.wear:wear-*:1.0.0-alpha19
". يحتوي الإصدار 1.0.0-alpha19 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- لقد أضفنا
ListenableWatchFaceMetadataClient.listenableCreateWatchFaceMetadataClient
الذي يوفر برنامج تضمينListenableFuture
لـWatchFaceMetadataClient.createWatchFaceMetadataClient
. (I5fa37) - تقبل الدالة
UserStyleOption.getOptionForId
الآن استخدامUserStyleOption.Id
بدلاً من مصفوفة بايت. (I469be) - توفير الثوابت
BooleanOption.TRUE
وBooleanOption.FALSE
وعدم السماح بإنشاء المثيل (I46e09) - وقد تمت الآن إضافة تعليقات توضيحية إلى الطرق في Wear-watchface-client التي يمكنها طرح RemoteException، وفقًا لذلك. (Ib8438)
- للحفاظ على الاتّساق، أعدنا تسمية "
EditorSession.createOnWatchEditingSession
" إلى "createOnWatchEditorSession
"، وبالتالي أصبح الآن "createHeadlessEditingSession
" هو "createHeadlessEditorSession
". وتمت إعادة تسمية أغلفة الجوافة أيضًا. (I1526b) - أصبحت
EditorSession
الآن واجهة، وتم الآن تفويضListenableEditorSession.commitChangesOnClose
بالشكل المناسب. (I7dc3e) - نرفض الآن أي مخطط نمط مستخدم يحتوي على إعدادات أو خيارات ذات معرّفات متعارضة (Ic2715).
- تمت إضافة
UserStyle.get
محمّل فوق الحد المسموح به ويقبلUserStyleSetting.Id
. (I2aa0f)
الإصدار 1.0.0-alpha18
21 تموز (يوليو) 2021
تم طرح "androidx.wear:wear-*:1.0.0-alpha18
". يحتوي الإصدار 1.0.0-alpha18 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- تم نقل "
ComplicationHelperActivity
" إلى مكتبة "androidx.wear:wear-watchface
". (I39e76) - لتحقيق الاتساق والوضوح، تمت إعادة تسمية
ComplicationProvider
إلىComplicationDataSource
، كما تمت إعادة تسمية جميع الصفوف التي تحمل اسم "مقدِّم الخدمة" باسمها بالطريقة نفسها. (Iaef0b) - تم نقل "
CanvasComplication.isHighlighted
" إلىRenderParameters.pressedComplicationSlotIds
، وهذه خطوة نحو إبقاءCanvasComplication
بدون حالة. لإتاحة هذا التغيير، تستخدم دالةCanvasComplication.render
الآن أيضًاslotId
كمَعلمة، ويتم الآن تمريرComplicationSlot
إلىGlesTextureComplication
. (I50e6e) - لقد أضفنا
headlessDeviceConfig
إلىEditorRequest
، إذا كانت هذه المَعلمة غير فارغة، يتم استخدام هذه المَعلمة لإنشاء مثيل بلا واجهة مستخدم رسومية لإظهار جلسة EditorSession بدلاً من العمل على المثيل التفاعلي. ويتيح ذلك إمكانية استدعاء المحرِّر لخلفية شاشة ساعة غير الخلفية الحالية. (I0a820) - أضفنا
WatchFaceMetadataClient
تجريبيًا يتيح استرداد البيانات الوصفية الثابتة لخلفية شاشة الساعة بشكل فعّال، مثلUserStyleSchema
والتفاصيل الثابتة حولComplicationSlots
. (I6bfdf) - لقد أعدنا تسمية
CanvasRenderer.uiThreadInit
إلى init. (I6fff9) - لقد أضفنا PreviewscreenParams، وهي مَعلمة جديدة اختيارية لخيار EditorRequest، والتي توجِّه تعليمات إلى EditorSession تشير إلى أخذ لقطة شاشة للمعاينة عند التنفيذ باستخدام هذه المَعلمة. يتم عرض صورة المعاينة في
EditorState.previewImage
. (Ic2c16)
إصلاح الأخطاء
- لم يعد المطوّرون بحاجة إلى إضافة AddicationHelperActivity إلى بيانهم. (I6f0c2)
الإصدار 1.0.0-alpha17
30 حزيران (يونيو) 2021
تم طرح "androidx.wear:wear-*:1.0.0-alpha17
". يحتوي الإصدار 1.0.0-alpha17 على هذه الالتزامات.
الميزات الجديدة
في
GlesRenderer
، تم استبدالmakeUiThreadContextCurrent
وmakeBackgroundThreadContextCurrent
بـrunUiThreadGlCommands
وrunBackgroundThreadGlCommands
وكلاهما يقبلRunnable
. تضمن المكتبة تنفيذ أمر GL واحد فقط قابل للتشغيل في أي وقت.لتسهيل بدء إعداد UiThread، أضفنا علامة
CanvasRenderer.uiThreadInit
التي يتم استدعائها مرة واحدة على UiThread قبل أي طلبات ليتم عرضها. أضفنا أيضًاonRendererCreated
إلىCanvasComplication
، ما يسهّل علىRenderer
وCanvasComplication
مشاركة الحالة.للتوضيح، أعدنا تسمية
Complication
إلىComplicationSlot
وcomplicationId
إلىcomplicationSlotId
أوcomplicationInstanceId
بناءً على الاستخدام.
تغييرات واجهة برمجة التطبيقات
- لمزيد من الوضوح، أعدنا تسمية
Complication
إلىComplicationSlot
وcomplicationId
إلىcomplicationSlotId
أوcomplicationInstanceId
بناءً على الاستخدام. بالإضافة إلى ذلك، تمت إعادة تسمية الصفوف التي تستخدم ميزة "الإضافات"، على سبيل المثال: تمت إضافة اسم "ComicationsManager" إلى "التكميلية". (I4da44) - في GlesRenderer
makeUiThreadContextCurrent
وmakeBackgroundThreadContextCurrent
، تم استبدالrunUiThreadGlCommands
وrunBackgroundThreadGlCommands
وكلاهما يقبلRunnable
. هذه الدوال مطلوبة فقط إذا كنت بحاجة إلى إجراء استدعاءات GL خارج العرض،runBackgroundThreadGlCommands
وonUiThreadGlSurfaceCreated
. هذا الإجراء مطلوب لأنّه قد يكون هناك العديد من برامج GlesRenderers متعددة ولكل منها سياقها الخاص في العملية نفسها، وربما من خلفيات مختلفة لشاشة الساعة. بالإضافة إلى ذلك، تتم مزامنة إمكانية الوصول إلى سياق GL الحالي المشترك. (I04d59) - لقد أضفنا
CanvasRenderer.uiThreadInit
الذي يتم طلبه مرة واحدة على UiThread قبل أي طلبات للعرض. وللتوضيح أيضًا في GlesRenderer، أعدنا تسميةonGlContextCreated
إلىonBackgroundThreadGlContextCreated
وonGlSurfaceCreated
إلىonUiThreadGlSurfaceCreated
. (If86d0) - تمت إعادة تسمية
HeadlessWatchFaceClient
وInteractiveWatchFaceClient
getComplicationsSlotState
إلىgetComplicationSlotsState
. فيComplicationSlot
: تمت إعادة تسميةcreateRoundRectComplicationBuilder
وcreateBackgroundComplicationBuilder
وcreateEdgeComplicationBuilder
إلىcreateRoundRectComplicationSlotBuilder
وcreateBackgroundComplicationSlotBuilder
وcreateEdgeComplicationSlotBuilder
على التوالي. (Ib9adc) - لقد أضفنا ميزة onRendererCreated إلى CanvasComplication، والتي تسهّل على العارضين وCanvasComplication مشاركة الحالة. (I5e1ac)
الإصدار 1.0.0-alpha16
16 حزيران (يونيو) 2021
تم طرح "androidx.wear:wear-*:1.0.0-alpha16
". يحتوي الإصدار 1.0.0-alpha16 على هذه الالتزامات.
الميزات الجديدة
- أصلحنا عددًا من الأخطاء المتعلّقة بالتغييرات الأخيرة في نموذج سلاسل المحادثات، بالإضافة إلى حلّ مشاكل أخرى في أداة تعديل خلفية شاشة الساعة.
إصلاح الأخطاء
- منع NPE في
onComplicationProviderChooserResult
(b/189594557) - إصلاح المشاكل المتعلّقة بالأسطح القديمة و drawBlack (b/189452267)
- إصلاح سباق الوصول إلى
complicationsManager.watchState
(b/189457893) - إصلاح الخطأ العمري لسلسلة المحادثات في الخلفية (b/189445428)
- إصلاح مشاكل محرر خلفية شاشة الساعة من Pre-R (b/189126313)
- لا تعدِّل مَعلمات التشغيل المباشر لتغييرات نمط المحرّر (b/187177307)
الإصدار 1.0.0-alpha15
2 حزيران (يونيو) 2021
تم طرح "androidx.wear:wear-*:1.0.0-alpha15
". يحتوي الإصدار 1.0.0-alpha15 على هذه الالتزامات.
الميزات الجديدة
يتم حاليًا إعداد معظم خلفية شاشة الساعة على سلسلة محادثات في الخلفية. ومع ذلك، يتم تنفيذ معظم عمليات عرض خلفية شاشة الساعة وما إلى ذلك على UiThread. هناك حاجز في الذاكرة بين التحميل والعرض، ولذلك لا تحتاج معظم خلفيات شاشة الساعة إلى اتخاذ أي إجراء خاص. وقد تُستثنى خلفيات شاشة الساعة التي تستخدم تقنية GLES من أنّ السياق خاص بسلسلة المحادثات، ونحن ننشئ سياقَين مرتبطَين كي نتمكّن من تحميل موارد GL (مثل الزخارف وعوامل التظليل) على سلسلة التعليمات في الخلفية واستخدامها على UiThread.
لقد قسّمنا إنشاء خلفيات شاشة الساعة إلى ثلاث دوال: createUserStyleSchema وcreateComplicationsManager وcreateWatchFace. نفترض أنّ createUserStyleSchema وcreateComplicationsManager سريعان، وقد يستغرق تحميل مواد العرض createWatchFace بعض الوقت. من خلال الاستفادة من ذلك، قدّمنا خاصية WatchFaceControlClient.getDefaultProviderPoliciesAndType
التي تعرض خريطة لمعرِّفات التطبيق مُركّبة لـ DefaultComplicationProviderPolicies والرمز البرمجي للتكامل النوعي التلقائي. هذا أسرع من إنشاء مثيل بلا واجهة مستخدم رسومية لأنه لا يحتاج إلى الإعداد الكامل لخلفية شاشة الساعة لتنفيذ طلب البحث.
وأخيرًا، يتم إنشاء التعقيدات باستخدام أداة CanvasComplication مرورك التي تسمح بالبناء الكسول لعارضات لوحة الرسم.
تغييرات واجهة برمجة التطبيقات
- تم استبدال "
@TargetApi
" بـ "@RequiresApi
". (I0184a وb/187447093 وb/187447094) - لقد قدّمنا سياسة
WatchFaceControlClient.getDefaultProviderPoliciesAndType
التي تعرض خريطة لمعرّف الإضافات إلى DefaultComplicationProviderPolicies والنوع التلقائي دَهْ مُركَّب. عند الإمكان، يتم استخدام مسار سريع يتجنّب إضافة خلفية شاشة ساعة بشكل كامل. لتسهيل هذه العملية، كان على واجهة برمجة التطبيقات WatchFaceService API تغيير طريقتين جديدتين هما: createUserStyleSchema وcreateComplicationsManager وسيتم نقل نتائجهما إلى createWatchFace. بالإضافة إلى ذلك، يتم الآن إنشاء الإضافات باستخدام أداة CanvasComplication أسعار تتيح البناء الكسول لعارضات لوحة الرسم. (Iad6c1) - تمت إزالة most_Recent_APP من SystemProviders. (I3df00)
- أصبحت MonitorableWatchData الآن فئة جلسات مغلقة. (Ic940d)
- يستدعي الآن CanvasComplication أسعار.create (الذي يكون عادةً مرتبطًا ببروتوكول iOS) في سلسلة محادثات في الخلفية لكل إضافة قبل بدء عرض سلسلة واجهة المستخدم. هناك حاجز في الذاكرة بين عملية الإنشاء والعرض، لذلك ليست هناك حاجة إلى بيانات أولية لسلاسل محادثات خاصة. (Ia18f2)
- يتم الآن إنشاء خلفية شاشة الساعة على سلسلة محادثات في الخلفية على الرغم من أنّ عملية العرض بالكامل تتم على سلسلة واجهة المستخدم، يتيح GlesRenderer سياقَين مرتبطَين لإتاحة ذلك. WatchFaceControlClient.createHeadlesswatchFaceClient وwatchFaceControlClient.getOrCreateInteractiveWatchFaceClient قد يتم حل المشكلة قبل اكتمال WatchFaceService.createWatchFace. سيتم حظر طلبات البيانات من واجهة برمجة التطبيقات اللاحقة إلى أن تكتمل عملية إعداد WatchFace. (Id9f41)
- لم يعُد EXPANSION_DP وSTROKE_WIDTH_DP مرئيين في ملف api.txt. (I54801)
- لقد أجرنا EditorSession.createOnWatchEditingSession طرح SessionCancelException إذا حدث خطأ بدلاً من إرسال جلسة فارغة. بالإضافة إلى ذلك، أصبحت القيمة المعروضة لـ EditorRequest.createFromIntent وEditorSession.createOnWatchEditingSession الآن غيرNull. (I41eb4)
الإصدار 1.0.0-alpha14
18 أيار (مايو) 2021
تم طرح "androidx.wear:wear-*:1.0.0-alpha14
". يحتوي الإصدار 1.0.0-alpha14 على هذه الالتزامات.
الميزات الجديدة
- تعرض دالة
EditorSession.openComplicationProviderChooser
الآن ChosenComplicationProvider الذي يحتوي على معرّف الإضافةComplicationProviderInfo
وحزمة تحتوي على أي إضافات إضافية يعرضها محدد الموفر. - بالإضافة إلى ذلك، نعمل باستمرار على نقل الرموز البرمجية إلى Kotlin، وأصبحت غالبية واجهة برمجة تطبيقات خلفية شاشة الساعة محددة الآن باستخدام Kotlin.
تغييرات واجهة برمجة التطبيقات
- أصبحت السمتان GlesRenderer
eglContext
وeglDisplay
غير قابلتين للقيم. يتم الآن الإبلاغ عن أي أخطاء في GL من خلالGlesRenderer.GlesException
بدلاً من RuntimeExceptions. (Ib1005) - نقلنا
androidx.wear.watchface.complications.rendering.ComplicationDrawable
من Java إلى Kotlin (Ibc3eb). - نقلنا
androidx.wear.watchface.complications.rendering.ComplicationStyle
من Java إلى Kotlin (I3375e). - أضفنا معلومات حول موفّر الإضافات لكل إضافة ضمن EditorSession. (I37f14)
- تم توسيع نتيجة
EditorSession.openComplicationProviderChooser
لتشمل المعلومات التي عرَضَها المستخدم الذي تم اختياره. (Iead6d)
إضافات Wear الإضافات والإصدار 1.0.0-alpha13
5 أيار (مايو) 2021
تم طرح "androidx.wear:wear-*:1.0.0-alpha13
". يحتوي الإصدار 1.0.0-alpha13 على هذه الالتزامات.
الميزات الجديدة
يمكن أن تحتوي خلفيات شاشة الساعة على عناصر مرئية مهمة تتجاوز عرض الوقت والإضافات. لإتاحة إمكانية استخدام قارئ الشاشة لهذا الغرض، يمكن لخلفية شاشة الساعة الآن تحديد ContentDescriptionDescriptions الخاص بأدوات تسهيل الاستخدام من خلال سمة additionalContentDescriptionDescription في العارض. بالإضافة إلى ذلك، تمّت إضافة إمكانية الوصول إلى واجهة برمجة التطبيقات AccessibilityTraversalIndex إلى الإضافات للتحكّم في ترتيب ContentDescriptionlabels. يمكن تعديل هذا الإعداد من خلال AddicationsUserStyleإعداد.
لتشجيع المطورين على التفكير بعناية في برامج قراءة الشاشة، جعلنا حقلي
ShortTextComplicationData.Builder
وLongTextComplicationData.Builder
وRangedValueComplicationData.Builder
contentDescription
إلزاميًا ليتم تمريره إلى الشركات الإنشائية الخاصة بهم. إذا تم تمريرComplicationText.EMPTY
إلىcontentDescription
، سيتم إنشاءcontentDescription
تلقائيًا من النص والعنوان.يطرح تطبيق "
WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient
" الآن الخطأServiceStartFailureException
إذا عرضت خلفية شاشة الساعة استثناءً أثناء عملية الإعداد، ما يسهّل تشخيص المشاكل أثناء بدء تشغيل خلفية شاشة الساعة.
تغييرات واجهة برمجة التطبيقات
- أتحنا إمكانية استخدام اسم مكوِّن فارغ فيComicationProviderInfo، وهذا المكوّن مطلوب لإتاحة الإصدارات القديمة من Wear OS. (I744d2)
- لقد نقلنا
androidx.wear.complications.SystemProviders
من Java إلى Kotlin. (Ia1f8b) - لقد أخفينا كل الفئات من واجهة برمجة التطبيقات العامة المتوفّرة في android.support.wearable.complications وأنشأنا برامج تضمين مقابلة في AndroidX عند الحاجة. (I7bd50)
- لقد أعدنا تسمية الطريقة في
TimeDifferenceComplicationText.Builder
منsetMinimumUnit
إلىsetMinimalTimeUnit
. (I20c64) - لقد جعلنا حقلَي
ShortTextComplicationData.Builder
وLongTextComplicationData.Builder
وRangedValueComplicationData.Builder
contentDescription
إلزاميًا لاجتيازه في الدالة الإنشائية. (I8cb69) - لقد غيّرنا اسم PaymentProviderService.onComplicationUpdate ليصبح على onComplicationRequest وتم تغليف معلَمة المعرف والنوع لهذه الطريقة في بطارية integrationRequest. تمت إعادة تسمية المستمع المقابل إلى integrationRequestListener والأسلوب الخاص به AdjustRequestListener.onComplicationData. (Iaf146)
- أزلنا الطريقة
isActiveAt
منComplicationData
وكشفنا الحقلvalidTimeRange
بدلاً منها. يمكن استبدال استدعاء هذه الطريقة بـvalidTimeRange.contains
. (I65936) - لقد غيَّرنا وصف الطريقة ComplicationProviderService.onComplicationActivated لتلقّي ComplicationType بدلاً من عدد صحيح. (Idb5ff)
- تم نقل ProviderUpdateRequester من Java إلى Koltin. (Ibce13)
- أصبح GlesRender.makeContextCurrent متاحًا للجميع الآن. قد يحتاج رمز خلفية شاشة الساعة إلى إجراء استدعاءات gl خارج Render وonGlContextCreated، ولأنّه قد يكون هناك سياق تفاعلي وبلا واجهة مستخدم رسومية، من الضروري استدعاءه. (I8a43c)
- تعرض WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient الآن على خدمة ServiceStartFailureException إذا تم عرض خلفية شاشة الساعة أثناء الإعداد. بالإضافة إلى ذلك، تعرض ميزة WatchFaceService الآن استثناءً إذا استغرقت عمل createWatchFace مدة أطول من 6 ثوانٍ. (I59b2f)
- لقد أزلنا خاصية المعرّف غير المستخدمة في
GlesTextureComplication
. (I28958) - يمكن لخلفية الساعة الآن تحديد ContentDescriptionLabel الخاص بإمكانية الوصول لتسهيل الاستخدام من خلال سمة additionalContentDescriptionLabel في
Renderer
. بالإضافة إلى التحكّم في ترتيب ContentDescriptionlabel تمت إضافة AccessibilityTraversalIndex إلى الإضافات. يمكن تعديل هذا الإعداد من خلال AddicationsUserStyleإعداد. (Ib7362) - توسيع المستندات حول التعامل مع أحداث اللمس في خلفية شاشة الساعة (Iaf31e)
إصلاح الأخطاء
- تعرض خدمة "
EditorSession.getComplicationsPreviewData()
" الآن خريطة لكل الإضافات غير الفارغة فقط. يتم استخدام مثيل BlankComplicationData في الإضافات الفارغة. (I1ef7e)
إضافات Wear الإضافات والإصدار 1.0.0-alpha12
21 نيسان (أبريل) 2021
تم طرح "androidx.wear:wear-*:1.0.0-alpha12
". يحتوي الإصدار 1.0.0-alpha12 على هذه الالتزامات.
الميزات الجديدة
يجب أن يسلّط محرِّرو خلفية شاشة الساعة الضوء على أجزاء من خلفية شاشة الساعة للمساعدة في تحديد الجانب الذي يتم إعداده من الساعة. لقد وسّعنا نطاق RenderParameters إلى السماح بتسليط الضوء على الأنماط والإضافات. هناك ميزة HighLayer الجديدة الاختيارية التي تم تصميمها أعلى خلفية شاشة الساعة بشفافية ألفا (يمكن لواجهات برمجة تطبيقات لقطات الشاشة إجراء ذلك نيابةً عنك، أو توفير ClickLayer بمفردها لتحقيق أقصى قدر من المرونة). على سبيل المثال، إذا كان لديك نمط يتيح لك ضبط مظهر خلفيات شاشة الساعة، يمكن لبرنامج العرض في واجهة RenderCastLayer أن يرسم مخططًا حولها.
لتشجيع موفّري الإضافة على تسهيل الاستخدام، صنّفنا حقلَي PhotoImageComplicationData.Builder وMonochromaticImageComplicationData.Builder وSmallImageComplicationData.Builder's contentDescription إلى وسيطة إنشائية إلزامية. تمّت إضافة ComputeTapFilter وComication.createEdgeComplicationBuilder لدعم الإضافات المستنِدة إلى الحافة (المرسومة حول حافة الشاشة). في خلفية شاشة الساعة، يتم عرض الإضافات واختبارها على الحافة. لا يتوفّر اختبار نتائج الحافة من المحرِّر المصاحب.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة البادئة
PROVIDER_
إلى الثوابت في SystemProviders. (I1e773) - لقد جعلنا حقل
PhotoImageComplicationData.Builder
وMonochromaticImageComplicationData.Builder
وSmallImageComplicationData.Builder
'scontentDescription
إجباريًا في الدالة الإنشائية. (I9643a) - تمت إعادة تسمية
ProviderInfoRetriever.requestPreviewComplicationData
إلىretrievePreviewComplicationData
. (I911ee) - تم نقل بيانات
ComplicationProviderService
من Java إلى Koltin. (I849f2) - الطريقة
ComplicationProviderService.onBind
هي الآن نهائية (I39af5) - لقد أعدنا الواجهة
CanvasComplication
ونقلناCanvasComplicaitonDrawable
وGlesTextureComplication
وComplicationHighlightRenderer
إلىwear-watchface-complications-rendering
. (I84670) - تمت إعادة هيكلة "
RenderParameters
" لإتاحة عرض لقطات مميّزة ممتدّة. أصبح من الممكن الآن طلب عرض النصوص المميّزة للأنماط بالإضافة إلى كلّ إضافة أو إضافة واحدة. بالإضافة إلى ذلك، CanvasRenderer وGlesRenderer، كيف تم استخدام طريقة جديدة مجرّدة لتسليط الضوء على PinpointLayer لعرض أي تمييز يطلبه المحرِّر. تمت إعادة تسمية الطبقة إلى WatchFaceLayer. (Ic2444) - تمت إضافة
ComplicationTapFilter
وComplication.createEdgeComplicationBuilder
لإتاحة الإضافات الطرفية. في خلفية شاشة الساعة، يتم عرض الإضافات واختبارها على الحافة. لا يتوفّر اختبار النتائج من داخل المحرّرين. (Ia6604) - بالنسبة إلى
DoubleRangeUserStyleSetting
وLongRangeUserStyleSetting
: أصبحتdefaultValue
وmaximumValue
وminimumValue
مواقع بلغة Kotlin. بالإضافة إلى ذلك، تمت إزالة الدوالUserStyleSetting.Option
مثل toBooleanOption وtoCoplicationOptions وtoListOption وغيرها. (I52899) - أضِف حجم الذقن إلى خصائص الجهاز المتاحة في خلفية شاشة الساعة. (I76e1e)
- تقبل الدالة الإنشائية
ComplicationHighlightRenderer
الآن المعلمتَينoutlineExpansion
وoutlineStrokeWidth
. (I87009) ComplicationDrawable.getNoDataText
هو الآن جزء من واجهة برمجة التطبيقات العامة. (I00598)
الإصدار 1.0.0-alpha11
7 نيسان (أبريل) 2021
تم طرح "androidx.wear:wear-*:1.0.0-alpha11
". يحتوي الإصدار 1.0.0-alpha11 على هذه الالتزامات.
الميزات الجديدة
- تم تطبيق المزيد من التحسينات على واجهات برمجة تطبيقات خلفية شاشة الساعة. تتمثل معظم التغييرات في إعادة تسمية بسيطة، ولكن تم دمج
InteractiveWatchFaceWcsClient
وInteractiveWatchFaceSysUiClient
فيInteractiveWatchFaceClient
.
تغييرات واجهة برمجة التطبيقات
- أصبحت ContentDescriptionLabel.text الآن مكمّلة نصية بدلاً من مكتبة الدعم القديمة القابلة للارتداء Time{7}entText. (I80c03)
- لا يمكن ضمان توفُّر الجهاز
SystemProviders.GOOGLE_PAY
على جميع أجهزة Android R، لذلك تمت إزالته من القائمة. لا يزال من الممكن استخدام مقدّم الخدمة هذا من خلالDefaultComplicationProviderPolicy
(If01b5) - لقد أعدنا تسمية ComputeUpdateCallback إلى لتبدأ بالموافقة علىضمن السياسة. (I61ec7)
- تم تغيير تنسيق الشبكة المستخدَم في UserStyle إلى
Map<String, byte[]>
. ولتسهيل الأمر، تمت إضافة صفUserStyleData
إلى واجهة برمجة التطبيقات العامة ويتم استخدامه الآن من خلال wear-watchface-client وwear-watchface-editor. وبالإضافة إلى ذلك، أصبحت CustomValueUserStyle Setting.CustomValueOption.value الآنbyte[]
بدلاً منString
. (Iaa103) - يستخدم
UserStyleSetting
وUserStyleSetting.Option
الآنUserStyleSetting.Id
وUserStyleSetting.Option.Id
على التوالي لتخزين رقم تعريفيهما بدلاً من سلسلة. (I63f72) - تمت إعادة تسمية
InteractiveWatchFaceClient.SystemState
إلىWatchUiState
. (I6a4e0) - تم دمج
InteractiveWatchFaceWcsClient
وInteractiveWatchFaceSysUiClient
لأنه كان من الصعب شرح عملية تقسيم المسؤولية (Iff3fa) - تمت إعادة تسمية قيم تعداد الطبقات للتوضيح. أصبحت
Layer#TOP_LAYER
الآنLayer#COMPLICATIONS_OVERLAY
وLayer#BASE_LAYER
أصبحتLayer#BASE
(Ia144e). - تمت إعادة تسمية "
UserStyleListener
" إلى "UserStyleChangeListener
" (I18524). - تمت إعادة تسمية "
UserStyleRepository
" إلى "CurrentUserStyleRepository
" (I6ea53). - تمت إعادة تسمية
InteractiveWatchFaceWcsClient.updateInstance
إلىupdateWatchfaceInstance
. (I321dc) - تمت إعادة تسمية أحداث نوع النقر لشاشة الساعة لتتوافق مع أحداث MotionEvent / Compose. (I0dfd0)
- تمت إعادة تسمية TakeWatchfaceلقطات الشاشة لتصبح بإصدار RenderWatchFaceToBitmap، كما تمت إعادة تسمية أخذ لقطة شاشة أخذ لقطة شاشة إلى RenderComplicationToBitmap (Ie0697).
- تمت إزالة واجهة CanvasComplication لصالح الفئة المفتوحة CanvasComplicationDrawable. (I1f81f)
- تمت إزالة
WatcfaceControlServiceFactory
من واجهة برمجة التطبيقات العامة. (I1f8d3) - أعدنا تسمية
CanvasComplication.setData
إلىCanvasComplication.loadData
. (If1239) - تمت إعادة تسمية
ComplicationsManager.bringAttentionToComplication
إلىdisplayPressedAnimation
. (Ic4297) - لدى "
WatchFaceService.createWatchFace
" الآن تعليق توضيحي@UiThread
. (Ib54c2) - تم تغيير اسم مَعلمة CanvasComplicationDrawable لإصلاح خطأ. (I50dac)
- لقد أضفنا
HeadlessWatchFaceClient.toBundle()
وHeadlessWatchFaceClient.createFromBundle
لإتاحة إرسالHeadlessWatchFaceClient
عبر AIDL. (I07c35) - أصبح لدى كل من HeadlessWatchFaceClient و InteractiveWatchFaceClient الآن استخدام ClientDisableListener وisConnectionAlive() للسماح لك بمراقبة ما إذا كان الاتصال معطلاً لسبب ما (على سبيل المثال، قطع خلفية شاشة الساعة). (Ie446d)
- أصبحت
WatchFaceControlClient#getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClientAsync
الآن دالة تعليق وتمت إعادة تسميتها إلىgetOrCreateInteractiveWatchFaceClient
. (Ib745d) - تمت إعادة تسمية
EditorState.commitChanges
وhasCommitChanges()
إلىshouldCommitChanges()
. (I06e04) - تمت إعادة تسمية
previewComplicationData
إلىpreviewComplicationsData
للإشارة إلى وجود أكثر من إضافة واحدة في الخريطة (عادةً). (I56c06) - تمت إعادة تسمية "
InteractiveWatchFaceWcsClient.bringAttentionToComplication
" إلى "displayPressedAnimation
" للحفاظ على توافقه مع "ComplicationsManager.displayPressedAnimation
". (Ic9999) - تم تضمين جميع مثيلات رقم تعريف مثيل خلفية شاشة الساعة في فئة WatchFaceId جديدة (I45fdf)
- تمت إعادة تسمية السمة
complicationState
إلىcomplicationsState
للإشارة إلى تعدُّد التعدد. (Ided07) - لقد أزلنا الإحالات الناجحة المختلفة لصنف Binder على خلفية شاشة الساعة والعميل، لذا يجب أن تكون ضرورية. (Icc4c0)
- لتحقيق الاتساق، تمت إعادة هيكلة
EditorServiceClient
لاستخدام المستمعين بدلاً من المراقبين. (Iec3a4) - لقد أضفنا تعليقات
@Px
توضيحية غير موجودة إلىInteractiveWatchFaceSysUiClient
وWatchFaceControlClient
. (I3277a) - تم تغيير اسم EditorMonitorerCallback إلى EditorMonitorerListener للحفاظ على التناسق. (Ie572d)
- يقتصر الإصدار EditorState.watchFaceInstanceId على مستوى واجهة برمجة التطبيقات Android R API والإصدارات الأحدث، ولا يمكن أن يكون صالحًا بعد الآن. (Id52bb)
- تمت إعادة تسمية
EditorSession.launchComplicationProviderChooser
إلىopenComplicationProviderChooser
. (I9d441) - تمت إعادة تسمية
EditorSession.createOnWatchEditingSessionAsync
إلىcreateOnWatchEditingSession
وهي الآن وظيفة تعليق. (Id257b) - تمت إضافة العديد من تعليقات
@UiThread
التوضيحية المفقودة إلىEditorSession
. (I6935c) - تمت إعادة تسمية
UserStyleSetting.affectsLayers
إلىaffectedLayers
. (I6e22b)
الإصدار 1.0.0-alpha10
24 آذار (مارس) 2021
تم طرح "androidx.wear:wear-*:1.0.0-alpha10
". يحتوي الإصدار 1.0.0-alpha10 على هذه الالتزامات.
الميزات الجديدة
- أصبح بالإمكان الآن إنشاء كائنات gl مباشرة (مثل الزخارف) أثناء WatchFaceService.createWatchFace لأن GlesRenderer يتطلب الآن استدعاءًا صريحًا إلى initOpenGLContext والذي يمكن تنفيذه داخل createWatchFace.
تغييرات واجهة برمجة التطبيقات
- كانت واجهة برمجة التطبيقات
IdAndComplicationData
غريبة بعض الشيء وتمت إزالتها من واجهة برمجة التطبيقات العامة. تمت إعادة هيكلة الصفوف والواجهات التي تم استخدامها. (I4c928) - لقد استبدلنا
ReferenceTime
بـCountUpTimeReference
وCountDownTimeReference
وهما أكثر وضوحًا. (Ib66c6) - تمت إضافة بعض التعليقات التوضيحية
@Px
و@ColorInt
غير المتوفّرة. (I9bbc3) Complication.complicationConfigExtras
الآن غير قابل للقيم ويتم ضبطه تلقائيًا علىBundle.EMPTY
. (Iad04f)- يطلُب منك "
GlesRenderer
" الآن الاتصال برقم "initOpenGLContext
" بعد البناء. كانت هذه الدالة من التفاصيل الداخلية، ولكنّها متوفّرة الآن في واجهة برمجة تطبيقات متاحة للجميع من أجل السماح باستدعاءات GL في وقت سابق داخل createWatchFace. (I726c2) - أزلنا
Complication.setRenderer
لعدم الحاجة إليه. (Ie992f) - لم يعُد
Complicaiton.setComplicationBounds
جزءًا من واجهة برمجة التطبيقات العامة. إذا كنت بحاجة إلى تعديل موضع الإضافة، يمكن القيام بذلك من خلالComplicationsUserStyleSetting
. (Ibd9e5) - تمت إعادة تسمية
ComplicationsManager.TapCallback.onComplicationSingleTapped
إلىonComplicationTapped
. (I3a55c) - تمت إعادة تسمية
ComplicationOutlineRenderer.drawComplicationSelectOutline
إلىdrawComplicationOutline
. (I14b88)
الإصدار 1.0.0-alpha09
10 آذار (مارس) 2021
تم طرح androidx.wear:wear-complications-*:1.0.0-alpha09
وandroidx.wear:wear-watchface-*:1.0.0-alpha09
. يحتوي الإصدار 1.0.0-alpha09 على هذه الالتزامات.
الميزات الجديدة
- تطورت الواجهة بين مضيف WCS/SysUI والخلفية على خلفية شاشة الساعة. وأصبح بإمكان المحرِّر الآن تحديد ما إذا كان تغيير النمط سيؤدّي إلى تفعيل إضافة أو إيقافها (مفعَّلة = "في البداية" بالإضافة إلى أيّ تجاوز من "ComicationsUserStyleConfiguration"). بالإضافة إلى ذلك،
EditorService.closeEditor
يسمح هذا الإذن لنظام SysUI بإغلاق محرِّر خلفية شاشة الساعة عن بُعد إذا لزم الأمر. - بالإضافة إلى
InteractiveWatchFaceWcsClient.setUserStyle
، يمكنك استخدام أمر أكثر فعاليةupdateInstance
وهو: يغيّر رقم تعريف المثيل، وإعداد النمط، وإزالة الإضافات دفعة واحدة.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة تتبع الأحداث إلى مكتبات خلفية شاشة الساعة. (I1a141)
- تمت إضافة السمة
initiallyEnabled
الجديدة فيComplicationState
الآن، وهي مفيدة لتوقّع النتائج المترتبة على تبديل الأنماط. (I8c905) - لقد استبدلنا
InteractiveWatchFaceWcsClient.setUserStyle
بأمر أكثر فعاليةupdateInstance
وهو: يغيّر رقم تعريف المثيل، وإعداد النمط، ومحو الإضافات. (Ife6f6) - لم تعُد واجهات برمجة التطبيقات لأخذ لقطات الشاشة في WatchFaceClient تضغط على لقطات الشاشة لأنّ ذلك كان بطيئًا، بدلاً من ذلك، نترك أي معالجة للمشاركات على المتصل. (Id35af)
- يمكن الآن إغلاق محرّر خلفية شاشة الساعة عن بُعد باستخدام
EditorService.closeEditor
. (Ic5aa4) - تعليقات توضيحية مُضافة حول إمكانية القيم الفارغة (Ic16ed)
الإصدار 1.0.0-alpha08
24 شباط (فبراير) 2021
تم طرح "androidx.wear:wear-*:1.0.0-alpha08
". يحتوي الإصدار 1.0.0-alpha08 على هذه الالتزامات.
الميزات الجديدة
- وقد تم تصميم بعض خلفيات شاشة الساعة لاعتماد إضافة محدّدة واحدة أو أكثر. ولدعم هذه الميزة، أضفنا Conication.Builder#setFixedComplicationProvider الذي إذا تم ضبطه على "صحيح" سيمنع المستخدم من تغيير الإضافة في تلك الخانة.
- مكتبات خلفية شاشة الساعة هي لغة Kotlin أولاً وتستخدم الكوروتينات (مثل دوال التعليق). بالنسبة إلى مستخدمي Java، وفّرنا برامج تضمين ListenableFuture لتحسين إمكانية التشغيل التفاعلي في المكتبات التالية: wear/wear-watchface-guava وwear/wear-watchface-client-guava وwear/wear-watchface-editor-guava.
تغييرات واجهة برمجة التطبيقات
- لقد ألغينا إتاحة النقرات المزدوجة على الإضافات التي تشغّل أداة اختيار موفّر الخدمة، ولم تكن هذه الميزة شائعة في خلفيات شاشة الساعة ولم تكن معقّدة عملية تنفيذ SysUI. (I3ef24)
- قد تتسبب طرق ProviderInfoRetriever في عرض ServiceUnsubscribeedException في حال إغلاق المجلّد بشكلٍ غير متوقَّع. (Ib2cc4)
- بدايةً من نظام التشغيل Android 11 والإصدارات الأحدث، هناك قيود مفروضة على إمكانية تشغيل ProviderChooser، بالإضافة إلى أنّنا نرغب في إنشاء أدوات التحرير باستخدام
wear-watchface-editor
الجديد، لذلك تتم إزالة AdjustHelperActivity من واجهة برمجة التطبيقات المتاحة للجميع. (Ib19c1) - قم بإزالة طرق integrationText الثابتة لصالح أدوات الإنشاء. (Ibe399)
- طرحنا برامج تضمين Guava ListenableFuture لمختلف الطرق التي تم تعليقها في مكتبة خلفية شاشة الساعة. (I16b2c)
- لتوضيح واجهة برمجة التطبيقات، أضفنا دالة إنشاءية ثانوية إلى مَعلمات RenderParameters، والتي لا تتطلب درجات لونية، لاستخدامها مع LayerModes (أوضاع LayerModes) بخلاف
LayerMode.DRAW_OUTLINED
. (I497ea) - في السابق، كانت ListUserStyleSet مختلفة عن الأخرى لأنّها كانت تضم وسيطة تلقائية. الآن، تأخذ جميع الدالة الإنشائية للفئة الفرعية StyleConfiguration القيمة الافتراضية أخيرًا. (I9dbfd)
- تمت إعادة هيكلة CanvasComplication إلى أن يستخدم طريقة مخفية، ما يجعل من السهل تنفيذ فئة فرعية (I5b321)
- لقد أعدنا هيكلة أداة EditorResult لتحل محلها إصدار EditorService الجديد و
EditorSession.broadcastState()
لبث التحديثات إلى أحد المراقبين (عادةً SysUI). (Ic4370) - بعض خلفيات شاشة الساعة تم تصميمها باعتماد إضافة معيّنة كجزء لا يتجزأ من خلفية شاشة الساعة حيث لا يمكن للمستخدمين ضبط إعدادات التطبيق. لتوفير الدعم، أضفنا
Complication.Builder#setFixedComplicationProvider
. (I4509e) - يحدد "EditorRequest" الآن اسم الحزمة بدلاً من ComponentName لأنه من غير الملائم أن تبحث SysUI عن اسم فئة المحرر، ونحتاج في الحقيقة إلى اسم الحزمة فقط. (Ib6814)
الإصدار 1.0.0-alpha07
10 شباط (فبراير) 2021
تم طرح "androidx.wear:wear-*:1.0.0-alpha07
". يحتوي الإصدار 1.0.0-alpha07 على هذه الالتزامات.
الميزات الجديدة
- أصبحت WatchFaceService.createWatchFace الآن وظيفة تعليق، ما يعني أن خلفية شاشة الساعة لم تعُد بحاجة إلى حظر سلسلة تعليمات واجهة المستخدم أثناء انتظار طلب الإدراج. تطبيقات مماثلة
تغييرات واجهة برمجة التطبيقات
- يمكنك إزالة فئة PhotoImage واستخدام الرمز مباشرةً. (I8a70b)
- اشرَح قيمة validTimeRange الخاصة بسمة AdjustData. (I91366)
- اجعل السمات التي تشبه الصور أكثر وضوحًا. (I81700)
- تمت إعادة هيكلة أداة تعديل خلفية شاشة الساعة وبيانات ملحقات ارتداء الجهاز لاستخدام دوال التعليق بدلاً من الكوروتينات. برامج تضمين Rx java وFuture التي يجب اتباعها. (If3c5f)
- يعرض مقدم الخدمة الآن PreviewNotAvailableException إذا لم تتمكّن requestPreviewComplicationData من عرض بيانات المعاينة بسبب مشاكل في الاتصال أو بسبب عدم توفُّر إمكانية استخدام واجهة برمجة التطبيقات. (I4964d)
- WatchFaceControlService::createWatchFaceControlClient الآن كخدمة معلَّقة، وأصبح الحصول على getOrCreateCircleServiceServiceBackedInteractiveWatchFaceWcsClient الآن باسم getOrCreateBackgroundServiceBackedInteractiveWatchFaceWcsClientAsync أثناء الرجوع إلى
Deferred<InteractiveWatchFaceWcsClient>
. برامج تضمين RX java وFuture التي يجب اتباعها. (I5d461) - إعادة تسمية "
CATEGORY_PROVIDER_CONFIG_ACTION
" إلى "CATEGORY_PROVIDER_CONFIG
". (I7c068) - يُرجى ملاحظة أنّ createOnWatchEditingSession قد أصبح الآن وظيفة معلّقة لأنّ خلفية شاشة الساعة لا تكون متاحة أحيانًا إلا بعد بدء نشاط المحرّر بفترة وجيزة. (Ida9aa)
- أصبحت WatchFaceService.createWatchFace الآن وظيفة تعليق تسمح بالتهيئة غير المتزامنة، وكان يتعين عليك في السابق حظر سلسلة التعليمات الرئيسية. (If076a)
- يتضمّن UserStyle الآن عامل تشغيل مصفوفة وقد أضفنا مساعدين للبث إلى UserStyle.Option. (I35036)
- لقد أصلحنا خطأً تنظيميًا باستخدام تنسيقات الأسلاك في UserStyle لتغيير بعض واجهات برمجة التطبيقات المخفية غير المستقرة. (I8be09)
- أضفنا CustomValueUserStyleإعداد التي تتيح لك تخزين سلسلة خاصة بتطبيق واحد ضمن UserStyle. وستتجاهل أدوات تعديل خلفية شاشة الساعة التلقائية هذه القيمة. (Ic04d2)
- لا يتم تمرير InstanceID في العناصر الإضافية للأهداف R والإصدارات الأقدم من Android WearOS التي لا يمكننا ترقيتها. ولدعم ذلك، نسمح الآن بأن يكون معرّف InstancID فارغًا. (Id8b78)
- يشتمل EditorRequest الآن على المحرِّر ComponentName الذي تم ضبطه كمكوّن في WatchFaceEditorContract.createIntent (I3cd06).
- تشتمل نتيجة "Editorface" (النتيجة) لخلفية شاشة الساعة الآن على معاينة إضافةً إلى بيانات التطبيق للسماح للمتصل بأخذ لقطة شاشة لخلفية شاشة الساعة بعد إجراء التعديل. (I2c561)
إصلاح الأخطاء
- تمت إضافة toString() لإلغاءات إلى UserStyle وUserStyleSet وUserStyleSchema مما يجعل العمل مع هذه الفئات أفضل قليلاً. (I9f5ec)
الإصدار 1.0.0-alpha06
27 كانون الثاني (يناير) 2021
تم طرح "androidx.wear:wear-*:1.0.0-alpha06
". يحتوي الإصدار 1.0.0-alpha06 على هذه الالتزامات.
الميزات الجديدة
- طرحنا أداة تعديل جديدة لارتداء خلفية شاشة الساعة على شاشة الساعة تتيح لمطوّري خلفيات شاشة الساعة والمصنّعين الأصليين للأجهزة إمكانية تصميم أداة تعديل للأنماط والإضافات. سترسِل SysUI هدفًا إلى خلفية شاشة الساعة التي ستستخدِم فئة EditorSession الجديدة للوصول إلى تفاصيل WatchFace وتسجيل النتيجة من خلال Activity.setWatchRequestResult. ولدعم ذلك، أضفنا ProviderInfoRetriever.requestPreviewComplicationData الذي يسمح لمحرّري خلفية شاشة الساعة بطلب معاينة التطبيق. وتكمن ميزة معاينة التطبيق المكمّل للبيانات في التطبيق الجديد، فلا داعي للقلق بشأن عرض مربّعات حوار الأذونات عند عرض المحرِّر (يُرجى العلم أنّه في حال اختار المستخدم مقدّم خدمة لديه إذن، سيُطلب منه منح هذا الإذن).
تغييرات واجهة برمجة التطبيقات
- تحتوي ميزةComicationProviderInfo على حقل لمكوّن ComponentName الخاص بموفّر الخدمة، وستتم إضافة إتاحة هذا الحقل إلى نظام التشغيل WearOS في وقت لاحق، وسيكون فارغًا إلى ذلك الوقت. (Id8fc4)
- لقد أضفنا ProviderInfoRetriever.requestPreviewComplicationData الذي يسمح لمحرِّري خلفية شاشة الساعة بطلب معاينة التطبيق. يُعدّ هذا الإجراء مفيدًا لأنّ الإضافات المباشرة قد تتطلّب أذونات، ويمكنك الآن عرض بيانات المعاينة للإضافات غير النشطة. (I2e1df)
- أصبحت هذه المَعلمةComicationManager معلَمة اختيارية في الدالة الإنشائية لشاشة الساعة، وقد تمت إعادة ترتيب الوسيطات للسماح بذلك. (I66c76)
- لقد أضفنا حزمة اختيارية إلى "الإضافات" والتي في حال دمجها في الغرض الذي تم إرساله لتشغيل نشاط أداة اختيار الموفِّر. (Ifd4ad)
- أضفنا مكتبة
wear-watchface-editor
جديدة لتوفيرها على خلفية شاشة الساعة وأدوات التحرير المستضافة في SysUi. ستشغّل SysUI أدوات التحرير هذه من خلال إرسال هدف. يمكن لخدمة نشاط خلفية شاشة الساعة استخدام فئة EditorSession الجديدة للوصول إلى تفاصيل WatchFace وتسجيل النتيجة من خلال Activity.setWatchRequestResult. (I2110d) - يُطلق على LayerMode.DRAW_HIGHlightED اسم LayerMode.DRAW_OUTLINED الآن اسم RenderParameters.highlightComplicationId على RenderParameters.selectedComplicationId الذي يسلّط الضوء على الإضافة المحدّدة بالإضافة إلى المخطط التفصيلي. (I90a40)
- يمكن الآن لمستقبل WatchFaceControlClient.getOrCreatebackgroundServiceBackedInteractiveWatchFaceWcsClient استخدام الخدمة ServiceStartFailureException إذا توقفت الخدمة أثناء انتظار إنشاء خلفية شاشة الساعة. (I0f509)
- تم تغيير وظيفة "EditorSession.complicationPreviewData" الآن إلى نموذج ListenableFuture، لأنّ عملية جلب هذه البيانات تتم غير متزامنة. (Iead9d)
إصلاح الأخطاء
- نعمل على إزالة الحقول غير المستخدَمة من BComicationOverlay إلى جانب تفعيل "مفعَّلة" و"complicationBounds". (I17b71)
الإصدار 1.0.0-alpha05
13 كانون الثاني (يناير) 2021
تم طرح "androidx.wear:wear-*:1.0.0-alpha05
". يحتوي الإصدار 1.0.0-alpha05 على هذه الالتزامات.
الميزات الجديدة
غالبًا ما تتيح خلفيات شاشة الساعة عددًا من إعدادات الإضافات مع عرض أعداد مختلفة من الإضافات. لتسهيل عملية الإعداد، نتيح الآن استخدام الإضافات التي تم إيقافها مبدئيًا عن طريق استدعاء setEnabled(false) في أداة الإنشاء. ويمكن تفعيل هذه الإعدادات لاحقًا من خلال BComicationsUserStyleConfiguration.
تغييرات واجهة برمجة التطبيقات
- تقبل هذه الخدمة integrationHelperActivity الآن استخدام
Collection<ComplicationType>
بدلاً من مصفوفة int، ما يجعلها أسهل في الاستخدام. (I1f13d) - تعرض "
ProviderInfoRetriever.retrieveProviderInfo
" الآن قيمة "ListenableFuture<ProviderInfo[]>
" على النحو الصحيح. (If2710) - يمكنك الآن إنشاء إضافة تم إيقافها مبدئيًا عن طريق استدعاء setEnabled(false) في أداة الإنشاء. (Idaa53)
- أصبحت ميزة WatchFaceState الآن تحتوي على الخاصية isHeadless، وهي صالحة فقط للمثيلات بلا واجهة مستخدم رسومية. (Ifa900)
- تتيح لك وظيفةComication Drawable الآن التحميل المتزامن للعناصر القابلة للرسم بشكل اختياري. يتم استخدام هذا من خلال واجهات برمجة تطبيقات لقطات الشاشة. (I34d4a)
الإصدار 1.0.0-alpha04
16 كانون الأول (ديسمبر) 2020
تم طرح "androidx.wear:wear-*:1.0.0-alpha04
". يحتوي الإصدار 1.0.0-alpha04 على هذه الالتزامات.
الميزات الجديدة
- تتيح لك مكتبة خلفية شاشة الساعة الآن ضبط حدود لكل نوع. على سبيل المثال، يمكنك التبديل إلى مربع حدود واسع لـ AddicationType.long_TEXT بينما تستخدم مربع حدود أصغر للأنواع الأخرى.
تغييرات واجهة برمجة التطبيقات
- تستخدم الإضافات الآن فيComicationBounds حيث يتم لفّ
Map<ComplicationType, RectF>
لتوفير أحجام كل نوع من أنواع الإضافة. (I1ebe7) - تتيح لك مَعلمات RenderParameters الآن تحديد درجة اللون الداكنة لاستخدامها في لقطات الشاشة. (Iff42b)
- باستثناء الحدود، يتعين عليك الآن استخدام Payment التكميلية من أجل تعديل التعقيدات، وهذا لضمان بقاء نظام التشغيل متزامنًا. (I8dc5d)
- أصبح العارض الآن فئة مغلقة وهذا يعني أن CanvasRenderer وGlesRenderer أصبحا الآن فئات داخلية في Renderer. (Iab5d4، b/173803230)
- تمت إعادة تسمية CanvasComplicationable.drawhighlight على drawOutline. هناك الآن بعض تعليقات UiThread التوضيحية المفقودة في MonitorableWatchData. تمت الآن إزالة ScreenState بالكامل من WatchState. (If1393)
- الحدّ الأدنى لمستوى واجهة برمجة التطبيقات لواجهة برمجة التطبيقات يمكن الآن استخدامه لخلفية شاشة الساعة هو 25 مستخدمًا. تجدر الإشارة إلى أنّ إتاحة لوحة تصميم الأجهزة يتطلّب المستوى 26 من واجهة برمجة التطبيقات أو المستويات الأعلى. (Ic9bbd)
- يتوفّر الآن مساعد getComplicationIdAt لـ InteractiveWatchFaceWcsClient. (I05811)
- تم تقليل مستوى واجهة برمجة التطبيقات الخاص بعميل Wear-watch- الخاص بـ 25 إلى 25، ولكن تتطلب واجهات برمجة التطبيقات التي تعرض لقطة الشاشة المستوى 27 من واجهة برمجة التطبيقات. (Id31c2)
إصلاح الأخطاء
- نكشف الآن لأحد مكونات التطبيق المكمّل للإضافة في مُركّب الفعل هذا في إضافةً السياسة. (I9b390)
- تم توفير طريقة "bringAttentionToComplication" لتسليط الضوء بإيجاز على الإضافة المحدّدة في InteractiveWatchFaceWcs. (I6d31c)
- هناك حمل زائد حاليًا على
InteractiveWatchFaceWcsClient#setUserStyle
يقبل الخريطة<string, string="">، ما قد يؤدي إلى تجنُّب إرسال ذهاب وعودة إضافي في الوقت الفعلي واللازمة لإنشاء UserStyle. (I24eec)</string,>
الإصدار 1.0.0-alpha03
2 كانون الأول (ديسمبر) 2020
تم طرح "androidx.wear:wear-*:1.0.0-alpha03
". يحتوي الإصدار 1.0.0-alpha03 على هذه الالتزامات.
الميزات الجديدة
أصبح لفئة "الإضافات" الآن خاصية CompicationData تتيح لخلفيات شاشة الساعة ملاحظة التغييرات التي تم إجراؤها على AdjustData. وهذا يجعل من الممكن تغيير أبعاد الإضافة بناءً على نوع الإضافة.
يمكن الآن استخدام عدد اللقطات المتغيّر في الثانية من خلال تحديد قيمة Renderer.interactiveDrawModeUpdateDelayMillis. وبالنسبة لخلفيات شاشة الساعة التي تستخدم رسوم متحركة قصيرة كل ثانية، يمكن أن يؤدي ذلك إلى توفير الطاقة بشكل جيد من خلال الانتقال إلى وضع السكون بدون تأثيرات حركية.
تغييرات واجهة برمجة التطبيقات
- تمت إعادة تسمية "
BACKGROUND_IMAGE
" إلى "PHOTO_IMAGE
"، بالإضافة إلى الصفوف ذات الصلة. لا يُستخدم هذا النوع من الإضافات حصريًا للخلفيات، وبالتالي تغيّر اسمها. (I995c6) - تمت إضافة تعليقات توضيحية بشكل صحيح إلى DefaultComplicationProviderPolicy باستخدام IntDefs. (I3b431)
- لم تعُد الفئة Time{7}entText المخفية مكشوفة عبر ContentDescriptionLabel، وبدلاً من ذلك أضفنا موصّلاً للحصول على النص في وقت محدّد. (Ica692)
- أصبحت الدالة الإنشائية لـ MonitorableWatchData داخلية الآن. (I30121، b/173802666)
- تحتوي الإضافة الآن على compicationData تُتيح لخلفيات شاشة الساعة ملاحظة التغييرات التي تطرأ على AddicationData. تحتوي الإضافة أيضًا على استدعاء isActiveAt جديد يمكن استخدامه لمعرفة ما إذا كان يجب عرض أي عنصر في التاريخ والوقت المقدَّم. (Ic0e2a)
- لم تعُد واجهة برمجة التطبيقات
SharedMemoryImage
الفارغة متوفّرة في واجهة برمجة التطبيقات العامة. (I7ee17) - يشتمل
WatchFace.overridePreviewReferenceTimeMillis
الآن على تعليق توضيحي IntRange ولهما أسماء متسقة للدالة getter وsetter. (Ia5f78) - تم إنشاء
Complication.Builder
الآن من خلالComplication.createRoundRectComplicationBuilder
أوComplication.createBackgroundComplicationBuilder
لمزيد من الوضوح (I54063). - تمت إضافة WatchFace.TapListener الذي يتيح لشاشة الساعة إمكانية رصد النقرات التي لا تستهلكها الإضافات. (Ic2fe1، b/172721168)
- تتيح خلفية شاشة الساعة الآن استخدام عدد لقطات متغير في الثانية من خلال التخصيص إلى
Renderer.interactiveDrawModeUpdateDelayMillis
. ويمكن أن يساعد ذلك في الحفاظ على عمر البطارية عن طريق النوم في حال عدم تحريك الجهاز. (I707c9) - لم تعُد هناك حاجة إلى WatchFace.Builder وتم نقل "in فرض()" و"UpdateRateMillis" التفاعلي إلى العارض. (I329ea)
- لتحسين إمكانية التشغيل التفاعلي لJavaScript، أعادت تسمية رموز Geters للخصائص المنطقية في WatchState (I6d2f1).
- تم تغيير اسم TapListener إلى TapCallback وProtectateCallback إلى أثناء إلغاء الصلاحية للاتّساق. (I9414e)
- تم نقل خيارات تصميم خلفية شاشة الساعة Wear 2.0 إلى فئتها الخاصة من أجل الوضوح. تتوفر الآن حروف متماثلة في فئة WatchFace.لمستخدمي أدوات الإنشاء. (Iefdfc)
- تمت إضافة InteractiveWatchFaceWcsClient و
WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient
، ويمكن إما الحصول على مثيل موجود أو إنشائه بعد ربط خدمة Wallaper وإنشاء المحرّك. (Id666e) - أصبحت WatchFaceControlClient الآن واجهة تسمح للاختبارات أن تجعلها محاكاة لها. (I875d9)
- أصبحت HeadlessWatchFaceClient و InteractiveWatchFaceSysUiClientImpl و InteractiveWatchFaceWcsClient الآن واجهات لتسهيل الاختبار بشكل أفضل. (I7cdc3)
- تمت إضافة تعليقات توضيحية إلى الطرق في
wear-watchface-complications-rendering
(I0d65c)
إصلاح الأخطاء
- إزالة شكل الشاشة من DeviceConfig، الذي كان يكرر
android.content.res.Configuration#isScreenRound()
(Ifadf4) - تم تغيير
WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient
لقبولMap<String, String>
بدلاً منUserStyle
لأنّه من الصعب إنشاءUserStyle
بدون معرفة المخطط الذي لا يمكنك الحصول عليه إلا بعد إنشاء العميل. (Iea02a) - يجب إصلاح
InteractiveWatchFaceWcsClient
لاستخدامComplicationState
بدلاً من تنسيق السلك. (Icb8a4) - أصبح "
UserStyleSettings
" الآن صفًا محكمًا لأنّ محرِّري خلفية شاشة الساعة لا يتقنون إلا الصفوف المضمَّنة. (I2d797)
الإصدار 1.0.0-alpha02
11 تشرين الثاني (نوفمبر) 2020
تم طرح "androidx.wear:wear-*:1.0.0-alpha02
". يحتوي الإصدار 1.0.0-alpha02 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- يُطلق على
ComplicationDetails
الآن اسمComplicationState
ويتم لفّه بشكل صحيح ونقل بيانات استخدامات الأجهزة القابلة للارتداء@ComplicationData.ComplicationType
إلى androidxComplicationType
. (I4dd36) - أضِف معلَمة
highlightedComplicationId
اختيارية إلى RenderParameters، ما يسمح لك بطلب تمييز إضافة واحدة في لقطات الشاشة. (I66ce9) ComplicationProviderService
استخدام واجهة برمجة التطبيقات لإضافة نمط جديد لتحقيق التناسق (Id5aea)- يحصل "
getPreviewReferenceTimeMillis
" الآن على الأوقات المرجعية من "DeviceConfig
". (I779fe) - تبسيط مساحة Renderer API، يمكنك استخدام
SurfaceHolder.Callback
لملاحظة التغييرات بدلاً من ذلك. (I210db) - لا يمتد نطاق
CanvasComplicationRenderer
منRenderer
. تتم إعادة تسميته من أجل الوضوح. (Ibe880)
إصلاح الأخطاء
- الإصدار الأول من
androidx.wear:wear-watchface-client
(I1e35e) - تم تغيير اسم
GlesTextureComplication#renderer
لمزيد من الوضوح (Ib78f7). - إعادة تسمية "
StyleCategory
" إلى "StyleSetting
" للتوضيح (I488c7) - إضافة
UserStyleSchema
لواجهة برمجة تطبيقات أكثر وضوحًا (If36f8)
الإصدار 1.0.0-alpha01
28 تشرين الأول (أكتوبر) 2020
تم طرح androidx.wear:wear-complications-*:1.0.0-alpha01
وandroidx.wear:wear-watchface-*:1.0.0-alpha01
. يحتوي الإصدار 1.0.0-alpha01 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- تمت إزالة بعض الأشياء التي لم نعتزم عرضها في واجهة برمجة التطبيقات العامة. (I41669)
- إنشاء مكتبة "
androidx.wear:wear-complications-provider
" (I77f1f) - FeedbacksUserStyleCategory: الفئة الجديدة المقترحة لضبط الإضافات (I96909)
- إضافة واجهة برمجة التطبيقات wear-complication-data API (I7c268)
- الدوال ذات القيم المعروضة المنطقية التي تبدأ بـ "is" بدلاً من "get" (If36ff)
- نصيحة حول واجهة برمجة التطبيقات هي تجنب استخدام البرامج المحمية؛ لذلك تمت إعادة هيكلة هذه الفئة بحيث تأخذ المعلمات عبر الدالة الإنشائية. (I61644)
- أعد تسمية المجموعة setBackgroundComplication للإيضاح. (I96fe3)
- استخدام سمات Kotlin لـ PlicationDrawable is عليّ وdata (I4dcc8)
- بدلاً منcomComicationRenderer.InvalidateCallback، نضيف الخلاصات#inالاستقلالية(I4f4c6)
- يتم إيقاف واجهات برمجة التطبيقات هذه نهائيًا في WearableSupport وإزالة هذه الواجهات هنا. (Ib425c)
- أعادت تسمية بعض طرق إنشاء WatchFace للتشديد على طبيعة Wear 2.0 القديمة. (Idb775)
- أول إصدار تجريبي من واجهة برمجة التطبيقات لواجهة برمجة التطبيقات wear/wear-watchface (Id3981)
- أول إصدار تم تتبعه من واجهة برمجة التطبيقات. (Ie9fe6)
- إخفاء integration Drawable.BorderStyle IntDef بشكل صحيح والانتقال إلى "ComplectionStyle" للحفاظ على التناسق (I27f7a)
- إضافة تعليقات توضيحية غير متوفرة لطرق PlicationStyle (I838fd)
- لا تحتوي هذه المكتبة على واجهة برمجة تطبيقات عامة (I88e2b)
- أصبحت جميع فئات خيار فئات الأنماط الآن نهائية بشكل صحيح. (Ib8323)
- أول إصدار تم تتبعه من واجهة برمجة التطبيقات. (I27c85)
إصلاح الأخطاء
- تم تغيير PaymentProviderService لكي يكون له طريقة getComplicationPreviewData صريحة. (I4905f)
- تم تفعيل ميزة فحص واجهة برمجة التطبيقات لـ مفقودةGetterMatchingBuilder لنظام androidx (I4bbea، b/138602561)
- إعادة تسمية عرض مضاعفات الاستهلاك. (Ifea02)
- أصبحت الأسماء المعروضة لفئات النمط الآن ChaSequences (I28990)
- استبدال "إلغاء" بـ "تراكب" لمطابقة اصطلاحات تسمية المظاهر والأنماط الحالية. (I4fde9)
- تمت إعادة تسمية UserStyle#getOptions للإيضاح. (I695b6)
الإصدار 1.2.0
الإصدار 1.2.0
15 أيلول (سبتمبر) 2021
تم طرح "androidx.wear:wear:1.2.0
". يتضمّن الإصدار 1.2.0 هذه الالتزامات.
التغييرات المهمة منذ الإصدار 1.1.0
تمت إضافة مكوّن CurvedText لكتابة النص المنحني بسهولة بعد انحناء أكبر دائرة يمكن إدراجها في العرض. مثال على الاستخدام:
<androidx.wear.widget.CurvedText android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="example curved text" app:anchorAngleDegrees="180" app:anchorPosition="center" app:clockwise="false" style="@android:style/TextAppearance.Large" />
تمت إضافة حاوية ArcLayout لوضع العناصر الفرعية واحدة تلو الأخرى على قوس إما في اتجاه عقارب الساعة أو عكس اتجاه عقارب الساعة. ويمكن أن تتمثل عناصره الثانوية في تطبيق Android المصغّر العادي أو تطبيقات مصغّرة "منحنية" تنفّذ واجهة
ArcLayout.Widget
. (I536da) مثال على الاستخدام:<androidx.wear.widget.ArcLayout android:layout_width="match_parent" android:layout_height="match_parent" app:anchorPosition="center"> <ImageView android:layout_width="20dp" android:layout_height="20dp" android:src="@drawable/ic_launcher" /> <androidx.wear.widget.CurvedText android:layout_width="match_parent" android:layout_height="match_parent" android:text="Curved Text" style="@android:style/TextAppearance.Small" android:padding="2dp" /> </androidx.wear.widget.WearArcLayout>
تمت إضافة حاوية تصميم جديدة، RejectibleFrameLayout، التي تعالج زر "الرجوع" و/أو "التمرير السريع للرفض" و/أو "التمرير السريع للإغلاق"، مخصصة للاستخدام ضمن أحد الأنشطة. يجب إضافة مستمع واحد على الأقل للتعامل مع إجراء الإغلاق. يزيل المستمع عادةً طريقة العرض المحتوية أو جزءًا من النشاط الحالي. يتم توفير set بداية السحب(منطقية) وsetBackButtonButtonible(منطقية) للتحكم المباشر في الميزات. ويهدف هذا التنسيق الجديد إلى استبدال طريقة السحب الحالية ScrollFrameLayout.
تمت إضافة الدعم للإشارة إلى أنّه يمكن "استئناف" نشاط معيّن تلقائيًا عندما يغادر الجهاز "وضع عدم النشاط" في فئة " ننصحك بالاستفادة من هذه الميزة". كانت هذه الوظيفة متاحة سابقًا في فئة WearableActivity التي تم إيقافها نهائيًا من WearableSupportLibrary. (I336ab)
تم نقل صف Wearable CalendarContract من مكتبة دعم الأجهزة القابلة للارتداء. توفّر واجهة برمجة التطبيقات هذه مجموعة فرعية من البيانات المتاحة من خلال calendarContract، ولكن تتم مزامنتها تلقائيًا مع الأجهزة القابلة للارتداء. (I6f2d7)
تمت إضافة
WearTypeHelper
واجهة برمجة تطبيقات جديدة فيandroidx.wear.utils
لتحديد ما إذا كان الجهاز المُستخدَم في ارتداء الجهاز مقتصرًا على الصين. (Ib01a9)تمت إضافة ميزات تسهيل الاستخدام إلى "
androidx.wear.widget.ConfirmationOverlay
" التي ستقرأ الرسائل إذا تم ضبطها متبوعةً بوصف الصورة المتحركة. (I524dd)تم إصلاح الخطأ الذي تسبب في تعطل ConfirmActivity إذا لم يتم تقديم أي رسالة. (Ie6055)
تم إصلاح الخطأ الذي تسبّب في جعل
WearableDrawerLayout
أثناء التمرير الأفقي على جميع التفاعلات. (I24c7f)
الإصدار 1.2.0-rc01
1 أيلول (سبتمبر) 2021
تم طرح androidx.wear:wear:1.2.0-rc01
بدون أي تغييرات منذ الإصدار التجريبي الأخير. يحتوي الإصدار 1.2.0-rc01 على هذه الالتزامات.
الإصدار 1.2.0-beta01
18 آب (أغسطس) 2021
تم طرح "androidx.wear:wear:1.2.0-beta01
". يحتوي الإصدار 1.2.0 -beta01 على هذه الالتزامات.
إصلاح الأخطاء
- إصلاح الخطأ الذي تسبب في تعطل التأكيدActivity إذا لم يتم تقديم أي رسالة. (Ie6055)
الإصدار 1.2.0-alpha13
4 آب (أغسطس) 2021
تم طرح "androidx.wear:wear:1.2.0-alpha13
". يتضمّن الإصدار 1.2.0-alpha13 هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- تمت إعادة التسمية "
WearTypeHelper.isChinaDevice
" إلى "WearTypeHelper.isChinaBuild
". (I47302)
إصلاح الأخطاء
- لقد أضفنا ميزات تسهيل الاستخدام إلى "
androidx.wear.widget.ConfirmationOverlay
" التي ستقرأ الرسائل إذا تم ضبطها متبوعة بوصف الصورة المتحركة. (I524dd)
الإصدار 1.2.0-alpha12
21 تموز (يوليو) 2021
تم طرح "androidx.wear:wear:1.2.0-alpha12
". يحتوي الإصدار 1.2.0-alpha12 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- لقد أضفنا واجهة برمجة تطبيقات جديدة
WearTypeHelper
فيandroidx.wear.utils
لتحديد ما إذا كان الجهاز المستخدَم في الصين متوفرًا في الصين. (Ib01a9)
الإصدار 1.2.0-alpha11
30 حزيران (يونيو) 2021
تم طرح "androidx.wear:wear:1.2.0-alpha11
". يتضمّن الإصدار 1.2.0-alpha11 هذه الالتزامات.
إصلاح الأخطاء
- تم إصلاح الخطأ الذي تسبّب في جعل
WearableDrawerLayout
أثناء التمرير الأفقي على جميع التفاعلات. (I24c7f)
الإصدار 1.2.0-alpha10
2 حزيران (يونيو) 2021
تم طرح "androidx.wear:wear:1.2.0-alpha10
". يحتوي الإصدار 1.2.0-alpha10 على هذه الالتزامات.
الميزات الجديدة
- يعمل برنامج Alpha10 على تحسين إمكانية الوصول في "النص المقوس" و"تخطيطات ArcLayouts". كما أنه يضيف بعض عمليات إعادة التسمية البسيطة لـ في RelayibleFrameLayout للمساعدة في توضيح واجهة برمجة التطبيقات.
تغييرات واجهة برمجة التطبيقات
- لقد أعدنا تسمية الطرق التالية في
DismissibleFrameLayout
(Ib195e):Callback#onDismissed
->Callback#onDismissedFinished
isSwipeDismissible
->isDismissableBySwipe
isBackButtonDismissible
->isDismissableByBackButton
- لقد أجرينا الإجراءات التالية بشكل نهائي (Ib195e):
setBackButtonDismissible
setSwipeDismissible
registerCallback
unregisterCallback
إصلاح الأخطاء
- استخدام محتوى CurvedTextView على TalkBack. (I05798)
- إمكانية وصول أفضل إلى طرق العرض العادية في ArcLayout. (I4418d)
الإصدار 1.2.0-alpha09
18 أيار (مايو) 2021
تم طرح "androidx.wear:wear:1.2.0-alpha09
". يتضمّن الإصدار 1.2.0-alpha09 هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة دالة جديدة
CurvedTextView.setTypeface()
(مشابهة لدالةTextView
)، لضبط الخط الطباعي والنمط الغامق/المائل. (I4653c) - تمت إعادة تسمية "
WearArcLayout
" إلى "ArcLayout
" و"WearCurvedText
" إلى "CurvedText
" و"WearArcLayout.ArcLayoutWidget
" إلى "ArcLayout.Widget
". (I6e5ce)- في
ArcLayout.Widget
، تم تغيير الاسم "getThicknessPx
" إلى "getThickness
". - تمت الآن تسمية ثوابت المحاذاة العمودية على
ArcLayout.LayoutParams
بدءًا منVERTICAL_ALIGN_
(بدلاً منVALIGN_
السابقة).
- في
- في
CurvedTextView
، تم استبدال الطريقتَينsetMinSweepDegrees
وsetMaxSweepDegrees
بـsetSweepRangeDegrees
(I7a9d9).
الإصدار 1.2.0-alpha08
5 أيار (مايو) 2021
تم طرح "androidx.wear:wear:1.2.0-alpha08
". يحتوي الإصدار 1.2.0-alpha08 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- لتحسين وضوح الرمز، أضفنا تعليقات
@FloatRange
التوضيحية إلى بعض مَعلَمات الزاوية وأنواع العرض. (I430dd) - في الواجهة
WearArcLayout.ArcLayoutWidget
، يُطلق على الطريقةinsideClickArea
الآن اسم isPointInsideClickArea. (Ia7307)
الإصدار 1.2.0-alpha07
24 آذار (مارس) 2021
تم طرح "androidx.wear:wear:1.2.0-alpha07
". يحتوي الإصدار 1.2.0-alpha07 على هذه الالتزامات.
إصلاح الأخطاء
- إصلاح أخطاء العناصر الثانوية غير المنحنية داخل WearArcLayout الناتجة عن استخدام حجم شاشة أكبر من العرض. تم وضع هذه الأطفال غير المنحنيات الآن بشكل صحيح داخل قوس على جميع أنواع الشاشات.
الإصدار 1.2.0-alpha06
27 كانون الثاني (يناير) 2021
تم طرح "androidx.wear:wear:1.2.0-alpha06
". يتضمّن الإصدار 1.2.0-alpha06 هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- نقل مكتبة الأنشطة المستمرة إلى مكتبة فرعية جديدة: الملابس المستمرة. تتوفّر الآن الصفوف الدراسية الآن في حزمة androidx.wear.onbound (المعروفة سابقًا باسم androidx.wear.on visibleactivities) (I7c029).
- يمكنك نقل فئة WearableAdminContract من مكتبة الدعم القابل للارتداء إلى AndroidX. توفّر واجهة برمجة التطبيقات هذه مجموعة فرعية من البيانات المتاحة من خلال calendarContract، ولكن تتم مزامنتها تلقائيًا مع الأجهزة القابلة للارتداء. (I6f2d7)
إصلاح الأخطاء
- يمكنك إيقاف ميزة إغلاق زر الرجوع تلقائيًا في Rejectible FrameLayout حيث يظل التمرير سريعًا للإغلاق الطريقة الرئيسية للرجوع إلى وضع ملء الشاشة على الأجهزة القابلة للارتداء (Ic24e3).
- تم إصلاح بعض المشاكل المتعلقة بالتعامل مع مستوى ظهور الأطفال على WearArcLayout (Icf912)
الإصدار 1.2.0-alpha05
13 كانون الثاني (يناير) 2021
تم طرح "androidx.wear:wear:1.2.0-alpha05
". يحتوي الإصدار 1.2.0-alpha05 على هذه الالتزامات.
إصلاح الأخطاء
- يُرجى تعديل فئة javadoc من فئة لإضافة "مساعد Google" إلى التطبيق لتوفير نماذج مقتطفات من أجل توضيح الاستخدام العام لهذه الفئة بشكل أفضل.
الإصدار 1.2.0-alpha04
16 كانون الأول (ديسمبر) 2020
تم طرح "androidx.wear:wear:1.2.0-alpha04
". يحتوي الإصدار 1.2.0-alpha04 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة الدعم للإشارة إلى أنّه يمكن "استئناف" نشاط معيّن تلقائيًا عندما يغادر الجهاز "وضع عدم النشاط" في فئة " ننصحك بالاستفادة من هذه الميزة". كانت هذه الوظيفة متاحة سابقًا في فئة WearableActivity التي تم إيقافها نهائيًا من WearableSupportLibrary. (I336ab)
- النشاط الجاري
- يمكن الآن ضبط الفئة عند إنشاء OnlegActivity، مثل
OngoingActivitiy.Builder.getCategory(String)
. - الطابع الزمني لوقت إنشاء OngoingActivityData الآن هو -
OngoingActivityData.getTimestamp()
. - (I91cb4)
- يمكن الآن ضبط الفئة عند إنشاء OnlegActivity، مثل
- تمت إتاحة ضبط الهوامش على عناصر WearArcLayout عن طريق تغيير مَعلمات التصميم لتوسيع نطاق MarginLayoutParams، أي أن WearArcLayout.LayoutParams تعمل على توسيع android.view.ViewGroup.MarginLayoutParams. (I2cd88)
- يمكنك تغيير نوع الرابط التلقائي في WearCurvedTextView إلى
WearArcLayout.ANCHOR_CENTER
(كانWearArcLayout.ANCHOR_START
). وهذا من شأنه تبسيط العقد بين التنسيق القوسي والنص المقوّس لأنّ النص المقوّس يرسم نفسه في وسط الجزء العلوي من الشاشة بشكل تلقائي، كما يمكن لتنسيق القوس الرئيسي تدويره إلى المكان المطلوب. (I105ff)
الإصدار 1.2.0-alpha03
2 كانون الأول (ديسمبر) 2020
تم طرح "androidx.wear:wear:1.2.0-alpha03
". يحتوي الإصدار 1.2.0-alpha03 على هذه الالتزامات.
الميزات الجديدة
هي حاوية تنسيق جديدة SepibleFrameLayout، وهي تعمل على التعامل مع زر "الرجوع" و/أو الرفض و/أو التمرير السريع للإغلاق، وهي مخصَّصة للاستخدام في النشاط. يجب إضافة مستمع واحد على الأقل للتعامل مع إجراء الإغلاق. يزيل المستمع عادةً طريقة العرض المحتوية أو جزءًا من النشاط الحالي. يتم توفير set بداية السحب(منطقية) وsetBackButtonButtonible(منطقية) للتحكم المباشر في الميزات. ويهدف هذا التنسيق الجديد إلى استبدال طريقة السحب الحالية ScrollFrameLayout.
أصبحت التطبيقات المصغّرة المنحنية تتعامل مع أحداث اللمس. ستتلقى التطبيقات المصغّرة العادية داخل WearArcLayout جميع أحداث اللمس، التي يتم ربطها بمساحتها الإحداثية. يمكن لمنصة WearCurvedTextView (داخل WearArcLayout أو لا) ضبط معالِجات onClick وonLongClick.
أصبحت صفوف الأنشطة الجارية متاحة الآن ضمن VersionedParcelables بدلاً من استخدام التسلسل المخصّص أو إلغاء التسلسل. أصبحا الرمز الثابت والنية باللمس مطلوبَين الآن.
تغييرات واجهة برمجة التطبيقات
- تم فصل السمة "sweepDegrees" لـ WearCurvedTextView إلى minSweepDegrees وmaxSweepDegrees لمنحه تنسيقًا أكثر مرونة لهذا التطبيق المصغّر.
الإصدار 1.2.0-alpha02
11 تشرين الثاني (نوفمبر) 2020
تم طرح "androidx.wear:wear:1.2.0-alpha02
". يحتوي الإصدار 1.2.0-alpha02 على هذه الالتزامات.
يضيف هذا الإصدار واجهة برمجة تطبيقات جديدة لـ "الأنشطة المستمرة" للمرة الأولى. يمكن للمطوّرين استخدام واجهة برمجة التطبيقات هذه للإشارة إلى استمرار نشاط طويل الأمد، مثل تمرين لياقة بدنية أو جلسة تشغيل وسائط. وهي تتيح للمطوّرين تقديم تحديثات دورية للحالة، مثل "المسافة ووقت التشغيل" أو "تشغيل الأغنية الحالية" لعرضها على خلفية شاشة الساعة أو في مشغّل التطبيقات. تستهدف هذه الوظيفة الأجهزة المستقبلية التي يتم تفعيل وظيفة النشاط المستمر عليها.
تغييرات واجهة برمجة التطبيقات
- واجهة برمجة تطبيقات جديدة للأنشطة المستمرة، هذه واجهة برمجة تطبيقات جديدة على "الأجهزة غير المتوافقة". (I69a31)
الإصدار 1.2.0-alpha01
28 تشرين الأول (أكتوبر) 2020
تم طرح "androidx.wear:wear:1.2.0-alpha01
". يحتوي الإصدار 1.2.0-alpha01 على هذه الالتزامات.
الميزات الجديدة
- تمت إضافة مكوّن WearCurvedTextView لكتابة نص منحني بسهولة بعد انحناء أكبر دائرة يمكن إدراجها في العرض. مثال على الاستخدام:
<androidx.wear.widget.WearCurvedTextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="example curved text"
app:anchorAngleDegrees="180"
app:anchorPosition="center"
app:clockwise="false"
style="@android:style/TextAppearance.Large"
/>
- تمت إضافة حاوية WearArcLayout لوضع عناصرها الفرعية واحدًا تلو الآخر على قوس إما في اتجاه عقارب الساعة أو عكس اتجاه عقارب الساعة. ويمكن أن تتمثل عناصره الفرعية في تطبيق Android المصغّر العادي أو تطبيقات مصغّرة "منحنية" تستخدم واجهة ArcLayoutWidget. مثال على الاستخدام:
<androidx.wear.widget.WearArcLayout
android:layout_width="match_parent"
android:layout_height="match_parent"
app:anchorPosition="center">
<ImageView
android:layout_width="20dp"
android:layout_height="20dp"
android:src="@drawable/ic_launcher"
/>
<androidx.wear.widget.WearCurvedTextView
android:layout_width="match_parent"
android:layout_height="match_parent"
android:text="Curved Text"
style="@android:style/TextAppearance.Small"
android:padding="2dp"
/>
</androidx.wear.widget.WearArcLayout>
(I536da)
الإصدار 1.2 من إدخال ارتداء Wear
الإصدار 1.2.0-alpha02
29 أيلول (سبتمبر) 2021
تم طرح androidx.wear:wear-input:1.2.0-alpha02
وandroidx.wear:wear-input-testing:1.2.0-alpha02
. يحتوي الإصدار 1.2.0-alpha02 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- تمت إعادة التسمية
disallowEmoji
إلىsetEmojisAllowed
فيWearableRemoteInputExtender
للاستخدام في ضبط ما إذا كان سيتم عرض خيار رسم الرموز التعبيرية. (I28393)
الإصدار 1.2.0-alpha01
15 أيلول (سبتمبر) 2021
تم طرح androidx.wear:wear-input:1.2.0-alpha01
وandroidx.wear:wear-input-testing:1.2.0-alpha01
. يحتوي الإصدار 1.2.0-alpha01 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- تم كشف جميع ثوابت موقع الزر من
WearableButtons
. (Ibb12c) - تمت إضافة فئة
WearableRemoteInputExtender
التي يمكن استخدامها لإضافة إضافات خاصة بأجهزة Wear إلى android.app.RemoteInput. (I01903)
الإصدار 1.1.0 من Wear-Input
الإصدار 1.1.0
18 آب (أغسطس) 2021
تم طرح androidx.wear:wear-input:1.1.0
وandroidx.wear:wear-input-testing:1.1.0
. يتضمّن الإصدار 1.1.0 هذه الالتزامات.
التغييرات المهمة منذ الإصدار 1.0.0
- تمت إضافة "
RemoteInputIntentHelper
".- يمكن استخدام هذه الفئة لإنشاء Intent Input Intent. ويمكن استخدام ذلك بعد ذلك لطلب إدخالات من المستخدمين في نشاط قابل للتخصيص.
الإصدار 1.1.0-rc01
4 آب (أغسطس) 2021
تم طرح androidx.wear:wear-input:1.1.0-rc01
وandroidx.wear:wear-input-testing:1.1.0-rc01
. يحتوي الإصدار 1.1.0-rc01 على هذه الالتزامات.
لم يتم إجراء أي تغييرات في واجهة برمجة التطبيقات منذ androidx.wear:wear-input:1.1.0-beta01
وandroidx.wear:wear-input-testing:1.1.0-beta01
.
الإصدار 1.1.0-beta01
21 تموز (يوليو) 2021
تم إصدار androidx.wear:wear-input:1.1.0-beta01
وandroidx.wear:wear-input-testing:1.1.0-beta01
بدون أي تغييرات منذ 1.1.0-alpha03
. يتضمّن الإصدار 1.1.0-beta01 هذه الالتزامات.
الإصدار 1.1.0-alpha03
30 حزيران (يونيو) 2021
تم طرح androidx.wear:wear-input:1.1.0-alpha03
وandroidx.wear:wear-input-testing:1.1.0-alpha03
. يتضمّن الإصدار 1.1.0-alpha03 هذه الالتزامات.
إصلاح الأخطاء
- تم إصلاح الخطأ الذي تسبّب في رفض أغراض RemoteInput التي تمت إضافة
RemoteInput
إليها من خلالRemoteInputHelper.putRemoteInputsExtra
.
الإصدار 1.1.0-alpha02
18 أيار (مايو) 2021
تم طرح androidx.wear:wear-input:1.1.0-alpha02
وandroidx.wear:wear-input-testing:1.1.0-alpha02
. يحتوي الإصدار 1.1.0-alpha02 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- إنّ طُرق
RemoteInputIntentHelper
المُستخدَمة للحصول على أو وضع إضافات تمثل العنوان والإلغاء والتأكيد والتصنيفات قيد التقدم تستخدم الآنCharSequence
بدلاً منString
لهذه التصنيفات. (I0e71f)
الإصدار 1.1.0-alpha01
27 كانون الثاني (يناير) 2021
تم طرح androidx.wear:wear-input:1.1.0-alpha01
وandroidx.wear:wear-input-testing:1.1.0-alpha01
. يحتوي الإصدار 1.1.0-alpha01 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- نقل فئة RemoteInputIntent من مكتبة دعم الأجهزة القابلة للارتداء إلى AndroidX تُعاد تسمية الفئة التي تم نقلها باسم RemoteInputIntentHelper الذي يوفّر وظائف مساعِدة لإتاحة المدخلات عن بُعد من خلال بدء غرض. (I47cee)
الإصدار 1.0.0 من Wear-Input
الإصدار 1.0.0
2 كانون الأول (ديسمبر) 2020
تم طرح androidx.wear:wear-input:1.0.0
وandroidx.wear:wear-input-testing:1.0.0
. يتضمّن الإصدار 1.0.0 هذه الالتزامات.
هذا الإصدار مماثل للنسخة 1.0.0-rc01
.
الميزات الرئيسية للإصدار 1.0.0
نقل بيانات وظيفة WearableButtons من مكتبة الدعم للأجهزة القابلة للارتداء إلى Jetpack
تمت إضافة
androidx.wear.input.test.TestWearableButtonsProvider
لتطبيقandroidx.wear.input.WearableButtonsProvider
للمساعدة في اختبار التطبيقات التي تم تطويرها باستخدام مكتبةandroidx.wear:wear-input
.
الإصدار 1.0.0-rc01
11 تشرين الثاني (نوفمبر) 2020
تم طرح androidx.wear:wear-input:1.0.0-rc01
وandroidx.wear:wear-input-testing:1.0.0-rc01
. يحتوي الإصدار 1.0.0-rc01 على هذه الالتزامات.
هذا الإصدار مماثل للنسخة 1.0.0-beta01
.
الإصدار 1.0.0-beta01
28 تشرين الأول (أكتوبر) 2020
تم إصدار androidx.wear:wear-input:1.0.0-beta01
وandroidx.wear:wear-input-testing:1.0.0-beta01
بدون أي تغييرات منذ 1.1.0-alpha01
. يتضمّن الإصدار 1.0.0-beta01 هذه الالتزامات.
الإصدار 1.0.0-alpha01 من Wear-Input Testing
14 تشرين الأول (أكتوبر) 2020
تم طرح "androidx.wear:wear-input-testing:1.0.0-alpha01
". يحتوي الإصدار 1.0.0-alpha01 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة
androidx.wear.input.test.TestWearableButtonsProvider
لتطبيقandroidx.wear.input.WearableButtonsProvider
للمساعدة في اختبار التطبيقات التي تم تطويرها باستخدام مكتبةandroidx.wear:wear-input
. (I0ed0c)
الإصدار 1.0.0-alpha01 من Wear-Input
2 أيلول (سبتمبر) 2020
تم طرح "androidx.wear:wear-input:1.0.0-alpha01
". يحتوي الإصدار 1.0.0-alpha01 على هذه الالتزامات.
الميزات الجديدة
نقل بيانات وظيفة WearableButtons من مكتبة الدعم للأجهزة القابلة للارتداء إلى Jetpack وسيتم توفير دعم إضافي للاختبار في مكتبة androidx.wear:wear-input-testing
ضمن إصدار Jetpack التالي.
الإصدار 1.1.0
الإصدار 1.1.0
14 تشرين الأول (أكتوبر) 2020
تم طرح "androidx.wear:wear:1.1.0
". يتضمّن الإصدار 1.1.0 هذه الالتزامات.
التغييرات الرئيسية منذ الإصدار 1.0.0
- تمت إضافة بادئة
layout_
إلى سمة boxedEdges (تحمل الآن اسمlayout_BoxedEdges
) فيBoxInsetLayout
من أجل الامتثال لاصطلاح تسمية Android. سيؤدي هذا الإجراء إلى إزالة خطأ linter لهذه السمات في "استوديو Android". (I4272f) - تمت إضافة السمة
EXTRA_ANIMATION_DURATION_MILLIS
بشكل اختياري إلىConfirmationActivity
لإتاحة المدة التي يتم خلالها عرض مربّع حوار التأكيد. (adb83ce، b/143356547) - تم التعديل
WearableActionDrawView
لتأجيل تضخّم قائمة الإجراءات إلى أن يتم فتح قائمة التنقّل للمرة الأولى. (I01026، b/163870541)
الإصدار 1.1.0-rc03
2 أيلول (سبتمبر) 2020
تم طرح "androidx.wear:wear:1.1.0-rc03
". يحتوي الإصدار 1.1.0-rc03 على هذه الالتزامات.
إصلاح الأخطاء
- تم إصلاح مشكلة عدم عرض "درج الإجراءات" للمحتوى عند فتحه. (I01026، b/163870541)
الإصدار 1.1.0-rc02
24 حزيران (يونيو) 2020
تم طرح "androidx.wear:wear:1.1.0-rc02
". يحتوي الإصدار 1.1.0-rc02 على هذه الالتزامات.
إصلاح الأخطاء
- تمت إضافة بادئة
layout_
إلى سمة boxedEdges (تحمل الآن اسمlayout_boxedEdges
) فيBoxInsetLayout
من أجل الامتثال لاصطلاح تسمية Android. سيؤدي هذا الإجراء إلى إزالة خطأ linter لهذه السمات في "استوديو Android".
الإصدار 1.1.0-rc01
14 أيار (مايو) 2020
تم طرح الإصدار "androidx.wear:wear:1.1.0-rc01
" بدون أي تغييرات منذ .1.0-beta01
. يحتوي الإصدار 1.1.0-rc01 على هذه الالتزامات.
الإصدار 1.1.0-beta01
29 نيسان (أبريل) 2020
تم طرح الإصدار "androidx.wear:wear:1.1.0-beta01
" بدون أي تغييرات منذ androidx.wear:wear:1.1.0-alpha01
. يتضمّن الإصدار 1.3.0-beta01 هذه الالتزامات.
الإصدار 1.1.0-alpha01
نيسان (أبريل) 2020
تم طرح "androidx.wear:wear:1.1.0-alpha01
". يحتوي الإصدار 1.1.0-alpha01 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة السمة
EXTRA_ANIMATION_DURATION_MILLIS
بشكل اختياري إلىConfirmationActivity
لإتاحة المدة التي يتم خلالها عرض مربّع حوار التأكيد. (adb83ce و134523c وb/143356547)
إصلاح الأخطاء
- تم التعديل
WearableActionDrawView
لتأجيل تضخّم قائمة الإجراءات إلى أن يتم فتح قائمة التنقّل للمرة الأولى. (5cd32f7)