Wear

يسرد هذا الجدول جميع العناصر في المجموعة androidx.wear.

تحديد الاعتماديات

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

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

dependencies {
    implementation "androidx.wear:wear:1.3.0"

    // Add support for wearable specific inputs
    implementation "androidx.wear:wear-input:1.2.0"
    implementation "androidx.wear:wear-input-testing:1.2.0"

    // Use to implement wear ongoing activities
    implementation "androidx.wear:wear-ongoing:1.1.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"
}

dependencies {
    implementation("androidx.wear:wear:1.3.0")

    // Add support for wearable specific inputs
    implementation("androidx.wear:wear-input:1.2.0")
    implementation("androidx.wear:wear-input-testing:1.2.0")

    // Use to implement wear ongoing activities
    implementation("androidx.wear:wear-ongoing:1.1.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-rc01

‫8 أكتوبر 2025

تم إصدار androidx.wear:wear-core:1.0.0-rc01 بدون أي تغييرات. يتضمّن الإصدار 1.0.0-rc01 هذه التعديلات.

الإصدار 1.0.0-beta02

‫10 سبتمبر 2025

تم طرح androidx.wear:wear-core:1.0.0-beta02. يتضمّن الإصدار 1.0.0-beta02 هذه التعديلات.

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

• منع WearApiVersionHelper من عرض استثناءات على الأجهزة القديمة عند التحقّق من توفّر واجهات برمجة التطبيقات الأحدث

الإصدار 1.0.0-beta01

‫30 يوليو 2025

تم إصدار androidx.wear:wear-core:1.0.0-beta01 بدون أي تغييرات ملحوظة منذ آخر إصدار أولي. يتضمّن الإصدار 1.0.0-beta01 هذه التعديلات.

الإصدار 1.0.0-alpha02

‫16 يوليو 2025

تم طرح androidx.wear:wear-core:1.0.0-alpha02. يتضمّن الإصدار 1.0.0-alpha02 هذه التعديلات.

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

• تعديل WearApiVersionHelper ليشمل VIC/Baklava (I4676d)

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

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

الإصدار 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-alpha02

‫16 يوليو 2025

تم طرح androidx.wear:wear:1.4.0-alpha02. يتضمّن الإصدار 1.4.0-alpha02 هذه التعديلات.

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

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

الإصدار 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 أفضل جهد MaxAngleDegrees يتم الالتزام به عند توسيع العناصر الفرعية باستخدام الأوزان. على سبيل المثال، يمكنك تثبيت القوس بعدة عناصر فرعية بأوزان على 90 درجة، وسيتم أيضًا مراعاة المساحة التي تشغلها أي عناصر غير موسّعة.

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

• أضفنا قيمة إلى ArcLayout.LayoutParams تتيح توسيع أداة لملء المساحة المتوفّرة، وإذا كان هناك أكثر من أداة واحدة، يكون نصيبها من المساحة المتوفّرة متناسبًا مع قيمتها. بالإضافة إلى ذلك، أضفنا ArcLayout.setMaxAngleDegrees حتى تتمكّن مثلاً من تحديد الحد الأقصى للتوسيع عند 90 درجة (يُرجى العِلم أنّ هذا لا يؤثر في تخطيط أي عناصر فرعية ذات حجم ثابت). أخيرًا، يتضمّن ArcLayout.Widget الآن setSweepAngleDegrees الذي يسمح ArcLayout بإبلاغ أداة ذات وزن غير صفري بحجمها. (I75f24)
• تعديل إمكانية قبول القيمة الخالية في setColorFilter(I99ddf، b/236498063)

الإصدار 1.3.0-alpha02

‫23 فبراير 2022

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

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

• إتاحة layoutDirection على ArcLayout (I14d49)
• رسالة وصف المحتوى المحسّنة لـ 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 يوليو 2022

تم طرح 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 هذه التعديلات.

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

• إصلاح خطأ تعذُّر التشغيل عند استخدام الإصدار 5 من نظام التشغيل Wear OS (المستوى 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 واستخدِم بدائل أصغر.

الإصدار 1.1.0-alpha03 من Wear-Phone-Interactions

‫9 مارس 2022

تم طرح androidx.wear:wear-phone-interactions:1.1.0-alpha03. يتضمّن الإصدار 1.1.0-alpha03 هذه التعديلات.

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

• تعرض الدالة redirectUrl من OAuthRequest الآن سلسلة فارغة إذا لم يتم ضبط عنوان URL لإعادة التوجيه في عنوان URL للطلب المحدّد. (I44242)

الإصدار 1.1.0-alpha02 من Wear-Phone-Interactions

15 كانون الأول (ديسمبر) 2021

تم طرح androidx.wear:wear-phone-interactions:1.1.0-alpha02. يتضمّن الإصدار 1.1.0-alpha02 هذه التعديلات.

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

• أصلِح الأخطاء في مستندات RemoteAuthClient، بما في ذلك الخطأ في مقتطف نموذج الرمز والرابط المعطّل إلى ErrorCode (I260e8).

الإصدار 1.1.0-alpha01 من Wear-Phone-Interactions

‫15 سبتمبر 2021

تم طرح androidx.wear:wear-phone-interactions:1.1.0-alpha01. يتضمّن الإصدار 1.1.0-alpha01 هذه التعديلات.

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

• تمت إضافة السمة redirectUrl إلى OAuthRequest. (I98840، Ie684d)

الإصدار 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. يتم توفير معالِجات وفئات مساعدة إضافية للتواصل.

تحتوي مكتبة Remote Interaction Library على واجهات برمجة تطبيقات للتفاعلات بين الأجهزة القابلة للارتداء والهواتف. ويحتوي على ما يلي:

• WatchFaceConfigIntentHelper، ما يوفّر دوال مساعدة لتحديد المعرّف واسم المكوّن في أنشطة ضبط إعدادات خلفية شاشة الساعة على الجهاز المرافق.
• فئة RemoteActivityHelper التي يمكن استخدامها لفتح أغراض على أجهزة أخرى (أي من الساعة إلى الهاتف).

‫Wear-Phone-Interactions Wear-Remote-Interactions الإصدار 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 Version 1.1

الإصدار 1.1.0

‫10 سبتمبر 2025

تم طرح androidx.wear:wear-ongoing:1.1.0. يتضمّن الإصدار 1.1.0 هذه التعديلات.

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

• تمت إضافة حقل وصف المحتوى إلى "الأنشطة الجارية"، وتستخدمه خدمات تسهيل الاستخدام.
• تمت إضافة تعليقات توضيحية RequiresPermission إلى واجهات برمجة التطبيقات التي تتطلّب الإذن POST_NOTIFICATIONS في حزمة تطوير البرامج (SDK) 33 والإصدارات الأحدث.

الإصدار 1.1.0-rc01

‫27 أغسطس 2025

تم إصدار androidx.wear:wear-ongoing:1.1.0-rc01 بدون أي تغييرات منذ آخر إصدار تجريبي. يتضمّن الإصدار 1.1.0-rc01 هذه التعديلات.

الإصدار 1.1.0-beta01

‫30 يوليو 2025

تم إصدار androidx.wear:wear-ongoing:1.1.0-beta01 بدون أي تغييرات ملحوظة منذ آخر إصدار أولي. يتضمّن الإصدار 1.1.0-beta01 هذه التعديلات.

الإصدار 1.1.0-alpha01

‫23 أغسطس 2023

تم طرح androidx.wear:wear-ongoing:1.1.0-alpha01. يتضمّن الإصدار 1.1.0-alpha01 هذه التعديلات.

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

• إضافة حقل وصف المحتوى إلى "النشاط الجاري" سيتم استخدام هذا الوصف من قِبل الخدمات المخصّصة لتسهيل الاستخدام لوصف "النشاط الجاري". (I79fc6)

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

• تمت إضافة @RequiresPermission إلى واجهات برمجة التطبيقات التي تتطلّب منح الإذن POST_NOTIFICATIONS على الإصدار 33 من حزمة تطوير البرامج (SDK) والإصدارات الأحدث. (Ie542e، b/238790278)

Wear-Ongoing الإصدار 1.0.0

‫1 سبتمبر 2021

تم طرح androidx.wear:wear-ongoing:1.0.0. يتضمّن الإصدار 1.0.0 هذه التعديلات.

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

• واجهة برمجة التطبيقات "الأنشطة المستمرة على Wear" هي واجهة برمجة تطبيقات للمطوّرين، بما في ذلك المطوّرون الخارجيون، تُستخدَم لوضع علامة "نشاط مستمر" على أنشطتهم وتقديم المعلومات اللازمة.
• تشير "الأنشطة الجارية" إلى الأنشطة التي يمكن تشغيلها في خلفية الساعة (مثل التمارين والمكالمات والوسائط). في نظام التشغيل Wear 3، سيتم إبراز النشاط الذي تم تحديده على أنّه نشاط جارٍ من خلال رمز تراكب مخصّص على خلفية شاشة الساعة وعرض مختلف في مشغّل التطبيقات.
• لمزيد من المعلومات، يُرجى الاطّلاع على دليل "النشاط الجاري" على Wear.

Wear-Phone-Interactions Wear-Remote-Interactions الإصدار 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)

الإصدار 1.0.0-rc01 من Wear-Ongoing

‫18 أغسطس 2021

تم إصدار androidx.wear:wear-ongoing:1.0.0-rc01 بدون أي تغييرات منذ 1.0.0-beta01. يتضمّن الإصدار 1.0.0-rc01 هذه التعديلات.

الإصدار 1.0.0-beta01 من Wear-Ongoing

‫4 أغسطس 2021

تم طرح androidx.wear:wear-ongoing:1.0.0-beta01. يتضمّن الإصدار 1.0.0-beta01 هذه التعديلات.

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

• تقبل بعض أدوات الضبط في OngoingActivity.Builder الآن وسيطة فارغة من أجل توفير التماثل والاتساق لأدوات الضبط وأدوات الجلب (I17ee5)

الإصدار 1.0.0-alpha07 من Wear-Phone-Interactions

‫4 أغسطس 2021

تم طرح androidx.wear:wear-phone-interactions:1.0.0-alpha07. يتضمّن الإصدار 1.0.0-alpha07 هذه التعديلات.

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

• تمت إعادة تسمية WearTypeHelper.isChinaDevice إلى WearTypeHelper.isChinaBuild. (I47302)
• لقد عدّلنا مكتبة RemoteAuthClient لاختيار redirect_uri تلقائيًا استنادًا إلى نوع الجهاز (بقية العالم/الصين). (I38866)
• تم إصلاح الخطأ الذي تسبَّب في تعذُّر تحويل BridgingConfig من/إلى حِزمة باستخدام ClassCastException. تمت إضافة اختبارات وحدات لفئة BridgingManagerService. (I68ecb)

الإصدار 1.0.0-alpha06 من Wear-Remote-Interactions

‫4 أغسطس 2021

تم طرح androidx.wear:wear-remote-interactions:1.0.0-alpha06. يتضمّن الإصدار 1.0.0-alpha06 هذه التعديلات.

الإصدار 1.0.0-alpha06 من Wear-Phone-Interactions

‫21 تموز (يوليو) 2021

تم طرح androidx.wear:wear-phone-interactions:1.0.0-alpha06. يتضمّن الإصدار 1.0.0-alpha06 هذه التعديلات.

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

• أصبح الصف BridgingManagerSeviceBinder الآن فئة فرعية من Service وتمت إعادة تسميته إلى BridgingManagerSevice. (I9fca2)
• تم تغيير الطريقة RemoteAuthClient.Callback.onAuthorizationError لتشمل المَعلمة OAuthRequest. تتطلّب الطرق التي تحتاج إلى معاودة الاتصال الآن أيضًا منفِّذًا لتشغيل معاودة الاتصال. (I35e11)

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

• لقد أوضحنا واجهة برمجة التطبيقات الخاصة بالمصادقة من خلال توفير المزيد من المَعلمات الموثّقة واستخدام السمات حيثما أمكن ذلك. (I12287)

الإصدار 1.0.0-alpha05 من Wear-Phone-Interactions

‫30 حزيران (يونيو) 2021

تم طرح androidx.wear:wear-phone-interactions:1.0.0-alpha05. يتضمّن الإصدار 1.0.0-alpha05 هذه التعديلات.

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

• المَعلمات الموثَّقة التي يجب تمريرها في الدالة الإنشائية لـ BridgingConfig.Builder.

الإصدار 1.0.0-alpha06 من Wear-Ongoing

‫2 حزيران (يونيو) 2021

تم طرح androidx.wear:wear-ongoing:1.0.0-alpha06. يتضمّن الإصدار 1.0.0-alpha06 هذه التعديلات.

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

• إضافة حقل "العنوان" إلى "النشاط الجاري" (I7a405)

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

• SerializationHelper.copy() الآن بإنشاء نسخة احتياطية من المعلومات (I8b276)
• تحسين مستندات setCategory (Iff01f)

الإصدار 1.0.0-alpha05 من Wear-Ongoing

‫18 أيار (مايو) 2021

تم طرح androidx.wear:wear-ongoing:1.0.0-alpha05. يتضمّن الإصدار 1.0.0-alpha05 هذه التعديلات.

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

• يتضمّن OngoingActivity الآن دوال جلب لاسترداد جميع القيم التي تم ضبطها مباشرةً من خلال Builder (أو القيم التلقائية المأخوذة من الإشعار المرتبط). (Id8ac8)

  • يتم الآن استخدام الفئة الجديدة Status لإنشاء حالة OngoingActivity
  • لم يعُد OngoingActivityData وOngoingActivityStatus ضِمن واجهة برمجة التطبيقات العامة.

• لم يعُد الصنفان TextStatusPart وTimerStatusPart جزءًا من واجهة برمجة التطبيقات المتاحة للجميع. (I57fb6)

  • لإنشاء Part باستخدام نص ثابت، استخدِم Status.TextPart.
  • لإنشاء Part باستخدام ساعة إيقاف (العدّ تصاعديًا)، استخدِم Status.Stopwatch
  • لإنشاء Part باستخدام موقّت (يتم العدّ تنازليًا)، استخدِم Status.Timer

الإصدار 1.0.0-alpha04 من Wear-Ongoing

‫5 أيار (مايو) 2021

تم طرح androidx.wear:wear-ongoing:1.0.0-alpha04. يتضمّن الإصدار 1.0.0-alpha04 هذه التعديلات.

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

• في OngoingActivity، أصبحت الطرق منExistingOngoingActivity تُعرف الآن باسم recoverOngoingActivity.
• يتضمّن OngoingActivity الآن مجموعة كاملة من دوال الحصول على البيانات، وهي الدوال نفسها التي كانت متاحة سابقًا في OngoingActivityData فقط. (I0ee4d)

الإصدار 1.0.0-alpha05 من Wear-Remote-Interactions

‫21 تموز (يوليو) 2021

تم طرح androidx.wear:wear-remote-interactions:1.0.0-alpha05. يتضمّن الإصدار 1.0.0-alpha05 هذه التعديلات.

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

• أضفنا الفئة RemoteIntentHelper (التي كانت تُعرف سابقًا باسم RemoteIntent في 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.

الإصدار 1.0.0-alpha03 من Wear-Remote-Interactions

‫7 نيسان (أبريل) 2021

تم طرح androidx.wear:wear-remote-interactions:1.0.0-alpha03. يتضمّن الإصدار 1.0.0-alpha03 هذه التعديلات.

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

• تم تغيير PlayStoreAvailability ليصبح فئة تحتوي على عنصر مصاحب يتضمّن طرقًا ثابتة. يظل الاستخدام كما هو.

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

• تم إصلاح مستند الملخّص الخاص بـ WatchFaceConfigIntentHelper لعرض نموذج الرمز بشكل صحيح باستخدام أحرف HTML الفعلية.

‫Wear-Ongoing Wear-Phone-Interactions الإصدار 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، وإضافة إمكانية استخدام إضافة PKCE لبروتوكول OAuth (I3eaaa)

الإصدار 1.0.0-alpha02 من Wear-Remote-Interactions

‫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، وهي توفّر طرقًا مساعدة لتحديد نوع الهاتف الذي تم إقران الساعة الحالية به، وذلك للاستخدام على الأجهزة القابلة للارتداء فقط. (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 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 وإضافة طريقتَين جديدتَين هما: 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 Complications & Watchface

‫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)
• أزلنا عمليات التحويل المختلفة لـ Binder wear-watchface-client، ومن المفترض أن تكون ضرورية. (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. تتضمّن الإضافة أيضًا استدعاء 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 Watch Face (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 من "مكتبة دعم الأجهزة القابلة للارتداء" إلى 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)
• تمت إضافة إمكانية ضبط الهوامش على العناصر الفرعية من WearArcLayout من خلال تغيير مَعلمات التصميم لتوسيع MarginLayoutParams، أي أنّ WearArcLayout.LayoutParams توسّع android.view.ViewGroup.MarginLayoutParams. (I2cd88)
• تغيير نوع نقطة الارتكاز التلقائي في WearCurvedTextView إلى WearArcLayout.ANCHOR_CENTER (كان WearArcLayout.ANCHOR_START). يؤدي ذلك إلى تبسيط العقد بين تصميم القوس والنص المنحني، لأنّ النص المنحني يرسم نفسه تلقائيًا في المنتصف العلوي، ويمكن أن يدور تصميم القوس الرئيسي إلى المكان المطلوب. (I105ff)

الإصدار 1.2.0-alpha03

‫2 ديسمبر 2020

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

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

حاوية تنسيق جديدة باسم 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

‫10 سبتمبر 2025

تم طرح androidx.wear:wear-input:1.2.0 وandroidx.wear:wear-input-testing:1.2.0. يتضمّن الإصدار 1.2.0 هذه التعديلات.

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

• ثوابت موقع الزرّ الفعلي المكشوف
• تمت إضافة WearableRemoteInputExtender لضبط الإضافات الخاصة بأجهزة Wear على android.app.RemoteInput (على سبيل المثال، تفعيل إدخال رموز الإيموجي)

الإصدار 1.2.0-rc01

‫27 أغسطس 2025

تم إصدار androidx.wear:wear-input:1.2.0-rc01 وandroidx.wear:wear-input-testing:1.2.0-rc01 بدون أي تغييرات منذ آخر إصدار تجريبي. يتضمّن الإصدار 1.2.0-rc01 هذه التعديلات.

الإصدار 1.2.0-beta01

‫30 يوليو 2025

تم إصدار androidx.wear:wear-input:1.2.0-beta01 وandroidx.wear:wear-input-testing:1.2.0-beta01 بدون أي تغييرات ملحوظة منذ آخر إصدارات ألفا. يتضمّن الإصدار 1.2.0-beta01 هذه التعديلات.

الإصدار 1.2.0-alpha04

‫16 يوليو 2025

تم طرح androidx.wear:wear-input:1.2.0-alpha04 وandroidx.wear:wear-input-testing:1.2.0-alpha04. يتضمّن الإصدار 1.2.0-alpha04 هذه التعديلات.

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

• يجب مراعاة تدوير الشاشة عند احتساب موضع الأزرار المادية بالنسبة إلى الشاشة. (87a57e)

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

• أعِد تسمية LOC* إلى LOCATION* في wear-input. (I5e879)

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

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

الإصدار 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 Support Library إلى AndroidX تمت إعادة تسمية الفئة التي تم نقلها إلى RemoteInputIntentHelper، وهي توفّر دوال مساعِدة لإتاحة الإدخالات عن بُعد من خلال بدء هدف. (I47cee)

Wear-Input 1.0.0

الإصدار 1.0.0

‫2 ديسمبر 2020

تم طرح androidx.wear:wear-input:1.0.0 وandroidx.wear:wear-input-testing:1.0.0. يتضمّن الإصدار 1.0.0 هذه التعديلات.

هذا الإصدار مطابق للإصدار 1.0.0-rc01.

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

• نقل وظيفة WearableButtons من 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 هذه التعديلات.

الإصدار 1.0.0-alpha01 من Wear-Input-Testing

‫14 أكتوبر 2020

تم طرح androidx.wear:wear-input-testing:1.0.0-alpha01. يتضمّن الإصدار 1.0.0-alpha01 هذه التعديلات.

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

• تمت إضافة androidx.wear.input.test.TestWearableButtonsProvider التي تنفّذ androidx.wear.input.WearableButtonsProvider للمساعدة في اختبار التطبيقات المطوّرة باستخدام مكتبة androidx.wear:wear-input. (I0ed0c)

الإصدار 1.0.0-alpha01 من Wear-Input

‫2 سبتمبر 2020

تم طرح androidx.wear:wear-input:1.0.0-alpha01. يتضمّن الإصدار 1.0.0-alpha01 هذه التعديلات.

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

نقل وظيفة WearableButtons من 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)