Wear

إنشاء تطبيقات لساعات Wear OS الذكية من Google

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

العناصر الإصدار الثابت إصدار محتمل الإصدار التجريبي إصدار أولي
ارتداء 1.3.0 - - 1.4.0-alpha01
wear-input 1.1.0 - - 1.2.0-alpha02
wear-input-testing 1.1.0 - - 1.2.0-alpha02
مستنِد إلى الارتداء 1.0.0 - - 1.1.0-alpha01
wear-phone-interactions 1.0.1 - - 1.1.0-alpha04
تفاعلات الارتداء عن بُعد 1.0.0 1.1.0-rc01 - -
تاريخ آخر تعديل لهذه المكتبة: 16 تشرين الأول (أكتوبر) 2024

إعلان التبعيات

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

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

Groovy

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

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

    // Use to implement wear ongoing activities
    implementation "androidx.wear:wear-ongoing:1.0.0"

    // Use to implement support for interactions from the Wearables to Phones
    implementation "androidx.wear:wear-phone-interactions:1.0.1"
    // Use to implement support for interactions between the Wearables and Phones
    implementation "androidx.wear:wear-remote-interactions:1.0.0"
}

Kotlin

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

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

    // Use to implement wear ongoing activities
    implementation("androidx.wear:wear-ongoing:1.0.0")

    // Use to implement support for interactions from the Wearables to Phones
    implementation("androidx.wear:wear-phone-interactions:1.0.1")
    // Use to implement support for interactions between the Wearables and Phones
    implementation("androidx.wear:wear-remote-interactions:1.0.0")
}

لمزيد من المعلومات عن العناصر الاعتمادية، اطّلِع على مقالة إضافة عناصر الاعتماد الخاصة بالإصدار.

ملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا واجهت مشاكل جديدة أو كان لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة تصويتك إلى مشكلة حالية من خلال النقر على زر النجمة.

إنشاء مشكلة جديدة

اطّلِع على مستندات أداة تتبُّع المشاكل لمزيد من المعلومات.

الإصدار 1.0 من Wear Core

الإصدار 1.0.0-alpha01

29 أيار (مايو) 2024

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

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

  • تمت إضافة فئة جديدة WearApiVersionhelper للمساعدة في التحقّق من توافق واجهة برمجة التطبيقات في وقت التشغيل على Wear. يمكن للعملاء استخدام فئة المساعدة الثابتة هذه والطريقة المقدَّمة (#isApiVersionAtLeast(VERSION)) للتحقّق من التوافق.

الإصدار 1.0 من معاينة أداة Wearing

الإصدار 1.0.0

29 تشرين الثاني (نوفمبر) 2023

تم إصدار androidx.wear:wear-tooling-preview:1.0.0. يحتوي الإصدار 1.0.0 على عمليات الربط هذه.

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

  • أضِف WearDevices إلى قائمة أجهزة Wear الصالحة التي يمكن استخدامها لمعاينة واجهة المستخدم.

الإصدار 1.0.0-rc01

15 تشرين الثاني (نوفمبر) 2023

تم طرح androidx.wear:wear-tooling-preview:1.0.0-rc01 بدون أي تغييرات. يحتوي الإصدار 1.0.0-rc01 على هذه المراجعات.

الإصدار 1.0.0-beta01

18 تشرين الأول (أكتوبر) 2023

تم طرح الإصدار androidx.wear:wear-tooling-preview:1.0.0-beta01 بدون أي تغييرات. يحتوي الإصدار 1.0.0-beta01 على هذه المراجعات.

الإصدار 1.0.0-alpha01

23 آب (أغسطس) 2023

تم إصدار androidx.wear:wear-tooling-preview:1.0.0-alpha01. يحتوي الإصدار 1.0.0-alpha01 على هذه المراجعات.

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

  • أضِف WearDevices إلى قائمة أجهزة Wear الصالحة التي يمكن استخدامها لمعاينات واجهة المستخدم (Ib036e).

الإصدار 1.4 من Wear

الإصدار 1.4.0-alpha01

15 تشرين الثاني (نوفمبر) 2023

تم إصدار androidx.wear:wear:1.4.0-alpha01. يحتوي الإصدار 1.4.0-alpha01 على هذه المراجعات.

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

  • يجب وضع رمز ConfirmationOverlay في منتصف الشاشة عموديًا عندما لا تكون هناك رسالة. (I496d8)

الإصدار 1.3 من Wear

الإصدار 1.3.0

9 آب (أغسطس) 2023

تم إصدار androidx.wear:wear:1.3.0 بدون أي تغييرات منذ 1.3.0-rc01. يحتوي الإصدار 1.3.0 على هذه المراجعات.

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

  • عليك نقل بيانات "AmbientModeSupport" لاستخدام "LifecycleObserver". إيقاف AmbientModeSupport نهائيًا واستبدالها بالفئات الجديدة التي تتضمّن معلومات عن دورة الحياة
  • تعديل ConfirmationOverlay باستخدام رموز/تنسيق جديدَين وخطوط ومقاييس خطوط
  • تم تعديل SwipeDismissTransitionHelper لاستخدام عنصر قابل للرسم في الخلفية بدلاً من View ثانٍ لتصحيح الأخطاء عند استخدام FragmentContainerView
  • SwipeDismissFrameLayout تم تعديل الرسوم المتحركة لتتلاءم مع منصة Wear وعمليات تنفيذ Wear Compose.
  • SwipeDismissFrameLayout إصلاح خطأ لتجنّب إغلاق الأجزاء عن طريق الخطأ من خلال التمرير سريعًا للأعلى أو للأسفل
  • تتيح ArcLayout الآن استخدام أوزان التوسيع التي تعمل بطريقة مشابهة لأوزان التنسيق العادية.
  • استخدام layoutDirection على ArcLayout

الإصدار 1.3.0-rc01

‫21 حزيران (يونيو) 2023

تم إصدار androidx.wear:wear:1.3.0-rc01 بدون أي تغييرات منذ 1.3.0-beta01. يحتوي الإصدار 1.3.0-rc01 على هذه عمليات التنفيذ.

الإصدار 1.3.0-beta01

7 حزيران (يونيو) 2023

تم إصدار androidx.wear:wear:1.3.0-beta01. يحتوي الإصدار 1.3.0-beta01 على هذه المراجعات.

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

  • تم تعديل AmbientLifecycleObserver بعد تلقّي الملاحظات. تمت إعادة تسمية AmbientLifecycleObserverInterface إلى AmbientLifecycleObserver، ويمكن الحصول على مثيل من خلال الاتصال بـ AmbientLifecycleObserver(...). تم نقل isAmbient ليكون حقلاً بدلاً من طريقة. (I84b4f)

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

  • إضافة عمليات التحقّق من القيمة الخالية للتعامل مع الحالات التي تكون فيها طريقة العرض الرئيسية خالية أثناء إعادة ضبط قيمة ألفا والترجمة في SwipeToDismiss (Ib0ec7)

الإصدار 1.3.0-alpha05

19 نيسان (أبريل) 2023

تم طرح androidx.wear:wear:1.3.0-alpha05. يحتوي الإصدار 1.3.0-alpha05 على هذه المراجعات.

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

  • نقل AmbientModeSupport لاستخدام LifecycleObserver إيقاف AmbientModeSupport نهائيًا واستبدالها بالفئات الجديدة التي تتضمّن معلومات عن دورة الحياة (I1593b)

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

  • عدِّل أسلوب SwipeDismissTransitionHelper لخلفية الشاشة المصغّرة لاستخدام عناصر قابلة للرسم بدلاً من إضافة عرض لإصلاح الأخطاء أثناء استخدام FragmentContainerView. (I851cd)

الإصدار 1.3.0-alpha04

25 كانون الثاني (يناير) 2023

تم طرح androidx.wear:wear:1.3.0-alpha04. يحتوي الإصدار 1.3.0-alpha04 على هذه المراجعات.

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

  • تم تعديل الصورة المتحركة في SwipeDismissFrameLayout لتتوافق مع نظام Wear الأساسي وعمليات تنفيذ Wear Compose. (I7261b)

الإصدار 1.3.0-alpha03

24 آب (أغسطس) 2022

تم إصدار androidx.wear:wear:1.3.0-alpha03. يحتوي الإصدار 1.3.0-alpha03 على هذه عمليات التنفيذ.

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

  • تتيح ArcLayout الآن استخدام أوزان التوسيع التي تعمل بطريقة مشابهة لأوزان التنسيق العادية. وهذا يعني أنّه يمكنك تحديد الحجم النسبي للعناصر الفرعية بدون الحاجة إلى احتساب زواياها مباشرةً. ولقد أضفنا أيضًا أفضل جهد MaxAngleDegrees تتم الالتزام به عند توسيع العناصر الثانوية باستخدام معاملات الترجيح. على سبيل المثال، يمكنك تثبيت القوس مع العديد من العناصر الثانوية التي تصل وزنها إلى 90 درجة، وسيحترم ذلك أيضًا المساحة التي تشغلها أي عناصر غير موسعة.

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

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

الإصدار 1.3.0-alpha02

23 شباط (فبراير) 2022

تم إصدار androidx.wear:wear:1.3.0-alpha02. يحتوي الإصدار 1.3.0-alpha02 على هذه المراجعات.

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

  • تقديم الدعم لـ "layoutDirection" على "ArcLayout" (I14d49)
  • رسالة وصف محتوى محسّنة لـ ControlOverlay (I0fdf8)
  • عدِّل ConfirmationOverlay باستخدام رموز أو تنسيق جديد. (If5b54)

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

  • تمت إضافة قواعد ProGuard لضمان الاحتفاظ بالرموز البرمجية المتعلّقة بالمحتوى المحيط (Idaa10)
  • تجنُّب إغلاق الأجزاء عن طريق الخطأ في SwipeDismissFrameLayout باستخدام التمرير السريع العمودي (Idb6d8)
  • إصلاح ConfirmationOverlay عندما لا يتضمّن رسالة (I63e6f)

المساهمة الخارجية

  • Dae Gyu LEE (Samsung) - تجنُّب إغلاق الأجزاء بشكل عرضي في scrollRemoveFrameLayout باستخدام التمرير الرأسي (Idb6d8)

الإصدار 1.3.0-alpha01

29 أيلول (سبتمبر) 2021

تم إصدار androidx.wear:wear:1.3.0-alpha01. يحتوي الإصدار 1.3.0-alpha01 على هذه عمليات التنفيذ.

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

  • ConfirmationOverlay يدفع الرمز الآن للأعلى لاستيعاب الرسائل الأطول، بدون أن تدخل الرسالة في الحافة الجانبية للجهاز (أو خارج الشاشة). (I54bff)

Wear Ongoing & Interactions Version 1.1.0

الإصدار 1.1.0-rc01

16 تشرين الأول (أكتوبر) 2024

تم طرح androidx.wear:wear-remote-interactions:1.1.0-rc01 بدون أي تغييرات منذ 1.1.0-beta01. يتضمّن الإصدار 1.1.0-rc01 عمليات الربط هذه.

الإصدار 1.1.0-beta01

24 يوليو 2024

تم طرح androidx.wear:wear-remote-interactions:1.1.0-beta01. يحتوي الإصدار 1.1.0-beta01 على عمليات التنفيذ هذه. يشير الإصدار 1.3.0-beta01 من Wear Remote Interactions إلى أنّ هذا الإصدار من المكتبة مكتمل الميزات وأنّ واجهة برمجة التطبيقات مقفلة (باستثناء الحالات التي تم وضع علامة عليها كإصدار تجريبي).

الإصدار 1.1.0-alpha04

10 كانون الثاني (يناير) 2024

تم إصدار androidx.wear:wear-phone-interactions:1.1.0-alpha04. يحتوي الإصدار 1.1.0-alpha04 على هذه المراجعات.

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

  • أضفنا RemoteAuthClient.isRemoteAuthAvailable الذي يتحقّق مما إذا كانت المصادقة عن بُعد متاحة. (Ibc10c)

الإصدار 1.1.0-alpha02

10 كانون الثاني (يناير) 2024

تم إصدار androidx.wear:wear-remote-interactions:1.1.0-alpha02. يحتوي الإصدار 1.1.0-alpha02 على هذه المراجعات.

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

  • أضفنا RemoteActivityHelper.isRemoteActivityHelperAvailable الذي يساعد في التحقّق مما إذا كانت وظيفة بدء نشاط عن بُعد متاحة. (I107a9)
  • لقد عدّلنا دالة إنشاء RemoteActivityHelper لتوفير مَعلمة اختيارية متوافقة مع Java. (I75554)

الإصدار 1.1.0-alpha01

‫21 حزيران (يونيو) 2023

تم طرح androidx.wear:wear-remote-interactions:1.1.0-alpha01. يحتوي الإصدار 1.1.0-alpha01 على هذه المراجعات.

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

  • تم تحسين طريقة إكمال المهام ومعالجة الأخطاء في RemoteActivityHelper. (I60d60)

المساهمة الخارجية

  • يمكنك إزالة تبعية Java من wear-remote-interactions واستخدام بدائل أصغر.

الإصدار 1.1.0-alpha03 من Wear-الهاتف

9 آذار (مارس) 2022

تم إصدار androidx.wear:wear-phone-interactions:1.1.0-alpha03. يحتوي الإصدار 1.1.0-alpha03 على هذه المراجعات.

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

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

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

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

تم إصدار androidx.wear:wear-phone-interactions:1.1.0-alpha02. يحتوي الإصدار 1.1.0-alpha02 على هذه المراجعات.

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

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

الإصدار 1.1.0-alpha01 من Wear-الهاتف

15 أيلول (سبتمبر) 2021

تم إصدار androidx.wear:wear-phone-interactions:1.1.0-alpha01. يحتوي الإصدار 1.1.0-alpha01 على هذه المراجعات.

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

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

Wear Ongoing & Interactions Version 1.0.0

Wear-Phone-Interactions الإصدار 1.0.1

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

تم إصدار androidx.wear:wear-phone-interactions:1.0.1. يحتوي الإصدار 1.0.1 على هذه المراجعات.

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

  • تم طرح استثناء ثابت من BridgingManager عند محاولة إيقاف ربط الإشعارات بدون excludedTags.

Wear-الهاتف-تفاعلات Wear-التفاعلات عن بُعد-الإصدار 1.0.0

15 أيلول (سبتمبر) 2021

تم طرح androidx.wear:wear-phone-interactions:1.0.0 وandroidx.wear:wear-remote-interactions:1.0.0. يحتوي الإصدار 1.0.0 على عمليات الربط هذه.

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

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

  • PhoneDeviceType، لتوفير طرق مساعدة لتحديد نوع الهاتف الذي تمت إقران الساعة الحالية به، وذلك للاستخدام على الأجهزة القابلة للارتداء فقط
  • واجهات برمجة التطبيقات BridgingManager وBridgingManagerService وBridgingConfig لتفعيل الإشعارات أو إيقافها أثناء التشغيل واختياريًا ضبط علامات للإشعارات المعفاة من وضع الربط
  • RemoteAuthClient، مع توفير إمكانية المصادقة عن بُعد على الأجهزة القابلة للارتداء وإضافة إضافة OAuth PKCE يتم توفير فئات معالجات ومساعِدين إضافية للتواصل.

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

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

Wear-Phone-Interactions Wear-Remote-Interactions Version 1.0.0-rc01

1 أيلول (سبتمبر) 2021

تم إصدار androidx.wear:wear-phone-interactions:1.0.0-rc01 وandroidx.wear:wear-remote-interactions:1.0.0-rc01. يحتوي الإصدار 1.0.0-rc01 على هذه المراجعات.

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

  • إصلاح خلل كان يمنع نشر الأخطاء التي تمّ رصدها في "خدمات Google Play" إلى المُتصل عند استخدام RemoteActivityHelper (I60d60)
  • إصلاح الخطأ الذي لا يمكن أن يفي به RemoteActivityHelper مطلقًا في حال عدم وجود عُقد متصلة، أو في حال لم يتم العثور على نقطة الاتصال المطلوبة (I60d60)

الإصدار 1.1 من نظام التشغيل Wear OS

الإصدار 1.1.0-alpha01

23 آب (أغسطس) 2023

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

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

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

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

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

Wear-Ongoing Version 1.0.0

1 أيلول (سبتمبر) 2021

تم إصدار androidx.wear:wear-ongoing:1.0.0. يحتوي الإصدار 1.0.0 على عمليات التنفيذ هذه.

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

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

Wear-Phone-Interactions Wear-Remote-Interactions Version 1.0.0-beta01

18 آب (أغسطس) 2021

تم إصدار androidx.wear:wear-phone-interactions:1.0.0-beta01 وandroidx.wear:wear-remote-interactions:1.0.0-beta01. يحتوي الإصدار 1.0.0-beta01 على هذه المراجعات.

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

  • تمت إعادة تسمية الصف RemoteIntentHelper إلى RemoteActivityHelper. تمت إعادة تسمية الدالتَين RemoteIntentHelper#getRemoteIntentExtraIntent وRemoteIntentHelper#getRemoteIntentNodeId إلى RemoteActivityHelper#getTargetIntent وRemoteActivityHelper#getTargetNodeId على التوالي. (Id2042)

Wear-Ongoing Version 1.0.0-rc01

18 آب (أغسطس) 2021

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

Wear-Ongoing Version 1.0.0-beta01

4 آب (أغسطس) 2021

تم إصدار androidx.wear:wear-ongoing:1.0.0-beta01. يحتوي الإصدار 1.0.0-beta01 على هذه المراجعات.

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

  • تقبل الآن بعض وظائف الإعداد في OngoingActivity.Builder دالّة null من أجل توفير توازن واتساق لوظائف الإعداد والحصول (I17ee5).

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

4 آب (أغسطس) 2021

تم إصدار androidx.wear:wear-phone-interactions:1.0.0-alpha07. يحتوي الإصدار 1.0.0-alpha07 على هذه المراجعات.

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

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

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

4 آب (أغسطس) 2021

تم طرح androidx.wear:wear-remote-interactions:1.0.0-alpha06. يحتوي الإصدار 1.0.0-alpha06 على هذه المراجعات.

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

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

تم طرح androidx.wear:wear-phone-interactions:1.0.0-alpha06. يحتوي الإصدار 1.0.0-alpha06 على هذه المراجعات.

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

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

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

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

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

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

تم إصدار androidx.wear:wear-phone-interactions:1.0.0-alpha05. يحتوي الإصدار 1.0.0-alpha05 على هذه المراجعات.

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

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

الإصدار 1.0.0-alpha06 مستمرًا في نظام Wear OS

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

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

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

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

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

  • SerializationHelper.copy() يُنشئ الآن نسخة دفاعية من المعلومات (I8b276).
  • تحسين مستندات setCategory (Iff01f)

الإصدار 1.0.0-alpha05 مستمرًا في نظام Wear OS

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

تم طرح androidx.wear:wear-ongoing:1.0.0-alpha05. يحتوي الإصدار 1.0.0-alpha05 على هذه المراجعات.

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

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

    • يتم الآن استخدام الفئة الجديدة Status لإنشاء حالة OngoingActivity.
    • لم يعُد OngoingActivityData وOngoingActivityStatus جزءًا من واجهة برمجة التطبيقات المتاحة للجميع.
  • لم تعُد الصفتان TextStatusPart وTimerStatusPart جزءًا من واجهة برمجة التطبيقات العامة. (I57fb6)

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

الإصدار 1.0.0-alpha04 مستمرًا في نظام Wear OS

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

تم إصدار androidx.wear:wear-ongoing:1.0.0-alpha04. يحتوي الإصدار 1.0.0-alpha04 على عمليات التنفيذ هذه.

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

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

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

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

تم إصدار androidx.wear:wear-remote-interactions:1.0.0-alpha05. يحتوي الإصدار 1.0.0-alpha05 على هذه المراجعات.

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

  • أضفنا فئة RemoteIntentHelper (المعروفة سابقًا باسم RemoteIntent في مكتبة دعم الأجهزة القابلة للارتداء) التي يمكن استخدامها لفتح النوايا على الأجهزة الأخرى (أي من الساعة إلى الهاتف). (I1d7e0)

  • تمت إزالة فئة PlayStoreAvailability من مكتبة AndroidX. لرصد ما إذا كان "متجر Play" متاحًا على هاتف متّصل، يمكنك استخدام طريقة androidx.phone.interactions.PhoneTypeHelper.getPhoneDeviceType لتحديد ما إذا كان الهاتف المتصل هو هاتف Android. بعد ذلك، استخدِم طريقة androidx.wear.utils.WearTypeHelper.isChinaDevice لتحديد ما إذا كان الهاتف المتصل هو جهاز صيني. إذا كان الهاتف هو هاتف Android وليس جهازًا صينيًا، سيكون "متجر Play" متاحًا. (Ie7dec)

Wear-Phone-Interactions الإصدار 1.0.0-alpha04

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

تم إصدار androidx.wear:wear-phone-interactions:1.0.0-alpha04. يحتوي الإصدار 1.0.0-alpha04 على هذه المراجعات.

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

  • تم تعديل ثوابت ErrorCode لجعل المكتبة الجديدة متوافقة مع الإصدارات القديمة مع التنفيذ في مكتبة الدعم القابل للارتداء.

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

  • تم إصلاح استثناء ناتج عن واجهة برمجة التطبيقات الجديدة لبروتوكول OAuth عند بدء جلسة OAuth.

الإصدار 1.0.0-alpha03 من Wear-عن بُعد

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

تم طرح androidx.wear:wear-remote-interactions:1.0.0-alpha03. يحتوي الإصدار 1.0.0-alpha03 على هذه المراجعات.

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

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

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

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

Wear-Ongoing Wear-Phone-Interactions Version 1.0.0-alpha03

10 آذار (مارس) 2021

تم إصدار androidx.wear:wear-ongoing:1.0.0-alpha03 وandroidx.wear:wear-phone-interactions:1.0.0-alpha03. يحتوي الإصدار 1.0.0-alpha03 على هذه المراجعات.

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

  • نقل OAuthClient من مكتبة الدعم القابل للارتداء إلى AndroidX. تمت إعادة تسمية هذه الفئة التي تم نقلها إلى RemoteAuthClient، وهي تتيح المصادقة عن بُعد على الأجهزة القابلة للارتداء، بالإضافة إلى إمكانية إضافة إضافة OAuth PKCE. يتم توفير فئات معالجات ومساعِدين إضافية للتواصل.
  • يمكن الآن ربط الأنشطة الجارية بإشعار يحتوي على علامة، وذلك باستخدام الدالة الإنشائية الجديدة OnthroughActivity.Builder.

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

  • تمت إضافة دعم علامات الإشعارات في "مكتبة الأنشطة الجارية" (I653b4).
  • نقل بيانات OAuthClient من مكتبة دعم Wear إلى AndroidX وإتاحة إضافة OAuth PKCE (I3eaaa)

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

10 آذار (مارس) 2021

تم طرح androidx.wear:wear-remote-interactions:1.0.0-alpha02. يحتوي الإصدار 1.0.0-alpha02 على عمليات التنفيذ هذه.

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

  • نقل فئة PlayStoreAvailability من مكتبة Wearable Support Library إلى AndroidX التي توفّر واجهة برمجة تطبيقات للتحقّق مما إذا كان "متجر Play" متاحًا على الهاتف

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

  • نقل الصف الدراسي PlayStoreStore من Wearable Support Library إلى AndroidX (I69bfe)

الإصدار 1.0.0-alpha02

10 شباط (فبراير) 2021

تم إصدار androidx.wear:wear-ongoing:1.0.0-alpha02 وandroidx.wear:wear-phone-interactions:1.0.0-alpha02. يحتوي الإصدار 1.0.0-alpha02 على عمليات التنفيذ هذه.

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

  • تمت إضافة دعم للحالات الأكثر تعقيدًا. وهي تتكون من نموذج (أو عدة أجزاء) وسلسلة من الأجزاء التي سيتم استخدامها لملء العناصر النائبة للنموذج. تتضمّن OngoingActivityStatus الآن طريقة ثابتة لإنشاء حالات بسيطة تتألف من جزء واحد فقط (نص أو موقّت)، و"أداة إنشاء" لإنشاء حالات أكثر تعقيدًا. (I1fe81)
  • نقل فئتَي BridgingManager وBridgingConfig من مكتبة Wear Support Library إلى AndroidX التي توفّر واجهات برمجة تطبيقات لتفعيل الإشعارات أو إيقافها أثناء التشغيل واختياريًا ضبط علامات للإشعارات المعفاة من وضع الربط (I3a17e)

الإصدار 1.0.0-alpha01

27 كانون الثاني (يناير) 2021

تم إصدار androidx.wear:wear-ongoing:1.0.0-alpha01 وandroidx.wear:wear-phone-interactions:1.0.0-alpha01 وandroidx.wear:wear-remote-interactions:1.0.0-alpha01. يحتوي الإصدار 1.0.0-alpha01 على هذه المراجعات.

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

  • نقل مكتبة "الأنشطة الجارية" إلى مكتبة فرعية جديدة: wear-ongoing تتوفّر الصفوف الآن في حزمة androidx.wear.oncomplete (وكانت سابقًا androidx.wear.onlaunchactivities) (I7c029).

  • أنشئ مكتبة دعم جديدة تحتوي على فئات تتيح التفاعلات من الأجهزة القابلة للارتداء إلى الهواتف. تتم تعبئة هذا الحقل في البداية بفئات تم نقلها من مكتبة دعم الأجهزة القابلة للارتداء. (Id5180)

  • نقل فئة PhoneDeviceType من مكتبة Wearable Support Library إلى AndroidX تمت إعادة تسمية الفئة التي تم نقلها باسم PhoneTypeHelper التي تقدّم طرقًا مساعدة لتحديد نوع الهاتف الذي تم إقران الساعة الحالية به، وذلك للاستخدام على الأجهزة القابلة للارتداء فقط. (Ibd947)

  • أنشئ مكتبة دعم جديدة تحتوي على فئات تتيح التفاعلات بين الأجهزة القابلة للارتداء والهواتف. تتم تعبئة هذا الحقل في البداية بفئات تم نقلها من مكتبة دعم الأجهزة القابلة للارتداء. (I9deb4)

  • نقل فئة WatchFaceCompanion من مكتبة Wearable Support Library إلى AndroidX تمت إعادة تسمية الفئة التي تم نقلها باسم WatchFaceConfigIntentHelper الذي يقدّم دوالّ مساعدة لتحديد رقم التعريف واسم المكوّن في أنشطة ضبط خلفية شاشة الساعة في التطبيق المصاحب على الهاتف، ويمكن استخدامه أيضًا على الجهاز لضبط خلفية شاشة الساعة على الجهاز القابل للارتداء. (Ia455f)

إضافات Wear وخلفية شاشة الساعة 1.0.0

الإصدار 1.0.0-alpha22

15 أيلول (سبتمبر) 2021

تم إصدار androidx.wear:wear-*:1.0.0-alpha22. يحتوي الإصدار 1.0.0-alpha22 على هذه المراجعات.

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

  • ينضمّ الآن EditorSession إلى مراقبي دورة الحياة، ما يغنيك عن إغلاقه صراحةً عند انتهاء نشاطك.

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

  • يستخدم كلّ من EditorSession وListenableEditorSession الآن kotlin StateFlows لـ complicationSlotsState وComplicationsPreviewData وComplicationsDataSourceInfo. (I761d9)
  • EditorSession#userStyle هي الآن MutableStateFlow<UserStyle> (I32ca9).
  • يستخدم EditorSession.createOnWatchEditorSession الآن أداة مراقبة مراحل النشاط ويتم إغلاقه تلقائيًا عند رصد onDestroy. بالإضافة إلى ذلك، لا تتطلّب createOnWatchEditorSession الآن سوى تمرير النشاط. تم أيضًا تطبيق تغييرات مماثلة على ListenableEditorSession. (Ic6b7f)
  • تمت إعادة إنشاء CustomValueUserStyleSetting كجزء من واجهة برمجة التطبيقات المتاحة للجميع. (I2e69a)
  • يكتسب UserStyle الآن القيمة من Map<UserStyleSetting, UserStyleSetting.Option> ويُعرِض MutableUserStyleSetting#put IllegalArgumentException إذا لم يكن الإعداد مضمّنًا في المخطّط أو إذا لم يتطابق الخيار مع الإعداد. (Iba40f)

الإصدار 1.0.0-alpha21

1 أيلول (سبتمبر) 2021

تم طرح androidx.wear:wear-*:1.0.0-alpha21. يحتوي الإصدار 1.0.0-alpha21 على هذه عمليات التنفيذ.

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

  • تستخدم الآن جميع واجهات برمجة التطبيقات العامة لخلفيات شاشة الساعة والعملاء والمحرِّرين والعناصر المخصّصة واجهة java.time.Instant للوقت بدلاً من Long، ونتيجةً لذلك، ارتفع الحد الأدنى لمستوى واجهة برمجة التطبيقات إلى 26. (I3cd48)
  • تستخدم الآن واجهات برمجة التطبيقات لخلفية شاشة الساعة وواجهات برمجة التطبيقات الإضافية تنسيق ZonedDateTime غير القابل للتغيير بدلاً من "تقويم Google". (I25cf8)
  • تم الآن إعداد ComplicationSlots باستخدام NoDataComplicationData، وأصبحت ComplicationSlot.complicationData تحتوي دائمًا على قيمة، ولم تعُد CanvasComplicationDrawable.complicationData قابلة للتغيير. (I4dfd6) يقلل هذا الإجراء من وميض الإضافات (ولكن لا يوقفه تمامًا) عند التبديل بين خلفيات شاشة الساعة.

الإصدار 1.0.0-alpha20

18 آب (أغسطس) 2021

تم إصدار androidx.wear:wear-*:1.0.0-alpha20. يحتوي الإصدار 1.0.0-alpha20 على هذه المراجعات.

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

  • أضفنا createFallbackPreviewData إلى ComplicationDataSourceInfo التي يمكن استخدامها عندما يعرض ComplicationDataSourceInfoRetriever.retrievePreviewComplicationData قيمة فارغة. (I38c4d)
  • تم تحويل ComplicationDataSourceUpdateRequester إلى واجهة للسماح بالمحاكاة في اختبارات الوحدة. يمكنك إنشاء عنصر ComplicationDataSourceUpdateRequester محدّد باستخدام ComplicationDataSourceUpdateRequester.create(). (I7da22)
  • تم استبدال RenderParameters.pressedComplicationSlotIds بـ RenderParameters.lastComplicationTapDownEvents الذي يعرِض فئة TapEvent الجديدة التي تحتوي على ثلاثية من إحداثيات x وy للنقرة بالبكسل والطابع الزمني. تم استبدال WatchFace.TapListener.onTap بـ onTapEvent(@TapType tapType: Int, tapEvent: TapEvent). بالإضافة إلى ذلك، تمت إزالة InteractiveWatchFaceClient.displayPressedAnimation. (Id87d2)
  • تمت إضافة تعليق توضيحي لسلاسل المحادثات الصريحة لـ setImportantForAccessibility (I990fa)
  • تم نقل ComplicationSlotBoundsType إلى androidx-wear-watchface.ComplicationSlotBoundsType in wear/wear-watchface. (I09420)
  • لقد أضفنا دعمًا لتمرير معرّفات موارد السلاسل إلى UserStylesetting وOptions. وهذه هي الطريقة الموصى بها لإنشاء تلك الكائنات. (I03d5f)
  • تم فرض حدود على الحد الأقصى لحجم الأسلاك في مخطّط UserStyle. يجب أيضًا ألا يزيد حجم الرموز في المخطّط عن 400 × 400 بكسل. (I3b65b)
  • أضفنا فئة MutableUserStyle للسماح بإجراء تغييرات على نُسخ UserStyle (I95a40).
  • تمت إعادة تسمية ListenableWatchFaceMetadataClient.Companion#listenableCreateWatchFaceMetadataClient إلى ListenableWatchFaceMetadataClient.Companion#createListenableWatchFaceMetadataClient. (I64ce2)
  • لقد عدّلنا EditorState.previewComplicationsData لكي لا يحتوي إلا على بيانات الملحقات المفعّلة، وأضفنا EditorSession.DEFAULT_PREVIEW_TIME_MILLIS الذي يطلب عند تمريره إلى renderWatchFaceToBitmap أو PreviewScreenshotParams عرض المعاينة باستخدام وقت المعاينة التلقائي لخلفية شاشة الساعة. (If7b3c)
  • لقد أزلنا أدوات إنشاء UserStyleSetting التي تأخذ CharSequence من واجهة برمجة التطبيقات العامة. ويُنصَح باستخدام الدوال الإنشائية التي تتطلّب معرّفات StringResource بدلاً من ذلك. (I8537b)
  • يتيح CurrentUserStyleRepository.UserStyleChangeListener الآن تحويل SAM. (I85989)

الإصدار 1.0.0-alpha19

4 آب (أغسطس) 2021

تم إصدار androidx.wear:wear-*:1.0.0-alpha19. يحتوي الإصدار 1.0.0-alpha19 على هذه المراجعات.

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

  • أضفنا ListenableWatchFaceMetadataClient.listenableCreateWatchFaceMetadataClient الذي يقدّم حزمة ListenableFuture لـ WatchFaceMetadataClient.createWatchFaceMetadataClient. (I5fa37)
  • يقبل UserStyleOption.getOptionForId الآن UserStyleOption.Id بدلاً من مصفوفة بايت. (I469be)
  • تقديم القيم الثابتة BooleanOption.TRUE وBooleanOption.FALSE ومنع إنشاء المثيلات (I46e09)
  • تم الآن وضع تعليقات توضيحية على الطرق في wear-watchface-client التي يمكن أن تؤدي إلى طرح RemoteException. (Ib8438)
  • لتحقيق الاتساق، أُعيدت تسمية EditorSession.createOnWatchEditingSession ليصبح createOnWatchEditorSession، وبالمثل، أصبح createHeadlessEditingSession الآن createHeadlessEditorSession. تمت أيضًا إعادة تسمية أغلفة الجوافة. (I1526b)
  • أصبحت EditorSession الآن واجهة وتم تفويض ListenableEditorSession.commitChangesOnClose بشكل صحيح. (I7dc3e)
  • نرفض الآن أي مخطّط لأسلوب المستخدِم يتضمّن إعدادات أو خيارات تتضمّن أرقام تعريف متضاربة (Ic2715).
  • أضفنا UserStyle.get محمّلاً بشكل زائد يقبل UserStyleSetting.Id. (I2aa0f)

الإصدار 1.0.0-alpha18

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

تم إصدار androidx.wear:wear-*:1.0.0-alpha18. يحتوي الإصدار 1.0.0-alpha18 على هذه المراجعات.

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

  • تم نقل ComplicationHelperActivity إلى مكتبة androidx.wear:wear-watchface. (I39e76)
  • من أجل الاتساق والوضوح، تمت إعادة تسمية ComplicationProvider إلى ComplicationDataSource، وتمّت إعادة تسمية جميع الصفوف التي تحتوي على Provider في اسمها بالطريقة نفسها. (Iaef0b)
  • تم نقل CanvasComplication.isHighlighted إلى RenderParameters.pressedComplicationSlotIds، وهذه خطوة نحو جعل CanvasComplication بدون حالة. لتطبيق هذا التغيير، يستخدم CanvasComplication.render أيضًا slotId كمَعلمة، ونمرر الآن ComplicationSlot إلى GlesTextureComplication. (I50e6e)
  • أضفنا headlessDeviceConfig إلى EditorRequest، وإذا لم تكن هذه المَعلمة فارغة، يتم استخدامها لإنشاء مثيل بدون واجهة مستخدم لدعم EditorSession بدلاً من التصرّف في المثيل التفاعلي. يتيح ذلك استخدام المحرِّر لخلفية شاشة ساعة غير الخلفية الحالية. (I0a820)
  • أضفنا WatchFaceMetadataClient تجريبيًا يتيح استرجاع البيانات الوصفية الثابتة لخلفية شاشة الساعة بكفاءة، مثل UserStyleSchema والتفاصيل الثابتة عن ComplicationSlots. (I6bfdf)
  • لقد أعادنا تسمية CanvasRenderer.uiThreadInit إلى init. (I6fff9)
  • لقد أضفنا مَعلمة PreviewPreviewParams جديدة اختيارية لـ EditorRequest، وهي توجِّه موجّه EditorSession إلى أخذ لقطة شاشة للمعاينة عند الالتزام بهذه المعلمة. تظهر صورة المعاينة على EditorState.previewImage. (Ic2c16)

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

  • لم يعُد على المطوّرين إضافة ComplicationHelperActivity إلى البيان الخاص بهم. (I6f0c2)

الإصدار 1.0.0-alpha17

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

تم إصدار androidx.wear:wear-*:1.0.0-alpha17. يحتوي الإصدار 1.0.0-alpha17 على هذه المراجعات.

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

  • في GlesRenderer، تم استبدال makeUiThreadContextCurrent وmakeBackgroundThreadContextCurrent بـ runUiThreadGlCommands وrunBackgroundThreadGlCommands، وكلاهما يقبلان Runnable. تضمن المكتبة تنفيذ أمر GL قابل للتنفيذ واحد فقط في أي وقت.

  • لتسهيل عملية بدء UiThread، أضفنا CanvasRenderer.uiThreadInit الذي يتم استدعاؤه مرة واحدة في UiThread قبل أي طلبات لعرض المحتوى. أضفنا أيضًا onRendererCreated إلى CanvasComplication، ما يسهّل على Renderer وCanvasComplication مشاركة الحالة.

  • للتوضيح، تمت إعادة تسمية Complication إلى ComplicationSlot وcomplicationId إلى complicationSlotId أو complicationInstanceId حسب الاستخدام.

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

  • للتوضيح، تمت إعادة تسمية Complication إلى ComplicationSlot وcomplicationId إلى complicationSlotId أو complicationInstanceId حسب الاستخدام. تمت إعادة تسمية الفئات التي تستخدم Complication بالطريقة نفسها، مثل ComplicationsManager التي أصبحت الآن تُعرف باسم ComplicationSlotsManager. (I4da44)
  • في GlesRenderer، تم استبدال makeUiThreadContextCurrent وmakeBackgroundThreadContextCurrent بـ runUiThreadGlCommands وrunBackgroundThreadGlCommands اللذان يقبلان Runnable. لا تكون هذه الدوالّ مطلوبة إلا إذا كنت بحاجة إلى إجراء طلبات GL خارج عمليات التقديم وrunBackgroundThreadGlCommands وonUiThreadGlSurfaceCreated. هذا مطلوب لأنّه يمكن أن يكون هناك عدة عناصر GlesRenderer لكل منها سياقاتها الخاصة في العملية نفسها، وقد تكون من خلفيات شاشة ساعة مختلفة. بالإضافة إلى ذلك، تتم مزامنة الوصول إلى سياق GL الحالي المشترك. (I04d59)
  • لقد أضفنا السمة CanvasRenderer.uiThreadInit التي يتم استدعاؤها مرة واحدة في UiThread قبل أن يتم عرض أي طلبات استدعاء. من أجل الوضوح أيضًا في GlesRenderer، تمت إعادة تسمية onGlContextCreated إلى onBackgroundThreadGlContextCreated وonGlSurfaceCreated إلى onUiThreadGlSurfaceCreated. (If86d0)
  • تمت إعادة تسمية "HeadlessWatchFaceClient" و"InteractiveWatchFaceClient" باسم "getComplicationsSlotState" إلى "getComplicationSlotsState". في ComplicationSlot: تمت إعادة تسمية createRoundRectComplicationBuilder وcreateBackgroundComplicationBuilder وcreateEdgeComplicationBuilder إلى createRoundRectComplicationSlotBuilder وcreateBackgroundComplicationSlotBuilder وcreateEdgeComplicationSlotBuilder على التوالي. (Ib9adc)
  • لقد أضفنا onRendererCreated إلى CanvasComplication لتسهيل مشاركة الحالة في كل من Renderer وCanvasComplication. (I5e1ac)

الإصدار 1.0.0-alpha16

16 حزيران (يونيو) 2021

تم إصدار androidx.wear:wear-*:1.0.0-alpha16. يحتوي الإصدار 1.0.0-alpha16 على هذه المراجعات.

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

  • لقد أصلحنا عددًا من الأخطاء المرتبطة بالتغييرات الأخيرة في نموذج سلاسل المحادثات، بالإضافة إلى معالجة مشاكل أخرى في محرِّر خلفية شاشة الساعة.

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

  • منع حدوث أخطاء NPE في onComplicationProviderChooserResult (b/189594557)
  • حلّ المشاكل المتعلّقة بالسطوح القديمة وdrawBlack (b/189452267)
  • إصلاح السباق في الوصول إلى complicationsManager.watchState (b/189457893)
  • إصلاح خطأ في مدة عمل سلسلة المهام في الخلفية (b/189445428)
  • إصلاح مشاكل "محرر خلفيات شاشة الساعة" في الإصدارات السابقة من نظام التشغيل (b/189126313)
  • عدم تعديل مَعلمات التمهيد المباشر لتغييرات نمط المحرِّر (b/187177307)

الإصدار 1.0.0-alpha15

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

تم إصدار androidx.wear:wear-*:1.0.0-alpha15. يحتوي الإصدار 1.0.0-alpha15 على هذه المراجعات.

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

يتم الآن تنفيذ معظم عمليات إعداد خلفية شاشة الساعة في سلسلة مهام في الخلفية، ولكن بعد تحميل كل عمليات عرض خلفية شاشة الساعة وما إلى ذلك، يتم تنفيذها في UiThread. هناك حدّ أقصى للذاكرة بين التحميل والعرض، لذا لا تحتاج معظم خلفيات شاشات الساعة إلى إجراء أيّ إجراء خاص. قد تكون خلفيات شاشة الساعة التي تستخدم GLES استثناءً لأنّ السياق خاص بالسلسلة ونحن ننشئ سياقَين مرتبطَين لكي نتمكّن من تحميل موارد GL (مثل الأشكال والظلال) على سلسلة المهام في الخلفية واستخدامها على UiThread.

لقد قسَّمنا عملية إنشاء خلفيات شاشة الساعة إلى ثلاث دوال: createUserStyleSchema وcreateComplicationsManager وcreateWatchFace. نفترض أنّ createUserStyleSchema وcreateComplicationsManager سريعان وأنّ createWatchFace قد يستغرق بعض الوقت لتحميل مواد العرض. استنادًا إلى ذلك، طرحنا WatchFaceControlClient.getDefaultProviderPoliciesAndType الذي يعرض خريطة لرموز Complication Ids إلى DefaultComplicationProviderPolicies وComplicationType التلقائي. وهذا أسرع من إنشاء مثيل بدون واجهة مستخدم، لأنّه لا يحتاج إلى بدء تشغيل خلفية شاشة الساعة بالكامل لتنفيذ الطلب.

أخيرًا، يتم الآن إنشاء الإضافات باستخدام CanvasComplicationFactory الذي يتيح إنشاء عناصر عرض CanvasComplication بشكل غير متزامن.

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

  • تم استبدال @TargetApi بـ @RequiresApi. (I0184a وb/187447093 وb/187447094)
  • لقد طرحنا WatchFaceControlClient.getDefaultProviderPoliciesAndType الذي يعرض خريطة لرموز Complication Ids إلى DefaultComplicationProviderPolicies وComplicationType التلقائي. يتم استخدام مسار سريع قدر الإمكان لتجنُّب إنشاء خلفية شاشة الساعة بالكامل. لتسهيل ذلك، كان علينا تغيير واجهة برمجة التطبيقات WatchFaceService API باستخدام طريقتَين جديدتَين هما createUserStyleSchema وcreateComplicationsManager، ويتم تمرير نتائجهما إلى createWatchFace. بالإضافة إلى ذلك، تم الآن إنشاء "Complications" (الإضافة) باستخدام CanvasComplication المصنع الذي يسمح بالإنشاء الكسول لبرامج عرض CanvasComplication. (Iad6c1)
  • لقد أزلنا MOST_RECENT_APP من SystemProviders. (I3df00)
  • أصبحت ObservableWatchData الآن فئة مختومة. (Ic940d)
  • يتم الآن استدعاء CanvasComplicationFactory.create (الذي يكون مرتبطًا عادةً بعمليات الإدخال/الإخراج) في سلسلة مهام في الخلفية لكلّ شاشة معلومات مصغّرة قبل بدء عرض سلسلة مهام واجهة المستخدم. هناك حاجز ذاكرة بين الإنشاء والعرض، لذا لا يلزم استخدام عناصر أساسية خاصة لإنشاء مؤشرات الترابط. (Ia18f2)
  • يتم الآن إنشاء خلفية شاشة الساعة في سلسلة مهام في الخلفية على الرغم من أنّه يتم تنفيذ جميع عمليات التقديم في سلسلة مهام واجهة المستخدم، ويتوافق GlesRenderer مع سياقَين مرتبطَين لدعم ذلك. قد يتم حلّ WatchFaceControlClient.createHeadlessWatchFaceClient وWatchFaceControlClient.getOrCreateInteractiveWatchFaceClient قبل اكتمال WatchFaceService.createWatchFace. سيتم حظر طلبات البيانات اللاحقة من واجهة برمجة التطبيقات إلى أن تكتمل عملية إعداد خلفية شاشة الساعة. (Id9f41)
  • لم يعد EXPANSION_DP وSTROKE_WIDTH_DP ظاهرتين في ملف api.txt. (I54801)
  • لقد جعلنا EditorSession.createOnWatchEditingSession يُرسِل TimeoutCancellationException في حال حدوث خطأ بدلاً من إرسال جلسة فارغة. بالإضافة إلى ذلك، أصبحت القيمة المعروضة لـ EditorRequest.createFromIntent وEditorSession.createOnWatchEditingSession الآن NonNull. (I41eb4)

الإصدار 1.0.0-alpha14

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

تم إصدار androidx.wear:wear-*:1.0.0-alpha14. يحتوي الإصدار 1.0.0-alpha14 على هذه عمليات التنفيذ.

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

  • يعرض EditorSession.openComplicationProviderChooser الآن ChosenComplicationProvider الذي يحتوي على معرّف التعقيد ComplicationProviderInfo وحزمة تحتوي على أي إضافات أخرى يعرضها أداة اختيار الموفّر.
  • بالإضافة إلى ذلك، كنّا نعمل باستمرار على نقل الرموز البرمجية إلى Kotlin، وأصبحت الآن معظم واجهات برمجة التطبيقات الخاصة بخلفيات شاشة الساعة محدّدة في Kotlin.

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

  • لم تعد سمتا GlesRenderer eglContext وeglDisplay قابلة للقيم الفارغة. يتم الآن الإبلاغ عن أي أخطاء في GL من خلال GlesRenderer.GlesException بدلاً من RuntimeExceptions. (Ib1005)
  • لقد نقلنا androidx.wear.watchface.complications.rendering.ComplicationDrawable من Java إلى Kotlin (Ibc3eb).
  • لقد نقلنا androidx.wear.watchface.complications.rendering.ComplicationStyle من Java إلى Kotlin (I3375e).
  • أضفنا معلومات عن موفِّر الملحقات لكل ملحق ضمن EditorSession. (I37f14)
  • لقد وسّعنا نطاق نتيجة EditorSession.openComplicationProviderChooser لتضمين المعلومات التي يعرضها العنصر الذي تم اختياره. (Iead6d)

الإصدار 1.0.0-alpha13 من إضافات خلفية شاشة الساعة وتطبيق Wear

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

تم إصدار androidx.wear:wear-*:1.0.0-alpha13. يحتوي الإصدار 1.0.0-alpha13 على هذه عمليات التنفيذ.

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

  • يمكن أن تتضمّن خلفيات شاشة الساعة عناصر مرئية مهمة غير الوقت والعناصر المعقدة. لتوفير إمكانية استخدام قارئ الشاشة لهذه الميزة، يمكن الآن لخلفية شاشة الساعة تحديد تصنيفات ContentDescriptionLabels لتسهيل الاستخدام من خلال سمة additionalContentDescriptionLabels في Renderer. بالإضافة إلى ذلك، تمّت إضافة accessibilityTraversalIndex إلى التعقيدات للتحكّم في ترتيب ContentDescriptionLabels. ويمكن تعديل هذا الإعداد من خلال الإعداد ComplicationsUserStyleSet.

  • لتشجيع المطوّرين على مراعاة برامج قراءة الشاشة بعناية، جعلنا حقل contentDescription في ShortTextComplicationData.Builder وLongTextComplicationData.Builder وRangedValueComplicationData.Builder إلزاميًا ليتم تمريره إلى منشئيها. إذا تمّ إدخال ComplicationText.EMPTY بدلاً من contentDescription، سيتمّ إنشاء contentDescription تلقائيًا من النص والعنوان.

  • تعرض ميزة "WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient" الآن ServiceStartFailureException في حال طرحت خلفية شاشة الساعة استثناءً أثناء عملية الإعداد، ما يسهّل تشخيص المشاكل أثناء بدء تشغيل خلفية شاشة الساعة.

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

  • أضفنا إمكانية استخدام اسم مكوّن فارغ في ComplicationProviderInfo، وهو مطلوب لتوفير التوافق مع الإصدارات القديمة من Wear OS. (I744d2)
  • لقد نقلنا androidx.wear.complications.SystemProviders من Java إلى Kotlin. (Ia1f8b)
  • لقد أخفينا جميع الفئات من واجهة برمجة التطبيقات العامة الموجودة في الإضافة android.support.wearable.comComputes وأنشأنا برامج تضمين مقابلة في AndroidX حسب الحاجة. (I7bd50)
  • تمت إعادة تسمية الطريقة في TimeDifferenceComplicationText.Builder من setMinimumUnit إلى setMinimalTimeUnit. (I20c64)
  • جعلنا حقلي ShortTextComplicationData.Builder وLongTextComplicationData.Builder وRangedValueComplicationData.Builder contentDescription إلزاميًا في الدالة الإنشائية. (I8cb69)
  • لقد أعادنا تسمية ComplicationProviderService.onComplicationUpdate إلى onComplicationRequest و أدرجنا مَعلمتَي id وtype لهذه الطريقة في بيانات ComplicationRequest. تمت إعادة تسمية المستمع المقابل إلى ComplicationRequestListener وطريقة ComplicationRequestListener.onComplicationData. (Iaf146)
  • أزلنا الطريقة isActiveAt من ComplicationData وعرضنا الحقل validTimeRange بدلاً منها. يمكن استبدال استدعاء الطريقة هذا بـ validTimeRange.contains. (I65936)
  • غيَّرنا وصف الطريقة ComplicationProviderService.onComplicationActivated لتلقّي ComplicationType بدلاً من int. (Idb5ff)
  • تم نقل ProviderUpdateRequester من Java إلى Koltin. (Ibce13)
  • أصبحت GlesRender.makeContextCurrent علنية الآن. قد يحتاج رمز خلفية شاشة الساعة إلى إجراء استدعاءات gl خارج العرض وonGlContextCreated، لأنّه قد يكون من الضروري توفّر سياق تفاعلي وآخر بلا واجهة مستخدم رسومية. (I8a43c)
  • يُعرِض WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient الآن ServiceStartFailureException إذا تعرّضت خلفية شاشة الساعة لخطأ أثناء الإعداد. بالإضافة إلى ذلك، تُرسِل WatchFaceService الآن استثناءً إذا استغرقت createWatchFace أكثر من 6 ثوانٍ. (I59b2f)
  • لقد أزلنا سمة id غير المستخدَمة للموقع الإلكتروني GlesTextureComplication. (I28958)
  • يمكن الآن لخلفية شاشة الساعة تحديد ContentDescriptionLabels لسهولة الاستخدام من خلال خاصية additionalContentDescriptionLabels في Renderer. بالإضافة إلى التحكّم في ترتيب ContentDescriptionLabels، تمت إضافة accessibilityTraversalIndex إلى المضاعفات. ويمكن تعديل ذلك باستخدام ComplicationsUserStyleSetting. (Ib7362)
  • توسيع المستندات حول معالجة أحداث اللمس في خلفية شاشة الساعة (Iaf31e)

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

  • تعرض EditorSession.getComplicationsPreviewData() الآن خريطة لكل تطبيقات مصغّرة غير فارغة فقط. يتم استخدام مثيل EmptyComplicationData للعناصر المعقدة الفارغة. (I1ef7e)

الإصدار 1.0.0-alpha12 من الإضافات وخلفيات شاشة الساعة على Wear

21 نيسان (أبريل) 2021

تم طرح androidx.wear:wear-*:1.0.0-alpha12. يحتوي الإصدار 1.0.0-alpha12 على هذه المراجعات.

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

على محرِّري خلفيات شاشة الساعة إبراز أجزاء من خلفية شاشة الساعة للمساعدة في توضيح جانب الساعة الذي يتم ضبطه. لقد وسّعنا نطاق RenderParameters للسماح بتمييز الأنماط بالإضافة إلى التعقيدات. هناك طبقة اختيارية جديدة من HighlightLayer مخصّصة لتطبيق تأثير التمويه على خلفية شاشة الساعة مع شفافية ألفا (يمكن لواجهات برمجة التطبيقات لأخذ لقطات الشاشة تطبيق هذا التمويه نيابةً عنك، أو توفير طبقة HighlightLayer بمفردها لتحقيق أقصى قدر من المرونة). على سبيل المثال، لنفترض أنّ لديك نمطًا يتيح لك ضبط مظهر عقارب الساعة، ويمكن لبرنامج الربط في renderHighlightLayer رسم مخطط حولها.

لتعزيز إتاحة ميزة "موفِّر المكوّنات الإضافية" للوصول، جعلنا حقل contentDescription في PhotoImageComplicationData.Builder وMonochromaticImageComplicationData.Builder و SmallImageComplicationData.Builder مَعلمة إلزامية لإنشاء العنصر. تمت إضافة ComplicationTapFilter وComplication.createEdgeComplicationBuilder لإتاحة المضاعفات على الحواف (المرسومة حول حافة الشاشة). تُترك عملية عرض الإضافات على الحواف واختبار مدى توفّرها لخلفية شاشة الساعة. لا يتوفّر اختبار نتائج الإعلانات على Edge من "أداة التعديل المصاحبة".

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

  • تمت إضافة البادئة PROVIDER_ إلى الثوابت في SystemProviders. (I1e773)
  • لقد جعلنا حقل contentDescription في كل من PhotoImageComplicationData.Builder وMonochromaticImageComplicationData.Builder وSmallImageComplicationData.Builder إلزاميًا لإرساله في دالة الإنشاء. (I9643a)
  • تمت إعادة تسمية ProviderInfoRetriever.requestPreviewComplicationData إلى retrievePreviewComplicationData. (I911ee)
  • تم نقل ComplicationProviderService من Java إلى Koltin. (I849f2)
  • أصبحت الطريقة ComplicationProviderService.onBind نهائية (I39af5)
  • أعدنا واجهة CanvasComplication ونقلنا CanvasComplicaitonDrawable وGlesTextureComplication وComplicationHighlightRenderer إلى wear-watchface-complications-rendering. (I84670)
  • تمّت إعادة صياغة RenderParameters لتتوافق مع ميزة عرض الإضاءة المميّزة الإضافية. أصبح من الممكن الآن طلب عرض الإشعارات المهمة للأنماط بالإضافة إلى جميع التعقيدات أو تعقيد واحد. بالإضافة إلى ذلك، يتضمّن CanvasRenderer وGlesRenderer طريقة جديدة مجردة لعرض الطبقة المميّزة لعرض أي تمييز يطلبه المحرِّر. تمت إعادة تسمية الطبقة إلى WatchFaceLayer. (Ic2444)
  • تمت إضافة ComplicationTapFilter وComplication.createEdgeComplicationBuilder لإتاحة الإضافات على الحواف. تُترك عملية عرض الإضافات على الحواف واختبار مدى توفّرها لخلفية شاشة الساعة. لا يمكن اختبار النتائج من داخل المحرّرات. (Ia6604)
  • بالنسبة إلى DoubleRangeUserStyleSetting وLongRangeUserStyleSetting: أصبحت defaultValue وmaximumValue وminimumValue الآن سمات kotlin. بالإضافة إلى ذلك، تمّت إزالة دوال UserStyleSetting.Option مثل toBooleanOption وtoCoplicationOptions وtoListOption وما شابهها. (I52899)
  • أضِف حجم الذقن إلى خصائص الجهاز المتاحة لخلفية شاشة الساعة. (I76e1e)
  • تقبل الدالة الإنشائية لـ ComplicationHighlightRenderer الآن المعلمتين outlineExpansion وoutlineStrokeWidth. (I87009)
  • أصبحت ComplicationDrawable.getNoDataText الآن جزءًا من واجهة برمجة التطبيقات العامة. (I00598)

الإصدار 1.0.0-alpha11

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

تم إصدار androidx.wear:wear-*:1.0.0-alpha11. يحتوي الإصدار 1.0.0-alpha11 على هذه المراجعات.

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

  • تم تحسين واجهات برمجة التطبيقات الخاصة بخلفيات شاشة الساعة. معظم التغييرات عبارة عن إعادة تسمية بسيطة، ولكن تم دمج InteractiveWatchFaceWcsClient وInteractiveWatchFaceSysUiClient في InteractiveWatchFaceClient.

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

  • أصبح ContentDescriptionLabel.text الآن ComplicationText بدلاً من TimeDependentText في مكتبة دعم الأجهزة القابلة للارتداء القديمة. (I80c03)
  • لا يمكن ضمان توفّر التطبيق SystemProviders.GOOGLE_PAY على جميع أجهزة Android R، لذا تمت إزالته من القائمة. لا يزال بإمكانك استخدام هذا الموفِّر من خلال DefaultComplicationProviderPolicy (If01b5).
  • لقد أعدنا تسمية ComplicationUpdateCallback إلى ComplicationUpdateListener من أجل الاتساق. (I61ec7)
  • تم تغيير خريطة تنسيق السلك لـ UserStyle إلى Map<String, byte[]>، ولتسهيل الأمر، تمت إضافة فئة UserStyleData إلى واجهة برمجة التطبيقات العامة، ويتم استخدامها الآن من قِبل wear-watchface-client وwear-watchface-editor. بالإضافة إلى ذلك، أصبحت قيمة CustomValueUserStyleSetting.CustomValueOption.value هي byte[] بدلاً من String. (Iaa103)
  • يستخدم UserStyleSetting وUserStyleSetting.Option الآن UserStyleSetting.Id وUserStyleSetting.Option.Id على التوالي لتخزين معرّفاتهما بدلاً من سلسلة. (I63f72)
  • تمت إعادة تسمية InteractiveWatchFaceClient.SystemState إلى WatchUiState. (I6a4e0)
  • تم دمج InteractiveWatchFaceWcsClient وInteractiveWatchFaceSysUiClient لأنّه كان من الصعب توضيح تقسيم المسؤوليات (Iff3fa)
  • تمت إعادة تسمية قيم التعداد للطبقة من أجل الوضوح. أصبح Layer#TOP_LAYER الآن Layer#COMPLICATIONS_OVERLAY وLayer#BASE_LAYER الآن Layer#BASE (Ia144e).
  • تمت إعادة تسمية UserStyleListener إلى UserStyleChangeListener (I18524).
  • تمت إعادة تسمية "UserStyleRepository" إلى "CurrentUserStyleRepository" (I6ea53).
  • تمت إعادة تسمية InteractiveWatchFaceWcsClient.updateInstance إلى updateWatchfaceInstance. (I321dc)
  • تمت إعادة تسمية أحداث WatchFace TapType لتتطابق مع MotionEvents / Compose. (I0dfd0)
  • تمت إعادة تسمية takeWatchfaceScreenshot ليصبح renderWatchFaceToBitmap، وتمت إعادة تسمية takeComplicationScreenshot ليصبح renderComplicationToBitmap (Ie0697).
  • تمت إزالة واجهة CanvasComplication لصالح الفئة المفتوحة CanvasComplicationDrawable. (I1f81f)
  • تمت إزالة WatcfaceControlServiceFactory من واجهة برمجة التطبيقات المتاحة للجميع. (I1f8d3)
  • تمت إعادة تسمية CanvasComplication.setData إلى CanvasComplication.loadData. (If1239)
  • تمت إعادة تسمية ComplicationsManager.bringAttentionToComplication إلى displayPressedAnimation. (Ic4297)
  • يحتوي "WatchFaceService.createWatchFace" الآن على تعليق توضيحي @UiThread. (Ib54c2)
  • تم تغيير اسم مَعلمة CanvasComplicationDrawable لحلّ خطأ. (I50dac)
  • أضفنا HeadlessWatchFaceClient.toBundle() وHeadlessWatchFaceClient.createFromBundle لإتاحة إرسال HeadlessWatchFaceClient عبر AIDL. (I07c35)
  • يتوفر لدى HeadlessWatchFaceClient و InteractiveWatchFaceClient الآن ClientConnectedListener وisConnectionAlive() للسماح لك بملاحظة ما إذا كان الاتصال معطّلاً لسبب ما (على سبيل المثال، تعرض واجهة الساعة للإغلاق). (Ie446d)
  • أصبحت WatchFaceControlClient#getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClientAsync الآن دالة تعليق وتمّت إعادة تسميتها إلى getOrCreateInteractiveWatchFaceClient. (Ib745d)
  • تمّت إعادة تسمية EditorState.commitChanges وhasCommitChanges() ليصبحا shouldCommitChanges(). (I06e04)
  • تمت إعادة تسمية previewComplicationData إلى previewComplicationsData للإشارة إلى أنّ هناك (عادةً) أكثر من ميزة واحدة في الخريطة. (I56c06)
  • تمت إعادة تسمية InteractiveWatchFaceWcsClient.bringAttentionToComplication إلى displayPressedAnimation للحفاظ على اتساقها مع ComplicationsManager.displayPressedAnimation. (Ic9999)
  • تم تضمين جميع نُسخ رقم تعريف مثيل خلفية شاشة الساعة في فئة WatchFaceId جديدة (I45fdf).
  • تمت إعادة تسمية السمة complicationState إلى complicationsState للإشارة إلى الجمع. (Ided07)
  • لقد أزلنا عمليات تحويل Binder المختلفة الخاصة بتطبيق Wear وWatchface وClient، ومن المفترض أن تكون ضرورية. (Icc4c0)
  • لتحقيق الاتّساق، تمت إعادة صياغة EditorServiceClient لاستخدام المستمعين بدلاً من المراقبين. (Iec3a4)
  • أضفنا بضعة تعليقات توضيحية @Px غير متوفّرة إلى InteractiveWatchFaceSysUiClient وWatchFaceControlClient. (I3277a)
  • تمت إعادة تسمية EditorObserverCallback إلى EditorObserverListener لتحقيق الاتساق. (Ie572d)
  • يقتصر العنصر EditorState.watchFaceInstanceId على مستوى واجهة برمجة التطبيقات Android R والإصدارات الأحدث، ولم يعُد قابلاً للقيمة الخالية. (Id52bb)
  • تمت إعادة تسمية EditorSession.launchComplicationProviderChooser إلى openComplicationProviderChooser. (I9d441)
  • تمت إعادة تسمية الدالة EditorSession.createOnWatchEditingSessionAsync إلى createOnWatchEditingSession، وهي الآن دالة تعليق. (Id257b)
  • تمت إضافة عدة تعليقات توضيحية @UiThread غير متوفّرة في EditorSession. (I6935c)
  • تمت إعادة تسمية "UserStyleSetting.affectsLayers" إلى "affectedLayers". (I6e22b)

الإصدار 1.0.0-alpha10

24 آذار (مارس) 2021

تم إصدار androidx.wear:wear-*:1.0.0-alpha10. يحتوي الإصدار 1.0.0-alpha10 على هذه المراجعات.

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

  • أصبح من الممكن الآن إنشاء كائنات gl مفتوحة (مثل الزخارف) أثناء WatchFaceService.createWatchFace، نظرًا لأن GlesRenderer يتطلب الآن استدعاءًا صريحًا لـ initOpenGLContext الذي يمكن تنفيذه داخل createWatchFace.

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

  • كان IdAndComplicationData غير ملائم بعض الشيء، لذا تمت إزالته من واجهة برمجة التطبيقات المتاحة للجميع. وتمّت إعادة صياغة الفئات والواجهات التي كانت تستخدمه. (I4c928)
  • لقد استبدلنا ReferenceTime بـ CountUpTimeReference وCountDownTimeReference، وهما أكثر وضوحًا. (Ib66c6)
  • تمت إضافة بعض تعليقات @Px و@ColorInt التوضيحية غير المتوفّرة. (I9bbc3)
  • أصبح الحقل Complication.complicationConfigExtras غير قابل للحذف، ويكون الإعداد التلقائي له هو Bundle.EMPTY. (Iad04f)
  • يطلب منك GlesRenderer الآن الاتصال بـ initOpenGLContext بعد الانتهاء من الإنشاء. كانت هذه الدالة تفاصيل داخلية، ولكنها أصبحت الآن متاحة في واجهة برمجة التطبيقات المتاحة للجميع للسماح بطلبات GL في وقت سابق داخل createWatchFace. (I726c2)
  • أزلنا Complication.setRenderer لأنّه ليس مطلوبًا. (Ie992f)
  • لم يعُد تطبيق Complicaiton.setComplicationBounds جزءًا من واجهة برمجة التطبيقات المتاحة للجميع. إذا كنت بحاجة إلى تعديل موضع إحدى التطبيقات المصغّرة، يمكنك إجراء ذلك من خلال ComplicationsUserStyleSetting. (Ibd9e5)
  • تمت إعادة تسمية "ComplicationsManager.TapCallback.onComplicationSingleTapped" إلى "onComplicationTapped". (I3a55c)
  • تمت إعادة تسمية ComplicationOutlineRenderer.drawComplicationSelectOutline إلى drawComplicationOutline. (I14b88)

الإصدار 1.0.0-alpha09

10 آذار (مارس) 2021

تم إصدار androidx.wear:wear-complications-*:1.0.0-alpha09 وandroidx.wear:wear-watchface-*:1.0.0-alpha09. يحتوي الإصدار 1.0.0-alpha09 على هذه المراجعات.

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

  • تم تطوير الواجهة بين مضيف WCS/SysUI وشاشة الساعة. أصبح بإمكان المحرِّر الآن تحديد ما إذا كان تغيير النمط سيؤدي إلى تفعيل ميزة أو إيقافها (enabled = initiallyEnabled بالإضافة إلى أي إلغاء من ComplicationsUserStyleSetting). وتسمح أيضًا EditorService.closeEditorلأداة SysUI بإغلاق محرّر خلفية شاشة الساعة عن بُعد إذا لزم الأمر.
  • بالإضافة إلى ذلك، يمكنك استخدام InteractiveWatchFaceWcsClient.setUserStyle باستخدام الأمر updateInstance الأكثر فعالية الذي يغيّر معرّف المثيل وتحديد النمط ومحو جميع الإضافات في آنٍ واحد.

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

  • تمت إضافة TraceEvents إلى مكتبات خلفيات شاشة الساعة. (I1a141)
  • يحتوي ComplicationState الآن على خاصيّة جديدة initiallyEnabled وهي مفيدة لتوقّع نتائج تبديل الأنماط. (I8c905)
  • لقد استبدلنا الأمر InteractiveWatchFaceWcsClient.setUserStyle بأمر أكثر فعالية updateInstance الذي: يغيّر رقم تعريف المثيل ويضبط النمط ويزيل التعقيدات. (Ife6f6)
  • لم تعُد واجهات برمجة التطبيقات لأخذ لقطات الشاشة في WatchFaceClient تُحسِّن لقطات الشاشة لأنّ ذلك كان بطيئًا، وبدلاً من ذلك، نترك أي معالجة لاحقة للمتصل. (Id35af)
  • أصبح من الممكن الآن إغلاق محرّر خلفية شاشة الساعة عن بُعد من خلال تطبيق "EditorService.closeEditor". (Ic5aa4)
  • تمت إضافة تعليقات توضيحية حول إمكانية القيمة الخالية (Ic16ed)

الإصدار 1.0.0-alpha08

24 شباط (فبراير) 2021

تم طرح androidx.wear:wear-*:1.0.0-alpha08. يحتوي الإصدار 1.0.0-alpha08 على هذه المراجعات.

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

  • تم تصميم بعض خلفيات شاشة الساعة استنادًا إلى إضافة واحدة أو أكثر، ولتسهيل ذلك، أضفنا Complication.Builder#setFixedComplicationProvider الذي يمنع المستخدم من تغيير الإضافة في هذا المربّع إذا تم ضبطه على "صحيح".
  • تكون مكتبات خلفية خلفيات شاشة الساعة مكتوبة بلغة Kotlin أولاً وتستخدم وحدات معالجة المهام المتزامنة (مثل الدوال التي تتوقّف مؤقتًا). وفّرنا لمستخدمي Java برامج دمج ListenableFuture لتحسين إمكانية التشغيل التفاعلي في المكتبات التالية: wear/wear-watchface-guava وwear/wear-watchface-client-guava &wear/wear-watchface-editor-guava.

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

  • لقد أزلنا ميزة النقرات المزدوجة على الإضافات التي تطلق أداة اختيار الموفّر، ولم تكن هذه الميزة شائعة في خلفيات شاشة الساعة، ما أدّى إلى تعقيد عملية تنفيذ SysUI. (I3ef24)
  • قد تؤدي طرق ProviderInfoRetriever إلى ظهور Service مساعدتك على وجه الاستثناء في حال إغلاق المثبت بشكل غير متوقع. (Ib2cc4)
  • بدءًا من نظام التشغيل Android 11 والإصدارات الأحدث، هناك قيود على وقت تشغيل أداة ProviderSelectr، إضافةً إلى ذلك، نودّ إنشاء أدوات تحرير باستخدام wear-watchface-editor الجديد، لذلك ستتم إزالة ComplicationHelperActivity من واجهة برمجة التطبيقات العامة. (Ib19c1)
  • أزِل الطرق الثابتة ComplicationText واستخدِم أدوات الإنشاء بدلاً منها. (Ibe399)
  • لقد طرحنا لفائف guava ListenableFuture للطرق المعلّقة المختلفة في مكتبة خلفيات شاشات الساعة. (I16b2c)
  • لتوضيح واجهة برمجة التطبيقات، أضفنا عنصر إنشاء ثانويًا إلى RenderParameters لا يتطلّب درجة لون، وذلك لاستخدامه مع LayerModes بخلاف LayerMode.DRAW_OUTLINED. (I497ea)
  • في السابق، كان ListUserStyleSetting مختلفًا عن الآخر لأنّه كان يحتوي على مَعلمة تلقائية. الآن تأخذ جميع دوال إنشاء الفئة الفرعية Stylesetting القيمة الافتراضية أخيرًا. (I9dbfd)
  • تمت إعادة صياغة CanvasComplication لاستخدام طريقة مخفية، ما يسهّل تنفيذ فئة فرعية (I5b321).
  • لقد أعدنا تصميم أداة EditorResult للاستفادة من خدمة EditorService جديدة وEditorSession.broadcastState() لبث التحديثات إلى المراقب (عادةً ما يكون نظام التشغيل SysUI). (Ic4370)
  • تم تصميم بعض خلفيات شاشة الساعة استنادًا إلى إضافة معيّنة كجزء لا يتجزأ من خلفية شاشة الساعة، ولا يمكن للمستخدم ضبط مقدّم الخدمة. لدعم ذلك، أضفنا Complication.Builder#setFixedComplicationProvider. (I4509e)
  • يحدد EditorRequest الآن اسم الحزمة بدلاً من ComponentName لأنه لم يكن من الملائم لـ SysUI البحث عن اسم فئة المحرر، ونحتاج حقًا إلى اسم الحزمة فقط. (Ib6814)

الإصدار 1.0.0-alpha07

10 شباط (فبراير) 2021

تم إصدار androidx.wear:wear-*:1.0.0-alpha07. يحتوي الإصدار 1.0.0-alpha07 على هذه المراجعات.

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

  • أصبحت WatchFaceService.createWatchFace الآن دالة تعليق، ما يعني أنّه لم يعُد على خلفية شاشة الساعة حظر سلسلة مهام واجهة المستخدم أثناء انتظار عمليات الإدخال والإخراج. وبالمثل، wear-watchface-editor وwear-complications-data

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

  • إزالة فئة PhotoImage واستخدام رمز Icon مباشرةً (I8a70b)
  • اعرض النطاق الزمني الصالح لـ ComplicationData. (I91366)
  • اجعل السمات التي تشبه الصور أكثر وضوحًا. (I81700)
  • تمّت إعادة صياغة wear-watchface-editor وwear-complications-data لاستخدام دوالّ التعليق بدلاً من الدوالّ المتعدّدة المهام. ستتوفّر لاحقًا حِزم Rx java وFuture compat wrappers. (If3c5f)
  • يُعرِض ProviderInfoRetriever الآن PreviewNotAvailableException إذا تعذّر على requestPreviewComplicationData عرض بيانات المعاينة بسبب مشاكل في الاتصال أو عدم توفّر واجهة برمجة التطبيقات. (I4964d)
  • أصبحت WatchFaceControlService::createWatchFaceControlClient الآن وظيفة معلّقة، وتم استبدال getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient باسم getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClientAsync الذي يعرض القيمة Deferred<InteractiveWatchFaceWcsClient>. ستتوفّر لاحقًا حِزم RX java وFuture compat. (I5d461)
  • إعادة تسمية "CATEGORY_PROVIDER_CONFIG_ACTION" إلى "CATEGORY_PROVIDER_CONFIG" (I7c068)
  • يُرجى العِلم أنّ createOnWatchEditingSession أصبحت الآن وظيفة معلّقة لأنّ خلفية شاشة الساعة لا تكون متاحة أحيانًا إلا بعد وقت قصير من بدء نشاط المحرِّر. (Ida9aa)
  • أصبحت WatchFaceService.createWatchFace الآن دالة تعليق تتيح الإعداد غير المتزامن، وكان عليك في السابق حظر سلسلة التعليمات الرئيسية. (If076a)
  • أصبح لـ UserStyle الآن عامل تشغيل صفيف، وأضفنا مساعدات البث إلى UserStyle.Option. (I35036)
  • لقد أصلحنا خطأ في تنسيقات بيانات UserStyle التي تؤدي إلى تغيير بعض واجهات برمجة التطبيقات المخفية غير المستقرة. (I8be09)
  • أضفنا CustomValueUserStyleSetting الذي يتيح لك تخزين سلسلة واحدة خاصة بالتطبيق ضمن UserStyle. سيتجاهل محرّرو خلفيات شاشة الساعة التلقائية هذه القيمة. (Ic04d2)
  • لا يتم تمرير InstanceID في إضافات النية لنظام التشغيل R والإصدارات الأقدم من Android WearOS التي لا يمكننا ترقيتها. لإتاحة ذلك، نسمح الآن بأن يكون InstancID فارغًا. (Id8b78)
  • يتضمّن EditorRequest الآن اسم مكوّن المحرِّر الذي تم ضبطه كمكوّن في WatchFaceEditorContract.createIntent (I3cd06).
  • يتضمّن العنصر EditorResult في خلفية شاشة الساعة الآن معاينة ComplicationData للسماح للمتصل بالتقاط لقطة شاشة لخلفية شاشة الساعة بعد التعديل. (I2c561)

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

  • تمت إضافة عمليات إلغاء toString() إلى UserStyle وUserStyleSetting وUserStyleSchema، ما يسهّل التعامل مع هذه الفئات. (I9f5ec)

الإصدار 1.0.0-alpha06

27 كانون الثاني (يناير) 2021

تم إصدار androidx.wear:wear-*:1.0.0-alpha06. يحتوي الإصدار 1.0.0-alpha06 على هذه المراجعات.

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

  • لقد طرحنا مكتبة جديدة باسم wear/wear-watchface-editor تتيح لمطوّري خلفيات شاشات الساعة والمصنّعين الأصليين للأجهزة إنشاء محرِّر للأنماط والإضافات. سيرسل SysUI طلبًا إلى خلفية شاشة الساعة التي ستستخدم فئة EditorSession الجديدة للوصول إلى تفاصيل خلفية شاشة الساعة وتسجيل النتيجة من خلال Activity.setWatchRequestResult. لإتاحة هذه العملية، أضفنا ProviderInfoRetriever.requestPreviewComplicationData. بهذه الطريقة، يمكن لمحرّري خلفية شاشة الساعة طلب معاينة ComplicationData. تتمثل ميزة معاينة ComplicationData في أنّه على عكس البيانات النشطة، لا داعي للقلق بشأن عرض مربّعات حوار الأذونات عند عرض المحرِّر (يُرجى العِلم أنّه إذا اختار المستخدم مقدّم خدمة لديه إذن، سيظلّ مطلوبًا منه منح الإذن).

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

  • يحتوي ComplicationProviderInfo الآن على حقل لـ ComponentName الخاص بالموفّر، وسيتم إضافة دعم لهذا الحقل إلى WearOS في وقت لاحق، وفي الوقت الحالي، سيكون حقلًا فارغًا. (Id8fc4)
  • أضفنا ProviderInfoRetriever.requestPreviewComplicationData الذي يسمح لمحرِّري خلفيات الشاشة على الساعة بطلب معاينة ComplicationData. ويُعدّ ذلك مفيدًا لأنّ التطبيقات المخصّصة للأجهزة الجوّالة التي تعرض معلومات مباشرة قد تتطلّب أذونات، ويمكنك الآن عرض بيانات المعاينة للتطبيقات المخصّصة للأجهزة الجوّالة التي لا تعرض معلومات مباشرة. (I2e1df)
  • أصبحت ComplicationManager الآن مَعلمة اختيارية لدالة إنشاء WatchFace، وتم إعادة ترتيب الوسيطات للسماح بذلك. (I66c76)
  • لقد أضفنا حِزمة اختيارية إلى "الإضافات"، والتي في حال دمجها بهدف إرسال نشاط أداة اختيار الموفّر. (Ifd4ad)
  • لقد أضفنا مكتبة جديدة من "wear-watchface-editor" لتوفيرها على خلفية شاشة الساعة وأدوات التحرير التي تستضيفها SysUi. سيشغِّل SysUI هذه المحرِّرين من خلال إرسال هدف. يمكن لخدمة نشاط خلفية شاشة الساعة استخدام فئة EditorSession الجديدة للوصول إلى تفاصيل WatchFace وتسجيل النتيجة من خلال Activity.setWatchRequestResult. (I2110d)
  • تم تغيير اسم LayerMode.DRAW_HIGHLIGHTED إلى LayerMode.DRAW_OUTLINED وتم تغيير اسم RenderParameters.highlightComplicationId إلى RenderParameters.selectedComplicationId الذي يرسم تمييزًا على التعقيد المحدّد بالإضافة إلى مخطط. (I90a40)
  • يمكن الآن حلّ مستقبل WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient باستخدام ServiceStartFailureException إذا توقّفت الخدمة أثناء انتظار إنشاء خلفية شاشة الساعة. (I0f509)
  • أصبح EditorSession.complicationPreviewData الآن عنصر ListenableFuture لأنّ جلب هذه البيانات عملية غير متزامنة. (Iead9d)

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

  • نعمل على إزالة الحقول غير المستخدمة من ComplicationOverlay وتركها مفعَّلة و ComplicactionBounds. (I17b71)

الإصدار 1.0.0-alpha05

13 كانون الثاني (يناير) 2021

تم طرح androidx.wear:wear-*:1.0.0-alpha05. يحتوي الإصدار 1.0.0-alpha05 على هذه عمليات التنفيذ.

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

غالبًا ما تتوافق خلفيات شاشة الساعة مع عدد من إعدادات الإضافات مع عرض أعداد مختلفة من الإضافات. لتسهيل عملية الإعداد، أصبح بإمكانك الآن استخدام ميزة "التطبيقات المصغّرة" المتوقفة عن العمل في البداية من خلال استدعاء setEnabled(false) في أداة الإنشاء. ويمكن تفعيلها لاحقًا من خلال ComplicationsUserStyleSetting.

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

  • يقبل ComplicationHelperActivity الآن Collection<ComplicationType> بدلاً من صفيف int، ما يسهّل استخدامه. (I1f13d)
  • تعرض ميزة "ProviderInfoRetriever.retrieveProviderInfo" الآن ListenableFuture<ProviderInfo[]> بشكل صحيح. (If2710)
  • يمكنك الآن إنشاء شاشة معلومات مصغّرة غير مفعّلة في البداية من خلال استدعاء setEnabled(false) في أداة الإنشاء. (Idaa53)
  • تحتوي WatchFaceState الآن على سمة isHeadless التي تكون صحيحة فقط للمثيلات التي لا تتضمّن واجهة مستخدم. (Ifa900)
  • يتيح تطبيق ComplicationDrawable الآن اختياريًا التحميل المتزامن للمواد القابلة للرسم. ويتم استخدام ذلك من خلال واجهات برمجة التطبيقات للقطات الشاشة. (I34d4a)

الإصدار 1.0.0-alpha04

16 كانون الأول (ديسمبر) 2020

تم إصدار androidx.wear:wear-*:1.0.0-alpha04. يحتوي الإصدار 1.0.0-alpha04 على هذه المراجعات.

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

  • تتيح الآن مكتبة خلفيات شاشة الساعة على WearOS ضبط الحدود لكل نوع. على سبيل المثال، يمكنك التبديل إلى مربّع حدود واسع لـ ComplicationType.LONG_TEXT مع استخدام مربّع حدود أصغر للأنواع الأخرى.

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

  • تستخدم الإضافات الآن ComplicationBounds التي تلتف حول Map<ComplicationType, RectF> لتتوافق مع أحجام أنواع الإضافات المختلفة. (I1ebe7)
  • تتيح لك RenderParameters الآن تحديد درجة لون التمييز لاستخدامها في لقطات الشاشة. (Iff42b)
  • باستثناء الحدود، عليك الآن استخدام ComplicationsUserStyleSetting لتعديل المضاعفات، وذلك لضمان مزامنة نظام التشغيل. (I8dc5d)
  • أصبح Renderer الآن فئة مختومة. وهذا يعني أنّ CanvasRenderer وGlesRenderer هما الآن فئتَان داخليتان من Renderer. (Iab5d4، b/173803230)
  • تمت إعادة تسمية CanvasComplicationDrawable.drawHighlight ليصبح drawOutline. هناك الآن بعض تعليقات UiThread غير التوضيحية التي لا تتوفّر في أداة ObserableWatchData. تمت الآن إزالة ScreenState بالكامل من WatchState. (If1393)
  • أصبح الحد الأدنى لمستوى واجهة برمجة التطبيقات لتطبيق خلفية شاشة الساعة هو 25. يتطلّب دعم لوحة ملاحظة على الجهاز المستوى 26 من واجهة برمجة التطبيقات أو المستويات الأحدث. (Ic9bbd)
  • يتضمّن InteractiveWatchFaceWcsClient الآن مساعد getComplicationIdAt. (I05811)
  • تم خفض مستوى واجهة برمجة التطبيقات لـ "Wear-watchface-client" إلى 25، غير أنّ واجهات برمجة التطبيقات الخاصة بلقطات الشاشة تتطلب المستوى 27 من واجهة برمجة التطبيقات. (Id31c2)

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

  • نعرض الآن ComplicationType الخاص بـ ComplicationData الحالي للإضافة في ComplicationState. (I9b390)
  • يتضمّن InteractiveWatchFaceWcs الآن طريقة bringAttentionToComplication لتمييز المقياس المُحدَّد بشكلٍ موجز. (I6d31c)
  • تتضمن الدالة InteractiveWatchFaceWcsClient#setUserStyle الآن حِملًا زائدًا يتم قبوله من خلال Map<string, string=""> التي قد تتجنّب إرسال البيانات ذهابًا وإيابًا IPC الإضافية اللازمة لإنشاء UserStyle. (I24eec)</string,>

الإصدار 1.0.0-alpha03

2 كانون الأول (ديسمبر) 2020

تم طرح androidx.wear:wear-*:1.0.0-alpha03. يحتوي الإصدار 1.0.0-alpha03 على هذه المراجعات.

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

تحتوي فئة Complication الآن على سمة compicationData تتيح لوجوه الساعة مراقبة تغييرات ComplicationData. يتيح ذلك تغيير أبعاد الإضافة بناءً على نوع الإضافة.

يمكن الآن استخدام عدد متغيّر من اللقطات في الثانية من خلال ضبط Renderer.interactiveDrawModeUpdateDelayMillis. بالنسبة إلى خلفيات شاشة الساعة التي تحتوي على رسوم متحركة قصيرة كل ثانية، يمكن أن يؤدي هذا إلى توفير الطاقة بشكل جيد من خلال الانتقال إلى وضع السكون عند عدم استخدام الصور المتحركة.

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

  • تمت إعادة تسمية "BACKGROUND_IMAGE" إلى "PHOTO_IMAGE" مع الصفوف ذات الصلة. لا يتم استخدام هذا النوع من التعقيدات حصريًا للخلفيات، لذا تم تغيير الاسم. (I995c6)
  • تم التعليق التوضيحي على DefaultComplicationProviderPolicy بشكل صحيح باستخدام IntDefs. (I3b431)
  • لم تعُد فئة TimeDependentText المخفية تظهر من خلال ContentDescriptionLabel، بدلاً من ذلك نضيف أداة وصول للحصول على النص في وقت محدّد. (Ica692)
  • أصبح المُنشئ ObservableWatchData داخليًا الآن. (I30121، b/173802666)
  • تحتوي إضافة "Complication" الآن على compicationData التي تتيح لخلفيات شاشة الساعة مراقبة تغييرات ComplicationData. تتضمّن الإضافة أيضًا استدعاء isActiveAt جديد يمكن استخدامه لمعرفة ما إذا كان يجب عرض أي شيء في التاريخ والوقت المحدد. (Ic0e2a)
  • لم تعُد قيمة SharedMemoryImage الفارغة متوفّرة في واجهة برمجة التطبيقات العامة. (I7ee17)
  • تشتمل WatchFace.overridePreviewReferenceTimeMillis الآن على تعليق توضيحي IntRange ، ويكون لكل من get وsetter أسماء متسقة. (Ia5f78)
  • تم إنشاء Complication.Builder الآن من خلال Complication.createRoundRectComplicationBuilder أو Complication.createBackgroundComplicationBuilder للتوضيح (I54063)
  • تمت إضافة WatchFace.TapListener الذي يسمح لخلفية شاشة الساعة برصد النقرات التي لا تستهلكها الإضافات. (Ic2fe1، b/172721168)
  • تتيح ميزة WatchFace الآن عددًا متغيرًا من اللقطات في الثانية من خلال ضبطها على Renderer.interactiveDrawModeUpdateDelayMillis. يمكن أن يساعد ذلك في الحفاظ على عمر البطارية عن طريق الانتقال إلى وضع السكون في حال عدم الحركة. (I707c9)
  • لم تعُد WatchFace.Builder مطلوبة، وتم نقل invalidate() وinteractiveUpdateRateMillis إلى Renderer. (I329ea)
  • لتحسين إمكانية التشغيل التفاعلي في Java
  • تمت إعادة تسمية TapListener إلى TapCallback وInvalidateCallback إلى InvalidateListener من أجل الاتساق. (I9414e)
  • تم نقل خيارات أسلوب خلفية شاشة الساعة في Wear 2.0 إلى فئة خاصة بها من أجل الوضوح. تتوفّر الآن أدوات التصنيف المتماثلة في فئة WatchFace. (Iefdfc)
  • تمت إضافة InteractiveWatchFaceWcsClient وWatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient اللذان يحصلان على مثيل حالي أو ينشئانه بعد أن تتصل خدمة خلفية الشاشة وتُنشئ المحرّك. (Id666e)
  • أصبحت WatchFaceControlClient الآن واجهة للسماح للاختبارات بمحاكاةها. (I875d9)
  • أصبحت واجهات HeadlessWatchFaceClient وInteractiveWatchFaceSysUiClientImpl وInteractiveWatchFaceWcsClient الآن لتسهيل الاختبار بشكلٍ أفضل. (I7cdc3)
  • تمت إضافة تعليقات توضيحية إلى الطرق في wear-watchface-complications-rendering (I0d65c)

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

  • إزالة شكل الشاشة من DeviceConfig، الذي كان يكرّر android.content.res.Configuration#isScreenRound() (Ifadf4)
  • تم تغيير WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient لقبول Map<String, String> بدلاً من UserStyle لأنّه من الصعب إنشاء UserStyle بدون معرفة المخطّط الذي لا يمكنك الحصول عليه إلا بعد إنشاء العميل. (Iea02a)
  • يجب إصلاح InteractiveWatchFaceWcsClient لاستخدام ComplicationState بدلاً من تنسيق الأسلاك. (Icb8a4)
  • أصبحت UserStyleSettings الآن فئة مغلقة لأنّ محرِّري خلفيات شاشة الساعة لا يفهمون سوى الفئات المضمّنة. (I2d797)

الإصدار 1.0.0-alpha02

11 تشرين الثاني (نوفمبر) 2020

تم إصدار androidx.wear:wear-*:1.0.0-alpha02. يحتوي الإصدار 1.0.0-alpha02 على هذه المراجعات.

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

  • أصبح اسم ComplicationDetails الآن باسم ComplicationState وتم التفافه بشكل صحيح، وتم نقل استخدامات الدعم القابل للارتداء @ComplicationData.ComplicationType إلى androidx ComplicationType. (I4dd36)
  • أضِف مَعلمة highlightedComplicationId اختيارية إلى RenderParameters تتيح لك طلب تمييز شاشة معلومات واحدة في لقطات الشاشة. (I66ce9)
  • ComplicationProviderService استخدام واجهة برمجة تطبيقات إضافة النمط الجديد من أجل تحقيق الاتساق (Id5aea)
  • تحصل "getPreviewReferenceTimeMillis" الآن على أوقات مرجعية من "DeviceConfig". (I779fe)
  • تبسيط سطح Renderer API، يمكن استخدام SurfaceHolder.Callback لمراقبة التغييرات بدلاً من ذلك. (I210db)
  • لا تمتد CanvasComplicationRenderer من Renderer، لذا تمت إعادة تسميتها للوضوح. (Ibe880)

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

  • الإصدار الأول من androidx.wear:wear-watchface-client (I1e35e)
  • تم تغيير اسم GlesTextureComplication#renderer لزيادة الوضوح (Ib78f7)
  • إعادة تسمية "StyleCategory" إلى "StyleSetting" لمزيد من التوضيح (I488c7)
  • إضافة UserStyleSchema لواجهة برمجة تطبيقات أكثر وضوحًا (If36f8)

الإصدار 1.0.0-alpha01

28 تشرين الأول (أكتوبر) 2020

تم طرح androidx.wear:wear-complications-*:1.0.0-alpha01 وandroidx.wear:wear-watchface-*:1.0.0-alpha01. يحتوي الإصدار 1.0.0-alpha01 على هذه المراجعات.

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

  • تمّت إزالة بعض العناصر التي لم نكن ننوي عرضها في واجهة برمجة التطبيقات العامة. (I41669)
  • أنشئ مكتبة androidx.wear:wear-complications-provider. (I77f1f)
  • ‫ComplicationsUserStyleCategory الفئة الجديدة المقترَحة لضبط الإضافات (I96909)
  • أضِف واجهة برمجة التطبيقات wear-complication-data API. (I7c268)
  • يجب إضافة البادئة is بدلاً من get إلى الدوال التي تعرض قيمًا منطقية (If36ff).
  • نصيحة واجهة برمجة التطبيقات هي تجنب استخدام الحماية، ولذلك تمت إعادة ضبط هذه الفئة لتضمين المعلمات عبر الدالة الإنشائية. (I61644)
  • أعِد تسمية setBackgroundComplication لزيادة الوضوح. (I96fe3)
  • استخدام خصائص Kotlin لعرض بيانات ishighlighted وDataable (I4dcc8)
  • بدلاً من ComplicationRenderer.InappropriateateCallback
  • يتم إيقاف واجهات برمجة التطبيقات هذه نهائيًا في WearableSupport، وتمّت إزالتها هنا. (Ib425c)
  • تمت إعادة تسمية بعض طرق إنشاء خلفية شاشة الساعة للتأكيد على طبيعتها القديمة في Wear OS 2.0. (Idb775)
  • أول إصدار تجريبي من واجهة برمجة التطبيقات المعنيّة بواجهة wear/wear-watchface (Id3981)
  • أول إصدار تم تتبُّعه من واجهة برمجة التطبيقات. (Ie9fe6)
  • إخفاء ComplicationDrawable.BorderStyle IntDef بشكل صحيح والانتقال إلى ComplicationStyle لتحقيق الاتساق (I27f7a)
  • إضافة تعليقات توضيحية غير متوفّرة لطرق ComplicationStyle (I838fd)
  • لا تتضمّن هذه المكتبة واجهة برمجة تطبيقات عامة (I88e2b).
  • أصبحت جميع فئات خيارات فئة الأنماط نهائية بشكل صحيح الآن. (Ib8323)
  • أول إصدار تم تتبُّعه من واجهة برمجة التطبيقات. (I27c85)

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

  • تم تغيير ComplicationProviderService لتوفير طريقة getComplicationPreviewData صريحة. (I4905f)
  • تم تفعيل فحص lint لواجهة برمجة التطبيقات لـ MissingGetterMatchingBuilder في androidx (I4bbea، b/138602561)
  • أعِد تسمية عرض تعقيدات الارتداء. (Ifea02)
  • أصبحت أسماء فئات الأنماط الآن سلاسل علامات (I28990).
  • استبدال Override (إلغاء) بـ Overlay (تراكب) لمطابقة اصطلاحات تسمية المظاهر والأنماط الحالية (I4fde9)
  • تمت إعادة تسمية UserStyle#getOptions لزيادة الوضوح. (I695b6)

الإصدار 1.2.0

الإصدار 1.2.0

15 أيلول (سبتمبر) 2021

تم إصدار androidx.wear:wear:1.2.0. يحتوي الإصدار 1.2.0 على هذه عمليات التنفيذ.

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

  • تمت إضافة مكوّن CurvedText لكتابة نص منحني بسهولة باتّباع منحنى أكبر دائرة يمكن إدراجها في العرض. مثال على الاستخدام:

    <androidx.wear.widget.CurvedText
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="example curved text"
            app:anchorAngleDegrees="180"
            app:anchorPosition="center"
            app:clockwise="false"
            style="@android:style/TextAppearance.Large"
    />
    

    مثال على نص منحني في Android Wear

  • تمت إضافة حاوية 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>
    

    مثال على نص منحني في Android Wear

  • تمت إضافة حاوية تنسيق جديدة، وهي DismissibleFrameLayout، التي تتعامل مع إغلاق التطبيق باستخدام زر الرجوع و/أو التمرير سريعًا للأعلى أو للأسفل، وهي مخصّصة للاستخدام داخل نشاط. يجب إضافة مستمع واحد على الأقل لتنفيذ إجراء الإغلاق. عادةً ما يزيل المستمع طريقة عرض تحتوي على أو جزء من النشاط الحالي. يتم توفير setSwipeSellible(boolean) وsetBackButtonRuleible(boolean) للتحكم بشكل مباشر في الميزات. يهدف هذا التنسيق الجديد إلى استبدال SwipeDismissFrameLayout الحالي.

  • تمت إضافة إمكانية الإشارة إلى أنّه يمكن "استئناف النشاط تلقائيًا" عندما يخرج الجهاز من وضع الإضاءة السينمائية في فئة AmbientModeSupport. كانت هذه الوظيفة متاحة سابقًا في فئة WearableActivity المتوقّفة نهائيًا من WearableSupportLibrary. (I336ab)

  • تم نقل فئة Wearable Calendarcalendar من مكتبة الدعم القابل للارتداء. توفّر واجهة برمجة التطبيقات هذه مجموعة فرعية من البيانات المتاحة من خلال CalendarContract، ولكن تتم مزامنتها تلقائيًا مع الأجهزة القابلة للارتداء. (I6f2d7)

  • تمت إضافة واجهة برمجة تطبيقات جديدة WearTypeHelper في androidx.wear.utils لتحديد ما إذا كان جهاز Wear المُعطى مخصّصًا للصين. (Ib01a9)

  • تمت إضافة ميزات تسهيل الاستخدام إلى androidx.wear.widget.ConfirmationOverlay التي ستقرأ الرسائل في حال ضبطها متبوعة بوصف للحركة. (I524dd)

  • تم إصلاح الخطأ الذي كان يتسبب في تعطُّل ConfirmationActivity في حال عدم تقديم رسالة. (Ie6055)

  • تم إصلاح خطأ كان يؤدي إلى اطّلاع WearableDrawerLayout على جميع التفاعلات عند التمرير أفقيًا في RecyclerViews. (I24c7f)

الإصدار 1.2.0-rc01

1 أيلول (سبتمبر) 2021

تم طرح الإصدار androidx.wear:wear:1.2.0-rc01 بدون أي تغييرات منذ الإصدار التجريبي الأخير. يحتوي الإصدار 1.2.0-rc01 على هذه المراجعات.

الإصدار 1.2.0-beta01

18 آب (أغسطس) 2021

تم إصدار androidx.wear:wear:1.2.0-beta01. يحتوي الإصدار 1.2.0-beta01 على هذه المراجعات.

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

  • إصلاح الخطأ الذي تسبب في تعطُّل FollowActivity إذا لم يتم تقديم أي رسالة. (Ie6055)

الإصدار 1.2.0-alpha13

4 آب (أغسطس) 2021

تم إصدار androidx.wear:wear:1.2.0-alpha13. يحتوي الإصدار 1.2.0-alpha13 على هذه عمليات التنفيذ.

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

  • تمت إعادة تسمية "WearTypeHelper.isChinaDevice" إلى "WearTypeHelper.isChinaBuild". (I47302)

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

  • وقد أضفنا ميزات تسهيل الاستخدام إلى تطبيق "androidx.wear.widget.ConfirmationOverlay" لتقرأ الرسائل بصوت عالٍ في حال ضبطها متبوعة بوصف الصورة المتحركة. (I524dd)

الإصدار 1.2.0-alpha12

21 يوليو 2021

تم إصدار androidx.wear:wear:1.2.0-alpha12. يحتوي الإصدار 1.2.0-alpha12 على عمليات التنفيذ هذه.

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

  • أضفنا واجهة برمجة تطبيقات جديدة WearTypeHelper في androidx.wear.utils لتحديد ما إذا كان جهاز Wear المُعطى مخصّصًا للصين. (Ib01a9)

الإصدار 1.2.0-alpha11

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

تم إصدار androidx.wear:wear:1.2.0-alpha11. يحتوي الإصدار 1.2.0-alpha11 على هذه المراجعات.

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

  • تم إصلاح خطأ كان يؤدي إلى اطّلاع WearableDrawerLayout على جميع التفاعلات عند التمرير أفقيًا في RecyclerViews. (I24c7f)

الإصدار 1.2.0-alpha10

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

تم إصدار androidx.wear:wear:1.2.0-alpha10. يحتوي الإصدار 1.2.0-alpha10 على هذه عمليات التنفيذ.

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

  • يُحسِّن الإصدار Alpha10 من إمكانية الوصول إلى النص المنحني وArcLayouts. كما أنها تضيف بعض إعادة التسمية البسيطة في SellibleFrameLayout للمساعدة في توضيح واجهة برمجة التطبيقات.

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

  • تمت إعادة تسمية الطرق التالية في الإصدار DismissibleFrameLayout (Ib195e):
    • Callback#onDismissed -> Callback#onDismissedFinished
    • isSwipeDismissible -> isDismissableBySwipe
    • isBackButtonDismissible -> isDismissableByBackButton
  • لقد جعلنا الطرق التالية نهائية (Ib195e):
    • setBackButtonDismissible
    • setSwipeDismissible
    • registerCallback
    • unregisterCallback

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

  • استخدِم محتوى CurvedTextView في Talkback. (I05798)
  • سهولة أكبر في الوصول إلى طرق العرض العادية في ArcLayout (I4418d)

الإصدار 1.2.0-alpha09

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

تم طرح androidx.wear:wear:1.2.0-alpha09. يحتوي الإصدار 1.2.0-alpha09 على هذه عمليات التنفيذ.

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

  • تمت إضافة دالة جديدة CurvedTextView.setTypeface() (مشابهة لدالة TextView) لضبط خط النص ونمطه المميّز بالخط العريض أو المائل. (I4653c)
  • تمت إعادة تسمية "WearArcLayout" إلى "ArcLayout"، و"WearCurvedText" إلى "CurvedText"، و"WearArcLayout.ArcLayoutWidget" إلى "ArcLayout.Widget". (I6e5ce)
    • في ArcLayout.Widget، تمت إعادة تسمية getThicknessPx إلى getThickness.
    • تم الآن تسمية ثوابت المحاذاة العمودية في ArcLayout.LayoutParams بدءًا من VERTICAL_ALIGN_ (بدلاً من VALIGN_ السابق).
  • في CurvedTextView، تم استبدال الطريقتَين setMinSweepDegrees وsetMaxSweepDegrees بالطريقة setSweepRangeDegrees (I7a9d9).

الإصدار 1.2.0-alpha08

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

تم إصدار androidx.wear:wear:1.2.0-alpha08. يحتوي الإصدار 1.2.0-alpha08 على هذه المراجعات.

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

  • لتحسين وضوح الرمز، أضفنا @FloatRange تعليقات توضيحية إلى بعض مَعلمات الزاوية وأنواع الإرجاع. (I430dd)
  • في الواجهة WearArcLayout.ArcLayoutWidget، يُطلق الآن على الطريقة insideClickArea اسم isPointInsideClickArea. (Ia7307)

الإصدار 1.2.0-alpha07

24 آذار (مارس) 2021

تم إصدار androidx.wear:wear:1.2.0-alpha07. يحتوي الإصدار 1.2.0-alpha07 على هذه المراجعات.

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

  • إصلاح الأخطاء في العناصر غير المنحنية داخل WearArcLayout الناتجة عن استخدام حجم شاشة يكون ارتفاعها أكبر من عرضها تم الآن وضع هذه العناصر الثانوية غير المنحنية بشكل صحيح داخل قوس على جميع أنواع الشاشات.

الإصدار 1.2.0-alpha06

27 كانون الثاني (يناير) 2021

تم إصدار androidx.wear:wear:1.2.0-alpha06. يحتوي الإصدار 1.2.0-alpha06 على هذه المراجعات.

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

  • نقل مكتبة "الأنشطة الجارية" إلى مكتبة فرعية جديدة: wear-ongoing أصبحت الفصول متوفرة الآن في حزمة androidx.wear.ongoing (كانت سابقًا androidx.wear.ongoingactivities) (I7c029).
  • نقل فئة WearableCalendarContract من مكتبة Wearable Support Library إلى AndroidX توفّر واجهة برمجة التطبيقات هذه مجموعة فرعية من البيانات المتاحة من خلال CalendarContract، ولكن تتم مزامنتها تلقائيًا مع الأجهزة القابلة للارتداء. (I6f2d7)

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

  • يمكنك إيقاف ميزة الإغلاق باستخدام زر الرجوع تلقائيًا في تنسيق الإطار القابل للرفض، وذلك لأنّ ميزة التمرير السريع للإغلاق تظل الطريقة الرئيسية للرجوع في وضع ملء الشاشة على الأجهزة القابلة للارتداء (Ic24e3).
  • تم إصلاح بعض المشاكل المتعلّقة بعرض العناصر الفرعية في WearArcLayout (Icf912)

الإصدار 1.2.0-alpha05

13 كانون الثاني (يناير) 2021

تم طرح androidx.wear:wear:1.2.0-alpha05. يحتوي الإصدار 1.2.0-alpha05 على هذه المراجعات.

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

  • حدِّث javadoc لفئة AmbientModeSupport لتقديم مقتطفات نموذجية لتوضيح الاستخدام العام لهذه الفئة بشكل أفضل.

الإصدار 1.2.0-alpha04

16 كانون الأول (ديسمبر) 2020

تم إصدار androidx.wear:wear:1.2.0-alpha04. يحتوي الإصدار 1.2.0-alpha04 على هذه المراجعات.

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

  • تمت إضافة إمكانية الإشارة إلى أنّه يمكن "استئناف النشاط تلقائيًا" عندما يخرج الجهاز من وضع الإضاءة السينمائية في فئة AmbientModeSupport. كانت هذه الوظيفة متاحة في السابق في فئة WearableActivity المتوقّفة نهائيًا من WearableSupportLibrary. (I336ab)
  • OngoingActivity
    • يمكن الآن ضبط الفئة عند إنشاء OngoingActivity، مثل OngoingActivitiy.Builder.getCategory(String).
    • تتضمّن OngoingActivityData الآن طابعًا زمنيًا لوقت إنشاء OngoingActivity‏: OngoingActivityData.getTimestamp()
    • (I91cb4)
  • تمت إضافة إمكانية ضبط الهوامش على عناصر WearArcLayout من خلال تغيير مَعلمات التنسيق لتوسيع MarginLayoutParams، أي أنّ WearArcLayout.LayoutParams يتوسّع إلى android.view.ViewGroup.MarginLayoutParams. (I2cd88)
  • يمكنك تغيير نوع الربط التلقائي لـ WearCurvedTextView إلى WearArcLayout.ANCHOR_CENTER (كان WearArcLayout.ANCHOR_START). يؤدي ذلك إلى تبسيط التفاعل بين تنسيق القوس والنص المنحني، لأنّ النص المنحني يرسم نفسه تلقائيًا في أعلى الصفحة على محور x، ويمكن لتنسيق القوس الرئيسي تدويره إلى المكان المطلوب. (I105ff)

الإصدار 1.2.0-alpha03

2 كانون الأول (ديسمبر) 2020

تم إصدار androidx.wear:wear:1.2.0-alpha03. يحتوي الإصدار 1.2.0-alpha03 على هذه المراجعات.

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

حاوية تنسيق جديدة DismissibleFrameLayout، التي تتعامل مع إغلاق الزر "رجوع" و/أو التمرير سريعًا لإغلاق الشاشة، والمخصّصة للاستخدام داخل نشاط يجب إضافة مستمع واحد على الأقل لتنفيذ إجراء الإغلاق. سيزيل المستمع عادةً عرضًا أو جزءًا يحتويان على العنصر من النشاط الحالي. يتم توفير setSwipeDismissible(boolean) وsetBackButtonDismissible(boolean) للتحكّم المباشر في الميزات. يهدف هذا التنسيق الجديد إلى استبدال SwipeDismissFrameLayout الحالي.

يمكن الآن للتطبيقات المصغّرة المنحنية معالجة أحداث اللمس. ستتلقّى التطبيقات المصغّرة العادية داخل WearArcLayout جميع أحداث اللمس، والتي يتم ربطها بمساحة إحداثياتها. يمكن لعنصر WearCurvedTextView (داخل WearArcLayout أو بدونه) ضبط معالِجات onClick وonLongClick.

أصبحت فئات الأنشطة الجارية الآن من فئة VersionedParcelables بدلاً من استخدام التسلسل/التسلسل العكسي المخصّص. أصبح الرمز الثابت ونية اللمس مطلوبَين الآن.

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

  • تم تقسيم سمة sweepDegrees لعنصر WearCurvedTextView إلى minSweepDegrees وmaxSweepDegrees لتوفير تنسيق أكثر مرونة لهذه الأداة المصغّرة.

الإصدار 1.2.0-alpha02

11 تشرين الثاني (نوفمبر) 2020

تم إصدار androidx.wear:wear:1.2.0-alpha02. يحتوي الإصدار 1.2.0-alpha02 على هذه المراجعات.

يضيف هذا الإصدار واجهة برمجة تطبيقات جديدة لخدمة "Ongoing Activities API" للمرة الأولى. يمكن للمطوّرين استخدام واجهة برمجة التطبيقات هذه للإشارة إلى أنّ الأنشطة التي تمارسها لفترة طويلة، مثل تمرين لياقة بدنية أو جلسة تشغيل وسائط جارية. يتيح هذا الإصدار للمطوّرين تقديم إشعارات دورية للحالة، مثل "المسافة والوقت الذي يتم تشغيله" أو "تشغيل المقطع الصوتي الحالي" لعرضه على خلفية شاشة الساعة أو في مشغّل التطبيقات. تستهدف هذه الوظيفة الأجهزة المستقبلية التي تم تفعيل وظيفة "النشاط الجاري" عليها.

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

  • واجهة برمجة تطبيقات جديدة للأنشطة الجارية، وهي غير متاحة على "الأجهزة غير المتوافقة". (I69a31)

الإصدار 1.2.0-alpha01

28 تشرين الأول (أكتوبر) 2020

تم إصدار androidx.wear:wear:1.2.0-alpha01. يحتوي الإصدار 1.2.0-alpha01 على هذه المراجعات.

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

  • تمت إضافة مكوّن WearCurvedTextView لكتابة نص منحني بسهولة وفقًا لمنحنى أكبر دائرة يمكن إدراجها في العرض. مثال على الاستخدام:
<androidx.wear.widget.WearCurvedTextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="example curved text"
        app:anchorAngleDegrees="180"
        app:anchorPosition="center"
        app:clockwise="false"
        style="@android:style/TextAppearance.Large"
/>

مثال على نص منحني في Android Wear

  • تمت إضافة حاوية 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>

مثال على نص منحني في Android Wear

(I536da)

Wear-Input 1.2

الإصدار 1.2.0-alpha02

29 أيلول (سبتمبر) 2021

تم إصدار androidx.wear:wear-input:1.2.0-alpha02 وandroidx.wear:wear-input-testing:1.2.0-alpha02. يحتوي الإصدار 1.2.0-alpha02 على هذه المراجعات.

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

  • تمت إعادة تسمية disallowEmoji إلى setEmojisAllowed في WearableRemoteInputExtender لاستخدامه لتحديد ما إذا كان سيتم عرض خيار رسم رموز الإيموجي. (I28393)

الإصدار 1.2.0-alpha01

15 أيلول (سبتمبر) 2021

تم إصدار androidx.wear:wear-input:1.2.0-alpha01 وandroidx.wear:wear-input-testing:1.2.0-alpha01. يحتوي الإصدار 1.2.0-alpha01 على هذه عمليات التنفيذ.

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

  • تم عرض جميع الثوابت الخاصة بمواقع الأزرار من WearableButtons. (Ibb12c)
  • تمت إضافة فئة WearableRemoteInputExtender التي يمكن استخدامها لإضافة عناصر إضافية خاصة بنظام التشغيل Wear إلى android.app.RemoteInput. (I01903)

Wear-Input 1.1.0

الإصدار 1.1.0

18 آب (أغسطس) 2021

تم إصدار androidx.wear:wear-input:1.1.0 وandroidx.wear:wear-input-testing:1.1.0. يحتوي الإصدار 1.1.0 على عمليات الربط هذه.

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

  • تمت إضافة "RemoteInputIntentHelper".
    • يمكن استخدام هذه الفئة لإنشاء RemoteInput Intent. ويمكن بعد ذلك استخدام ذلك لطلب إدخالات من المستخدمين في نشاط قابل للتخصيص.

الإصدار 1.1.0-rc01

4 آب (أغسطس) 2021

تم إصدار androidx.wear:wear-input:1.1.0-rc01 وandroidx.wear:wear-input-testing:1.1.0-rc01. يحتوي الإصدار 1.1.0-rc01 على هذه المراجعات.

لم يتم إجراء أي تغييرات على واجهة برمجة التطبيقات منذ androidx.wear:wear-input:1.1.0-beta01 وandroidx.wear:wear-input-testing:1.1.0-beta01

الإصدار 1.1.0-beta01

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

تم طرح androidx.wear:wear-input:1.1.0-beta01 وandroidx.wear:wear-input-testing:1.1.0-beta01 بدون أي تغييرات منذ 1.1.0-alpha03. يحتوي الإصدار 1.1.0-beta01 على عمليات التنفيذ هذه.

الإصدار 1.1.0-alpha03

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

تم إصدار androidx.wear:wear-input:1.1.0-alpha03 وandroidx.wear:wear-input-testing:1.1.0-alpha03. يحتوي الإصدار 1.1.0-alpha03 على هذه المراجعات.

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

  • تم إصلاح الخطأ الذي تسبَّب في رفض عمليات نوايا الإدخال عن بُعد، والتي تمت إضافة RemoteInput إليها من خلال RemoteInputHelper.putRemoteInputsExtra.

الإصدار 1.1.0-alpha02

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

تم إصدار androidx.wear:wear-input:1.1.0-alpha02 وandroidx.wear:wear-input-testing:1.1.0-alpha02. يحتوي الإصدار 1.1.0-alpha02 على هذه المراجعات.

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

  • إنّ طُرق RemoteInputIntentHelper المُستخدَمة للحصول على محتوى إضافي أو إدراجه تمثّل العنوان والإلغاء والتأكيد والتصنيفات قيد التقدّم، تستخدم الآن CharSequence بدلاً من String لهذه التصنيفات. (I0e71f)

الإصدار 1.1.0-alpha01

27 كانون الثاني (يناير) 2021

تم إصدار androidx.wear:wear-input:1.1.0-alpha01 وandroidx.wear:wear-input-testing:1.1.0-alpha01. يحتوي الإصدار 1.1.0-alpha01 على هذه المراجعات.

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

  • نقل فئة RemoteInputIntent من مكتبة Wearable Support Library إلى AndroidX وتتم إعادة تسمية الفئة التي تم نقلها إلى RemoteInputIntentHelper، والتي توفّر وظائف مساعدة لدعم الإدخالات عن بُعد من خلال بدء هدف. (I47cee)

Wear-Input 1.0.0

الإصدار 1.0.0

2 كانون الأول (ديسمبر) 2020

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

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

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

  • نقل وظائف WearableButtons من مكتبة الدعم القابل للارتداء إلى Jetpack

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

الإصدار 1.0.0-rc01

11 تشرين الثاني (نوفمبر) 2020

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

هذا الإصدار مماثل للإصدار 1.0.0-beta01.

الإصدار 1.0.0-beta01

28 تشرين الأول (أكتوبر) 2020

تم طرح androidx.wear:wear-input:1.0.0-beta01 وandroidx.wear:wear-input-testing:1.0.0-beta01 بدون أي تغييرات منذ 1.1.0-alpha01. يحتوي الإصدار 1.0.0-beta01 على هذه المراجعات.

Wear-Input-Testing Version 1.0.0-alpha01

14 تشرين الأول (أكتوبر) 2020

تم إصدار androidx.wear:wear-input-testing:1.0.0-alpha01. يحتوي الإصدار 1.0.0-alpha01 على عمليات التنفيذ هذه.

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

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

إصدار Wear-Input 1.0.0-alpha01

2 أيلول (سبتمبر) 2020

تم إصدار androidx.wear:wear-input:1.0.0-alpha01. يحتوي الإصدار 1.0.0-alpha01 على هذه المراجعات.

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

نقل وظيفة WearableButtons من مكتبة دعم الأجهزة القابلة للارتداء إلى Jetpack سيتم توفير دعم إضافي للاختبار في مكتبة androidx.wear:wear-input-testing في الإصدار التالي من Jetpack.

الإصدار 1.1.0

الإصدار 1.1.0

14 تشرين الأول (أكتوبر) 2020

تم إصدار androidx.wear:wear:1.1.0. يحتوي الإصدار 1.1.0 على عمليات الربط هذه.

التغييرات الرئيسية منذ الإصدار 1.0.0

  • تمت إضافة بادئة layout_ إلى سمة boxedEdges (المعروفة الآن باسم layout_BoxedEdges) لعنصر BoxInsetLayout من أجل الامتثال لاصطلاحات تسمية Android. سيؤدي ذلك إلى إزالة خطأ أداة التدقيق في Android Studio لهذه السمات. (I4272f)
  • تمت إضافة EXTRA_ANIMATION_DURATION_MILLIS اختياري إلى ConfirmationActivity للسماح بتحديد مدة عرض مربّع حوار التأكيد. (adb83ce، b/143356547)
  • تم التعديل WearableActionDrawViewلتأخير تضخيم درج الإجراءات إلى أن يتم فتح الدرج لأول مرة. (I01026، b/163870541)

الإصدار 1.1.0-rc03

2 أيلول (سبتمبر) 2020

تم طرح androidx.wear:wear:1.1.0-rc03. يحتوي الإصدار 1.1.0-rc03 على هذه عمليات التنفيذ.

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

  • تم إصلاح مشكلة عدم عرض محتوى "درج الإجراءات" عند فتحه. (I01026، b/163870541)

الإصدار 1.1.0-rc02

24 حزيران (يونيو) 2020

تم طرح androidx.wear:wear:1.1.0-rc02. يحتوي الإصدار 1.1.0-rc02 على هذه عمليات التنفيذ.

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

  • تمت إضافة بادئة layout_ إلى سمة boxedEdges (المعروفة الآن باسم layout_boxedEdges) لعنصر BoxInsetLayout من أجل الامتثال لاصطلاحات تسمية Android. سيؤدي ذلك إلى إزالة خطأ أداة التدقيق في Android Studio لهذه السمات.

الإصدار 1.1.0-rc01

14 أيار (مايو) 2020

تم طرح androidx.wear:wear:1.1.0-rc01 بدون أي تغييرات منذ .1.0-beta01. يحتوي الإصدار 1.1.0-rc01 على هذه عمليات التنفيذ.

الإصدار 1.1.0-beta01

29 نيسان (أبريل) 2020

تم طرح androidx.wear:wear:1.1.0-beta01 بدون أي تغييرات منذ androidx.wear:wear:1.1.0-alpha01. يحتوي الإصدار 1.3.0-beta01 على عمليات التنفيذ هذه.

الإصدار 1.1.0-alpha01

نيسان (أبريل) 2020

تم إصدار androidx.wear:wear:1.1.0-alpha01. يحتوي الإصدار 1.1.0-alpha01 على هذه عمليات التنفيذ.

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

  • تمت إضافة EXTRA_ANIMATION_DURATION_MILLIS اختياري إلى ConfirmationActivity للسماح بتحديد مدة عرض مربّع حوار التأكيد. (adb83ce، 134523c، b/143356547)

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

  • تم التعديل WearableActionDrawViewلتأخير تضخيم درج الإجراءات إلى أن يتم فتح الدرج لأول مرة. (5cd32f7)