Wear
androidx.wear.activity
androidx.wear.ambient
androidx.wear.input
androidx.wear.utils
androidx.wear.widget
androidx.wear.widget.drawer
(الاطّلاع على المستندات المرجعية لجميع حِزم Wear)
يسرد هذا الجدول جميع العناصر في المجموعة 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 |
wear-ongoing | 1.0.0 | - | - | 1.1.0-alpha01 |
wear-phone-interactions | 1.1.0 | - | - | - |
wear-remote-interactions | 1.1.0 | - | - | 1.2.0-alpha01 |
تعريف التبعيات
لإضافة تبعية على 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.1.0" // Use to implement support for interactions between the Wearables and Phones implementation "androidx.wear:wear-remote-interactions:1.1.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.1.0") // Use to implement support for interactions between the Wearables and Phones implementation("androidx.wear:wear-remote-interactions:1.1.0") }
لمزيد من المعلومات حول العناصر التابعة، يُرجى الاطّلاع على إضافة عناصر تابعة للإنشاء.
الملاحظات
تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.
يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.
الإصدار 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
الإصدار 1.0.0
29 نوفمبر 2023
تم طرح androidx.wear:wear-tooling-preview:1.0.0
. يتضمّن الإصدار 1.0.0 عمليات الدمج هذه.
الميزات في الإصدار 1.0.0
- أضِف
WearDevices
إلى قائمة أجهزة Wear OS الصالحة التي يمكن استخدامها لمعاينة واجهة المستخدم.
الإصدار 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 OS الصالحة التي يمكن استخدامها لمعاينة واجهة المستخدم (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
best effortMaxAngleDegrees
التي يتم احترامها عند توسيع العناصر الفرعية باستخدام الأوزان. على سبيل المثال، يمكنك تثبيت القوس بعدة عناصر فرعية بأوزان على 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) - رسالة وصف المحتوى المحسّنة لـ ConfirmationOverlay (I0fdf8)
- تعديل
ConfirmationOverlay
باستخدام رموز/تنسيق جديد (If5b54)
إصلاح الأخطاء
- تمت إضافة قواعد ProGuard لضمان الاحتفاظ بالرمز ذي الصلة بالبيئة المحيطة (Idaa10)
- تجنُّب إغلاق الأجزاء عن طريق الخطأ في SwipeDismissFrameLayout من خلال التمرير السريع عموديًا (Idb6d8)
- إصلاح ConfirmationOverlay عندما لا تتضمّن رسالة (I63e6f)
المساهمة الخارجية
- Dae Gyu LEE (Samsung) - Avoid accidentally dismissing of fragments in SwipeDismissFrameLayout with a vertical fling (Idb6d8)
الإصدار 1.3.0-alpha01
29 سبتمبر 2021
تم طرح androidx.wear:wear:1.3.0-alpha01
. يحتوي الإصدار 1.3.0-alpha01 على عمليات الإيداع هذه.
إصلاح الأخطاء
- تعمل
ConfirmationOverlay
الآن على دفع الرمز للأعلى لاستيعاب الرسائل الأطول، بدون أن تدخل الرسالة في إطار الجهاز (أو خارج الشاشة). (I54bff)
الإصدار 1.2.0 من Wear-Remote-Interactions
الإصدار 1.2.0-alpha01
2 يوليو 2025
تم طرح androidx.wear:wear-remote-interactions:1.2.0-alpha01
. يحتوي الإصدار 1.2.0-alpha01 على عمليات الدمج هذه.
الميزات الجديدة
- تم تعديل
RemoteActivityHelper.startRemoteActivity
لاستخدام واجهة برمجة تطبيقات Wear SDK عامة جديدة (startRemoteActivity
) إذا كانت متاحة (من Wear 6 والإصدارات الأحدث). (Id1e77)
الإصدار 1.1.0 من Wear Ongoing & Interactions
الإصدار 1.1.0
26 فبراير 2025
تم طرح androidx.wear:wear-phone-interactions:1.1.0
. يحتوي الإصدار 1.1.0 على عمليات الدمج هذه.
التغييرات المهمة منذ الإصدار 1.0.0
- يحتوي هذا الإصدار على إصلاح مهم للأخطاء في التطبيقات التي تعمل على Wear OS 5 (المستوى 34 لواجهة برمجة التطبيقات) أو الإصدارات الأحدث وتستهدف المستوى 35 أو مستوى أحدث لواجهة برمجة التطبيقات.
- يجب تحديث التطبيقات إلى هذا الإصدار من المكتبة قبل تحديث
targetSdkVersion
إلى 35 أو إصدار أحدث. - وفي حال عدم توفّرها، سيتم عرض خطأ وقت التشغيل.
- تمت إضافة تعريف جديد لنوع الجهاز المقترن، وهو
none
، عندما لا يكون الجهاز مقترنًا بالهاتف.
الإصدار 1.1.0-rc01
12 فبراير 2025
تم إصدار androidx.wear:wear-phone-interactions:1.1.0-rc01
بدون أي تغييرات ملحوظة منذ آخر إصدار تجريبي. يحتوي الإصدار 1.1.0-rc01 على عمليات الدمج هذه.
الإصدار 1.1.0-beta01
29 يناير 2025
تم طرح androidx.wear:wear-phone-interactions:1.1.0-beta01
. يحتوي الإصدار 1.1.0-beta01 على عمليات الإيداع هذه.
الميزات الجديدة
يشير الإصدار 1.1.0-beta01 من Wear Phone Interactions إلى أنّ هذا الإصدار من المكتبة يتضمّن جميع الميزات وأنّ واجهة برمجة التطبيقات مقفلة (باستثناء الأجزاء التي تمّت الإشارة إليها على أنّها تجريبية). يتضمّن الإصدار 1.1 من Wear Phone Interactions الوظائف وواجهات برمجة التطبيقات الجديدة التالية:
- تمت إضافة الموقع
redirectUrl
إلى الحسابOAuthRequest
. - إصلاحات المستندات
- إضافة نوع إضافي في
PhoneTypeHelper
لتحديد متى لا يكون الجهاز مقترنًا بالهاتف، بدلاً من استخدام النوع غير المعروف الحالي
تغييرات واجهة برمجة التطبيقات
- تمت إضافة تعريف جديد لنوع الجهاز المقترن - لا شيء، عندما لا يكون الجهاز مقترنًا بالهاتف. (I06cb8)
الإصدار 1.1.0-alpha05
11 ديسمبر 2024
تم طرح androidx.wear:wear-phone-interactions:1.1.0-alpha05
. يحتوي الإصدار 1.1.0-alpha05 على عمليات الدمج هذه.
إصلاح الأخطاء
- إصلاح خطأ تعطُّل عند التشغيل على Wear OS 5 (المستوى 34 لواجهة برمجة التطبيقات) أو الإصدارات الأحدث أثناء استهداف المستوى 35 لواجهة برمجة التطبيقات أو الإصدارات الأحدث يجب تحديث التطبيقات إلى هذا الإصدار من المكتبة قبل تحديث
targetSdkVersion
إلى 35 أو إصدار أحدث.
الإصدار 1.1.0
11 ديسمبر 2024
تم طرح androidx.wear:wear-remote-interactions:1.1.0
. يحتوي الإصدار 1.1.0 على عمليات الدمج هذه.
التغييرات المهمة منذ الإصدار 1.0.0
- لقد أضفنا
RemoteActivityHelper.isRemoteActivityHelperAvailable
التي تساعد في التحقّق مما إذا كانت وظيفة بدء نشاط عن بُعد متاحة. (I107a9)
الإصدار 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)
المساهمة الخارجية
- أزِل التبعية في Guava من
wear-remote-interactions
واستخدِم بدائل أصغر.
Wear-Phone-Interactions الإصدار 1.1.0-alpha03
9 مارس 2022
تم طرح androidx.wear:wear-phone-interactions:1.1.0-alpha03
. يحتوي الإصدار 1.1.0-alpha03 على عمليات الإيداع هذه.
إصلاح الأخطاء
- تعرض الدالة
redirectUrl
منOAuthRequest
الآن سلسلة فارغة إذا لم يتم ضبط عنوان URL لإعادة التوجيه في عنوان URL للطلب المحدّد. (I44242)
Wear-Phone-Interactions Version 1.1.0-alpha02
15 كانون الأول (ديسمبر) 2021
تم طرح androidx.wear:wear-phone-interactions:1.1.0-alpha02
. يحتوي الإصدار 1.1.0-alpha02 على عمليات الإيداع هذه.
إصلاح الأخطاء
- أصلِح الأخطاء في مستندات
RemoteAuthClient
، بما في ذلك الخطأ في مقتطف نموذج الرمز والرابط المعطّل إلىErrorCode
(I260e8).
Wear-Phone-Interactions الإصدار 1.1.0-alpha01
15 سبتمبر 2021
تم طرح androidx.wear:wear-phone-interactions:1.1.0-alpha01
. يحتوي الإصدار 1.1.0-alpha01 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
الإصدار 1.0.0 من Wear Ongoing & Interactions
Wear-Phone-Interactions الإصدار 1.0.1
15 كانون الأول (ديسمبر) 2021
تم طرح androidx.wear:wear-phone-interactions:1.0.1
. يحتوي الإصدار 1.0.1 على عمليات الإيداع هذه.
إصلاح الأخطاء
- تم طرح استثناء ثابت من
BridgingManager
عند محاولة إيقاف إشعارات الربط بدونexcludedTags
.
Wear-Phone-Interactions Wear-Remote-Interactions Version 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 إكمال Future إذا لم تكن هناك عُقد مرتبطة أو إذا لم يتم العثور على nodeId المطلوب (I60d60)
Wear-Ongoing الإصدار 1.1
الإصدار 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-Ongoing
1 سبتمبر 2021
تم طرح androidx.wear:wear-ongoing:1.0.0
. يتضمّن الإصدار 1.0.0 عمليات الدمج هذه.
الميزات الرئيسية في الإصدار 1.0.0
- واجهة برمجة التطبيقات "الأنشطة المستمرة على Wear" هي واجهة برمجة تطبيقات للمطوّرين، بما في ذلك المطوّرون الخارجيون، تُستخدَم لوضع علامة "نشاط مستمر" على أنشطتهم وتقديم المعلومات اللازمة.
- تشير "الأنشطة الجارية" إلى الأنشطة التي يمكن تشغيلها في خلفية الساعة (مثل التمارين والمكالمات والوسائط). في نظام التشغيل 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 الإصدار 1.0.0-rc01
18 أغسطس 2021
تم إصدار androidx.wear:wear-ongoing:1.0.0-rc01
بدون أي تغييرات منذ 1.0.0-beta01
. يحتوي الإصدار 1.0.0-rc01 على عمليات الإيداع هذه.
Wear-Ongoing الإصدار 1.0.0-beta01
4 أغسطس 2021
تم طرح androidx.wear:wear-ongoing:1.0.0-beta01
. يحتوي الإصدار 1.0.0-beta01 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- تقبل بعض أدوات الضبط في OngoingActivity.Builder الآن وسيطة فارغة من أجل توفير التماثل والاتساق بين أدوات الضبط وأدوات الجلب (I17ee5)
Wear-Phone-Interactions Version 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 تلقائيًا استنادًا إلى نوع الجهاز (بقية العالم/الصين). (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 على عمليات الإيداع هذه.
Wear-Phone-Interactions الإصدار 1.0.0-alpha06
21 تموز (يوليو) 2021
تم طرح androidx.wear:wear-phone-interactions:1.0.0-alpha06
. يحتوي الإصدار 1.0.0-alpha06 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- أصبح الصف
BridgingManagerSeviceBinder
الآن فئة فرعية من Service وتمت إعادة تسميته إلى BridgingManagerSevice. (I9fca2) - تم تغيير الطريقة
RemoteAuthClient.Callback.onAuthorizationError
لتشمل المَعلمة OAuthRequest. تتطلّب الطرق التي تحتاج إلى معاودة الاتصال الآن أيضًا منفِّذًا لتشغيل معاودة الاتصال. (I35e11)
إصلاح الأخطاء
- لقد أوضحنا واجهة برمجة التطبيقات الخاصة بالمصادقة من خلال توفير المزيد من المَعلمات الموثّقة واستخدام السمات حيثما أمكن ذلك. (I12287)
Wear-Phone-Interactions الإصدار 1.0.0-alpha05
30 حزيران (يونيو) 2021
تم طرح androidx.wear:wear-phone-interactions:1.0.0-alpha05
. يحتوي الإصدار 1.0.0-alpha05 على عمليات الإيداع هذه.
إصلاح الأخطاء
- المَعلمات الموثَّقة التي يجب تمريرها في الدالة الإنشائية لـ
BridgingConfig.Builder
.
Wear-Ongoing الإصدار 1.0.0-alpha06
2 حزيران (يونيو) 2021
تم طرح androidx.wear:wear-ongoing:1.0.0-alpha06
. يحتوي الإصدار 1.0.0-alpha06 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- إضافة حقل "العنوان" إلى "النشاط الجاري" (I7a405)
إصلاح الأخطاء
SerializationHelper.copy()
الآن بإنشاء نسخة احتياطية من المعلومات (I8b276)- تحسين مستندات setCategory (Iff01f)
Wear-Ongoing الإصدار 1.0.0-alpha05
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
- لإنشاء
Wear-Ongoing الإصدار 1.0.0-alpha04
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 في Wearable Support Library) والتي يمكن استخدامها لفتح أغراض على أجهزة أخرى (أي من الساعة إلى الهاتف). (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
لجعل المكتبة الجديدة متوافقة مع الإصدارات القديمة من خلال التنفيذ في Wearable Support Library.
إصلاح الأخطاء
- تم إصلاح الخطأ الناتج عن واجهة برمجة التطبيقات الجديدة OAuth عند بدء جلسة OAuth.
Wear-Remote-Interactions الإصدار 1.0.0-alpha03
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. يتم توفير معالجات وفئات مساعدة إضافية للتواصل.
- يمكن الآن ربط الأنشطة الجارية بإشعار يتضمّن علامة باستخدام الدالة الإنشائية الجديدة OngoingActivity.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" على الهاتف
إصلاح الأخطاء
- نقل فئة PlayStoreAvailability من 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 الآن على طريقة ثابتة لإنشاء حالات بسيطة تتضمّن جزءًا واحدًا فقط (نص أو مؤقّت)، وBuilder لإنشاء حالات أكثر تعقيدًا. (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.ongoing (كانت سابقًا androidx.wear.ongoingactivities) (I7c029)
أنشئ مكتبة دعم جديدة تحتوي على فئات تتيح التفاعلات بين الأجهزة القابلة للارتداء والهواتف. تتم تعبئته في البداية بالفئات التي تم نقلها من Wearable Support Library. (Id5180)
نقل فئة PhoneDeviceType من Wearable Support Library إلى AndroidX تمت إعادة تسمية الفئة التي تم نقلها إلى PhoneTypeHelper، وهي توفّر طرقًا مساعدة لتحديد نوع الهاتف الذي تم إقران الساعة الحالية به، وذلك لاستخدامها على أجهزة Wearable فقط. (Ibd947)
أنشئ مكتبة دعم جديدة تحتوي على فئات تتيح التفاعلات بين الأجهزة القابلة للارتداء والهواتف. تتم تعبئة هذا الحقل في البداية بالصفوف التي تم نقلها من Wearable Support Library. (I9deb4)
نقل فئة WatchFaceCompanion من Wearable Support Library إلى AndroidX تمت إعادة تسمية الفئة التي تم نقلها إلى WatchFaceConfigIntentHelper، وهي توفّر دوال مساعدة لتحديد المعرّف واسم المكوّن في أنشطة إعداد خلفية شاشة الساعة في التطبيق المصاحب على الهاتف، ويمكن أيضًا استخدامها محليًا لإعداد خلفية شاشة الساعة على الجهاز القابل للارتداء. (Ia455f)
إضافات Wear وWatchface 1.0.0
الإصدار 1.0.0-alpha22
15 سبتمبر 2021
تم طرح androidx.wear:wear-*:1.0.0-alpha22
. يحتوي الإصدار 1.0.0-alpha22 على عمليات الإيداع هذه.
الميزات الجديدة
- تتضمّن EditorSession الآن أدوات مراقبة مراحل النشاط، لذا لم يعُد عليك إغلاقها بشكل صريح عند إيقاف نشاطك.
تغييرات واجهة برمجة التطبيقات
- تستخدِم الفئتان EditorSession وListenableEditorSession الآن StateFlows في Kotlin لكلّ من complicationSlotsState وComplicationsPreviewData وComplicationsDataSourceInfo. (I761d9)
- أصبح EditorSession#userStyle الآن
MutableStateFlow<UserStyle>
(I32ca9) - تستخدِم الدالة EditorSession.createOnWatchEditorSession الآن أداة مراقبة مراحل النشاط، ويتم إغلاقها تلقائيًا عند رصد حدث onDestroy. بالإضافة إلى ذلك، لم يعُد
createOnWatchEditorSession
يتطلّب سوى تمرير النشاط. تم أيضًا تطبيق تغييرات مماثلة على ListenableEditorSession. (Ic6b7f) - تمت إعادة تثبيت أداة إنشاء CustomValueUserStyleSetting كجزء من واجهة برمجة التطبيقات العامة. (I2e69a)
- تتضمّن السمة
UserStyle
الآن السمتَينMap<UserStyleSetting, UserStyleSetting.Option>
وMutableUserStyleSetting#put
، وتُصدر السمة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 غير القابل للتغيير بدلاً من Calendar. (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 القيمة null. (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 في 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
. تمت أيضًا إعادة تسمية أغلفة Guava. (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) - أضفنا PreviewScreenshotParams، وهي مَعلمة جديدة اختيارية لـ 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)
- إصلاح مشاكل "محرّر خلفيات شاشة الساعة" في الإصدارات السابقة للإصدار 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
الذي يعرض خريطة لمعرّفات Complication Ids إلى DefaultComplicationProviderPolicies وDefaultComplicationType. وهذه الطريقة أسرع من إنشاء مثيل بدون واجهة مستخدم لأنّها لا تحتاج إلى تهيئة خلفية شاشة الساعة بالكامل لتنفيذ طلب البحث.
أخيرًا، يتم الآن إنشاء الإضافات باستخدام CanvasComplicationFactory الذي يتيح إنشاء أدوات العرض CanvasComplication بشكل مؤجّل.
تغييرات واجهة برمجة التطبيقات
- تم استبدال
@TargetApi
بـ@RequiresApi
. (I0184a وb/187447093 وb/187447094) - لقد أضفنا
WatchFaceControlClient.getDefaultProviderPoliciesAndType
التي تعرض خريطة لمعرّفات Complication Ids إلى DefaultComplicationProviderPolicies وComplicationType التلقائي. يتم استخدام مسار سريع حيثما أمكن ذلك لتجنُّب إنشاء خلفية شاشة ساعة بشكل كامل. ولتسهيل ذلك، كان لا بد من تغيير واجهة برمجة التطبيقات WatchFaceService API وإضافة طريقتَين جديدتَين هما: createUserStyleSchema وcreateComplicationsManager، ويتم تمرير نتائج هاتين الطريقتَين إلى createWatchFace. بالإضافة إلى ذلك، يتم الآن إنشاء الإضافات باستخدام CanvasComplicationFactory الذي يتيح الإنشاء المؤجّل لبرامج عرض CanvasComplication. (Iad6c1) - لقد أزلنا MOST_RECENT_APP من SystemProviders. (I3df00)
- أصبحت ObservableWatchData الآن فئة محكمة الإغلاق. (Ic940d)
- يتم الآن استدعاء CanvasComplicationFactory.create (الذي يكون عادةً مرتبطًا بالإدخال/الإخراج) في سلسلة محادثات في الخلفية لكل عنصر من عناصر واجهة المستخدم المعقّدة قبل بدء عرض سلسلة محادثات واجهة المستخدم. هناك حاجز ذاكرة بين الإنشاء والعرض، لذا لا يلزم استخدام أي عناصر أولية خاصة بالترابط. (Ia18f2)
- يتم الآن إنشاء خلفيات شاشة الساعة في سلسلة محادثات في الخلفية، على الرغم من أنّ جميع عمليات العرض تتم في سلسلة محادثات واجهة المستخدم، ويتيح GlesRenderer سياقَين مرتبطَين لدعم ذلك. قد يتم حلّ WatchFaceControlClient.createHeadlessWatchFaceClient وWatchFaceControlClient.getOrCreateInteractiveWatchFaceClient قبل اكتمال WatchFaceService.createWatchFace. سيتم حظر طلبات البيانات من واجهة برمجة التطبيقات اللاحقة إلى أن يكتمل إعداد watchFace. (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.
تغييرات واجهة برمجة التطبيقات
- أصبحت السمتان
eglContext
وeglDisplay
في GlesRenderer غير قابلتَين للتصغير. يتم الآن الإبلاغ عن أي أخطاء في 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. يمكن تعديل ذلك باستخدام ComplicationsUserStyleSetting.
لتشجيع المطوّرين على مراعاة برامج قراءة الشاشة، جعلنا الحقول
ShortTextComplicationData.Builder
وLongTextComplicationData.Builder
وRangedValueComplicationData.Builder
contentDescription
إلزامية ليتم تمريرها إلى دوال الإنشاء. إذا تم تمريرComplicationText.EMPTY
إلىcontentDescription
، سيتم إنشاءcontentDescription
تلقائيًا من النص والعنوان.تعرض السمة
WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient
الآن الخطأServiceStartFailureException
إذا عرضت خلفية شاشة الساعة استثناءً أثناء عملية التهيئة، ما يسهّل كثيرًا تشخيص المشاكل أثناء بدء تشغيل خلفية شاشة الساعة.
تغييرات واجهة برمجة التطبيقات
- أضفنا إمكانية استخدام اسم مكوّن فارغ في ComplicationProviderInfo، وهو أمر ضروري لتوافق التطبيق مع الإصدارات القديمة من 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) - أعدنا تسمية ComplicationProviderService.onComplicationUpdate إلى onComplicationRequest، ووضعنا مَعلمتَي المعرّف والنوع لهذه الطريقة في بيانات ComplicationRequest. تمت إعادة تسمية أداة معالجة الأحداث المقابلة إلى ComplicationRequestListener، كما تمت إعادة تسمية طريقتها إلى ComplicationRequestListener.onComplicationData. (Iaf146)
- لقد أزلنا الطريقة
isActiveAt
منComplicationData
واستبدلناها بالحقلvalidTimeRange
. يمكن استبدال استدعاء الطريقة هذا بـvalidTimeRange.contains
. (I65936) - لقد غيّرنا وصف الطريقة ComplicationProviderService.onComplicationActivated لتلقّي ComplicationType بدلاً من عدد صحيح. (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 Complications & Watchface
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 لدعم الإضافات على الحواف (المرسومة حول حافة الشاشة). يتم ترك عملية العرض واختبار الضغط لإضافات الحواف لخلفية شاشة الساعة. لا تتوفّر ميزة اختبار إصابة الحافة من المحرّر المصاحب.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة البادئة
PROVIDER_
إلى الثوابت في SystemProviders. (I1e773) - لقد جعلنا الحقول
PhotoImageComplicationData.Builder
وMonochromaticImageComplicationData.Builder
وSmallImageComplicationData.Builder
contentDescription
إلزامية ليتم تمريرها في الدالة الإنشائية. (I9643a) - تمت إعادة تسمية
ProviderInfoRetriever.requestPreviewComplicationData
إلىretrievePreviewComplicationData
. (I911ee) - تم نقل
ComplicationProviderService
من Java إلى Kotlin. (I849f2) - أصبحت الطريقة
ComplicationProviderService.onBind
نهائية الآن (I39af5) - أعدنا واجهة
CanvasComplication
ونقلناCanvasComplicaitonDrawable
وGlesTextureComplication
وComplicationHighlightRenderer
إلىwear-watchface-complications-rendering
. (I84670) - تمت إعادة تصميم
RenderParameters
لتتيح عرض التمييز الموسّع. يمكنك الآن طلب عرض اللحظات البارزة للأنماط، بالإضافة إلى جميع التطبيقات المصغّرة أو تطبيق مصغّر واحد. بالإضافة إلى ذلك، يتضمّن كل من CanvasRenderer وGlesRenderer طريقة renderHighlightLayer مجرّدة جديدة لعرض أي تمييز يطلبه المحرّر. تمت إعادة تسمية الطبقة إلى 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 الآن ClientDisconnectListener و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) - أزلنا عمليات التحويل المختلفة في Wear-watchface-client Binder، ومن المفترض أن تكون ضرورية. (Icc4c0)
- لتحقيق الاتّساق، تمت إعادة تصميم
EditorServiceClient
لاستخدام أدوات معالجة الأحداث بدلاً من أدوات المراقبة. (Iec3a4) - أضفنا بعض التعليقات التوضيحية الناقصة من
@Px
إلىInteractiveWatchFaceSysUiClient
وWatchFaceControlClient
. (I3277a) - تمت إعادة تسمية EditorObserverCallback إلى EditorObserverListener للحفاظ على الاتساق. (Ie572d)
- يقتصر استخدام EditorState.watchFaceInstanceId على المستوى 30 لواجهة برمجة التطبيقات في Android والإصدارات الأحدث، ولم يعُد يمكن أن تكون قيمته فارغة. (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 على عمليات الإيداع هذه.
الميزات الجديدة
- يمكن الآن إنشاء عناصر open 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 وواجهة الساعة. يمكن للمحرِّر الآن تحديد ما إذا كان تغيير النمط سيؤدي إلى تفعيل أو إيقاف إحدى الإضافات (مفعّلة = initiallyEnabled بالإضافة إلى أي تجاوز من ComplicationsUserStyleSetting).
EditorService.closeEditor
تسمح أيضًا لواجهة المستخدم الخاصة بالنظام بإغلاق أداة تعديل خلفية شاشة الساعة عن بُعد عند الحاجة. - بالإضافة إلى
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 الخطأ ServiceDisconnectedException إذا تم إغلاق الرابط بشكل غير متوقّع. (Ib2cc4)
- بدءًا من الإصدار 11 من نظام التشغيل Android، هناك قيود على وقت تشغيل ProviderChooser، بالإضافة إلى ذلك، نريد أن يتم إنشاء أدوات التعديل باستخدام
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)
- عرض validTimeRange الخاص بـ ComplicationData (I91366)
- اجعل السمات المشابهة للصور أكثر وضوحًا. (I81700)
- تمت إعادة تصميم wear-watchface-editor وwear-complications-data لاستخدام دوال تعليق بدلاً من الروتينات المشتركة. سيتم توفير برامج تضمين متوافقة مع Rx java وFuture. (If3c5f)
- يُصدر ProviderInfoRetriever الآن الخطأ PreviewNotAvailableException إذا تعذّر على requestPreviewComplicationData عرض بيانات المعاينة بسبب مشاكل في الاتصال أو عدم توفّر دعم لواجهة برمجة التطبيقات. (I4964d)
- أصبح WatchFaceControlService::createWatchFaceControlClient الآن دالة معلّقة، وأصبح اسم getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient هو getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClientAsync الذي يعرض
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)
- أضفنا CustomValueUserStyleSetting الذي يتيح لك تخزين سلسلة واحدة خاصة بالتطبيق ضمن UserStyle. ستتجاهل أدوات تعديل خلفية شاشة الساعة التلقائية هذه القيمة. (Ic04d2)
- لا يتم تمرير InstanceID في إضافات الهدف للإصدار R والإصدارات الأقدم من Android WearOS التي لا يمكننا ترقيتها. ولإتاحة ذلك، نسمح الآن بأن تكون قيمة InstancID فارغة. (Id8b78)
- يتضمّن EditorRequest الآن اسم ComponentName الخاص بالمحرّر الذي تم ضبطه كمكوّن في 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 الجديدة للوصول إلى تفاصيل WatchFace وتسجيل النتيجة من خلال 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's future باستخدام ServiceStartFailureException إذا توقفت الخدمة أثناء انتظار إنشاء خلفية شاشة الساعة. (I0f509)
- أصبح EditorSession.complicationPreviewData الآن ListenableFuture لأنّ جلب هذه البيانات هو عملية غير متزامنة. (Iead9d)
إصلاح الأخطاء
- سنزيل الحقول غير المستخدَمة من ComplicationOverlay، مع إبقاء الحقلين enabled وcomplicationBounds. (I17b71)
الإصدار 1.0.0-alpha05
13 كانون الثاني (يناير) 2021
تم طرح androidx.wear:wear-*:1.0.0-alpha05
. يحتوي الإصدار 1.0.0-alpha05 على عمليات الإيداع هذه.
الميزات الجديدة
تتيح خلفيات شاشة الساعة غالبًا عددًا من إعدادات العناصر مع اختلاف عدد العناصر المعروضة. لتسهيل عملية الإعداد، أصبحنا الآن نتيح استخدام الإضافات غير المفعّلة في البداية من خلال استدعاء setEnabled(false) في أداة الإنشاء. يمكن تفعيلها لاحقًا من خلال ComplicationsUserStyleSetting.
تغييرات واجهة برمجة التطبيقات
- تقبل ComplicationHelperActivity الآن
Collection<ComplicationType>
بدلاً من مصفوفة عدد صحيح، ما يسهّل استخدامها. (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 على عمليات الإيداع هذه.
الميزات الجديدة
- تتيح مكتبة خلفيات شاشة الساعة على Wear OS الآن ضبط حدود لكل نوع. على سبيل المثال، يمكنك التبديل إلى مربّع حدود عريض للنوع ComplicationType.LONG_TEXT أثناء استخدام مربّع حدود أصغر للأنواع الأخرى.
تغييرات واجهة برمجة التطبيقات
- تستخدم الإضافات الآن ComplicationBounds التي تتضمّن
Map<ComplicationType, RectF>
لتوفير أحجام لكل نوع من أنواع الإضافات. (I1ebe7) - تتيح لك RenderParameters الآن تحديد لون التمييز لاستخدامه في لقطات الشاشة. (Iff42b)
- باستثناء الحدود، عليك الآن استخدام ComplicationsUserStyleSetting لتعديل الإضافات، وذلك لضمان مزامنة نظام التشغيل. (I8dc5d)
- أصبحت أداة العرض الآن فئة محكمة الإغلاق. وهذا يعني أنّ CanvasRenderer وGlesRenderer أصبحا الآن فئتَين داخلية ضمن Renderer. (Iab5d4، b/173803230)
- تمت إعادة تسمية CanvasComplicationDrawable.drawHighlight إلى drawOutline. يحتوي ObservableWatchData الآن على بعض التعليقات التوضيحية UiThread الناقصة. تمت الآن إزالة ScreenState بالكامل من WatchState. (If1393)
- أصبح الحد الأدنى لمستوى واجهة برمجة التطبيقات في wear-watchface هو 25. ملاحظة: يتطلّب توفُّر لوحة العرض على الأجهزة المستوى 26 من واجهة برمجة التطبيقات أو المستويات الأحدث. (Ic9bbd)
- يتضمّن InteractiveWatchFaceWcsClient الآن أداة مساعدة getComplicationIdAt. (I05811)
- تم خفض مستوى واجهة برمجة التطبيقات لحزمة wear-watchface-client إلى 25، ولكن تتطلّب واجهات برمجة التطبيقات الخاصة بلقطات الشاشة المستوى 27 من واجهة برمجة التطبيقات. (Id31c2)
إصلاح الأخطاء
- نعرض الآن ComplicationType الخاص بـ ComplicationData الحالي للعنصر Complication في 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)
- تتضمّن الإضافة الآن compicationData الذي يتيح لخلفيات شاشة الساعة مراقبة تغييرات ComplicationData. يتضمّن العنصر Complication أيضًا استدعاءً جديدًا باسم isActiveAt يمكن استخدامه لمعرفة ما إذا كان يجب عرض أي شيء في التاريخ والوقت المحدّدين. (Ic0e2a)
- لم يعُد
SharedMemoryImage
الفارغ متوفّرًا في واجهة برمجة التطبيقات العامة. (I7ee17) - يحتوي
WatchFace.overridePreviewReferenceTimeMillis
الآن على تعليق توضيحي IntRange، كما أنّ الدالتَين getter وsetter لهما أسماء متسقة. (Ia5f78) - تم الآن إنشاء
Complication.Builder
عبرComplication.createRoundRectComplicationBuilder
أوComplication.createBackgroundComplicationBuilder
للتوضيح (I54063) - تمت إضافة WatchFace.TapListener الذي يسمح لـ WatchFace بمراقبة النقرات التي لم تستخدمها الإضافات. (Ic2fe1، b/172721168)
- تتيح خدمة WatchFace الآن استخدام عدد متغير من اللقطات في الثانية من خلال تعيين القيمة
Renderer.interactiveDrawModeUpdateDelayMillis
. يمكن أن يساعد ذلك في الحفاظ على عمر البطارية من خلال إيقاف الحركة عندما لا تكون هناك حاجة إليها. (I707c9) - لم يعُد WatchFace.Builder مطلوبًا، وتم نقل invalidate() وinteractiveUpdateRateMillis إلى Renderer. (I329ea)
- لتحسين إمكانية التشغيل التفاعلي مع Java، تمت إعادة تسمية دوال الحصول على قيم السمات المنطقية في WatchState (I6d2f1)
- تمت إعادة تسمية TapListener إلى TapCallback وInvalidateCallback إلى InvalidateListener للحفاظ على الاتساق. (I9414e)
- تم نقل خيارات نمط خلفية شاشة Wear 2.0 إلى فئة خاصة لتوضيحها. تتضمّن أدوات ضبط WatchFace.Builder الآن أدوات جلب متناظرة لفئة 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
المتوافقة مع الأجهزة القابلة للارتداء إلىComplicationType
في androidx. (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 (I7c268)
- يجب أن تبدأ الدوال التي تعرض قيمًا منطقية بـ "is" بدلاً من "get" (If36ff)
- تنصح واجهة برمجة التطبيقات بتجنُّب استخدام protected، لذا تمت إعادة تصميم هذه الفئة لتلقّي المَعلمات من خلال الدالة الإنشائية. (I61644)
- إعادة تسمية setBackgroundComplication لتوضيح معناها (I96fe3)
- استخدام سمات Kotlin لـ ComplicationDrawable isHighlighted والبيانات (I4dcc8)
- بدلاً من ComplicationRenderer.InvalidateCallback، نضيف Complication#invalidate() (I4f4c6).
- سيتم إيقاف واجهات برمجة التطبيقات هذه نهائيًا في WearableSupport، وستتم إزالتها هنا. (Ib425c)
- تمت إعادة تسمية بعض طرق إنشاء خلفيات شاشة الساعة للتأكيد على طبيعتها القديمة في Wear 2.0. (Idb775)
- أول إصدار تجريبي من واجهة برمجة التطبيقات لتطبيقات Wear OS/خلفيات شاشة Wear OS (Id3981)
- أول إصدار تم تتبُّعه من واجهة برمجة التطبيقات (Ie9fe6)
- إخفاء ComplicationDrawable.BorderStyle IntDef بشكل صحيح والانتقال إلى ComplicationStyle لتحقيق الاتساق (I27f7a)
- إضافة التعليقات التوضيحية الناقصة لطُرق ComplicationStyle (I838fd)
- لا تحتوي هذه المكتبة على مساحة واجهة برمجة تطبيقات عامة (I88e2b)
- أصبحت جميع فئات الخيارات الخاصة بفئات الأنماط نهائية بشكل صحيح. (Ib8323)
- أول إصدار تم تتبُّعه من واجهة برمجة التطبيقات (I27c85)
إصلاح الأخطاء
- تم تغيير ComplicationProviderService لتضمين طريقة getComplicationPreviewData صريحة. (I4905f)
- تم تفعيل فحص API lint للخطأ MissingGetterMatchingBuilder في androidx (I4bbea وb/138602561)
- أعِد تسمية wear-complications-rendering. (Ifea02)
- أصبحت أسماء العرض لفئات الأنماط الآن CharSequences (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>
تمت إضافة حاوية تنسيق جديدة، DismissibleFrameLayout، تتعامل مع إغلاق الشاشة باستخدام زر الرجوع و/أو الإغلاق عن طريق التمرير السريع، وهي مخصّصة للاستخدام داخل أحد الأنشطة. يجب إضافة مستمع واحد على الأقل لاتّخاذ إجراء عند إغلاق الإعلان. يزيل معالج الأحداث عادةً طريقة عرض أو جزءًا يحتوي على النشاط الحالي. يتم توفير setSwipeDismissible(boolean) وsetBackButtonDismissible(boolean) للتحكّم المباشر في الميزات. تم تصميم هذا التصميم الجديد ليحلّ محلّ SwipeDismissFrameLayout الحالي.
تمت إضافة إمكانية الإشارة إلى أنّه يمكن "استئناف النشاط تلقائيًا" عندما يخرج الجهاز من "وضع الإضاءة المحيطة" في فئة AmbientModeSupport. كانت هذه الوظيفة متاحة سابقًا في الفئة WearableActivity المتوقّفة نهائيًا من WearableSupportLibrary. (I336ab)
تم نقل فئة WearableCalendarContract من Wearable Support Library. توفر واجهة برمجة التطبيقات هذه مجموعة فرعية من البيانات المتاحة من خلال 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 على عمليات الإيداع هذه.
إصلاح الأخطاء
- تم إصلاح الخطأ الذي كان يؤدي إلى تعطُّل ConfirmationActivity في حال عدم توفّر رسالة. (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. يضيف أيضًا بعض عمليات إعادة التسمية البسيطة في DismissibleFrameLayout للمساعدة في توضيح واجهة برمجة التطبيقات.
تغييرات واجهة برمجة التطبيقات
- أعدنا تسمية الطرق التالية في
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" إلى AndroidX توفر واجهة برمجة التطبيقات هذه مجموعة فرعية من البيانات المتاحة من خلال CalendarContract، ولكن تتم مزامنتها تلقائيًا مع الأجهزة القابلة للارتداء. (I6f2d7)
إصلاح الأخطاء
- إيقاف ميزة الإغلاق باستخدام زر الرجوع تلقائيًا في Dismissible FrameLayout لأنّ الإغلاق عن طريق التمرير السريع يظل الطريقة الرئيسية للرجوع إلى وضع ملء الشاشة على أجهزة Wearable (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 على عمليات الإيداع هذه.
يضيف هذا الإصدار "واجهة برمجة تطبيقات الأنشطة الجارية" الجديدة للمرة الأولى. يمكن للمطوّرين استخدام واجهة برمجة التطبيقات هذه للإشارة إلى أنّ هناك نشاطًا طويل الأمد، مثل تمرين لياقة بدنية أو جلسة تشغيل وسائط، لا يزال مستمرًا. ويتيح للمطوّرين تقديم آخر المعلومات بشكل دوري، مثل "المسافة والوقت المستغرَق في الجري" أو "الأغنية الحالية التي يتم تشغيلها" لعرضها على خلفية شاشة الساعة أو في مشغّل التطبيقات. هذه الوظيفة مخصّصة للأجهزة المستقبلية التي تم تفعيل وظيفة "النشاط الجاري" عليها.
تغييرات واجهة برمجة التطبيقات
- واجهة برمجة تطبيقات جديدة للأنشطة الجارية، وهي لا تنفّذ أي عملية على "الأجهزة غير المتوافقة". (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 التي تمت إضافة
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" إلى 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 من Wearable Support Library إلى 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 الإصدار 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)
الإصدار 1.0.0-alpha01 من Wear-Input
2 سبتمبر 2020
تم طرح androidx.wear:wear-input:1.0.0-alpha01
. يحتوي الإصدار 1.0.0-alpha01 على عمليات الدمج التالية.
الميزات الجديدة
نقل وظيفة WearableButtons من Wearable Support Library إلى 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" لهذه السمات. (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" لهذه السمات.
الإصدار 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)