Wear
androidx.wear.activity
androidx.wear.ambient
androidx.wear.input
androidx.wear.utils
androidx.wear.widget
androidx.wear.widget.drawer
(اطّلِع على مستندات المراجع لجميع حِزم Wear OS)
يعرض هذا الجدول كل العناصر في مجموعة androidx.wear
.
العناصر | الإصدار الثابت | إصدار محتمل | الإصدار التجريبي | إصدار أولي |
---|---|---|---|---|
ارتداء | 1.3.0 | - | - | 1.4.0-alpha01 |
wear-input | 1.1.0 | - | - | 1.2.0-alpha02 |
wear-input-testing | 1.1.0 | - | - | 1.2.0-alpha02 |
مستنِد إلى الارتداء | 1.0.0 | - | - | 1.1.0-alpha01 |
wear-phone-interactions | 1.0.1 | - | - | 1.1.0-alpha04 |
تفاعلات الارتداء عن بُعد | 1.0.0 | 1.1.0-rc01 | - | - |
إعلان التبعيات
لإضافة تبعية على Wear، عليك إضافة مستودع Google Maven إلى مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.
أضِف التبعيات للعناصر التي تحتاج إليها في ملف build.gradle
ل
تطبيقك أو وحدتك:
Groovy
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 من معاينة أداة Wearing
الإصدار 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 الأساسي وعمليات تنفيذ 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) - رسالة وصف محتوى محسّنة لـ ControlOverlay (I0fdf8)
- عدِّل
ConfirmationOverlay
باستخدام رموز أو تنسيق جديد. (If5b54)
إصلاح الأخطاء
- تمت إضافة قواعد ProGuard لضمان الاحتفاظ بالرموز البرمجية المتعلّقة بالمحتوى المحيط (Idaa10)
- تجنُّب إغلاق الأجزاء عن طريق الخطأ في SwipeDismissFrameLayout باستخدام التمرير السريع العمودي (Idb6d8)
- إصلاح ConfirmationOverlay عندما لا يتضمّن رسالة (I63e6f)
المساهمة الخارجية
- Dae Gyu LEE (Samsung) - تجنُّب إغلاق الأجزاء بشكل عرضي في scrollRemoveFrameLayout باستخدام التمرير الرأسي (Idb6d8)
الإصدار 1.3.0-alpha01
29 أيلول (سبتمبر) 2021
تم إصدار androidx.wear:wear:1.3.0-alpha01
. يحتوي الإصدار 1.3.0-alpha01 على هذه عمليات التنفيذ.
إصلاح الأخطاء
ConfirmationOverlay
يدفع الرمز الآن للأعلى لاستيعاب الرسائل الأطول، بدون أن تدخل الرسالة في الحافة الجانبية للجهاز (أو خارج الشاشة). (I54bff)
Wear Ongoing & Interactions Version 1.1.0
الإصدار 1.1.0-rc01
16 تشرين الأول (أكتوبر) 2024
تم طرح androidx.wear:wear-remote-interactions:1.1.0-rc01
بدون أي تغييرات منذ 1.1.0-beta01
. يتضمّن الإصدار 1.1.0-rc01 عمليات الربط هذه.
الإصدار 1.1.0-beta01
24 يوليو 2024
تم طرح androidx.wear:wear-remote-interactions:1.1.0-beta01
. يحتوي الإصدار 1.1.0-beta01 على عمليات التنفيذ هذه. يشير الإصدار 1.3.0-beta01 من Wear Remote Interactions إلى أنّ هذا الإصدار من المكتبة مكتمل الميزات وأنّ واجهة برمجة التطبيقات مقفلة (باستثناء الحالات التي تم وضع علامة عليها كإصدار تجريبي).
الإصدار 1.1.0-alpha04
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)
المساهمة الخارجية
- يمكنك إزالة تبعية Java من
wear-remote-interactions
واستخدام بدائل أصغر.
الإصدار 1.1.0-alpha03 من Wear-الهاتف
9 آذار (مارس) 2022
تم إصدار androidx.wear:wear-phone-interactions:1.1.0-alpha03
. يحتوي الإصدار 1.1.0-alpha03 على هذه المراجعات.
إصلاح الأخطاء
- يعرض
redirectUrl
منOAuthRequest
الآن سلسلة فارغة إذا لم يتم ضبط عنوان URL لإعادة التوجيه في عنوان URL للطلب المحدّد. (I44242)
Wear-Phone-Interactions الإصدار 1.1.0-alpha02
15 كانون الأول (ديسمبر) 2021
تم إصدار androidx.wear:wear-phone-interactions:1.1.0-alpha02
. يحتوي الإصدار 1.1.0-alpha02 على هذه المراجعات.
إصلاح الأخطاء
- إصلاح الأخطاء في مستندات
RemoteAuthClient
، بما في ذلك الخطأ في مقتطف نموذج الرمز والرابط غير الصالح المؤدّي إلىErrorCode
(I260e8)
الإصدار 1.1.0-alpha01 من Wear-الهاتف
15 أيلول (سبتمبر) 2021
تم إصدار androidx.wear:wear-phone-interactions:1.1.0-alpha01
. يحتوي الإصدار 1.1.0-alpha01 على هذه المراجعات.
تغييرات واجهة برمجة التطبيقات
Wear Ongoing & Interactions Version 1.0.0
Wear-Phone-Interactions الإصدار 1.0.1
15 كانون الأول (ديسمبر) 2021
تم إصدار androidx.wear:wear-phone-interactions:1.0.1
. يحتوي الإصدار 1.0.1 على هذه المراجعات.
إصلاح الأخطاء
- تم طرح استثناء ثابت من
BridgingManager
عند محاولة إيقاف ربط الإشعارات بدونexcludedTags
.
Wear-الهاتف-تفاعلات Wear-التفاعلات عن بُعد-الإصدار 1.0.0
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-Phone-Interactions Wear-Remote-Interactions Version 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)
Wear-Ongoing Version 1.0.0
1 أيلول (سبتمبر) 2021
تم إصدار androidx.wear:wear-ongoing:1.0.0
. يحتوي الإصدار 1.0.0 على عمليات التنفيذ هذه.
الميزات الرئيسية في الإصدار 1.0.0
- Wear Ongoing Activities API هي واجهة برمجة تطبيقات للمطوّرين، بما في ذلك المطوّرون التابعون لجهات خارجية، ويتم استخدامها لوضع علامة "نشاط جارٍ" على نشاطهم وتقديم المعلومات المطلوبة.
- تشير "الأنشطة الجارية" إلى الأنشطة التي يمكن أن تكون قيد التشغيل في الخلفية على الساعة (مثل التمارين والمكالمات والوسائط). على نظام التشغيل Wear 3، سيصبح النشاط المُعلَن عنه مستمرًا بشكل أكثر بروزًا من خلال رمز مركَّب مخصّص على خلفية شاشة الساعة وعرض مختلف في مشغّل التطبيقات.
- لمزيد من المعلومات، يُرجى الاطّلاع على دليل النشاط الجاري في Wear OS.
Wear-Phone-Interactions Wear-Remote-Interactions Version 1.0.0-beta01
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)
Wear-Ongoing Version 1.0.0-rc01
18 آب (أغسطس) 2021
تم طرح androidx.wear:wear-ongoing:1.0.0-rc01
بدون أي تغييرات منذ 1.0.0-beta01
. يحتوي الإصدار 1.0.0-rc01 على هذه المراجعات.
Wear-Ongoing Version 1.0.0-beta01
4 آب (أغسطس) 2021
تم إصدار androidx.wear:wear-ongoing:1.0.0-beta01
. يحتوي الإصدار 1.0.0-beta01 على هذه المراجعات.
تغييرات واجهة برمجة التطبيقات
- تقبل الآن بعض وظائف الإعداد في OngoingActivity.Builder دالّة null من أجل توفير توازن واتساق لوظائف الإعداد والحصول (I17ee5).
Wear-Phone-Interactions الإصدار 1.0.0-alpha07
4 آب (أغسطس) 2021
تم إصدار androidx.wear:wear-phone-interactions:1.0.0-alpha07
. يحتوي الإصدار 1.0.0-alpha07 على هذه المراجعات.
تغييرات واجهة برمجة التطبيقات
- تمت إعادة تسمية "
WearTypeHelper.isChinaDevice
" إلى "WearTypeHelper.isChinaBuild
". (I47302) - لقد عدَّلنا مكتبة RemoteAuthClient لاختيار "redirect_uri" تلقائيًا استنادًا إلى نوع الجهاز (RoW/الصين). (I38866)
- تم إصلاح الخلل الذي تسبّب في تعذُّر تحويل BridgingConfig إلى/من حِزمة باستخدام ClassCastException. تمت إضافة اختبارات وحدات لفئة BridgingManagerService. (I68ecb)
Wear-Remote-Interactions الإصدار 1.0.0-alpha06
4 آب (أغسطس) 2021
تم طرح androidx.wear:wear-remote-interactions:1.0.0-alpha06
. يحتوي الإصدار 1.0.0-alpha06 على هذه المراجعات.
الإصدار 1.0.0-alpha06 من Wear-Phone
21 تموز (يوليو) 2021
تم طرح androidx.wear:wear-phone-interactions:1.0.0-alpha06
. يحتوي الإصدار 1.0.0-alpha06 على هذه المراجعات.
التغييرات في واجهة برمجة التطبيقات
- أصبحت فئة
BridgingManagerSeviceBinder
الآن فئة فرعية من Service وتمّ تغيير اسمها إلى BridgingManagerSevice. (I9fca2) - تم تغيير طريقة
RemoteAuthClient.Callback.onAuthorizationError
لتضمين معلمة OAuthRequest. إنّ الطرق التي تتطلّب إجراء طلب معاودة الاتصال تتطلّب الآن أيضًا تنفيذًا لتنفيذ طلب معاودة الاتصال. (I35e11)
إصلاح الأخطاء
- لقد سهّلنا استخدام واجهة برمجة التطبيقات Authentication API من خلال إضافة المزيد من المَعلمات الموثَّقة واستخدام السمات كلما أمكن ذلك. (I12287)
الإصدار 1.0.0-alpha05 من Wear-Phone
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
الآن أدوات جلب لاسترداد جميع القيم التي تم ضبطها مباشرةً من خلال "أداة الإنشاء" (أو الإعدادات التلقائية المستمَدة من الإشعار المرتبط). (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 على عمليات التنفيذ هذه.
تغييرات واجهة برمجة التطبيقات
- في OngoingActivity، تمّ الآن استبدال الطرق من ExistingOngoingActivity باسم recoverOngoingActivity.
- تتضمّن OngoingActivity الآن مجموعة كاملة من وظائف الحصول، وهي نفسها الوظائف التي كانت متاحة سابقًا في OngoingActivityData فقط. (I0ee4d)
Wear-Remote-Interactions الإصدار 1.0.0-alpha05
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)
Wear-Phone-Interactions الإصدار 1.0.0-alpha04
7 نيسان (أبريل) 2021
تم إصدار androidx.wear:wear-phone-interactions:1.0.0-alpha04
. يحتوي الإصدار 1.0.0-alpha04 على هذه المراجعات.
تغييرات واجهة برمجة التطبيقات
- تم تعديل ثوابت
ErrorCode
لجعل المكتبة الجديدة متوافقة مع الإصدارات القديمة مع التنفيذ في مكتبة الدعم القابل للارتداء.
إصلاح الأخطاء
- تم إصلاح استثناء ناتج عن واجهة برمجة التطبيقات الجديدة لبروتوكول OAuth عند بدء جلسة OAuth.
الإصدار 1.0.0-alpha03 من Wear-عن بُعد
7 نيسان (أبريل) 2021
تم طرح androidx.wear:wear-remote-interactions:1.0.0-alpha03
. يحتوي الإصدار 1.0.0-alpha03 على هذه المراجعات.
تغييرات واجهة برمجة التطبيقات
- تم تغيير
PlayStoreAvailability
لتكون فئة تحتوي على كائن مصاحب بطرق ثابتة. لن يتغيّر معدّل الاستخدام.
إصلاح الأخطاء
- تم إصلاح مستند الملخّص الخاص بـ
WatchFaceConfigIntentHelper
لعرض نموذج الرمز البرمجي بشكل صحيح باستخدام أحرف HTML الفعلية.
Wear-Ongoing Wear-Phone-Interactions Version 1.0.0-alpha03
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. يتم توفير فئات معالجات ومساعِدين إضافية للتواصل.
- يمكن الآن ربط الأنشطة الجارية بإشعار يحتوي على علامة، وذلك باستخدام الدالة الإنشائية الجديدة OnthroughActivity.Builder.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة دعم علامات الإشعارات في "مكتبة الأنشطة الجارية" (I653b4).
- نقل بيانات OAuthClient من مكتبة دعم Wear إلى AndroidX وإتاحة إضافة OAuth PKCE (I3eaaa)
Wear-Remote-Interactions الإصدار 1.0.0-alpha02
10 آذار (مارس) 2021
تم طرح androidx.wear:wear-remote-interactions:1.0.0-alpha02
. يحتوي الإصدار 1.0.0-alpha02 على عمليات التنفيذ هذه.
الميزات الجديدة
- نقل فئة PlayStoreAvailability من مكتبة Wearable Support Library إلى AndroidX التي توفّر واجهة برمجة تطبيقات للتحقّق مما إذا كان "متجر Play" متاحًا على الهاتف
إصلاح الأخطاء
- نقل الصف الدراسي PlayStoreStore من Wearable Support Library إلى 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 على عمليات التنفيذ هذه.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة دعم للحالات الأكثر تعقيدًا. وهي تتكون من نموذج (أو عدة أجزاء) وسلسلة من الأجزاء التي سيتم استخدامها لملء العناصر النائبة للنموذج. تتضمّن OngoingActivityStatus الآن طريقة ثابتة لإنشاء حالات بسيطة تتألف من جزء واحد فقط (نص أو موقّت)، و"أداة إنشاء" لإنشاء حالات أكثر تعقيدًا. (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 على هذه المراجعات.
تغييرات واجهة برمجة التطبيقات
نقل مكتبة "الأنشطة الجارية" إلى مكتبة فرعية جديدة: wear-ongoing تتوفّر الصفوف الآن في حزمة androidx.wear.oncomplete (وكانت سابقًا androidx.wear.onlaunchactivities) (I7c029).
أنشئ مكتبة دعم جديدة تحتوي على فئات تتيح التفاعلات من الأجهزة القابلة للارتداء إلى الهواتف. تتم تعبئة هذا الحقل في البداية بفئات تم نقلها من مكتبة دعم الأجهزة القابلة للارتداء. (Id5180)
نقل فئة PhoneDeviceType من مكتبة Wearable Support Library إلى AndroidX تمت إعادة تسمية الفئة التي تم نقلها باسم PhoneTypeHelper التي تقدّم طرقًا مساعدة لتحديد نوع الهاتف الذي تم إقران الساعة الحالية به، وذلك للاستخدام على الأجهزة القابلة للارتداء فقط. (Ibd947)
أنشئ مكتبة دعم جديدة تحتوي على فئات تتيح التفاعلات بين الأجهزة القابلة للارتداء والهواتف. تتم تعبئة هذا الحقل في البداية بفئات تم نقلها من مكتبة دعم الأجهزة القابلة للارتداء. (I9deb4)
نقل فئة WatchFaceCompanion من مكتبة Wearable Support Library إلى 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 وComplicationsPreviewData وComplicationsDataSourceInfo. (I761d9)
- EditorSession#userStyle هي الآن
MutableStateFlow<UserStyle>
(I32ca9). - يستخدم EditorSession.createOnWatchEditorSession الآن أداة مراقبة مراحل النشاط ويتم إغلاقه تلقائيًا عند رصد onDestroy. بالإضافة إلى ذلك، لا تتطلّب
createOnWatchEditorSession
الآن سوى تمرير النشاط. تم أيضًا تطبيق تغييرات مماثلة على ListenableEditorSession. (Ic6b7f) - تمت إعادة إنشاء CustomValueUserStyleSetting كجزء من واجهة برمجة التطبيقات المتاحة للجميع. (I2e69a)
- يكتسب
UserStyle
الآن القيمة منMap<UserStyleSetting, UserStyleSetting.Option>
ويُعرِضMutableUserStyleSetting#put
IllegalArgumentException إذا لم يكن الإعداد مضمّنًا في المخطّط أو إذا لم يتطابق الخيار مع الإعداد. (Iba40f)
الإصدار 1.0.0-alpha21
1 أيلول (سبتمبر) 2021
تم طرح androidx.wear:wear-*:1.0.0-alpha21
. يحتوي الإصدار 1.0.0-alpha21 على هذه عمليات التنفيذ.
تغييرات واجهة برمجة التطبيقات
- تستخدم الآن جميع واجهات برمجة التطبيقات العامة لخلفيات شاشة الساعة والعملاء والمحرِّرين والعناصر المخصّصة واجهة java.time.Instant للوقت بدلاً من Long، ونتيجةً لذلك، ارتفع الحد الأدنى لمستوى واجهة برمجة التطبيقات إلى 26. (I3cd48)
- تستخدم الآن واجهات برمجة التطبيقات لخلفية شاشة الساعة وواجهات برمجة التطبيقات الإضافية تنسيق ZonedDateTime غير القابل للتغيير بدلاً من "تقويم Google". (I25cf8)
- تم الآن إعداد ComplicationSlots باستخدام NoDataComplicationData، وأصبحت ComplicationSlot.complicationData تحتوي دائمًا على قيمة، ولم تعُد CanvasComplicationDrawable.complicationData قابلة للتغيير. (I4dfd6) يقلل هذا الإجراء من وميض الإضافات (ولكن لا يوقفه تمامًا) عند التبديل بين خلفيات شاشة الساعة.
الإصدار 1.0.0-alpha20
18 آب (أغسطس) 2021
تم إصدار androidx.wear:wear-*:1.0.0-alpha20
. يحتوي الإصدار 1.0.0-alpha20 على هذه المراجعات.
التغييرات في واجهة برمجة التطبيقات
- أضفنا createFallbackPreviewData إلى ComplicationDataSourceInfo التي يمكن استخدامها عندما يعرض ComplicationDataSourceInfoRetriever.retrievePreviewComplicationData قيمة فارغة. (I38c4d)
- تم تحويل ComplicationDataSourceUpdateRequester إلى واجهة للسماح بالمحاكاة في اختبارات الوحدة. يمكنك إنشاء عنصر ComplicationDataSourceUpdateRequester محدّد باستخدام ComplicationDataSourceUpdateRequester.create(). (I7da22)
- تم استبدال RenderParameters.pressedComplicationSlotIds بـ RenderParameters.lastComplicationTapDownEvents الذي يعرِض فئة TapEvent الجديدة التي تحتوي على ثلاثية من إحداثيات x وy للنقرة بالبكسل والطابع الزمني. تم استبدال
WatchFace.TapListener.onTap
بـonTapEvent(@TapType tapType: Int, tapEvent: TapEvent)
. بالإضافة إلى ذلك، تمت إزالةInteractiveWatchFaceClient.displayPressedAnimation
. (Id87d2) - تمت إضافة تعليق توضيحي لسلاسل المحادثات الصريحة لـ setImportantForAccessibility (I990fa)
- تم نقل ComplicationSlotBoundsType إلى androidx-wear-watchface.ComplicationSlotBoundsType in wear/wear-watchface. (I09420)
- لقد أضفنا دعمًا لتمرير معرّفات موارد السلاسل إلى UserStylesetting وOptions. وهذه هي الطريقة الموصى بها لإنشاء تلك الكائنات. (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) - لقد أزلنا أدوات إنشاء UserStyleSetting التي تأخذ CharSequence من واجهة برمجة التطبيقات العامة. ويُنصَح باستخدام الدوال الإنشائية التي تتطلّب معرّفات 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
، وتمّت إعادة تسمية جميع الصفوف التي تحتوي على Provider في اسمها بالطريقة نفسها. (Iaef0b) - تم نقل
CanvasComplication.isHighlighted
إلىRenderParameters.pressedComplicationSlotIds
، وهذه خطوة نحو جعلCanvasComplication
بدون حالة. لتطبيق هذا التغيير، يستخدمCanvasComplication.render
أيضًاslotId
كمَعلمة، ونمرر الآنComplicationSlot
إلىGlesTextureComplication
. (I50e6e) - أضفنا
headlessDeviceConfig
إلىEditorRequest
، وإذا لم تكن هذه المَعلمة فارغة، يتم استخدامها لإنشاء مثيل بدون واجهة مستخدم لدعم EditorSession بدلاً من التصرّف في المثيل التفاعلي. يتيح ذلك استخدام المحرِّر لخلفية شاشة ساعة غير الخلفية الحالية. (I0a820) - أضفنا
WatchFaceMetadataClient
تجريبيًا يتيح استرجاع البيانات الوصفية الثابتة لخلفية شاشة الساعة بكفاءة، مثلUserStyleSchema
والتفاصيل الثابتة عنComplicationSlots
. (I6bfdf) - لقد أعادنا تسمية
CanvasRenderer.uiThreadInit
إلى init. (I6fff9) - لقد أضفنا مَعلمة PreviewPreviewParams جديدة اختيارية لـ EditorRequest، وهي توجِّه موجّه EditorSession إلى أخذ لقطة شاشة للمعاينة عند الالتزام بهذه المعلمة. تظهر صورة المعاينة على
EditorState.previewImage
. (Ic2c16)
إصلاح الأخطاء
- لم يعُد على المطوّرين إضافة ComplicationHelperActivity إلى البيان الخاص بهم. (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
حسب الاستخدام. تمت إعادة تسمية الفئات التي تستخدم Complication بالطريقة نفسها، مثل ComplicationsManager التي أصبحت الآن تُعرف باسم ComplicationSlotsManager. (I4da44) - في GlesRenderer، تم استبدال
makeUiThreadContextCurrent
وmakeBackgroundThreadContextCurrent
بـrunUiThreadGlCommands
وrunBackgroundThreadGlCommands
اللذان يقبلانRunnable
. لا تكون هذه الدوالّ مطلوبة إلا إذا كنت بحاجة إلى إجراء طلبات GL خارج عمليات التقديم وrunBackgroundThreadGlCommands
وonUiThreadGlSurfaceCreated
. هذا مطلوب لأنّه يمكن أن يكون هناك عدة عناصر GlesRenderer لكل منها سياقاتها الخاصة في العملية نفسها، وقد تكون من خلفيات شاشة ساعة مختلفة. بالإضافة إلى ذلك، تتم مزامنة الوصول إلى سياق 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 لتسهيل مشاركة الحالة في كل من Renderer و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)
- إصلاح مشاكل "محرر خلفيات شاشة الساعة" في الإصدارات السابقة من نظام التشغيل (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
الذي يعرض خريطة لرموز Complication Ids إلى DefaultComplicationProviderPolicies وComplicationType التلقائي. وهذا أسرع من إنشاء مثيل بدون واجهة مستخدم، لأنّه لا يحتاج إلى بدء تشغيل خلفية شاشة الساعة بالكامل لتنفيذ الطلب.
أخيرًا، يتم الآن إنشاء الإضافات باستخدام CanvasComplicationFactory الذي يتيح إنشاء عناصر عرض CanvasComplication بشكل غير متزامن.
التغييرات في واجهة برمجة التطبيقات
- تم استبدال
@TargetApi
بـ@RequiresApi
. (I0184a وb/187447093 وb/187447094) - لقد طرحنا
WatchFaceControlClient.getDefaultProviderPoliciesAndType
الذي يعرض خريطة لرموز Complication Ids إلى DefaultComplicationProviderPolicies وComplicationType التلقائي. يتم استخدام مسار سريع قدر الإمكان لتجنُّب إنشاء خلفية شاشة الساعة بالكامل. لتسهيل ذلك، كان علينا تغيير واجهة برمجة التطبيقات WatchFaceService API باستخدام طريقتَين جديدتَين هما createUserStyleSchema وcreateComplicationsManager، ويتم تمرير نتائجهما إلى createWatchFace. بالإضافة إلى ذلك، تم الآن إنشاء "Complications" (الإضافة) باستخدام CanvasComplication المصنع الذي يسمح بالإنشاء الكسول لبرامج عرض CanvasComplication. (Iad6c1) - لقد أزلنا MOST_RECENT_APP من SystemProviders. (I3df00)
- أصبحت ObservableWatchData الآن فئة مختومة. (Ic940d)
- يتم الآن استدعاء CanvasComplicationFactory.create (الذي يكون مرتبطًا عادةً بعمليات الإدخال/الإخراج) في سلسلة مهام في الخلفية لكلّ شاشة معلومات مصغّرة قبل بدء عرض سلسلة مهام واجهة المستخدم. هناك حاجز ذاكرة بين الإنشاء والعرض، لذا لا يلزم استخدام عناصر أساسية خاصة لإنشاء مؤشرات الترابط. (Ia18f2)
- يتم الآن إنشاء خلفية شاشة الساعة في سلسلة مهام في الخلفية على الرغم من أنّه يتم تنفيذ جميع عمليات التقديم في سلسلة مهام واجهة المستخدم، ويتوافق GlesRenderer مع سياقَين مرتبطَين لدعم ذلك. قد يتم حلّ WatchFaceControlClient.createHeadlessWatchFaceClient وWatchFaceControlClient.getOrCreateInteractiveWatchFaceClient قبل اكتمال WatchFaceService.createWatchFace. سيتم حظر طلبات البيانات اللاحقة من واجهة برمجة التطبيقات إلى أن تكتمل عملية إعداد خلفية شاشة الساعة. (Id9f41)
- لم يعد EXPANSION_DP وSTROKE_WIDTH_DP ظاهرتين في ملف api.txt. (I54801)
- لقد جعلنا EditorSession.createOnWatchEditingSession يُرسِل TimeoutCancellationException في حال حدوث خطأ بدلاً من إرسال جلسة فارغة. بالإضافة إلى ذلك، أصبحت القيمة المعروضة لـ EditorRequest.createFromIntent وEditorSession.createOnWatchEditingSession الآن NonNull. (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)
الإصدار 1.0.0-alpha13 من إضافات خلفية شاشة الساعة وتطبيق Wear
5 أيار (مايو) 2021
تم إصدار androidx.wear:wear-*:1.0.0-alpha13
. يحتوي الإصدار 1.0.0-alpha13 على هذه عمليات التنفيذ.
الميزات الجديدة
يمكن أن تتضمّن خلفيات شاشة الساعة عناصر مرئية مهمة غير الوقت والعناصر المعقدة. لتوفير إمكانية استخدام قارئ الشاشة لهذه الميزة، يمكن الآن لخلفية شاشة الساعة تحديد تصنيفات ContentDescriptionLabels لتسهيل الاستخدام من خلال سمة additionalContentDescriptionLabels في Renderer. بالإضافة إلى ذلك، تمّت إضافة accessibilityTraversalIndex إلى التعقيدات للتحكّم في ترتيب ContentDescriptionLabels. ويمكن تعديل هذا الإعداد من خلال الإعداد ComplicationsUserStyleSet.
لتشجيع المطوّرين على مراعاة برامج قراءة الشاشة بعناية، جعلنا حقل
contentDescription
فيShortTextComplicationData.Builder
وLongTextComplicationData.Builder
وRangedValueComplicationData.Builder
إلزاميًا ليتم تمريره إلى منشئيها. إذا تمّ إدخالComplicationText.EMPTY
بدلاً منcontentDescription
، سيتمّ إنشاءcontentDescription
تلقائيًا من النص والعنوان.تعرض ميزة "
WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient
" الآنServiceStartFailureException
في حال طرحت خلفية شاشة الساعة استثناءً أثناء عملية الإعداد، ما يسهّل تشخيص المشاكل أثناء بدء تشغيل خلفية شاشة الساعة.
التغييرات في واجهة برمجة التطبيقات
- أضفنا إمكانية استخدام اسم مكوّن فارغ في ComplicationProviderInfo، وهو مطلوب لتوفير التوافق مع الإصدارات القديمة من Wear OS. (I744d2)
- لقد نقلنا
androidx.wear.complications.SystemProviders
من Java إلى Kotlin. (Ia1f8b) - لقد أخفينا جميع الفئات من واجهة برمجة التطبيقات العامة الموجودة في الإضافة android.support.wearable.comComputes وأنشأنا برامج تضمين مقابلة في AndroidX حسب الحاجة. (I7bd50)
- تمت إعادة تسمية الطريقة في
TimeDifferenceComplicationText.Builder
منsetMinimumUnit
إلىsetMinimalTimeUnit
. (I20c64) - جعلنا حقلي
ShortTextComplicationData.Builder
وLongTextComplicationData.Builder
وRangedValueComplicationData.Builder
contentDescription
إلزاميًا في الدالة الإنشائية. (I8cb69) - لقد أعادنا تسمية ComplicationProviderService.onComplicationUpdate إلى onComplicationRequest و أدرجنا مَعلمتَي id وtype لهذه الطريقة في بيانات ComplicationRequest. تمت إعادة تسمية المستمع المقابل إلى ComplicationRequestListener وطريقة ComplicationRequestListener.onComplicationData. (Iaf146)
- أزلنا الطريقة
isActiveAt
منComplicationData
وعرضنا الحقلvalidTimeRange
بدلاً منها. يمكن استبدال استدعاء الطريقة هذا بـvalidTimeRange.contains
. (I65936) - غيَّرنا وصف الطريقة ComplicationProviderService.onComplicationActivated لتلقّي ComplicationType بدلاً من int. (Idb5ff)
- تم نقل ProviderUpdateRequester من Java إلى Koltin. (Ibce13)
- أصبحت GlesRender.makeContextCurrent علنية الآن. قد يحتاج رمز خلفية شاشة الساعة إلى إجراء استدعاءات gl خارج العرض وonGlContextCreated، لأنّه قد يكون من الضروري توفّر سياق تفاعلي وآخر بلا واجهة مستخدم رسومية. (I8a43c)
- يُعرِض WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient الآن ServiceStartFailureException إذا تعرّضت خلفية شاشة الساعة لخطأ أثناء الإعداد. بالإضافة إلى ذلك، تُرسِل WatchFaceService الآن استثناءً إذا استغرقت createWatchFace أكثر من 6 ثوانٍ. (I59b2f)
- لقد أزلنا سمة id غير المستخدَمة للموقع الإلكتروني
GlesTextureComplication
. (I28958) - يمكن الآن لخلفية شاشة الساعة تحديد ContentDescriptionLabels لسهولة الاستخدام من خلال خاصية additionalContentDescriptionLabels في
Renderer
. بالإضافة إلى التحكّم في ترتيب ContentDescriptionLabels، تمت إضافة accessibilityTraversalIndex إلى المضاعفات. ويمكن تعديل ذلك باستخدام ComplicationsUserStyleSetting. (Ib7362) - توسيع المستندات حول معالجة أحداث اللمس في خلفية شاشة الساعة (Iaf31e)
إصلاح الأخطاء
- تعرض
EditorSession.getComplicationsPreviewData()
الآن خريطة لكل تطبيقات مصغّرة غير فارغة فقط. يتم استخدام مثيل EmptyComplicationData للعناصر المعقدة الفارغة. (I1ef7e)
الإصدار 1.0.0-alpha12 من الإضافات وخلفيات شاشة الساعة على Wear
21 نيسان (أبريل) 2021
تم طرح androidx.wear:wear-*:1.0.0-alpha12
. يحتوي الإصدار 1.0.0-alpha12 على هذه المراجعات.
الميزات الجديدة
على محرِّري خلفيات شاشة الساعة إبراز أجزاء من خلفية شاشة الساعة للمساعدة في توضيح جانب الساعة الذي يتم ضبطه. لقد وسّعنا نطاق RenderParameters للسماح بتمييز الأنماط بالإضافة إلى التعقيدات. هناك طبقة اختيارية جديدة من HighlightLayer مخصّصة لتطبيق تأثير التمويه على خلفية شاشة الساعة مع شفافية ألفا (يمكن لواجهات برمجة التطبيقات لأخذ لقطات الشاشة تطبيق هذا التمويه نيابةً عنك، أو توفير طبقة HighlightLayer بمفردها لتحقيق أقصى قدر من المرونة). على سبيل المثال، لنفترض أنّ لديك نمطًا يتيح لك ضبط مظهر عقارب الساعة، ويمكن لبرنامج الربط في renderHighlightLayer رسم مخطط حولها.
لتعزيز إتاحة ميزة "موفِّر المكوّنات الإضافية" للوصول، جعلنا حقل contentDescription في PhotoImageComplicationData.Builder وMonochromaticImageComplicationData.Builder و SmallImageComplicationData.Builder مَعلمة إلزامية لإنشاء العنصر. تمت إضافة ComplicationTapFilter وComplication.createEdgeComplicationBuilder لإتاحة المضاعفات على الحواف (المرسومة حول حافة الشاشة). تُترك عملية عرض الإضافات على الحواف واختبار مدى توفّرها لخلفية شاشة الساعة. لا يتوفّر اختبار نتائج الإعلانات على Edge من "أداة التعديل المصاحبة".
التغييرات في واجهة برمجة التطبيقات
- تمت إضافة البادئة
PROVIDER_
إلى الثوابت في SystemProviders. (I1e773) - لقد جعلنا حقل
contentDescription
في كل منPhotoImageComplicationData.Builder
وMonochromaticImageComplicationData.Builder
وSmallImageComplicationData.Builder
إلزاميًا لإرساله في دالة الإنشاء. (I9643a) - تمت إعادة تسمية
ProviderInfoRetriever.requestPreviewComplicationData
إلىretrievePreviewComplicationData
. (I911ee) - تم نقل
ComplicationProviderService
من Java إلى Koltin. (I849f2) - أصبحت الطريقة
ComplicationProviderService.onBind
نهائية (I39af5) - أعدنا واجهة
CanvasComplication
ونقلناCanvasComplicaitonDrawable
وGlesTextureComplication
وComplicationHighlightRenderer
إلىwear-watchface-complications-rendering
. (I84670) - تمّت إعادة صياغة
RenderParameters
لتتوافق مع ميزة عرض الإضاءة المميّزة الإضافية. أصبح من الممكن الآن طلب عرض الإشعارات المهمة للأنماط بالإضافة إلى جميع التعقيدات أو تعقيد واحد. بالإضافة إلى ذلك، يتضمّن CanvasRenderer وGlesRenderer طريقة جديدة مجردة لعرض الطبقة المميّزة لعرض أي تمييز يطلبه المحرِّر. تمت إعادة تسمية الطبقة إلى 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 الآن ComplicationText بدلاً من TimeDependentText في مكتبة دعم الأجهزة القابلة للارتداء القديمة. (I80c03)
- لا يمكن ضمان توفّر التطبيق
SystemProviders.GOOGLE_PAY
على جميع أجهزة Android R، لذا تمت إزالته من القائمة. لا يزال بإمكانك استخدام هذا الموفِّر من خلالDefaultComplicationProviderPolicy
(If01b5). - لقد أعدنا تسمية ComplicationUpdateCallback إلى ComplicationUpdateListener من أجل الاتساق. (I61ec7)
- تم تغيير خريطة تنسيق السلك لـ UserStyle إلى
Map<String, byte[]>
، ولتسهيل الأمر، تمت إضافة فئةUserStyleData
إلى واجهة برمجة التطبيقات العامة، ويتم استخدامها الآن من قِبل wear-watchface-client وwear-watchface-editor. بالإضافة إلى ذلك، أصبحت قيمة CustomValueUserStyleSetting.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) - تمت إعادة تسمية أحداث WatchFace TapType لتتطابق مع MotionEvents / Compose. (I0dfd0)
- تمت إعادة تسمية takeWatchfaceScreenshot ليصبح renderWatchFaceToBitmap، وتمت إعادة تسمية takeComplicationScreenshot ليصبح 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 الآن ClientConnectedListener و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 المختلفة الخاصة بتطبيق Wear وWatchface وClient، ومن المفترض أن تكون ضرورية. (Icc4c0)
- لتحقيق الاتّساق، تمت إعادة صياغة
EditorServiceClient
لاستخدام المستمعين بدلاً من المراقبين. (Iec3a4) - أضفنا بضعة تعليقات توضيحية
@Px
غير متوفّرة إلىInteractiveWatchFaceSysUiClient
وWatchFaceControlClient
. (I3277a) - تمت إعادة تسمية EditorObserverCallback إلى EditorObserverListener لتحقيق الاتساق. (Ie572d)
- يقتصر العنصر EditorState.watchFaceInstanceId على مستوى واجهة برمجة التطبيقات Android R والإصدارات الأحدث، ولم يعُد قابلاً للقيمة الخالية. (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 وشاشة الساعة. أصبح بإمكان المحرِّر الآن تحديد ما إذا كان تغيير النمط سيؤدي إلى تفعيل ميزة أو إيقافها (enabled = initiallyEnabled بالإضافة إلى أي إلغاء من ComplicationsUserStyleSetting). وتسمح أيضًا
EditorService.closeEditor
لأداة SysUI بإغلاق محرّر خلفية شاشة الساعة عن بُعد إذا لزم الأمر. - بالإضافة إلى ذلك، يمكنك استخدام
InteractiveWatchFaceWcsClient.setUserStyle
باستخدام الأمرupdateInstance
الأكثر فعالية الذي يغيّر معرّف المثيل وتحديد النمط ومحو جميع الإضافات في آنٍ واحد.
التغييرات في واجهة برمجة التطبيقات
- تمت إضافة TraceEvents إلى مكتبات خلفيات شاشة الساعة. (I1a141)
- يحتوي
ComplicationState
الآن على خاصيّة جديدةinitiallyEnabled
وهي مفيدة لتوقّع نتائج تبديل الأنماط. (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 على هذه المراجعات.
الميزات الجديدة
- تم تصميم بعض خلفيات شاشة الساعة استنادًا إلى إضافة واحدة أو أكثر، ولتسهيل ذلك، أضفنا Complication.Builder#setFixedComplicationProvider الذي يمنع المستخدم من تغيير الإضافة في هذا المربّع إذا تم ضبطه على "صحيح".
- تكون مكتبات خلفية خلفيات شاشة الساعة مكتوبة بلغة Kotlin أولاً وتستخدم وحدات معالجة المهام المتزامنة (مثل الدوال التي تتوقّف مؤقتًا). وفّرنا لمستخدمي Java برامج دمج ListenableFuture لتحسين إمكانية التشغيل التفاعلي في المكتبات التالية: wear/wear-watchface-guava وwear/wear-watchface-client-guava &wear/wear-watchface-editor-guava.
تغييرات واجهة برمجة التطبيقات
- لقد أزلنا ميزة النقرات المزدوجة على الإضافات التي تطلق أداة اختيار الموفّر، ولم تكن هذه الميزة شائعة في خلفيات شاشة الساعة، ما أدّى إلى تعقيد عملية تنفيذ SysUI. (I3ef24)
- قد تؤدي طرق ProviderInfoRetriever إلى ظهور Service مساعدتك على وجه الاستثناء في حال إغلاق المثبت بشكل غير متوقع. (Ib2cc4)
- بدءًا من نظام التشغيل Android 11 والإصدارات الأحدث، هناك قيود على وقت تشغيل أداة ProviderSelectr، إضافةً إلى ذلك، نودّ إنشاء أدوات تحرير باستخدام
wear-watchface-editor
الجديد، لذلك ستتم إزالة ComplicationHelperActivity من واجهة برمجة التطبيقات العامة. (Ib19c1) - أزِل الطرق الثابتة ComplicationText واستخدِم أدوات الإنشاء بدلاً منها. (Ibe399)
- لقد طرحنا لفائف guava ListenableFuture للطرق المعلّقة المختلفة في مكتبة خلفيات شاشات الساعة. (I16b2c)
- لتوضيح واجهة برمجة التطبيقات، أضفنا عنصر إنشاء ثانويًا إلى RenderParameters لا يتطلّب درجة لون، وذلك لاستخدامه مع LayerModes بخلاف
LayerMode.DRAW_OUTLINED
. (I497ea) - في السابق، كان ListUserStyleSetting مختلفًا عن الآخر لأنّه كان يحتوي على مَعلمة تلقائية. الآن تأخذ جميع دوال إنشاء الفئة الفرعية Stylesetting القيمة الافتراضية أخيرًا. (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 الآن دالة تعليق، ما يعني أنّه لم يعُد على خلفية شاشة الساعة حظر سلسلة مهام واجهة المستخدم أثناء انتظار عمليات الإدخال والإخراج. وبالمثل، wear-watchface-editor وwear-complications-data
التغييرات في واجهة برمجة التطبيقات
- إزالة فئة PhotoImage واستخدام رمز Icon مباشرةً (I8a70b)
- اعرض النطاق الزمني الصالح لـ ComplicationData. (I91366)
- اجعل السمات التي تشبه الصور أكثر وضوحًا. (I81700)
- تمّت إعادة صياغة wear-watchface-editor وwear-complications-data لاستخدام دوالّ التعليق بدلاً من الدوالّ المتعدّدة المهام. ستتوفّر لاحقًا حِزم Rx java وFuture compat wrappers. (If3c5f)
- يُعرِض ProviderInfoRetriever الآن PreviewNotAvailableException إذا تعذّر على requestPreviewComplicationData عرض بيانات المعاينة بسبب مشاكل في الاتصال أو عدم توفّر واجهة برمجة التطبيقات. (I4964d)
- أصبحت WatchFaceControlService::createWatchFaceControlClient الآن وظيفة معلّقة، وتم استبدال getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient باسم getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClientAsync الذي يعرض القيمة
Deferred<InteractiveWatchFaceWcsClient>
. ستتوفّر لاحقًا حِزم RX java وFuture compat. (I5d461) - إعادة تسمية "
CATEGORY_PROVIDER_CONFIG_ACTION
" إلى "CATEGORY_PROVIDER_CONFIG
" (I7c068) - يُرجى العِلم أنّ createOnWatchEditingSession أصبحت الآن وظيفة معلّقة لأنّ خلفية شاشة الساعة لا تكون متاحة أحيانًا إلا بعد وقت قصير من بدء نشاط المحرِّر. (Ida9aa)
- أصبحت WatchFaceService.createWatchFace الآن دالة تعليق تتيح الإعداد غير المتزامن، وكان عليك في السابق حظر سلسلة التعليمات الرئيسية. (If076a)
- أصبح لـ UserStyle الآن عامل تشغيل صفيف، وأضفنا مساعدات البث إلى UserStyle.Option. (I35036)
- لقد أصلحنا خطأ في تنسيقات بيانات UserStyle التي تؤدي إلى تغيير بعض واجهات برمجة التطبيقات المخفية غير المستقرة. (I8be09)
- أضفنا CustomValueUserStyleSetting الذي يتيح لك تخزين سلسلة واحدة خاصة بالتطبيق ضمن UserStyle. سيتجاهل محرّرو خلفيات شاشة الساعة التلقائية هذه القيمة. (Ic04d2)
- لا يتم تمرير InstanceID في إضافات النية لنظام التشغيل R والإصدارات الأقدم من Android WearOS التي لا يمكننا ترقيتها. لإتاحة ذلك، نسمح الآن بأن يكون InstancID فارغًا. (Id8b78)
- يتضمّن EditorRequest الآن اسم مكوّن المحرِّر الذي تم ضبطه كمكوّن في WatchFaceEditorContract.createIntent (I3cd06).
- يتضمّن العنصر EditorResult في خلفية شاشة الساعة الآن معاينة ComplicationData للسماح للمتصل بالتقاط لقطة شاشة لخلفية شاشة الساعة بعد التعديل. (I2c561)
إصلاح الأخطاء
- تمت إضافة عمليات إلغاء toString() إلى UserStyle وUserStyleSetting وUserStyleSchema، ما يسهّل التعامل مع هذه الفئات. (I9f5ec)
الإصدار 1.0.0-alpha06
27 كانون الثاني (يناير) 2021
تم إصدار androidx.wear:wear-*:1.0.0-alpha06
. يحتوي الإصدار 1.0.0-alpha06 على هذه المراجعات.
الميزات الجديدة
- لقد طرحنا مكتبة جديدة باسم wear/wear-watchface-editor تتيح لمطوّري خلفيات شاشات الساعة والمصنّعين الأصليين للأجهزة إنشاء محرِّر للأنماط والإضافات. سيرسل SysUI طلبًا إلى خلفية شاشة الساعة التي ستستخدم فئة EditorSession الجديدة للوصول إلى تفاصيل خلفية شاشة الساعة وتسجيل النتيجة من خلال Activity.setWatchRequestResult. لإتاحة هذه العملية، أضفنا ProviderInfoRetriever.requestPreviewComplicationData. بهذه الطريقة، يمكن لمحرّري خلفية شاشة الساعة طلب معاينة ComplicationData. تتمثل ميزة معاينة ComplicationData في أنّه على عكس البيانات النشطة، لا داعي للقلق بشأن عرض مربّعات حوار الأذونات عند عرض المحرِّر (يُرجى العِلم أنّه إذا اختار المستخدم مقدّم خدمة لديه إذن، سيظلّ مطلوبًا منه منح الإذن).
تغييرات واجهة برمجة التطبيقات
- يحتوي ComplicationProviderInfo الآن على حقل لـ ComponentName الخاص بالموفّر، وسيتم إضافة دعم لهذا الحقل إلى WearOS في وقت لاحق، وفي الوقت الحالي، سيكون حقلًا فارغًا. (Id8fc4)
- أضفنا ProviderInfoRetriever.requestPreviewComplicationData الذي يسمح لمحرِّري خلفيات الشاشة على الساعة بطلب معاينة ComplicationData. ويُعدّ ذلك مفيدًا لأنّ التطبيقات المخصّصة للأجهزة الجوّالة التي تعرض معلومات مباشرة قد تتطلّب أذونات، ويمكنك الآن عرض بيانات المعاينة للتطبيقات المخصّصة للأجهزة الجوّالة التي لا تعرض معلومات مباشرة. (I2e1df)
- أصبحت ComplicationManager الآن مَعلمة اختيارية لدالة إنشاء WatchFace، وتم إعادة ترتيب الوسيطات للسماح بذلك. (I66c76)
- لقد أضفنا حِزمة اختيارية إلى "الإضافات"، والتي في حال دمجها بهدف إرسال نشاط أداة اختيار الموفّر. (Ifd4ad)
- لقد أضفنا مكتبة جديدة من "
wear-watchface-editor
" لتوفيرها على خلفية شاشة الساعة وأدوات التحرير التي تستضيفها SysUi. سيشغِّل SysUI هذه المحرِّرين من خلال إرسال هدف. يمكن لخدمة نشاط خلفية شاشة الساعة استخدام فئة EditorSession الجديدة للوصول إلى تفاصيل WatchFace وتسجيل النتيجة من خلال Activity.setWatchRequestResult. (I2110d) - تم تغيير اسم LayerMode.DRAW_HIGHLIGHTED إلى LayerMode.DRAW_OUTLINED وتم تغيير اسم RenderParameters.highlightComplicationId إلى RenderParameters.selectedComplicationId الذي يرسم تمييزًا على التعقيد المحدّد بالإضافة إلى مخطط. (I90a40)
- يمكن الآن حلّ مستقبل WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient باستخدام ServiceStartFailureException إذا توقّفت الخدمة أثناء انتظار إنشاء خلفية شاشة الساعة. (I0f509)
- أصبح EditorSession.complicationPreviewData الآن عنصر ListenableFuture لأنّ جلب هذه البيانات عملية غير متزامنة. (Iead9d)
إصلاح الأخطاء
- نعمل على إزالة الحقول غير المستخدمة من ComplicationOverlay وتركها مفعَّلة و ComplicactionBounds. (I17b71)
الإصدار 1.0.0-alpha05
13 كانون الثاني (يناير) 2021
تم طرح androidx.wear:wear-*:1.0.0-alpha05
. يحتوي الإصدار 1.0.0-alpha05 على هذه عمليات التنفيذ.
الميزات الجديدة
غالبًا ما تتوافق خلفيات شاشة الساعة مع عدد من إعدادات الإضافات مع عرض أعداد مختلفة من الإضافات. لتسهيل عملية الإعداد، أصبح بإمكانك الآن استخدام ميزة "التطبيقات المصغّرة" المتوقفة عن العمل في البداية من خلال استدعاء setEnabled(false) في أداة الإنشاء. ويمكن تفعيلها لاحقًا من خلال ComplicationsUserStyleSetting.
تغييرات واجهة برمجة التطبيقات
- يقبل ComplicationHelperActivity الآن
Collection<ComplicationType>
بدلاً من صفيف int، ما يسهّل استخدامه. (I1f13d) - تعرض ميزة "
ProviderInfoRetriever.retrieveProviderInfo
" الآنListenableFuture<ProviderInfo[]>
بشكل صحيح. (If2710) - يمكنك الآن إنشاء شاشة معلومات مصغّرة غير مفعّلة في البداية من خلال استدعاء setEnabled(false) في أداة الإنشاء. (Idaa53)
- تحتوي WatchFaceState الآن على سمة isHeadless التي تكون صحيحة فقط للمثيلات التي لا تتضمّن واجهة مستخدم. (Ifa900)
- يتيح تطبيق ComplicationDrawable الآن اختياريًا التحميل المتزامن للمواد القابلة للرسم. ويتم استخدام ذلك من خلال واجهات برمجة التطبيقات للقطات الشاشة. (I34d4a)
الإصدار 1.0.0-alpha04
16 كانون الأول (ديسمبر) 2020
تم إصدار androidx.wear:wear-*:1.0.0-alpha04
. يحتوي الإصدار 1.0.0-alpha04 على هذه المراجعات.
الميزات الجديدة
- تتيح الآن مكتبة خلفيات شاشة الساعة على WearOS ضبط الحدود لكل نوع. على سبيل المثال، يمكنك التبديل إلى مربّع حدود واسع لـ ComplicationType.LONG_TEXT مع استخدام مربّع حدود أصغر للأنواع الأخرى.
التغييرات في واجهة برمجة التطبيقات
- تستخدم الإضافات الآن ComplicationBounds التي تلتف حول
Map<ComplicationType, RectF>
لتتوافق مع أحجام أنواع الإضافات المختلفة. (I1ebe7) - تتيح لك RenderParameters الآن تحديد درجة لون التمييز لاستخدامها في لقطات الشاشة. (Iff42b)
- باستثناء الحدود، عليك الآن استخدام ComplicationsUserStyleSetting لتعديل المضاعفات، وذلك لضمان مزامنة نظام التشغيل. (I8dc5d)
- أصبح Renderer الآن فئة مختومة. وهذا يعني أنّ CanvasRenderer وGlesRenderer هما الآن فئتَان داخليتان من Renderer. (Iab5d4، b/173803230)
- تمت إعادة تسمية CanvasComplicationDrawable.drawHighlight ليصبح drawOutline. هناك الآن بعض تعليقات UiThread غير التوضيحية التي لا تتوفّر في أداة ObserableWatchData. تمت الآن إزالة ScreenState بالكامل من WatchState. (If1393)
- أصبح الحد الأدنى لمستوى واجهة برمجة التطبيقات لتطبيق خلفية شاشة الساعة هو 25. يتطلّب دعم لوحة ملاحظة على الجهاز المستوى 26 من واجهة برمجة التطبيقات أو المستويات الأحدث. (Ic9bbd)
- يتضمّن InteractiveWatchFaceWcsClient الآن مساعد getComplicationIdAt. (I05811)
- تم خفض مستوى واجهة برمجة التطبيقات لـ "Wear-watchface-client" إلى 25، غير أنّ واجهات برمجة التطبيقات الخاصة بلقطات الشاشة تتطلب المستوى 27 من واجهة برمجة التطبيقات. (Id31c2)
إصلاح الأخطاء
- نعرض الآن ComplicationType الخاص بـ ComplicationData الحالي للإضافة في ComplicationState. (I9b390)
- يتضمّن InteractiveWatchFaceWcs الآن طريقة bringAttentionToComplication لتمييز المقياس المُحدَّد بشكلٍ موجز. (I6d31c)
- تتضمن الدالة
InteractiveWatchFaceWcsClient#setUserStyle
الآن حِملًا زائدًا يتم قبوله من خلال Map<string, string=""> التي قد تتجنّب إرسال البيانات ذهابًا وإيابًا IPC الإضافية اللازمة لإنشاء UserStyle. (I24eec)</string,>
الإصدار 1.0.0-alpha03
2 كانون الأول (ديسمبر) 2020
تم طرح androidx.wear:wear-*:1.0.0-alpha03
. يحتوي الإصدار 1.0.0-alpha03 على هذه المراجعات.
الميزات الجديدة
تحتوي فئة Complication الآن على سمة compicationData تتيح لوجوه الساعة مراقبة تغييرات ComplicationData. يتيح ذلك تغيير أبعاد الإضافة بناءً على نوع الإضافة.
يمكن الآن استخدام عدد متغيّر من اللقطات في الثانية من خلال ضبط Renderer.interactiveDrawModeUpdateDelayMillis. بالنسبة إلى خلفيات شاشة الساعة التي تحتوي على رسوم متحركة قصيرة كل ثانية، يمكن أن يؤدي هذا إلى توفير الطاقة بشكل جيد من خلال الانتقال إلى وضع السكون عند عدم استخدام الصور المتحركة.
تغييرات واجهة برمجة التطبيقات
- تمت إعادة تسمية "
BACKGROUND_IMAGE
" إلى "PHOTO_IMAGE
" مع الصفوف ذات الصلة. لا يتم استخدام هذا النوع من التعقيدات حصريًا للخلفيات، لذا تم تغيير الاسم. (I995c6) - تم التعليق التوضيحي على DefaultComplicationProviderPolicy بشكل صحيح باستخدام IntDefs. (I3b431)
- لم تعُد فئة TimeDependentText المخفية تظهر من خلال ContentDescriptionLabel، بدلاً من ذلك نضيف أداة وصول للحصول على النص في وقت محدّد. (Ica692)
- أصبح المُنشئ ObservableWatchData داخليًا الآن. (I30121، b/173802666)
- تحتوي إضافة "Complication" الآن على compicationData التي تتيح لخلفيات شاشة الساعة مراقبة تغييرات ComplicationData. تتضمّن الإضافة أيضًا استدعاء isActiveAt جديد يمكن استخدامه لمعرفة ما إذا كان يجب عرض أي شيء في التاريخ والوقت المحدد. (Ic0e2a)
- لم تعُد قيمة
SharedMemoryImage
الفارغة متوفّرة في واجهة برمجة التطبيقات العامة. (I7ee17) - تشتمل
WatchFace.overridePreviewReferenceTimeMillis
الآن على تعليق توضيحي IntRange ، ويكون لكل من get وsetter أسماء متسقة. (Ia5f78) - تم إنشاء
Complication.Builder
الآن من خلالComplication.createRoundRectComplicationBuilder
أوComplication.createBackgroundComplicationBuilder
للتوضيح (I54063) - تمت إضافة WatchFace.TapListener الذي يسمح لخلفية شاشة الساعة برصد النقرات التي لا تستهلكها الإضافات. (Ic2fe1، b/172721168)
- تتيح ميزة WatchFace الآن عددًا متغيرًا من اللقطات في الثانية من خلال ضبطها على
Renderer.interactiveDrawModeUpdateDelayMillis
. يمكن أن يساعد ذلك في الحفاظ على عمر البطارية عن طريق الانتقال إلى وضع السكون في حال عدم الحركة. (I707c9) - لم تعُد WatchFace.Builder مطلوبة، وتم نقل invalidate() وinteractiveUpdateRateMillis إلى Renderer. (I329ea)
- لتحسين إمكانية التشغيل التفاعلي في Java
- تمت إعادة تسمية TapListener إلى TapCallback وInvalidateCallback إلى InvalidateListener من أجل الاتساق. (I9414e)
- تم نقل خيارات أسلوب خلفية شاشة الساعة في Wear 2.0 إلى فئة خاصة بها من أجل الوضوح. تتوفّر الآن أدوات التصنيف المتماثلة في فئة WatchFace. (Iefdfc)
- تمت إضافة InteractiveWatchFaceWcsClient و
WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient
اللذان يحصلان على مثيل حالي أو ينشئانه بعد أن تتصل خدمة خلفية الشاشة وتُنشئ المحرّك. (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) - ComplicationsUserStyleCategory الفئة الجديدة المقترَحة لضبط الإضافات (I96909)
- أضِف واجهة برمجة التطبيقات wear-complication-data API. (I7c268)
- يجب إضافة البادئة is بدلاً من get إلى الدوال التي تعرض قيمًا منطقية (If36ff).
- نصيحة واجهة برمجة التطبيقات هي تجنب استخدام الحماية، ولذلك تمت إعادة ضبط هذه الفئة لتضمين المعلمات عبر الدالة الإنشائية. (I61644)
- أعِد تسمية setBackgroundComplication لزيادة الوضوح. (I96fe3)
- استخدام خصائص Kotlin لعرض بيانات ishighlighted وDataable (I4dcc8)
- بدلاً من ComplicationRenderer.InappropriateateCallback
- يتم إيقاف واجهات برمجة التطبيقات هذه نهائيًا في WearableSupport، وتمّت إزالتها هنا. (Ib425c)
- تمت إعادة تسمية بعض طرق إنشاء خلفية شاشة الساعة للتأكيد على طبيعتها القديمة في Wear OS 2.0. (Idb775)
- أول إصدار تجريبي من واجهة برمجة التطبيقات المعنيّة بواجهة wear/wear-watchface (Id3981)
- أول إصدار تم تتبُّعه من واجهة برمجة التطبيقات. (Ie9fe6)
- إخفاء ComplicationDrawable.BorderStyle IntDef بشكل صحيح والانتقال إلى ComplicationStyle لتحقيق الاتساق (I27f7a)
- إضافة تعليقات توضيحية غير متوفّرة لطرق ComplicationStyle (I838fd)
- لا تتضمّن هذه المكتبة واجهة برمجة تطبيقات عامة (I88e2b).
- أصبحت جميع فئات خيارات فئة الأنماط نهائية بشكل صحيح الآن. (Ib8323)
- أول إصدار تم تتبُّعه من واجهة برمجة التطبيقات. (I27c85)
إصلاح الأخطاء
- تم تغيير ComplicationProviderService لتوفير طريقة getComplicationPreviewData صريحة. (I4905f)
- تم تفعيل فحص lint لواجهة برمجة التطبيقات لـ MissingGetterMatchingBuilder في androidx (I4bbea، b/138602561)
- أعِد تسمية عرض تعقيدات الارتداء. (Ifea02)
- أصبحت أسماء فئات الأنماط الآن سلاسل علامات (I28990).
- استبدال Override (إلغاء) بـ Overlay (تراكب) لمطابقة اصطلاحات تسمية المظاهر والأنماط الحالية (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>
تمت إضافة حاوية تنسيق جديدة، وهي DismissibleFrameLayout، التي تتعامل مع إغلاق التطبيق باستخدام زر الرجوع و/أو التمرير سريعًا للأعلى أو للأسفل، وهي مخصّصة للاستخدام داخل نشاط. يجب إضافة مستمع واحد على الأقل لتنفيذ إجراء الإغلاق. عادةً ما يزيل المستمع طريقة عرض تحتوي على أو جزء من النشاط الحالي. يتم توفير setSwipeSellible(boolean) وsetBackButtonRuleible(boolean) للتحكم بشكل مباشر في الميزات. يهدف هذا التنسيق الجديد إلى استبدال SwipeDismissFrameLayout الحالي.
تمت إضافة إمكانية الإشارة إلى أنّه يمكن "استئناف النشاط تلقائيًا" عندما يخرج الجهاز من وضع الإضاءة السينمائية في فئة AmbientModeSupport. كانت هذه الوظيفة متاحة سابقًا في فئة WearableActivity المتوقّفة نهائيًا من WearableSupportLibrary. (I336ab)
تم نقل فئة Wearable Calendarcalendar من مكتبة الدعم القابل للارتداء. توفّر واجهة برمجة التطبيقات هذه مجموعة فرعية من البيانات المتاحة من خلال CalendarContract، ولكن تتم مزامنتها تلقائيًا مع الأجهزة القابلة للارتداء. (I6f2d7)
تمت إضافة واجهة برمجة تطبيقات جديدة
WearTypeHelper
فيandroidx.wear.utils
لتحديد ما إذا كان جهاز Wear المُعطى مخصّصًا للصين. (Ib01a9)تمت إضافة ميزات تسهيل الاستخدام إلى
androidx.wear.widget.ConfirmationOverlay
التي ستقرأ الرسائل في حال ضبطها متبوعة بوصف للحركة. (I524dd)تم إصلاح الخطأ الذي كان يتسبب في تعطُّل ConfirmationActivity في حال عدم تقديم رسالة. (Ie6055)
تم إصلاح خطأ كان يؤدي إلى اطّلاع
WearableDrawerLayout
على جميع التفاعلات عند التمرير أفقيًا في RecyclerViews. (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 على هذه المراجعات.
إصلاح الأخطاء
- إصلاح الخطأ الذي تسبب في تعطُّل FollowActivity إذا لم يتم تقديم أي رسالة. (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
لتحديد ما إذا كان جهاز Wear المُعطى مخصّصًا للصين. (Ib01a9)
الإصدار 1.2.0-alpha11
30 حزيران (يونيو) 2021
تم إصدار androidx.wear:wear:1.2.0-alpha11
. يحتوي الإصدار 1.2.0-alpha11 على هذه المراجعات.
إصلاح الأخطاء
- تم إصلاح خطأ كان يؤدي إلى اطّلاع
WearableDrawerLayout
على جميع التفاعلات عند التمرير أفقيًا في RecyclerViews. (I24c7f)
الإصدار 1.2.0-alpha10
2 حزيران (يونيو) 2021
تم إصدار androidx.wear:wear:1.2.0-alpha10
. يحتوي الإصدار 1.2.0-alpha10 على هذه عمليات التنفيذ.
الميزات الجديدة
- يُحسِّن الإصدار Alpha10 من إمكانية الوصول إلى النص المنحني وArcLayouts. كما أنها تضيف بعض إعادة التسمية البسيطة في SellibleFrameLayout للمساعدة في توضيح واجهة برمجة التطبيقات.
تغييرات واجهة برمجة التطبيقات
- تمت إعادة تسمية الطرق التالية في الإصدار
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 على هذه المراجعات.
تغييرات واجهة برمجة التطبيقات
- نقل مكتبة "الأنشطة الجارية" إلى مكتبة فرعية جديدة: wear-ongoing أصبحت الفصول متوفرة الآن في حزمة androidx.wear.ongoing (كانت سابقًا androidx.wear.ongoingactivities) (I7c029).
- نقل فئة WearableCalendarContract من مكتبة Wearable Support Library إلى AndroidX توفّر واجهة برمجة التطبيقات هذه مجموعة فرعية من البيانات المتاحة من خلال CalendarContract، ولكن تتم مزامنتها تلقائيًا مع الأجهزة القابلة للارتداء. (I6f2d7)
إصلاح الأخطاء
- يمكنك إيقاف ميزة الإغلاق باستخدام زر الرجوع تلقائيًا في تنسيق الإطار القابل للرفض، وذلك لأنّ ميزة التمرير السريع للإغلاق تظل الطريقة الرئيسية للرجوع في وضع ملء الشاشة على الأجهزة القابلة للارتداء (Ic24e3).
- تم إصلاح بعض المشاكل المتعلّقة بعرض العناصر الفرعية في WearArcLayout (Icf912)
الإصدار 1.2.0-alpha05
13 كانون الثاني (يناير) 2021
تم طرح androidx.wear:wear:1.2.0-alpha05
. يحتوي الإصدار 1.2.0-alpha05 على هذه المراجعات.
إصلاح الأخطاء
- حدِّث javadoc لفئة AmbientModeSupport لتقديم مقتطفات نموذجية لتوضيح الاستخدام العام لهذه الفئة بشكل أفضل.
الإصدار 1.2.0-alpha04
16 كانون الأول (ديسمبر) 2020
تم إصدار androidx.wear:wear:1.2.0-alpha04
. يحتوي الإصدار 1.2.0-alpha04 على هذه المراجعات.
التغييرات في واجهة برمجة التطبيقات
- تمت إضافة إمكانية الإشارة إلى أنّه يمكن "استئناف النشاط تلقائيًا" عندما يخرج الجهاز من وضع الإضاءة السينمائية في فئة AmbientModeSupport. كانت هذه الوظيفة متاحة في السابق في فئة WearableActivity المتوقّفة نهائيًا من WearableSupportLibrary. (I336ab)
- OngoingActivity
- يمكن الآن ضبط الفئة عند إنشاء OngoingActivity، مثل
OngoingActivitiy.Builder.getCategory(String)
. - تتضمّن OngoingActivityData الآن طابعًا زمنيًا لوقت إنشاء OngoingActivity:
OngoingActivityData.getTimestamp()
- (I91cb4)
- يمكن الآن ضبط الفئة عند إنشاء OngoingActivity، مثل
- تمت إضافة إمكانية ضبط الهوامش على عناصر WearArcLayout من خلال تغيير مَعلمات التنسيق لتوسيع MarginLayoutParams، أي أنّ WearArcLayout.LayoutParams يتوسّع إلى android.view.ViewGroup.MarginLayoutParams. (I2cd88)
- يمكنك تغيير نوع الربط التلقائي لـ WearCurvedTextView إلى
WearArcLayout.ANCHOR_CENTER
(كانWearArcLayout.ANCHOR_START
). يؤدي ذلك إلى تبسيط التفاعل بين تنسيق القوس والنص المنحني، لأنّ النص المنحني يرسم نفسه تلقائيًا في أعلى الصفحة على محور x، ويمكن لتنسيق القوس الرئيسي تدويره إلى المكان المطلوب. (I105ff)
الإصدار 1.2.0-alpha03
2 كانون الأول (ديسمبر) 2020
تم إصدار androidx.wear:wear:1.2.0-alpha03
. يحتوي الإصدار 1.2.0-alpha03 على هذه المراجعات.
الميزات الجديدة
حاوية تنسيق جديدة DismissibleFrameLayout، التي تتعامل مع إغلاق الزر "رجوع" و/أو التمرير سريعًا لإغلاق الشاشة، والمخصّصة للاستخدام داخل نشاط يجب إضافة مستمع واحد على الأقل لتنفيذ إجراء الإغلاق. سيزيل المستمع عادةً عرضًا أو جزءًا يحتويان على العنصر من النشاط الحالي. يتم توفير setSwipeDismissible(boolean) وsetBackButtonDismissible(boolean) للتحكّم المباشر في الميزات. يهدف هذا التنسيق الجديد إلى استبدال SwipeDismissFrameLayout الحالي.
يمكن الآن للتطبيقات المصغّرة المنحنية معالجة أحداث اللمس. ستتلقّى التطبيقات المصغّرة العادية داخل 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 على هذه المراجعات.
يضيف هذا الإصدار واجهة برمجة تطبيقات جديدة لخدمة "Ongoing Activities API" للمرة الأولى. يمكن للمطوّرين استخدام واجهة برمجة التطبيقات هذه للإشارة إلى أنّ الأنشطة التي تمارسها لفترة طويلة، مثل تمرين لياقة بدنية أو جلسة تشغيل وسائط جارية. يتيح هذا الإصدار للمطوّرين تقديم إشعارات دورية للحالة، مثل "المسافة والوقت الذي يتم تشغيله" أو "تشغيل المقطع الصوتي الحالي" لعرضه على خلفية شاشة الساعة أو في مشغّل التطبيقات. تستهدف هذه الوظيفة الأجهزة المستقبلية التي تم تفعيل وظيفة "النشاط الجاري" عليها.
التغييرات في واجهة برمجة التطبيقات
- واجهة برمجة تطبيقات جديدة للأنشطة الجارية، وهي غير متاحة على "الأجهزة غير المتوافقة". (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)
Wear-Input 1.2
الإصدار 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)
Wear-Input 1.1.0
الإصدار 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
".- يمكن استخدام هذه الفئة لإنشاء RemoteInput 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
إليها من خلال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 من مكتبة Wearable Support Library إلى AndroidX وتتم إعادة تسمية الفئة التي تم نقلها إلى RemoteInputIntentHelper، والتي توفّر وظائف مساعدة لدعم الإدخالات عن بُعد من خلال بدء هدف. (I47cee)
Wear-Input 1.0.0
الإصدار 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 على هذه المراجعات.
Wear-Input-Testing Version 1.0.0-alpha01
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)
إصدار Wear-Input 1.0.0-alpha01
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. سيؤدي ذلك إلى إزالة خطأ أداة التدقيق في Android Studio لهذه السمات. (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. سيؤدي ذلك إلى إزالة خطأ أداة التدقيق في Android Studio لهذه السمات.
الإصدار 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)